DeepSeek Harness (DSH) 的会话遵循单写者约束：当桌面持有会话写锁时，外部进程的写入会被拒绝。本插件通过“持锁宿主代投”机制，为 Codex 等外部驱动提供了一条协作通道，解决任务派发、独立开发与结果交回审查的流程打通问题。
核心功能¶
插件本身不处理代码生成，仅负责通信与同步。主要能力包括：
- 工作区同步与文件投递：支持工作区定期自动同步、手动刷新，以及文件投递箱功能，将外部登记的工作区同步到桌面侧栏。
- 会话消息投递：允许向桌面当前持有的 DSH 会话投递任务或审查意见。
- Git 状态交回：开发者完成提交、推送与 PR 后，插件通过
dsh2codex校验 Git 状态，将验证摘要与 PR 信息交回指定的 Codex 对话。 - 零运行时依赖：插件仅使用 Node.js 内置模块，无需安装额外的 npm 包。
安装与启用¶
- 打开 DeepSeek Harness 的 设置。
- 进入 插件 菜单。
- 点击 添加插件。
- 输入仓库地址：
https://github.com/heswy/dsh-plugin-codex-bridge
安装后确保插件处于启用状态，并保持 DSH 桌面运行。
典型用法¶
该插件配合 Codex 侧的 codex2dsh skill 和 DSH 侧的 dsh2codex skill 使用，形成一个完整的协作闭环。
工作流程：
1. Codex 通过 codex2dsh 登记工作区、创建会话并投递任务。
2. DSH 在任务工作区实施与验证，插件将外部登记的工作区同步到桌面侧栏。
3. 开发者完成提交、推送与 PR 后，dsh2codex 校验状态并通知指定的 Codex 对话。
4. Codex 在原会话内投递审查意见，DSH 继续修复与验证。
查看会话索引：
运行以下命令查看宿主发布的会话索引与交回 CLI 能力：
node tools/send.mjs --list
检查 CLI 能力：
运行以下命令预演或检查 Codex 侧的 CLI 能力：
python3 skills/dsh2codex/scripts/notify.py --probe
注意事项¶
- 权限与安全：插件以当前 DSH 进程的权限运行。它不自动提交、推送、创建 PR、合并或发布，所有 Git 操作需由用户授权决定。
- 协作机制：DSH 的会话单写者约束通过持锁宿主代投实现。若遇到
session/writer-held状态，需检查所有权与回执。 - 并发风险：多宿主同时写
workspace.json可能导致后写覆盖，插件定期对账但不提供跨进程事务。 - 平台兼容性：插件未在 Windows 上验证，PR 与 Git URL 校验支持
github.com。 - 同步方式：同步机制使用轮询与手动刷新，不抢占当前轮次。
总结¶
该插件为 Codex 与 DeepSeek Harness 之间提供了一个具体的开发协作桥梁，适用于 Codex 负责规划与审查、DSH 负责实施的工作流。相关文档与源码可在 GitHub 查看完整说明。
