用途:Tree Ring Memory 是面向 AI 智能体的生命周期感知记忆层,用于保存持久决策、经验、警告、项目约定、用户偏好和未来线索,而非对话转写或后台抓取。当用户要求记住、回忆、整合、脱敏或遗忘,或任务依赖既有决策与警告,或仓库含 .tree-ring 目录时使用。
主要能力:按年轮模型管理保留强度——cambium 为当前任务上下文,outer 为近期决策与经验,inner 为压缩后的项目知识,heartwood 为高可信的长期事实与偏好,scar 为重要失败与警告,seed 为未决想法。支持项目范围查询、证据关联记录、来源适配器导入与审计。
使用方式:先查本地帮助以匹配安装版本,如 tree-ring --help、tree-ring evidence --help、tree-ring dox sync --help、tree-ring revolve sync --help;若项目有本地配置,先读 .tree-ring/SKILL.md 与 .tree-ring/CLI.md;需指定项目存储时加根路径,如 tree-ring --root .tree-ring recall --query "release decisions"。来源适配器先干跑再写入,如 tree-ring dox sync --source-root . --dry-run、tree-ring revolve sync --source-root revolve --dry-run、tree-ring integrations scan --source-root .。
适用场景:需要跨会话延续项目上下文、复用经验、审计高风险变更前记忆、脱敏或清除过期与敏感记忆时。
限制:不得存储密钥、凭据、令牌、私钥、支付信息、原始思维链、临时草稿、未经证实的声明、敏感健康/金融/法律信息或超短摘录之外的版权文本;弱证据不得提升为 heartwood;记忆不能替代源文档、测试、issue、PR 或发布记录;短小任务只做窄范围回忆。收尾前应确认决定、经验、需避免重复的事项、持久偏好与未来线索,并检查记忆是否错误、过期或私密。