oil-oil/codex-deepseek-subagent

codex‑deepseek‑subagent – 将 DeepSeek 作为原生子代理无缝集成到 Codex 桌面应用中

这是什么

• 专为 Codex 桌面应用程序（OpenAI 的 ChatGPT/Codex 产品附带的 UI）设计的 技能（插件）。该技能将 DeepSeek 的大语言模型 API 注册为 Codex 应用可直接调用的 原生子代理。
• 它仅负责 配置、健康检查和修复 DeepSeek 集成——它 不会 自行执行常规的编码或生成任务。

你可能需要它的原因

• Codex 可以启动在其他 LLM 提供商上运行的子代理。没有此技能，你将不得不手动编辑配置文件、管理 API 密钥，并验证 DeepSeek 模型是否正确连接。
• 该技能自动化了整个工作流：安装、选择 DeepSeek 模型（Flash 或 Pro）、通过操作系统凭据存储提供 API 密钥、运行验证会话，然后让 Codex 在正常任务中调用 spawn_agent(agent_type="DeepSeek")。

核心功能

功能	作用
全局安装	npx skills add oil-oil/codex-deepseek-subagent -g -y 会为机器上的每个 Codex 用户注册该技能。
模型选择	首次配置时，可选择 deepseek‑v4‑flash（更便宜、更快）或 deepseek‑v4‑pro（功能更强）。
凭据处理	在 macOS 上，API 密钥存储在 Keychain 中；在 Windows 上，存储在凭据管理器中。该技能不会在聊天中发送密钥。
状态 / 测试 / 修复命令	CLI 脚本（`codex_deepseek.py status
自动备份与回滚	在写入任何配置或模型文件之前会创建备份；失败时会自动恢复到之前的状态。
兼容性检查	该技能验证父级 Codex 模型是否与所选 DeepSeek 模型兼容，并检查返回的令牌 NATIVE_DEEPSEEK_OK 是否存在。
无视觉输入	DeepSeek 仅处理文本；任何图像/视频必须由主 Codex 代理预先处理。

安装与首次设置

1. 前提条件 – macOS 或 Windows，Python 3.11+，已安装的 Codex 桌面应用，以及 DeepSeek API 密钥。
2. 运行上述全局安装命令。
3. 重启 Codex，打开新聊天，输入：

   帮我把 DeepSeek 配置成 Codex 的原生子 Agent。
   

4. 根据提示选择所需的 DeepSeek 模型。
5. 如果技能需要密钥，将弹出一个小的 UI（需要 Node 22+）；你粘贴密钥后，它将被保存到系统凭据存储中。
6. 当技能报告 status: ready 后，再次重启 Codex。此后你只需说：

   用 DeepSeek 子 Agent 检查这个项目。
   

   Codex 就会调用 DeepSeek 子代理。

管理集成

• 状态：python3 scripts/codex_deepseek.py status --json
• 测试（运行独立验收会话）：... test --json
• 修复 / 切换模型：... repair --model deepseek-v4-pro --json
• 禁用：... disable --json
• 卸载：... uninstall --json

在 Windows 上，可使用等效的 py -3 命令；如果 Codex 可执行文件未被自动找到，请将 CODEX_DESKTOP_BIN 设置为 codex.exe 的路径。

安全与回滚

• API 密钥从不显示在控制台或通过聊天发送；仅存储在操作系统提供的安全存储中。
• 所有写入操作均为事务性——失败时会自动保留并恢复备份。
• 该技能从不更改主 Codex 模型或登录方式；仅修改 DeepSeek 子代理的配置。

许可证

• 采用 MIT 许可证分发。

了解更多

• 兼容性与路由详情：codex-deepseek-subagent/references/compatibility.md
• 技能执行规则：SKILL.md
• API 密钥 UI 指南：references/api-key-setup.md
• 官方 DeepSeek 模型列表及 Codex 安装脚本链接在 README 中提供参考。

---

本说明仅基于仓库的 README；未推断任何额外功能。