分层记忆预算leetom314/dsh-tiered-memory

dsh-tiered-memory

分层记忆 + 预算管理(带每层预算的分层记忆)。
移植 Hermes Agent 的记忆纪律:dsh 生态约 65 个记忆插件全是单层存储,本插件是
分层 + 预算概念的首个实现。

功能说明

三个 tier(user / env / project)+ 每层 char 预算:

- mem_set — 写稳定事实到层(tier + key + content)。同 key upsert。层满拒绝写。
- mem_get — 按 key 精确读。
- mem_query — 语义查询:自动路由到对应层(用户特征词→user,环境词→env,项目词→project),只在档案真有时返回。
- tier_summary — 各层用量 + 驱逐候选(冷/旧条目)。
- mem_delete — 显式删除(淘汰权交模型,不自动删)。

Hermes 纪律的移植点

| Hermes | 本插件 |
|---|---|
| 四层记忆(user/memory/wiki/skills) | 三层 tier(user/env/project),每层预算 |
| 满层拒绝 → 替换/合并 | add 返回 tier full — delete or merge first |
| 只写稳定事实(不写过程) | content 声明式事实,单条 cap(默认 400) |
| 查询时机:只在真有用时查 | mem_query 无命中返回 [],不编造 |
| 淘汰:满了替换/合并 | tier_summary 列候选,mem_delete 显式删 |

验证

单测 node --test(tiers.js 行覆盖 98.5%);真实 headless e2e:
- 三层写入 + 跨层查询路由正确(user→user / env→env,未跨层)
- 预算拒绝闭环:第二写被拒 → tier_summary 看候选 → mem_delete 冷条目 → 重写成功

安装/开发

from GitHub (requires dsh CLI)
dsh plugin --profile web add "github:leetom314/dsh-tiered-memory#main"

or clone and verify locally first
git clone https://github.com/leetom314/dsh-tiered-memory.git
cd dsh-tiered-memory && ./setup.sh && npm test && ./verify.sh   # e2e 隔离 DSH_HOME,不碰真实记忆

verify.sh 动态生成临时 overlay($HERE/index.js 路径),不需要仓库内 overlay 文件——overlay*.yml 已 gitignore(含本机绝对路径,不随版本库分发)。