SuperAPI AI 工具集

read-codex-history

智能体与模型

查看项目

更新于 10-15 20:34

技能介绍

用途:只读取本地 OpenAI Codex 的历史证据,不继续旧任务、不修改其项目。若读取后需要执行,应把已验证证据交给 daymade-claude-code:continue-codex-work。

主要能力:Codex 有四类历史来源——history.jsonl(用户提交内容,按 Session ID 与内部时间戳)、state_.sqlite(cwd、标题、更新时间、rollout 路径等清单元数据)、sessions/**/rollout-.jsonl 与 archived_sessions/**(完整 user/assistant/tool/compaction/fork 事件流)、logs_*.sqlite(运行时事件,含 ts、level、target、feedback_log_body、process_uuid)。不同来源不可互相替代:prompt 账本只证明提交了什么,不证明回答;state DB 路径只是候选,需 rollout 的 session_meta.id 匹配。

使用方式:脚本相对 SKILL.md 解析,不要用临时 SQLite、Node、jq 或递归 grep 重建。常用命令:list_local_history.py --source codex --index-only 列清单;list_codex_user_inputs.py 列原始输入;reconcile_codex_inputs.py --session <ID> 核对整段对话输入;analyze_sessions.py locate-codex <ID> 定位 rollout;read_codex_session.py --session <ID> --full 重建会话与父快照;--tools/--record 读取工具与记录证据;history_index.py recall 做索引检索。

适用场景:查找含某段引文的会话、导出按会话分组的近期原始输入、核对工具返回与记录、定位报错进程与错误形态随时间分布。

限制:writer-lock 输出仅正向有效;logs 中的 thread_id 不等于可恢复会话,需 state_*.sqlite 的 threads.id 确认;时间边界应写 UTC 字面量,避免 strftime 本地时间双重转换;索引为全文而非向量,CJK 连续串按整段分词;退出码 2 或 complete:false 表示结果不完整,scope_input_count 为 null 不等于零。