前言¶
DeepSeek Harness (DSH) 采用插件化架构。在开发或调试智能体时，通常需要浏览器环境。dsh-browser 插件为每个对话会话创建一个独立的浏览器实例，并将视图镜像到右侧侧边栏，便于观察和接管。
插件介绍¶
名称：dsh-browser
维护者：CJYLZS
分类：联网工具
许可证：MIT
核心价值：为每个 DSH 会话提供一个真实的本地浏览器，镜像至侧边栏，由代理使用 9 个工具驱动，并通过 CDP 端口可附加。插件在 Web 和 Desktop 接口均可运行。
核心功能¶
- 独立浏览器实例：每个会话对应一个独立的浏览器进程，拥有独立的配置文件和 CDP 端口。
- 侧边栏镜像：浏览器内容实时显示在右侧侧边栏，支持切换查看。
- 工具驱动：代理通过 9 个工具调用控制浏览器，包括页面快照、元素查找、坐标获取和代码执行。
- 真实浏览器环境：不是嵌入式 WebView，而是真实的 Chrome 或 Edge 进程，支持 DevTools 附加。
- 输入真实化：使用真实的鼠标和文本事件，而非合成事件，确保页面交互准确性。
- CDP 附加：每个浏览器监听独立的 CDP 端口，支持
chrome://inspect、Playwright 或内置脚本附加。
安装与启用¶
安装前请确认宿主 DSH 版本（建议 ≥ 0.1.7-rc.1 以匹配最新插件版本）。
在 Web 接口执行：
dsh plugin add --profile web github:CJYLZS/dsh-browser#v0.2.3
安装后需要重启 DSH。该插件依赖 playwright-core，并要求系统中已安装 Chrome 或 Edge。
典型用法¶
使用流程通常不需要额外配置，按以下步骤操作：
- 启动：通常不需要主动启动。当代理的第一次工具调用需要浏览器时，插件会自动创建实例，右侧侧边栏会出现名为 “Browser” 的选项卡。
- 操作：向代理下达指令，例如“打开文档并告诉我安装部分的内容”。代理会调用工具在同一个浏览器实例上执行操作，侧边栏同步显示页面变化。
- 接管：代理运行时，可以通过 CDP 端口附加外部工具。例如，使用
curl http://127.0.0.1:9333/json/version查看连接状态，或使用 Playwright 的chromium.connectOverCDP进行调试。
设计与工具¶
插件通过 9 个工具集控制浏览器。关键工具包括：
browser_snapshot：读取页面可访问性树，为代理提供页面结构信息，无需预先了解 CSS 选择器。find：在页面中缩小查找范围。boxes：获取元素位置信息，无需截图。browser_evaluate：通用代码执行工具。browser_input：发送真实的鼠标和文本事件，处理原生下拉框、复选框和快捷键（如 Ctrl+A）。
注意事项¶
- 版本兼容：插件 v0.2.x 需要 DSH ≥ 0.1.7-rc.1。
- 依赖环境：必须安装 Chrome 或 Edge 浏览器。
- 会话隔离：每个会话拥有独立的浏览器配置文件，互不干扰。
- 非 WebView：页面在独立进程中运行，关闭 DSH 不会残留浏览器进程。
总结¶
dsh-browser 提供了一种隔离且透明的浏览器使用方式，适合需要深入调试智能体网页操作行为的场景。
