前言¶
如果你需要让 DSH 智能体完成网页浏览、点击、填表、截图，常见做法会在 CDP 端点或 MCP 服务上再加一层链路。duyefeng/dsh-browser 的说明里明确：不用配 CDP，也不用跑 MCP。
它底层使用 Playwright，直接驱动本机已安装的 Microsoft Edge，并把浏览器动作封装成一组 browser_* 工具供智能体调用。
这是什么¶
dsh-browser 是一个给 DeepSeek Harness（DSH）用的浏览器插件。装上之后，AI 可以直接打开网页、点击按钮、填写表单、截图。
仓库位于 duyefeng 名下：https://github.com/duyefeng/dsh-browser。许可证为 MIT。
核心能力¶
- 底层是 Playwright，直接驱动电脑上已经安装好的 Microsoft Edge。
- 页面行为与真人浏览一致，cookie、JS、登录态都会保留。
- 不需要单独配置 CDP，也不需要运行 MCP 服务。
- 向智能体提供以下浏览器工具：
| 工具 | 说明 |
|---|---|
browser_navigate(url) |
打开网址 |
browser_snapshot() |
读取当前页面，例如标题、正文、可点元素 |
browser_click(selector) |
点击某个元素 |
browser_type(selector, text) |
往输入框里填字 |
browser_press(key) |
按键盘，例如 Enter、Tab、Esc |
browser_evaluate(expression) |
在页面里执行一段 JavaScript |
browser_screenshot() |
截图，并返回图片路径 |
browser_close() |
关闭本次会话的浏览器 |
package.json 声明依赖 playwright-core ^1.49.0，并声明 peerDependencies：@deepseek-ai/cordis、@deepseek-ai/dsh-tools。
环境要求¶
使用这个插件前，先确认环境满足：
- Node.js 22+。
- 安装了 Microsoft Edge。
- 有
dsh命令行；如果在源码 checkout 里运行，可用pnpm dsh。
安装与启用¶
先安装插件：
dsh plugin --profile web add github:duyefeng/dsh-browser
然后启动：
dsh web
插件是在 profile 启动时读取的。安装后需要重启一下 profile，否则不会生效。
典型用法¶
装好之后，可以直接用自然语言让 AI 做浏览器任务，例如：
- “打开
example.com，读一下正文，告诉我标题。” - “打开百度搜“天气”，把第一条结果的标题给我。”
- “打开这个登录页，填好账号密码，截个图给我看。”
AI 会根据任务调用对应的 browser_* 工具。
覆盖默认配置¶
如果默认行为不符合要求，可以在 profile 的 cordis.patch.yml 中覆盖 browser 配置：
- id: browser
config:
channel: msedge # 使用已安装的 Microsoft Edge
headless: false # false：有界面；true：无头运行
timeoutMs: 30000 # 单次操作超时，单位毫秒
适用场景与注意¶
适合需要在 DSH 里完成网页浏览、点击、填表、截图，并且本机已有 Microsoft Edge 的场景。
因为它会直接操作浏览器并读取页面内容，属于敏感能力。安装前建议检查源码和 MIT 许可证；运行时也会以当前 dsh 进程权限执行浏览器操作，请确认所连页面和输入内容可信。
链接¶
- GitHub：
https://github.com/duyefeng/dsh-browser - 目录页：按所在 DSH 插件目录搜索
dsh-browser；社区目录独立于 DeepSeek / 幻方，不是官方应用商店。
