把 Codex CLI 历史会话提炼进 Obsidian…

当你想从过去的 Codex 会话日志中挖掘可复用知识并沉淀到 Obsidian wiki 时使用。

适用场景

解决思路

1. 先解析配置：按 llm-wiki/SKILL.md 的 Config Resolution Protocol 解析配置（内联 @name 覆盖 → 从 CWD 向上查找 .env → 全局配置 → 提示设置），得到 OBSIDIAN_VAULT_PATH 和 CODEX_HISTORY_PATH（默认 ~/.codex）。
2. 读取 vault 根目录的 .manifest.json 检查已导入内容，再读取根目录 index.md 了解 wiki 现有内容。
3. 选择导入模式：Append 模式（默认）只处理 manifest 中不存在的新文件，或修改时间晚于 manifest 中 ingested_at 的文件；Full 模式忽略 manifest 处理全部内容，用于 wiki-rebuild 之后或用户明确要求全量重导。
4. 了解 Codex 数据布局：~/.codex/ 下有 sessions/YYYY/MM/DD/rollout-<timestamp>-<id>.jsonl、archived_sessions/、session_index.jsonl、history.jsonl、config.toml 以及 state_*.sqlite / logs_*.sqlite。
5. 按价值排序数据源：1) session_index.jsonl 用于 ID、标题、新鲜度清单；2) sessions/**/rollout-*.jsonl 为丰富的结构化转录事件；3) history.jsonl 作为启用时的回退/时间线辅助。除非用户明确要求，不要导入 SQLite 内部数据。
6. 扫描 CODEX_HISTORY_PATH 并与 .manifest.json 对比：检查 ~/.codex/session_index.jsonl、~/.codex/sessions/**/rollout-*.jsonl、可选的 ~/.codex/archived_sessions/**（仅当用户要求归档历史）、可选的 ~/.codex/history.jsonl。将每个文件分类为 New（不在 manifest）、Modified（在 manifest 但文件新于 ingested_at）、Unchanged（已导入且未变），深度解析前先报告简洁的增量摘要。
7. 先解析 session_index.jsonl（条目形如 {"id":"...","thread_name":"...","updated_at":"..."}），用于构建规范会话清单、优先处理近期/高信号会话、把 rollout ID 映射为可读线程名。
8. 安全解析 rollout JSONL：每行是事件信封 {"timestamp":"...","type":"session_meta|turn_context|event_msg|response_item","payload":{...}}。优先提取用户意图和助手可见输出，优先 response_item 中的用户/助手消息内容，选择性使用 event_msg 捕捉有意义的里程碑，忽略纯遥测，把 session_meta 当作元数据（cwd、model、ids）而非用户知识。
9. 应用跳过/噪声过滤：跳过 token 计费事件、无语义内容的工具管道、不含可复用决策/模式的原始命令输出、不增加新决策的重复计划快照。
10. 应用关键隐私过滤：不要逐字导入系统/开发者提示或机密；移除 API key、token、密码、凭据；除非相关且获批准，否则对私人标识符做脱敏；用摘要代替引用原始转录。
11. 按主题聚类，不要每个会话建一个 wiki 页面：跨多个会话按稳定主题分组，把混合会话拆分为独立主题，跨日期/项目合并重复概念，用元数据中的 cwd 推断项目范围。
12. 按现有 wiki 约定路由知识：项目特定架构/流程 → projects/<name>/...；通用概念 → concepts/；重复技术/调试手册 → skills/；工具/服务 → entities/；跨会话模式 → synthesis/。为每个受影响项目创建/更新 projects/<name>/<name>.md（文件名用项目名，绝不用 _project.md）。
13. 遵守写作规则：提炼知识而非时间线；避免“在 X 日我们讨论了……”除非日期上下文必要；每个新建/更新页面加 summary: frontmatter（1-2 句，≤200 字符）；每个新页面加 confidence 与 lifecycle 字段（base_confidence: 0.42、lifecycle: draft、lifecycle_changed: <今天 ISO 日期>），更新时保持 lifecycle 不变；加 provenance 标记 ^[extracted]（直接基于明确会话内容）、^[inferred]（跨事件/会话综合模式）、^[ambiguous]（会话冲突）；为每个变更页面添加/更新 provenance: frontmatter 混合。
14. 更新 .manifest.json：为每个已处理源文件记录 ingested_at、size_bytes、modified_at、source_type（codex_rollout | codex_index | codex_history）、project（可推断时）、pages_created、pages_updated；并添加/更新顶层项目/会话摘要块（含 source_path、last_ingested、sessions_ingested、sessions_total、index_updated_at）。
15. 更新特殊文件：在 index.md 和 log.md 追加形如 - [TIMESTAMP] CODEX_HISTORY_INGEST sessions=N pages_updated=X pages_created=Y mode=append|full 的记录；读取 $OBSIDIAN_VAULT_PATH/hot.md（缺失时按 wiki-ingest 模板创建），用一行摘要更新 Recent Activity（如“Ingested 12 Codex sessions; surfaced recurring patterns in CLI tooling and shell scripting.”），保留最近 3 次操作，并更新 updated 时间戳。
16. 遵守隐私与合规：提炼综合而非原始转录转储；对疑似敏感内容默认脱敏；存储个人/敏感细节前先询问用户；对他人引用保持最少且目的受限。
17. vault 写入后刷新 QMD（QMD 是搜索索引而非事实来源）：若 $QMD_WIKI_COLLECTION 为空或未设置则跳过；仅在本次技能写入或重写 vault markdown 后运行；若 QMD 刷新失败不要回滚 vault 变更，单独报告 QMD 状态。使用 $QMD_CLI（未设置则用 qmd）执行 ${QMD_CLI:-qmd} update；若输出提示需要向量或嵌入可能过期，执行 ${QMD_CLI:-qmd} embed；用 ${QMD_CLI:-qmd} ls "$QMD_WIKI_COLLECTION" 或已知页面路径时用 ${QMD_CLI:-qmd} get "qmd://$QMD_WIKI_COLLECTION/<page>.md" -l 5 验证；记录 QMD refreshed: update + embed + verified / QMD refreshed: update only + verified / QMD skipped: QMD_WIKI_COLLECTION unset / QMD skipped: qmd CLI unavailable / QMD failed: <short error summary> 之一。

适用边界 · 注意事项

• 没有 Obsidian vault 或未配置 OBSIDIAN_VAULT_PATH / CODEX_HISTORY_PATH 时无法使用。
• 用户未启用 Codex 历史持久化（history.jsonl 不存在）时，可用的数据源会受限。
• 不要导入 SQLite 内部数据（state_*.sqlite / logs_*.sqlite），除非用户明确要求。