前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在多輪對話或長時間運行中，對話上下文容易丟失，或者跨會話的偏好（如溝通風格、工作習慣）無法持久化。dsh-agent-memory 旨在解決這個問題，提供一套能夠實時採集證據、持久化偏好，並在 Web UI 中提供狀態監控的長期記憶方案。
這是什麼¶
這是一個用於 DSH 的長期記憶插件，由 BPTumbleweed 維護。它通過零運行時依賴的架構設計，實現了對話證據的實時採集、全局偏好與會話記憶的雙層注入，以及一個只讀的數據瀏覽器和狀態面板。
核心功能¶
- 實時採集對話證據：通過鉤子機制將用戶消息追加到
evidence/live-messages.jsonl。 - Web UI 狀態面板：在對話視圖的
記憶標籤頁中展示/dsh-agent-memory/panel。 - 只讀數據瀏覽器：提供
/dsh-agent-memory/data/<kind>路由，支持瀏覽 human、live、signals、preferences 等類型數據。 - 能力探測與熔斷：插件加載時會探測能力，若連續失敗達到閾值會觸發熔斷，且該熔斷不會影響 DSH 主程序運行。
- 零運行時依賴：僅使用 Node.js 原生模塊。
安裝與啓用¶
使用官方插件管理命令安裝。安裝後需重啓對應 profile 的 web 實例。
dsh plugin --profile web add github:BPTumbleweed/dsh-agent-memory
systemctl restart dsh-web-<your-instance>
典型用法¶
插件依賴配套的 CLI (bin/) 來填充數據。首次使用需要進行全量回填。
python3 bin/memory-scan.py --full --root ~/agent-memory --dsh-home ~/.dsh
記錄偏好：
python3 bin/memory-note.py "prefers terse, evidence-backed answers" --section "溝通"
處理完信號後，清空待處理計數器：
python3 bin/memory-scan.py --mark-distilled
注意事項¶
- 偏好注入：插件不接管偏好注入，偏好注入由官方
agent-instructions負責。 - 脆弱層保護：會話內記憶注入是脆弱層，受字節預算限制，且受熔斷機制保護。
- 存儲機制：舊記錄會被壓縮，存儲佈局由插件讀取，由 CLI 寫入。
生態與鏈接¶
該插件面向跨版本升級設計，遵循 MIT 許可證。更多細節可查閱社區目錄與 GitHub 倉庫。
