让 Minimal 模式在 Windows 上真正可用:补上缺失的 win32 进程探测,常驻 Git Bash shell 才能正常工作;附还原度高的 minimal-windows 预设与安装排障工具(koffi 崩溃、PS 5.1 回退、localhost 403)。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-win32
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:sjh9714/dsh-win32
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本。请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
让 DeepSeek Harness 在 Windows 上成为一等公民。
English ·

| 官方 DSH(Windows) | 装上 dsh-win32 | |
|---|---|---|
| 极简模式 | 无法使用。持久 shell 一启动就抛 terminal inspection is unsupported on platform win32 |
可用。真正的持久 Git Bash,状态跨调用保留 |
| 安装深坑 | koffi 崩溃链、PS 5.1 崩溃循环、localhost 403、System32 假 bash | 一条 doctor 命令逐项指出问题和修法 |
| 启动 | 每天早上去 GitHub 找 npx 命令 | npx dsh-win32 setup(可选桌面快捷方式) |
为什么做这个
社区反复实测说 DeepSeek 模型在 DSH 的极简模式下表现最好。但在 Windows 上,极简模式根本跑不起来:它的持久 bash 需要 PTY,而官方 subprocess 运行时在 win32 上解析平台进程探测器时直接抛错,连 node-pty 都没碰到。所有 Windows 用户都被挡在模型对齐得最好的那个模式之外。
dsh-win32 用三个部分补上这个缺口。
- Windows 版 subprocess 运行时。 与官方运行时完全一致,只补上缺失的 win32 ProcessInspector(进程树与身份用 CIM,信号用 taskkill)。通过 bundle patch 仅在 win32 上替换,其他平台原样保留官方实现。
minimal-windows预设。 忠实复刻官方极简模式,唯一改动是把 PTY shell 换成你机器上的 Git Bash。同样的完整 persona、同样的双工具、同样不做压缩。- doctor 体检。 覆盖社区踩过的坑:koffi 3.1.3/3.1.4 损坏预编译(安装失败、目录选择器崩溃、会话保存闪退)、缺 PowerShell 7(5.1 回退在沙箱里 0xC0000142 崩溃循环)、localhost 与 127.0.0.1 的 403、System32 里的 WSL 假 bash。
安装
dsh plugin --profile web add dsh-win32 # 接入运行时 bundle
npx dsh-win32 setup # 安装预设 + 输出体检报告
npx dsh-win32 setup --shortcut # 同上,外加桌面快捷方式
预设立即出现在选择器里,无需重启。需要 Git for Windows(winget install Git.Git)。
实证
- CI 跑在真实
windows-latest上:构建运行时、经它拉起持久 Git Bash PTY、验证状态跨写入保留(第一次STATE=x,第二次echo $STATE)。官方运行时在同一任务上必然失败,因为探测器缺口就在启动路径上。 - 单元测试覆盖进程树排序、PID 复用成环、身份匹配、信号映射。
诚实的限制(v0.1)
- Windows 没有前台进程组概念,持久 shell 里长命令的中断能力降级。v0.2 计划用 Ctrl-C 注入实现。
- Windows ACL 受限令牌沙箱下的行为尚未验证(MSYS 系 shell 在其中已知困难)。如果
workspace-write下 shell 起不来,暂用danger-full-access,等 v0.2。欢迎反馈。 - 基于 DSH
0.1.0-rc.6开发。DSH 是开发者预览版,官方已声明会有破坏性变更。版本锁定,每次 rc 更新快速跟进。
License
MIT。预设组合复刻自官方极简模式(MIT)并注明出处。踩坑清单提炼自 DSH 官方讨论区的社区报告。
链接
同类插件
strukto-ai/mirage#dsh★ 3435
把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Slack、Gmail、Notion、Postgres)而非宿主磁盘,支持按挂载点设置读/写/执行模式、按命令选择沙箱(进程内 monty、pyodide、quickjs;远程 docker、e2b、daytona),并可在虚拟终端中安装 CLI(git、gh、slack、linear、ntn、gws,或自行注册的程序树)作为命令头词。
hust-open-atom-club/oh-dsh★ 179
社区发行版:TUI、桌面端与 Web UI 统一体验,分层安装、一步到位。
Jayden-X-L/forkprobe★ 65
同一任务并行试跑多个技能,对比结果选出最优。
vlln/plugin-registry★ 40
插件生态基建:浏览器面板管理官方 repository 插件(0 patch)+ make-dsh-plugin 插件开发引导技能。
forrestchang/dsh-multica-runtime★ 33
让 dsh 运行时跑在 Multica 上。
DietCokewithSugar/dsh-user-experience★ 18
帮你发现项目中可能存在的用户体验问题:自动走查 React/TypeScript 源码,定位问题并给出具体优化建议。