dsh-web-annotate
DSH 侧栏网页批注：在宿主里跑真实浏览器，指向页面元素即可看到标签/尺寸/颜色/字体，点一下就地批注，汇总成结构化指令。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:nubeslove/dsh-web-annotate#511a4abf7be2a363930a7bead5d16b83a76caaf3Web Annotate 以 dsh-web-annotate 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DSH 侧栏里跑一个真实浏览器，指向页面元素就地写批注，汇总成结构化指令。
Point at a live element inside the DSH sidebar, drop a comment on it, and get back a structured instruction list.
装不上、报错、或者行为和文档对不上，直接发邮件到 1992335297@qq.com，比开 Issue 更快被看到。
图为界面示意，按插件
lib/client.js的工具栏、拾取高亮、元素信息与批注列表样式渲染，页面内容为假数据，不是运行截图。可用node scripts/make-screenshots.mjs重新生成（源码在scripts/demo/annotate.html）。
改界面最累的不是改，是指路。「左边那个卡片的边距大了点」——模型得猜是哪个卡片；截一张图贴进去——又得反复圈。批注把指路变成点一下：鼠标停在哪个元素上，它的标签、尺寸、背景色、字体就摆在那儿，点一下写一句人话，最后汇总成一份带选择器的清单。
Page.startScreencast 出帧，SSE 推到侧栏，页面一有变化就刷新。标签 / 尺寸 / 背景色 / 字体 / 字号 / 字重。Ctrl+Shift+. 切换批注模式。localStorage，关掉 tab 再打开还在；删完自动清空。⌨ 把一段文本（含中文）送进页面当前焦点元素，绕开键盘布局与输入法。⤓ 把汇总写成 Markdown，存到 ~/.dsh/web-annotate/ 下。## 网页批注
页面：http://localhost:5173/
1. `#card-a`（div，936×54）
卡片内边距太大，收到 12px
2. `#card-b.accent`（div，936×54）
强调色换成主题蓝
localhost:5173，回车。首次启动浏览器要等几秒。Ctrl+Shift+.）进入拾取模式。指向元素看信息，点一下写评论；按住拖动可以框一块区域。退出拾取模式后，点击和滚轮会正常传给页面，可以当普通预览用。
| dsh-web-preview | dsh-web-annotate | |
|---|---|---|
| 渲染 | iframe 直出 | CDP 画面流 |
| 速度 | 接近原生 | 帧流，有几十毫秒延迟 |
| 能否批注 | 否（跨域拿不到 DOM） | 能 |
| 依赖 | 无 | 需要 Playwright（复用 DSH 自带的那份） |
两个插件可以同时装，各自一个 tab 类型。
宿主 lib/index.js
├─ 从 DSH profile 目录解析 playwright，复用 DSH 自带的 chromium
├─ 每个地址一个 page 会话，CDP screencast 出帧
├─ SSE GET /api/web-annotate/frames?session=<id>
├─ POST /api/web-annotate/session 创建会话
├─ POST /api/web-annotate/input 鼠标 / 滚轮 / 键盘转发
├─ POST /api/web-annotate/pick 坐标 → 元素信息（elementFromPoint）
├─ POST /api/web-annotate/reload 重新加载
└─ DEL /api/web-annotate/session/<id> 关闭
没用 WebSocket：DSH 的 webServer 只暴露路由注册，不保证能拿到 http server 的 upgrade 事件。SSE 是普通响应，稳定可控；输入事件走 POST，量级完全够。
选择器生成走 id → 类名 → nth-of-type 的降级链，最多上溯 6 层。
这个插件比纯前端插件权限大，装之前请明确知道它做了什么。
http / https，拒绝 file:// 与其它协议，不能读取本地文件。dependencies 为空，无 preinstall / install / postinstall / prepare 生命周期脚本。⌨ 面板的整段输入，逐字键入不转。conversation.input.left 插槽存在。该插槽没挂上时自动退回复制到剪贴板。~/.dsh/web-annotate/，不写项目目录。localStorage，按页面地址分键；换浏览器 profile 或清理站点数据会丢。0.2.x 桌面端验证过。node scripts/verify.mjs # 静态 + 路由级，17 项，不启动浏览器
node scripts/smoke.mjs # 端到端：起站点、起 chromium、取帧、拾取、输入、刷新、关闭，8 项
smoke.mjs 会真起一个本地 HTTP 站点和 Chromium，实测输出形如：
PASS 创建会话并打开页面
frame=13351 bytes, device=1000x700
PASS SSE 收到首帧画面
picked <div> #card-a 936x54
bg=rgb(255, 255, 255) font=16px / system-ui
PASS 拾取元素返回标签与样式
...
结果: 8 passed, 0 failed
dsh plugin --profile desktop add "github:nubeslove/dsh-web-annotate"
然后在 $DSH_HOME/profiles/desktop/package.json 的 dsh.profile.bundles 里追加 "dsh-web-annotate"，重启 DSH。
插件本身不含运行时依赖；Playwright 在运行时从 DSH profile 目录解析，复用 DSH 自带的 Chromium，不会额外下载浏览器。
自己改代码时用 link 指向工作副本：
dsh plugin --profile desktop add "link:/absolute/path/to/dsh-web-annotate"
路径含空格时手工处理：在 profiles/desktop/package.json 的 dependencies 加 "dsh-web-annotate": "link:E:/path/to/dsh-web-annotate"，在 dsh.profile.bundles 追加 "dsh-web-annotate"，并在 profiles/desktop/node_modules/ 下建指向本目录的 Junction，然后重启 DSH。
frame.childFrames() 逐层进入子文档，跨域也能读，最多 4 层，浮层显示所在层级）；新增 ⌨ 页面文本输入面板，用 keyboard.insertText 送中文等任意字符；新增 ⤓ 导出，把汇总写成 Markdown 到 ~/.dsh/web-annotate/。自检 19 项，冒烟 11 项。conversation.input.left 挂桥接组件拿到 inputActions，桥不可用时退回复制）；新增 Ctrl+Shift+. 快捷键、拖动框选区域、方向键与编辑键转发、批注 localStorage 持久化。自检增至 17 项。遇到 bug、安装失败、行为和文档不一致，或者想要某个功能，都可以直接发邮件。
邮件里带上这三样，定位会快很多：
package.json 里的 version）dsh --version）也可以在 GitHub Issues 提，但邮件更快。