前言¶
DeepSeek Harness (DSH) Web 客户端在调试智能体对网页的操作时，通常需要手动复制选择器或截图。dsh-plugin-browser 插件在 DSH 右侧栏增加了一个基于 Playwright 的浏览器面板，提供实时画面、元素选择以及模型可调用的工具，减少手动操作。
插件简介¶
- 名称：
dsh-plugin-browser - 维护者：TEGONG00
- 分类：客户端
- 许可证：MIT
核心功能¶
1. 右侧栏浏览器面板¶
在 DSH 侧栏底部点击“浏览器”按钮打开面板，显示 Chromium 的实时画面。支持导航、点击、输入，鼠标移动、点击、双击、滚轮和键盘操作会转发给被控页面。画面流基于 CDP screencast 推送，仅在面板可见时推送。
2. 元素选择器¶
开启“选择元素”开关后，点击页面元素，会生成一个 Lexical chip。该 chip 包含元素的截图、选择器、标签、文本和 outerHTML。这些引用会以“元素1、元素2……”的格式插入输入框末尾，模型可据此精确定位要改的元素。
3. 模型工具¶
插件注册了一组浏览器操作工具，模型可自主调用：
- browser_navigate：导航到指定 URL
- browser_screenshot：截取当前页面，结果以图片附件形式在聊天中渲染
- browser_snapshot：获取交互元素大纲（如 [12] <button> "Submit"）
- browser_click：按索引点击元素
- browser_type：在元素中输入文本
安装与启用¶
安装前需确保环境满足要求：dsh >= 0.1.5-rc.x，Node.js >= 20。
安装插件：
npx @deepseek-ai/dsh plugin --profile web add github:TEGONG00/dsh-plugin-browser
安装 Playwright Chromium：
npx playwright install chromium
典型用法¶
- 打开面板：点击侧栏底部的“浏览器”按钮打开面板。
- 导航页面：在 URL 栏输入地址并导航。
- 交互元素：开启“选择元素”，点击页面元素，元素引用作为 chip 插入输入框。
- 模型操作：模型可使用
browser_navigate或browser_screenshot等工具自主操作页面。
适用场景与注意事项¶
该插件适合需要在 DSH 环境中直接调试网页交互、让模型自主验收代码修改的场景。
需注意以下限制：
- 选择器范围：选择器仅覆盖主 frame，不穿透 shadow DOM 或 iframe。
- 插入位置：元素引用 chip 插入在输入框末尾。
- 推送策略：画面流仅在面板可见时推送。
- 安全性：自有路由未接入会话认证，依赖 Origin 同源校验。
- 事件依赖：“选择元素”依赖真实鼠标事件。
总结¶
该插件为 DSH Web 客户端补齐了浏览器可视化的能力，通过 Playwright 驱动和 Lexical 芯片机制，让模型能够更自然地与网页交互。
