国内网络引导 zoahdev/dsh-cn-boot

dsh-cn-boot

npm

CI
License: MIT
dsh-plugin

面向 DeepSeek Harness (dsh) 的中国网络引导工具：一条命令告诉你为什么安装缓慢或失败，以及该如何处理。

它会探测对中国大陆 dsh 用户至关重要的端点——npm registry、npmmirror、GitHub、raw.githubusercontent、Hugging Face、Gitee——以及常见的本地代理端口（127.0.0.1:7897 / 10809），读取你当前的 npm/pnpm registry 配置，并返回具体建议以及可直接复制粘贴的引导脚本。默认只读；apply 是显式选择加入，且仅将 npm/pnpm registry 设置为 npmmirror。

安装

dsh plugin add dsh-cn-boot

或独立运行：

npx dsh-cn-boot

CLI

dsh-cn-boot [--apply] [--json] [--timeout ]

- 打印探测结果、建议以及 PowerShell + bash 引导脚本。
- 当建议执行时，--apply 会运行 pnpm config set registry https://registry.npmmirror.com（以及 npm）——这是唯一的副作用。
- 退出码：0 连接看起来正常，1 有建议，2 用法错误。

npx dsh-cn-boot
npx dsh-cn-boot --apply
npx dsh-cn-boot --json

在 harness 内使用（可由 agent 调用）

向你的 dsh agent 提问：

检查一下我的网络连 dsh 依赖源通不通，给个引导建议。
Run a China-network bootstrap check: cn_boot.

该工具返回一个 dsh-cn-boot/v1 结果：每个目标的探测结果、当前 registry 配置、建议、生成的脚本，以及（仅在 options.apply: true 时）已应用的内容。

检查项

| 探测 | 原因 |
| registry.npmjs.org/-/ping | 官方 npm registry 可达性 |
| registry.npmmirror.com/-/ping | 标准中国镜像 |
| github.com | dsh 源码安装 / 文档 |
| raw.githubusercontent.com | 原始文件下载 |
| huggingface.co | 模型/资源下载 |
| gitee.com | 国内备用 |
| 127.0.0.1:7897 / 127.0.0.1:10809 | 常见本地代理端口（Clash / V2Ray） |

为什么需要它

- 中国 dsh 用户最常见的首小时失败是网络问题：pnpm dlx @deepseek-ai/dsh 卡住或 ERESOLVE，GitHub clone 超时，raw.githubusercontent.com 无法访问。
- 现有工具只告诉你某些东西坏了；这个工具告诉你是什么以及接下来该运行什么——镜像 registry、代理环境变量，或者什么都不需要。
- 零运行时依赖，默认只读，且 apply 路径只是一个单一、显式、可逆的 registry 设置。

开发

pnpm install
pnpm typecheck
pnpm build
pnpm test
pnpm test:integration
CI 在 Windows 上运行 dsh-plugin-doctor 预检、单元测试、打包产物集成（真实 cn_boot 调用），以及全新 profile 的 dsh web 启动冒烟。

许可证

MIT © 2026 zoahdev

dsh-cn-boot（中文）

DeepSeek Harness（dsh）的国内网络引导插件：一条命令告诉你安装为什么慢/坏，以及该怎么做。

它探测国内 dsh 用户最关心的端点——npm 官方源、npmmirror、GitHub、raw.githubusercontent、Hugging Face、Gitee——以及常见本地代理端口（127.0.0.1:7897 / 10809），读取当前 npm/pnpm 注册表配置，返回具体建议和一份可直接复制的引导脚本（PowerShell + bash）。默认只读；apply 是显式开关，唯一副作用是把 npm/pnpm 注册表设为 npmmirror。

安装

dsh plugin add dsh-cn-boot

独立使用：

npx dsh-cn-boot

CLI

dsh-cn-boot [--apply] [--json] [--timeout ]

- 输出探测结果、建议和 PowerShell + bash 引导脚本。
- --apply 在推荐时执行 pnpm config set registry https://registry.npmmirror.com（以及 npm）——唯一的副作用。
- 退出码：0 网络正常，1 有建议，2 用法错误。

npx dsh-cn-boot
npx dsh-cn-boot --apply
npx dsh-cn-boot --json

在 harness 内使用（agent 可调用）

对 agent 说：

检查一下我的网络连 dsh 依赖源通不通，给个引导建议。

工具返回 dsh-cn-boot/v1 结果：各目标探测结果、当前注册表配置、建议、生成脚本，以及（仅当 options.apply: true 时）已执行的操作。

为什么需要它

- 国内 dsh 用户第一小时的失败大多是网络问题：pnpm dlx @deepseek-ai/dsh 卡住或 ERESOLVE、GitHub clone 超时、raw.githubusercontent 不通。
- 现有工具只告诉你“坏了”；这个插件告诉你“哪里坏、下一步跑什么”——换镜像、走代理，或者什么都不用动。
- 零运行时依赖、默认只读，apply 路径是单一、显式、可逆的注册表设置。

开发

pnpm install
pnpm typecheck
pnpm build
pnpm test
pnpm test:integration

CI 跑 dsh-plugin-doctor 预检、单元测试、打包集成（真实 cn_boot 调用）、Windows 全新 profile 的 dsh web 启动冒烟。

许可证

MIT © 2026 zoahdev
相关生态工具

- dsh-dep-audit - 依赖供应链卫生
- dsh-quality-score - 插件质量评分卡 + 全注册表排行榜
- dsh-ecosystem - 健康扫描、影响、趋势、实时仪表盘
- dsh-tutorials - 双语插件流水线教程 FAQ

- How do I install? dsh plugin add dsh-cn-boot or run the CLI directly (see README).
- Does it need an API key? No.
- Is it read-only? Yes by default; any write/apply is an explicit flag.
示例

完整 CLI 用法见 README。快速开始：

npx dsh-cn-boot --help