| name | export-chat-records |
| version | 1.0.0 |
| description | 导出指定工作区的 AI 聊天记录到 Markdown 文件。用户提到导出聊天记录、导出会话记录、导出 AI 对话、导出 Cursor/Claude/Codex/Copilot 聊天时使用。脚本会优先根据工作区根目录中的 .claude、.codex、.codex、.github 自动识别 AI 类型，并将导出结果写入工作区根目录下新建的 chat_exports 文件夹。 |
导出聊天记录
当前版本：1.0.0
通用 Skill 查找规则
本项目只维护 .codex/skills 这一份通用 skill 内容，不再为不同 AI 单独维护多套 skill。
当需要根据当前 AI 客户端判断应查看哪个工作区根目录下的配置目录时，按以下规则理解：
- 根目录有
.claude 目录时，表示 Claude Code 在该目录中寻找项目级能力配置
- 根目录有
.codex 目录时，表示 Cursor 在该目录中寻找项目级 skill
- 根目录有
.codex 目录时，表示 Codex 在该目录中寻找项目级 skill
- 根目录有
.github 目录时，表示 VSCode Copilot 在该目录中寻找项目级提示与指令
以上规则用于确定不同 AI 的项目级目录位置；本仓库中的通用 skill 内容统一以 .codex/skills 为准。
使用时机
当用户提到以下需求时使用此技能：
- 导出聊天记录
- 导出会话记录
- 导出 AI 对话
- 导出 Cursor / Claude Code / Codex / VSCode Copilot 聊天记录
执行规则
- 默认使用当前工作区根目录作为
--workspace
- 执行脚本：
node .codex/skills/export-chat-records/scripts/export_ai_sessions.js --workspace "."
- 如果用户明确指定了 AI 类型，再额外传入
--ai <ai-type>
- 如果用户明确指定了输出目录，再额外传入
--output "<输出目录>"
- 若未传
--ai，脚本会按以下顺序自动识别工作区根目录中的标记目录：
.claude -> claude-code.codex -> cursor.codex -> codex.github -> vscode-copilot
- 若未指定
--output，脚本会在工作区根目录中创建 chat_exports/<ai-type>/，并将每个会话导出为一个 Markdown 文件
- 导出完成后，向用户说明导出目录和导出的会话数量
- 在 PowerShell 中不要使用
cd <路径> && node ... 这种写法；应直接在目标工作区根目录执行命令，或先单独切换目录后再执行命令
- 如果导出内容中识别到访问令牌、API Key、Bearer Token 等敏感令牌，脚本会自动将实际内容替换为
[token过滤]
常用命令
node .codex/skills/export-chat-records/scripts/export_ai_sessions.js --workspace "."
node .codex/skills/export-chat-records/scripts/export_ai_sessions.js --workspace "." --ai cursor
node .codex/skills/export-chat-records/scripts/export_ai_sessions.js --workspace "." --output "./chat_exports/custom"
PowerShell 示例：
Set-Location "G:\VibeCoding\Copilot"
node .github/skills/export-chat-records/scripts/export_ai_sessions.js --workspace "." --ai vscode-copilot
输出位置
默认输出目录：
<workspace>/chat_exports/<ai-type>/
例如：
./chat_exports/cursor/
注意事项
- 如果工作区根目录不存在
.claude、.codex、.codex、.github，脚本会回退为手动选择 AI 类型
- 如果本地工作区路径不存在，脚本仍会尝试从历史记录中匹配并导出
- 每个会话会单独导出成一个
.md 文件
- 导出前会对消息内容做敏感令牌脱敏，避免把访问令牌原文写入导出结果
