Developers in China using DeepSeek Harness (DSH) often encounter issues such as sluggish pnpm dlx @deepseek-ai/dsh, ERESOLVE errors, or download timeouts from GitHub/Hugging Face. DSH follows the philosophy that “everything is a plugin,” and zoahdev/dsh-cn-boot aims to address this problem by providing endpoint probing, proxy detection, and registry configuration reading, helping users identify and resolve network connectivity issues.

What This Is

zoahdev/dsh-cn-boot is a China network bootstrap plugin for DeepSeek Harness (dsh). It probes endpoints of interest to users in China, such as the official npm registry, npmmirror, GitHub, raw.githubusercontent, Hugging Face, and Gitee; detects common local proxy ports; reads the current npm/pnpm registry configuration; and provides specific recommendations and bootstrap scripts based on the results.

The plugin is maintained by zoahdev and uses the MIT License.

Core Features

  1. Endpoint probing: probes connectivity to endpoints such as npm/GitHub/Hugging Face/mirrors.

  2. Proxy detection: detects common local proxy ports (such as 127.0.0.1:7897 / 10809).

  3. Configuration reading: reads npm/pnpm registry configuration.

  4. Guided recommendations: provides specific operational suggestions and copyable bootstrap scripts.

  5. Safe mode: read-only by default; apply is an explicit switch and only sets the registry to npmmirror.

Installation and Enablement

  1. Install it through the DSH plugin system:
dsh plugin add dsh-cn-boot
  1. Or run it directly as a standalone tool:
npx dsh-cn-boot

Typical Usage

  • Check network and get recommendations:
    dsh-cn-boot
  • Apply recommendations (modify registry):
    dsh-cn-boot --apply

  • Invocation inside an Agent: In a DSH agent call, request execution of the cn_boot tool.

  • Exit codes: 0 means the network is normal; 1 means recommendations are pending; 2 means usage error.

Applicable Scenarios and Notes

This tool is suitable for DSH users who need to troubleshoot network issues or optimize dependency installation speed.

  • Read-only by default: The plugin is read-only by default and does not silently modify system configuration; only when the --apply parameter is explicitly used does it set the npm/pnpm registry to npmmirror.
  • Permissions and dependencies: zero runtime dependencies and runs with the current process privileges.
  • Audit: Please confirm the source code and license before use.

Conclusion

zoahdev/dsh-cn-boot addresses the pain point of “only telling you it is broken” by providing concrete endpoint probing and registry configuration recommendations. Its read-only by default design reduces risk, making it suitable as a network diagnostics assistant in the DSH ecosystem.