前言¶
DeepSeek Harness（DSH）采用插件化架构，允许开发者扩展其功能。在智能体开发和长期对话场景中，如何有效地将前文上下文传递给模型，以及如何追踪当前轮次生成的文件，是常见的痛点。dsh-cite 插件旨在解决这两个问题，它提供了前文批注和历史会话引用能力，并自动在回复中展示生成的文件。
插件介绍¶
dsh-cite 是 DeepSeek Harness 的 Web 插件，中文名为“引注”。该插件由用户 wanghehe123 维护，采用 MIT 许可证。它通过注入浏览器逻辑，实现了文本选区引用、跨会话引用以及文件产物展示功能。
安装与启用¶
通过 CLI 安装该插件：
dsh plugin --profile web add @wishp3/dsh-cite
安装完成后，需要手动启用。打开 DSH Web 界面，进入设置 -> 插件 -> 插件配置，找到“引注”卡片。在卡片中可以调整 scope 配置，默认范围是当前工作区。
核心功能¶
- 圈选前文批注：选中对话中的文本，可以添加评论并随消息发送。
- 历史会话引用：使用
@符号引用历史会话作为只读证据。 - 产物展示：回复完成后，生成的文件会以列表形式显示在消息下方。
- 会话 ID 复制：在会话行菜单中可复制原生的 session id。
- 配置 Scope：支持在设置中切换引用范围（仅当前工作区 vs 所有可见会话）。
使用方法¶
圈选前文添加批注¶
在聊天正文中选中一段文本，点击出现的“添加到对话”按钮。句子末尾会出现数字小圆点。点击圆点可以打开评论卡片，输入评论并保存。发送时，选中的文本会变成 Markdown 引用块，评论会跟在后面。
引用历史会话¶
在输入框输入 @，会从历史会话列表中弹出候选菜单。选择一段会话后，系统会将其作为只读快照传递给模型。也可以直接输入 session-<uuid> 或在开关开启时手打 @标题（标题必须唯一）。
查看与打开文件¶
回复完成后，消息下方会出现“产物”列表，列出本轮生成的文件。左键点击可打开文件，右键点击可复制路径，或直接在文件管理器中打开所在文件夹。
复制原生会话 ID¶
在会话列表中，点击会话行右侧的菜单按钮（⋯），可以选择复制该会话的原生 session id。
配置说明¶
插件配置主要涉及 scope 参数：
* workspace：只能引用与目标会话同工作目录（cwd）的记录。
* all：引用本机 dsh 可见的全部持久化会话。
默认值为 workspace。
注意事项¶
- 选区限制：选区引注仅支持文本，图片和工具卡片不支持。
- 重复引用：同一段文字可以圈选多次，系统不会自动去重。
- 渲染方式：回复中的引用块不做特殊渲染，
>就是普通的 Markdown 语法。 - 草稿重载：草稿重载后，选区引用不会自动变回 chip，只保留文本。
- 搜索范围：
@候选列表不搜索消息正文，仅基于 id、cwd 和折叠后的标题进行匹配。 - 跨会话限制：跨会话引用只传播文本，非文本块不会传递。
- 引用时效：引用不是实时链接，快照在发送时冻结，不会随源会话变化而更新。
结语¶
dsh-cite 插件通过简单的交互（圈选、输入 @）增强了 DSH 的记忆能力，使得上下文传递和文件管理更加直观。它不改变 DSH 的核心运行时，而是通过 Web 层面进行增强，适合需要精细化控制上下文和产物的开发者使用。
