侧边栏智能体浏览器 Dax233/dsh-sidebar-browser-control

dsh-sidebar-browser-control

DSH 侧边栏智能体浏览器：给模型一个真实的 <webview>，支持快照、点击、输入、滚动、截图，页面内虚拟光标不会移动用户的真实鼠标。

安装

dsh plugin --profile desktop add github:Dax233/dsh-sidebar-browser-control

安装后重启 DSH Desktop；调用 browser open 会自动打开 Agent Browser 面板。

@local/dsh-sidebar-browser-control

Host + Client 插件，给智能体在 DSH 侧边栏里配一个真实浏览器。

- Host 部分（index.js）：注册 browser 工具和一条回环桥接（bridge.js，绑定到 127.0.0.1），把工具动作送到渲染进程。桥接要求 Authorization: Bearer <token>（绝不用查询参数），拒绝外来的 Host 头，只放行 DSH 渲染进程来源（dsh-app://app / null），这样随便一个网页都驱动不了它。
- Client 部分（client.js）：注册 Agent Browser 侧边栏标签类型，持有一个租用的 Electron <webview>（通过 window.dshDesktop.browser），用 executeJavaScript（快照/refs）和 sendInputEvent（可信的点击/输入/滚动）执行动作，并注入一个 shadow-DOM 虚拟光标，让用户能看着智能体操作，而系统指针不动。

工具接口

browser(action)：

| action | 参数 | 含义 |
| open | url | 显示侧边栏面板并导航 |
| navigate | url | 在已打开的面板里导航 |
| snapshot | – | 标题/url/视口 + 带 ref 的可交互元素 |
| click | ref 或 x,y | 移动虚拟光标，命中测试，派发真实鼠标输入 |
| type | text，可选 ref | 聚焦 ref（可选）并输入 |
| key | key | Enter/Tab/Escape/Arrow* |
| scroll | deltaY，可选 ref | 滚轮输入 |
| wait | ms 或 selector | 等待时间或元素 |
| status | – | 桥接/客户端状态 |

只允许 http: / https: 导航。插件绝不碰用户的系统指针。

测试

测试先行编写；在仓库根目录运行：

npm test

tests/browser-control-client.test.mjs 在 Node VM 里执行真实的 client.js，mock 掉 __ModuleLoader__ / dshDesktop / <webview>，检查启动契约（apply() 必须返回 undefined）、标签注册和每条控制器命令。tests/browser-control-host.test.mjs 检查工具 JSON Schema（对象为根；兼容 DS）、参数校验，以及走一遍假客户端的往返。

开发规则

1. Client 的 apply() 必须保持同步并返回 undefined；后台循环发出去就不管。
2. 打包后的桌面端只在页面启动时加载客户端 bundle：改完 client.js 后，重启应用（或换新包 id 重装）才能指望新代码生效。
3. npm test 红着的时候，绝不要启用 bundle。