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 头 |
