前言¶
DeepSeek Harness（DSH）把智能體循環、工具調用、工作區審批和沙箱策略放在本地或自託管運行時裏執行。日常開發時，你往往已經在瀏覽器裏開着 ChatGPT，卻還要切到 DSH Web 或終端去新建會話、跟進進度、處理審批。兩邊沒有統一入口，遠程協作時更難讓同事「看見」本地 DSH 在做什麼。
下面介紹的 dsh-chatgpt-bridge 是一條 MCP 橋接路徑：讓 ChatGPT Web 通過官方 Model Context Protocol，在受控隧道里調用本地 DSH，創建、查看、繼續和監督 agent 會話。控制方向是 ChatGPT Web → 安全 MCP 隧道 → 橋接插件 → DSH；它不會讓 DSH 去調用 ChatGPT，也不會把 DSH 的模型請求路由到 ChatGPT。
這是什麼¶
dsh-chatgpt-bridge 由維護者 jiezeng2004-design 作爲獨立 DSH 插件持續維護。當前公開發布版本爲 0.4.1（npm 包同名），README 寫明已在 DSH 0.1.1-rc.1 上端到端驗證。許可證爲 MIT。
插件只做連接：會話日誌、agent 循環、工具、技能、子智能體、工作流、審批、沙箱與工作區安全模型仍由 DSH 核心承擔，無需修改 DSH 核心代碼。在 SkillHub 等社區目錄中，它歸類爲「工作流」類插件。
核心功能¶
MCP 工具面¶
橋接通過 MCP 暴露 15 個工具。連接建立後，應在 ChatGPT 側掃描或刷新工具列表；README 要求列表中應包含第 15 個工具 dsh_update_goal，若缺失需重新掃描連接器。
文檔中明確提到的工具包括：
- 只讀檢查：
dsh_health、dsh_list_workspaces - 會話與消息：
dsh_send_message - Goal 監督：
dsh_start_goal、dsh_wait_goal、dsh_update_goal - 審批：
dsh_approve
其中包含寫入與動作類工具，不僅限於只讀 MCP。橋接會驅動真實的 DSH agent，在 DSH 已註冊工作區內按審批與沙箱策略修改文件，安裝前應理解這一權限邊界。
原生設置與隧道運行時（v0.4.0）¶
DSH Web 的 Settings → ChatGPT Bridge 頁面可在圖形界面管理 OpenAI 隧道：配置隧道、保存 Runtime API key、啓動/停止/重啓插件自帶的 tunnel-client、查看即時狀態、運行分層診斷並查看脫敏日誌。
運行時配置位於 $DSH_HOME/chatgpt-bridge/runtime-config.json；密鑰存放在 $DSH_HOME/chatgpt-bridge/secrets/，生成的 profile 僅以 file: 引用。管理 API 爲 DSH Web 服務器上的 loopback 路徑 /_dsh/chatgpt-bridge/*，帶 Host/Origin/Content-Type 等 CSRF 檢查。
本地端點¶
在同一 web profile/runtime 中同時運行 DSH Web 與橋接時，默認端點爲：
| 用途 | URL |
|---|---|
| DSH Web | http://127.0.0.1:3080 |
| Bridge MCP | http://127.0.0.1:3456/mcp |
橋接綁定 127.0.0.1，不自行對外暴露公網接口，也不自建隧道；ChatGPT Web 需通過 OpenAI 當前支持的 Secure MCP Tunnel 等機制，把遠程 MCP 客戶端請求轉發到本機 loopback。
安裝與啓用¶
環境要求¶
- Node.js >= 22，且可在
PATH中調用。 - 可用的 DSH 安裝（
dsh在PATH中）；README 示例亦可用pnpm dlx @deepseek-ai/dsh@0.1.1-rc.1替代每條命令裏的dsh。 - 建議使用 web profile：DSH Web 與橋接應運行在同一 web profile/runtime，ChatGPT 創建的會話才能在 DSH Web 中即時可見。
- ChatGPT 側的 MCP 與寫入類動作是否可用，取決於你當前的 OpenAI 套餐與工作區；安裝前請查閱 OpenAI 官方文檔。
安裝插件¶
推薦從已發佈的 npm 包安裝到 web profile：
dsh plugin --profile web add dsh-chatgpt-bridge
僅執行 npm install dsh-chatgpt-bridge 不夠：插件必須加入 DSH profile bundle，dsh plugin ... add 會完成這一步。
啓動運行時¶
dsh web
在同一 web profile/runtime 中啓動 DSH Web 與橋接。
讀取認證令牌¶
首次啓動時，橋接會生成令牌並寫入 $DSH_HOME/chatgpt-bridge.token。macOS / Linux 下讀取：
cat ~/.dsh/chatgpt-bridge.token
勿將令牌提交到 GitHub 或粘貼到公開聊天；它授權 MCP 訪問你的 DSH 運行時。也可自行設置環境變量 DSH_CHATGPT_BRIDGE_TOKEN，橋接將優先使用該值。
連接 ChatGPT¶
ChatGPT Web 無法直接訪問本機 http://127.0.0.1:3456/mcp。若橋接跑在本機，需通過 OpenAI 當前支持的 Secure MCP Tunnel 將請求轉發到 loopback；在連接器中使用步驟 3 的令牌作爲 MCP Authorization Bearer。stdio 傳輸不是 ChatGPT Web 的快速路徑；其他 MCP 客戶端可參考 README 的 Advanced 章節。
連接後掃描/刷新 MCP 工具，確認 15 個工具（含 dsh_update_goal）均已出現。
典型用法¶
只讀驗收¶
將以下提示交給已連接 MCP 的 ChatGPT，驗證橋接與 DSH 健康狀態：
請使用已連接的 DSH App，只做只讀檢查：
1. 調用 dsh_health
2. 調用 dsh_list_workspaces
3. 不修改任何文件
4. 返回 bridge version、health 和 workspace 名稱
README 給出的期望結果示例：
health = ok
bridge version = 0.4.1
Goal 監督（只讀約束）¶
在確認工作區名稱後，可用 Goal 流程做結構化只讀檢查：
使用 dsh_start_goal 創建一個只讀檢查目標（workspace 用 dsh_list_workspaces
查到的名稱），goal 描述爲“只讀檢查項目”，plan 爲列出項目結構並總結
README，constraints 使用 {"read_only": true}。然後反覆調用 dsh_wait_goal
直到 terminal，最後只彙報 health、goal revision 和總結，不修改任何文件。
v0.3.0 引入的 Goal Control Plane 與 v0.4.0 的原生設置能力在 0.4.1 中仍保留。
適用場景與注意¶
適合誰
- 已在本地或自託管環境運行 DSH，並希望在 ChatGPT Web 中統一發起和監督 agent 任務。
- 需要遠程同事通過 ChatGPT（在隧道與令牌保護下）查看 DSH 會話進度、處理審批，而不必直接登錄 DSH 機器。
- 希望保持 DSH 原有安全模型，僅增加一條 MCP 橋接，而非改造 DSH 核心。
注意事項
- 插件以當前
dsh進程權限運行，寫入類工具可在已註冊工作區內改文件；安裝前應閱讀源碼與 MIT 許可證，並理解 DSH 審批與沙箱策略。 - 橋接不替代 DSH 的模型後端；模型請求仍由 DSH 自身配置決定。
- SkillHub、dshbase、DSHarness 等目錄爲社區生態列表，與 DeepSeek / 幻方無官方從屬關係；目錄標籤不代表安全審計或用戶規模背書。
- GitHub 倉庫當前約 11 stars；維護方持續跟蹤 DSH 上游兼容性併發布迴歸測試過的版本。
鏈接¶
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/jiezeng2004-design/dsh-chatgpt-bridge
- GitHub 倉庫：https://github.com/jiezeng2004-design/dsh-chatgpt-bridge
- npm 包：https://www.npmjs.com/package/dsh-chatgpt-bridge
經過上面的步驟，你可以在 ChatGPT Web 與本地 DSH 之間建立一條受控 MCP 通道：會話仍是原生 DSH 會話，安全邊界仍由 DSH 承擔，多一個從瀏覽器側創建與監督智能體工作流的入口。
