dsh-memory-forget — AI Agent 遗忘引擎

English · 中文

记住更少，想得更清。

AI Agent 遗忘引擎：记忆 TTL、衰减、淘汰、审计。记忆编程的反面。零依赖核心，MIT 协议。

记忆编程席卷 Agent 生态（Mem0、Letta、Engram 都在教 Agent 记住一切），dsh-memory-forget 做的是它的反面——把"遗忘"从意外变成设计：每条记忆都有保质期、到点即死、全程审计、注入有硬预算、拔得干净。

一句话差异：记忆引擎回答"怎么存得好、找得准"；dsh-memory-forget 回答"什么时候该忘、哪条还可信、放多少进上下文、里面到底有什么"。

这不是抬杠，是有依据的：Agent 用得越久越笨，记忆污染是主因（CUHK & ZJU）；记忆投毒是真实攻击类（单封邮件持久投毒、隐形记忆注入）。遗忘不是记忆的故障，是记忆的治理。

安装（DSH 插件 · 官方 bundle）

dsh plugin --profile <name> add @xiaoke8698/dsh-memory-forget

卸载：dsh plugin --profile <name> remove @xiaoke8698/dsh-memory-forget（记忆留在磁盘上；删除该工作空间的 .dsh-memory-forget/ 目录即彻底清空）。

开发者把引擎当库用：npm install @xiaoke8698/dsh-memory-forget，然后 import { AmnesiaEngine } from '@xiaoke8698/dsh-memory-forget/core'（Node >= 20，零依赖，ESM）。

bundle 声明两行插件：记忆总线（只依赖 tools，headless 也能挂）与 web 支持行（inject: ['webServer','amnesia']），后者为浏览器半提供 GET /amnesia/status。

使用

import { AmnesiaEngine } from '@xiaoke8698/dsh-memory-forget/core'

const memory = new AmnesiaEngine({ restorable: true })

// 记住（带保质期，插上记忆总线）
const v = memory.plug({
  content: '验证饮品是 lapsang',
  ttlMs: 60_000,
  kind: 'preference',
  tags: ['validation'],
})

// 健康度：活跃/陈旧/已遗忘 + token 占用
console.log(memory.status())

// 想起即续命（use it or lose it）
memory.recall('lapsang')

// 拔下（物理删除 + 审计；restorable 时审计保留副本）
memory.unplug({ id: v.id })

// 恢复（restorable 模式）：新 id、新 TTL、审计记 restored
const back = memory.restore(v.id)

// 预算内注入选择：死记忆（stale/forgotten）绝不入选
const sel = memory.selectForInjection(2000)

// 干跑预览（不 touch，token 对账用）
console.log(memory.preview())

持久化：引擎是内存态，提供 StoreAdapter 即可落盘（示例见英文版 README）。

API

| 方法 | 含义 | |---|---| | plug(input) | 记住（TTL / pin / scope / tags） | | unplug(filter) | 遗忘（按 id / 关键词 / 标签）——物理删除 + 审计 | | touch(id) | 显式想起：重置衰减时钟（滑动续期） | | touchFromInjection(id) | 被动读取：节流续期（每个冷却期一次），且绝不越过寿命上限 | | recall(query?) | 想起：匹配并续命 | | restore(id) | 从审计恢复（restorable 模式） | | selectForInjection(budget) | 预算内选择；死记忆排除 | | preview() | 注入干跑预览（token 账本，不 touch） | | status() | 计数 + token 占用 + 下次过期 + 最近审计 | | auditView(limit) | 遗忘/恢复轨迹（只留哈希） | | sweep() | 结算并清除过期记忆（回合末调用） |

配置

所有可调项在 bundle 行的 config 里（可在你自己的 cordis.patch.yml 里按 id 覆盖；后层会整行替换）：

| 键 | 默认 | 含义 | |---|---|---| | defaultTtlMs | 30 天 | 新记忆的保质期 | | staleStrength / forgottenStrength | 0.3 / 0.05 | 陈旧 / 死亡的强度阈值 | | maxInjectedTokens | 2000 | 每步注入预算（少选不截断） | | maxItemBytes | 2048 | 写入密度上限 | | maxStoreBytes | 256 KB | 单工作空间 store 上限 | | injectRenewalCooldownMs | 6 小时 | 注入最多多久一次续期 | | maxLifetimeMs | 90 天 | 未 pin 记忆的硬寿命上限 | | restorable | false | 审计保留内容副本，使 restore 可用 | | promoteAfterAccesses | 0（关） | 显式访问达标后升级到更长 TTL | | storeFile | .dsh-memory-forget/store.json | store 路径（相对工作空间） |

特性

| 特性 | 说明 | |---|---| | 记忆总线 · 可插拔 | 记住 = 插上；遗忘 = 拔下——物理删除、无幽灵引用 | | 带保质期 | TTL + 艾宾浩斯衰减曲线：活跃 → 陈旧 → 遗忘 | | 重要性：声明或挣得 | pin: true 永不忘；或靠显式想起（recall）挣得——自动注入只是被动读取（续期每个冷却期最多一次、不计访问），且未 pin 的记忆有硬寿命上限，所以"只被注入过"的记忆照样会按时死掉 | | 可恢复 | restore(id) 把拔下的记忆原样插回；隐私模式可重新 remember（审计哈希可对照） | | 审计只留哈希 | 谁/何时/为什么被忘或恢复全留痕；内容默认物理删除 | | 注入硬预算 | 每步 ≤ maxInjectedTokens（默认 2000）；死记忆绝不注入；超限少选不截断 | | token 账本 | status() 暴露注入账本；preview() 干跑不生效 | | 轻量化 | 零 embedding、零 LLM 抽取/改写、零服务端进程 | | 隐私优先 | 默认物理删除；可恢复与删得干净是显式取舍 | | 按工作空间分域 | 工作空间就是记忆空间：每个工作空间独立 store（<workspace>/.dsh-memory-forget/store.json），记忆绝不跨项目泄漏 | | 多 Agent 适配 | scope 三档；子 Agent 消亡自动拔出临时记忆，默认不继承 |

测评：方法、现状与诚实声明

方法（三臂对照，同一模型同一任务集，只切换遗忘策略）：A 无记忆（每任务冷启动）/ B 全记忆（写入即永久）/ C Amnesia（带 TTL + 衰减）。公平性关键：B 与 C 共用同一存储与检索，只开关遗忘策略——记忆厂商无法"关掉自己的记忆"做对照。指标：累计上下文 token、任务成功率、陈旧错误率（事实中途变更后各臂使用旧事实的比例）、步数/耗时。任务集：记忆有帮助组 / 记忆有害组（事实变更、过期约束、投毒）/ 混合组。完整设计见 docs/design.md §11。

现状：尚无对比结果（M3 未跑）。 已验证的是机制能工作（过期/恢复/审计/预算注入/滑动续期），不是遗忘能提升效果。在 M3 出数据之前，效果主张基于引用研究，不是本包实测——一旦基准跑完，我们会连同方法论和任务集一起公开数据。

路线图

v0.5.0 包含核心引擎 + DSH 官方 bundle（AmnesiaEngine + Cordis 宿主适配层 + 浏览器半）：记忆按工作空间分域，并有注入续期节流与硬寿命上限——只被注入、从未被真正想起的记忆不会永生。未包含：CLI、skill、MCP server、基准结果。

• [x] M0 设计定稿
• [x] M1 动态插件验证（DSH 会话级）
  • [x] M1.1 核心引擎　[x] M1.2 服务与存储　[x] M1.3 工具面（7 工具）
  • [x] M1.4 生命周期钩子　[x] M1.5 注入与预算　[ ] M1.6 验收（子 Agent 自动拔出待实测）
• [x] M2 Client UI —— 环境读数条（已随 0.5.0 发布）：乐高风格的记忆健康度积木条（活跃/陈旧数、token 预算条、下次过期、工作空间），数据来自宿主半的 /amnesia/status 路由
• [ ] M2b 记忆面板 —— 节点视图 + 点击拔下 / 设置页
• [ ] M3 三臂基准 —— 累计 token、任务成功率、陈旧错误率
• [x] M4 DSH 官方 bundle（host + browser 双半自 0.5.0 完整）
• [ ] M4b skill + 本地 CLI 分发
• [ ] M5 增值（/amnesia 命令、自动建议 opt-in）　[ ] M6 MCP server（远期，不做承诺）
• [ ] 开放问题：Q1 遗忘激进度 / Q2 自动抽取 / Q3 语义检索 / Q4 目标用户 / Q5 基准任务集 / Q6 分发形态

其他 Agent 整合

DSH 用户——经官方 bundle 机制安装（见上文"安装"；dsh.bundle + cordis.patch.yml，见 DSH 文档 docs/user/develop/basic/publish.md）。

规划中（M4b）：skill + 本地 CLI（SKILL.md 复制即用，零服务端）。远期（M6）：MCP server（需服务端托管，不做承诺）。当前 npm 包 = 核心引擎 + DSH 官方 bundle；DSH 动态插件是会话级验证形态。

文档与相关研究

• 完整设计文档：docs/design.md（§13 架构总览、§14 最小真实验证实录）
• 生态依据：DSH 有 compaction（压缩）但无删除/过期/淘汰语义；记忆系统仅第三方 MCP 示例（默认关闭）
• 记忆污染使 Agent 变笨（CUHK & ZJU）　·　记忆治理：MemArchitect　·　记忆投毒：MemGhost / MemIncept