核心用法
memory-management 实现了一套完整的三级记忆生命周期系统（HOT/WARM/COLD），专为SEO/GEO长期战役设计：
- HOT层：
memory/hot-cache.md，最多80行，SessionStart钩子自动加载，存放当前优先关键词、核心竞品、活跃campaign - WARM层：各主题文件按需加载，通过Wiki索引快速定位，包含决策记录、开放问题、术语表、实体库等
- COLD层：
memory/archive/归档历史数据，仅显式查询时检索
关键操作路径：
1. 初始化：Refresh wiki index生成索引，Set up SEO memory for [project]创建目录结构
2. 日常更新：竞品分析后Refresh hot cache、关键词检查后用CSV记录排名历史
3. 查询检索：四层查找（HOT→Wiki索引→术语表→COLD归档），未命中则询问用户并记录新术语
4. 升降级管理：高频引用自动提升热度，30天未引用标记降级，90天归档
显著优点
- 跨会话连续性：通过Hooks机制（SessionStart加载热缓存、PostToolUse静默刷新索引）实现"断点续传"
- 智能分层：自动化的温度生命周期规则减少手动整理负担
- 多IDE兼容：支持Claude Code、Cursor、Windsurf、Gemini CLI等9种主流AI编程环境
- 多语言原生支持：中英日韩葡五语言触发词，国际化团队友好
- 审计追踪：v7.1.0+支持auditor handoff结构化归档，v8.0.1+决策来源标记（user-approved vs advisory）
- 合规内置：GDPR/CCPA删除流程
purge <entity>，自动日志记录与跨文件引用提示
潜在缺点与局限
- 冷存储检索成本：COLD层查询需用户显式发起，历史数据复活依赖人工判断
- 并发访问风险：文档未说明多用户/多会话同时写入的冲突解决机制
- 数据新鲜度：自动降级基于时间而非内容变化，可能误伤仍有效但低频引用的策略
- Wiki编译性能：大规模项目下
memory/wiki/index.md自动刷新可能成为瓶颈 - 法律免责声明：GDPR合规功能标注"Not legal advice"，企业用户仍需法务审核
适合人群
- SEO/GEO项目经理：需要追踪6-12个月长周期战役，跨多次会话保持上下文
- 多客户代理团队：通过
memory/<project>/子目录隔离客户数据，配合实体级删除满足合规 - 内容运营与审计人员：利用decisions.md和open-loops.md管理待办与已决事项
- 跨国团队：多语言触发词降低使用门槛
常规风险
| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| **数据残留** | `memory/archive/`永不自动删除，Art 17请求需手动执行purge | 建立季度审计流程 |
| **决策误用** | `approved_by: skill_inferred`的条目被当作权威依据 | 养成习惯确认"user-approved"标记 |
| **热缓存膨胀** | 超80行或25KB未自动截断，仅警告 | 定期运行`cleanup`指令 |
| **隐私泄露** | 第三方个人数据（创始人、作者）可能无意入库 | 写入entities前确认lawful basis |
| **钩子失效** | 非Claude Code环境可能不支持全部hook行为 | 优先使用官方兼容IDE |
版本与生态
- 当前版本：9.9.5（Apache-2.0）
- 上游依赖：与8个技能深度集成（keyword-research、rank-tracker、competitor-analysis等）
- 下游触发：通常作为战役启动后的首个技能，随后衔接keyword-reresearch刷新策略