本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-annotation

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @changfenhuang/dsh-annotation

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 纯浏览器端：全部能力在 client.js（hand-written CJS bundle，无构建步骤，按请求读取 no-cache）
• 消息格式（跟随 DSH locale 语言偏好，zh/en 双语）：
• 气泡隐藏：用户气泡是纯文本渲染（MessageText 单节点，非 markdown）；MutationObserver 微任务阶段（绘制前）按最后一个 \n提问： 切掉批注块、贴「批注 ×N」标签；1s 轮询兜底 + 刷新后历史消息自动修复
• 语言跟随：UI 文案与批注协议块跟随 DSH locale 服务（zh/en，实时切换）；历史气泡跨语言可解析；locale 服务缺失时回退 zh
• IME 安全：Enter 拦截带 isComposing/keyCode 229 守卫；不 DOM 硬改 composer textarea；setDraft 仅在提交前一刻拼批注块，不覆盖用户草稿

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件装上后需要额外配置吗？

不需要。安装命令一次到位，插件无任何配置项；如需卸载直接走 DSH 标准插件移除流程即可。

我发送的消息气泡里会显示批注块吗？

不会。批注块在浏览器绘制前就被从用户气泡的 DOM 中隐藏，气泡里只剩你的问题和「批注 ×N」标签，悬浮标签可查看每条批注的原文与批注内容，刷新后历史消息会自动修复。

切换到其他对话窗口时批注会保留吗？

不会。批注只存在当前会话内，切换会话或新建会话时插件会自动清空已收集的批注，避免跨会话污染。

和 dsh-focus-chat 这种聚焦视图插件兼容吗？

兼容。插件同时识别 DSH 主视图的助手行（带 data-time-hover-root）和 focus-chat 聚焦视图的助手行（带 data-focus-flow 且 class 含 assistant 的容器），两种视图的选区批注、回复芯片都能正常工作。

使用中文输入法时回车会被插件拦截吗？

不会。插件对 Enter 的拦截带 isComposing / keyCode 229 / compositionend 50ms 延迟三重守卫，拼音或第三方输入法合成中或上屏确认的 Enter 不会被误判为提交。

会改动 DSH 本体代码吗？

不会。cordis.patch.yml 只插入一行自身 id，profile 补丁保持空数组，DSH 核心文件零改动；Node 侧是空实现，所有逻辑都在浏览器端 client.js。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=20
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则