國內開發者使用 DeepSeek Harness（DSH）時，常遇到 pnpm dlx @deepseek-ai/dsh 卡頓、ERESOLVE 錯誤或 GitHub/HuggingFace 下載超時的問題。DSH 的理念是“一切皆插件”，zoahdev/dsh-cn-boot 旨在解決這個問題，提供端點探測、代理檢測和註冊表配置讀取功能，幫助用戶定位並解決網絡連接問題。
這是什麼¶
zoahdev/dsh-cn-boot 是 DeepSeek Harness（dsh）的國內網絡引導插件。它探測國內用戶關心的端點（如 npm 官方源、npmmirror、GitHub、raw.githubusercontent、Hugging Face、Gitee 等），檢測本地常見代理端口，讀取當前的 npm/pnpm 註冊表配置，並據此提供具體建議和引導腳本。
該插件由 zoahdev 維護，採用 MIT 許可證。
核心功能¶
1、端點探測：探測 npm/GitHub/HuggingFace/mirrors 等端點的連通性。
2、代理檢測：檢測本地常見代理端口（如 127.0.0.1:7897 / 10809）。
3、配置讀取：讀取 npm/pnpm 的註冊表配置。
4、引導建議：提供具體的操作建議和可複製的引導腳本。
5、安全模式：默認只讀，apply 爲顯式開關，僅將註冊表設爲 npmmirror。
安裝與啓用¶
1、通過 DSH 插件系統安裝：
dsh plugin add dsh-cn-boot
2、或者直接作爲獨立工具運行：
npx dsh-cn-boot
典型用法¶
- 檢查網絡與獲取建議：
dsh-cn-boot
- 應用建議（修改註冊表）：
dsh-cn-boot --apply
-
Agent 內調用：在 DSH 的 agent 調用中，請求執行
cn_boot工具。 -
退出碼：
0表示網絡正常；1表示有建議待處理；2表示用法錯誤。
適用場景與注意¶
該工具適合需要排查網絡問題或優化依賴安裝速度的 DSH 用戶。
- 默認只讀：插件默認只讀，不會靜默修改系統配置；只有顯式使用
--apply參數時，纔會將 npm/pnpm 註冊表設置爲 npmmirror。 - 權限與依賴：零運行時依賴，以當前進程權限運行。
- 審查：使用前請確認源碼與許可證。
結語¶
zoahdev/dsh-cn-boot 通過提供具體的端點探測和註冊表配置建議，解決了“只告訴你壞了”的痛點。它默認只讀的設計降低了風險，適合作爲 DSH 生態中的網絡診斷輔助工具。
