codex-history-ingest 是做什麼的?
將 Codex CLI 對話歷史擷取並匯入 Obsidian 知識庫。當使用者想要挖掘過往 Codex 工作階段的知識、匯入 ~/.codex 資料夾、從先前的編碼會話中提取見解,或說出「處理我的 Codex 歷史」、「將我的 Codex 對話加入知識庫」、「我之前在 Codex 討論過什麼」等語句時使用此技能。當使用者提及 .codex 工作階段、rollout 檔案、session_index.jsonl 或 Codex 轉錄日誌時,也會觸發此技能。
功能
- 自動掃描
~/.codex目錄中的session_index.jsonl檔案 - 解析 Codex CLI 的對話索引與轉錄檔案
- 將歷史對話轉換為 Obsidian 格式的 markdown 筆記
- 保留原始對話的上下文與連結
- 支援增量匯入,避免重複處理
使用方法
當使用者提出以下需求時,請執行此技能:
- 「處理我的 Codex 歷史」
- 「將我的 Codex 對話加入 Obsidian 知識庫」
- 「我之前在 Codex 討論過哪些專案?」
- 「從我的 Codex 工作階段中提取見解」
- 提及
.codex資料夾、session_index.jsonl或類似檔案
支援的平台
- Obsidian: 主要目標平台,產生的筆記可直接用於 Obsidian 知識庫
- Codex CLI: 能存取 ~/.codex 資料夾的環境
- 任何支援 markdown 格式的知識庫工具
運作方式
- 掃描
~/.codex資料夾以尋找session_index.jsonl及轉錄檔案 - 解析 JSONL 格式的索引,提取每個工作階段的 metadata(時間戳記、專案名稱、狀態等)
- 讀取對應的轉錄日誌,解析對話內容、程式碼片段與 AI 回覆
- 使用 Obsidian 的 markdown 模板(包含 frontmatter、標籤、內部連結)生成筆記
- 將筆記儲存至使用者指定的 Obsidian 儲存庫中
注意事項
- 確保
~/.codex目錄存在且包含有效的session_index.jsonl - 若使用者首次執行,建議先備份現有檔案
- 支援增量匯入,但需保留本機記錄以避免重複
相關資源
- Codex CLI 文件
- Obsidian 知識庫
- 關於
session_index.jsonl格式的詳細說明