让 DSH(DeepSeek Harness)同时接入 Codex pair 与本机 Claude Code 的完整方案:MCP 适配器、对端面板、Windows 一键启动与配置。本仓库包含三个部分:
agentbridge-dsh/ 核心 MCP 适配器(Bun):把 agent-bridge pair 协议转换为
DSH 可调用的 MCP 工具(send_message / get_messages /
pair_status / claude_send)
dsh-pair-panel/ DSH Web 插件:右侧显示 Codex / Claude 对端面板
launcher/ Windows 一键启动脚本(DSH Web + adapter + 浏览器窗口)
shims/ Windows 命令 shim 模板(abg / dsh / chromium)
config/ DSH MCP 配置示例
- agentbridge-dsh(子目录):用 Bun 运行的 MCP 适配器,连接
agent-bridge daemon,让 DSH 既能加入
Codex pair(channel/attach),也能对接
abg claude(server 模式)。详细用法见 agentbridge-dsh/README.md。 - dsh-pair-panel(子目录):DSH Web 网页插件,读取 Codex rollout、适配器 feed 和 Claude Code 会话记录,显示单面板或 Codex / Claude 双面板。 安装与配置见 dsh-pair-panel/README.md。
- launcher / shims / config:Windows 落地配套——自动探测依赖、生成命令 shim、 配置 MCP、隐藏控制台窗口的一键启动。详见下文「Windows 安装步骤」。
来源:
agentbridge-dsh/与dsh-pair-panel/分别由 visualeafsama-hub/agentbridge-dsh 和 visualeafsama-hub/dsh-pair-panel 改进而来,完整 git 历史保留在各子目录中。
当前代码已同时适配 DSH 0.1.x(老 web profile 流程) 与 DSH 0.2.x
(桌面 App / 最新 web 版),且在 0.2.1-rc.2(桌面版 44.7.0 同版本)上实测通过:
bundle 安装、host 半加载、三个 HTTP 路由、client bundle 进 __DSH_BOOT__、
MCP 适配器握手与 tools/call 均正常。主要适配点:
- web / desktop 两条安装路径:桌面 App 的
desktopprofile 不能用普通dsh plugin --profile desktop管理(CLI 明确拒绝),改为「插件页本地目录安装」 或桌面自带 CLI;MCP 配置支持写 profile 或 home 层(一次覆盖两个 profile)。 - DSH 0.2.x 消息格式:推送唤醒改用 session format v4 的
source: { kind: 'plugin:ui-pair-panel' },避免 v4 编码器拒绝导致会话日志卡住。 - 插件生命周期:三个 route 注册包进
ctx.effect,兼容 HMR/禁用再启用; client 半补exports.inject = ["slots"];session.meta→session.header。 - 布局:面板改为右侧通栏停靠栏(顶到标题栏下沿、与左侧侧边栏同风格), 不再悬浮在聊天上;会话标题栏右侧工具区放置显示/隐藏小图标,窄窗口不再与 文件夹图标重叠;消息按 Markdown 渲染;feed 滚动贴底逻辑加固(双 rAF + 关闭浏览器 scroll anchoring)。client 半把当前会话 id 传给 host,DSH 上下文 仪表在桌面版也能工作。
- 适配器:
abg dsh --pair自动识别并复用正在运行的桌面 App(netstat + tasklist +/manifest.webmanifest指纹,无需手填端口),不再重复起 web 实例; 修复abg dsh mcp子命令分发、Windows 下.cmd启动与错误处理; MCP 配置默认带toolCallTimeoutMs: 300000。 - 一键安装:仓库根目录
install-dsh.ps1 -Profile both。
版本细节、逐项改动与实测记录见 COMPATIBILITY.md。
┌────────────────┐ MCP / HTTP ┌───────────────────┐
│ DSH Web GUI │ ─────────────────────▶ │ agentbridge-dsh │
│ 会话与工具 │ ◀───────────────────── │ MCP adapter │
└───────┬────────┘ 127.0.0.1:8765 └─────────┬─────────┘
│ │
│ dsh-pair-panel │ attach / channel
▼ ▼
┌────────────────┐ ┌───────────────────┐
│ Codex / Claude │ │ agent-bridge │
│ 双对端面板 │ │ daemon + pair │
└────────────────┘ └─────────┬─────────┘
▼
┌───────────────────┐
│ Codex TUI / CLI │
└───────────────────┘
DSH ──MCP claude_send──▶ 本机 claude -p ──▶ Claude Code
各组件职责:
- agentbridge-dsh 适配器:使用 Bun 运行,连接 agent-bridge daemon,提供
send_message、get_messages、pair_status和claude_send等 MCP 工具。 - dsh-pair-panel 面板:读取 Codex rollout、适配器 feed 和 Claude Code 会话记录,在 DSH Web 中显示单面板或 Codex / Claude 双面板。
- launcher:检查 DSH Web、pair control 端口和 MCP adapter 状态,按需启动 缺失进程并打开 Chrome/Chromium 应用窗口。
- shims:在 Windows 上生成
abg、dsh和chromium命令包装;abgshim 只拦截dsh子命令,其余参数继续透传给真实 agent-bridge CLI。 - MCP 配置:把本机
http://127.0.0.1:8765/mcp注册到 DSH Web。
DSH 会话内可用的主要工具:
mcp__abg__send_message:向当前 pair 对端发送消息并等待回复;mcp__abg__get_messages:获取尚未被消费的对端消息;mcp__abg__pair_status:检查 daemon、proxy、control 和 app-server 状态;mcp__abg__claude_send:调用本机 Claude Code CLI。
| 依赖 | 用途 | 安装说明 |
|---|---|---|
| Bun | 运行 agentbridge-dsh | 按 Bun 官方方式安装 |
| Node.js 18+ | 运行 DSH CLI 等 Node 工具 | 建议使用当前 LTS |
| agent-bridge | pair、daemon 和真实 abg 命令 |
按其仓库说明安装 |
| agentbridge-dsh | DSH 与 agent-bridge 之间的 MCP 适配器 | 单独克隆 |
| Codex CLI | pair 的 Codex 侧 | 按官方方式安装 |
| Claude Code CLI | claude_send 的本机执行入口 |
先完成登录或 API 配置 |
@deepseek-ai/dsh |
DSH Web 服务 | 全局安装或使用 npx |
| Chrome / Chromium | DSH 独立应用窗口 | 已安装 Chrome 即可 |
| PowerShell | 执行 launcher 和 shim 安装器 | Windows 5.1 可用,建议 7+ |
| Git Bash | 执行本文安装命令 | Git for Windows 自带 |
安装前在 Git Bash 中检查命令:
where.exe node
where.exe bun
where.exe abg
where.exe codex
where.exe claude如果同一个命令返回多条路径,请确认 PATH 第一项是准备使用的版本。
以下命令在 Git Bash 中执行。PowerShell 也可以完成相同操作,但路径格式和 环境变量语法不同。
先安装 Bun、Node.js、agent-bridge、Codex CLI、Claude Code CLI、DSH 和 Chrome/Chromium,并确认上一节中的命令均能被找到。
git clone https://github.com/RAB123QQ/agent-bridge-dsh.git ~/agent-bridge-dsh
cd ~/agent-bridge-dshcd agentbridge-dsh
./install.sh # 安装 abg shim 到 ~/.bun/bin/abginstall.sh 生成 abg 薄包装:所有 dsh 子命令路由到本适配器,其余命令
(doctor / pairs / resume / kill / --pair ...)原样透传给真 abg。详细说明见
agentbridge-dsh/README.md。
DSH 0.2.x 有两类宿主,选对应的安装方式:
# A. CLI / 浏览器 web 版(profile = web)
dsh plugin --profile web add "$PWD/dsh-pair-panel"
# B. 桌面 App(profile = desktop,普通 dsh CLI 会拒绝该 profile)
# 推荐:桌面 App 侧栏「插件」→「添加插件」→「安装第三方插件」→ 本地目录
# 或完全退出 App 后,用桌面自带 CLI:
# "<安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "<本目录绝对路径>"
# C. 两边都装 + 自动写 MCP 配置(PowerShell 7)
powershell -NoProfile -ExecutionPolicy Bypass -File .\install-dsh.ps1 -Profile both安装后重启 abg dsh --pair <name> / 刷新页面;桌面 App 需重启或重新加载页面。
详见 dsh-pair-panel/README.md。
在仓库根目录执行(Git Bash 的 $HOME/... 是 POSIX 路径,PowerShell 需要
Windows 路径,因此使用 cygpath -w 转换):
cd ~/agent-bridge-dsh
export AGENTBRIDGE_DSH_DIR="$(cygpath -w "$HOME/agent-bridge-dsh/agentbridge-dsh")"
powershell.exe -NoProfile -ExecutionPolicy Bypass \
-File "$(cygpath -w "$PWD/shims/install-shims.ps1")"安装器默认向 %USERPROFILE%\.bun\bin 写入:
abg.cmd/abg.ps1;dsh.cmd;chromium.cmd。
脚本会自动探测 node.exe、Chrome/Chromium 和 DSH bin.js。如果探测失败,可在
PowerShell 中给 install-shims.ps1 显式传入 -AdapterPath、-NodeExe、
-DshBinJs 或 -ChromeExe。
确认 %USERPROFILE%\.bun\bin 位于 PATH 前部,然后重新打开 Git Bash:
abg doctor
abg dsh --helpabg doctor 应继续调用真实 agent-bridge;abg dsh --help 应显示
agentbridge-dsh 的帮助。
把 config/cordis.patch.yml.example 中的插件配置合并到当前宿主的 patch 层:
| 宿主 | 文件 |
|---|---|
| 桌面 App(profile=desktop) | $DSH_HOME/profiles/desktop/cordis.patch.yml |
dsh web / abg dsh(profile=web) |
$DSH_HOME/profiles/web/cordis.patch.yml |
| 两者共用(推荐) | $DSH_HOME/cordis.patch.yml(home 层,对所有 profile 生效) |
DSH_HOME 未设置时通常位于 %USERPROFILE%\.dsh。
配置必须使用 - insert::
- insert:
- id: mcp-agentbridge
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: abg
transport: streamable-http
url: http://127.0.0.1:8765/mcp
toolCallTimeoutMs: 300000 # 0.2.x 必加:默认 60s 会截断长回合cordis.patch.yml 是“覆盖/插入”层:插入新条目必须用 - insert:,直接写
- id: 匹配不到已有条目时只会警告后丢弃;空文件/仅注释会导致启动失败,禁用时写
[]。保存后 live profile 一般会 HMR 热生效;工具列表没更新就重启宿主进程
(web 版 dsh web,桌面版重启 App)。
launcher/launch-dsh.vbs 与 launcher/launch-dsh.ps1 应放在同一目录。桌面
快捷方式指向 launch-dsh.vbs,它会隐藏 PowerShell 控制台窗口。
建议配置以下用户环境变量:
AGENTBRIDGE_DSH_DIR=<agentbridge-dsh 克隆目录>
AGENTBRIDGE_DSH_PAIR=<pair 名称>
DSH_WORKDIR=<pair 对应的项目目录>
可选变量和脚本参数见 launcher/launch-dsh.ps1 文件头说明。
先在目标项目目录启动 Codex pair:
cd /path/to/project
abg codex --pair main然后在同一项目目录启动 DSH 侧:
cd /path/to/project
abg dsh --pair mainabg dsh --pair main 会启动 MCP adapter,并在默认模式下按需启动 DSH Web、
打开 Chrome/Chromium 应用窗口、attach 到指定 pair 并输出对话流。
配套 dsh-pair-panel 插件根据数据情况显示:
- 只有 Codex 数据:单个“Codex 对端”面板;
- 只有 Claude 数据:单个“Claude 对端”面板;
- 两侧都有数据:Codex / Claude 两个面板并排显示。
面板只负责显示消息、上下文和启动入口,不代替 agent-bridge 的通信链路。
pair registry 同时记录名称和 cwd。建议始终显式传入 --pair NAME,并确保 Codex、
DSH、launcher 的 DSH_WORKDIR 都指向同一个项目目录。
配置好 launcher/launch-dsh.vbs 后,可以通过桌面快捷方式一键:
- 检查 DSH Web 是否已启动;
- 检查 pair control 和 MCP adapter 是否可达;
- 按需启动
abg dsh --pair <NAME>; - 打开 Chrome/Chromium 应用窗口。
脚本不会重复启动已监听的服务。日志写在 launcher 目录:
launch-dsh.log;dsh-web.log;abg-dsh.log。
面板中的 Codex / Claude 启动按钮会请求宿主启动对应侧。宿主应负责启动状态、重复 点击保护和错误反馈;“存在历史消息”不等于对应进程当前仍在运行。
mcp__abg__claude_send 会在 pair 工作目录中运行:
claude -p <提示词>
它使用本机 Claude Code 的登录/API 配置,不通过本配套包保存任何密钥。
常用参数:
text:发送给 Claude Code 的提示词;timeoutMs:最大等待时间;continue:是否延续当前 cwd 的最近会话,默认true;readonly:是否增加--permission-mode plan,默认false。
Windows 下可通过 ABG_CLAUDE_BIN 指定 Claude Code 的可执行入口。如果 PATH 中
的 claude 实际解析为无法被 Node 直接启动的 .cmd,应把该变量指向可执行程序
或显式调用 cmd.exe 的包装入口。
claude -p 每次调用都会启动新的 Claude Code 进程。continue: true 只表示增加
--continue;Claude Code 会根据当前 cwd 选择最近一次会话,不是 MCP adapter
在内存中维护上下文。
这意味着:
- 同一 cwd 下连续调用,才能延续该目录最近的 Claude Code 会话;
- 更换 pair 工作目录后,不会继续原项目的最近会话;
- 多个 DSH 会话并发复用同一 cwd,可能争用同一条最近会话;
- 与上一任务无关时,使用
continue: false开启独立会话。
readonly: true 会给 Claude Code 增加:
--permission-mode plan
适合代码阅读、方案设计和不希望落地修改的任务。需要注意:
- 只读边界由 Claude Code 自身的 plan 模式实现;
- 它不是本配套包额外提供的操作系统沙箱;
- 高风险或不可信项目仍应使用独立目录、虚拟机或容器;
- 默认
readonly: false时,Claude Code 可能读取和修改文件、运行命令。
MIT,见 LICENSE。
