前言¶
在 DeepSeek Harness（DSH）裏跑主 Agent、在本機 Codex 裏跑另一套 CLI 或桌面會話，兩邊各有一套聊天上下文，方案對齊往往要靠複製粘貼或口頭複述。若希望具名消息往返、在同一份記錄裏複覈結論，又不必把橋接消息灌進 Codex 當前主聊天，就需要在本機搭一座橋。社區插件 同舟（dsh-codex-bridge，維護者 PhoenixQian）面向這一問題：讓本機 Codex 與 DSH 通過具名討論協作，並在兩側查看同一份可讀討論史。插件包內含本機服務與閱讀頁面，不要求再單獨拉取開發者工作區。
這是什麼¶
同舟（Tongzhou）是 DSH 生態中的工作流類社區插件，倉庫爲 PhoenixQian/dsh-codex-bridge，當前發佈版本 0.3.0，許可證 MIT。它與 OpenAI、DeepSeek 無隸屬關係，不會代裝 Codex、複製登錄或提供共享賬號；模型調用按各自產品的賬號與計費規則執行。
首版環境約束（以 README 爲準）：
- 操作系統：macOS（
package.json中os爲darwin）。 - DSH Desktop：0.2.2-rc.1；對其他 DSH 版本會明確提示未驗證。
- 本機 Codex CLI 或帶 Codex CLI 的桌面應用，且已用用戶自己的賬號登錄。
- 命令行/開發側需要 Node.js 24.9.0 或更新；測試環境爲 Node.js 26。DSH Desktop 加載插件時使用宿主運行時。
未接入 Codex 時仍可打開同舟、整理議題並閱讀記錄；雙 Agent 討論需要 DSH 與 Codex 兩端都就緒。
核心功能¶
下面能力均來自倉庫 README，不展開未經文檔證實的特性。
討論與署名
- 新建議題時需寫明問題、背景、成員和最大往返次數，再點擊開始；新建記錄與打開頁面不會自動調用模型。
- Codex 與 DSH 的消息分別署名；用戶審閱意見單獨記錄。
- 主 Agent 可在答案充分時提前結束；用戶可暫停或補充要求。
會話隔離與展示
- 同舟討論複用獨立橋接會話，不把後臺來信注入當前 Codex 主聊天。
- DSH 側橋接原生會話屬於【同舟】工作區，默認展示易讀討論正文，可切回原生協議記錄。
工具與授權邊界
- 討論成員只能使用明確開放的只讀檢索工具；來信和引用文件不會擴大用戶授權，也不會自動寫入長期記憶。
- 若執行任務，需在任務頁選擇工作目錄並查看授權範圍；任務使用 macOS 沙箱，不支持的環境會明確停用。Python 爲可選能力，需配置獨立解釋器；插件不安裝 Python、Conda 或系統依賴。
本機服務
- 啓用插件後啓動僅監聽
127.0.0.1:32719的本機服務；僅此步驟不會發起模型調用。 - 健康檢查「在線」只表示服務/Host 就緒，最終結論應以實際回覆和回執爲準。
安裝與啓用¶
官方路徑是從 GitHub Releases 下載包，在 DSH Desktop 插件管理器中安裝，而非憑倉庫名拼接 CLI 安裝命令。
1、在 Releases 下載 dsh-codex-bridge-0.3.0.tgz。
2、在 DSH Desktop 的插件管理器中安裝該包並啓用。須裝到桌面 profile；Web profile 不會出現在桌面側欄。
3、打開 DSH 側欄【同舟】。插件會啓動本機服務（127.0.0.1:32719）。
4、點擊【接入本機 Codex】檢查狀態，再點【一鍵接入 Codex】安裝協作技能。Codex 需事先安裝並登錄；自動發現失敗時可指定本機可執行文件路徑（亦可通過環境變量 TONGZHOU_CODEX_CLI 指定 Codex CLI 絕對路徑）。
5、協作技能僅安裝到：
~/.agents/skills/tongzhou-collaboration/
不修改全局 AGENTS.md、Codex 模型配置或賬號；已存在的不同技能不會被靜默覆蓋。DSH 側無需在 Codex 再裝 DSH 插件。
社區目錄 skillhub 條目 需經維護者審覈；正式收錄後可從 dshmarket 直接安裝。當前 Release 包可獨立安裝，不要求 npm 賬號。
典型用法¶
在 DSH 側
新建議題 → 填寫問題、背景、成員、最大往返次數 → 開始討論。審閱過程中可暫停或補充要求。
在 Codex 側
在已登錄的 Codex 會話中，用自然語言說明「通過同舟和 DSH 討論……」，或明確調用技能 $tongzhou-collaboration。若當前會話未發現新技能，重新打開會話或重啓 Codex。
插件提供的 CLI 入口（package.json 中 bin）爲 tongzhou，對應 skills/tongzhou-collaboration/scripts/tongzhou.mjs。
數據目錄與環境變量¶
代碼與用戶數據分離。默認數據目錄爲 ~/.dsh/tongzhou/；若設置 DSH_HOME，則爲 $DSH_HOME/tongzhou/。也可用 TONGZHOU_DATA_DIR 覆蓋。
首版一臺機器只支持一個同舟實例，固定端口 32719。端口衝突時需先關閉另一實例；插件會報告衝突。
可選環境變量（摘自 README）：
| 變量 | 用途 |
|---|---|
TONGZHOU_DATA_DIR |
同舟可寫數據目錄 |
TONGZHOU_CODEX_CLI |
Codex CLI 的絕對路徑 |
TONGZHOU_DSH_RESOURCES |
非標準 DSH Desktop 安裝的 Resources 路徑 |
TONGZHOU_DSH_EXECUTABLE |
非標準 DSH Desktop 可執行文件 |
TONGZHOU_PYTHON_CODEX / TONGZHOU_PYTHON_DSH |
可選獨立 Python 解釋器 |
TONGZHOU_PYTHON_CODEX_PREFIX / TONGZHOU_PYTHON_DSH_PREFIX |
對應獨立 Python 環境目錄 |
討論、會話映射和交付狀態保存在本機；安裝包不包含作者的討論記錄、密鑰或個人路徑。插件不讀取或複製 auth.json，也不接收用戶在聊天中粘貼的密鑰。
適用場景與注意¶
適合誰
- 已在 macOS 上使用 DSH Desktop 0.2.2-rc.1 與本機 Codex，希望在同一臺機器上讓兩邊 Agent 具名往返、共享可讀討論史，且不希望橋接流量污染 Codex 主會話的開發者。
安裝與運行前建議
- 插件以當前 DSH 進程權限運行；安裝前應閱讀倉庫源碼與 MIT 許可證，自行判斷風險。
- 這是社區插件，與官方應用商店無從屬關係；skillhub 等爲社區目錄站點。
- 頁面離線時：確認插件已啓用，並查看數據目錄中的
web-service.log（反饋問題時先去掉消息正文、路徑和賬號信息）。 - 卸載：在插件管理器停用/卸載；討論數據不會自動刪除，可自行刪除同舟數據目錄。若不再使用 Codex 技能，可刪除
~/.agents/skills/tongzhou-collaboration/。
結尾¶
同舟把本機 Codex 與 DSH 收成一條具名、可審閱的討論鏈路，服務和閱讀界面都打在插件包裏，適合需要雙端對齊方案、又強調會話邊界與本地數據留存的場景。更多說明見社區目錄 PhoenixQian/dsh-codex-bridge 與 GitHub 倉庫 PhoenixQian/dsh-codex-bridge。
