前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的生態理念。在智能體開發中，記憶模塊常面臨兩個問題：要麼是複雜的 JSON 結構配合置信度機器，要麼缺乏跨會話的語義整合能力。dsh-evolving-memory 插件旨在解決這一問題，它疊在官方 compaction（會話內壓縮）之上，通過廉價模型將壓縮後的會話摘要進一步提取、整合爲人類可讀的 Markdown 文件。
插件介紹¶
本插件名稱爲 dsh-evolving-memory，由 findshan 維護。它提供文件化自進化的記憶能力，核心流程爲：捕獲會話內容 → 夢境整合 → 檢索注入 → 進化。其設計要點在於將記憶迴歸爲可編輯的文檔，而非封閉的數據庫，系統只提供文件、檢索器和整合觸發器，判斷全部交給模型。
核心功能¶
插件提供了六個核心工具，用於記憶的讀寫與整合：
1. memory_search：檢索記憶內容。
2. memory_read：展開記憶詳情。
3. memory_catalog：生成記憶目錄。
4. memory_save：寫入記憶。
5. memory_correct：通過糾錯進行學習。
6. memory_dream：進行跨會話的整合。
安裝與啓用¶
在 DSH 環境中安裝並啓用該插件：
dsh plugin --profile web add dsh-evolving-memory
dsh --profile web
典型用法¶
記憶文件默認保存在 $DSH_HOME/memory/ 目錄下，結構如下：
├── daily/2026-08-16.md # 今日要點 + 會話紀要
├── user.md # 用戶畫像（身份/偏好/目標/禁忌）—— 用戶可編輯
├── agent.md # 智能體自我認知與工作方式
├── memory.md # 長期記憶（兜底落點）
├── dream.md # 夢境整合日誌
└── projects/<p>/project.md
使用時，按需調用 memory_search（找）和 memory_read（展開）進行檢索。用戶可編輯 user.md 文件，Agent 寫入僅爲建議，用戶擁有最終決定權。夢境整合門控默認爲 24 小時或 5 次會話。
注意事項¶
- 無 schema、無遷移、無置信度、無狀態機：系統不強制結構，不維護遷移腳本，不輸出置信度評分，不使用狀態機。
- 人機共治：Agent 寫入僅爲建議，用戶擁有最終決定權。
- 無 API Key 時的行爲：無 API key 時，記憶的讀寫/檢索照常進行，僅模型步驟會跳過。
總結¶
dsh-evolving-memory 將記憶層簡化爲文件系統，通過官方 compaction 事件驅動提取，實現每日情景層與夢境整合固化的語義記憶。適合希望擁有完全控制權、以文件形式管理智能體記憶的開發者。
