Aloneswork/deepseek-harness-codex-bridge
Codex 主导、DeepSeek Harness 辅助的本地双向 MCP 协作桥｜Local bidirectional Codex ↔ DSH MCP bridge
安装Install
dsh plugin --profile web add github:Aloneswork/deepseek-harness-codex-bridge把 Aloneswork/deepseek-harness-codex-bridge 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
DeepSeek Harness ↔ Codex 双向协作桥
简体中文 | English
这是一个非官方、本地运行的 MCP 桥，让 Codex 和 DeepSeek Harness 在同一项任务上分工协作。
Codex 负责主导、拆解和验收；它可以把边界清楚的子任务交给 DeepSeek Harness（DSH），接收进度与证据，通过持久消息盒子回复，再决定是否采用结果。DSH 运行时也能主动新建或继续一个真实的 Codex 任务。桥会阻止循环甩锅：接到子任务的 Agent 必须实际执行，不能把原任务原样退回。
不需要数据库服务或常驻守护进程，消息只保存在本机 JSON 文件中。
安装
需要：
- macOS 或 Linux
- Node.js
>=22.19.0 - 已安装并配置 DeepSeek Harness
- Codex CLI；只有 DSH 主动联系 Codex 时才需要
codex app-server
如未安装 DSH，先执行下面两行，并在 Web 界面中配置模型：
npm install --global @deepseek-ai/dsh
dsh web
安装桥并注册到 Codex：
npm install --global https://github.com/Aloneswork/deepseek-harness-codex-bridge/releases/download/v0.2.2/deepseek-harness-mcp-bridge-0.2.2.tgz
codex mcp add deepseek_harness -- deepseek-harness-mcp
建议在 ~/.codex/config.toml 中使用：
[mcp_servers.deepseek_harness]
tool_timeout_sec = 900
enabled_tools = [
"delegate_to_deepseek",
"list_deepseek_messages",
"reply_to_deepseek",
"get_bridge_task_status",
]
default_tools_approval_mode = "approve"
只有用户已经授权无需逐次确认调用 DSH 时，才应自动批准这些 MCP 工具。自动批准不包含删除、公开发布、付费服务、凭据或敏感数据传输等额外权限。
验证
注册 MCP 后新开一个 Codex 任务，让 Codex 委派一个无害测试，例如“返回圆周率前 10 位”。Codex 应通过 delegate_to_deepseek 收到 DSH 结果，并向用户说明 DSH 做了什么。
如需从源码测试：
git clone https://github.com/Aloneswork/deepseek-harness-codex-bridge.git
cd deepseek-harness-codex-bridge
npm install
npm test
给你自带 Agent 的一句话安装提示词
请从 https://github.com/Aloneswork/deepseek-harness-codex-bridge 安装并配置 Codex ↔ DeepSeek Harness MCP 双向协作桥；先检查 Node.js、Codex、DSH 和现有配置，保留并备份原配置，安装后做双向消息测试，最后报告所有修改文件、调用链和测试结果。
安装后有什么
deepseek-harness-mcp：供 Codex 或其他 MCP 客户端使用的 stdio MCP 服务。dsh-codex-mail：DSH 可通过 Bash 调用的消息盒子和主动聊天命令。
MCP 提供四个工具：
delegate_to_deepseek：新建 DSH 子任务并以 headless 模式执行。list_deepseek_messages：读取 DSH 的进度、证据、问题、阻塞和结果。reply_to_deepseek：写入 DSH 可读取的持久回复。get_bridge_task_status：查看任务归属、状态、工作区和关联的 Codex 任务。
DSH 在每个委派提示中都会收到 rootTaskId 和 taskId。它可以在终端发送进度：
dsh-codex-mail send \
--root-task-id ROOT_ID \
--task-id TASK_ID \
--kind milestone \
--body "解析器检查完成" \
--progress "100%" \
--evidence "测试样例通过"
DSH 运行时也可以主动联系 Codex：
dsh-codex-mail chat \
--root-task-id ROOT_ID \
--task-id TASK_ID \
--kind question \
--body "解析器是否保留这个回退逻辑？" \
--progress "全部样例已通过" \
--evidence "已附测试输出" \
--workspace /absolute/project/path
同一 taskId 第一次调用 chat 会新建并命名 Codex 任务，后续调用继续该任务。这是运行中的主动发起，不是永远在线：DSH 进程停止后，必须由外部调度重新启动，才能再次发消息。
存储和边界
- 消息和任务记录默认保存在
~/.dsh-codex-bridge/，文件权限仅限本机用户。 - 不要提交或分享消息盒子，其中可能包含项目提示和回复。
- MCP 客户端超时应不短于
DSH_BRIDGE_TIMEOUT_MS，默认值为900000。 - 委派提示最多 16,000 字符；大输入应放进工作区文件，再把文件路径交给 DSH。
- 可选变量：
DSH_BIN、CODEX_BIN、DSH_CODEX_MAILBOX_DIR、DSH_BRIDGE_TIMEOUT_MS、DSH_CODEX_CHAT_TIMEOUT_MS。
建议协作规则
- Codex 负责问题定义、任务拆解、协调、决策、集成、验证和最终答复。
- 只有用户已授权时，Codex 才可免逐次确认调用 DSH。
- DSH 必须执行收到的子任务，不能把它原样退回或再次转交。
- DSH 只能用进度、证据、结果、有进展支撑的问题或明确阻塞联系 Codex。
- 避免同时修改同一文件；委派不会扩大用户授权。
- 每次调用 DSH 后，都要报告委派内容、DSH 的返回或修改，以及 Codex 的采纳、修改或否决。
MIT 许可证。本项目与 DeepSeek、OpenAI 均无隶属或官方认可关系。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…