在 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服務，輸入管線缺失時會優雅降級爲純文本插入。
