前言¶

DSH 支持插件擴展；社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係。DSH 的理念是「一切皆插件」，插件可以在不直接改源碼的前提下擴展 DSH Web 的會話能力。

在同一個 dsh web 頁面裏，如果要在 DSH 的 Agent 流程和 Grok Build 之間切換，通常需要分別打開兩套界面。DSH Agent Bridge 要解決的是：把 Grok Build 作爲 ACP 驅動的根 Agent 放進 DSH Web 的空白會話選擇中，並繼續使用 DSH Web 的輸入框、工具展示、權限確認和 Markdown diff 界面。

這是什麼¶

DSH Agent Bridge 由 zmh2000829 維護，倉庫爲 zmh2000829/DSH-agent-bridge，安裝名爲 dsh-grok-acp。

它的一句話定位是：Use Grok Build as an ACP-powered root agent inside DeepSeek Harness Web。換句話說，它把 Grok Build 接入 DSH Web，並把 ACP 流式輸出映射回 DSH Web 可閱讀、可操作的結果。

當前資料表明，項目當前只實現 Grok Build，當前沒有 Codex 或 Claude Code 適配器。插件以獨立 DSH Bundle 形式安裝，不修改全局 npm 包或 DeepSeek Harness 源碼。

核心功能¶

• 在同一個 dsh web 頁面選擇 DSH 或 Grok Build。
• DSH 模式動態讀取當前部署提供的 Agent 預設，並保留現有模型和插件。
• Grok Build 模式只展示 ACP 實際報告的模型和推理力度，並隱藏無關的 DSH Agent 預設。
• ACP 流式輸出映射爲 DSH 的回答、思考、工具調用和 diff。
• 計劃更新進入輸入框上方可摺疊的原生任務面板，不再反覆寫入回答正文。
• 每輪 Grok 工具調用收攏爲一行醒目的活動摘要，點擊後展開完整時間線；失敗時自動展開。
• 文件修改、Markdown diff 和權限請求繼續獨立展示。
• Grok 權限請求進入 DSH 的批准界面。
• DSH 的 Full access 會同步到 Grok ACP 文件訪問和批准策略。
• 支持 /usage、/context、/session-info、/btw、/model、/models、/effort 等 Grok 命令，併兼容 /uasge 拼寫。
• /model 與 /models 只展示當前 Harness 的模型。
• 空白會話可切換 Harness；首輪消息發出後鎖定，避免一段歷史由兩個 Agent 引擎共同生成。
• 多個 Grok 會話複用一個按需啓動的 ACP 進程，空閒後自動關閉。
• ACP 進程異常退出後，下一次請求會自動重啓進程並恢復對應的 Grok 會話。

安裝與啓用¶

前置條件¶

1、macOS 或能夠運行 Grok Build CLI 的環境。

2、Node.js ^22.19 或 >=24。

3、全局安裝 DeepSeek Harness 0.1.1-rc.2，且 dsh web 能正常啓動。

4、已安裝並登錄 Grok Build CLI，且 grok --version 可以成功執行。

從 npm 安裝¶

先安裝插件，再啓動 DSH Web：

dsh plugin --profile web add dsh-grok-acp@latest
dsh web

啓動後打開 3080 頁面，新建會話。如果瀏覽器緩存舊前端，可執行硬刷新。

從本地項目路徑安裝¶

如果項目已經在本機，也可以直接指定完整路徑安裝。下面的路徑是示例路徑，替換爲本機實際項目目錄：

dsh plugin --profile web add /Users/your-name/Projects/DSH-agent-bridge
dsh web

檢查安裝¶

用下面命令檢查當前 Web profile 下的插件狀態：

dsh plugin --profile web exec dsh-grok doctor

典型用法¶

1、啓動 dsh web 並打開 3080 頁面。

2、點擊“新會話”。

3、在輸入框下方選擇 DSH 或 Grok Build。

4、選擇 DSH 時，可在輸入框上方選擇四種 Agent 預設；選擇 Grok Build 時，可在輸入框右側選擇 Grok 模型和推理力度。

5、發出第一條消息後，本會話的 Harness 被鎖定；要更換 Harness，請新建會話。

Grok Build 會話支持以下命令：

• /usage、/cost、/uasge
• /context
• /session-info
• /btw <問題>
• /model
• /models
• /effort <級別>
• /compact
• /goal
• /workflow
• /deep-research

其中 /model 與 /models 只展示當前 Harness 的模型。

安全與注意¶

• 默認需要逐次批准敏感操作，ACP 文件接口也只能訪問會話工作目錄。
• 文件讀寫默認限制在當前會話工作目錄，並拒絕通過絕對路徑、.. 或符號鏈接越界。
• yoloMode 與 allowOutsideWorkspace 都是顯式的高權限選項，僅在明確接受風險時再開啓。
• 瀏覽器橋接路由只接受 loopback Host，並拒絕跨站請求；寫操作要求同源 JSON 請求。
• 插件當前針對 DSH 0.1.1-rc.2 開發；DSH 預發佈版本可能改變內部 AgentFactory 或客戶端 Slot API。
• 該插件會調用本機 Grok Build CLI 子進程，安裝前應檢查源碼和 MIT License。
• 不要手工編輯 ~/.dsh/profiles/web/package.json。
• 卸載插件不會刪除 Grok 自己的登錄信息或會話文件。

更新與卸載¶

更新 npm 安裝：

dsh plugin --profile web add dsh-grok-acp@latest

卸載插件：

dsh plugin --profile web remove dsh-grok-acp
dsh web

結尾¶

DSH Agent Bridge 的價值，是在 DSH Web 的會話選擇中接入 Grok Build，並保留 DSH Web 的原生展示、工具時間線、權限確認和 diff 展示。當前資料未給出可確認的目錄頁 URL；倉庫地址爲：

https://github.com/zmh2000829/DSH-agent-bridge