DSH Codex Agent Bridge

English

@jadynchou/dsh-codex-agent-bridge 是一个社区插件，通过官方 Codex App Server 协议把 DeepSeek Harness Agent 接入 Codex。它会注册 openai-codex 提供方，从本机 Codex CLI 登录态实时获取可用模型，并在 DSH 模型选择器中展示各模型支持的思考强度。

插件复用运行 DSH 的操作系统用户所拥有的 Codex CLI 登录。Codex CLI 支持 ChatGPT 订阅和 API Key 两种登录方式；凭据继续由 Codex CLI 管理，无需复制到 DSH profile。相关行为见 OpenAI 官方的 Codex 身份验证和 App Server文档。

功能

• 通过 model/list 实时发现模型、默认模型及其支持的思考强度。
• 流式输出文本、思考摘要和用量数据，支持当前用户消息中的图片。
• 在 Codex Agent 回合中调用 DSH 动态 Tool。
• 每个活跃 DSH 会话复用一个 App Server 进程，同时由 DSH 持久化会话历史。
• 默认使用 Codex 原生只读沙箱，也可以配置为 workspace-write 或 danger-full-access。
• 对不支持的 DSH 请求字段明确报错，不会静默忽略。

环境要求

• DeepSeek Harness 0.1.0-rc.5 或更高的兼容版本。
• Node.js ^22.19.0 || >=24.0.0。
• DSH 进程能从 PATH 启动 Codex CLI；目前经过验证的协议基线是 Codex CLI 0.147.0。
• 运行 DSH 的同一操作系统用户具有有效的 Codex CLI 登录态。

按照 Codex CLI 官方说明完成安装，然后登录并检查版本：

npm install --global @openai/codex
codex login
codex --version

如果 DSH 以系统服务运行，需要用服务用户完成登录，或者确保服务的 HOME / CODEX_HOME 指向预期的 Codex 登录目录。

安装

通过 npx 运行 DSH

如果不全局安装 DSH，只需先安装一次 dsh plugin 所需的包管理器，然后为每条 DSH 命令加上 npx --yes @deepseek-ai/dsh 前缀：

npm install --global pnpm
npx --yes @deepseek-ai/dsh plugin --profile web add @jadynchou/dsh-codex-agent-bridge@0.1.1
npx --yes @deepseek-ai/dsh web

这种方式不会全局安装 DSH。插件文件和 web profile 会保存在共用的 DSH 主目录中（默认是 ~/.dsh，Windows 上是 %USERPROFILE%\.dsh），以后再次通过 npx 启动时仍会保留本插件。

已安装 DSH CLI

使用已安装的 DSH CLI：

dsh plugin --profile web add @jadynchou/dsh-codex-agent-bridge@0.1.1
dsh web

从 DeepSeek Harness 源码运行

从 DeepSeek Harness 源码仓库运行：

cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add @jadynchou/dsh-codex-agent-bridge@0.1.1
pnpm dsh web