oil-oil/codex-deepseek-subagent

Latest recorded source activity: September 10, 2026 at 12:42

SkillsMP catalog refreshed: November 12, 2026 at 12:52

skills collected: 1

GitHub stars: 392
GitHub forks: 27

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/oil-oil/codex-deepseek-subagent.

Repository README

Repository README source: README.md

Read the source README

Expand full README

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

Loading the repository README…

Skills in this repository

Computer Occupations, All Other

1 occupation category · 100% classified

skill

occupation

description

updated

codex-deepseek-subagent

Computer Occupations, All Other

配置和维护 Codex 桌面应用中的 DeepSeek 原生子 Agent，支持模型选择、路由验证、修复、停用和卸载。仅在用户要求配置或管理该集成时使用；普通 API 问题与配置后的日常编码任务不触发。

Source text: Chinese

2026-09-10

Showing 1 of 1 collected skill.