OpenBot 会话桥 shiyoungwoo/dsh-openbot-artist-bridge

dsh-openbot-artist-bridge

把 OpenBot 聊天接入 DeepSeek Harness（DSH）里已有的 DS Bot。OpenBot 通过 Agent Client Protocol（ACP）驱动 Bot；这个桥接把对话转发进你在 DSH 里已经运行的 DS Bot 会话，于是 Bot 在两个应用之间保持同一身份、同一记忆、同一工作区。

中文说明

它是什么，不是什么

- 它是前端适配器。它不创建 Bot，不启动自己的 DSH 进程，也不接管任何会话。
- 它连的 Bot 必须已经在 DSH 里存在（DS Bot 插件）。桥接只负责转发提示词，再把回复流式传回。

架构

OpenBot Desktop
│ ACP over stdin/stdout (newline-delimited JSON-RPC)
▼
acp_bridge.py ──┐
│ AF_UNIX socket, newline-delimited JSON
▼
runtime.mjs (host half inside DSH)
│ shared fetch /api/bot + sessionController.prompt
▼
DS Bot session in DSH

- runtime.mjs 持有一个仅属主可访问的 AF_UNIX socket（父目录 0700，socket 0600）。它通过 DSH 的共享连接解析配置的 Bot，用 mode: 'queue' 发送提示词，并按 rpcId 把每个 session/event 对应回它的请求。
- acp_bridge.py 是独立的 ACP 前端，由 OpenBot 启动。它以客户端身份连接 socket，只声明自己支持的能力（文本和 resource_link 提示词），取消某个提示词时只关闭该提示词自己的 socket——从不做全局取消，所以无关的 Bot 工作照常运行。

环境要求

- DSH >=0.2.1-rc.3 <0.3.0，带 DS Bot 插件，且至少有一个 Bot 会话。
- Node >=22.19。
- Python 3.9+，用于 ACP 前端。
- macOS 或 Linux（AF_UNIX socket）。

安装配置

1. 安装宿主端到 DSH 配置档：

pnpm add link:/path/to/dsh-openbot-artist-bridge
or: pnpm add github:shiyoungwoo/dsh-openbot-artist-bridge

2. 配置它。 把 cordis.patch.yml 复制进配置档的 bundle 列表，或者在你自己的配置档补丁里覆盖这一行：

- id: local-openbot-artist-bridge
name: '@local/dsh-openbot-artist-bridge'
config:
botId: session-your-bot-session-id
socketPath: /absolute/path/to/dsh-openbot-artist-bridge/runtime/bridge.sock
timeZone: Asia/Shanghai

可选：lookupTimeoutMs（默认 15000）、promptTimeoutMs（默认 3600000）。

3. 在 OpenBot 里注册 ACP 前端，作为自定义智能体。它走 stdin/stdout，所以命令是：

{
"id": "dsh",
"name": "DeepSeek Harness",
"command": "/usr/bin/python3",
"args": ["/absolute/path/to/dsh-openbot-artist-bridge/acp_bridge.py"]
}

如果你改过 socketPath，给 acp_bridge.py 传 --socket <path>；否则它默认用脚本旁边的 runtime/bridge.sock。

4. 重启 DSH（或者在 Plugins 页面里开关一次 bundle），然后就能从 OpenBot 跟 Bot 对话了。

安全说明

- socket 仅属主可访问。同一轮次里，另一个 DSH 用户发来的提示词会被检测到并拒绝，返回一条可读的消息，而不是静默合并。
- 帧大小上限为 8 MiB。
- 配置值（botId、socketPath）标识某台机器上的 Bot；把真实值写进配置档覆盖项，不要放进共享仓库。

Tests

npm test # host half: real AF_UNIX socket, queueing, rpcId correlation, security cases
npm run test:acp # ACP frontend: real stdin/stdout against a fake socket server

Files

- index.js — 插件入口；声明配置，并在 effect 中启动桥接。
- runtime.mjs — host 半：socket 服务器、Bot 解析、提示词转发。
- acp_bridge.py — 面向 OpenBot 的独立 ACP 前端。
- cordis.patch.yml — 带占位配置的 bundle 补丁。
- locale/*.json、icon.svg — 插件元数据。
- tests/ — host（Node）与 ACP（Python）测试套件。

中文说明

这个插件把 OpenBot 的对话接到 DSH 里已经存在的某个 DS Bot 上，让两边共用同一个 Bot、同一份记忆和工作区。它只是前端适配层：不创建 Bot、不启动自己的 DSH 进程、不接管会话。

- runtime.mjs（DSH 内 host 半）：创建仅属主可访问的 AF_UNIX socket（父目录 0700、socket 0600），通过 DSH 共享连接找到配置的 Bot，用 mode: 'queue' 投递提示，并按 rpcId 把 session/event 对回请求。
- acp_bridge.py（OpenBot 启动的独立进程）：在 stdin/stdout 上讲 ACP，作为客户端连到上面的 socket；只声明支持文本与 resource_link；取消一条提示靠断开它自己的连接，不影响 Bot 的其他工作。

配置项：botId（必填）、socketPath（必填，绝对路径）、timeZone（默认 Asia/Shanghai）。请把真实值写在你自己的配置档补丁里，不要提交到仓库。

License

MIT