dsh-doctor-windows

by sublatesublate-design

开发与运行时github收录于 08-23

DeepSeek Harness 的 Windows 环境诊断:新增仅人类可用的 /doctor-windows 命令,模型供应商不可用时也能用

Windows environment diagnostics for DeepSeek Harness. The plugin adds a human-only /doctor-windows command, so it still works when the model provider is unavailable.

安装

dsh plugin --profile web add github:sublatesublate-design/dsh-doctor-windows

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络,DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单,不构成兼容性或安全审查;安装前请审阅源码,不熟悉的插件先在不含密钥的环境试用。

README

目录

DeepSeek Harness 的 Windows 环境诊断插件。插件提供无需模型的 /doctor-windows 命令,因此模型提供方不可用时仍能运行。

诊断内容

  • Harness、Node.js、操作系统和 CPU 架构版本。
  • 当前工作区是否可读、可写。
  • 可能被部分预览版原生目录选择器截断的 UTF-16 低字节为零字符。
  • 代理环境变量与 Node 的 NODE_USE_ENV_PROXY 启动设置。Node 从 22.21.0 和 24.0.0 开始提供内置环境代理支持。
  • 查找并实际以非交互方式启动 PowerShell 7(pwsh)和 Windows PowerShell。
  • 加载 Harness 原生目录选择器实际使用的 Koffi,并执行一次无副作用的 GetCurrentProcessId 调用。

命令不会输出代理 URL 或凭据值,不会修改设置、打开目录选择器或发起网络请求。

从本地目录安装

先构建并验证:

pnpm install
pnpm run check

安装到 Web profile:

dsh plugin --profile web add C:\path\to\dsh-doctor-windows
dsh --profile web --dump-config
dsh web

打开工作区后执行:

/doctor-windows

卸载:

dsh plugin --profile web remove dsh-doctor-windows

从 GitHub 安装

Git 依赖会运行本包的 prepare 脚本。pnpm 10 及以上版本需要先在 profile 的 pnpm-workspace.yaml 中允许准确的包名,然后安装固定 commit:

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

只应允许运行来源可信的构建脚本。

配置

可以在 profile 的 cordis.patch.yml 中覆盖组合包配置:

- id: doctor-windows
  name: dsh-doctor-windows
  config:
    commandName: doctor-windows
    processTimeoutMs: 5000
    processGraceMs: 1000
    maxOutputBytes: 16384
    checkNativePicker: true

开发验证

pnpm run typecheck
pnpm run test
pnpm run build
pnpm run smoke
pnpm pack --dry-run

许可证

MIT

原始 README: https://github.com/sublatesublate-design/dsh-doctor-windows/blob/main/README.zh.md ↗