通过 Better Sidebar 为 DeepSeek Harness 提供共享浏览器面板,支持本地 Chromium、人和 AI 的鼠标键盘操作、页面快照、截图及按聊天持久保存的浏览器资料。
安装
# Release 预构建包
dsh plugin --profile web add "https://github.com/alllllinnrann/dsh-inapp-browser/releases/download/v0.2.6/dsh-inapp-browser-0.2.6.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:alllllinnrann/dsh-inapp-browser
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
为 DeepSeek Harness 提供内置浏览器面板,你和 AI 可以操作同一张网页,支持多标签、点击、中文输入、滚动、拖拽、页面文字读取与截图。默认使用必应,登录资料按聊天保存。
基于本机 Edge / Chrome / Chromium,通过画面传输在 Better Sidebar 中显示网页;不接管日常已经打开的浏览器。适用于本机运行的 Harness 0.1.5-rc.2、Node.js 22.19+、Better Sidebar 0.19.1–0.19.x。截图工具需要支持图片输入的模型。
接口参数
以下为提供给 AI 的工具。? 表示可选;无参数时传 {}。工具自动使用当前聊天会话,不需要传入聊天 ID。坐标均为网页视口的 CSS 像素,不是侧栏图片的缩放后坐标。
| 工具 | 参数 | 功能/返回 |
|---|---|---|
iab_open |
url: string;newTab?: boolean;engine?: "bing" | "baidu" | "google" |
打开网址或搜索词;返回页面快照。默认当前标签、必应搜索。 |
iab_snapshot |
无 | 返回网址、标题、页面文字、控件列表、视口尺寸和 revision。控件含位置、标签、是否在视口内等信息。 |
iab_screenshot |
无 | 返回实际图片附件及视口尺寸、图片尺寸、revision;需要图片模型及宿主附件服务。 |
iab_click |
x: number;y: number;button?: "left" | "right" | "middle";revision?: number |
点击坐标,默认左键;传入快照版本可拒绝导航后失效的点击。 |
iab_type |
text: string |
向已聚焦控件输入文字,支持中文。 |
iab_key |
key: string;modifiers?: number |
按键,例如 Enter、Tab、Escape 或快捷键字母。 |
iab_scroll |
deltaY: number;deltaX?: number;x?: number;y?: number |
滚动;正 deltaY 向下,默认在视口中心操作。 |
iab_drag |
x: number;y: number;toX: number;toY: number |
从起点拖拽到终点。 |
iab_wait |
ms: number |
等待 0–10000 毫秒;之后重新读取快照或截图。 |
iab_tabs |
无 | 返回标签列表、当前标签及浏览器状态。 |
iab_select |
targetId: string |
切换到 iab_tabs 返回的标签 ID。 |
iab_close_tab |
targetId?: string |
关闭指定标签,默认当前标签;保留至少一个标签。 |
iab_back |
无 | 后退。 |
iab_forward |
无 | 前进。 |
iab_reload |
无 | 刷新当前网页。 |
iab_dialog |
accept: boolean;text?: string |
确认或取消网页 JavaScript 弹窗,text 用于 prompt 输入。 |
iab_close |
无 | 关闭当前聊天的浏览器进程,保留登录资料。 |
modifiers 为位掩码:Alt = 1、Ctrl = 2、Meta = 4、Shift = 8,可相加组合。例如全选:iab_key({"key":"a","modifiers":2}),随后使用 iab_type 输入替换文字。
截图若被模型端缩放,点击前需要换算回原始视口坐标。页面滚动、导航或布局变化后应重新观察。
可选环境变量(启动 Harness 前设置):
| 变量 | 含义/默认值 |
|---|---|
DSH_IAB_BROWSER_PATH |
浏览器可执行文件绝对路径;默认自动查找 Edge、Chrome 或 Chromium。 |
DSH_IAB_DATA_DIR |
浏览器资料根目录;默认 ${DSH_HOME}/storages/dsh-inapp-browser/。 |
DSH_HOME |
Harness 数据根目录;未设置时使用用户目录下的 .dsh。 |
DSH_IAB_HOME_URL |
新会话首页;默认 https://www.bing.com/。 |
链接
同类插件
Tencent/BrowserSkill#dsh-plugin-browserskill★ 9929
BrowserSkill 的 DeepSeek Harness 浏览器自动化桥接插件,通过原生浏览器工具控制可见的 Chrome 和 Edge Agent Window,支持可访问性与 VOM 页面观察、截图、隔离的多会话控制和 Web UI 实时观察浮层。
omdsh-dev/dsh-browser#packages/browser/bridge-browser★ 966
Chrome 侧边栏扩展,让 DSH 直接操控你的浏览器,无需视觉能力。
liustack/modsearch★ 911
纯文本 agent 的联网搜索桥:搜索网页与 X,返回结构化 JSON 证据(search/fetch/引用)。
DDDMUC/dsh-free-search★ 817
DSH 免费搜索插件:7 个引擎(DuckDuckGo/Bing/SearXNG 免费 + Exa/Perplexity/DeepSeek 付费)、自动回退、设置页 UI(API key 输入 + 官网链接)、web_fetch、引擎测试工具。
Fisfzy/dsh-ego-browser★ 395
用 35 个结构化工具从 DeepSeek Harness 驱动真实 Chrome/Chromium:导航、语义快照、点击、表单、JavaScript/CDP、截图、下载与标签页管理;右侧边栏实时镜像页面,并支持鼠标键盘直接接管。插件自带受管 CDP 运行时,跨调用保留登录状态,并可通过配套 Chrome 扩展从日常浏览器导入 cookie。
wqty123/dsh-browser★ 162
共享真实浏览器:用户可观看并随时接管的原生 Electron 窗口,agent 通过 CDP 驱动,内置 20 个 browser_* 工具(打开/快照/执行/填表/截图/下载/登录态);任务级会话隔离、登录态持久化、人机验证识别,纯 `dsh web` 无需桌面外壳即可自托管。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。