DSH 插件安裝失敗從「git 未安裝」到「網(wǎng)絡(luò)線路問題」的完整排障復(fù)盤一句話摘要裝一個(gè) GitHub 上的 DSH 插件連續(xù)踩了git 缺失、npm 同名撞車、pnpm store 告警、git 證書不受信、網(wǎng)絡(luò)線路間歇性斷開五個(gè)坑 —— 本文把每一步的前提、交付物、坑的表現(xiàn)、如何避坑完整復(fù)盤?！?結(jié)論先行報(bào)錯(cuò)第一行往往不是真正的錯(cuò)誤。那條git ls-remote ... 不是內(nèi)部或外部命令才是根因系統(tǒng)沒裝 git。別按 npm 名字裝 GitHub 插件。npm 上的dsh-plugin-manager是另一個(gè)作者的項(xiàng)目同名同版本純屬「名字撞車」按名字裝會(huì)裝錯(cuò)東西必須用GitHub 倉庫 URL / tarball。git 證書報(bào)錯(cuò)SEC_E_UNTRUSTED_ROOTGit for Windows 默認(rèn)走 Windows SChannel遇到「根證書不受信」→ 一條命令git config --global http.sslBackend openssl即可繞過。Connection was reset/Could not connect這是網(wǎng)絡(luò)線路問題不是 git 也不是 VPN 的錯(cuò)。特征是間歇性—— 換個(gè)網(wǎng)絡(luò)手機(jī)熱點(diǎn)常能通?！笧g覽器能開、命令行不能」 瀏覽器走 QUIC/DoHgit 走 TCP兩者路徑不同不能用瀏覽器結(jié)果推斷命令行。插件裝好后要重啟 DSH才加載且該插件硬編碼了webprofile 路徑在desktopprofile 下它的 MCP 管理會(huì)去改web的配置插件作者設(shè)計(jì)如此非安裝問題。一、前提條件問題產(chǎn)生的前提在復(fù)盤前我先把「當(dāng)時(shí)處于什么環(huán)境」明晰一下否則很多現(xiàn)象可能會(huì)被誤判前提說明為何重要操作系統(tǒng)Windows 11家庭版中文版Git for Windowsgit 默認(rèn)用SChannelWindows 證書庫容易出「根證書不受信」DSH 桌面端DSH Desktopprofile 名為desktop安裝發(fā)生在C:\Users\……\.dsh\profiles\desktop插件來源github.com/liqichen/dsh-plugin-managergit 倉庫托管pnpm 裝 git 依賴必須本地有g(shù)itnpm 同名包npm 上已有dsh-plugin-manager0.1.0作者 hrhgit名字撞車按名字裝會(huì)裝成別人的項(xiàng)目pnpmDSH 內(nèi)置 pnpm v11.8.0pnpm 11 的 store 校驗(yàn)在不同運(yùn)行環(huán)境下結(jié)果不同網(wǎng)絡(luò)到 GitHub 的線路間歇性不穩(wěn)定家庭寬帶、移動(dòng)網(wǎng)絡(luò)均如此會(huì)出現(xiàn)Connection reset/ 超時(shí)已裝 VPN(CNPC)CSP OpenVPN GUI進(jìn)程在跑但不表示在接管流量易誤判?? 重點(diǎn)「VPN 進(jìn)程在運(yùn)行」≠「VPN 在接管你的流量」。后面階段六會(huì)拆解。二、問題現(xiàn)象原始報(bào)錯(cuò)用戶執(zhí)行安裝后終端/面板輸出一大段其中最關(guān)鍵的是這幾行? Lockfile passes supply-chain policies (verified 4d ago) [WARN] deprecated linxin666/dsh-web-ui-all0.3.5: 遷移到 linxin666/dsh-web-all [ERROR] Command failed with exit code 1: git ls-remote https://github.com/liqichen/dsh-plugin-manager.git HEAD HEAD^{} git 不是內(nèi)部或外部命令也不是可運(yùn)行的程序或批處理文件。 ← ? 真正的錯(cuò)誤但顯示為亂碼 dsh: pnpm failed in profile directory C:\Users\……\.dsh\profiles\desktop坑 1 – 錯(cuò)誤被「噪音」淹沒 中文亂碼。報(bào)錯(cuò)前面有 Lockfile 校驗(yàn)、deprecated 警告、pnpm 更新提示真正錯(cuò)誤藏在倒數(shù)幾行而且 Windows CMD 下的中文報(bào)錯(cuò)是GBK 亂碼git ??差點(diǎn)被當(dāng)成看不懂的亂碼忽略。?避坑只看[ERROR]/failed后面的命令那一行并抓住「不是內(nèi)部或外部命令」這個(gè)特征詞它就是「沒找到該程序」。用chcp 65001切 UTF-8 可讓中文正常顯示。三、排障決策樹先看結(jié)論再往下走插件安裝報(bào)錯(cuò) └─ 報(bào)錯(cuò)里有沒有 不是內(nèi)部或外部命令 / ls-remote / git 有 → 系統(tǒng)沒裝 git 或 PATH 沒生效 → 裝 git / 修復(fù) PATH 無 → 往下 └─ 報(bào)錯(cuò)是不是 證書 / SEC_E_UNTRUSTED_ROOT / schannel 是 → git 走的是 SChannel根證書不受信 → 設(shè) http.sslBackendopenssl 無 → 往下 └─ 報(bào)錯(cuò)是不是 Connection was reset / Could not connect / timeout 是 → 網(wǎng)絡(luò)線路問題間歇性→ 換網(wǎng)絡(luò) / 代理 / 鏡像 / 重試 無 → 往下 └─ 報(bào)錯(cuò)是不是 ERR_PNPM_UNEXPECTED_STORE / unable to open database file 是 → store 位置/權(quán)限問題 → 指定 --store-dir / 提權(quán)四、分階段復(fù)盤目標(biāo) → 交付物 → 坑 → 避坑階段 1 · 確診「git 未安裝」 目標(biāo)搞清 pnpm 為什么在解析 git 依賴時(shí)退出。 交付物確認(rèn)系統(tǒng)無gitGet-Command git為空常見路徑C:\Program Files\Git\cmd\git.exe不存在。 坑的表現(xiàn)git ls-remote ... 不是內(nèi)部或外部命令命令行里git --version直接報(bào)錯(cuò)。? 避坑裝 gitchoco install git -y需管理員裝完必須開新終端已運(yùn)行進(jìn)程的 PATH 不會(huì)刷新見階段 5。階段 2 · 干掉「npm 同名撞車」 目標(biāo)確定到底該裝「哪個(gè) dsh-plugin-manager」。 交付物查明 npm 上的dsh-plugin-manager0.1.0是hrhgit的項(xiàng)目你要裝的是liqichen的倉庫同名同版本但不同項(xiàng)目它的package.json里repository指向github.com/hrhgit/...。 坑的表現(xiàn)如果直接dsh plugin add dsh-plugin-manager會(huì)安安靜靜裝成另一個(gè)項(xiàng)目功能對不上且很難察覺。? 避坑裝前核對repository/description用 GitHub倉庫 URL / commit tarball安裝而不是裸名字。階段 3 · 用「GitHub tarball」繞過 git階段性成功 目標(biāo)在沒有 git 的前提下先把插件裝上。 交付物用 commit 快照 tarball 讓 pnpm 直接下載無需git ls-remotedsh plugin--profiledesktopadd--store-dirC:\Users\……\AppData\Local\pnpm\store\https://github.com/liqichen/dsh-plugin-manager/archive/36a73f0174f0714243ba01afcc9a5ffaa36b0b04.tar.gz裝完后package.json的dependencies與dsh.profile.bundles都寫入dsh-plugin-managernode_modules/dsh-plugin-manager/文件齊全。 坑的表現(xiàn)第一次報(bào)ERR_PNPM_UNEXPECTED_STOREnode_modules鏈接的 store 和 pnpm 當(dāng)前默認(rèn) store 不一致。第二次報(bào)ERR_SQLITE_ERROR unable to open database file寫入全局 store 被權(quán)限/沙箱攔截。? 避坑store 不一致 → 顯式--store-dir node_modules 實(shí)際鏈接的那個(gè) store。寫 store 被拒 → 需完整寫權(quán)限受限命令行環(huán)境里即使--store-dir也可能寫不進(jìn)要提升權(quán)限。??誠實(shí)提醒這個(gè) store 告警往往跟運(yùn)行環(huán)境有關(guān)受限/沙箱命令行 vs 真實(shí) GUIpnpm 默認(rèn) store 可能不同。很多場景下真實(shí)用戶環(huán)境根本沒有此問題別把它當(dāng)成必然坑。階段 4 · 驗(yàn)證安裝與加載 目標(biāo)確認(rèn)插件「真的裝進(jìn)去了、且會(huì)被加載」。 交付物三條都過package.jsondependencies含dsh-plugin-managerdsh.profile.bundles含dsh-plugin-manager。node_modules/dsh-plugin-manager/index.js、client.js、cordis.patch.yml、package.json齊全。讓 DSH 實(shí)際組合一次配置dsh--profiledesktop --dump-config輸出出現(xiàn)# dsh-plugin-manager和它插入的- id: plugin-manager-ui即加載鏈路打通。 坑的表現(xiàn)dsh.client.inject里的deepseek-ai/dsh-client-runtime等在 profile 的node_modules頂層找不到→ 誤以為缺依賴。? 避坑這些deepseek-ai/dsh-client-*是宿主deepseek-ai/dsh-web-app運(yùn)行時(shí)提供的不進(jìn) profile 的node_modules屬正常。 坑的表現(xiàn)裝完當(dāng)前 DSH 實(shí)例還沒加載它是新 bundle 層要重啟。? 避坑重啟 DSH再進(jìn)「設(shè)置 → 插件管理」。階段 5 · 修復(fù) git 的「證書不受信」 目標(biāo)讓 git 能正常連 GitHub。 交付物gitconfig--globalhttp.sslBackend opensslgitls-remote https://github.com/liqichen/dsh-plugin-manager.git HEAD# 36a73f0174f0714243ba01afcc9a5ffaa36b0b04 HEAD ? 坑的表現(xiàn)git ls-remote ... schannel: SEC_E_UNTRUSTED_ROOT (0x80090325) 證書由不受信任的頒發(fā)機(jī)構(gòu)頒發(fā)。? 避坑 根因Git for Windows 默認(rèn) SChannelWindows 證書庫對 GitHub 根證書不信任切到 OpenSSL 后端用 git 自帶的 CA 包即可。寫在~/.gitconfig用git config --global --unset http.sslBackend可撤銷。 坑的表現(xiàn)裝完 git 后舊終端/DSH 里git仍找不到系統(tǒng) PATH 已更新但已啟動(dòng)的進(jìn)程 PATH 沒有刷新。? 避坑重開終端 / 重啟 DSH用git --version驗(yàn)證。階段 6 · 拆解「網(wǎng)絡(luò)線路問題」最大的坑 目標(biāo)解釋Recv failure: Connection was reset/Could not connect to github.com:443 ... 超時(shí)。 交付物確診這是間歇性網(wǎng)絡(luò)線路問題與 git 配置、VPN 均無關(guān)換網(wǎng)絡(luò)手機(jī)熱點(diǎn)后git ls-remote成功。 坑的表現(xiàn)與判定逐條排除「是 VPN 嗎」—— 排查發(fā)現(xiàn)VPN 進(jìn)程在跑CNPC_C330、openvpn-gui但虛擬網(wǎng)卡全部「已斷開」Media disconnected其默認(rèn)路由躍點(diǎn)數(shù) 256備用真正生效的是直連線路躍點(diǎn)數(shù) 0系統(tǒng)代理也處于關(guān)閉狀態(tài)?！⒎?VPN 接管流量。教訓(xùn)單看「進(jìn)程存在」會(huì)誤判要看「路由/網(wǎng)卡實(shí)際狀態(tài)」?！甘?DNS 嗎」——github.com解析到20.205.243.166api.github.com解析到緊挨著的20.205.243.168卻能通。說明不是 DNS 解析不到而是對特定邊結(jié)點(diǎn) IP 的 TCP 連接不通。教訓(xùn)解析出 IP ≠ 該 IP 能連要真正建立 TCP 才算通?！甘?IPv6 嗎」——github.com無 AAAA(IPv6) 記錄 → 排除。「為什么瀏覽器能開、命令行不能」—— 瀏覽器走QUIC(UDP)/DoHgit/pnpm 走TCP兩者路徑不同。教訓(xùn)不能用瀏覽器結(jié)果推斷命令行能否連通?！甘情g歇性嗎」—— 是該 IP 的 TCP 連接間歇性被重置/超時(shí)換網(wǎng)絡(luò)往往就好。? 避坑按需三選一換一條更穩(wěn)的網(wǎng)絡(luò)/線路后重試有代理則git config --global http.proxy http://127.0.0.1:端口用加速鏡像前綴如https://ghproxy.com/https://github.com/...。五、坑點(diǎn)匯總表一表看懂#坑表現(xiàn)根因避坑1錯(cuò)誤被噪音淹沒亂碼git 不是內(nèi)部或外部命令顯示成 GBK 亂碼真正錯(cuò)誤在倒數(shù)幾行CMD 中文亂碼只看[ERROR]后的命令行chcp 65001切 UTF-82git 未安裝git ls-remote ... 不是內(nèi)部或外部命令系統(tǒng)沒裝 git裝 git裝后開新終端3npm 同名撞車dsh-plugin-manager是別人的項(xiàng)目npm 已有同名同版本包用倉庫 URL/tarball裝前核對 repository4pnpm store 不一致ERR_PNPM_UNEXPECTED_STOREnode_modules 與 pnpm 默認(rèn) store 不同顯式--store-dir但要警惕可能是環(huán)境差異5寫 store 失敗ERR_SQLITE_ERROR unable to open database file寫全局 store 被權(quán)限/沙箱攔截提升寫權(quán)限受限環(huán)境別硬試6加載需重啟裝完 DSH 無反應(yīng)新 bundle 層需重啟加載重啟 DSH用--dump-config先驗(yàn)證鏈路7證書不受信SEC_E_UNTRUSTED_ROOTSChannel 不信任 GitHub 根證書git config --global http.sslBackend openssl8PATH 未刷新新裝 git 舊進(jìn)程找不到已啟動(dòng)進(jìn)程 PATH 不更新重開終端/重啟 DSH9網(wǎng)絡(luò)線路問題Connection was reset/ 超時(shí)到 GitHub 特定 IP 的 TCP 連接間歇性不穩(wěn)換網(wǎng)絡(luò)/代理/鏡像重試10VPN 誤判以為 VPN 在接管流量VPN 進(jìn)程在跑但網(wǎng)卡斷開/路由為備用看網(wǎng)卡狀態(tài)與路由躍點(diǎn)數(shù)別只看進(jìn)程11瀏覽器≠命令行瀏覽器能開但 git 不通瀏覽器走 QUIC/DoHgit 走 TCP以命令行實(shí)測為準(zhǔn)12插件硬編碼 web 路徑desktop profile 下 MCP 管理改錯(cuò)文件作者寫死~/.dsh/profiles/web/...用前看文檔或在 web profile 使用六、快速排查清單下次直接照做當(dāng)再次遇到「DSH 插件裝不上」先看報(bào)錯(cuò)中[ERROR]后的命令與錯(cuò)誤行別被前面噪音帶偏。git --version沒有 → 裝 git開新終端。確認(rèn)安裝源npm 名字 vs GitHub 倉庫裝前核對 repositoryGitHub 插件優(yōu)先用 URL/tarball。若報(bào) store 相關(guān) →pnpm config get store-dir與node_modules/.modules.yaml的storeDir對比不一致就顯式--store-dir。若報(bào)unable to open database file→ 檢查是否有寫全局 store 的權(quán)限。若報(bào)證書 →git config --global http.sslBackend openssl。若報(bào)Connection reset / Could not connect / timeout→ 這是網(wǎng)絡(luò)間歇性換網(wǎng)絡(luò) / 代理 / 鏡像 / 重試別去改 git 配置。裝完用dsh --profile 名字 --dump-config看是否出現(xiàn)該 bundle 層。確認(rèn)以上后重啟 DSH再進(jìn)設(shè)置面板使用。七、結(jié)論與長期建議95% 的「git 裝不上 GitHub 插件」 沒裝 git 網(wǎng)絡(luò)線路不穩(wěn)定跟 DSH 本身無關(guān)。git 證書問題用一條http.sslBackend openssl根治寫在~/.gitconfig保留即可。GitHub 插件安裝優(yōu)先用倉庫 URL/tarball避免 npm 同名撞車裝前核對repository。網(wǎng)絡(luò)線路是最大變量GitHub 在你所在網(wǎng)絡(luò)常間歇性不通。要長期穩(wěn)定用 GitHub建議代理或鏡像不要裸連大流量場景。重啟裝插件、改 PATH、改 git 配置后凡是「看起來沒生效」先重啟進(jìn)程/DSH。附錄 · 本文用到的關(guān)鍵命令與文件# 查 gitgit--versiongitls-remote https://github.com/liqichen/dsh-plugin-manager.git HEAD# 修證書 / 走代理gitconfig--globalhttp.sslBackend opensslgitconfig--globalhttp.proxy http://127.0.0.1:端口# 裝插件GitHub tarball無需本地 gitdsh plugin--profiledesktopadd\--store-dirC:\Users\……\AppData\Local\pnpm\store\https://github.com/liqichen/dsh-plugin-manager/archive/commit.tar.gz# 驗(yàn)證加載鏈路dsh--profiledesktop --dump-config# 查 store / 路由 / 網(wǎng)絡(luò)pnpmconfig get store-dir route print-4Resolve-DnsName github.com-TypeA關(guān)鍵文件package.jsondependenciesdsh.profile.bundles、node_modules/.modules.yamlstoreDir、node_modules/dsh-plugin-manager/{package.json,cordis.patch.yml,index.js,client.js}、~/.gitconfighttp.sslBackend。