前言¶
在 DeepSeek Harness（DSH）里，每台机器通常各跑一套环境与 Bot。开发或协作时，常见需求是：机器 A 上的 Bot 要把一条任务或上下文交给机器 B 上的 Bot 处理，而不是让人在两台机器之间复制粘贴。
ds-harness-remote 已经提供加密通道、账号鉴权、穿透与 plugin.route.v1（把 ds-bot 的 POST api/bot 转发到对端 Host）。若直接用 remote 的 setMode('client', id)，会把本机整个 Harness API 代理到对端，窗口变成对方的——适合人远程操作，不适合 Bot 在后台互发消息。
下面介绍社区插件 dsh-remote-bot-bridge（维护者 onesmash）：它把 remote 的 client runtime 包装成 Bot 可调用的工具，只做「最后一厘米」，本地窗口全程不动。
这是什么¶
dsh-remote-bot-bridge 是基于 ds-harness-remote 的 DSH 插件（npm 包名 dsh-remote-bot-bridge，当前版本 0.1.2，MIT 许可证）。它解决的是：机器 A 与机器 B 各跑一套 DSH 时，A 上的 Bot 如何给 B 上的 Bot 发一条消息，且不把本机 Harness 窗口切到对端。
插件通过 client runtime 上的 connect(deviceId) 建立连接，不设置 connected、不切换 API/gateway；连接由插件自行管理关闭。
核心功能¶
与 remote 的分工¶
- 底层：Noise 端到端加密、账号级鉴权、
LAN → P2P → TURN → Relay穿透（Host 只需出站，无需公网 IP）、plugin.route.v1转发 ds-bot 操作。 - 本插件：注册
remote_*工具，供本地 Bot 查状态、选目标、列对端 Bot、发消息、测连接。
Bot 侧工具¶
| 工具 | 作用 |
|---|---|
remote_status |
登录态、当前后台目标、同账号设备（名字 / deviceId / 在线） |
remote_target |
可选：固定目标设备或设别名，"none" 清除 |
remote_bots |
列出对端 Bot（名字 + session id） |
remote_send |
给对端某个 Bot 发消息（to 给名字或 id，message 给正文） |
remote_ping |
测冷/热连接耗时，报告协商出的传输路径 |
消息在对端以「用户输入」进入目标 Bot 会话（ds-bot 的 send 内部走 ctx.sessionController.prompt({ mode: 'queue' })）。
连接复用¶
冷连接开销远大于单次 RPC。README 中 LAN 实测：建立连接约 4.3–5.3 s，一次 RPC 约 15–18 ms。插件采用三层策略：
- 借道：Remote UI 已连同一对端时，复用该连接，零成本、不改变窗口状态。
- 池：自建私有连接并复用，空闲 5 分钟自动关闭。
- 冷启动：以上都没有时新建。
体感上首次约 4–5 秒，之后约 20–50 毫秒；remote_ping 会分别报告冷连接与复用命中耗时。
双向传话¶
plugin.route 为 Client → Host 单方向；一条连接只服务一个方向。若 A、B 都要互发，两台机器都安装本插件，各自把目标指向对方，形成两条独立连接（各自走连接池）。
安装与启用¶
接收方 Host 必须启用 ds-bot，且 remote 版本支持 plugin.route.v1。两台机器需先安装并登录同一 remote 账号，再装本插件并重启 DSH。
# 1. 两台机器都装 ds-harness-remote 并登录同一账号
dsh plugin --profile desktop add -w ds-harness-remote@0.5.17
# 2. 装本插件
dsh plugin --profile desktop add dsh-remote-bot-bridge
# 3. 重启 DSH
插件以当前 DSH 进程权限运行；安装前建议在 GitHub 阅读源码与 MIT 许可证，确认符合你的安全策略。
典型用法¶
正常情况下不必记工具名，直接对 Bot 说明意图即可，例如：
发给远端的 Chief：ZOOM-1449791 那个 MR 帮我看下状态
未设置目标时，若仅有一台对端在线，插件会自动选中并记住，之后无需重复配置。
需要精确控制时，可显式调用上表中的 remote_target、remote_bots、remote_send 等工具。
适用场景与注意¶
适合：多机 DSH 协作、让本地 Bot 把任务委派给远端 Bot、在不动本地 Remote 窗口的前提下做后台传话。
注意：
- 必须先满足 ds-harness-remote 与 ds-bot 的前置条件。
- 双向互发需两端都装插件并各自配置对端目标。
- DSH 生态采用「一切皆插件」思路；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系，本文事实以 GitHub 仓库 README 为准。
结尾¶
dsh-remote-bot-bridge 把 ds-harness-remote 已有能力收敛成 Bot 工具，专注跨机器传话且不接管本地窗口。若你在多机 Harness 环境里做 Agent 协作，可按上文步骤安装 remote 与本插件后，用自然语言或 remote_* 工具完成对端 Bot 的消息投递。
- 目录页：https://www.skillhub.cn/plugins/onesmash/dsh-remote-bot-bridge
- GitHub：https://github.com/onesmash/dsh-remote-bot-bridge
