前言¶
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 事件驱动提取，实现每日情景层与梦境整合固化的语义记忆。适合希望拥有完全控制权、以文件形式管理智能体记忆的开发者。
