ububwudb/dsh-memory-agent ↗★ 1
dsh-memory-agent
基于文件的长上下文混合检索记忆系统 适合需要长期记忆和自动体检清理的复杂对话任务,支持BM25混合检索。
安裝
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:ububwudb/dsh-memory-agent說明文件
閱讀完整 README ↗体检与使用信号
记忆系统只增不减必然腐化,所以要有「哪条还有用」的证据。这部分判据不是拍脑袋定的,
是参考了社区里迭代过十几个版本的实现(@max-null/dsh-memory 的 sweep / demoteStale)
在注释里留下的结论,只搬规则不搬代码:
- 使用信号:每次检索命中的前 5 条记进
/usage.jsonl(追加一行,{id, at, rank})。 只记前 5 条是刻意的——保证hit_count度量的是「模型真的会看的那几条」。 为什么是独立文件而不是写索引:检索是读路径,绝不能为了 +1 去重写整个index.jsonl; 记录失败也静默(旁路证据,不影响检索结果)。面板搜索同样计数,否则会误判「没人用」。 memory_sweep(只读体检):longUnused:默认 90 天没命中。阈值远大于降级阈值,因为「非常驻记忆几十天不用」 是常态,按 30 天报会把正常记录说成待清理。supersededBacklog:已被新版本取代、但文件还留档的旧版本(可择期物理清理)。- 只列清单,绝不删除:阈值在没攒够分布数据前只能靠猜,所以先让它可观察;
真要删就走
forget,要合并就走memory_resolve。
- 面板里每条会显示「命中 N 次 / 还没被检索过」,
idleDays由last_used_at ?? time反算。
配置
| 字段 | 默认 | 含义 |
|---|---|---|
root | null | 存储根目录;null = /.agent/memory |
requireConfirmation | false | 写入是否先落 suggested |
defaultBudget | 1200 | memory_assemble 默认预算(token) |
maxTopK | 200 | 检索硬上限 |
injectEnabled | true | 常驻注入开关;空库时自然什么都不注入 |
injectBudgetChars | 1500 | 注入文本的字符预算硬顶(200–8000) |
lifecycle.enabled | false | 会话钩子,只注入/审计,绝不删除 |
lifecycle.audit | true | 钩子是否写 lifecycle/attach、lifecycle/detach 事件 |
autoSettleEnabled | false | 自动沉淀总开关;面板「行为设置」可勾,下一轮生效(只写 suggested,见自动沉淀) |
lifecycle.autoSettle.enabled | false | 上面那个开关在 cordis 配置里的落点(面板写 config.json 时以面板为准) |
lifecycle.autoSettle.minIntervalMs | 90000 | 两次尝试的最小间隔(毫秒) |
lifecycle.autoSettle.minMessages | 4 | 会话里至少这么多条用户消息才提炼 |
lifecycle.autoSettle.maxCandidates | 3 | 单次最多沉淀几条 |
会话钩子默认关闭:删除只能通过 forget_memories_by_session 显式触发。
钩子打开也只往 ledger.jsonl 写两条审计事件,不碰任何记忆文件。
lifecycle.enabled / lifecycle.audit 与自动沉淀的间隔、条数阈值只从 cordis 配置读;
自动沉淀的总开关另映射成运行期字段 autoSettleEnabled,面板可改、立即生效(见自动沉淀)。