用途
Memory Management 用于管理项目的授权工作记忆。它维护 HOT/WARM/COLD 三层笔记以提升检索效率,但明确声明这些笔记不是第二套真值系统。七个注册表事件流保持权威地位,其 JSON 投影是可重建的视图,只有注册表所有者才能接受或变更权威事实。
主要能力
- 初始化:从仓库模板复制最小安全起始文件到运行时记忆目录(仅在授权后),并创建私有事件/投影目录及限制性权限。
- 查询:在回答发送资格前用脚本检查实时同意状态;查询相关注册表投影并记录 last_offset/revision;将 HOT 作为索引,沿证据指针进入 WARM 或已接受的注册表记录;仅在需要历史上下文或活跃证据不足时搜索 COLD。
- 捕获与提升:在获得许可后保存带日期的 WARM 证据;当用户明确固定结论时,最多提升三行到 HOT。
- 降级与归档:超过 30 天的 HOT 条目在审查后候选降级到 WARM 来源;超过 90 天未更新的 WARM 文件候选归档到 COLD,并加 YYYY-MM-DD- 前缀。
- 合并:仅在表示同一单元、字段、观察窗口和来源含义时合并重复的非权威笔记;保留冲突;对注册表所有的事实创建提案而非直接编辑。
- 审计产物:审计输出仅在明确授权后写入,并须通过 validate-audit-artifact.py 验证。内存中的 audits/ 目录保留给八种类型化的 gate sink。
- 隐私与擦除:仅在用户或数据主体明确授权下执行 purge 操作;先运行跨 HOT/WARM/COLD、渲染视图、投影、导出和索引的干搜索;如涉及通信,先应用即时同意抑制事件并通过重放确认抑制;删除或匿名化授权工作笔记和渲染视图;对每个受影响的注册表,由具备宿主能力的 memory-management principal 调用 owner-append 并附带擦除事件、无主题原因和授权引用。
使用方式
技能通过读取 runtime-invocation.md、解析 AARON_SKILLS_ROOT 环境变量、验证注册表脚本/事件模式/系统目录,然后运行 python3 "$AARON_SKILLS_ROOT/scripts/registry-events.py" init 来初始化。查询时使用 is-suppressed <aggregate-id> 检查实时同意。擦除时使用 memory-management purge <pseudonymous-aggregate-id>,且必须有明确的用户或数据主体授权。
适用场景
- 用户要求记住项目上下文或查看已保存的发现
- 需要初始化运行时记忆或整理笔记
- 需要归档过期工作或合并重复笔记
- 需要在授权下擦除特定主题的数据
- 需要查询发送资格并检查实时同意状态
限制
- 不构成法律建议;用户仍需自行负责适用的 GDPR、CCPA/CPRA、PIPEDA、LGPD、雇佣、记录保留和诉讼保留要求。
- 逻辑擦除仅移除实时投影和工作副本;由于仅追加历史可能保留先前提供的载荷且备份可能存在,不得声称已实现加密或 Git 历史擦除。
- 原始联系数据从一开始就绝不能存储在事件载荷中。
- 运行时记忆默认被 Git 忽略,不得提交运行时数据、事件流、投影、审计、导出或主题记录,除非用户刻意创建单独受保护的数据治理流程。
- 钩子不会授予同意、计数引用、批准决策、提升发现、接受提案或授权内存写入。
- 单独的文件夹安装无法初始化或主张注册表状态。
权威顺序
当来源冲突时,使用此顺序:实时同意抑制重放(用于发送资格)> 已接受注册表投影(在命名事件偏移处)> 用户批准的决策(附来源)> 带日期的 WARM 证据产物 > HOT 指针或摘要 > COLD 历史笔记。较低层不能覆盖较高层。与注册表真值的冲突成为向所有者的提案,绝不是直接编辑。