dsh-inapp-browser

dsh-inapp-browser

为 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/。