前言¶
在使用 DSH Web GUI 進行開發或任務處理時，智能體可能會在專注於當前任務時產生“等等，那個其他東西可能……”的即時想法。如果這些想法與當前任務無關，直接打斷可能會分散注意力；如果相關，智能體在後續處理中可能會遺忘。dsh-insight-dock 解決了這個問題，它允許智能體停放簡短、嚴格受限的側邊觀察，而不干擾當前工作流。
插件介紹¶
dsh-insight-dock 是一個 DSH Web GUI 客戶端插件，由 POPCORNBOOM 維護。其核心價值在於爲智能體提供一個“上下文錨點”，允許停放簡短、嚴格受限的側邊觀察。
安裝與啓用¶
插件通過 DSH 的插件系統安裝。執行以下命令：
dsh plugin --profile <profile> add dsh-insight-dock
安裝後，需要重啓 dsh，插件纔會出現在界面中。
核心功能與用法¶
安裝並重啓後，composer（輸入框）上方會出現一個單行 dock，顯示爲 💡 3 條見解。點擊可展開當前筆記，使用箭頭切換到其他筆記。針對每個筆記，提供以下操作：
- 說來聽聽：讓智能體從它錨定的日誌窗口中討論這條筆記。
- 關閉：移除這條筆記。
- 關閉並告訴 agent 爲什麼：移除筆記，並注入一條包含你理由的單行通知。
在 DSH 的設置頁面中，找到“見解”部分，可以配置以下選項：
- 啓用/禁用：控制插件是否運行。
- 提示強度：決定智能體何時以及如何生成見解。
- 併發打開上限：允許同時打開的筆記數量，範圍 1-50。
- 生命週期：筆記在未被處理前的存活時間，單位爲分鐘，範圍 1-1440，默認爲 5 分鐘。
技術細節與限制¶
上下文錨點¶
每條筆記都記住它創建時的會話序列。insight_load 函數可以從那個時刻的真實對話日誌中讀取內容。這是利用持久化的會話日誌實現的，因此即使智能體自己的上下文被壓縮掉，筆記依然有效。
數據與生命週期¶
- 無歸檔：筆記在結束時即被刪除，沒有歸檔記錄。
- 重啓清空：由於筆記僅存在於內存中，重啓
dsh會清空 dock。 - 持久化設置：插件會持久化保存設置（文件位於
~/.dsh/insight-settings.json），但不會持久化筆記內容。
UI 與本地化¶
插件的用戶界面文本爲中文，包括 說來聽聽、關閉並告訴 agent 爲什麼 以及所有設置標籤。插件不支持 locale 綁定。
總結¶
dsh-insight-dock 提供了一種在 DSH 中管理非任務相關想法的結構化方式，通過上下文錨點確保觀察結果在智能體上下文丟失後依然可讀。
