dsh-tiered-memory

dsh-tiered-memory

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

What it does

三个 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 纪律的移植点

验证

单测 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(含本机绝对路径,不随版本库分发)。