前言¶

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