前言¶
DeepSeek Harness (DSH) 采用插件化架构。在开发智能体时，若需要直接操作浏览器（如登录、抓取动态内容或执行自动化任务），通常需要配置 Selenium 或 Playwright 等重型驱动。lexmount/dsh-browser 插件通过注册原生工具，将 Lexmount 的云浏览器能力注入 DSH，让模型直接调用浏览器操作，无需手动管理驱动。
插件简介¶
这是一个为 DeepSeek Harness 提供的轻量级 Bundle，负责注册 31 个原生工具，并在底层调用 Rust 编写的 browser-cli 可执行文件。该包不包含浏览器二进制文件，也不依赖 Lexmount 的 Node.js SDK。
核心功能¶
- 31 个原生工具：覆盖诊断、认证、会话管理、下载管理、上下文管理。
- 浏览器操作：支持打开 URL、等待元素/文本、点击、填充表单、页面快照、截图、导出 PDF。
- 高级能力：支持执行任意 JavaScript 和 Chrome DevTools Protocol (CDP) 命令。
- 自动下载与缓存：首次调用时通过网络下载匹配当前平台的
browser-cli，并自动校验 SHA256 校验和；后续调用复用缓存，支持离线工作。
安装与启用¶
安装前需确保环境满足以下要求：
* Node.js >= 22.14.0
* DeepSeek Harness >= 0.1.0-rc.6 且 < 0.2.0
* 全局 pnpm（可通过 corepack 安装）
在 DSH 的 Web profile 中执行以下命令安装插件：
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add @lexmount/dsh-browser@0.1.1
典型用法¶
插件安装后，通过以下命令进行初始化和操作：
- 检查环境：运行
lexmount_doctor查看状态，首次调用会触发browser-cli的下载。 - 身份认证：运行
lexmount_auth_login，通过系统浏览器完成授权。 - 会话管理：创建临时 Session 或持久 Context 以复用登录状态。
- 页面操作：使用
lexmount_browser_snapshot导航并检查页面结构，随后使用 typed wait/click/fill 工具执行具体动作。 - 清理：临时 Session 使用完毕后关闭。
适用场景与注意¶
- 平台支持：当前支持 Windows x64、macOS Apple Silicon 和 Linux x64。macOS Intel 和 Linux ARM64 不在支持列表中。
- Headless 模式：Headless profile 必须预先完成认证，因为 PKCE 流程需要交互式浏览器。
- 安全性：模型输入作为子进程参数数组传递（
shell: false），不会拼接 shell 命令，防止注入攻击。API 密钥和敏感信息在返回数据中会被自动移除。 - 离线支持：
browser-cli二进制文件下载后存入缓存，后续重启可复用，无需再次下载。
结语¶
该插件通过标准化的原生工具接口，降低了在 DSH 环境下进行浏览器自动化的门槛。开发者可参考 技能目录 或 GitHub 仓库 获取更多细节。
