DeepSeek Harness 在 Windows 上装不顺?dsh-win32 三步走:检查、修复、验收

DSH 在 Windows 原生环境跑不动、终端行为怪异、装完插件没反应——这类问题多数不在 DSH 本体,而在 Windows 侧的运行时栈。dsh-win32 是开发者 sjh9714 出品的开源工具(MIT 许可,GitHub 仓库与 npm 包在册),定位就一件事:检查当前 DSH 官方的 Windows 栈——持久 PowerShell 与 Windows ACL 沙箱——找出已知故障,修复能证明安全的问题,并给出可核对的验收。它不安装 Git、不代装 PowerShell、不装 busybox 或 WSL,也不往系统里再塞另一份 DSH;当前版本以独立命令行工具方式使用,官方文档明确提醒不要用插件安装命令来装它——那会装到旧的遗留包。

它能做什么

  • setup 一条命令起步:检查 DSH 官方 Windows 包契约、PowerShell 7 与已知损坏的 koffi 运行时,创建 DeepSeek Harness 桌面快捷方式,官方配置与 Minimal 预设保持原样;装完照提示打开 DSH、添加工作区即可开始
  • verify 实测验收:不调用模型、不填密钥,在隔离的临时环境里实测已安装的栈——PowerShell 7 能启动、两次调用保持同一终端会话与状态、工作区内读写正常、越界写入被拒且不留文件、拒绝后能恢复、资源清理干净;任何一环不达标即失败
  • doctor 体检:校验发布包契约并检查本地已知故障,输出结构化结果,装机脚本与工单系统可以直接消费
  • fix 保守修复:只修已知损坏或实际加载失败的 koffi 版本,修完再验一次,不动其余任何东西
  • 遗留版本兼容:更早的 DSH 版本没有官方 PowerShell 栈,Git Bash 与 busybox 旧预设保留在显式标志后面,老环境也有路可走
  • 诚实边界:官方文档明确说明验收属于组件链验证而非端到端会话证明;拦截规则是否真的生效,需要自己跑一次应当被拒绝的无害测试确认——不夸大、不含糊

怎么获取

官方渠道是 GitHub 仓库 sjh9714/dsh-win32 与 npm 包仓库。Windows 上打开 PowerShell 执行 npx dsh-win32 setup 即可;建议先装好 PowerShell 7(工具不代装)。加参数可以不建桌面快捷方式,或为指定的其他 profile 配置。

上手怎么用

  1. 新装环境先 setup:装完 DSH 跑一遍,把快捷方式、包契约、运行时三件事一次配齐,照提示从 Minimal 预设起步
  2. 疑似故障找 doctor:DSH 起不来、行为异常,先跑 doctor 看结构化结果,别急着重装系统级组件
  3. 批量装机用 verify:在交付前的机器上跑实测验收,避免「装了但沙箱没生效」这类看不见的隐患
  4. 改完拦截规则做测试:调整限制或升级 DSH 后,跑一个应当被拒绝的无害操作,确认动作真的被拦住
  5. 报告问题带结构化结果:命令支持输出结构化结果,附给问题跟踪即可;输出不含测试路径与终端内容,安全顾虑小

适合谁用

在 Windows 上部署 DSH 的开发与运维人员,负责批量装机、环境标准化的 IT 支持团队。它把「Windows 上能不能跑好」变成可执行的检查清单与可交付的验收记录——环境问题前置到装机环节解决,比事后救火省得多。开源许可,内部使用与二次封装按许可条款执行即可。