lazygophers cortex-history-digest
Claude Code 历史 transcripts → 全局记忆库. 扫 ~/.claude/projects/**/*.jsonl 全部 session 历史, 抽学习增量 (用户校正 / 关键决策 / 踩坑 / L0 硬性规则), 经三轴判定路由到 ~/.cortex/.wiki/memory/L0-core | L1-long | L2-mid | L3-short. 默认 --apply 落盘 (--dry-run opt-in 仅出 JSON plan 预览).
破坏性提示：默认
--apply会向全局记忆库落盘 (含 L0-core 项直接落盘, 不再 ask)；只想看计划不落盘时显式传--dry-run。
后台执行段 (cortex-history-worker 执行)
本段由 context: fork 派 cortex-history-worker 后台跑：扫 transcripts，抽学习增量，三轴判定路由，默认 --apply 直接落盘 (含 L0-core 项自动落盘)，落盘后调用 cortex-lint 校 frontmatter 合规。
bash plugins/tools/cortex/scripts/history-digest.sh
bash plugins/tools/cortex/scripts/history-digest.sh --source-root ~/.claude/projects --target $HOME/.cortex
默认 --apply + target=$HOME/.cortex + source-root=$HOME/.claude/projects. --since YYYY-MM-DD 增量过滤 (默认全量). worker 把落盘结果 (正文截前 80 字摘要保护敏感数据 / 各条目目标 level) 作为报告返回主会话。
仅预览 (不落盘) 时显式传 --dry-run：
bash plugins/tools/cortex/scripts/history-digest.sh --dry-run
何时读哪个 reference
| 任务 | 文件 |
|---|---|
| 查 transcripts 目录结构 + jsonl message schema | references/sources.md |
| 查 "学习增量" 识别算法 (用户校正 / 决策 / 踩坑 / L0 关键词) | references/parser.md |
| 查路由到 L0-L4 + 三轴复用 + 敏感保护 | references/routing.md |
入口命令
bash plugins/tools/cortex/scripts/history-digest.sh # 默认 --apply 落盘
bash plugins/tools/cortex/scripts/history-digest.sh --source-root ~/.claude/projects --target $HOME/.cortex
bash plugins/tools/cortex/scripts/history-digest.sh --dry-run # opt-in 预览, 不落盘
默认 --apply + target=$HOME/.cortex + source-root=$HOME/.claude/projects. --since YYYY-MM-DD 增量过滤 (默认全量).
与 cortex-extract 边界
| skill | 数据源 | 落点 |
|---|---|---|
| cortex-history-digest (本) | ~/.claude/projects/**/*.jsonl (Claude Code session 历史) |
仅全局 ~/.cortex/.wiki/memory/ |
| cortex-extract | L4-inbox 内已收件 .md 资料 | L0-L4 + 项目/领域 全模块 |
history-digest 从对话流抽取增量, extract 整理已收件文件 — 互补不重叠.
路径 + 三轴权威
- 路径段 (L0-core / L1-long / L2-mid / L3-short):
../cortex-schema/references/memory-levels.md - 三轴判定 (抗遗忘 / 强度 / 复用面):
../cortex-extract/references/classifier.md(复用算法, 不重写) - 落盘前 lint 检查: 调用
cortex-lintskill (frontmatter 合规校验)
安全
- 正文落盘前截前 80 字摘要进 plan / 报告 (保护敏感数据);
--dry-run仅出 plan 不落盘 - 默认
--apply直接落盘; 需事前审计时显式传--dry-run预览 - L0 候选默认直接落盘 (不再 ask); env
CORTEX_EXTRACT_L0_AUTO=reject可拦核心规则误写 - 不识别字段 skip + warn (transcripts 格式漂移容忍)