--- title: "codex-deepseek-subagent by oil-oil · skilld" canonical_url: "https://skilld.dev/gh/oil-oil/codex-deepseek-subagent" meta: description: "配置和维护 Codex 桌面应用中的 DeepSeek 原生子 Agent，支持模型选择、路由验证、修复、停用和卸载。仅在用户要求配置或管理该集成时使用；普通 API 问题与配置后的日常编码任务不触发。 From oil-oil/codex-deepseek-subagent." "og:description": "配置和维护 Codex 桌面应用中的 DeepSeek 原生子 Agent，支持模型选择、路由验证、修复、停用和卸载。仅在用户要求配置或管理该集成时使用；普通 API 问题与配置后的日常编码任务不触发。 From oil-oil/codex-deepseek-subagent." "og:title": "codex-deepseek-subagent by oil-oil" "twitter:description": "配置和维护 Codex 桌面应用中的 DeepSeek 原生子 Agent，支持模型选择、路由验证、修复、停用和卸载。仅在用户要求配置或管理该集成时使用；普通 API 问题与配置后的日常编码任务不触发。 From oil-oil/codex-deepseek-subagent." "twitter:title": "codex-deepseek-subagent by oil-oil" --- ` [All skills](https://skilld.dev/skills) [![oil-oil avatar](https://skilld.dev/_img/avatar?url=https%3A%2F%2Fgithub.com%2Foil-oil.png%3Fsize%3D96)](https://skilld.dev/gh/oil-oil) # **/codex-deepseek-subagent** [@978b079](https://github.com/oil-oil/codex-deepseek-subagent/commit/978b079524d22318625d14fe7d7f40cc8ec66fce "Your agent reads SKILL.md at commit 978b079") by [Zhihuang Lin](https://skilld.dev/gh/oil-oil)· [oil-oil](https://skilld.dev/gh/oil-oil)/ [codex-deepseek-subagent](https://skilld.dev/gh/oil-oil/codex-deepseek-subagent)·376 stars 28 配置和维护 Codex 桌面应用中的 DeepSeek 原生子 Agent，支持模型选择、路由验证、修复、停用和卸载。仅在用户要求配置或管理该集成时使用；普通 API 问题与配置后的日常编码任务不触发。 - 33 files - 178.1 KB - Updated 3 weeks ago - [GitHub](https://github.com/oil-oil/codex-deepseek-subagent/blob/978b079524d22318625d14fe7d7f40cc8ec66fce/codex-deepseek-subagent/SKILL.md "View SKILL.md on GitHub") - [1 warning](#third-party-checks "Third-party checks: 1 warning · 3 checks · Risk SAFE") ## SKILL.md 4.9 KB **≈68** tokens always: the name and description. **≈1.2k** when used: this file. **≈8.2k** more on demand in 12 files. ## Codex DeepSeek 子 Agent 本 Skill 只维护配置，不承接日常用户任务。确定性的文件、模型目录和凭据操作交给 `scripts/codex_deepseek.py`；不要手动改 TOML、JSON、Agent 文件或系统凭据库。 ### API Key 配置入口 需要外部服务凭据时先读 [API Key 配置与业务读取](https://skilld.dev/gh/oil-oil/codex-deepseek-subagent/codex-deepseek-subagent/-/references/api-key-setup.md)：复用已有安全入口；本机缺少 Key 时使用随附固定页面，保存后通过业务包装入口读取。内置能力与纯本地流程不要求配置 Key。 ### 关键契约 - 只使用桌面应用内置的 Codex 运行时；版本仅用于诊断，兼容性以真实派发验收为准。 - 从桌面配置读取父模型，并由管理程序应用 v1 明文派发设置；不要硬编码父模型或手改配置。技术原因见 [references/compatibility.md](https://skilld.dev/gh/oil-oil/codex-deepseek-subagent/codex-deepseek-subagent/-/references/compatibility.md)。 - 父模型变化后必须运行 `repair`，再重新验收。 - 支持 `deepseek-v4-flash` 与 `deepseek-v4-pro`。Flash 更快、更省；Pro 能力更强，适合复杂 Agent 任务。两者默认思考程度均为 `high`。 - DeepSeek 是纯文本 Agent，不处理图片、视频、截图或其他视觉输入。父 Agent 先识别视觉内容，再传入文字事实。 - 日常任务只能直接调用： ``` spawn_agent(agent_type="DeepSeek", fork_turns="none", ...) ``` 不要为日常任务运行本 Skill、管理脚本或 `codex exec`。 - 当前工具若不认识 `DeepSeek` 角色，只提示用户打开新任务或重启 Codex；不得改用默认角色、脚本或 `codex exec` 代做当前任务。 ### 触发后的流程 1. 运行 `status --json`，根据结构化状态继续，不靠文件名猜测。 2. 首次配置时，如果用户没有指定模型，先让用户选择： `DeepSeek V4 Flash`（更快、更省）或 `DeepSeek V4 Pro`（能力更强，推荐复杂任务）。不要替用户静默选择。 3. 配置请求运行 `setup --model <模型> --json`；切换模型或修复配置时运行 `repair --model <模型> --json`。不传 `--model` 的 `repair` 会保留当前选择。 4. 缺少凭据时按配置说明展示固定页面，由用户保存后，经 run 入口运行 setup 并传 `--api-key-env`，接入运行时原生凭据；不在聊天中索要 API Key。 `--api-key-stdin` 仅供可信凭据程序传递，不拼接密钥命令。 5. `setup`、 `repair` 或 `test` 使用桌面内置运行时创建隔离验收会话。若返回 `new_task_required` 或 `restart_required`，提示用户重启桌面应用并打开新任务。 6. 验收必须检查子线程数据库 `threads` 表的实际元数据，并确认子 Agent 返回口令 `NATIVE_DEEPSEEK_OK`。实际 `model` 必须等于用户选择的模型，两者缺一不可。 7. 最终只汇报状态、实际 Provider、模型、思考程度、角色和备份位置；不要输出密钥或原始事件日志。 ### 管理命令 入口。macOS 使用 `python3`，Windows 使用 `py -3`： ``` python3 /scripts/codex_deepseek.py --json ``` - `status`：只读检查桌面内置运行时、配置、模型目录、凭据和客户端能力。 - `setup`：使用 `--model deepseek-v4-flash` 或 `--model deepseek-v4-pro` 写入配置并验收；未选择时返回 `model_selection_required`。 - `test`：通过桌面内置运行时执行一次直连测试和一次原生 `spawn_agent(agent_type="DeepSeek")` 验收。 - `repair`：按当前父模型重新应用配置并验收；传 `--model` 可切换模型，不传则保留当前模型。 - `disable`：停用本 Skill 创建的角色，保留 Provider、模型目录和凭据。 - `uninstall`：移除本 Skill 管理的配置；只有用户明确要求删除凭据时才传 `--remove-credential`。 默认使用当前 `CODEX_HOME`；仅在用户明确指定其他 Codex Home 时传 `--codex-home`。 ### 状态处理 - `ready`：直连、原生路由、数据库元数据和返回口令均通过。 - `configured`：静态配置完整，但尚未完成实时验收。 - `credential_missing`：引导用户通过固定页面保存，再经包装器完成运行时配置后继续原流程。 - `model_selection_required`：向用户展示 Flash/Pro 选项，得到选择后继续原流程。 - `operation_in_progress`：已有配置操作正在运行，稍后重试，不并发修改。 - `conflict`：报告冲突文件和字段，等待用户决定是否替换。 - `unsupported`：报告缺少的系统能力，不按固定版本号猜测兼容性，也不手工绕过。 - `failed`：读取结构化 `errors`；若程序已回滚，明确说明，不再手改配置。 更详细的路径、版本和安全边界见 [references/compatibility.md](https://skilld.dev/gh/oil-oil/codex-deepseek-subagent/codex-deepseek-subagent/-/references/compatibility.md)。 Source: [SKILL.md on GitHub](https://github.com/oil-oil/codex-deepseek-subagent/blob/978b079524d22318625d14fe7d7f40cc8ec66fce/codex-deepseek-subagent/SKILL.md) ## Third-party checks
1 warning21d3 checks · Risk SAFE - Gen Agent Trust Hub21d The skill is a utility for managing DeepSeek sub-agent configurations within the Codex desktop application. It follows security best practices by using secure OS-native credential storage, performing atomic file operations, and executing local binaries without shell interpolation. - Socket21d No alerts - Snyk21d Risk: MEDIUM · 1 issue
## Provenance [Signed by skilld at 978b079.](https://github.com/oil-oil/codex-deepseek-subagent/commit/978b079524d22318625d14fe7d7f40cc8ec66fce "978b079524d22318625d14fe7d7f40cc8ec66fce") This ties the file your Agent reads to that commit on GitHub. It does not review the instructions. Last checked against GitHub 3 weeks ago. Activeupdated 3 weeks ago ## README badge ![README badge for oil-oil/codex-deepseek-subagent](https://skilld.dev/b/oil-oil/codex-deepseek-subagent?theme=light&label=0) ## Related skills - - - - - -