Skip to content
Back to search

codex-deepseek-subagent

配置和维护桌面应用中的原生子 Agent,支持选择模型、检查路由、修复、停用和卸载。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/oil-oil--codex-deepseek-subagent/badge.svg)](/listings/oil-oil--codex-deepseek-subagent)

HTML

<a href="/listings/oil-oil--codex-deepseek-subagent"><img src="/api/listings/oil-oil--codex-deepseek-subagent/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 149 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="./assets/readme/hero.svg" width="100%" alt="codex-deepseek-subagent:将 DeepSeek 注册为 Codex 原生子 Agent">
  3. </p>
  4. 配置和维护桌面应用中的原生子 Agent,支持选择模型、检查路由、修复、停用和卸载。
  5. ## 适用范围
  6. 这个 Skill 只用于:
  7. - 首次配置、状态检查和实时测试;
  8. - 父模型变化后的修复;
  9. - 停用或卸载 DeepSeek 配置。
  10. 普通的编码、探索、实现、评审和验证任务不应重复运行配置流程。
  11. <p align="center">
  12. <img src="./assets/readme/workflow.svg" width="100%" alt="DeepSeek 子 Agent 的配置和验证流程">
  13. </p>
  14. ## 快速开始
  15. 要求:macOS 或 Windows、Python 3.11+、ChatGPT/Codex 桌面应用,以及 DeepSeek 官方 API Key。
  16. 1. 全局安装 Skill:
  17. ```bash
  18. npx skills add oil-oil/codex-deepseek-subagent -g -y
  19. ```
  20. 2. 重启桌面应用并新建任务,让 Skill 生效。
  21. 3. 在新任务中发出配置请求:
  22. ```text
  23. 帮我把 DeepSeek 配置成 Codex 的原生子 Agent。
  24. ```
  25. 4. Codex 会先让你选择模型:
  26. - `DeepSeek V4 Flash`:更快、更省,适合日常编码;
  27. - `DeepSeek V4 Pro`:能力更强,适合复杂编码和高难度 Agent 任务。
  28. 5. 选择后,Agent 会在缺少凭据时展示本机配置页,再通过包装器接入运行时原生凭据并验收;不会索要聊天中的 API Key。
  29. 6. 看到 `status: ready` 后,再重启桌面应用并新建任务。此后可直接说:
  30. ```text
  31. 用 DeepSeek 子 Agent 检查这个项目。
  32. ```
  33. 配置成功后,角色文件位于 `$CODEX_HOME/agents/DeepSeek.toml`;默认 `CODEX_HOME` 为 `~/.codex`。
  34. ## 使用与兼容性
  35. - 日常任务只能由主 Agent 直接调用 `spawn_agent(agent_type="DeepSeek", fork_turns="none")`。
  36. - 配置与验收只使用桌面应用内置运行时;版本仅作诊断,实际能力以真实派发结果为准。
  37. - 父模型从当前配置读取;切换父模型后运行 `repair`。
  38. - DeepSeek 模型可以随时切换;`repair --model deepseek-v4-pro` 或 `repair --model deepseek-v4-flash` 会更新配置并重新验收。
  39. - DeepSeek 只处理文本。图片、视频、截图等视觉输入必须由父 Agent 先识别并整理成文字。
  40. - 当前工具若不认识 `DeepSeek` 角色,只提示用户打开新任务或重启 Codex;不得用脚本或 `codex exec` 代做用户任务。
  41. v1/v2 路由原因、配置位置和回滚规则见 [兼容性说明](codex-deepseek-subagent/references/compatibility.md)。
  42. ## 管理命令
  43. 管理命令由 Skill 按需调用:
  44. macOS:
  45. ```bash
  46. python3 codex-deepseek-subagent/scripts/codex_deepseek.py status --json
  47. node codex-deepseek-subagent/scripts/credential-ui/src/profile.ts run default -- python3 codex-deepseek-subagent/scripts/codex_deepseek.py setup --model deepseek-v4-pro --api-key-env --json
  48. python3 codex-deepseek-subagent/scripts/codex_deepseek.py test --json
  49. python3 codex-deepseek-subagent/scripts/codex_deepseek.py repair --model deepseek-v4-flash --json
  50. python3 codex-deepseek-subagent/scripts/codex_deepseek.py disable --json
  51. python3 codex-deepseek-subagent/scripts/codex_deepseek.py uninstall --json
  52. ```
  53. Windows:
  54. ```powershell
  55. py -3 codex-deepseek-subagent\scripts\codex_deepseek.py status --json
  56. node codex-deepseek-subagent/scripts/credential-ui/src/profile.ts run default -- py -3 codex-deepseek-subagent/scripts/codex_deepseek.py setup --model deepseek-v4-pro --api-key-env --json
  57. py -3 codex-deepseek-subagent\scripts\codex_deepseek.py test --json
  58. py -3 codex-deepseek-subagent\scripts\codex_deepseek.py repair --model deepseek-v4-flash --json
  59. py -3 codex-deepseek-subagent\scripts\codex_deepseek.py disable --json
  60. py -3 codex-deepseek-subagent\scripts\codex_deepseek.py uninstall --json
  61. ```
  62. 管理程序会自动寻找桌面应用内置运行时。Windows 自动发现失败时,可以通过 `CODEX_DESKTOP_BIN` 指定 `codex.exe`。
  63. `setup` 或 `test` 会创建隔离验收会话;这不是日常任务的替代入口。验收必须同时满足数据库路由元数据与子 Agent 返回口令:
  64. ```text
  65. model_provider = deepseek
  66. model = deepseek-v4-flash 或 deepseek-v4-pro(必须等于所选模型)
  67. reasoning_effort = high
  68. agent_role = DeepSeek
  69. ```
  70. ```text
  71. NATIVE_DEEPSEEK_OK
  72. ```
  73. 不能只相信子 Agent 的自述。
  74. 模型名称和能力以 [DeepSeek 官方模型列表](https://api-docs.deepseek.com/api/list-models) 与 [官方 Codex 安装脚本](https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh) 为准。
  75. ## 安全与回滚
  76. - API Key 默认通过固定页面保存,再由可信包装器注入配置程序;标准输入仅供显式选择的兼容入口。macOS 保存到 Keychain,Windows 保存到 Credential Manager。配置、临时文件和测试输出均不包含密钥。
  77. - 配置和模型目录写入前会创建备份;解析或实时测试失败会恢复本次事务。
  78. - 不修改主任务的顶层模型或登录方式。
  79. Skill 执行规则见 [SKILL.md](codex-deepseek-subagent/SKILL.md)。
  80. ## 品牌素材
  81. Codex 图标来自官方 ChatGPT 应用资源,DeepSeek 图标来自 DeepSeek 官方 CDN。相关商标与品牌素材归各自权利人所有,本项目与 OpenAI 或 DeepSeek 无隶属或官方背书关系。
  82. ## 开发验证
  83. ```bash
  84. python3 scripts/test_manager.py
  85. python3 scripts/build_readme_assets.py
  86. ```
  87. ## License
  88. [MIT](./LICENSE)
  89. ## 配置、依赖与使用边界
  90. 依赖兼容的 Codex 桌面、Python 3.11+、macOS 或 Windows 系统凭据库;API Key 默认通过固定页面和业务包装器接入。
  91. 仅配置、诊断与验收,普通编码不重新运行安装;它是宿主专用适配,不宣称所有 Agent 通用。
  92. 使用示例:
  93. ```text
  94. 把 DeepSeek 配置成我的原生子 Agent,缺少配置时指引我完成。
  95. ```
  96. ## API Key 配置页面
  97. 首次使用外部服务时,可以在本机配置页亲自填写 Key;已有配置会复用,密钥存入系统凭据库。只为实际使用的外部服务配置;纯本地处理不需要 Key。页面需要 Node.js 22.18+ 与可用的系统凭据服务,业务运行仍使用原依赖。
  98. 安装、状态检查、打开页面和带凭据运行的完整入口见[配置说明](codex-deepseek-subagent/references/api-key-setup.md)。页面保存与业务读取已经接通;不把 Key 发进聊天,也不自动迁移旧文件。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.