前言¶
DeepSeek Harness（DSH）采用插件化架构，允许开发者通过扩展功能来适配具体工作流。在对话场景中，若需针对特定文本进行引用、解释或记录思考过程，传统的截图或手动复制方式往往不够高效，且容易造成上下文传递的断裂。dsh-plugin-text-quote 插件解决了这一问题，它模仿 Codex 的交互模式，允许用户在对话中直接对文本进行批注，并将这些信息作为结构化数据注入消息流，使模型能够感知并处理这些补充信息。
插件定位¶
这是一个对话文字批注插件，由 sunnystarye-ui 维护。它不改变对话的基本交互逻辑，而是在输入侧提供批注坞，在发送后提供胶囊展示。其核心价值在于将非结构化的引用和评论转化为机器可读的 <!-- dsh-annotations --> 标记，确保模型在生成回复时能基于这些批注上下文。
核心功能¶
- 选区注释：在对话窗口中拖动选择一段文本，系统会弹出上下文菜单。点击「添加到对话」即可打开批注框，保存所选原文与用户的评论内容。
- 输入侧批注坞：批注列表会显示在输入框的左侧区域。用户可以在此处展开、查看、编辑或删除已创建的批注。
- 引用注入：当消息发送时，插件会自动将批注块（格式为
<!-- dsh-annotations -->）注入消息正文。这使得大模型在处理该消息时能够读取到批注内容。 - 发送后胶囊：在已发送的消息中，批注块会被折叠为「N 条注释」胶囊。点击胶囊即可展开，查看原始文本与对应的评论内容。
- 快捷键支持：在批注框内输入时，按 Enter 键保存批注，按 Shift+Enter 换行，或者使用 Ctrl/Cmd+Enter 亦可保存。
- 本地运行：插件完全在本地运行，不包含遥测数据，也不向外部发送请求，运行环境纯净。
安装与启用¶
该插件基于 DeepSeek Harness Web 端架构。安装前请确保环境满足 Node.js 版本 >= 18。
dsh plugin --profile web add dsh-plugin-text-quote
安装完成后，插件将以客户端插件（dsh.client.platform = web）的形式运行。它依赖宿主环境提供 @deepseek-ai/dsh-client-ui-slots 接口。
典型用法¶
- 在对话历史中拖动选择需要引用或注释的文本。
- 点击弹出的菜单中的「添加到对话」选项。
- 在打开的批注框中输入评论内容，使用 Enter 键保存。
- 点击发送消息。消息发送后，批注块会自动注入，并在消息内容中以「N 条注释」胶囊形式展示，点击即可展开查看详情。
适用场景与注意¶
- 适用平台：DeepSeek Harness Web 客户端（
dsh.client.platform = web）。 - 依赖项：需要宿主提供
@deepseek-ai/dsh-client-ui-slots插槽支持。 - 许可证：遵循 MIT 许可证，代码开源。
该插件通过标准化的数据注入方式，帮助开发者更清晰地管理对话中的上下文引用。如需查看源码或提交 Issue，请访问 GitHub 仓库。
