| name | cortex-evolve |
| description | 记忆库升降级维护 — 按金字塔模型 (L4 庞大 → L0 稠密) 自动 promote/demote. 信号: 频率 (近期提及) / 时间 (距今) / 重要度. 规则: 用户反复强调 → 逐级升; L1/L0 允许自动升不允许自动降. 主要工作区 L4-L2; 默认 --apply 落盘 (--dry-run opt-in 预览). 无独立脚本, 调 cortex-extract/save/lint 执行. |
| argument-hint | [--scan|--dry-run|--apply] [--target <vault>] |
| arguments | [--scan|--dry-run|--apply] [--target <仓库根>] |
| user-invocable | true |
| disable-model-invocation | true |
| context | fork |
| agent | cortex-evolve-worker |
cortex-evolve
记忆库跨级再平衡, 按金字塔模型 (L4 庞大 → L0 稠密) 自动 promote/demote 已入 vault 的条目. L0 越少越好, L4 容量大. 与 cortex-extract 边界: extract = L4-inbox 入门级路由; evolve = 已入 vault 后跨级再平衡. 无独立脚本, 步骤指导 main 调 cortex-extract (复用三轴评分) / cortex-save (移动文件) / cortex-lint --fix (frontmatter level 校正).
默认 --apply 落盘 (--dry-run/--scan opt-in 仅出 plan 预览, 不移文件).
破坏性提示：默认 --apply 会移动 vault 内文件 + 改 frontmatter level (含 L1/L0 升级直接落盘, 不再 ask)；只想看再平衡计划时显式传 --dry-run 或 --scan。
后台执行段 (cortex-evolve-worker 执行)
本段由 context: fork 派 cortex-evolve-worker 后台跑：列 vault 全部条目，跑三轴评分算 promote_score/demote_score，按 references/rules.md 阈值默认 --apply 落盘 (调 cortex-save 移文件 + cortex-lint --fix 校 frontmatter level)。
- 列条目: 列 vault
memory/L0-core ~ memory/L4-inbox 全部条目
- 评分: 跑三轴 →
promote_score / demote_score (复用 cortex-extract 三轴模式)
- 落盘: 按
rules.md 对达阈条目移文件 + 校 level (L1/L0 升级与跳级直接落盘, 不再 ask)
- 报告: 输出再平衡结果 (file / current_level → proposed_level / score / reason) 返回主会话
仅预览 (不移文件) 时显式传 --dry-run 或 --scan，输出升降级 JSON plan。
速查表
| 触发 | 条件 | 行为 |
|---|
| 升级 (主) | promote_score ≥ 阈 (各级不同) | 移文件 + 改 frontmatter level |
| 降级 (主) | demote_score ≥ 0.7 + 30d 未访问 (仅 L2→L3) | 移文件 + 改 level |
| 用户反复强调 (≥ 3) | "永远/硬性" 多次 | 跳级允许 (L3→L1 直跳) |
| L1/L0 自动升 | 从 L2/L1 promote | 允许 (默认直接落盘) |
| L1/L0 自动降 | 任何信号 | 禁 (仅标 audit-candidate, 用户显式 forget 才动) |
| L1/L0 直接写新 | 非 promote 路径 | 默认直接落盘 (走 save 路径) |
| L0 audit | 条目数 > 20 | lint warn (事后审计兜底) |
适用范围
- 自动双向: L3 ↔ L2 (主要工作区)
- 自动升单向: L2 → L1 → L0 (默认直接落盘, 仅标 audit-candidate 供事后审)
- 自动降禁止: L1 / L0
- 不在范围: L4 → L3 (走
cortex-extract); 一次性写入 (走 cortex-save)
路由表 (3 references)
| 任务 | 文件 |
|---|
| 查三轴信号 (频率/时间/重要度) 定义 + 计算公式 + 综合得分 | references/signals.md |
| 查升降级各级阈值 + 5 修饰规则 + 金字塔约束 + 适用范围速查 | references/rules.md |
| 查 5 步执行流程 + dry-run JSON schema + 边界 vs extract/save | references/workflow.md |
执行入口
无独立脚本。扫描+评分+默认 --apply 落盘在 worker 后台段 (移文件 + 校 level)；--dry-run/--scan opt-in 仅出 plan (详见 references/workflow.md 流程)。
引用
- 5 级路径与 frontmatter 模板:
cortex-schema
- 三轴评分原型 + L4-inbox 路由:
cortex-extract
- 一次性写入 (新条目):
cortex-save
- frontmatter level 校正 + L0 audit warn:
cortex-lint
