前言¶
在使用 DeepSeek Harness (DSH) 進行對話時，經常需要對助手的回覆內容進行即時批註，以便後續讓模型針對特定片段進行回應。傳統的批註方式往往需要在回覆後手動複製粘貼或切換上下文，不夠流暢。dsh-inline-comments 插件旨在解決這個問題，允許用戶在對話流中直接選中文本並添加註釋，發送時將這些批註與正文一起交給模型。
這是什麼¶
該插件由 zenvertao 維護，屬於「記憶」類別工具。它的核心邏輯是：在助手回覆文本上選中內容，觸發批註編輯器，保存後生成高亮與編號；發送對話時，批註內容會以特定格式（--- 分隔）置於正文之前，模型隨後逐條回應。發送後批註自動清理。
核心功能¶
行內交互
選中助手回覆文本，浮出「＋ 添加註釋」按鈕。點擊後進入編輯器，回車保存，Shift+回車換行。
狀態反饋
保存後，被批註文本高亮顯示，右上角出現編號氣泡。輸入框上方出現「N 條注」膠囊。
膠囊管理
懸停膠囊可查看詳情，支持刪除單條或清空全部。
發送邏輯
發送時，批註區（格式包含 [i] 原文：… / 批註：…）置於正文之前，中間以 --- 分割，模型逐條回應。發送後自動清理批註。
持久化與清理
支持跨刷新持久化至宿主 JSON 文件（默認路徑爲 ~/.dsh/dsh-inline-comments.），瀏覽器 localStorage 僅作同頁快速鏡像。發送後自動清理，不留殘留。
可靠性與兼容
記錄選中文字前後的上下文，確保定位準確。若原文變動導致找不到，膠囊與詳情會標出「原文已變」。支持多窗口/多端安全合併（按批註 id 合併，刪除帶時間戳）。
安裝與啓用¶
使用官方安裝命令添加插件：
dsh plugin --profile web add dsh-inline-comments
典型用法¶
- 在助手回覆裏用鼠標選中一段文字。
- 點浮出的「＋ 添加註釋」。
- 輸入批註，回車保存。
- （可選）再選別的文字繼續加；膠囊裏可管理 / 刪除。
- 直接回車（或點發送）——正文會帶上批註，模型逐條回應。
適用場景與注意¶
該插件適合需要在對話流中即時標註上下文並傳遞給模型進行逐條回應的場景。使用時需注意：
- 插件面向最新版 DSH 開發，不追求兼容所有舊版本。
- 若接口取不到，會出現
[dsh-inline-comments]開頭的告警。 - 測試基準爲桌面版 0.1.7-rc.2。
插件遵循 MIT 許可證。
短結尾¶
dsh-inline-comments 解決了在對話流中即時標註上下文並傳遞給模型的需求。更多細節可查閱插件目錄或源碼。
