在 DeepSeek Harness (DSH) 的开发与调试中,面对浏览器环境时的操作与状态追踪往往较为繁琐。本插件旨在提供一套完整的网页调试与操作能力,包括独立浏览器窗口、多标签页管理、可访问性快照以及控制台和网络数据采集。
插件定位¶
这是一个为 DeepSeek Harness 提供客户端网页操作与调试能力的插件。它通过独立的浏览器窗口或标签页,为智能体提供多会话管理、元素操作、快照读取及网络数据采集等能力。该插件在社区目录维护,通过 cordis.patch.yml 接入 profile。
核心功能¶
- 独立浏览器窗口与多标签页:支持新开受控标签、导航、历史前进后退及标签页的激活、关闭、领取与移交。
- 元素操作与等待:提供点击、填充、按键、滚动等操作,支持等待文本出现、元素消失、页面稳定或指定时间。
- 调试与采集:支持可访问性快照、截图、控制台日志采集及网络请求捕获。
- 高级能力:提供 ref 操作以恢复旧引用或获取实时坐标,支持人工接管模式,以及通过 CDP / Electron provider 执行高级命令。
安装与启用¶
插件通过 cordis.patch.yml 接入 profile。桌面端默认使用 Electron provider,外部 Chrome 使用 CDP provider(出厂配置默认关闭)。
安装步骤如下:
-
桌面端首次使用:
从 GitHub Releases 下载dsh-webops-desktop-v<版本>-win-x64-portable.zip。解压后运行启动.cmd。 -
已有桌面便携版:
下载dsh-webops-plugin-update-v<版本>.zip,覆盖到便携版根目录并保留home,重启即可。 -
已有自己的 dsh:
下载dsh-webops-plugin-v<版本>-win-x64-portable.zip,按 插件安装说明 装入 profile。
典型用法¶
- 新开与导航:使用
webpage_open或webpage_navigate新开受控标签并进行导航或历史前进后退。 - 读取页面信息:使用
webpage_snapshot读取页面大纲,或使用webpage_find检索缓存。 - 元素操作:使用
webpage_click、fill、press或scroll操作元素,或使用webpage_locate获取实时坐标以恢复旧 ref。 - 等待与采集:使用
webpage_wait等待页面稳定或特定条件,使用webpage_screenshot、console或network进行调试采集。 - CDP 执行:通过
webpage_execute执行允许列表内的一条 CDP 命令。
适用场景与注意¶
- 标签独占:每个受控标签同时最多由一个对话占用。弹窗会继承家族归属。
- 权限与接管:支持人工接管,接管期间 Agent 无法操作,交还后重新取得有效 ref。重启不会恢复旧对话的权限。
- 安全提示:页面内容按不可信数据处理,Runtime.evaluate 会执行页面代码,需谨慎使用。
- 适用范围:适合需要精细控制浏览器行为、进行网页自动化测试或调试的智能体开发场景。
该插件通过提供标准化的工具集和双 provider 架构,降低了 DeepSeek Harness 在浏览器环境中的操作门槛。更多细节与源码请查看其 GitHub 仓库。