juyanjy/dsh-codex-bridge：從 Harness 連接並引導本地 Codex 會話

DeepSeek Harness（DSH）作爲一個插件化平臺，允許開發者通過工具調用外部服務。本地 Codex 會話通常運行在 Codex 桌面應用中，與其協議對接存在技術壁壘。本插件通過 Codex app-server 協議，在 Harness 中實現了對這些會話的實時觀察與指令下發。

插件信息¶

• 項目名稱：juyanjy/dsh-codex-bridge
• 項目描述：通過 Codex app-server 協議從 DeepSeek Harness 連接並引導本地 Codex（OpenAI）會話。
• 維護者：JUYANJY
• 分類：工作流
• 開源協議：MIT
• 安裝命令：

  node scripts/install.mjs

核心功能¶

本插件提供了一套工具集，用於監控和操控本地 Codex 進程：

• 協議連接：連接到 Codex app-server 協議，支持對會話的觀察和引導。
• 狀態監控工具：
• codex_status：檢查賬戶信息、計劃、速率限制預算及本地進程狀態。
• codex_threads：列出最近的線程，支持按搜索字符串過濾。
• codex_transcript：獲取指定線程的詳細記錄。
• codex_watch：監控線程的實時流，返回流經的事件。
• codex_queue：查看線程中等待的消息，支持取消操作。
• 交互與控制：
• codex_send：向 Codex 發送消息，支持參數 queue（入隊）、turn（回合）和 steer（引導）。
• codex_approvals：列出待處理的審批請求並予以回覆。
• codex_budget：讀取速率限制桶，判斷是否超出配額。
• codex_ask：在一次性線程中提問並將答案回填到開發線程中。
• codex_handoff：構建接管簡報，支持 prepare（準備接管）和 claim（聲明接管）動作。
• 可視化面板：在 Harness 中提供 Codex 側邊欄面板，顯示四種狀態：Needs you（紅色）、Blocked（橙色）、Running（綠色）和 Nothing observed（灰色）。
• 自動化輔助：支持自動延續消息功能 “Keep Codex moving for 30m”。

典型用法¶

1. 監控線程流：
   使用 codex_watch 監控線程的實時流，合併實時通知流和輪詢記錄。
2. 發送指令：
   使用 codex_send 發送消息。當桌面應用持有線程的寫鎖時，會自動回退到隊列模式。
3. 接管會話：
   使用 codex_handoff 準備接管簡報。若需正式聲明接管，必須顯式調用 codex_handoff action=claim。
4. 檢查狀態：
   使用 codex_status 檢查本地進程及 Codex 賬戶的速率限制預算。

注意事項¶

• 運行環境：需要 Node.js 版本 >= 22。
• 依賴關係：@deepseek-ai/dsh-tools 和 @deepseek-ai/schemastery 爲可選的 peerDependencies。
• 接管流程：準備接管簡報並不算移交，必須顯式調用 codex_handoff action=claim 才能聲明接管。
• 採樣機制：隊列、項目、回合和目標的檢查是採樣的，非全量讀取。
• 配額邏輯：速率限制桶使用 usedPercent。100% 不報告爲 “out of quota”，只有當服務器標記爲超出時才報告。

相關鏈接¶

• 插件目錄
• GitHub 倉庫