Deepseek 可以和 Codex 上桌吃饭！

简体中文 · English

将 DeepSeek 真正地接入 Codex 中。Codex 做总指挥，自动选择 Flash / Pro ，
把便宜的大量阅读交给 Flash ，把难问题交给 Pro ，并且最终由 Codex 验收。

先看结果

这不是 daemon 、proxy 、MCP Server 或第二套 Agent runtime 。它是一组受管的
Codex 原生配置：两个 Agent 、一个模型目录、一个明文交接 Hook 、一个运行时
路由 Skill 和一个事务化管理器。

快速开始

要求：Node.js/npm 、Python 3.9+、至少启动过一次的 ChatGPT Desktop （ Codex ）
或已经安装 Codex CLI ，以及 DeepSeek API Key 。

1. 安装 Plugin

ChatGPT Desktop （推荐）

只安装了 ChatGPT Desktop 的用户不需要在系统终端运行 codex。打开 Desktop
中的 Codex ，新建任务，然后直接发送：

请安装这个插件：

https://github.com/TheBlindM/codex-deepseek-router

Codex Agent 会检查仓库中的 .agents/plugins/marketplace.json 并发起安装；出现
插件确认页面时点击 Install plugin。安装完成后用 ⌘Q（ macOS ）或完全退出
应用（ Windows ），重新打开并新建任务。

仅安装 Desktop 时，系统终端出现 command not found: codex 属于正常情况；
这不影响 Agent 在 Desktop 中安装插件。也可以在 Plugins 页面找到
DeepSeek Router 后手动点击安装。

Codex CLI

只有在系统终端执行 codex --version 成功时才使用下面的命令：

codex plugin marketplace add TheBlindM/codex-deepseek-router

codex plugin add codex-deepseek-router@deepseek-router

这里的 deepseek-router 是仓库提供的 Marketplace 名称，定义在
.agents/plugins/marketplace.json，不是需要用户自行替换的占位符。

Plugin 会同时提供管理 Skill 、路由 Skill 与原生 Hook ，不需要手动写入全局
~/.codex/hooks.json。

更新或卸载

无论使用哪种方式，安装或更新后都应完全重启 Desktop/CLI ，并打开新任务，
让新的 Skill 、Hook 和工具生效。更多通用说明见
OpenAI Plugins 文档。

2. 在 Codex 中完成配置

重启 Codex 、打开新任务，然后说：

请帮我安装并配置 codex-deepseek-router 。

Skill 会先检查状态。缺少凭据时，Codex 会索要 API Key ，并只通过标准输入
交给管理器；密钥不会进入命令参数、配置文件或聊天回显。

3. 审查并验收

1. 重启 Codex 或打开新任务，在原生 Plugin Hook UI 中 Review/Trust 。


2. 让 Codex 运行真实路由测试； Flash 与 Pro 必须分别通过。


3. 若当前版本没有自动显示 Review Prompt ，再在交互式 CLI 使用 /hooks。

以后可以直接说：

用 DeepSeek 子 Agent 评审这个仓库。

它如何工作

用户任务

   │

   ├─ 模态门：TEXT_ONLY / VISION_TRANSLATABLE / VISION_CRITICAL

   ├─ 敏感数据门：密钥与敏感内容留在 Codex

   ├─ 模型路由：Flash / Pro / 不委托

   └─ 策略路由：FAST / REACT / SPEC / DEEP

            │

            ▼

stage → SubagentStart Hook → DeepSeek 子 Agent

            │

            ▼

原生 callback → 元数据与 marker 验证 → Codex 整合

谁来做什么

Flash 可以返回带 Evidence Packet 的 ESCALATE_TO_PRO； Pro 从已有证据继续，
不重新扫描整个仓库。FAST / REACT / SPEC / DEEP 为有边界的决策合同，不是
额外的模型或运行时。

安装内容与安全边界

管理器会：

• 同时安装 deepseek-flash.toml 与 deepseek-pro.toml；


• 在 ~/.codex/models.json 同时注册两个模型；


• 由 Plugin 提供 skills/ 与 hooks/hooks.json； Hook 通过 PLUGIN_ROOT
  定位文件，不依赖 cwd 或用户绝对路径；


• setup 只配置凭据、Agent 、模型目录与显式路由所需的本地运行时；


• 使用系统凭据库保存 Key ，并在任何步骤失败时完整回滚；


• 永远不修改父任务的 config.toml，也不伪造 Hook 信任状态。

macOS 通过同一个 Python 进程身份调用 Security.framework 读写 Keychain ；
status/doctor 只检查条目是否存在，不解密 Key ，也不会为一次状态检查
重复触发钥匙串授权。所有面向用户的回复跟随用户当前使用的语言。

DeepSeek 子 Agent 只接收文本。截图、图片和视频必须先由 Codex 转成文字事实；
关键视觉判断不会委托。Windows Agent 通过用户环境变量
DEEPSEEK_API_KEY 认证，设置后需要完全重启 Codex 。

管理命令

所有命令支持 --json 与 --codex-home。退出码：0 表示
ready/configured ，2 表示需要人工处理，3 表示超时，1 表示意外失败。

git clone https://github.com/TheBlindM/codex-deepseek-router.git

cd codex-deepseek-router

python3 scripts/codex_deepseek_router.py status --json

只通过 stdin 配置 Key：

printf '%s\n' '<你的 key>' | python3 scripts/codex_deepseek_router.py setup --api-key-stdin --json

完成 Codex 原生 Plugin Hook 审查（若未出现提示，再用 CLI /hooks）后运行真实验收：

python3 scripts/codex_deepseek_router.py test --json

test 会分别证明两个角色使用正确的 model_provider、model 与 agent role ，
并验证每个子 Agent 返回独立的随机 marker 。Flash 通过不代表 Pro 通过。