DeepSeek Harness (DSH) 的智能體開發中，會話記憶通常隨進程重啓而丟失。dsh-memory-panel 插件爲每個會話提供了持久化、可搜索的記憶，並支持自動注入到系統提示詞中。
核心功能¶
該插件爲 DSH 提供了一套完整的記憶管理能力，主要包含以下部分：
- 模型工具：
memory_save（創建或更新條目）、memory_search（關鍵詞搜索）、memory_list（按標籤過濾列表）、memory_get（讀取條目）、memory_delete（刪除條目）。 - 自動注入：
memory:recall。插件會自動將排名前 6 的記憶注入到智能體的系統提示詞中，並在記憶被標記爲[重要]時高亮。 - 管理面板：通過設置菜單中的“記憶”入口，提供可視化的瀏覽、搜索、創建、編輯和刪除功能。
- JSON API：提供
/memory/api/*路由，用於面板與主機的通信。
安裝¶
使用官方 CLI 進行安裝，無需手動修改配置文件：
dsh plugin --profile <profile-name> add dsh-memory-panel
用法示例¶
作爲模型調用工具時，可以直接使用以下接口：
1、保存一條記憶
memory_save(title='User prefers Chinese thinking', content='...', tags=['preference'], importance='high')
2、搜索記憶
memory_search(query='Chinese thinking')
3、列出特定標籤的記憶
memory_list(tag='preference')
4、讀取完整內容
memory_get(id='m...')
5、刪除記憶
memory_delete(id='m...')
工作原理¶
- 存儲位置：記憶數據保存在用戶主目錄下的
.dsh-memory文件夾中，文件名爲memories。重啓進程後數據依然存在。 - 掛載方式：插件被掛載在 DSH 配置的用戶層，因此無論當前激活哪個智能體預設，這些工具對所有會話可見。
- 併發處理：寫入操作通過串行化鏈路執行，避免文件併發寫入衝突。
- 排名邏輯：評分權重爲 標題 (×3) > 標籤 (×2) > 內容 (×1)。中文查詢會進行雙字分詞匹配。
- 刷新機制：記憶緩存每 30 秒自動刷新，或在保存/刪除操作時立即刷新。
注意事項¶
- 運行環境：需要 Node.js 版本 >= 20。
- 文件權限：請確保主機進程對用戶主目錄下的
.dsh-memory文件夾有寫入權限。
