前言¶
在 DeepSeek Harness(DSH)里用右侧栏内置浏览器对照网页改需求时,常见做法是截图、口述位置,或自己复制 DOM 信息贴进输入框。信息容易散,截图和文字也常对不齐。dsh-web-pick 面向 DSH Desktop 的内置浏览器:在页面里点选元素或框选区域,配上简短说明,再一次性写入对话输入框(文字 + 截图附件),由你检查后再按回车发送,不向被访问站点注入业务代码。
这是什么¶
dsh-web-pick 是社区插件(维护者 Chenghui-Liang,分类:联网工具),当前 GitHub 星标为 0。它解决的是「在 Harness 内置浏览器里把网页上的具体位置结构化地送进当前对话草稿」——装完即用,不修改你所浏览项目的源码。
插件只适用于桌面版:内置浏览器由 Electron <webview> 承载,插件 Client 半与 <webview> 同处一个文档,才能注入选取层;Web 版浏览器为 iframe,插件无法触及页面 DOM,因此不生效。
核心功能¶
下面能力均来自插件 README 与仓库说明。
- 元素点选:进入选取模式后,鼠标悬停高亮目标,并显示标签名、尺寸、颜色、字号等信息;单击元素可保存并可选填说明。
- 区域框选:按住拖动框选矩形区域,松手后同样可保存与备注;选区虚线框留在页面上便于对照。
- 批量管理:页面右下角「选取」胶囊旁数字为已存条数;可打开列表做定位、编辑说明、删除或清空。
- 写入输入框:点「放入输入框」将批次格式化为一段文字(
insertText,不覆盖已有输入),截图经输入框原生文件 intake 进入附件栏;不会自动发送。 - 按页隔离存储:使用
sessionStorage,key 为 origin + pathname;刷新同页仍保留,换页各存各的。
单批最多附带 6 张截图,超出部分仅保留文字。Esc 可退出选取模式或关闭卡片。
安装与启用¶
使用 DSH Desktop 配置下的官方安装命令:
dsh plugin --profile desktop add github:Chenghui-Liang/dsh-web-pick
安装后需完整退出并重启一次 DSH(Client 半在 host 启动时组装)。随后在右侧栏打开内置浏览器,访问任意页面即可使用。仓库 package.json 标明当前版本为 1.3.1,许可证为 MIT。
安装前建议自行阅读 GitHub 仓库 源码与许可证;插件以当前 DSH 进程权限运行,并向 <webview> 内页面注入脚本层。
典型用法¶
- 打开内置浏览器并加载目标页面。
- 点击页面右下角 「选取」 进入选取模式。
- 单击元素或拖动框选区域,在弹出卡片中补充说明(也可直接保存)。
- 重复直至条目足够;需要时用胶囊旁列表编辑或删除。
- 点 「放入输入框」,在对话输入框中核对文字与截图附件,确认后自行回车发送。
写入输入框的文字形态大致如下(示例结构来自 README):
【网页选取】2 条 · GitHub - Chenghui-Liang
页面:https://github.com/Chenghui-Liang
截图:2 张(已附在下面)
1. 元素 div `#id` · 字号大一点
源码:src/pages/Budget.tsx:42
2. 区域 320×180 · 这块留白太大
实现要点(便于判断是否适合自己)¶
Host 半提供 overlay 脚本路由与上报接口;Client 半扫描 <webview>、注入 web/overlay.js(Shadow DOM 隔离的 IIFE),约每 700ms 同步选取结果,并用 webview.capturePage() 为每条裁剪截图。写草稿走 slot 自带的 inputActions,不调用 session.prompt,因此消息不会直接发出。无需反向代理、CDP 或向站点加 <script>,任意 URL 均可作为浏览对象。
适用场景与已知限制¶
适合:在 DSH Desktop 里边看本地或远程预览页,边把 UI 问题、区域留白、元素样式等标进同一条对话,交给智能体或同事改代码/改稿。
限制(README 已列):
- 无法标注跨域 iframe 内元素。
- 关闭或切走内置浏览器面板后选取层暂停,返回会重新注入。
- SPA 路由切换后,旧条目「定位」可能失效。
- 输入框正在发送等导致无法插入时会报错,条目仍留在列表可重试。
- 修改
client.js需刷新 DSH 窗口;修改web/overlay.js仅需重新加载被浏览页面。
结尾¶
dsh-web-pick 把内置浏览器里的点选、框选与说明收成一批结构化草稿,减少截图与描述脱节。社区目录页:SkillHub - dsh-web-pick;源码与详细说明:GitHub - Chenghui-Liang/dsh-web-pick。DSH 插件生态由社区目录与各自仓库维护,与 DeepSeek / 幻方无官方从属关系。