前言¶
在 DeepSeek Harness（DSH）里和模型对话时，经常需要指着某一段回复或某一行代码补充说明：这条 SQL 的 001 必传、驳回原因要写清楚、某段输出只是中间结果。把整段原文复制进输入框再写注释，草稿会很长，模型也容易搞混「引文」和「你的意思」。
下面介绍社区插件 dsh-annotation-cards（维护者 kaige1986kg），在 Web / Desktop 界面里实现类似 Codex 的「选中文本 → 写注解 → 随消息发送」流程：选区旁弹窗、蓝色角标、输入框上方的注释胶囊，以及发送后的可展开卡片。插件归类为社区目录中的「趣味换装」，当前 GitHub 星标为 0；能力以仓库 README 与 package.json 为准。
这是什么¶
dsh-annotation-cards 是面向 DSH 浏览器端 UI 的插件包（标准 DSH bundle，通过 dsh.bundle.patch 自动向 profile 组合层插入 annotation-cards，无需手工改 cordis.patch.yml）。宿主 half 为空实现，逻辑在客户端 bundle（lib/client.js）中完成。
它解决的是：在对话界面里对任意选中文本挂注解，发送时把结构化注解块附加到消息并进入模型上下文，界面上则用角标和卡片保持可读，而不必重写你已输入的草稿。
核心功能¶
以下能力均来自官方 README 说明。
- 选区胶囊：在对话里拖选文字后出现「加入对话」。
- 即时弹窗：点击后在选区旁弹出小窗，输入执行结果或注释；
Enter保存，Shift+Enter换行，Esc取消。 - 蓝色角标：保存后在被注解原文旁显示蓝色角标，点击可再次编辑；滚动时跟随原文。
- 极简占位：输入框上方只显示
● N 条注释小胶囊，点击展开 Codex 式注解卡片列表（引文、注释、编辑/删除）。 - 发送时自动附加：存在注解时按
Enter或点发送，注解块会自动附加到消息（不重写草稿），随消息进入模型上下文。 - 发送后卡片化：消息里的原始注解文本会被替换成
● N 条注解 ⌄可展开卡片；模型侧仍拿到完整可读文本。
插件无网络请求、无文件系统写入、不执行外部命令、不读取凭据；注解保存在浏览器内存，刷新页面后清空，已发送消息里保留可读文本。
安装与启用¶
DSH 版本需满足 engines.dsh：>=0.2.0 <0.3.0；peer 依赖 @deepseek-ai/cordis ^4.0.2。适用 profile 为 web 或 desktop（纯 CLI 无浏览器端则无法使用）。
从 GitHub 安装（README 原文，不需要 npm 账号）：
dsh plugin --profile web add github:kaige1986kg/dsh-annotation-cards
锁定版本示例（当前包版本为 0.4.0）：
dsh plugin --profile web add github:kaige1986kg/dsh-annotation-cards#v0.4.0
也可安装仓库打包的 tarball：
dsh plugin --profile web add ./dsh-annotation-cards-0.4.0.tgz
安装后重启或刷新 DSH 界面；README 写明无额外配置。仓库已提交构建产物 lib/，从 git 安装时不需要执行构建脚本。
插件以当前 DSH 进程与浏览器环境运行；安装前建议在 GitHub 查看源码与 MIT 许可证。
典型用法¶
- 在对话消息或输入区域拖选需要指代的文字，点「加入对话」。
- 在弹出的小窗里写注释，用
Enter保存。 - 在输入框上方通过
● N 条注释查看或编辑列表；需要时在原文旁的蓝色角标再次打开编辑。 - 照常输入消息正文并发送；有注解时发送逻辑会自动把注解块附在消息上。
发送给模型的注解块格式如下（README 示例）：
[[对话注解]]
注解 1 · 选中文本：
DELETE FROM t WHERE id = 1
注解 1 · 用户注释：
001 必传，驳回原因写得不清楚
[[/对话注解]]
适用场景与注意¶
适合：需要在 DSH Web / Desktop 里对某段对话内容做「引文 + 说明」式补充，并希望模型在一条消息里同时看到选区和注释的开发者或日常对话用户。
已知限制（README）：
- 蓝色角标依赖原消息 DOM，消息重渲染、刷新或切换会话后会消失。
- 发送后的卡片替换是 DOM 增强；识别不到消息气泡时退回显示原始可读文本，功能不受影响。
- 斜杠命令草稿、图片附件不做拦截。
- 依赖 DSH 内部客户端约定（如
conversation.input.dock、useInput/inputActions等）；DSH 大版本升级后可能需要插件适配。
社区插件目录站点 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，安装与使用以你本地环境与仓库文档为准。
结尾¶
dsh-annotation-cards 把「选中哪段话、附加什么说明」收成可发送的结构化块，并在界面上用角标和卡片减轻草稿噪音。进一步了解可访问目录页 kaige1986kg/dsh-annotation-cards 与源码仓库 github.com/kaige1986kg/dsh-annotation-cards。
