dsh-browser-plugin

开始使用

1. 打开一个 DSH 对话。
2. 在右侧边栏中打开「浏览器」。首次使用会为该对话启动 Chrome。
3. 在画面中手动打开网页、登录或完成需要人工确认的步骤。
4. 让智能体调用 browser_* 工具继续操作；它会接管此对话对应的同一浏览器。

边栏状态显示“智能体正在使用本对话的浏览器”时，手动操作会等待当前工具调用完成。这样可避免导航和表单输入交错。

常用配置

所有配置均可选，完整定义见 src/config.ts。

配置	默认值	说明
chromePath	Windows 系统 Chrome 路径	Chrome 或 Chromium 可执行文件的绝对路径。
isolation	'session'	'session' 为每个对话独立浏览器；'shared' 让所有对话共用一个浏览器。
userDataDir	''	会话隔离模式下是各对话 profile 的父目录；留空时使用 ~/.dsh/browser-profiles。
maxBrowsers	4	最多保留的浏览器数；超出时优先关闭最久未使用的空闲浏览器。
idleTimeoutMs	600000	浏览器空闲多久后关闭，单位为毫秒；关闭不会删除 profile。设为 0 可关闭自动回收。
stealth	false	是否默认使用隐身模式。
headed	false	无头模式是否显示 Chrome 窗口；隐身模式始终显示窗口。
pane	true	是否启用右侧边栏的实时浏览器视图。
allowSubagents	false	是否允许子智能体和工作流子任务操作浏览器。
queueTimeoutMs	30000	人工边栏操作等待智能体释放浏览器的最长时间，单位为毫秒。
navTimeoutMs	45000	网页导航超时，单位为毫秒。
timeoutMs	60000	单次浏览器工具调用的超时，单位为毫秒。

示例：为 web profile 配置浏览器路径、降低并发上限，并默认启用隐身模式。

- insert:
    - id: dsh-browser-plugin
      name: 'dsh-browser-plugin'
      config:
        chromePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
        maxBrowsers: 2
        stealth: true