dsh-omni-bridge
DeepSeek Harness (DSH) 的多通道消息桥接：将 WeChat（ClawBot/iLink）、QQ 和 Feishu（Lark）聊天消息路由至 DSH agent，并将其回复转发回来。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:baisama-cloud/dsh-omni-bridge#de46a1b44558f733a7ddb329d686c6735252fd28Omni Bridge 以 dsh-omni-bridge 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Multi-channel message bridge for DeepSeek Harness (DSH): route WeChat (ClawBot/iLink), QQ, and Feishu (Lark) chat messages to a DSH agent, and relay the agent's replies back to the sender.
多通道桥接插件：把微信 ClawBot / QQ / 飞书的消息接入 DSH agent，并把回复回传给发消息的人。 远程操控Agent。
| 通道 | 收消息 | 发消息 | 凭据 |
|---|---|---|---|
| 微信 ClawBot | iLink 拉模式 (/ilink/bot/getupdates) | /ilink/bot/sendmessage（带 client_id + base_info + 回传 context_token） | botToken（扫码登录） |
| 官方网关 WebSocket（长连接） | `POST /v2/users | groups/{openid}/messages（被动消息带 msg_id`） | |
| 飞书 | 官方 SDK 长连接（@larksuiteoapi/node-sdk，订阅 im.message.receive_v1） | tenant_access_token + im/v1/messages | appId + appSecret |
requireMention），私聊始终回复。omni-bridge-<channel>），回复去重用 sessionPersistence.readFrom 水位（持久化 seq），解决「只有第一条回复」的问题。当前以 DSH 持久化 bundle 形式提供（host + client 打包进 profile，跨 DSH 重启生效）：
lib/index.js —— host 半区：三个通道的收发 + 会话桥接 + 定时轮询，通过 webServer 路由对外提供 RPC（/omni-bridge/*）。lib/client.js —— client 半区：设置页（微信/QQ/飞书三张卡片），通过 fetch 调用 host 路由。lib/feishu-ws.cjs —— 飞书长连接子进程（由 host 用 node 拉起）。方式一：从 npm 安装（推荐）
# 在 profile（如 ~/.dsh/profiles/web）目录执行
pnpm add dsh-omni-bridge
然后在 profile 的 package.json 的 dsh.profile.bundles 追加 "dsh-omni-bridge"，重启 DSH 生效。
方式二：本地 tgz 安装
npm pack 打包成 tgz（或直接用仓库目录）。~/.dsh/profiles/web）的 package.json：
dsh.profile.bundles 追加 "dsh-omni-bridge"；dependencies 追加 "dsh-omni-bridge": "file:<tgz 路径>"。pnpm install（会自动安装 @larksuiteoapi/node-sdk 依赖）。方式三：从 DSH 商城 / GitHub 安装
# 在任意一次性或正式 profile 上直接加仓库路径（等价于商城 GitHub 源安装）
dsh plugin --profile <p> add https://github.com/baisama-cloud/dsh-omni-bridge
>=0.1.0-rc.8 <0.2.0（声明于 package.json 的 dsh.compatibility.dsh）。>=22.13.0。package.json 的 dsh.compatibility.dshReleases 对每个公开发行版给出
compatible 记录（rc.7/rc.8 为商店仍接受的历史别名，其余为完整 SemVer 键）。每个声明版本都配有一次性 Profile 安装/启动/卸载证据（install、start、uninstall），
方法与逐版本结果见 COMPATIBILITY.md。该类证据为一次性 Profile
级（partial）：证明 bundle 能随对应 DSH 发行版安装、组合并完成宿主 apply() 启动；
真实第三方消息收发需外部凭据与网络服务，不包含在该证据内。
飞书长连接依赖官方 SDK，由 bundle 的 dependencies 自动安装：
pnpm add @larksuiteoapi/node-sdk # 或随 bundle 一起 pnpm install
lib/feishu-ws.cjs 通过 require('@larksuiteoapi/node-sdk') 加载 SDK，Node 从该脚本所在目录向上解析到 profile 的 node_modules。
配置文件位于 ~/.dsh/omni-bridge-config.json（写入时权限为 0600，目录 0700）：
{
"runtime": { "provider": "deepseek-official", "model": "deepseek-v4-flash" },
"channels": {
"weixin": { "enabled": true, "botToken": "...", "defaultTarget": "", "allowedUsers": [], "allowAll": false },
"qq": { "enabled": true, "appId": "...", "secret": "...", "allowedUsers": [], "allowAll": false },
"feishu": { "enabled": true, "appId": "cli_...", "appSecret": "...", "requireMention": true, "allowedUsers": [], "allowAll": false }
}
}
每个频道默认拒绝所有入站消息（allowAll: false 且 allowedUsers 为空时无人可用）。运营者二选一显式放行：
allowedUsers: 允许的发送者 ID 数组。微信用 from_user_id（如 xxx@im.wechat），QQ 单聊/群聊用成员 openid，飞书用 sender_open_id。未授权消息会收到一条「未授权」提示，并在 host 日志打印 [bridge] unauthorized <channel> sender=<id>（可用它找到自己的 ID）。allowAll: true: 允许所有人（显式选择开放，不建议生产使用）。设置页每个通道卡片也提供「允许的用户 ID（逗号分隔）」与「允许所有人」开关。
botToken。defaultTarget 留空则回复私信者。appId / secret。im:message（含 im:message.group_at_msg、im:message.p2p_msg、im:message:send_as_bot）。im.message.receive_v1。安装并重启后，设置页出现「远程桥接」卡片（微信/QQ/飞书三张配置卡）。
weixin-qr / weixin-poll 使用 iLink 扫码登录流程，botToken 会写入 ~/.dsh/omni-bridge-config.json。MIT