在開發智能體或進行復雜調試時，DeepSeek Harness (DSH) Web 提供了良好的會話可視化，但本地 CLI 工具（如 Codex）通常無法直接與之交互。journ10/codex-dsh-bridge 解決了這個問題。它是一個 HTTP MCP 服務器，允許 Codex 通過 MCP 協議在正在運行的 DSH Web 中創建任務、繼續會話、查詢進度並獲取結果。會話由同一個 DSH Host 管理，並在 DSH Web 中可見。
核心功能¶
插件提供六個 MCP 工具，用於管理 DSH 會話的生命週期和數據：
dsh_workspaces：列出 DSH 已註冊的工作區，獲取workspace_id。dsh_sessions：列出會話，支持按工作區或目錄過濾。dsh_task：在指定工作區或目錄新建會話併發送prompt。dsh_send：向已有會話發送消息。支持queue（排隊）和steer（引導）模式。dsh_wait：等待會話結果。需要傳入異步提交返回的from_seq和request_id。dsh_status：查詢當前狀態、最近答案與工具調用。
安裝¶
安裝前需確保 DSH 版本爲 0.2.1-alpha.2，Node 版本爲 ^22.19.0 || >=24.0.0，且 Web profile 可正常啓動。
使用官方倉庫的發佈版本：
dsh plugin --profile web add github:journ10/codex-dsh-bridge#v0.1.0
安裝完成後需重啓 DSH Web。插件包僅包含 JavaScript 文件，無編譯步驟。
連接 Codex¶
在 Codex 配置文件中添加 MCP 服務器段。插件默認監聽 http://127.0.0.1:3080/codex-dsh。
[mcp_servers.dsh]
url = "http://127.0.0.1:3080/codex-dsh"
bearer_token_env_var = "DSH_BRIDGE_TOKEN"
tool_timeout_sec = 3600
令牌默認從 $DSH_HOME/codex-dsh-bridge.token 讀取。首次加載時，插件會以排他創建方式生成該文件（權限需爲 600）。令牌僅在用戶機器上配置，不會寫進倉庫。若不繼承終端環境，可在 Codex 配置中使用 Authorization 頭手動提供。
驗證服務是否正常加載工具：
curl --fail 'http://127.0.0.1:3080/codex-dsh?probe=tools'
工具使用流程¶
dsh_task 和 dsh_send 默認會等待結果。若需異步處理，可設置 wait: false，此時會返回 session_id、accepted、from_seq 和 request_id。隨後將這三個參數傳給 dsh_wait 以獲取特定請求的答案。
dsh_status 用於查詢當前狀態或最近狀態，默認僅折取末尾 200 個事件。steer 模式會共享當前 turn 的上下文，返回後續答案，而非獨立消息的隔離執行。
適用場景與注意¶
此插件僅支持 Web profile，未驗證 Desktop、TUI 或 headless profile 的安裝與運行。卸載插件不會刪除 DSH 中已有的會話數據。令牌文件權限需嚴格保護，避免向其他用戶開放。
MCP 提供 JSON POST 響應和工具調用，不包含服務器 SSE 推送。超時結束等待不代表停止 DSH 任務，客戶端斷連或插件卸載會取消等待計時器。
