前言¶

在 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