ububwudb/dsh-memory-agent ↗★ 1

dsh-memory-agent

File-based long-context memory for DeepSeek Harness: fixed read budget, BM25 hybrid search, confirmation gate, index rebuild, atomic writes and explicit session forget. Zero hard dependencies. 适合需要长期记忆和自动体检清理的复杂对话任务,支持BM25混合检索。

Package
dsh-memory-agent
Compatibility
Unverified
Harness peer range
0.2.1-rc.2
Cordis peer range
~4.0.5
Version
0.1.1
License
MIT
Last updated
Oct 25, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:ububwudb/dsh-memory-agent

体检与使用信号

记忆系统只增不减必然腐化,所以要有「哪条还有用」的证据。这部分判据不是拍脑袋定的, 是参考了社区里迭代过十几个版本的实现(@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 反算。

配置

字段默认含义
rootnull存储根目录;null = /.agent/memory
requireConfirmationfalse写入是否先落 suggested
defaultBudget1200memory_assemble 默认预算(token)
maxTopK200检索硬上限
injectEnabledtrue常驻注入开关;空库时自然什么都不注入
injectBudgetChars1500注入文本的字符预算硬顶(200–8000)
lifecycle.enabledfalse会话钩子,只注入/审计,绝不删除
lifecycle.audittrue钩子是否写 lifecycle/attach、lifecycle/detach 事件
autoSettleEnabledfalse自动沉淀总开关;面板「行为设置」可勾,下一轮生效(只写 suggested,见自动沉淀)
lifecycle.autoSettle.enabledfalse上面那个开关在 cordis 配置里的落点(面板写 config.json 时以面板为准)
lifecycle.autoSettle.minIntervalMs90000两次尝试的最小间隔(毫秒)
lifecycle.autoSettle.minMessages4会话里至少这么多条用户消息才提炼
lifecycle.autoSettle.maxCandidates3单次最多沉淀几条

会话钩子默认关闭:删除只能通过 forget_memories_by_session 显式触发。 钩子打开也只往 ledger.jsonl 写两条审计事件,不碰任何记忆文件。

lifecycle.enabled / lifecycle.audit 与自动沉淀的间隔、条数阈值只从 cordis 配置读; 自动沉淀的总开关另映射成运行期字段 autoSettleEnabled,面板可改、立即生效(见自动沉淀)。