dsh-doctor-windows：一键诊断 Windows 下的 Node、PowerShell、Koffi 与路径问题

[sublatesublate-design]

项目简介

我做了一个社区插件 dsh-doctor-windows，为 DeepSeek Harness 增加无需调用模型的 /doctor-windows 命令，用来快速定位 Windows 环境中常见的安装和运行问题。

它目前检查：

• Harness、Node.js、Windows 与 CPU 架构版本；
• 当前工作区是否可读、可写；
• 工作区路径中可能触发部分预览版原生目录选择器截断的 UTF-16 低字节为零字符；
• HTTP_PROXY / HTTPS_PROXY 等代理变量与 Node 环境代理开关；
• PowerShell 7（pwsh）和 Windows PowerShell 是否可发现、能否以非交互方式真实启动；
• Harness 原生目录选择器实际使用的 Koffi 能否加载，并执行一次无副作用的 GetCurrentProcessId 原生调用。

安全边界

诊断过程是只读的：不会修改 Harness 配置，不会输出代理 URL 或凭据值，不会打开目录选择器，也不会发起网络请求。PowerShell 探针使用 Harness 自己的 subprocess 服务运行，带超时、进程树终止和输出上限，因此测到的是实际执行链路。

安装

dsh plugin --profile web add github:sublatesublate-design/dsh-doctor-windows#v0.1.0

GitHub 源码安装会运行 prepare。如果 pnpm 阻止构建，请按 DSH 的提示在该 profile 的 pnpm-workspace.yaml 中加入：

allowBuilds:
  dsh-doctor-windows: true

然后重新执行安装命令。也可以从 v0.1.0 Release 下载预构建的 .tgz，避免源码构建授权。

安装后打开一个工作区，输入：

/doctor-windows

验证情况

当前版本已在 Windows x64 上验证：

• DeepSeek Harness 0.1.0-rc.6
• Node.js 24.14.1
• PowerShell 7 7.6.4
• Windows PowerShell 5.1.26100.9168
• Koffi / kernel32 真实调用通过
• 7 个单元测试、类型检查、构建、打包及隔离 Web profile 安装通过

项目地址：https://github.com/sublatesublate-design/dsh-doctor-windows

欢迎提供不同 Windows 版本、ARM64、公司代理、非 ASCII 工作区路径以及 PowerShell 安装方式下的诊断输出或问题反馈。请在反馈前删除用户名、目录名等不希望公开的信息。

---

English summary

dsh-doctor-windows is a community plugin that adds a model-independent /doctor-windows command to DeepSeek Harness. It checks the supported Node range, workspace access and UTF-16 path hazards, proxy startup configuration, real pwsh/Windows PowerShell execution, and the Koffi dependency used by the native folder picker.

The checks are read-only: no credentials or proxy URLs are printed, no settings are changed, no folder dialog is opened, and no network request is made.

Repository: https://github.com/sublatesublate-design/dsh-doctor-windows
Release: https://github.com/sublatesublate-design/dsh-doctor-windows/releases/tag/v0.1.0