DeepSeek Harness（DSH）作为一个插件化平台，允许开发者通过工具调用外部服务。本地 Codex 会话通常运行在 Codex 桌面应用中，与其协议对接存在技术壁垒。本插件通过 Codex app-server 协议，在 Harness 中实现了对这些会话的实时观察与指令下发。
插件信息¶
- 项目名称：juyanjy/dsh-codex-bridge
- 项目描述：通过 Codex app-server 协议从 DeepSeek Harness 连接并引导本地 Codex（OpenAI）会话。
- 维护者：JUYANJY
- 分类：工作流
- 开源协议：MIT
- 安装命令：
node scripts/install.mjs
核心功能¶
本插件提供了一套工具集，用于监控和操控本地 Codex 进程：
- 协议连接：连接到 Codex app-server 协议，支持对会话的观察和引导。
- 状态监控工具：
codex_status：检查账户信息、计划、速率限制预算及本地进程状态。codex_threads：列出最近的线程，支持按搜索字符串过滤。codex_transcript：获取指定线程的详细记录。codex_watch：监控线程的实时流，返回流经的事件。codex_queue：查看线程中等待的消息，支持取消操作。- 交互与控制：
codex_send：向 Codex 发送消息，支持参数queue（入队）、turn（回合）和steer（引导）。codex_approvals：列出待处理的审批请求并予以回复。codex_budget：读取速率限制桶，判断是否超出配额。codex_ask：在一次性线程中提问并将答案回填到开发线程中。codex_handoff：构建接管简报，支持prepare（准备接管）和claim（声明接管）动作。- 可视化面板：在 Harness 中提供 Codex 侧边栏面板，显示四种状态：Needs you（红色）、Blocked（橙色）、Running（绿色）和 Nothing observed（灰色）。
- 自动化辅助：支持自动延续消息功能 “Keep Codex moving for 30m”。
典型用法¶
- 监控线程流：
使用codex_watch监控线程的实时流，合并实时通知流和轮询记录。 - 发送指令：
使用codex_send发送消息。当桌面应用持有线程的写锁时，会自动回退到队列模式。 - 接管会话：
使用codex_handoff准备接管简报。若需正式声明接管，必须显式调用codex_handoff action=claim。 - 检查状态：
使用codex_status检查本地进程及 Codex 账户的速率限制预算。
注意事项¶
- 运行环境：需要 Node.js 版本 >= 22。
- 依赖关系：
@deepseek-ai/dsh-tools和@deepseek-ai/schemastery为可选的 peerDependencies。 - 接管流程：准备接管简报并不算移交，必须显式调用
codex_handoff action=claim才能声明接管。 - 采样机制：队列、项目、回合和目标的检查是采样的，非全量读取。
- 配额逻辑：速率限制桶使用
usedPercent。100% 不报告为 “out of quota”，只有当服务器标记为超出时才报告。
