前言¶

在 Windows 环境下部署或使用 DeepSeek Harness (DSH) 时，环境配置错误、Node.js 版本不兼容或配置文件损坏常导致启动失败。排查这些问题往往需要手动检查系统路径、环境变量和配置文件。

dsh-doctor-windows 是一款针对 Windows 系统的只读诊断工具。它通过检查命令解析、Node.js 版本、DSH_HOME 可达性、配置清单和 Cordis 补丁等关键点，生成诊断报告。工具本身不执行 DSH shim，也不发送任何网络请求或遥测数据。

插件定位¶

• 性质：非官方
• 维护者：xianfanwindy
• 许可证：MIT
• 核心特性：只读诊断、本地执行、隐私保护

核心能力¶

该工具主要对 DSH 及系统配置进行只读检查，不修改任何文件，也不进行网络交互。

1. 环境基础检查
   - 检查 dsh 命令是否可解析。
   - 检查 Node.js 版本是否符合要求（^22.19.0 || >=24.0.0）。
   - 检查 DSH_HOME 路径是否可达。

2. 配置与依赖检查
   - 检查配置文件清单。
   - 检查 Cordis 补丁。
   - 检查直接包链接。

3. 安全与隐私
   - 无网络请求：不会向任何服务器发送数据。
   - 无遥测：不收集使用行为数据。
   - 不执行 Shim：不会调用发现的 DSH shim 执行。
   - 不读取敏感文件：不读取 .credentials.yaml 或 .env。
   - 数据脱敏：在报告中自动脱敏已知 homes、DSH_HOME、临时路径、URL 凭证、高熵值等敏感信息。

4. 报告输出
   - 支持终端、Markdown、JSON 三种格式。

安装与启用¶

全局安装：

npm install -g dsh-doctor-windows

在 Cordis 环境中启用：

dsh plugin --profile web add dsh-doctor-windows

使用方式¶

CLI 基础用法：

dsh-doctor

指定 profile 进行诊断：

dsh-doctor --profile web

导出 Markdown 报告：

dsh-doctor --profile web --format markdown --output .\dsh-doctor-report.md

导出 JSON 报告（不显示颜色）：

dsh-doctor --profile web --format json --no-color

报告与隐私¶

• 退出代码：0 表示无阻碍，1 表示存在阻碍，2 表示参数错误或初始化失败。
• 报告性质：诊断证据，而非最终解决方案。
• 隐私保护：报告仅在本地生成，不会上传。所有已知敏感路径和凭证类值都会被脱敏。

适用场景与注意¶

• 系统要求：
• 操作系统：Windows 10 或 Windows 11。
• Shell：PowerShell 5.1 或 PowerShell 7。
• Node.js：^22.19.0 || >=24.0.0。

• 需要确保 dsh 命令已添加到系统 PATH。

• 限制说明：

• 版本 1 仅支持 Windows，不支持 macOS 或 Linux。
• 不支持自动修复、GUI 界面或插件安装自动化。
• 配置文件格式为 DSH 预发布输入，可能随版本变化。

结语¶

dsh-doctor-windows 为 Windows 下的 DSH 用户提供了快速定位环境配置问题的手段。通过只读检查和本地报告生成，可以在不泄露隐私的前提下，辅助开发者排查启动障碍。

• 插件目录：https://www.skillhub.cn/plugins/xianfanwindy/dsh-doctor-windows
• 源码地址：https://github.com/xianfanwindy/dsh-doctor-windows