前言¶
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 層面進行增強，適合需要精細化控制上下文和產物的開發者使用。
