wangwei-wade/dsh-quote-annotate

dsh-quote-annotate

选区引用与锚点批注 —— DeepSeek Harness（DSH）Web 插件，纯 Client、无 Host 逻辑。

解决了什么问题

DSH 会话中的消息无法被选中、引用和批注：你想针对上文某段内容提问或评论时，只能复制粘贴或口头描述“上面那部分”，模型无法精确知道你说的是哪一段。

本插件让“选中 → 批注 → 引用”成为一条完整链路：选中的文字变成带锚点的引用 chip 进入输入框，发送时序列化为结构化引用块，模型收到的评论精确锚定在你引用的那段原文上；输入框里的每个引用还能点击跳回原文位置、悬停查看原文。

功能

- 选中即批注：鼠标选中会话中任意文字 → 选区上方浮出小气泡（宽度随文字增长）→ 点「批注」
- 悬浮编辑框：引用预览 + 独立评论输入框（自动聚焦、元素常驻），随输入变宽；Enter 插入 / Esc 关闭
- 引用锚点 chip：插入后草稿中显示 引用#N chip
- 点击 → 平滑滚动回原文并高亮
- 悬停 → 浮出提示框，显示当时选中的文字
- 提交序列化：发送时 chip 展开为 > 引用块 + 评论，模型收到结构化上下文
- 回合级引用：每条已完成回合尾部有「引用提问 / 引用回答」按钮，整段引用该轮的提问或回答
- 全程走官方接口：conversation.input 输入机器、inputTriggers 引用管线（quote-ref source codec）、slots 注入（turnTail / shell.overlay）

安装（一键，发给 Agent 即可）

把下面这段话直接粘贴给 DSH 助手：

请帮我安装 dsh-quote-annotate 插件：运行 dsh plugin --profile web add github:wangwei-wade/dsh-quote-annotate，
然后重启一次 web 服务使插件生效（静态客户端插件在服务启动时加载，重启后或下次启动时生效）。

手动安装（可选）：

dsh plugin --profile web add github:wangwei-wade/dsh-quote-annotate  # 从 GitHub 安装
dsh --profile web --dump-config                                       # 确认出现 # == dsh-quote-annotate 层

npm 状态：dsh-quote-annotate 的 npm 发布待开通（npm 要求发布者开启 2FA，账号暂未绑定），开通后即可 dsh plugin --profile web add dsh-quote-annotate。

要求：DSH Web 界面（官方 web profile 自带 ui-input-trigger 引用管线）；管线缺失时自动回退为纯文本引用插入。

发布（维护者侧）

git push origin main                        # 推送源码
git tag v0.1.0 && git push origin v0.1.0    # 打版本 tag

说明

- 引用映射（ref → 原文位置）存于浏览器内存，刷新页面后失效（chip 退化为纯文本）
- 评论输入框的输入法语言行为取决于操作系统/输入法，插件已做元素常驻复用优化
- 有产出文件的回合会让位给官方「已生成文件」chips