mcsam163/shared-memory-layer

README excerpt

Shared Memory Layer — 多 agent 共享记忆 + 归纳 一个自托管的 多 agent 共享记忆层 ：SQLite KV 事实总线 + refine 式小步归纳 job（含 LLM 精判 + 证据闸）。 为多 agent 体系解决三件事： 1. 共享事实 ：各 agent 读写一个带命名空间隔离、CAS 乐观锁、全量审计的 KV 层 2. 归纳不漂移 ：每日笔记 → 长期记忆，用「watermark 增量 + 按条存储 + 小步 diff + 证据闸」替代整块重写 3. 防幻觉 ：LLM 归纳产出的每一条断言，都要过证据闸（原文支撑校验，宁拦勿放） 架构 快速开始 1. 启动共享记忆层 tokens.json 格式（每个 agent 一个 token，值存 sha256 哈希）： 2. 迁移（可选，v4 新列/新表） 3. 归纳 job（refine 式小步更新） 每日笔记格式（ ./memory/YYYY-MM-DD.md ）： 归纳 job 会把「决策」写入 durable，把「流水」判 noop 丢弃。 核心设计 refine 式小步更新（不是整块重写） - watermark 增量 ：只处理上次之后的笔记，幂等 - 按条存储 ： durable/ / ，每条独立，改动影响面 = 单条 - 小步 diff ：append（新干货）/ replace（同主题更新）/ noop（流水丢弃）/ delete（推翻旧结论） - CAS 乐观锁 ：写前读 version，写回带 expected version，冲突 409 放弃不盲写 5 道闸（写回前校验） 1. schema ：op/target/text 合法 2. 证据真实性 ： evidence item ids 必须指向本批 notes（防伪造） 3. read only / pinned ：豁免条目不覆盖 4. 体积 ：≤80 字 + ≤max bytes 字节 5. LLM 证据闸 （LLM 模式）：断言能否被证据原文支撑，拦幻觉 命名空间写隔离 每个 agent 只能写自己的 namespace，越权 403。 secret 级内容仅用户可写。 目录结构 测试 License MIT 设计背景 这套归纳机制来自一个真实的多 agent 运维/业务协作体系（6 个 agent 共享记忆）。原 v1 每天把近 7 天事件 整块重写 进一个 blob，导致旧结论被冲掉、重复归纳、LLM 幻觉无闸门。v2 用 refine 式小步更新重构，核心不是「换更强的模型」，而是「换更新纪律」——小步、稳定、可回滚。 相关设计文档： v4/ 内的注释与 test v4.py 的用例即规格说明。

Category