在開發智能體時,上下文記憶的管理往往依賴於臨時對話或未標準化的存儲方式。DSH 提倡插件化架構,dsh-agent-memory 正是爲了解決 Claw Agent 的記憶持久化問題而設計的獨立插件。它爲每個 Agent 提供 USER / MEMORY 金庫、日記和回合後回顧機制。
核心功能¶
- 金庫與日記:每個 Claw Agent 擁有獨立的 USER 和 MEMORY 金庫,以及按日期歸檔的日記文件。
- 回合後回顧:在每輪對話結束後,根據設置執行回顧操作。
- 壓縮同步:在官方會話壓縮開始時,插件監聽
session/event的compaction/start事件,並立即將需要寫入的內容存入金庫。 - 配置選項:支持設置記憶寫入是“自由寫”還是“需審批”,以及“回顧開關”的開啓狀態。
- 作用域隔離:
- Claw 會話只讀自己的金庫。
- 工作區 / 官方會話不注入 Claw 記憶。
memory工具只掛在 Claw 會話上。
安裝與啓用¶
安裝前建議先安裝 dsh-agent-registry 和 dsh-agent-identity。
- 通過 GitHub 安裝:
dsh plugin --profile web add github:xingyingyuzhui/dsh-agent-memory
- 本地開發安裝:
dsh plugin --profile web add link:/abs/path/to/dsh-agent-memory
- 重啓服務:
安裝完成後重啓dsh web。
數據存儲位置¶
插件運行時會生成以下文件:
- 金庫文件:
~/.dsh/DSclaw/<slug>/USER.md~/.dsh/DSclaw/<slug>/MEMORY.md
- 日記文件:
~/.dsh/DSclaw/<slug>/memory/YYYY-MM-DD.md
- 全局配置:
~/.dsh/agent-memory/settings.json
注意事項¶
- 工具掛載:
memory工具僅掛在 Claw 會話上(DSH 0.1.6+ 版本採用串行初始化)。 - 卸載行爲:卸載後,上述文件仍保留在磁盤上,但插件不再注入、不再執行回顧,
memory工具會消失。 - 權限與安全:插件以當前 dsh 進程權限運行,安裝前請檢查源碼與許可證。
該插件爲 DSH 下的 Claw Agent 提供了標準化的記憶層。更多細節可參考項目目錄或源碼。