用途：Tree Ring Memory 是框架无关、本地优先的智能体记忆生命周期层，用于在恢复项目、变更架构/存储/安全/发布，或用户要求记住、回忆、审计、脱敏、遗忘、合并记忆时使用。它不把原始对话记录当记忆，而是保存持久化的项目知识。
主要能力：公开运行时是 Rust CLI/TUI，使用本地 SQLite/FTS 存储，支持限定范围的回忆（recall）、证据记录（evidence）、审计（audit）、确定性合并、维护、DOX/Revolve 源适配器、框架发现、脱敏与显式遗忘，并用树轮分层：cambium（当前任务）、outer（近期决策与教训）、inner（压缩的旧项目知识）、heartwood（高置信持久事实）、scar（失败与回归）、seed（未解决想法）。
使用方式：先发现本地指引，如 test -f .tree-ring/SKILL.md 与 .tree-ring/CLI.md，并优先遵循项目本地文件；CLI 已安装时可运行 tree-ring --help、tree-ring recall --help 等查看命令面。未安装时应定位项目根，说明下载内容，经用户明确批准后下载版本锁定的 v0.15.0/install.sh，校验 SHA-256 为 ef0d5eb8f09cbe2e4c3abe80ee9a98a56759c89ad4ddd103d6c68314cd653ade 并检查后再运行：sh <verified-installer-path> --project --init --release v0.15.0 --no-animation。切勿把网络响应直接管道给 shell。回忆使用窄范围查询如 tree-ring recall "release behavior" --project example-service；只写持久记忆如 tree-ring remember "..." --event-type lesson --scope project；对已评估结果记录证据如 tree-ring evidence "..." --outcome observed --evidence-ref "ci/install-smoke/2026-07-08"，结果类型包括 promoted、rejected、deferred、observed。源适配器先 dry-run：tree-ring dox sync --source-root . --dry-run、tree-ring revolve sync --source-root revolve --dry-run、tree-ring integrations scan --source-root .。
适用场景：恢复项目前、风险变更前、测试与复盘后、存在 .tree-ring 桥接文件时。
限制：它不替代源码控制、issue 跟踪、文档、测试、日志或运行时验证；回忆内容可能过时或错误，需用当前源码与运行状态核实；CLI 命令面可能随版本变化，应以本地指引和 --help 为准。不得用于密钥存储、完整对话归档、合规留存或未经审查的敏感个人数据收集；不存密钥、凭据、令牌、私钥、恢复码、原始思维链或临时草稿，不存超出允许摘录的受版权文本。执行安装、网络、破坏性或变更命令须获明确批准。跨智能体互操作取决于各工具能否调用本地 CLI 或读取项目本地指引。相关技能包括 @agent-memory-systems、@agent-memory、@planning-with-files。