前言¶
在 DSH 生态里，常见做法是让桌面端 Harness 直接接模型、用插件扩展工具面。若你希望由 Codex 这类主管客户端制定验收标准、在关键节点暂停并提问、对 DSH 写出的成果做独立检查并在同一会话里退回修改，就需要一条稳定的 MCP 链路和一套明确的监督流程。社区插件 linglanxin/codex-dsh-bridge（仓库名 codex-dsh-bridge，npm 包名 dsh-desktop-mcp-bridge）面向 Windows，在 DSH Desktop MCP Bridge 之上做实验性适配与流程扩展，把「Codex 收任务、DSH 执行、问题与验收回传 Codex」串成可配置工作流。
这是什么¶
linglanxin/codex-dsh-bridge 由维护者 linglanxin 发布，分类为工作流。一句话定位：Codex 接收任务并监督进度，DeepSeek Harness Desktop 通过 MCP 异步执行；遇到方向问题会阻塞式提问并回传 Codex，执行前后有计划检查点与成果验收，文件变化会使旧验收失效。项目为社区插件，保留上游 MIT 许可与第三方归属，与 OpenAI、DeepSeek 无官方隶属关系。
当前公开预发布版本为 0.2.1-rc3-windows.6（package.json 中 engines.dsh 为 0.2.1-rc.3，Node ≥22.19.0）。市场说明明确限定 DSH Desktop 0.2.1-rc.3 / Cordis 4.0.5 / Schemastery 3.18.5、Windows；其他版本不应跳过兼容性检查。
核心功能¶
下面介绍 README 与安装文档中已写明、且在本仓库验证记录中出现的能力。
连接与 MCP¶
- Windows 命名管道通信与本地认证，连接已运行的 DSH Desktop。
- MCP 异步派发、事件等待、状态查询、取消和显式恢复。
- 结构化方向问答，绑定任务和问题编号。
监督与验收¶
- 写入前的计划检查点、执行后的独立验收与退回修改。
- 成果指纹：验收后的文件变化使旧验收失效。
- 首版串行执行；关闭 Codex 聊天后的自动唤醒尚未实现；取消保留已写文件，中断后需检查成果并显式恢复。
任务隔离与工作区¶
- 独立任务目录、限制路径的文件工具及 Windows 状态目录权限检查（windows.6 起用 .NET 读取 DACL，避免精简环境中
Get-Acl阻塞）。 - 可指定 DSH 工作区名称（如文档示例
"workspaceTitle": "codex自动"），桥接创建的会话自动归入该工作区。
运行边界（文档原文）¶
DSH 默认只获得任务目录内的文件工具；构建、命令运行和外部核验可由 Codex 处理。输入材料由 Codex 在计划审查前按授权范围准备。任务目录限制并非操作系统级沙箱。插件以当前 DSH 进程权限运行；状态目录与认证文件应保持私有。
数据流可概括为：
用户 → Codex → MCP → DSH Desktop 插件
↑ ↓
└─ 问题 / 检查点 / 成果 ─┘
修复版 windows.6 在本机及 GitHub Windows / Node.js 24.22.1 上通过 37 项自动检查（见 Actions 记录）。README 还记录了真实模型完成「提问 → 答复 → 计划审查 → 写文件 → 验收」以及同一会话「初稿 → 退回修改 → 复验通过」的联调；长期稳定性尚未验证。
安装与启用¶
安装步骤以 市场安装说明 为准。DSH 官方尚无统一上传中心；本项目提供公开仓库、预发布包与仅含此插件的索引，不代表官方审核或背书。社区目录页：skillhub.cn 插件页。
1、在 DSH Desktop 安装插件¶
方式 A：自定义市场索引
在支持自定义索引的 DSH 市场「索引源」中添加：
https://raw.githubusercontent.com/linglanxin/codex-dsh-bridge/main/market-index.json
再选择此插件的 next 版本。索引使用确切 Git 提交，仓库含构建产物，安装无需本地构建。
方式 B：本地 Release 包
预发布下载：v0.2.1-rc3-windows.6。下载 .tgz 后，在桌面版插件页「添加插件」选择本地文件，或使用：
dsh plugin --profile desktop add <下载的 .tgz 的完整路径>
保存正在进行的工作，按 DSH 提示重新加载或重启，再启用 「桌面端 MCP 桥接（非官方）」。不需要更改模型账号或复制模型密钥。
2、为 Codex 等 MCP 客户端安装桥接命令¶
市场安装的是 DSH 侧插件；MCP 客户端还需同一份 Release 中的 CLI：
npm install --global https://github.com/linglanxin/codex-dsh-bridge/releases/download/v0.2.1-rc3-windows.6/dsh-desktop-mcp-bridge-0.2.1-rc3-windows.6.tgz --ignore-scripts
dsh-desktop-mcp setup
默认状态与任务目录为当前用户主目录下的 .dsh-mcp-state/config.json 与 .dsh-mcp-work。若自定义目录，给 setup 同时传入 --state-dir 和 --workspace-root，并在 DSH 插件配置 configFile 中填写生成的完整配置文件路径；MCP 命令使用相同 --config。
MCP 客户端启动命令设为 dsh-desktop-mcp，参数为 stdio。另开终端运行：
dsh-desktop-mcp doctor
验证与已运行 Desktop 的连接。新电脑上的真实 DSH 连接仍建议以 doctor 为准；windows.6 文档说明本次未新增新的真实模型联调。
典型用法¶
经过上面的步骤，主管侧（Codex）通过 MCP 调用桥接，DSH 在桌面端执行任务目录内允许的工具；计划在写入前经检查点，成果经 Codex 侧验收，不通过可在同一会话退回修改。
若需按工作区收纳会话，在私有配置 JSON 中增加工作区标题，并保留文档要求的工具白名单字段，例如：
"workspaceTitle": "codex自动",
"allowedTools": []
重新加载插件后，新任务会话进入该工作区，文件仍落在各任务子目录。默认只允许桥接任务目录内的五个监督和文件工具；命令执行、外部检索和独立验收由主管客户端承担。
开发侧复现检查（需 Node.js 22.19+、npm 与已配置模型的官方 DSH Desktop；Windows 验证环境建议 Node.js 24）：
npm ci --ignore-scripts
npm run check
适用场景与注意¶
适合谁： 在 Windows 上使用 DSH Desktop 0.2.1-rc.3，且希望用 Codex（或其它 MCP 主管客户端）做任务分解、阻塞式方向确认、计划审查与成果验收的团队或个人。
务必注意：
- 平台与版本边界明确为 Windows 及文档列出的 Cordis / Schemastery 版本；勿在生产环境跳过兼容性检查。
- 插件以当前 DSH 进程权限运行；安装前应阅读源码、LICENSE 与 NOTICE，并用 Release 中的
SHA256SUMS.txt核对包完整性。 - 不要公开
.dsh-mcp-state、认证文件、模型配置或任务材料；仓库不包含本机认证令牌与 Desktop 二进制。 - 未实现读取任意历史会话、后台自动唤醒已关闭的 Codex 聊天、跨版本自动恢复或 OS 级隔离。
结尾¶
codex-dsh-bridge 把 Codex 的监督语义（MCP 委派、阻塞提问、阶段审查、修改与成果校验）落到 Windows 上的 DSH Desktop，适合需要「主管—执行」分工而非单端全自动闭环的场景。细节与验证记录见 GitHub 仓库 linglanxin/codex-dsh-bridge 与社区目录 https://www.skillhub.cn/plugins/linglanxin/codex-dsh-bridge。
