Codex DeepSeek 子 Agent
本 Skill 只维护配置，不承接日常用户任务。确定性的文件、模型目录和凭据操作交给 scripts/codex_deepseek.py；不要手动改 TOML、JSON、Agent 文件或系统凭据库。
API Key 配置入口
需要外部服务凭据时先读API Key 配置与业务读取：复用已有安全入口；本机缺少 Key 时使用随附固定页面，保存后通过业务包装入口读取。内置能力与纯本地流程不要求配置 Key。
关键契约
-
只使用桌面应用内置的 Codex 运行时；版本仅用于诊断，兼容性以真实派发验收为准。
-
从桌面配置读取父模型，并由管理程序应用 v1 明文派发设置；不要硬编码父模型或手改配置。技术原因见 references/compatibility.md。
-
父模型变化后必须运行
repair，再重新验收。 -
支持
deepseek-v4-flash与deepseek-v4-pro。Flash 更快、更省；Pro 能力更强，适合复杂 Agent 任务。两者默认思考程度均为high。 -
DeepSeek 是纯文本 Agent，不处理图片、视频、截图或其他视觉输入。父 Agent 先识别视觉内容，再传入文字事实。
-
日常任务只能直接调用：
textspawn_agent(agent_type="DeepSeek", fork_turns="none", ...)不要为日常任务运行本 Skill、管理脚本或
codex exec。 -
当前工具若不认识
DeepSeek角色，只提示用户打开新任务或重启 Codex；不得改用默认角色、脚本或codex exec代做当前任务。
触发后的流程
- 运行
status --json，根据结构化状态继续，不靠文件名猜测。 - 首次配置时，如果用户没有指定模型，先让用户选择：
DeepSeek V4 Flash（更快、更省）或DeepSeek V4 Pro（能力更强，推荐复杂任务）。不要替用户静默选择。 - 配置请求运行
setup --model <模型> --json；切换模型或修复配置时运行repair --model <模型> --json。不传--model的repair会保留当前选择。 - 缺少凭据时按配置说明展示固定页面，由用户保存后，经 run 入口运行 setup 并传
--api-key-env，接入运行时原生凭据；不在聊天中索要 API Key。--api-key-stdin仅供可信凭据程序传递，不拼接密钥命令。 setup、repair或test使用桌面内置运行时创建隔离验收会话。若返回new_task_required或restart_required，提示用户重启桌面应用并打开新任务。- 验收必须检查子线程数据库
threads表的实际元数据，并确认子 Agent 返回口令NATIVE_DEEPSEEK_OK。实际model必须等于用户选择的模型，两者缺一不可。 - 最终只汇报状态、实际 Provider、模型、思考程度、角色和备份位置；不要输出密钥或原始事件日志。
管理命令
入口。macOS 使用 python3，Windows 使用 py -3：
textpython3 <skill-dir>/scripts/codex_deepseek.py <command> --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。
