Paired: GitHub #405 ↔ GitCode #223
🚀 背景描述
背景描述
1、监管驱动：上级对部署记忆服务有安全审查要求。金监总局《指导意见》与 9 月发布的《人工智能安全治理框架 3.0》均明确提出"记忆安全"相关要求，记忆系统作为智能体的长期状态载体，已纳入AI 应用安全审查范围。
2、当前记忆服务（V0.2.0beta）已提供初步生命周期管控能力如删除与批量删除接口等提供，但存在如下问题
（1）无留存期限管理：长期记忆无限期留存，超出"实现处理目的所必要的最短时间"，不满足个人信息存储期限最小必要原则；两份发文均要求数据/记忆全生命周期管控（留存期限、到期删除、下线销毁），无限期留存无法通过安全审查
（2）无过期清理与淘汰机制：当前记忆遗忘仅对记忆打标记，被标记记忆不被 search/list 返回但不删除，软标签持续增加存储膨胀；随记忆条数增长，单用户匹配 topK 含过期记忆，出现性能劣化、卡顿甚至 OOM 风险
（3）无下线清理能力：记忆模块停用/卸载后，KV 与文件系统中的记忆数据、索引与备份（含个人金融信息）继续残留，形成停用下线后的数据存留，存在泄露风险与审查不通过风险
设计思路
（1）留存期限配置化：基于配置参数管理记忆文件与数据，支持全局默认策略（长期记忆默认保存时间 1 年），支持按租户/空间/记忆类型覆盖配置；记忆写入时记录过期时间等留存元数据；
（2）定期清理与过期淘汰：后台定期扫描超过保存周期的记忆，按策略执行物理删除（或转归档），优先淘汰重要性低、过期时间长的记忆；清理后执行存储碎片整理，保证服务不劣化
（3）卸载全量清理：提供卸载/下线场景的一键清理能力，清除所有记忆数据/文件（KV、文件系统、向量索引、备份），防止停用下线的数据存留；清理完成后输出清理报告并提供残留校验，防漏删；
涉及到的对外API
新增留存策略配置接口、过期记忆清理任务触发与结果查询接口、卸载全量清理接口（含清理报告）；变更记忆写入接口（记录留存期限/过期时间元数据）。
与其他模块的相关性描述
影响记忆写入模块（留存元数据）、记忆召回模块（超期记忆过滤）、存储模块（物理删除与碎片整理）
测试设计与测试计划
1、正确性：留存期限边界（到期/未到期/覆盖配置）淘汰正确性，已淘汰记忆不再被召回返回；
2、性能基线：百万级记忆规模下过期扫描与物理删除开销、碎片整理后性能恢复基线；
3、彻底性：卸载清理后对 KV、文件系统、向量索引、备份的全量残留扫描验证；
4、联动：清理/销毁动作审计留痕验证、配置化策略生效测试。
其他信息
感谢您的贡献 🎉!
Paired: GitHub #405 ↔ GitCode #223
🚀 背景描述
背景描述
1、监管驱动：上级对部署记忆服务有安全审查要求。金监总局《指导意见》与 9 月发布的《人工智能安全治理框架 3.0》均明确提出"记忆安全"相关要求，记忆系统作为智能体的长期状态载体，已纳入AI 应用安全审查范围。
2、当前记忆服务（V0.2.0beta）已提供初步生命周期管控能力如删除与批量删除接口等提供，但存在如下问题
（1）无留存期限管理：长期记忆无限期留存，超出"实现处理目的所必要的最短时间"，不满足个人信息存储期限最小必要原则；两份发文均要求数据/记忆全生命周期管控（留存期限、到期删除、下线销毁），无限期留存无法通过安全审查
（2）无过期清理与淘汰机制：当前记忆遗忘仅对记忆打标记，被标记记忆不被 search/list 返回但不删除，软标签持续增加存储膨胀；随记忆条数增长，单用户匹配 topK 含过期记忆，出现性能劣化、卡顿甚至 OOM 风险
（3）无下线清理能力：记忆模块停用/卸载后，KV 与文件系统中的记忆数据、索引与备份（含个人金融信息）继续残留，形成停用下线后的数据存留，存在泄露风险与审查不通过风险
设计思路
（1）留存期限配置化：基于配置参数管理记忆文件与数据，支持全局默认策略（长期记忆默认保存时间 1 年），支持按租户/空间/记忆类型覆盖配置；记忆写入时记录过期时间等留存元数据；
（2）定期清理与过期淘汰：后台定期扫描超过保存周期的记忆，按策略执行物理删除（或转归档），优先淘汰重要性低、过期时间长的记忆；清理后执行存储碎片整理，保证服务不劣化
（3）卸载全量清理：提供卸载/下线场景的一键清理能力，清除所有记忆数据/文件（KV、文件系统、向量索引、备份），防止停用下线的数据存留；清理完成后输出清理报告并提供残留校验，防漏删；
涉及到的对外API
新增留存策略配置接口、过期记忆清理任务触发与结果查询接口、卸载全量清理接口（含清理报告）；变更记忆写入接口（记录留存期限/过期时间元数据）。
与其他模块的相关性描述
影响记忆写入模块（留存元数据）、记忆召回模块（超期记忆过滤）、存储模块（物理删除与碎片整理）
测试设计与测试计划
1、正确性：留存期限边界（到期/未到期/覆盖配置）淘汰正确性，已淘汰记忆不再被召回返回；
2、性能基线：百万级记忆规模下过期扫描与物理删除开销、碎片整理后性能恢复基线；
3、彻底性：卸载清理后对 KV、文件系统、向量索引、备份的全量残留扫描验证；
4、联动：清理/销毁动作审计留痕验证、配置化策略生效测试。
其他信息
感谢您的贡献 🎉!