dsh-browser-harness

浏览器控制插件：把 browser-use / browser-harness 的 Browser Harness 注册为 DSH 会话工具，让 agent 直接写 Python 驱动真实 Chrome（导航/点击/输入/取无障碍树/截图），支持独立专用浏览器与附着系统浏览器两种模式。适合需要让Agent直接控制真实浏览器进行导航、点击和截图等任务的用户。

パッケージ

dsh-browser-harness

互換性

未検証

Harness ピア範囲

>=0.1.0-rc.6 <0.2.0

バージョン

0.2.0

ライセンス

MIT

最終更新

2026/09/19

配置

在 profile 的 cordis.patch.yml 里用 id 定向覆盖（不要 - insert:，本 bundle 已自动 insert 自身 id）：

- id: browser-harness
  config:
    mode: dedicated            # dedicated（默认）| system
    command: browser-use       # 或 browser-harness，或绝对路径
    timeoutMs: 120000
    cdpPort: 9334
    chromeArgs: ['--proxy-server=http://127.0.0.1:7890']   # 需要代理时

键	默认	说明
`mode`	`dedicated`	`dedicated` 自起专用 Chrome（与日常浏览器完全隔离，不弹授权框）；`system` 附着你正在用的 Chrome
`command`	自动解析	Harness 可执行文件。建议显式配置，见下方「已知陷阱」
`buName`	`dsh-browser`	具名 daemon，会开自己的后台 tab，不抢你当前看的 tab
`cdpUrl`	空	自带 CDP 地址时填，填了就不再自起 Chrome
`cdpPort`	`9334`	dedicated 模式的调试端口
`chromePath`	自动探测	Chrome 可执行文件
`userDataDir`	`~/.dsh-browser-profile`	dedicated 模式的独立配置目录
`chromeArgs`	`[]`	追加给 Chrome 的参数（代理、窗口大小等）
`timeoutMs`	`120000`	单次执行预算，上限 600000
`restoreTab`	`true`	是否设置 `BU_NAME` 让 daemon 用独立后台 tab

同一份配置也可用环境变量给：DSH_BROWSER_USE_MODE / DSH_BROWSER_USE_BIN / DSH_BROWSER_USE_PORT / DSH_BROWSER_USE_PROFILE。

dsh-browser-harness

インストール

ドキュメント

配置