前言¶
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 倉庫。
