前言¶
DeepSeek Harness（DSH）的插件化生態允許擴展其桌面能力。esroamer/codex-dsh-collab 旨在解決 Codex 與本地桌面環境協作的痛點。它通過一個可重用的技能，允許 Codex 將任務委派給桌面可見的 DeepSeek Harness 代理，並支持跟蹤執行、讀取結果及繼續工作。
插件定位¶
- 名稱：esroamer/codex-dsh-collab
- 維護者：ESROAMER
- 類別：工作流
- 核心價值：將 Codex 的任務處理能力延伸至桌面環境，提供作用域憑證管理和持久會話支持。
核心能力¶
該插件主要實現以下功能：
- 任務委派與執行跟蹤：Codex 可發起任務，DSH 代理在桌面執行，插件負責跟蹤執行流程。
- 工作區感知協作：支持基於工作區的上下文協作，Codex 可讀取執行結果並繼續後續工作。
- 客戶端無關協議：底層採用循環認證的 HTTP 協議，不依賴特定客戶端實現。
- 安全與會話管理：提供作用域憑證，支持持久會話和可重用技能。
安裝與配置¶
安裝需要同時配置 DSH 插件環境和 Codex 客戶端。
-
在 DSH 中添加插件：
打開 Settings → Plugins → Add plugin，輸入以下任一地址：https://github.com/ESROAMER/codex-dsh-collab@esroamer/codex-dsh-collab- 本地倉庫路徑
注：全工作區設置和註冊需要 0.2.0 及以上版本。
-
運行配置腳本：
在倉庫根目錄下執行 PowerShell 命令以授權工作區：
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -ConfigureOnly
系統會提示選擇要授權的工作區，該步驟會安裝 `$deepseek-harness` Codex 技能併爲選定工作區創建本地令牌。
- 檢查連接狀態：
安裝完成後，在倉庫根目錄運行：
.\install.ps1 -Check
- 在 Codex 中使用：
重啓 DSH（如需要）後，在 Codex 中調用$deepseek-harness，並描述任務和目標工作區。
高級配置¶
若需爲當前及未來的所有工作區進行配置，並允許 Codex 創建新工作區：
.\install.ps1 -ConfigureOnly -AllWorkspaces -AllowWorkspaceCreate
注意：Codex 僅在 DSH 尚未存在對應路徑的工作區時纔會註冊現有目錄，否則會複用現有工作區，不會創建新目錄。
運行環境與安全¶
- 系統要求：僅支持 Windows 平臺。必須安裝 DSH Desktop 和 Codex 客戶端。
- 開發環境：Setup 和 Codex 客戶端需要 Node.js 22+ 和 Python 3.10+。
- 權限範圍：插件訪問權限覆蓋選定的工作區或顯式授權的全工作區範圍。
- 權限分離：工作區的創建權限與 DSH 工具的審批權限是分離的，DSH 工具審批在插件安裝後依然有效。
注意事項¶
- 會話喚醒機制：Codex 是交互的發起者。DSH 不會主動喚醒處於空閒狀態的 Codex 會話。
- 桌面安裝修補：橋接安裝程序不會自動修補桌面安裝的 Windows shell 啓動配置。如果遇到相關啓動問題，需參考文檔手動處理。
- 許可證：本項目採用 MIT 許可證。
結語¶
該插件爲 Codex 與本地 DSH 的協同工作提供了標準化入口。通過作用域憑證和持久會話機制，開發者可以在不破壞安全隔離的前提下，讓智能體在桌面環境中持續執行復雜任務。
