国内开发者使用 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 生态中的网络诊断辅助工具。