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；未推斷任何額外功能。