前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构，智能体在执行任务时若需访问互联网或进行复杂页面交互，通常需要依赖浏览器驱动。直接使用浏览器驱动往往面临会话管理混乱、选择器脆弱以及数据泄露等风险。
dsh-browser 插件旨在为 DSH 提供一套无头优先、隔离安全的浏览器自动化方案。它不依赖传统的 CSS 选择器，而是通过语义化引用来操作页面，确保 Agent 的操作具有确定性和可追溯性。
这是什么¶
dsh-browser 是 DeepSeek Harness 的联网工具插件，由开发者 ZSeven-W 维护。
它的核心价值在于为智能体提供隔离的 Chromium 会话环境，并封装了一套语义化的操作接口。插件使用 Playwright Core 1.62.1 作为底层驱动，通过临时的用户数据目录实现 Agent 间的完全隔离，并提供了有界证据和确定性安全检查机制。
核心功能¶
该插件提供以下核心能力：
- 无头优先的浏览器自动化：默认以无头模式运行，不依赖个人浏览器配置。
- 隔离的会话环境：每个 Agent 拥有独立的 Chromium 上下文，互不干扰。
- 语义化引用：操作页面元素不依赖 CSS 选择器，而是使用生成的语义引用。
- 作用域观察：支持对页面局部或特定子树进行观察。
- 有界证据：限制控制台和网络日志的输出范围，避免敏感信息泄露。
- 确定性安全检查：在执行动作前进行验证，防止无效或危险操作。
安装与启用¶
确保环境满足要求：
* Node.js 版本 >= 24.11.0
* pnpm（插件内部使用 pnpm@10.34.5）
通过 npm 安装插件包：
npm install @zseven-w/dsh-browser
注意：当前版本为预发布版本 0.1.0-rc.1，根据 DSH v9 契约，该版本可能存在变更。
典型用法¶
使用该插件的标准流程如下：
- 启动会话：调用
browser_session_start启动一个隔离的浏览器上下文。 - 观察页面：调用
browser_observe获取页面的语义化视图。 - 执行操作：使用
browser_act配合上一步获取的引用进行点击、填写、导航等操作。 - 二次观察：执行操作后再次调用
browser_observe检查结果。 - 结束会话：调用
browser_session_stop关闭上下文并删除临时数据。
适用场景与注意¶
该插件适用于需要在智能体中集成浏览器自动化能力的场景，如网页测试、数据抓取或表单填写。
注意事项：
* 插件以 DSH 进程的权限运行，安装前请检查源码与许可证。
* 由于是预发布版本，API 行为可能随 v9 契约更新而变化。
* 使用了 Playwright Core 1.62.1 作为底层依赖。
结语¶
dsh-browser 为 DeepSeek Harness 提供了标准化的浏览器操作能力，通过隔离会话和语义化引用降低了智能体开发浏览任务的复杂度。更多详情可访问插件目录或 GitHub 仓库。
