@hy-sde-org/dsh-tool-browser

中文文档
0.2.1-rc.5发布于 2026/11/01MITTypeScriptES Module

面向模型的浏览器工具(打开/关闭/运行启动,cdp附加和中继后端,aria快照+截图观察),用于DeepSeek Harness -一个独立的插件,不需要更改上游的Harness。

中文使用文档
文档目录4 节
  1. 它是做什么的
  2. 咏叹调参
  3. 配置
  4. 会话隔离

@hy-sde-org dsh-tool-browser

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 共发布 10 个版本,首次发布于 2026/08/26;过去 12 个月发布了 10 个版本。

版本发布日期距今
0.2.1-rc.5latest2026/11/012 天前
0.2.1-rc.32026/10/259 天前
0.2.1-alpha.42026/10/1618 天前
0.2.1-alpha.22026/10/1321 天前
0.2.0-rc.22026/10/031 个月前
0.1.7-rc.22026/09/291 个月前

关于 @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 和提交记录判断。