侧栏浏览器操控 Yingmoon0715/rightbar-driver

rightbar-driver

驱动 DeepSeek Harness 右侧边栏里的内置浏览器。

它做什么

DSH 右侧边栏自带一个浏览器标签页（Ctrl+T，官方 ui-sidebar-browser）。
页面渲染没问题，但智能体侧没法操作它——点什么、输什么都得你手动来。

这个插件让那个浏览器变得可操作。六个工具：

- rightbar_open —— 打开侧边栏浏览器标签页，可带 URL
- rightbar_navigate —— 导航到某个 URL
- rightbar_read —— 读取当前页面：URL、标题、正文文本，以及一份可交互元素列表，每个元素带 dsh-ref-N 句柄
- rightbar_click —— 按 dsh-ref-N 句柄或 CSS 选择器点击元素
- rightbar_fill —— 按句柄或选择器往输入框里输入
- rightbar_close —— 关闭标签页

打开和导航走官方公开 API
ctx.sidebarRight.openTab('browser', { params: { url } })。读取和交互在浏览器 guest 内部执行，走的是官方桌面版用的同一条通道。不额外起进程，不额外开浏览器，没有内存开销，也完全不碰你已经登录的那个浏览器。

为什么做它

市面上其他浏览器插件都会再起一个浏览器：Playwright Chromium、Electron 窗口，或者连到你自己的 Chrome 的 CDP 连接。需要隔离、下载、cookie 持久化时，这是对的答案。可你要的浏览器已经在侧边栏里坐着，只想让智能体用上它，那这就是错的答案。

环境要求

- DSH 桌面版。侧边栏浏览器在那里渲染成 Electron <webview>，页面读取才成为可能。
- 屏幕上必须有会话。否则官方 sidebarRight.require() 会抛 "no session surface is mounted"——这是官方行为，不是插件限制。
- 在 dsh web 上（没有桌面外壳），侧边栏浏览器渲染成 。打开和导航照常可用；读取和交互不行，因为浏览器同源策略禁止读取跨源 frame。插件会直接说明这一点，而不是抛一个看不懂的错误。

安装

dsh plugin add https://github.com/<owner>/rightbar-driver

或者在 DSH 里的插件市场安装。

状态

首个版本。六个工具，已在 DSH 0.2.1-rc.2 桌面版上端到端验证：open 返回 frames: 1，read 返回真实页面内容，navigate 改变已加载的 URL，click 真的触发导航。截图和路线图（截图捕获、设置界面、技能包）在 screenshots.json 和 issue tracker 里。

本版本尚未包含：截图、下载、cookie 持久化、多会话隔离、CAPTCHA 处理。

许可证

MIT
- rightbar_read —— 读取当前页面：网址、标题、正文，以及可交互元素清单，每个元素带 dsh-ref-N 句柄
- rightbar_click —— 按 dsh-ref-N 句柄或 CSS 选择器点击元素
- rightbar_fill —— 按句柄或选择器往输入框填字
- rightbar_close —— 关闭标签页

打开页面与导航走官方公开 API ctx.sidebarRight.openTab('browser', { params: { url } })；读取与交互通过官方桌面版使用的同一条通道，在浏览器容器内执行。
不起额外进程，不起第二个浏览器，不占额外内存，也不碰你正在登录着的浏览器。

为什么会有它

市场上其他浏览器插件都是另起一个浏览器：Playwright 的 Chromium、Electron 窗口，或者用 CDP 连你自己的 Chrome。当你需要隔离、下载、登录态持久化时，那是对的。
但当你想用的浏览器本来就躺在右推栏里，你只是想让智能体能使得动它时，正确答案是这个。

使用前提

- 需要 DSH 桌面版。右推栏浏览器在桌面版是 Electron <webview> 渲染，这是能读到页面内容的原因。
- 需要有会话在屏幕上。否则官方 sidebarRight.require() 会抛 "no session surface is mounted"——这是官方行为，不是插件限制。
- 在 dsh web（无桌面外壳）下，右推栏浏览器是 渲染。
打开与导航仍然可用；读取与交互不可用，因为浏览器同源策略禁止读取跨域框架。
插件会明确说明这一点，而不是抛一个看不懂的错。

安装

dsh plugin add https://github.com/<owner>/rightbar-driver

或在 DSH 内的插件市场安装。

当前状态

首个版本。六个工具已在 DSH 0.2.1-rc.2 桌面版端到端验证： open 返回 frames: 1，read 返回真实页面内容，navigate 真实改变网址， click 真实触发跳转。

这个版本还没有的：截图、下载、登录态持久化、多会话隔离、人机验证处理。

许可

MIT