dsh-agent-memory:Claw 記憶持久化插件

在開發智能體時,上下文記憶的管理往往依賴於臨時對話或未標準化的存儲方式。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。

  1. 通過 GitHub 安裝:
    dsh plugin --profile web add github:xingyingyuzhui/dsh-agent-memory
  1. 本地開發安裝:
    dsh plugin --profile web add link:/abs/path/to/dsh-agent-memory
  1. 重啓服務:
    安裝完成後重啓 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 提供了標準化的記憶層。更多細節可參考項目目錄或源碼。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜