DeepSeek Harness的面向模型的代理浏览器工具(从omp / oh-my-pi移植),解析主机 @hy-sde-org/dsh-browser 通过 启动/补丁/附加/中继 后端。代理平面:此包作为预设行挂载,并且不注册自己的服务。一个独立的插件-不需要更改上游线束。
它是做什么的
注册一个工具(browser)和a browser:tools 系统提示符位置部分:
- 开放 -浏览已命名的选项卡(
url, wait_until、可选 code 加载后运行),返回观察结果(标题、url、ARIA快照)。
- 运行 ——评估
code 在选项卡中,然后重新观察尽力而为。
- 状态 -在不导航的情况下返回当前观测值。
- 关闭 -关闭一个选项卡,
all 选项卡,或 kill 生成的浏览器。
- 截图 - - - - - -
screenshot: yes 将PNG格式写入 screenshotDir、默认 <cwd>/.dsh-browser),并返回其路径供模型重新读取。
后端镜像omp的 app 对象: app.path 生成一个隐形补丁浏览器, app.patch 使用CloakBrowser源代码补丁的Chromium(可选) cloakbrowser peer - c++级指纹随机化), app.cdp_url 附加到现有的CDP端点, app.relay 通过本地中继+扩展驱动用户自己的选项卡。
咏叹调参
每一次观察都带有剧作家ARIA的快照 [ref=eN] id。id在每个快照中重新编号,并且在下一个快照之前一直有效;地址元素的CSS选择器作为回退。当像素无关紧要时,更喜欢快照而不是截图——快照很便宜,而截图则不然。
配置
cwd -默认工作目录(会话头优先,默认进程cwd)。
maxAriaChars —ARIA快照上限返回到模型(默认为20000)。
screenshotDir -截图输出目录(默认) <cwd>/.dsh-browser)。
waitUntil -默认等待条件(load)。
timeoutSeconds -默认的每次呼叫超时(30)。
会话隔离
这个 browser 服务为共享主机平面;该工具将TAB键命名为每个会话id,因此并发会话永远不会引导彼此的选项卡。
关于 @hy-sde-org/dsh-tool-browser 的常见问题
@hy-sde-org/dsh-tool-browser 是什么?
面向模型的浏览器工具(打开/关闭/运行启动,cdp附加和中继后端,aria快照+截图观察),用于DeepSeek Harness -一个独立的插件,不需要更改上游的Harness。
如何安装 @hy-sde-org/dsh-tool-browser?
在项目目录运行 npm install @hy-sde-org/dsh-tool-browser,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@deepseek-ai/cordis(~4.0.5)、@deepseek-ai/dsh-tools(^0.2.1-rc.5)、@hy-sde-org/dsh-browser(^0.2.1-rc.5)、@deepseek-ai/dsh-system-prompt(^0.2.1-rc.5)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。
@hy-sde-org/dsh-tool-browser 支持 TypeScript 吗?
支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。
@hy-sde-org/dsh-tool-browser 支持 ESM 还是 CommonJS?
以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。
@hy-sde-org/dsh-tool-browser 需要什么版本的 Node.js?
package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。
@hy-sde-org/dsh-tool-browser 可以商用吗?
@hy-sde-org/dsh-tool-browser 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。
@hy-sde-org/dsh-tool-browser 还在维护吗?
最新版本 0.2.1-rc.5 发布于 2026/11/01(2 天前);至今共发布 10 个版本,其中过去 12 个月发布了 10 个;首次发布于 2026/08/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。