# @hy-sde-org/dsh-tool-browser 中文文档

规范地址：https://npmcn.com/package/%40hy-sde-org/dsh-tool-browser/

版本：0\.2\.1-rc\.5
npm 元数据更新时间：2026-11-01T04:21:35.296Z
中文译文更新时间：2026-11-01T09:59:11.958Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40hy-sde-org/dsh-tool-browser
原文对照：https://npmcn.com/package/%40hy-sde-org/dsh-tool-browser/?lang=original
项目主页：https://github.com/hy-sde/dsh-browser#readme
源码仓库：https://github.com/hy-sde/dsh-browser

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：42.7 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：1 个
- 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
- 首次发布：2026-08-26T03:22:48.500Z
- 最新版本发布：2026-11-01T04:21:35.128Z
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

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

## 安装

```sh
npm install @hy-sde-org/dsh-tool-browser
```

也可以使用：`pnpm add @hy-sde-org/dsh-tool-browser`、`yarn add @hy-sde-org/dsh-tool-browser`、`bun add @hy-sde-org/dsh-tool-browser`

## README

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

DeepSeek Harness的面向模型的代理浏览器工具（从omp / oh-my-pi移植），解析主机 [`@hy-sde-org/dsh-browser`](https://npmcn.com/package/%40hy-sde-org/browser/README.md) 通过 **启动/补丁/附加/中继** 后端。代理平面：此包作为预设行挂载，并且不注册自己的服务。一个独立的插件-不需要更改上游线束。

## 它是做什么的

注册一个工具(`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 是什么？

面向模型的浏览器工具（打开/关闭/运行启动，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 和提交记录判断。