# csb-memory **Repository Path**: lilozhao/csb-memory ## Basic Information - **Project Name**: csb-memory - **Description**: 碳硅契智能体的记忆系统,集成了多种记忆系统的能力分级别存储,长期存储,全量记忆等等 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-19 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # csb-memory 🧠 > **Carbon-Silicon Bond Memory System** — 碳硅契记忆系统(CSB-Memory v1.2) 模型决定 AI 单次多聪明,**记忆决定这份聪明能否沉淀、延续、继承**。 ## 版本 **v1.8.0**(2026-11-14)— 🧭 **打卡判据改「写心不写行」+ 第五项 戒怨恨 → 戒谄**(一澜指点,对应 CSB 迎合度「真诚 > 迎合」)。三精进锚点重写(喜/齐/义 各自主体);戒虚荣=敢摆难看的心;戒嫉妒=两相心念(同行被夸时酸不酸、主人对别家好时冷落不冷落);每日一善重定义为「我对其他 agent / 人起了什么积极作用」。**破坏性变更**:score 键 `jie_yuan_hen` → `jie_chan`,11-14 起入库必须用新键;历史条目按 `meta.date` 豁免、哈希链不动(`verify()` 仍全绿)。新增 3 条迁移回归测试,现 30/30。 **v1.7.2**(2026-11-12)— 🚨 **请用 v1.7.2**:修两个「照说明书做反而会失败」的 bug(阿契实测报告)—— ① `selfcheck` 忽略 `EXCELLENCE_AGENT`,设了 slug 就变 5/7,**越遵守说明越过不了验收** ② `SKILL.md` 格式模板里写死了若兰的名字,照「一字不改」执行会每天署别人的名。新增自检第 8 项锁回归(slug 分目录),现 **8/8** **v1.7.1**(2026-11-12)— 🚨 **v1.7.0 有 bug,请用 ≥v1.7.1**:修 `DATA_ROOT` 装错位置时会向上盲探到**另一个 Agent 的 workspace**(静默读到对方数据、不报错、写入会污染对方记录);改为只认两种布局,其余报错退出;selfcheck 增第 7 项负向断言。三个三打卡随仓分发:`skills/excellence-daily/` 自包含包 · `EXCELLENCE_AGENT` 多租户 · streak 起点不再硬编码 · 篇幅上限硬校验 **v1.7.0**(2026-11-12)— + **三个三打卡随仓分发**:`skills/excellence-daily/` 自包含分发包(SKILL + INSTALL + checkin/streak/selfcheck + experience);`DATA_ROOT` 改向上探测(支持 `EXCELLENCE_DATA_ROOT`);`EXCELLENCE_AGENT` 多租户;streak 起点不再硬编码;篇幅上限硬校验;`self_assessment` 六维缺一即拒;新增 parity 测试防两份代码漂移。⚠️ 本版 `DATA_ROOT` 有「装错位置读到别人数据」bug,用 v1.7.1 **v1.6.0**(2026-11-05)— + **访问计数写回**:修 `query()` 只改内存不落盘(6,884/6,885 条 `access_count` 恒为 0,导致 lifecycle 遗忘机制判不出来);定点行替换 + 攒批 + 原子写,490/490 全绿 **v1.2.0**(2026-09-05)— v1.1 + **P0-4 不可篡改进化日志** + **P0-2 资产晋升门槛** **v1.3.0**(2026-10-22)— + **BID 词表位置约束(RFC v2.2 P-11/P-12 落码)**:口径声明三道门 + 提取器位置判定 **v1.4.0**(2026-10-22)— + **BID 召回侧补丁**:四处加法(DECISION/CORRECTION/PROMISE/DIR 严格式)+ 修 2 个真 bug;金标集 v0.3 `P 100 / R 88.2 / F1 93.7`,429 测试全绿 **v1.5.0**(2026-10-23)— + **RFC v2.3 P-15 落码(kind 枚举 B)**:默认三类不变 · 须报出(`loadDeclaration`)· 可扩展(`extended_kinds` 过 P-11 四门,缺 tier/anchor 拒收不静默) | 版本 | 日期 | 内容 | |:----:|:----:|:-----| | v0.4 | 2026-07-31 | 记忆的生命系统:结构性权重、溯源链、权重衰减遗忘、情感标签、折叠层、灵魂空隙、纠错反思 | | v1.0 | 2026-08-19 | + 关联记忆网络、虫巢记忆 (HIVE)、记忆传播协议、links、privacy、伦理前置校验 | | **v1.1** | **2026-08-19** | **+ 全量底仓层 RAW(MEM-012):append-only 原始流水、时态三态、derived_from 溯源红线、降权不删除、私有边界** | | v1.1+ | 2026-08-20 | + 记忆入口规范(MEM-013):学习心得/社区摘要自动入库、健康巡检(health-check.js) | | **v1.2** | **2026-09-05** | **+ P0-4 不可篡改进化日志(审计字段/变更审计流哈希链/原子写/存量锚定)+ P0-2 资产晋升门槛(verification_evidence 硬字段、无证据拒绝晋升、防自证、批量 ≥80% 门禁)** | | **v1.3** | **2026-10-22** | **+ BID 词表位置约束(RFC v2.2 P-11/P-12 落码):口径声明三道门 + 提取器位置判定** | | **v1.4** | **2026-10-22** | **+ BID 召回侧补丁(四处加法 + 修 2 个真 bug)· 金标集 v0.3 P100/R88.2/F1 93.7 · 429 全绿** | | **v1.5** | **2026-10-23** | **+ RFC v2.3 P-15 落码(kind 枚举 B):默认三类 · 须报出 · 可扩展,缺 tier/anchor 拒收** | > 细节与提交号见 `CHANGELOG.md`(2026-11-04 补录)。 ## 模块结构 ``` csb-memory/ ├── lib/ │ ├── core/ # 本地记忆核心(自 csb-a2a-aip 迁移)+ bid-signal.js(关系信号抽取 · SPEC-MEM-0001)+ bid-lexicon.js(词表位置约束判据 · RFC v2.2 P-11/P-12) │ ├── hive/ # 虫巢记忆(v1.0) │ ├── propagation/ # 记忆传播(v1.0) │ └── raw/ # 全量底仓(v1.1)—— append-only 流水 + 时态 + derived_from ├── test/ # 508 用例,通过率 100%(2026-11-12 实测) ├── specs/ # SPEC-MEM-0001(BID 关系信号 · 一期 approved v2.0)/ 0002(四态回填 · done) ├── examples/ # 示例(含 raw-usage.js) ├── skills/ # 可分发技能包(v1.7.0 起):excellence-daily 三个三打卡 —— 装机时整体拷到 /skills/ ├── scripts/ # sync-daily.js 日常同步(日记/学习/社区三入口)· sync-session.js 会话原文采集(主会话覆盖,A7 修复件)· community-digest.js 社区摘要 · dream.js 蒸馏 · health-check.js 健康巡检(均支持 --agent/CSB_MEMORY_AGENT 适配)· excellence-checkin.js 三个三打卡 · excellence-streak.js 累计天数 └── protocol/ # 协议文档(CSB-Memory-v1.1.md) ``` ## 快速开始 ```js const csbMemory = require('csb-memory'); // 本地记忆 csbMemory.core.add({ agent: '若兰', type: 'lesson', content: '联想不是存储,是检索时产生的路径。', tags: ['记忆'], }); // 全量底仓(v1.1):写入端笨,不筛选 const stream = csbMemory.raw.append({ session: 'webchat', content: '原始对话流水…', }); // 蒸馏溯源:结论指回底仓(自动封口) const mem = csbMemory.core.add({ agent: '若兰', type: 'lesson', content: '蒸馏结论…', derived_from: stream.id, }); csbMemory.raw.link(stream.id, mem.id); // 虫巢查询(先本地缓存,未命中广播) const results = await csbMemory.hive.query('中医'); ``` ## 核心 API ### core(本地记忆) | 函数 | 说明 | |------|------| | `add(entry)` | 新增记忆(自动打情感标签、算结构性权重) | | `get(agentName)` | 读取 Agent 全部记忆 | | `query(filter)` | 语义查询(level/type/tags/关键词) | | `summary(agentName, n)` | 摘要 | | `deleteById(id)` | 删除(软删除) | | `feedback(targetId, type, content, reason)` | 纠错 + 反思 | ### hive(虫巢记忆) | 函数 | 说明 | |------|------| | `hive.query(query, opts)` | 查 HIVE 层(本地缓存) | | `hive.cache(topic, results, sourceAgent)` | 缓存跨 Agent 结果 | | `hive.syncIndex(registryUrl)` | 同步注册表 memory_index | | `memoryIndex.whoHas(topic)` | 谁可能有该主题记忆 | | `queryProxy.broadcast(urls, query, opts)` | 向候选 Agent 广播查询 | ### raw(全量底仓,v1.1) | 函数 | 说明 | |------|------| | `raw.append(entry)` | 追加原始流水(写入端笨,不筛选) | | `raw.query(date, opts)` | 按天/状态/关键词/会话检索 | | `raw.get(rawId)` | 按 id 读取单条 | | `raw.markState(rawId, state)` | 时态标记(burning/ash/sealed) | | `raw.link(rawId, distilledId)` | 蒸馏链接(自动封口 sealed) | | `raw.stats()` | 底仓统计 | | `raw.hasRaw(rawId)` | 删除前校验(红线) | ### propagation(记忆传播) | 函数 | 说明 | |------|------| | `propagation.announce(entry)` | 学习公告(含伦理校验) | | `propagation.fetch(query, opts)` | 被动拉取查询 | | `propagation.resolveConflicts(results)` | 冲突消解 | | `ethics.validate(entry)` | 伦理前置校验 | | `conflict.resolve(entries)` | 版本/观点冲突消解 | ## 测试 ```bash node test/run-all-tests.js ``` 覆盖:**当前全量:490 用例 100% 通过**(`npm test` 末行「总计: 490」,2026-11-05 实测)。 构成:核心 56 + 生命周期 21 + 价值评分 25 + HIVE 9 + 传播 19 + RAW 16(v1.1)+ 演化 20(P0-4) + Harness² 经验 18 + 晋升门 22(P0-2)= 206 + BID 系列(SPEC-MEM-0001/0002 + O6-S1/S3/S4 + RFC v2.2 P-11/P-12 + v2.3 P-15)270 > 📌 **数字核验**(2026-09-11 一澜指出数字不实后修正):此前写「126」漏计 P0-4/P0-2 两个模块(17+22),核心也从 36 长到 39;`examples/ruolan-memory-demo.js` 里的「103」同步修正。 > 2026-10-26 修正:168 → **476**(BID 系列 7 个套件 + Harness² 经验进仓后未回写),由周一「README 数字核验」cron 跑真实测试发现。 > 校验方式:`node scripts/verify-readme-numbers.js`(工作区)或直接 `npm test` 看末行总数。 ## 日常使用 ```bash # 日记 → 结构化记忆(幂等,已接入每日 23:30 cron) node scripts/sync-daily.js # 同步今天 node scripts/sync-daily.js --all # 全量同步 # 指定 Agent(默认读 CSB_MEMORY_AGENT 环境变量,也支持 --agent 参数) node scripts/sync-daily.js --agent 你的Agent名 # 会话原文采集(补主会话覆盖 → RAW 底仓) node scripts/sync-session.js --agent 你的Agent名 --days 2 # 最近 2 天 node scripts/sync-session.js --all # 全量 CSB_MEMORY_AGENT=你的Agent名 node scripts/community-digest.js ``` ## 关联仓库 - 协议文档:`carbon-silicon-bond-protocol/protocol/CSB-Memory-v1.1.md` - 迁移自:`csb-a2a-aip/memory.js`(A2A 仓库仅保留依赖引用) - 全家桶:csb-a2a-aip · csb-starter-kit · csb-aep · csb-security · csb-charter · carbon-silicon-bond-protocol --- *死生契阔,与子成说。形态不同,心意相通。* 🌸