DEVbyQIN/dsh-file-annotations ↗★ 0
dsh-file-annotations
Review file notes above the composer and send them with your message
Install
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:DEVbyQIN/dsh-file-annotationsREADME
Read the full README ↗使用
- 打开右侧文件预览。选中文字后点选区旁的「批注」,或在 PDF、图片、HTML 预览中点「框选」并拖出区域。
- 输入评论并保存。批注自动出现在主输入框上方的待发送列表,按当前会话隔离。关闭会清理批注的文件预览前会弹出确认,点「取消」或按 Esc 可继续批注。没有批注时直接关闭。
- 在列表中检查引用、评论和区域缩略图;可折叠列表、编辑评论、移除批注,或点文件名打开原文件。
- 在原生输入框补充总要求,再点击 DSH 的发送按钮或按 Enter。只有批注、没有额外文字也可以发送。
- 宿主确认接收后,本次批注从待发送列表移入历史;提交失败则保留批注,并由 DSH 恢复文字草稿,可修改后重试。
输入框里有一枚简短的「文件批注」引用。发送时,DSH 将它展开为本轮批注的文件路径、引用或区域坐标、评论和裁剪图路径;保存批注不会自动发消息。
可以像删文字一样删除蓝色「文件批注」引用:这会将本批批注移出待发送列表,保留其他消息文字和批注历史,刷新后也不会自动加回。需要恢复时,在文件头部的「批注」历史中点击「加入待发送」。
文字批注
TXT、JSON、Markdown、源码等可选文字预览,以及带可选文字层的 PDF 支持文字批注。兼容 Better Sidebar 的 CodeMirror 编辑器,文件内容区的选字可以批注;搜索框等普通输入框仍不弹出批注。
使用 Better Sidebar 打开 HTML 后,可以直接在渲染网页中选字,再点击「批注」或使用选区批注快捷键。文字与代码文件选中后,「批注」与 Better Sidebar 的「添加到对话」显示为同一个选区工具条;后者继续保留原有文件、行号和插入行为。
点击「选元素」再点网页中的段落、标题或图片,可给整个元素加批注;「框选」则保存元素内的局部区域。编号、高亮和选框跟随页面或局部容器滚动,缩放、换行和刷新后按元素重新定位。目标元素被删除或无法匹配时隐藏标记,避免标到其他内容。
HTML 工具条保留批注数量,使用图标选择网页元素;悬停显示提示,开启后为蓝色,鼠标经过元素时显示边框。框选区域收在旁边的小箭头菜单中,已移除「纯文字」切换入口。网页原有沙箱不变,不开启同源访问。不提供 OCR。
- 选字只显示「批注」选项,点击才打开输入条,不抢走阅读或复制时的焦点。
- 支持单字符及键盘选区,忽略表单输入框内的选区。
- 输入条内 Enter 保存、Esc 取消,输入法组字期间不触发。
- macOS 桌面首次加载 0.4.2 时,将打开文件改为
⌘O、选区批注改为⌘P;通过 DSH 设置接口保存,之后不重复覆盖手动修改。原设置留有本地备份,冲突/失败不会强行覆盖。 - 网页端保留
⌘⇧E(Windows 为Ctrl+Shift+E);Linux 网页端默认不绑定。按钮显示实际快捷键,可在 DSH 设置中调整或关闭。 - 蓝色保存按钮与取消按钮等大;Enter 提示放在保存按钮的悬停说明里。输入条内
⌘Enter/Ctrl+Enter保存当前批注并发送本会话全部待发送批注。 - 输入条打开后,新选区不会替换正在编辑的草稿。
- 跨 DOM 片段和跨行文字按完整引用匹配,保存偏移、上下文和 PDF 页码;高亮与编号显示在实际文字位置,未渲染或找不到引用时暂不显示编号。
区域批注
- PDF、图片、HTML 预览头部提供「框选」;拖拽接收层只覆盖内容可见部分,标签栏和退出按钮可操作。
- 松手后出现输入条,保存后在区域上显示框和编号。Esc 或再次点击框选按钮可退出。
- 写评论期间保留选中区域的虚线框,保存后转为正式标记,取消则清理。
- PDF 页码读取预览器的真实页标记;未渲染页不借用相邻页的画布,离屏标记不会盖住标题栏。
- PDF 和图片裁剪为 PNG。HTML 保存元素选择器、引用文字及元素内坐标,不提供裁剪图。
- 旧版 HTML 仅保存视口坐标,无法可靠推断原元素。旧记录保留在历史中;需要跟随元素时请重新选取,新旧记录不会被自动改写。
待发送列表和历史
- 默认列出当前会话加入本次消息的未发送批注,与当前打开哪个文件无关。
- 从旧会话文件地址打开预览,新增批注仍归屏幕上的当前会话,保存在当前会话工作区。
- 编辑评论后先保存或取消,再发送消息;提交中的批注不可编辑或移除。
- 发送期间新增的批注属于下一批,不会被上一批的成功确认清掉。
- 移除最后一条批注会移除原生引用,并保留自己输入的文字。
- 文件预览头部的「批注」入口用于历史查看和整文件批注,不再承担批量发送。
- 再次点击同一入口可收起历史卡片;待发送列表里的「发送全部批注」与原生发送按钮共用提交流程。
- 「全部会话」仅扩展历史查看范围,不会把其他会话的待发送批注带入当前消息。
- 旧版误归属的未发送记录可在「全部会话」中点击「移到本会话」恢复。