前言¶
DeepSeek Harness (DSH) 是一个插件化的智能体开发环境。在构建需要浏览网页的智能体时，处理登录态、会话持久化以及人工介入控制是常见痛点。DeepSeek Harness Browser Use 插件提供了持久化的 Playwright 浏览器工具和一个交互式面板，帮助开发者或智能体在 DSH 环境中稳定地操作浏览器。
插件定位¶
该插件由 syncended 维护，基于 Playwright。它为 DeepSeek Harness 提供持久化浏览器配置、跨标签页登录状态共享、稳定的页面快照引用以及实时可视化的浏览器面板。
核心功能¶
- 持久化与状态共享：保持一个 Chromium 配置文件，在多轮对话中共享登录状态。
- 交互式面板：提供实时浏览器视图，支持被动监控和手动接管。
- 稳定快照引用：通过
browser_snapshot获取页面元素引用，后续通过browser_click或browser_type操作。 - 代理工具集：提供
browser_status、browser_tabs、browser_navigate、browser_snapshot、browser_click、browser_type、browser_press、browser_scroll、browser_screenshot等工具。
安装与启用¶
该插件依赖 DeepSeek Harness 0.1.6-alpha.2、Node.js 22 或更新版本以及 pnpm。宿主机必须已安装 Chromium 或 Chrome 可执行文件。
dsh plugin --profile web add @syncended/dsh-browser-use@0.1.6-alpha.1
典型用法¶
- 打开或创建 DSH 会话，进入对话详情侧边栏，打开 Browser 标签页。
- 保持面板打开，可以被动观察智能体的浏览过程。
- 需要手动操作时，在面板底部选择 Take control，输入 URL 或与页面交互，完成后选择 Return control to agent。
- 让智能体执行操作时，通过
browser_snapshot获取当前页面的交互元素引用，随后使用browser_click或browser_type进行操作。注意快照引用是一次性的，操作后需重新获取。
配置项¶
插件通过 cordis.patch.yml 注入默认配置。可覆盖 profile（持久化配置名称）、headless（是否无头模式）、executablePath（浏览器路径）、viewportWidth/Height、screenshotQuality（截图质量）、operationTimeoutMs（超时时间）、humanLeaseTtlMs（手动接管租约时长）等。
适用场景与注意¶
- 环境依赖：必须在宿主机安装 Chromium 或 Chrome 可执行文件，且模型需支持图片输入以使用截图功能。
- 安全注意：浏览器配置文件包含凭证，请保护 DSH 的家目录；远程 Web 控制遵循
trustedHosts策略；请保持 Chromium 沙箱开启；敏感操作（密码、支付、验证码）需人工介入，插件不自动填充。 - 快照机制：
browser_snapshot返回的引用是单次有效的，任何页面变动后必须重新调用快照。 - 反爬限制：插件不提供反反爬虫机制。
结语¶
该插件通过提供稳定的浏览器操作接口和可视化的交互面板，降低了智能体在 DSH 环境中进行 Web 任务开发的门槛。更多细节与源码请访问 GitHub 仓库。
