前言¶
在 DeepSeek Harness（DSH）裏做開發時，執行側通常由 DeepSeek 和本機工具完成；若還需要第二套視角做方案、代碼審查或訓練結果解讀，往往要切換到 Codex CLI 或圖形客戶端，工作目錄和對話上下文也要自己對齊。dsh-codex-bridge 把 Codex 以會話級插件接進 Harness：默認關閉，只在顯式開啓的會話裏調用本機 Codex CLI，並與當前會話的真實工作區共享只讀上下文。下面介紹它的定位、能力與安裝啓用方式。
這是什麼¶
- 名稱：
dsh-codex-bridge（npm 包名一致） - 維護者：ChangJiang326（獨立社區項目，與 DeepSeek、OpenAI 無官方隸屬關係）
- 分類：工作流（SkillHub 目錄）
- 版本：0.4.0（MIT 許可證）
- 一句話：DeepSeek 負責執行，Codex 通過本機 CLI 提供方案、代碼審查、改進建議與訓練結果分析；僅對單獨開啓協作的會話生效。
核心功能¶
會話級協作開關¶
協作默認關閉。新會話、複製會話和子會話也默認關閉；設置按會話 ID 持久化。關閉協作或取消調用會終止本會話的 Codex 子進程，晚到的結果會被丟棄，不會取消 DeepSeek 或其訓練任務。
自動與手動模式¶
勾選功能並打開「在本會話啓用協作」後：
- 自動模式：每輪開始時請求一次方案，輪末請求一次審查；DeepSeek 也可按需使用
consult_codex。未勾選的功能會跳過對應自動調用。 - 手動模式：關閉自動計劃與審查；面板按鈕和 DeepSeek 按需調用仍可用。面板請求只展示結果，不會喚醒 DeepSeek。
默認每輪最多 3 次顧問調用，單次超時 300 秒，可在面板調整。配額涵蓋自動計劃、審查和工具調用；輪末審查最多一次，DeepSeek 修正後不會無限自動重審。手動請求需要會話已有運行實例；新建空會話若提示尚未運行，需先發送一條消息。
工作區與共享上下文¶
Codex 使用當前 Harness 會話的真實工作目錄。CLI 以 read-only sandbox、approval_policy=never、臨時執行模式啓動。Codex 的建議與短依據返回給 DeepSeek，不共享模型內部隱藏思考。
可選共享內容包括近期用戶/助手/工具文字，以及會話專用記錄目錄（開啓「每步保存」時由插件寫入，Codex 不寫項目文件）：
<當前工作區>/.codex-bridge/<會話ID的哈希>/
TASK.md 最新顧問請求
PROGRESS.md DeepSeek 步驟和顧問進度（滾動保留）
DECISIONS.md 最近一次顧問結論與驗收項
自動附帶的對話最多 24,000 字符；系統提示、隱藏推理和二進制附件不會自動附帶。關閉「共享上下文/讀取記錄」只關閉自動附帶，Codex 仍能只讀訪問工作區文件。顧問結果限 256 KiB，超限會報錯。建議將 .codex-bridge/ 加入 .gitignore。
插件配置及最近結果保存在 $DSH_HOME/plugins/codex-bridge/（默認 ~/.dsh/plugins/codex-bridge/）。
自動識圖（可選）¶
勾選「自動識圖（當前會話）」後，開啓協作的會話收到用戶圖片時會交給 Codex 分析，結果反饋給 DeepSeek；默認關閉，手動模式下也可獨立生效。圖片發往當前 Codex 所配置的模型服務，模型需支持圖片輸入。一次最多 8 張，每張不超過 20 MiB；QQ 圖片暫不支持。
環境安裝與登錄（Windows 側重）¶
環境配置在本機共用，與各會話協作開關獨立。面板提供：檢查連接、完整環境檢查、配置 CLI 與終端、同步系統代理到終端、打開瀏覽器登錄等。Windows 可在面板內安裝官方獨立 Codex CLI，無需另裝 Node 或 npm；僅安裝 ChatGPT 圖形客戶端不能保證 CLI 可用。插件不自帶 API Key，調用使用本機 CLI 的身份與模型配置。本插件已在 Windows 真機驗證；macOS / Linux 可參考 Codex 官方 CLI 說明，但尚未完成對應系統實機驗收。
當前範圍與限制¶
本版支持文字、代碼、圖片識別與訓練結果顧問協作；訓練本身仍由 DeepSeek 和本機工具執行。QQ 圖片、生圖和視頻生成尚未接入。
安裝與啓用¶
環境要求¶
- DeepSeek Harness：
0.2.1-rc.3（README 記載的已驗證目標版本；package.json中dsh引擎爲>=0.2.1-rc.3 <0.3.0-0） - Node（插件運行時）：
>=22.19.0（由 Harness 自帶運行時承載）
Windows 安裝包¶
從 GitHub Releases 下載 dsh-codex-bridge-0.4.0-windows.zip，解壓後雙擊 Install.cmd。安裝前完全退出 Harness，重新打開後會話輸入框旁出現 Codex 協作 入口，再通過面板安裝 CLI 並完成登錄。
GitHub 自動生成的 Source code 壓縮包是源碼；手動安裝可使用同一 Release 中的 .tgz。
使用 tgz 安裝（含遷移）¶
先打開 Harness 一次以初始化配置，再完全退出。在安裝包所在目錄執行：
dsh plugin --profile desktop add ./dsh-codex-bridge-0.4.0.tgz
Windows 遷移包中的 Install.cmd / Install.ps1 可自動尋找 Harness，也支持 -HarnessPath 指定安裝目錄。
卸載¶
完全退出 Harness 後執行：
dsh plugin --profile desktop remove dsh-codex-bridge
卸載保留設置和項目記錄；再次安裝後仍可讀取。
典型用法¶
- 在 Harness 會話輸入框旁點擊 Codex 協作。
- 在 環境安裝與登錄 中點擊 完整環境檢查；缺少 CLI 時點擊 配置 CLI 與終端；需登錄時點擊 打開瀏覽器登錄，在瀏覽器中完成授權。
- 勾選需要的功能，打開 在本會話啓用協作；更改其他設置後點擊 保存設置。
- 按自動或手動模式與 DeepSeek 協同工作；需要時由 DeepSeek 調用
consult_codex。
同一時刻僅執行一個環境配置任務；進行中的顧問調用與環境配置互斥。
適用場景與注意¶
適合：希望在同一 Harness 工作區內，讓 DeepSeek 執行的同時，用本機 Codex 做計劃、評審、識圖或訓練結果解讀的開發者；尤其 Windows 上希望面板內完成 CLI 安裝與檢查的流程。
注意：
- 插件在本機 DSH 進程權限下運行，安裝前應閱讀倉庫源碼與 MIT 許可證，確認可接受其只讀沙箱、上下文共享與網絡行爲。
- 工作區內含敏感資料時，應使用適當劃分的項目目錄；共享上下文不是完整聊天備份。
- 健康檢查成功只表示程序與登錄可用，真實請求仍可能因模型、服務端或網絡失敗。
- SkillHub 目錄頁與 GitHub 爲社區分發渠道，非 DeepSeek / 幻方官方應用商店。
