mcpField
E
export

export

github.com/gaossr文档处理745 次安装27 周前更新
代码仓库

关于 export

此 Codex skill 可将会话 JSONL 文件转换为易读的 Markdown 记录，支持自动选择会话或指定 ID 和文件，并可选导出工具日志及本地路径。

主要功能

  1. 01将会话导出为 Markdown
  2. 02选择当前或最近的会话
  3. 03指定会话 ID 或 JSONL 文件
  4. 04可选包含工具日志
  5. 05可选显示本地路径

适用场景

  1. 01保存易读的 Codex 对话记录
  2. 02导出指定会话以供查看

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gaossr/codex-export-skill --skill export

安装后在 Claude Code 中输入/export确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
selection-and-format.md
scripts/
export_codex_session.py

详细介绍

导出

用途

将 ~/.codex/sessions 或 ~/.codex/archived_sessions 中的 Codex 会话 JSONL 文件导出为易读的 Markdown 对话记录。

运行环境要求

  • 需要 Python 3.10 或更高版本的 python3。

默认工作流

  1. 在当前工作区运行导出器：
if [ -n "${CODEX_EXPORT_SKILL_DIR:-}" ]; then
  EXPORT_SKILL_DIR="$CODEX_EXPORT_SKILL_DIR"
elif [ -f "$HOME/.codex/skills/export/scripts/export_codex_session.py" ]; then
  EXPORT_SKILL_DIR="$HOME/.codex/skills/export"
else
  EXPORT_SKILL_DIR="$HOME/.agents/skills/export"
fi
python3 "$EXPORT_SKILL_DIR/scripts/export_codex_session.py" --json --output-dir "$(pwd)/codex-session-exports"
  1. 解析 JSON 结果，并将 file、session_id、message_count、include_tools 和 selected_by 视为结果。
  2. 回复 Markdown 文件的绝对路径和简短的导出摘要。

选择规则

  • 默认选择当前 Codex 对话 ID（如果 Codex 将其提供给工具进程，则从 CODEX_THREAD_ID 或 CODEX_SESSION_ID 获取）。
  • 如果无法获取当前对话 ID，则选择会话元数据中的 cwd 与当前工作目录匹配且最近修改的 Codex 会话。
  • 如果没有可用的会话 ID 或 cwd 匹配项，则回退到全局最近的 Codex 会话。
  • 如果用户提供会话 ID，则使用 --session-id <id> 运行。
  • 如果用户提供 JSONL 路径，则使用 --session-file <path> 运行。

内容规则

  • 默认导出包含可见的用户消息和可见的助手消息。
  • 除非用户明确要求，否则不要在聊天中粘贴完整的导出对话记录。
  • 不要泄露系统提示词、开发者指令、AGENTS 上下文注入、Codex Skill 上下文注入（例如 <skill>...</skill>）、环境上下文注入或加密推理。导出器会跳过这些记录。
  • 默认不包含工具调用和命令输出。如果用户要求命令日志或完整执行跟踪，则添加 --include-tools。
  • 默认会在 Markdown 中对本地源文件路径和 cwd 元数据进行脱敏。只有当用户明确要求提供完整本地源文件路径时，才添加 --show-paths。
  • 将运行导出器作为最后一项实质性操作。报告导出文件路径的简短回复只会出现在后续导出中。

常用命令

列出最近的会话：

if [ -n "${CODEX_EXPORT_SKILL_DIR:-}" ]; then
  EXPORT_SKILL_DIR="$CODEX_EXPORT_SKILL_DIR"
elif [ -f "$HOME/.codex/skills/export/scripts/export_codex_session.py" ]; then
  EXPORT_SKILL_DIR="$HOME/.codex/skills/export"
else
  EXPORT_SKILL_DIR="$HOME/.agents/skills/export"
fi
python3 "$EXPORT_SKILL_DIR/scripts/export_codex_session.py" --json --list

导出指定会话：

if [ -n "${CODEX_EXPORT_SKILL_DIR:-}" ]; then
  EXPORT_SKILL_DIR="$CODEX_EXPORT_SKILL_DIR"
elif [ -f "$HOME/.codex/skills/export/scripts/export_codex_session.py" ]; then
  EXPORT_SKILL_DIR="$HOME/.codex/skills/export"
else
  EXPORT_SKILL_DIR="$HOME/.agents/skills/export"
fi
python3 "$EXPORT_SKILL_DIR/scripts/export_codex_session.py" --json --session-id <session-id> --output-dir "$(pwd)/codex-session-exports"

导出工具日志：

if [ -n "${CODEX_EXPORT_SKILL_DIR:-}" ]; then
  EXPORT_SKILL_DIR="$CODEX_EXPORT_SKILL_DIR"
elif [ -f "$HOME/.codex/skills/export/scripts/export_codex_session.py" ]; then
  EXPORT_SKILL_DIR="$HOME/.codex/skills/export"
else
  EXPORT_SKILL_DIR="$HOME/.agents/skills/export"
fi
python3 "$EXPORT_SKILL_DIR/scripts/export_codex_session.py" --json --include-tools --output-dir "$(pwd)/codex-session-exports"

参考资料

  • 请参阅 references/selection-and-format.md，了解 JSONL 选择启发式规则和格式边界。

评论

支持 Markdown