用途:把 Codex 会话从 ~/.codex/sessions 或 ~/.codex/archived_sessions 中的 JSONL 文件导出为可读的 Markdown 记录。适用于用户要求保存或导出当前 Codex 对话历史的场景。
运行要求:需要 python3,版本 3.10 或更高。
主要能力:默认导出可见的用户消息与助手消息;默认不包含工具调用与命令输出、不暴露系统提示、开发者指令、上下文注入与加密推理等内容;默认对本地源路径与 cwd 元数据做脱敏。
使用方式:在活动工作区运行导出脚本,脚本会先确定 EXPORT_SKILL_DIR,再调用 scripts/export_codex_session.py 并输出 JSON 结果,结果字段包括 file、session_id、message_count、include_tools、selected_by,最后以绝对 Markdown 路径和简短摘要回复。会话选择规则:优先使用 CODEX_THREAD_ID 或 CODEX_SESSION_ID 提供的当前会话;否则选择 cwd 与当前工作目录匹配的最新会话;再否则回退到全局最新会话。用户可传 --session-id <id> 或 --session-file <path> 指定。常用命令包括列出近期会话(--list)、导出指定会话(--session-id)、包含工具日志导出(--include-tools)。
限制:工具调用和命令输出默认排除,需显式添加 --include-tools;本地路径默认脱敏,仅在用户明确要求全路径时使用 --show-paths;除非用户明确要求,不要把完整导出的记录粘贴到聊天中。更多选择启发式与格式边界见 references/selection-and-format.md。其余细节暂未提供。