在 DeepSeek Harness (DSH) 的生态中，插件化是核心设计理念。当需要在对话中引用文件片段或代码行时，直接粘贴大段文本不仅占用空间，还缺乏精确的上下文关联。dsh-file-quote 插件通过统一引用机制，解决了这一问题。它基于 dsh-better-sidebar 构建，允许用户划选文件或消息内容，将其封装为带有文件路径和行区间的引用块，并在发送后保持对话整洁。
插件定位¶
该插件名为 dsh-file-quote，由开发者 Sunday2Mo 维护，类别属于客户端插件。它的核心作用是在 DSH 的对话与编辑器之间建立统一的引用流：划选文本 → 批注 → 生成引用块 → 发送。引用块在发送后会被折叠，用户侧仅显示一个 Chip，而 AI 收到的则是包含完整引用内容与来源位置的 Markdown 块。
安装与启用¶
安装该插件需要先安装其核心依赖 dsh-better-sidebar，否则文件引用功能将退化为普通浮层展示。
- 安装
dsh-better-sidebar：
dsh plugin --profile web add dsh-better-sidebar@latest
首次安装时可能会因 pnpm 11 拦截 node-pty 构建脚本而失败，此时需放行构建脚本：
cd ~/.dsh/profiles/web && pnpm approve-builds --all
dsh plugin --profile web add dsh-better-sidebar@latest
- 安装本插件：
dsh plugin --profile web add dsh-file-quote
核心功能¶
该插件提供了从选择到引用的完整闭环，主要包含以下能力：
- 划选批注：支持在侧边栏预览的文件内容、工作台编辑器、better-sidebar 编辑器或 Markdown 预览中划选文本。选中后点击浮层“批注”，可添加评论，随后点击“插入输入框”。
- 文件引用带行区间：生成的引用块会自动封装文件地址与被引内容的具体行区间，格式通常为
路径（第 X-Y 行）。这确保了 AI 能够精确定位到原文。 - 任意位置插入与数量不限：引用块可以在输入框的任意文本位置插入，且支持连续插入多个引用。序列化机制确保了多个引用块之间互不粘连，各自独占成块。
- 双端折叠：引用块在输入框和已发送的会话记录中均保持折叠状态。用户侧仅看到一个“引用内容 · 悬停查看”的 Chip，悬停可查看全文；AI 侧则能收到完整的引用块与来源信息。
- 点击跳回原文：点击输入框内或历史记录中的引用 Chip，系统会自动定位到原文。定位方式包括编辑器的高亮选中、消息行的滚动闪烁，以及文件原文浮层兜底。
典型用法¶
-
引用会话消息：
在任意对话中划选一段文本，点击浮层“批注”（可加评论），点“插入输入框”。输入框光标处会出现“引用#N”的 Chip。 -
引用文件文本：
在工作台编辑器、better-sidebar 编辑器或 Markdown 预览中划选代码，同样流程操作。发送后，引用块会自动带上文件路径和行区间，AI 可以直接根据这些信息定位到文件中的具体代码行。
注意事项¶
- 依赖关系：插件的完整功能（侧边栏文件内容引用、跳回定位高亮）依赖
dsh-better-sidebar。未安装该依赖时，仅会话消息引用功能可用，文件引用会退化为原文浮层展示。 - 版本要求：需要 DeepSeek Harness Web 0.1.x 版本。该版本使用
slots和inputTriggers服务，输入管线缺失时会优雅降级为纯文本插入。
