前言¶
DeepSeek Harness (DSH) 的默認對話會話是無狀態的。當會話結束或應用重啓時,上下文會丟失。對於需要長期記憶、特定命名或隱私隔離的智能體開發場景,這會帶來阻礙。dsh-memory 插件通過持久化存儲解決了這些問題。
這是什麼¶
dsh-memory 是一個靜態 profile 插件,由開發者 hmlyx 維護,採用 MIT 許可證。它讓 DSH 中的 AI 擁有持久記憶,支持記憶標籤頁管理、自動命名、多 AI 隱私隔離以及經驗自動歸檔。
核心功能¶
插件提供以下核心能力:
- 記憶標籤頁:在對話視圖中新增「記憶」標籤,支持總開關、改名、文件瀏覽。
- 自動命名:內置 50 個不重複的 AI 名字庫,可隨機分配。
- 隱私隔離:記錄分爲私有(global、brief)和共享(shared、experience)兩種模式,確保不同 AI 之間的數據隔離。
- 側欄 AI 名:一鍵讓所有會話側欄顯示各自 AI 的名字。
- 經驗共享:通過只讀方式共享解決過的問題,實現經驗複用。
- 記憶歸檔:提供
memory_record工具,支持將內容歸檔爲 global、shared、brief、event 或 experience 五種類型。
安裝與啓用¶
插件以靜態 profile 形式安裝,無需複雜的配置步驟。
-
放置倉庫
將插件倉庫放入 DSH 的 profile 目錄:
~\.dsh\profiles\web\node_modules\dsh-memory\ -
修改依賴配置
打開~\.dsh\profiles\web\package.json,在dependencies字段中添加:
"dsh-memory": "3.0.0"
- 註冊插件
在dsh.profile.bundles字段中添加:
"dsh-memory"
- 重啓
重啓 DeepSeek Harness 使配置生效。
典型用法¶
插件通過注入工具和 Prompt 指導 AI 進行記憶管理。
1. 使用記憶工具
AI 可調用 memory_record 工具寫入記憶。kind 參數決定記憶的類型和可見性:
* global:全局私有記錄。
* shared:全局共享記錄(其他人可讀)。
* brief:簡要私有記錄。
* event:事件私有記錄。
* experience:經驗共享記錄(解決過的問題,可複用)。
2. 主動記錄經驗
* 在解決問題或學習技巧時,主動調用工具寫經驗。
* 在完成任務或開啓新任務前,總結帶標題的經驗。
3. SystemPrompt 注入
在 systemPrompt 中注入 AI 名和記憶義務,無需用戶提醒。
4. 標題還原
插件會自動管理側欄名稱。當會話結束時,側欄名稱會自動還原爲原始標題。
適用場景與注意¶
- 適用場景:需要長期對話上下文、希望 AI 具備自我命名能力、或需要在不同預設間隔離隱私的開發者。
- 權限注意:插件以當前 DSH 進程的權限運行,請確保安裝源可靠。
- 兼容性:與舊動態插件兼容,數據不會遷移或丟失。記憶文件默認存儲在對話記憶目錄下,可通過
.memory-state.json查看狀態。
結尾¶
通過 dsh-memory,DSH 用戶可以構建具備長期記憶和隱私隔離能力的智能體。該插件安裝後重啓即生效,適合任何預設使用。