DeepSeek Harness (DSH) 的會話遵循單寫者約束：當桌面持有會話寫鎖時，外部進程的寫入會被拒絕。本插件通過“持鎖宿主代投”機制，爲 Codex 等外部驅動提供了一條協作通道，解決任務派發、獨立開發與結果交回審查的流程打通問題。
核心功能¶
插件本身不處理代碼生成，僅負責通信與同步。主要能力包括：
- 工作區同步與文件投遞：支持工作區定期自動同步、手動刷新，以及文件投遞箱功能，將外部登記的工作區同步到桌面側欄。
- 會話消息投遞：允許向桌面當前持有的 DSH 會話投遞任務或審查意見。
- Git 狀態交回：開發者完成提交、推送與 PR 後，插件通過
dsh2codex校驗 Git 狀態，將驗證摘要與 PR 信息交回指定的 Codex 對話。 - 零運行時依賴：插件僅使用 Node.js 內置模塊，無需安裝額外的 npm 包。
安裝與啓用¶
- 打開 DeepSeek Harness 的 設置。
- 進入 插件 菜單。
- 點擊 添加插件。
- 輸入倉庫地址：
https://github.com/heswy/dsh-plugin-codex-bridge
安裝後確保插件處於啓用狀態，並保持 DSH 桌面運行。
典型用法¶
該插件配合 Codex 側的 codex2dsh skill 和 DSH 側的 dsh2codex skill 使用，形成一個完整的協作閉環。
工作流程：
1. Codex 通過 codex2dsh 登記工作區、創建會話並投遞任務。
2. DSH 在任務工作區實施與驗證，插件將外部登記的工作區同步到桌面側欄。
3. 開發者完成提交、推送與 PR 後，dsh2codex 校驗狀態並通知指定的 Codex 對話。
4. Codex 在原會話內投遞審查意見，DSH 繼續修復與驗證。
查看會話索引：
運行以下命令查看宿主發佈的會話索引與交回 CLI 能力：
node tools/send.mjs --list
檢查 CLI 能力：
運行以下命令預演或檢查 Codex 側的 CLI 能力：
python3 skills/dsh2codex/scripts/notify.py --probe
注意事項¶
- 權限與安全：插件以當前 DSH 進程的權限運行。它不自動提交、推送、創建 PR、合併或發佈，所有 Git 操作需由用戶授權決定。
- 協作機制：DSH 的會話單寫者約束通過持鎖宿主代投實現。若遇到
session/writer-held狀態，需檢查所有權與回執。 - 併發風險：多宿主同時寫
workspace.json可能導致後寫覆蓋，插件定期對賬但不提供跨進程事務。 - 平臺兼容性：插件未在 Windows 上驗證，PR 與 Git URL 校驗支持
github.com。 - 同步方式：同步機制使用輪詢與手動刷新，不搶佔當前輪次。
總結¶
該插件爲 Codex 與 DeepSeek Harness 之間提供了一個具體的開發協作橋樑，適用於 Codex 負責規劃與審查、DSH 負責實施的工作流。相關文檔與源碼可在 GitHub 查看完整說明。
