sdegongzuo/dsh-webops-plugin

dsh-webops-plugin

DeepSeek Harness 客户端网页操作与调试插件:多会话、新窗口、多标签页调试和操作网页

Uncategorizedbrowser-automationcdpdeepseek-harness

dsh-webops-plugin

为 DeepSeek Harness 提供网页操作与调试:独立浏览器窗口、多标签、可访问性快照、ref 操作、控制台与网络采集,以及人工接管。

插件在自己的仓库维护,通过 cordis.patch.yml 接入 profile。桌面端默认使用 Electron provider;外部 Chrome 使用 CDP provider,出厂配置默认关闭,启用方式见安装说明。

桌面端浏览器面板

安装与更新

从 GitHub Releases 按使用方式选择产物:

使用方式产物操作
首次使用桌面端dsh-webops-desktop-v<插件发布版本>-win-x64-portable.zip解压后运行启动.cmd
更新已有插件dsh-webops-plugin-v<版本>.zip完全退出后覆盖到实际插件目录,再重启
已有自己的 dshdsh-webops-plugin-v<版本>.zip按 插件安装说明 装入 profile

每次发布同时提供完整便携包与独立插件包;已有用户可以只替换插件。完整包内置 WebOps、Context 与 Better Sidebar 三个插件,release-manifest.json 分别记录插件和 DSH 本体版本。下载后核对 SHA256;插件版本取插件目录中的 package.json。

工具与权限

工具用途
webpage_open / webpage_navigate新开受控标签、导航或历史前进后退
webpage_snapshot / webpage_find读取页面大纲和检索缓存;区域参数为 region_ref、region_viewport、region_box,三者互斥
webpage_locate取得实时坐标
webpage_click点击元素;可选 observe=true 附全页快照,wait_text 等待页面可见正文中的已知结果文本并附快照
webpage_press按键操作;可选 observe=true 附全页快照,wait_text 等待页面可见正文中的已知结果文本并附快照
webpage_fill / webpage_scroll填写或滚动页面,执行前检查 ref 与页面状态
webpage_wait等文本、元素消失、页面稳定或指定时间;生成回复优先等待当前回复的完成标记
webpage_screenshot / console / network截图与调试采集
webpage_tabs查看持有/空闲标签、激活、关闭、领取、释放与移交
webpage_execute用 session_id、code 和可选 timeout_ms 执行一次 async 函数体;用 return 返回普通数据,用 await 等待结果

0.2.18 提供 click/press 的操作后观察和内置 Electron 窗口输入队列:同一窗口的前台输入按序执行,页面加载与后台读取可以并行。人工持有前台时,其他标签的自动切换与输入暂缓;外部 Chrome 不提供同等窗口级保护。实际验证范围与附件身份见 验收记录。

每个受控标签同时最多由一个对话占用;弹窗继承家族归属。释放保留页面,移交使用一次性码。人工接管期间 agent 不能操作,交还后重新取得有效 ref。重启不会恢复旧对话权限。页面内容按不可信数据处理。

开发与验证

先读 AGENTS.md,本机路径配置使用 .env.local 与 scripts/local-env.mjs。日常命令、Chrome live 测试和开发态联调见 开发指南。构建、暂存与测试证据放 D 盘;脚本是否删除或覆盖文件必须执行前核对。

发布步骤与门禁见 打包与发版。Release 附件存在和 Actions 成功分别核对,报告同时包含两者。

文档导航

任务文档
改实现或排查模块架构与实现、CDP 实测事实
维护对话标签归属页面归属与接管
窗口并发、人工前台与取消恢复并发网页操作
改点击、浮层、导航和 execute网页交互
优化工具描述、快照与上下文预算快照与上下文、测量口径
运行真实工具场景用户故事、打包态对话驱动
查看版本验证结果与限制验收记录
核对当前遗留问题与证据缺口遗留问题

License

MIT