dsh-plugin-highlight-notes · 批注 ✍️

给 DeepSeek Harness 的回答加批注：选中文字 → 右键「批注」→ 写备注 → 一键放进输入框。

全部逻辑跑在浏览器半边，不碰会话日志、模型请求、文件系统。批注只存在你这台机器的浏览器里。

截图

功能

功能	说明
两种批注	仅高亮：右键一步完成，纯视觉记号，默认不进列表；可引用：弹框写备注，进列表并可交回输入框
列表筛选	仅可引用 / 仅高亮 / 全部，默认只看可引用，标签带数量
高亮	用 CSS Custom Highlight API 绘制，不插入任何 DOM 节点，不干扰 Markdown 渲染
按会话隔离	每条批注属于创建它的会话；切换会话自动换列表、清高亮、切回自动恢复
偏移自愈	锚点存「座位键 + 偏移 + 引文 + 前后文」，DOM 重建或前文改动后靠引文重新定位
快捷引用	右键「批注…」后，备注框里的「添加到对话」把原文和备注直接放进输入框，不保存批注、不进列表
喂给模型	引用块 → 备注 → 指令，三段拼成一条消息写进输入框，由你自己按发送。内置「解释 / 不同意」，也可在设置里增删
可配置	「设置 → 批注」里编辑快捷指令的按钮文字与指令语；内置两条以真实行呈现，可改可删，「恢复内置」回到未配置态
入口	输入框上方状态栏的「批注 N」药丸，点开右侧浮层面板
中英文	跟随 DSH 语言设置

安装

dsh plugin --profile desktop add dsh-plugin-highlight-notes

装完重启 DSH——运行中的进程持有内存里的旧插件树。

桌面应用也可以在「插件」页的安装框里填 dsh-plugin-highlight-notes。

从源码

git clone <repo> && cd dsh-plugin-highlight-notes
pnpm install
pnpm build
dsh plugin --profile desktop add "file:$PWD"

用法

1. 在回答里选中一段文字（同一段落内），右键 →「批注…」。
2. 写备注（可留空）→「保存批注」。文字被高亮（暖黄），状态栏药丸计数 +1。
   • 只想留个视觉记号：右键直接选「高亮」（冷蓝，不进列表）。
   • 只想把这段放进下一条消息：备注框里点「添加到对话」——写进输入框，但不保存。
3. 点药丸打开面板：点条目可滚动定位；[添加] 只放引用，[解释 ▾] 连同指令一起放。
4. 切到别的会话，面板只显示那个会话自己的批注；切回来原样恢复。

数据

• 存在浏览器的 localStorage，键为 dsh-plugin-highlight-notes/v1/<sessionId>。
• 不进入会话日志，换设备或清空站点数据会丢；这是刻意的取舍（见 DESIGN.md）。
• 卸载插件不会删除已有数据，重新安装即可看到。

已知限制

• 跨段落选择会被拒绝（会提示「请在同一个段落内选择」），跨会话的锚点也无意义。
• 折叠起来的内容（思考过程、折叠的工具输出）里的文字标不到；展开后已有的批注会重新定位成功。
• 高亮颜色统一；::highlight() 只支持静态名，按标签配色留到后续版本。
• 桌面端右键菜单由插件自绘（Electron 原生菜单在宿主进程，插件改不了）。
• 桌面端只在开发版 Web renderer 上验证过配色与几何；打包应用内的实机验证见交付说明。

开发

pnpm typecheck     # tsc
pnpm test          # 锚点定位的回归用例（纯函数，无浏览器）
pnpm build         # lib/index.js + lib/client.js
pnpm smoke         # 无浏览器加载 bundle，断言三个插槽的注册
pnpm verify        # 上面四步一次跑完
pnpm release       # 发版：校验 → 改版本 → 收口 CHANGELOG → 提交 → 打 tag → 推送

本地起真实应用（在 deepseek-harness 仓库里）：

pnpm dsh web --patch ../dsh-plugin-highlight-notes/dev.patch.yml

改 client 刷新页面即可；改 host 或 overlay 需要重启。

demo/ 里是立项前的交互验证页（锚点算法与性能实测），不属于插件运行时。

设计决策

见 DESIGN.md：数据边界、模型可见性、面板形态、引用模板、会话隔离。