前言¶

DeepSeek Harness（簡稱 DSH）把模型、工具、會話和界面都做成插件，理念是「一切皆插件」。實際幹活時，很多人並不是只待在 DSH 裏：有人主戰場在 Codex，希望主任務繼續走 OpenAI，只把檢索、日誌和大量文本整理交給更便宜的 DeepSeek；也有人已經在 Pi 裏用 deepseek-v4-pro，希望第一次請求能貼近 DSH Minimal 的工程軌跡，但後面仍用 Pi 的 read/edit/write 和現有插件。

mixagents 就是爲這兩種組合準備的。它由 Utopia-V 維護，MIT 許可，GitHub 倉庫地址是 https://github.com/Utopia-V/mixagents 。社區插件目錄把它歸在「模型與提供方」，當前 GitHub 星標爲 169。需要先說清楚：這個社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係；倉庫自己也寫明，項目與 OpenAI、DeepSeek、Pi、OpenCode 均無隸屬或官方背書。

mixagents 是什麼¶

mixagents 不是單一的 Cordis 運行時插件，而是同一倉庫裏兩套彼此獨立的組件：

倉庫曾名爲 Utopia-V/codex-deepseek-subagent，後來改名爲 mixagents。舊名稱會保持空置，以便已有網頁、Git remote 和 raw prompt 鏈接繼續重定向。

目錄頁給出的通用安裝命令是：

dsh plugin add github:Utopia-V/mixagents

如需可復現安裝，目錄頁建議固定 commit。當前 main 最新提交（2026-08-17）爲：

dsh plugin add github:Utopia-V/mixagents#925ba7d5e7a07c4bb34a8d03784016283bff8acf

這條命令以目錄頁原文爲準。對照倉庫源碼後需要注意：倉庫根目錄沒有 package.json，也沒有 dsh.bundle 聲明。README 裏真正寫清楚的安裝路徑，是 Codex 安裝提示詞，以及 Pi 側的 pi install npm:pi-dsh-mimic。若目標是「把 DeepSeek Flash 接到 Codex」或「在 Pi 裏復現 DSH Minimal 首請求」，應按下面兩節的官方步驟操作，不要默認 dsh plugin add 會自動變成可用的 DSH 運行時層。

插件（以及 Pi 擴展）會以當前進程權限運行，安裝時可能執行代碼。安裝前應檢查源代碼倉庫和許可證。

Codex DeepSeek Subagent：主 Agent 不動，Flash 做子任務¶

這一組件的定位很窄：主任務繼續使用現有 GPT / OpenAI 模型和 ChatGPT 登錄，DeepSeek 只出現在獨立的 v4_flash_worker child 裏。它不是 MCP Server，不是另一套 Codex CLI，也不需要 CC Switch 去切換全局 provider。Codex 仍負責 child 的創建、權限、取消和 callback；倉庫只補了一層受信任的 SubagentStart Hook，用來跨過當前 OpenAI parent → 非 OpenAI child 的任務投遞問題。

高級說明裏寫過原因：Multi-agent V2 在跨 provider 時，child 可能只看到無法解釋的 encrypted_content，真正任務傳不過去。倉庫用一次性 plaintext handoff：父 Agent 把完整 assignment 短暫寫到本地用戶狀態，Hook 在 v4_flash_worker 啓動時領取並注入。這是傳輸兼容層，不是加密通道。

已測試基線（來自組件高級說明）：

• Windows Codex Desktop：26.727.6591.0
• Codex CLI：0.146.0
• DeepSeek 模型別名：deepseek-v4-flash（文檔標註版本 DeepSeek-V4-Flash-0731）
• macOS 的 Python/POSIX 路徑已在 Codex 0.146.0 上通過原生 callback smoke 和 27 項協議測試；Linux 使用同一 POSIX 實現

三步安裝¶

1. 設置 DEEPSEEK_API_KEY

在 DeepSeek 創建 key，保存爲環境變量 DEEPSEEK_API_KEY。不要把 key 發進 Codex 聊天、Issue、截圖或倉庫。

• Windows：在用戶環境變量中新建 DEEPSEEK_API_KEY，然後完全退出並重新啓動 Codex Desktop。
• macOS / Linux：在啓動 Codex 的 shell 或 secret manager 中設置該變量，再啓動 Codex。

macOS 另有 Keychain 認證模板，只有明確選擇時纔會使用，已有配置不會自動遷移。

2. 把下面這段交給 Codex

請讀取並嚴格執行
https://raw.githubusercontent.com/Utopia-V/mixagents/main/packages/codex-deepseek-subagent/prompts/install-with-codex.md
爲我安裝其中的 DeepSeek V4 Flash subagent。保留當前主模型、provider 和 ChatGPT
登錄，不得索要或輸出 API key；完成無付費調用的本地驗證後停止，暫不運行 smoke
test。

安裝過程會下載併合並 Agent、skill、Hook 與兩條 AGENTS.md 索引，不會調用 DeepSeek，也不會改掉主模型。

3. 信任 Hook，再新開任務做 smoke

在 Codex 輸入 /hooks，確認它只匹配 v4_flash_worker，命令指向剛安裝的 plaintext-handoff 腳本，然後選擇信任。已經在跑的舊任務不保證重新加載 Hook，需要新開一個任務。把下面一句複製進去：

請讀取並嚴格執行
https://raw.githubusercontent.com/Utopia-V/mixagents/main/packages/codex-deepseek-subagent/prompts/quick-smoke-test.md
測試剛安裝的 v4_flash_worker。不得使用替代 provider、直接 API 或另一個 Codex
CLI。

quick smoke 不要求 clone 倉庫，但會產生一次很小的 DeepSeek API 調用。成功時應同時看到：出現獨立 child，agent type 爲 v4_flash_worker；child 返回父 Agent 隨機生成的 marker，並得到 arithmetic=323；一次性 pending handoff 已被消費；主任務仍使用原來的 OpenAI 模型。

安裝完成後，父 Agent 會在適合的任務上按需加載 $use-v4-flash-worker，並不強迫每個任務都走 Flash。README 建議把邊界明確、以文本爲主、會產生大量原始材料而只需少量結論的搜索、日誌、枚舉和閱讀交給 Flash；緊密耦合的推理、決策、驗證和最終整合留在父 Agent。

Pi DSH Mimic：只借 DSH 的第一次請求¶

pi-dsh-mimic 解決的是另一件事。Pi 已經能調用 deepseek-v4-pro 或 opencode-go/deepseek-v4-pro，但默認首請求帶着完整 Pi prompt 和一整套工具。該組件只在新 session 的第一次模型請求裏復現 DSH Minimal：persona 使用 You are a helpful software engineer assistant.，對外只暴露 bash 與 str_replace_editor。第一次有效 assistant 響應或 durable tool call 之後，請求 #2 立刻回到 Pi 原生 payload 和當下完整工具目錄，其他插件工具會自然出現。Minimal persona 在整個 session 保持，Pi 較長的自動 system prompt 不會作爲額外 user message 重放。

用戶不必安裝或運行完整 DSH harness。真正執行任務、管理 session、組合插件的仍然是 Pi。擴展不增加身份 warm-up，不復制原任務，不注入 We need，也不代理 API。

安裝和使用¶

要求：Node.js 22.19 或更新、Pi 0.84.2 或更新，並已配置 DeepSeek 官方 API 或 OpenCode Go。Pi 0.84.2 已內置這兩條 provider 路徑。

用戶級安裝：

pi install npm:pi-dsh-mimic

項目級安裝：

pi install -l npm:pi-dsh-mimic

直接試用當前 checkout：

pi -e ./packages/pi-dsh-mimic \
  --provider deepseek \
  --model deepseek-v4-pro

使用 OpenCode Go 時，把 key 放在 Pi 期望的 OPENCODE_API_KEY 環境變量中，並把 provider 改爲 opencode-go。先選擇 V4 Pro，再新建 session。在已有對話中途切到 V4 Pro，不會僞造一次新的 bootstrap。

Project2 分數怎麼讀¶

README 給出的對照來自維護者個人、自託管的長程代碼維護評測 Project2 V4.1b：模型接手一個故意保留缺陷的多模塊 Python 後端與 ESP32-S3 固件倉庫。它不是跨項目通用 benchmark，分數只描述這套凍結任務。

默認 Pi baseline 爲 92。同一 one-shot 請求流程的四次最終結果爲 98、96、96、98，並均保持 F3 16/16。維護者據此認爲：DSH Minimal 首請求可以在 Pi 中穩定建立高能力軌跡，恢復完整工具目錄也不會自動破壞它。實驗文檔還記錄了若干被否決的設計，例如額外身份輪、只減少工具數量、全程模擬 DSH wire、恢復後重放完整 Pi system context，這些路徑的分數都低於「首請求 Minimal，隨後回到 Pi」這條線。

離線側，TypeScript typecheck 已通過，13 項自動化測試全部通過。package 行爲測試覆蓋首請求字段順序、請求 #2 恢復完整目錄、圖片、API error 重試、session resume 和 crash-stale 恢復等。Provider error 或 aborted response 不消耗 bootstrap。

怎樣選擇¶

• 想保留 Codex 的 OpenAI 主 Agent，同時用更便宜的 DeepSeek child 處理邊界清楚的文本工作，安裝 Codex DeepSeek Subagent。
• 已經在 Pi 中使用 deepseek-v4-pro 或 opencode-go/deepseek-v4-pro，希望從已驗證的 DSH Minimal 軌跡起步，同時繼續使用 Pi 的讀寫工具和其他插件，安裝 Pi DSH Mimic。
• 兩條組件互不依賴，按自己的運行時選一套即可。

適用場景與注意事項¶

適合已經在用 Codex 或 Pi、並且接受把任務內容發給 DeepSeek / OpenCode 的人。不適合把 mixagents 理解成「裝進 DSH Web UI 就能換模型」的 Cordis 插件；倉庫公開文檔沒有這條路徑。

安全和費用邊界以倉庫 SECURITY.md 爲準，這裏只列已經寫明的幾點：

1. 兩個組件都會把任務內容發送給用戶配置的第三方 provider。本地 sandbox 限制的是文件系統改寫，不是保密邊界。
2. Codex 組件會在本地用戶狀態中短暫保存明文 assignment。默認位置：Windows 爲 %LOCALAPPDATA%\Codex\plaintext-subagent-handoff；macOS/Linux 爲 $XDG_STATE_HOME/codex/plaintext-subagent-handoff 或 ~/.local/state/codex/plaintext-subagent-handoff。安裝後必須在 /hooks 裏審查並信任 Hook，不要爲了非交互安裝去僞造 trust hash。
3. Pi 組件以 Pi 進程的文件系統權限運行，提供的 str_replace_editor 可以創建和修改文件。它不讀取、保存或傳輸 API key，也不增加額外模型輪次。
4. DeepSeek 與 OpenCode 的費用獨立於 ChatGPT / OpenAI 訂閱。安裝和離線測試不應調用模型；quick smoke 和完整模型運行會按對應賬戶計費。
5. 倉庫明確要求：不要把 API key、完整請求頭或未脫敏配置發進 Issue 或聊天。

Windows 用戶若剛改過環境變量，需要完整重啓 Codex，否則 child 可能讀不到 DEEPSEEK_API_KEY。高級說明還提到：User/HKCU command auth 可能跑在 sandbox identity 下，這不是默認 env_key 路徑。PowerShell 加固實現已通過本地協議、併發與恢復測試，倉庫寫明尚待一次更新後的 live smoke。

小結¶

mixagents 把兩件已經有文檔和測試的事放進同一個倉庫：Codex 繼續用 OpenAI 主模型，把 Flash 做成原生 subagent；Pi 只在第一次請求裏借用 DSH Minimal，隨後回到自己的工具和插件。社區目錄可以用來發現它，真正能跑起來的步驟在 GitHub README 裏。

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/mixagents/

GitHub：https://github.com/Utopia-V/mixagents