前言¶

在 DeepSeek Harness（DSH）里做浏览器相关任务时，如果 AI 只能在后台操控浏览器，操作过程不容易直接核对。dsh-browser-control 提供一条更直观的路径：让 AI 操控一个真实、可见的 Chrome 浏览器，并在对话 GUI 里实时看到每一步操作。

下面介绍这个插件的定位、核心能力、安装方式和典型用法。

这是什么¶

dsh-browser-control 是 kyo615 维护的 DeepSeek Harness 插件，许可证为 MIT，版权归 kyo615 所有。

它的一句话定位是：让 DeepSeek Harness 里的 AI 操控一个真实、可见的 Chrome 浏览器，并在对话 GUI 里实时看到每一步操作。

插件基于 microsoft/playwright-mcp，通过 MCP stdio 连接。它只调用 DSH / Cordis 的公开插件 API，不包含、不修改它们的源码。

核心能力¶

真实有头 Chrome¶

插件使用真实有头 Chrome，不是无头浏览器。AI 执行鼠标移动、输入、点击等操作时，桌面上可以直接看到浏览器里的实际动作。

面向 AI 的 browser_* 工具¶

插件会把约 80 个 browser_* 工具注册给 AI，例如：

• browser_navigate
• browser_click
• browser_type
• browser_snapshot
• browser_press_key
• browser_mouse_click_xy
• browser_tabs
• browser_evaluate

这些工具用于完成网页导航、点击、输入、按键、标签页管理和脚本执行等任务。

GUI 内嵌实时画面¶

每次 AI 动作后，插件会截图到 live.png，并通过宿主 HTTP 路由 /dsh-browser/shot.png 刷新到对话面板。

面板截图上的数字方框，对应 AI 可点击的元素编号。这样可以在对话 GUI 里同时看到浏览器画面和 AI 正在操作的元素位置。

面板可操作¶

对话面板支持以下操作：

• 网址栏跳转
• 刷新画面
• 重启浏览器
• 关闭浏览器

零硬编码路径¶

插件声明为零硬编码路径，所有路径自动探测或可配置。使用时不需要手工拼本机绝对路径。

安装与启用¶

先确认运行环境：

• DeepSeek Harness，或兼容其动态 Cordis 插件机制的环境
• Node.js ≥ 18
• 系统已安装 Google Chrome（或 Edge）

先执行安装命令：

dsh plugin add https://github.com/kyo615/dsh-browser-control

安装后，还需要在对应工作区执行依赖安装：

npm install @playwright/mcp

如果使用动态插件方式，即通过 cordis_define / cordis_run 定义和运行，则它是进程级的：DSH 重启后需要重新定义与运行。Client 部分需要授权。

典型用法¶

经过上面的步骤后，可以使用以下方式触发浏览器操作。

1、直接对 AI 说：

• 打开某网站
• 搜索某某
• 帮我操作网页

2、在面板的网址输入框输入网址，执行跳转。

3、如果浏览器未运行，AI 可以调用 browser_status，并带 start: true，自行拉起浏览器。

4、通过面板执行画面刷新、重启浏览器或关闭浏览器。

适用场景与注意¶

适合在 DSH 对话中执行网页导航、搜索、点击、输入等操作，并希望看到真实浏览器画面的场景。

使用前需要注意：

• 插件允许 AI 操控浏览器执行真实操作，需要自行负责网站条款、登录态、自动化访问限制等合规性。
• 使用前应检查源码和许可证，并确认当前 DSH 进程的权限范围、可用资源和目标网站访问限制。
• 第三方依赖包括 microsoft/playwright-mcp、Playwright 等，涉及 Apache-2.0 许可证，详见仓库中的 THIRD_PARTY_NOTICES。
• 动态插件方式在 DSH 重启后需要重新定义与运行。

相关链接¶

GitHub 仓库：

https://github.com/kyo615/dsh-browser-control