前言¶
在 Windows 環境下使用 DeepSeek Harness 時，原生文件夾選擇器可能因字符編碼問題截斷文件名，代理配置或 PowerShell 版本也可能影響運行。dsh-doctor-windows 插件用於診斷這些環境問題，確保插件和 Harness 能在本地正確運行。
插件介紹¶
dsh-doctor-windows 是 DeepSeek Harness 的一個診斷插件，用於檢查 Windows 環境的各項配置。它由 sublatesublate-design 維護，核心價值在於排查環境配置導致的運行異常。
核心功能¶
該插件主要檢查以下內容：
- 系統與版本信息：檢查 Harness、Node.js、平臺及架構的版本。
- 工作區權限：檢查當前工作區是否可讀、可寫。
- 字符編碼問題：檢測 UTF-16 低字節零字符，這類字符可能導致原生文件夾選擇器截斷文件名。
- 代理配置：檢查代理環境變量及 Node.js 的
NODE_USE_ENV_PROXY啓動設置。 - PowerShell 環境檢查：探測 PowerShell 7 (
pwsh) 和 Windows PowerShell 的發現與啓動情況。 - Koffi 安裝：檢查由 Harness 原生文件夾選擇器擁有的 Koffi 安裝狀態。
安裝與啓用¶
安裝前請確保已安裝 Node.js，版本要求爲 ^22.19.0 || >=24.0.0。
- 運行安裝命令，將插件添加到 Web 配置文件中：
dsh plugin --profile web add github:sublatesublate-design/dsh-doctor-windows#v0.1.0
- 安裝完成後，在 Harness 工作區中運行命令：
/doctor-windows
卸載¶
如需移除該插件，執行以下命令：
dsh plugin --profile web remove dsh-doctor-windows
適用場景與注意事項¶
該插件以當前 DSH 進程的權限運行。使用時請注意以下限制：
- 隱私安全：不會打印代理 URL 或憑據值。
- 行爲限制：不會更改系統設置，不會打開文件夾對話框，也不會發起網絡請求。
- 源碼信任：插件通過 pnpm 安裝，僅允許構建腳本從信任的源運行。
總結¶
dsh-doctor-windows 提供了針對 Windows 平臺的環境診斷能力，幫助開發者快速定位環境配置問題。插件維護信息可在 GitHub 查看。
