dsh-bsk-ws-bridge

DSH 插件：把本机 bsk daemon 的回环 WebSocket 暴露为 DSH web server 上的一个 WebSocket 端点（默认 /__bsk__），供配套的修改版 browser-skill 扩展接入——Agent 由此经 DSH 页面远程操控客户端浏览器。

bsk daemon 只监听本机回环（ws://127.0.0.1:52800），原本浏览器必须与它同机；经本插件暴露到 DSH web server 后，浏览器只要打得开 DSH 网页就能连上，Agent 跑在远端服务器也能使用这台浏览器。

本插件只提供数据链路，不为 Agent 提供浏览器操作能力；还需安装 dsh-plugin-browserskill 插件与配套修改版的 browser-skill 扩展（见「配套组件」）。

核心功能

• WebSocket 端点：在 DSH web server 上注册 /__bsk__（路径可配置），将入站连接转发到本机 bsk daemon（默认 ws://127.0.0.1:52800）。
• 透明转发：对 WebSocket 帧原样转发、不解析不改写，握手与会话语义全部交给真正的 daemon 处理；仅转发文本帧（bsk-protocol 为 JSON 行），关闭码双向透传。
• Origin 伪装：daemon 只接受 chrome-extension:// 来源的握手，本插件连接 daemon 时按配置伪造该前缀的 Origin；upstream 只走本机回环。
• 健康检查端点：GET /__bsk__/health 返回 JSON 探活信息。

配套组件

端到端的远程操控需要以下组件配合，本插件只承担其中的数据链路：

• bsk（CLI/daemon）：安装在 DSH 所在机器，其 daemon 是这条链路的另一端；
• dsh-plugin-browserskill：BrowserSkill 官方的 dsh 插件，把 bsk 能力以 browser_* 工具的形式提供给 Agent——没有它，Agent 发起不了任何浏览器操作；
• 修改版 browser-skill 扩展：与本插件配套的修改版 browser-skill 扩展，fork 自 Tencent/BrowserSkill，装在客户端浏览器里，打开任意 DSH 页面即自动接入本端点，真正执行页面操作。

安装

遵循标准 dsh 插件流程：

# 1. 加入 web profile（本地路径安装；发布到 npm 后可直接写包名）
dsh plugin --profile web add file:<本仓库路径>
# 2. 启动该 profile，端点随之注册
dsh --profile web
# 3. 验证
curl http://127.0.0.1:3080/__bsk__/health

配置

行内 config 定义于 cordis.patch.yml：

键	默认值	说明
enabled	true	false 时整个插件不注册
path	/__bsk__	DSH 上的 WebSocket 端点路径（exact match，无尾斜杠）
upstream	ws://127.0.0.1:52800	本机 bsk daemon 的 WebSocket 地址
origin	chrome-extension://aab…	连接 daemon 时伪造的 Origin 头