前言¶
在 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 查看。
