dsh-subprocess-win32

这是给 DeepSeek Harness 的 Windows 支持包。它是 DSH Cordis 运行时插件，不是 Codex 插件。DSH 中显示的 运行时、Loader 和插件库存名称统一为 subprocess-win32。

包含内容

• Windows 版本地 subprocess 运行时替换：补齐 DSH 终端工具需要的进程检查、 Windows 清理和控制信号处理，并且只在 process.platform === 'win32' 时生效。
• Minimal (Windows)：持久 Git Bash + str_replace_editor 的极简预设。
• Anchored Standard (Windows)：低常驻工具集的标准预设。首轮只暴露极简的 两个工具；提升阶段常驻 dev_tool_search、skill_search、skill_load，其余 Standard 工具按需解锁。
• 显式 PowerShell 生命周期管理器：安装、诊断、更新、回退和完整卸载。没有 postinstall 脚本，不写系统 PATH，也不会静默提升权限。

当前包按 Windows 原生 DSH 0.1.0-rc.6、Node.js 24 和 Git for Windows 布局 测试。GitHub 仓库是源码发布，不代表已经发布到 npm。

运行时插件和 Agent 预设不是一回事

subprocess-win32 才是真正的 Cordis 运行时插件，可以在 DSH 的“插件列表”中 启用或停用。两个 Windows 模式是随插件提供的 Agent 预设。预设文件被删除， 或者宿主 profile 不再挂载预设时，预设选择项才会消失；停用运行时插件不会把 预设变成另一种插件。

独立仓库 dsh-anchored-standard-windows 只提供 Anchored 预设，特意不伪装成第二个 Cordis bundle。

两个仓库之间的关系

仓库	DSH 对象	作用	能否单独运行
dsh-subprocess-win32	Cordis 运行时 bundle	注册 subprocess-win32，提供 Windows subprocess 接口，并携带两个受管理预设的源码	可以作为运行时插件单独安装；预设可选
dsh-anchored-standard-windows	用户 Agent 预设包	只提供 Anchored Standard 组合和测试	不能；Windows 使用时需要前一个运行时插件

管理式安装时，只需安装或更新第一个仓库，让它的生命周期管理器渲染 Minimal (Windows) 和 Anchored Standard (Windows)。只有在想单独检查、测试或 分发 Anchored 预设时，才需要克隆第二个仓库。第二个仓库不会替代运行时插件；反过来， 只安装运行时插件也不会强制使用 Anchored Standard，可以选择 Minimal、Standard 或不启用该预设。

在其他 DSH profile 中安装

前置条件：Windows x64、Node.js 22.19+（推荐 Node.js 24 LTS）、Git for Windows 以及可用的 DSH。克隆本仓库后，将本地包加入目标 profile。支持插件命令的 DSH 版本可以使用：

dsh plugin --profile web add C:\src\dsh-subprocess-win32

如果当前 CLI 没有 add 子命令，就在 profile 的 package.json 中添加本地 依赖，并将 dsh-subprocess-win32 加入 dsh.profile.bundles，然后使用该 profile 自己的包管理器安装。不要把这个包直接放进 DSH 核心版本目录。

本包的 Cordis patch 只在 Windows 停用官方 subprocess 并插入 subprocess-win32；Linux 和 macOS 继续使用官方运行时。

当前管理式安装的显式入口：

$setup = "$env:LOCALAPPDATA\DeepSeekHarness\setup\dsh-subprocess-win32.ps1"
& $setup -Action doctor
& $setup -Action setup -PackageSource C:\src\dsh-subprocess-win32

安装后请新建一个空会话，再选择 Minimal (Windows) 或 Anchored Standard (Windows)；已有会话保留创建时的 Agent 组合。

更新和回退

DSH 核心更新与本包更新分开进行。让新源码目录与当前目录并存，不要原地覆盖。 先执行只读检查：

& $setup -Action doctor
& $setup -Action update -DryRun -PackageSource C:\src\dsh-subprocess-win32

确认清单和测试结果后再应用：

& $setup -Action update -PackageSource C:\src\dsh-subprocess-win32
& $setup -Action rollback

管理器会备份 profile、保留上一包，并在失败时恢复活动版本指针和 profile 文件。 它不会自动升级第三方 DSH bundle 或 Codex 插件。

完整卸载

先预览，再执行删除：

& $setup -Action uninstall -DryRun
& $setup -Action uninstall

卸载器根据安装清单，只停止登记的 DSH 进程/任务，删除两个 DSH 预设和专用的 %LOCALAPPDATA%\DeepSeekHarness 根目录，并做残留审计。它不会删除项目源码、 .agents\skills、.codex\skills、Codex 插件、Codex MCP 原始配置或其他 Edge 应用。需要备份时使用管理器的导出选项；不要在 Host 运行时手工删除根目录。

Windows 限制和安全注意事项

• DSH 的 workspace-write 受限令牌下，Git/MSYS Bash 可能返回 0xC0000142。完整权限验证已通过；本包不会放宽权限、绕过审批或静默选择 danger-full-access。
• Windows 回退路径没有 Linux landlock 隔离，请把命令输出当作不可信数据， 保留 DSH 的审批策略。
• “极简”指模型可见的工具 schema 和提示词表面尽量接近 Minimal，不声称 Windows 变成 Linux 内核，也不保证所有任务的延迟、缓存命中或完成率相同。
• 不要把 Codex 的 .codex-plugin 清单复制到本包。Codex 插件、DSH Cordis bundle、Agent 预设、Skills 和 MCP 使用不同加载器；只有明确兼容的 SKILL.md 和 MCP Tools 配置可以共享。

开发和测试

使用 DSH 自带 Node.js（或 Node.js 22.19+）：

npm test

测试覆盖预设阶段切换、首轮上下文抑制、工具发现、压缩恢复和 Windows subprocess 适配器；不代替模型提供商、API 密钥或沙箱策略的配置检查。

参考项目和致谢

本项目是集成和 Windows 适配，不代表 DeepSeek、OpenAI 或上游维护者背书。

• DeepSeek Harness：官方 预设、Skills、Cordis bundle 和 MCP 设计。
• sjh9714/dsh-win32：固定源码提交 f8a68a9836b84fdfec5c1f36ab60cea9923c689f，提供 Windows subprocess 方向。
• xiaobright/dsh-anchored-standard： 固定源码提交 f57a1bde2dbaba3039bdae8631f78a0cb3ae3ebe，提供两阶段 Agent 预设思路。
• Anchored Standard issue #24： 说明应在当前 Agent scope 中解析工具 schema。

感谢 DeepSeek Harness 和社区贡献者公开运行时接口、预设实验、测试和问题报告， 使这个 Windows 包成为可能。许可证和来源信息见 NOTICE。