DSH | Memory Bank | 让助手跨会话记住你的零依赖长期记忆系统

[luoyukun3-oss]

DSH | Memory Bank | 让助手跨会话记住你的零依赖长期记忆系统

非官方项目，由社区成员独立开发和维护。

项目地址

https://github.com/luoyukun3-oss/dsh-memory-bank

项目介绍

给 DSH 里的助手一套跨会话可用的长期记忆：自己记、自己想起来、不撑爆上下文。

纯 Node 标准库实现，零依赖——没有 npm 包、没有编译步骤、没有向量模型（唯一非相对 import 是 Node 自带的 node:sqlite，用来存事件）。

挂上 hook 之后基本不用管：

• 开场自动注入：新会话一开始就带上摘要，包括全局偏好、待办索引、近期事件、重要决策、故障速查、程序记忆、教训索引，一共 13 段，总预算 8000 字。只给目录和路径，细节按需取。
• 每轮自动召回：按当轮提问检索相关记忆，命中才注入，没命中保持安静。
• 后台自动保存：每轮把对话增量写进知识库，限流 90 秒一次，另有计划任务兜底。
• 按仓库隔离：每个工作目录一套独立记忆库，互不污染；跨仓库的偏好单独放一处。

知识页都是普通 Markdown，可以直接用编辑器改。条目可带元数据（重要度 / 来源 / 置信度 / 到期日 / 被谁取代 / 触发词 / 关联边），软遗忘只降权、不物理删文件，历史一直可查。

还附带一批维护工具：教训哑弹审计、关联发现、纠错进候选箱、跨会话交接、体检、行数红线检查，共 28 个 CLI 命令。

与 DSH 的集成方式

通过 @deepseek-ai/dsh-hooks-claude-code 桥接，用一个 bundle 层 patch 挂载，监听四个事件：

• SessionStart：注入 13 段开场摘要
• UserPromptSubmit：按提问召回 + 后台增量保存
• PreToolUse：写文件前提醒行数预算
• PostToolUse：收尾自检与状态更新

数据直接读 DSH 的会话日志（sessions/**/session.v3.jsonl.zstd，多帧 zstd 逐帧解压），增量摄入成知识页与流水——所以它记的是你真实聊过的内容，不需要另外复述一遍。

注入走 hook 的 stdout，同时兼容 agent/inbox/spliced 与 user/message 两种载体。

安装

git clone https://github.com/luoyukun3-oss/dsh-memory-bank
node bank/cli.mjs init
node bank/cli.mjs remember "你的偏好" --page preferences.md
node bank/cli.mjs recall "偏好"

前两行建库，后两行立刻能用。要自动跑就挂 hook，bank/README.md 第八节有完整步骤。

要求 Node ≥ 22.5。

文档

• bank/README.md —— 架构、13 段注入、28 个命令、安装卸载
• bank/FORMAT.md —— 知识页写入格式规范

[QIANLING-0831]

能直接手改 Markdown 很方便。好奇一个冲突场景：后台整理读完一页后，用户又手动改了，最终以哪版为准？如果还没处理，写回前比一下内容哈希，变了就重新读，能避免整理结果覆盖刚写下的纠正。

[luoyukun3-oss]

非常感谢你提出的宝贵的建议
这是我的真实缺陷，我已经实测复现了。

复现（模拟 sync 的「读全文 → 改一节 → 写全文」）：
① 后台读完（拿到快照）
② 用户手动改了另一节
③ 后台在快照上改完写回
⇒ 结果：用户那次编辑被静默覆盖，且无任何提示。

按你提的方案加了写前比对：
读时指纹 007b1c70 ｜ 写前指纹 f6a79846 → 不一致
⇒ 拒绝静默覆盖，重读后在新内容上重做
⇒ 用户编辑保住、后台整理也生效，两个都对。

暴露面我逐个查了：sync 是读全文→替换一节→写全文（最高危）；
ingest 写 journal 是读全文→追加一段→写全文（次之）；
inbox / neg-inbox 是纯追加，风险低。
全库目前没有任何 hash / mtime / 版本号保护。

补充一个我想到的细节：只比 hash 还不够——如果两次读之间文件被改了两次、
又刚好改回原样（比如编辑器保存触发格式归一化），hash 会一致但语义已变。
所以重读后我会再做一次「目标节是否仍是我期望的旧值」的检查，双重确认。

谢谢，这条我记进待办了。

[QIANLING-0831]

看到 safe-write 也补上了，感谢这么细地复现！再加一条并发回归会更踏实：让两个后台任务同时通过写前检查，再各改不同节写回，确认两处都保住。对这些后台写者，检查和写入要在同一把锁内完成，单独多查一次 hash 仍有竞争窗口。

[luoyukun3-oss]

更新（2026-11-09）—— 结构整理 + 一批新能力

■ 按域拆分（新增 42 个模块）
core.mjs 489 → 321 行
mood.mjs 349 → 221
evstore.mjs 294 → 168
index.mjs 160 → 69
test.mjs 439 → 374（拆成 24 个独立测试文件）
现在 bank/ 共 120 个模块 / 19381 行。

■ 新增能力
· cli extract —— LLM 抽取通道：把对话喂给模型抽结构化候选，
带游标 + 分批，失败能从最后成功的批复跑
· cli rel —— 手工编辑条目间关系
· cli rotate —— 备份按数量 / 体积轮转
· cli explain —— 逐条给出命中来源，判不出来的拒绝硬凑
· 索引治理三件套 —— 结构版本自描述 / 写后自检 / 失败率门重建
· config-clamp 值域夹紧 · safe-write 并发安全读改写 · tick 断点日志

■ 数字
CLI 31 个子命令 · 38 个测试文件 · 719 条断言全绿（退出码 0）

■ 一处策略修正
行数预算从「目标值」改成「可读性护栏」：
预算 = max(实测 × 1.2 上取整到十, 200, 原预算)，只放宽不收紧
理由：收紧会让每个文件贴着 90% 运行，改一行又得拆，
把「预防」变成高频劳动。

README 也一并重写了 —— 之前那份还在讲旧版 MEMORY.md 那层，现在以记忆银行为主角。