AIRI 單倉(cāng)實(shí)踐pnpm CLI 核心命令全解安裝、腳本、Workspace、補(bǔ)丁與發(fā)布【免費(fèi)下載鏈接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ai/airiAIRI 是一個(gè)橫跨 Web、Electron、Android/iOS 的 pnpm monorepo根 package.json 通過packageManager字段鎖定pnpm11.24.0。本文以倉(cāng)庫內(nèi)的 pnpm CLI 參考文檔 .agents/skills/pnpm/references/core-cli.md 為主體完整覆蓋安裝、腳本運(yùn)行、workspace 過濾、補(bǔ)丁、全局包、運(yùn)行時(shí)與發(fā)布等核心命令并結(jié)合 AIRI 倉(cāng)庫真實(shí)的 pnpm-workspace.yaml、package.json 與 CI 配置說明每條命令在大型單倉(cāng)中的實(shí)際用法與約束。讀完本文你可以直接使用這套命令管理 AIRI 這類多包倉(cāng)庫的依賴安裝、構(gòu)建編排與發(fā)布流程。安裝命令從pnpm install到可復(fù)現(xiàn)的 CI 安裝文檔給出的基礎(chǔ)安裝命令集如下覆蓋了添加、移除與更新依賴的日常操作pnpm install # 安裝所有依賴別名pnpm i pnpm add pkg # 生產(chǎn)依賴 pnpm add -D pkg # devDependency也可用 -d pnpm add -O pkg # optionalDependency也可用 -o pnpm add -E pkg # 精確版本也可用 -e pnpm add pkgversion pnpm remove pkg # 別名rm、uninstall、un pnpm update # 別名up pnpm update --latest # 忽略 semver 范圍-L pnpm update -i # 交互式更新干凈/可復(fù)現(xiàn)安裝文檔專門列出了保證安裝可復(fù)現(xiàn)性的四個(gè)命令pnpm install --frozen-lockfile # 若 lockfile 會(huì)變化則失敗CI 中自動(dòng)啟用 pnpm ci # 干凈安裝 pnpm clean install --frozen-lockfile pnpm clean # 移除所有 workspace 項(xiàng)目的 node_modules別名purge pnpm clean --lockfile # 同時(shí)刪除 pnpm-lock.yaml這一點(diǎn)在 AIRI 倉(cāng)庫有直接的落地證據(jù).github/workflows/ci.yml 的 lint、build、test、typecheck 四個(gè) job 中每個(gè)都顯式執(zhí)行pnpm install --frozen-lockfile如第 44、104、153、177 行保證 CI 安裝結(jié)果與本地 pnpm-lock.yaml 完全一致構(gòu)建階段再配合pnpm run build:packages觸發(fā) turbo 的任務(wù)圖構(gòu)建。文檔還特別強(qiáng)調(diào)了一個(gè) v11 的行為變化自 v11 起tarball 與 lockfile 的完整性校驗(yàn)不匹配會(huì)直接報(bào)硬錯(cuò)誤ERR_PNPM_TARBALL_INTEGRITY。只有在確認(rèn)新字節(jié)內(nèi)容無誤后才使用pnpm install --update-checksums。在 CI 中pnpm 還會(huì)因 lockfile 由更新的 pnpm 主版本寫就而失敗。AIRI 根 package.json 第 6 行的packageManager: pnpm11.24.0正是配合這一約束的版本錨點(diǎn)CI 使用的pnpm/setupv2action 會(huì)依據(jù)該字段還原同一 pnpm 版本避免lockfile 版本高于 CI pnpm 版本導(dǎo)致的失敗。腳本命令run、exec與 AIRI 的腳本編排文檔給出的腳本命令集pnpm run script # 或直接pnpm script pnpm run build -- --watch pnpm run --if-present build pnpm set-script test vitest run # 添加/更新 scripts 條目別名ss pnpm exec cmd # 運(yùn)行本地二進(jìn)制如 pnpm exec eslint .文檔同時(shí)指出兩條容易踩坑的規(guī)則隱藏腳本以.開頭的腳本名如.helper不能直接運(yùn)行只能被其他腳本調(diào)用內(nèi)建命令與腳本名沖突clean、setup、deploy、rebuild會(huì)優(yōu)先執(zhí)行package.json中的同名腳本若要強(qiáng)制執(zhí)行內(nèi)建命令需用pnpm pm name如pnpm pm clean。在 AIRI 根 package.json 中可以看到這套機(jī)制的典型用法postinstall腳本寫作pnpm exec simple-git-hooks pnpm run build:packages——安裝完成后自動(dòng)注冊(cè) git hooks 并預(yù)構(gòu)建全部基礎(chǔ)包dev系列腳本則大量使用pnpm -rF proj-airi/pkg run dev的形式從根目錄直達(dá)子包詳見下文 Workspace 章節(jié)。dlx / pnx —— 免安裝執(zhí)行pnx create-vite my-app # pnx pnpm dlx pnpx pnpm dlx degit user/repo dest pnx shxcatalog: # 支持 catalog: 協(xié)議 pnx --packagescope/tool tool --helpdlx/pnx會(huì)遵循供應(yīng)鏈設(shè)置minimumReleaseAge、trustPolicy并在 v11 中默認(rèn)使用全局虛擬存儲(chǔ)global virtual store。AIRI 倉(cāng)庫有兩處印證根 package.json 第 50 行定義了nolyfill: pnpm dlx nolyfill用 dlx 臨時(shí)拉取 nolyfill 工具無需將其寫入 devDependenciespnpm-workspace.yaml 第 2 行的minimumReleaseAge: 4320正是文檔提到的供應(yīng)鏈策略配置——該倉(cāng)庫要求依賴包發(fā)布至少 3 天后才可被安裝并對(duì)moeru/*、proj-airi/*等自有 scope 豁免見第 3-10 行的minimumReleaseAgeExclude。Workspace 命令與過濾模式AIRI 9 個(gè)目錄族的構(gòu)建編排文檔給出的 workspace 命令pnpm -r run script # 在所有包中運(yùn)行別名--recursive pnpm --filter pattern run script pnpm --filter ./packages/** run build pnpm --filter myorg/* run lint pnpm -r --parallel run dev過濾模式filter patternspnpm --filter pkg-name cmd # 按包名過濾-F 縮寫 pnpm --filter ./packages/core test pnpm --filter ...scope/app build # 包 它依賴的包 pnpm --filter scope/core... test # 包 依賴它的包 pnpm --filter ...[origin/main] build # 相對(duì) git 引用發(fā)生變化的包AIRI 倉(cāng)庫對(duì)這套機(jī)制的使用幾乎覆蓋了全部模式。pnpm-workspace.yaml 第 13-23 行聲明了packages/**、plugins/**、integrations/**、services/**、examples/**、docs/**、engines/**、apps/**、server/**九個(gè)目錄族并用!**/dist/**排除產(chǎn)物目錄根 package.json 第 105-115 行的workspaces字段與之保持一致。在此基礎(chǔ)上按 glob 路徑過濾dev:apps: pnpm -rF\./apps/*\ run --parallel dev第 28 行同時(shí)演示了-rF縮寫、glob 過濾與--parallel并行執(zhí)行按包名過濾dev: pnpm -r -F proj-airi/stage-web dev第 16 行、dev:docs: pnpm -rF proj-airi/docs run dev第 17 行等十余個(gè)dev:*腳本均通過proj-airi/name包名精確指向單個(gè)子包多 glob 疊加typecheck: pnpm -rF\./packages/*\ -F\./apps/*\ -F\./server/**\ -F\./docs\ --parallel typecheck第 47 行在一次調(diào)用中覆蓋四個(gè)目錄族CI 中的單包構(gòu)建.github/workflows/ci.yml 的 build-test job 用pnpm -F proj-airi/stage-web run build、pnpm -F proj-airi/stage-tamagotchi run build等命令按矩陣分別構(gòu)建各應(yīng)用第 56、59 行。值得注意的是AIRI 還疊加了 turbo 任務(wù)圖根build腳本為turbo run build -F\./packages/*\ ...由 turbo.json 定義build任務(wù)的dependsOn: [^build]依賴拓?fù)?。pnpm filter 負(fù)責(zé)選包turbo 負(fù)責(zé)排序與緩存兩者組合是該倉(cāng)庫構(gòu)建管線的基本形態(tài)。Patches文檔命令在 AIRI 中的真實(shí)應(yīng)用文檔給出的補(bǔ)丁三件套pnpm patch pkgversion # 打開可編輯副本并打印路徑 pnpm patch-commit path # 寫入 patches/*.patch 并記錄 pnpm patch-remove pkgversionAIRI 倉(cāng)庫正在使用這套機(jī)制pnpm-workspace.yaml 第 38-43 行的patchedDependencies記錄了五個(gè)生效的補(bǔ)丁與patches/目錄下的文件一一對(duì)應(yīng)——patchedDependencies: mineflayer-pathfinder: patches/mineflayer-pathfinder.patch pixi-live2d-display: patches/pixi-live2d-display.patch sponsorkit17.1.0: patches/sponsorkit17.1.0.patch tab-election4.6.2: patches/tab-election4.6.2.patch uiohook-napi1.5.5: patches/uiohook-napi1.5.5.patch可以看到兩種寫法pkg: path對(duì)任意已解析版本生效與pkgversion: path鎖定到具體版本如 sponsorkit17.1.0.patch。其中 mineflayer-pathfinder.patch 服務(wù)于integrations/minecraft的 Minecraft 玩法集成uiohook-napi1.5.5.patch 服務(wù)于桌面端的系統(tǒng)級(jí) hook。修改上游依賴時(shí)流程就是文檔所述的pnpm patch編輯 →pnpm patch-commit落盤 →patchedDependencies自動(dòng)更新。本地包鏈接與 v11 全局包隔離文檔說明pnpm link dir # 將路徑鏈接進(jìn)當(dāng)前項(xiàng)目的 node_modules僅接受路徑 pnpm add -g . # 將當(dāng)前包的 bin 全局注冊(cè)v11 破壞性變更pnpm link只接受相對(duì)/絕對(duì)路徑不再支持全局存儲(chǔ)解析、--global也不支持裸pnpm link。要用pnpm add -g .讓 bin 在系統(tǒng)級(jí)可用。全局包v11 isolated installs命令集pnpm add -g typescript prettier # 每個(gè)包獲得獨(dú)立隔離安裝目錄 pnpm add -g eslint,prettier # 逗號(hào) 共享同一個(gè)安裝組 pnpm add -g --allow-buildesbuild esbuild pnpm remove -g pkg pnpm list -g pnpm bin -g # 顯示全局 bin 目錄$PNPM_HOME/binpnpm install -g無參數(shù)不受支持。升級(jí)到 v11 后需運(yùn)行pnpm setup使$PNPM_HOME/bin進(jìn)入 PATH。AIRI 的 Cloudflare 部署流水線正是 v11 隔離全局安裝的實(shí)例.github/workflows/deploy-cloudflare-workers-dev-server.yml 中先執(zhí)行pnpm i -g wrangler4安裝 wrangler 4再執(zhí)行pnpm install --frozen-lockfile安裝倉(cāng)庫依賴——兩個(gè)安裝彼此隔離wrangler 的依賴不會(huì)污染 workspace 的 lockfile。Runtimes用 pnpm 管理 Node/Deno/Bun文檔給出的運(yùn)行時(shí)命令pnpm runtime set node 22 -g # 安裝并暴露 node別名rt pnpm runtime set node lts -g pnpm runtime set deno 2 -g pnpm install --no-runtime # 跳過安裝 devEngines.runtime 聲明的運(yùn)行時(shí)AIRI 的 CI 是該功能的配套實(shí)踐.github/workflows/ci.yml 第 24-28 行使用pnpm/setupv2并傳入runtime: node26.7.0讓 pnpm 直接供給 CI 所需的 Node 版本注釋解釋了釘住 26.7.0 而非跟隨 26.8.0 的原因26.8.0 報(bào)告預(yù)發(fā)布版本號(hào)導(dǎo)致 sharp 0.29.3 在pnpm install時(shí)拒絕安裝。開發(fā)者本地同樣可以用pnpm runtime set node version -g獲得一致的運(yùn)行時(shí)環(huán)境無需額外的 nvm/fnm。Store 管理與檢查/注冊(cè)表命令Store 管理pnpm store path # 顯示存儲(chǔ)位置prune 后打印釋放大小 pnpm store prune # GC 未被引用的包含全局虛擬存儲(chǔ)鏈接 pnpm store status檢查與注冊(cè)表命令pnpm list # 別名ls pnpm why pkg # 反向依賴樹對(duì)子樹去重 pnpm why --find-byfinder # 從 .pnpmfile.mjs 中取自定義 finder pnpm outdated pnpm audit pnpm peers check # 從 lockfile 報(bào)告未滿足/缺失的 peer pnpm view pkg [field] # 注冊(cè)表元數(shù)據(jù)別名info、show pnpm whoami pnpm rebuild pnpm import # 由 npm/yarn lockfile 生成 pnpm-lock.yaml pnpm dedupeAIRI 根 package.json 第 49 行的up: taze -w -r -I pnpm prune pnpm dedupe是一個(gè)值得參考的組合用 taze 批量升級(jí)范圍后接pnpm prune清理無用依賴、pnpm dedupe折疊重復(fù)版本。此外 pnpm-workspace.yaml 第 25-37 行的overrides塊如axios: npm:feaxios^0.0.23、多處npm:nolyfill/*替換配合pnpm why使用是定位并治理傳遞依賴替換的完整鏈路第 489-523 行的packageExtensions則為vitepress、pixiv/three-vrm-core等包補(bǔ)充了缺失聲明的 peerDependencies與pnpm peers check的輸出形成對(duì)照。發(fā)布命令文檔給出的發(fā)布命令集pnpm pack pnpm publish -r --no-git-checks pnpm version patch|minor|major|2.0.0 # 升版本并 commit tagv11 pnpm version prerelease --preid beta pnpm deprecate pkgrange message pnpm dist-tag add pkgversion tag pnpm unpublish pkgversion # 不推薦優(yōu)先用 deprecate pnpm sbom --sbom-format cyclonedx # SBOMcyclonedx (1.7) | spdx (2.3) pnpm stage publish ... # 分階段發(fā)布可延后 2FAAIRI 是private: true的倉(cāng)庫publish -r不面向本倉(cāng)庫自身但pnpm version系列命令與根 bump.config.ts、devDependencies 中的bumpp構(gòu)成版本管理鏈路倉(cāng)庫通過 release-pkg.yaml 等發(fā)布工作流將packages/下的共享庫發(fā)布到 registry發(fā)布產(chǎn)物再由pnpm-lock.yaml鎖定的proj-airi/*私有 catalog 版本如 pnpm-workspace.yaml 第 170-176 行消費(fèi)。維護(hù)命令與實(shí)用 Flag維護(hù)與版本管理命令pnpm self-update [version] # 更新 packageManager 鎖定的版本或全局安裝 pnpm with current install # 用指定 pnpm 版本執(zhí)行單條命令 pnpm with 11.0.0 install pnpm approve-builds [--all] # 審查依賴構(gòu)建腳本寫入 allowBuilds實(shí)用 Flagpnpm install --ignore-scripts pnpm install --prefer-offline pnpm install --prod # -P跳過 devDependencies pnpm install --no-optional pnpm install --strict-peer-dependencies其中pnpm approve-builds在 AIRI 有直接落點(diǎn)pnpm-workspace.yaml 第 455-488 行的allowBuilds塊就是構(gòu)建腳本審查的產(chǎn)物逐一聲明了electron、esbuild、sharp、canvas等需要 postinstall 構(gòu)建的包true以及明確拒絕的better-sqlite3、prisma/clientfalse。第 483 行還保留了一條注釋說明simple-git-hooks被設(shè)為false的原因在shellEmulator: true第 12 行下無.git目錄時(shí)其安裝腳本可能失敗。這類注釋讓為什么禁用某構(gòu)建腳本成為倉(cāng)庫內(nèi)可追溯的事實(shí)。關(guān)鍵要點(diǎn)小結(jié)文檔末尾的 Key Points 可概括為五條每一條都能在本倉(cāng)庫中找到對(duì)應(yīng)實(shí)踐pnpm ci clean frozen installCI 自動(dòng)啟用 frozen-lockfile——對(duì)應(yīng) .github/workflows/ci.yml 各 job 的pnpm install --frozen-lockfiledlx/pnpx是pnx的別名全局安裝按包隔離逗號(hào)列表可共享安裝組——對(duì)應(yīng) deploy-cloudflare-workers-dev-server.yml 的pnpm i -g wrangler4pnpm link只接受路徑暴露全局 bin 請(qǐng)用pnpm add -g .用pnpm runtime set管理 Node/Deno/Bun安裝時(shí)可用--no-runtime跳過devEngines.runtime聲明——對(duì)應(yīng) CI 中pnpm/setupv2的runtime: node26.7.0v11 新增發(fā)布/注冊(cè)表命令version、view、whoami、deprecate、dist-tag、unpublish、sbom、stage。在 AIRI 倉(cāng)庫中的適用前提本文所有結(jié)論基于當(dāng)前倉(cāng)庫的實(shí)際狀態(tài)pnpm 版本由 package.json 的packageManager: pnpm11.24.0鎖定workspace 結(jié)構(gòu)由 pnpm-workspace.yaml 聲明含catalogMode: prefer的 catalog 依賴協(xié)議與catalogs.vitest命名 catalogCI 運(yùn)行于 pnpm-lock.yaml 之上。若要復(fù)現(xiàn)文中的過濾、patch 或全局安裝操作前提是本地 pnpm 版本與該鎖定一致可用pnpm self-update對(duì)齊并保證pnpm install未在 CI 環(huán)境之外改動(dòng) lockfile否則--frozen-lockfile會(huì)直接報(bào)錯(cuò)——這正是該倉(cāng)庫要求本地安裝結(jié)果可復(fù)現(xiàn)的底線?！久赓M(fèi)下載鏈接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ai/airi創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考