自进化长期记忆bass1125/imemory

imemory — DSH 自进化长期记忆插件

EN: English README

⚠️ 版本状态:本项目 2026-08-14 建项,次日即投入使用,至今已更迭 4 个版本。因高度个人定制化开发,当前发布版仍属测试版,接口与行为可能随迭代调整,敬请见谅。

imemory 是 DeepSeek Harness (DSH) 的自进化长期记忆插件:把"长期记忆"做成两个纯文本文件(MEMORY.md 你的笔记 + USER.md 用户档案,条目以单独一行 § 分隔),由 LLM 在回合结束后自动提炼值得记住的内容写入,并在每次对话步骤前自动召回相关记忆注入上下文;可复用的操作流程还会沉淀成 learned- 技能。附带一个网页管理面板。

✨ 特性

- 回合后自动提取:根会话每回合结束,LLM 从对话中提炼持久信息写入记忆(importance 打分 1-10,\.dsh)。路径不写死,任何机器上开箱即用:

| 文件 | 说明 |
| --- | --- |
| /MEMORY.md | 你的笔记(本机环境、项目、教训、技能沉淀) |
| /USER.md | 用户档案(身份、偏好、风格、铁律),仅档案变化时更新 |
| /memories.index.json | 侧车索引(插件自写条目的重要度 / 命中次数 / 时间) |
| /skills.json | 学习到的 learned- 技能 |

记忆文件是纯文本，随时可手动编辑；§ 单独一行作条目分隔符，条目内不要出现孤立 § 行。

✅ 验证安装

- 新会话第一步会收到  开场记忆块
- 模型工具列表出现 6 个 memory_* 工具
- 面板：http://:/imemory/（web profile；端口见启动日志 [imemory] 管理面板: ...）

🔬 行为细节

- 提取：仅根会话触发（子代理回合不额外消耗）；同一会话 20 秒冷却；每轮最多 6 条记忆操作 / 2 个技能
- 召回：每步关键词打分，候选 ≤15 条走 LLM 语义重排（温度 0）；无模型可用时回退纯关键词
- 固化：每 6 小时执行冲突合并 + 去重 + 衰减淘汰（>14 天且有效分 ≤1.5 的低价值条目淘汰）+ 索引孤儿清理
- 重要度：1-10；memory_add 或提取时 <3 直接丢弃；命中次数会提高条目有效分
- 与 Hermes 兼容：记忆文件格式与 Hermes 的记忆库一致（§ 分隔）——之前用 Hermes 写过记忆的话，把 memDir 指向现有记忆目录即可无缝沿用

🛠 开发

imemory/
├─ imemory.mjs       插件本体（单文件，零构建，零依赖）
├─ package.json      bundle 声明（dsh.bundle.patch）+ 元信息
├─ cordis.patch.yml  官方安装通道的挂载补丁
├─ README.md / README_EN.md
└─ LICENSE

📄 License

MIT