前言¶
在使用 DeepSeek Harness (DSH) 與 Agent 交互時，開發者常需針對回覆中的特定片段給出反饋或修正意見。直接複製文本或重寫整條消息容易丟失上下文，且難以精確對應。dsh-message-annotator 插件參考了 Codex 桌面版的交互模式，旨在解決這一痛點，提供一種結構化的引用與批註機制。
是什麼¶
dsh-message-annotator 是一個客戶端插件，由 Theoz001 維護。它的核心功能是在 DeepSeek Harness Web 界面中，允許用戶對 Assistant 的回覆（包括中間步驟或工具輸出）進行引用和批註。用戶可以將選中的文本與批註內容暫存爲編號卡片，隨後將這些卡片與草稿對齊合併，作爲一條結構化的消息發送給 Agent。
核心功能¶
該插件提供以下主要功能：
- 劃詞浮動觸發：在聊天流中選中任意文本（Agent 回覆、中間步驟、工具輸出），選區旁會浮出“Annotate”按鈕。點擊後，引用內容即鎖定爲選中文本。
- 逐消息動作：每條已完成的 Assistant 消息的操作欄（點贊/點踩按鈕旁）也會出現“Annotate”按鈕。不選中文本時，點擊該按鈕可對整條消息進行批註。
- 批註停靠欄：輸入框上方會列出所有暫存的批註，以編號卡片形式展示（如 Annotation 1, Annotation 2…）。每張卡片包含引用原文和可編輯的批註內容，支持單條移除和一鍵清空。
- 摺疊條：當批註數量較多時，卡片會摺疊爲單行 Chip。懸停可預覽內容，點擊 × 可移除，發送按鈕始終可用。
- 對齊發送：
- Send annotations：將當前草稿與所有批註合併爲一條消息發出，每條引用塊與批註內容嚴格對齊。
- Insert into draft：僅將排版好的文本（包含引用和批註結構）插入到輸入框草稿中，供用戶檢查。
- 雙語界面：界面語言跟隨系統環境，支持中英文切換。
安裝與啓用¶
通過官方命令行安裝該插件：
dsh plugin --profile web add github:Theoz001/dsh-message-annotator
執行命令後，需要重啓 dsh 並刷新 Web UI 以使插件生效。
典型用法¶
- 創建批註：在聊天界面中選中一段代碼或文本，點擊出現的“Annotate”按鈕，在彈出的編輯框中輸入批註內容。
- 管理批註：在輸入框上方的停靠欄中，可以查看、編輯或刪除已創建的批註卡片。
- 發送消息：
- 若需 Agent 根據批註調整內容，點擊“Send annotations”。
- 若需先檢查生成的結構化文本，點擊“Insert into draft”。
注意事項¶
- 觸發限制：操作欄上的“Annotate”按鈕僅出現在每個回合的結束消息上（這是插槽的固有約束）。對於中間步驟或非結束消息，請使用劃詞浮動按鈕進行批註。
- 數據持久性：暫存的批註僅在當前會話的內存中有效。刷新頁面後，批註內容會丟失（已發送的消息不受影響）。
- 安全提示：安裝前建議檢查插件的源碼與許可證。
