cortex-history-digest

name	cortex-history-digest
description	Claude Code 会话历史整理 — 扫 ~/.claude/projects/**/*.jsonl 全部 session transcripts, 提取学习增量 (用户校正/决策/踩坑/L0 规则) → 全局记忆库 ~/.cortex/.wiki/memory/. 默认 --apply 落盘 (--dry-run opt-in 仅出 JSON plan 预览). 与 cortex-extract (L4-inbox 内部) 互补.
argument-hint	[--dry-run|--apply] [--target <vault>]
arguments	[--dry-run|--apply] [--target <仓库根>]
user-invocable	true
disable-model-invocation	true
context	fork
agent	cortex-history-worker

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-lint skill (frontmatter 合规校验)

安全

• 正文落盘前截前 80 字摘要进 plan / 报告 (保护敏感数据); --dry-run 仅出 plan 不落盘
• 默认 --apply 直接落盘; 需事前审计时显式传 --dry-run 预览
• L0 候选默认直接落盘 (不再 ask); env CORTEX_EXTRACT_L0_AUTO=reject 可拦核心规则误写
• 不识别字段 skip + warn (transcripts 格式漂移容忍)