openyida 导出 AI 对话记录
严格禁止 (NEVER DO)
- 不要在非 Claude Code 环境下省略
--input参数（其他环境无法自动检测对话文件）
严格要求 (MUST DO)
- 导出前确认当前环境（
openyida env），Claude Code 环境可自动检测，其他环境需--input手动指定 - 导出前必须确认输出路径有写权限，避免导出失败
- 导出完成后必须告知用户文件路径和文件大小，方便用户确认
- 遇到对话文件格式不支持时，必须明确告知用户支持的格式（
.jsonl） - 本技能不读写 memory：对话记录导出为本地 Markdown 文件，不依赖跨会话的 memory 状态
适用场景
用户需要"导出对话记录"、"保存 AI 对话"、"生成开发文档"时使用。 无需登录宜搭，为纯本地操作。
触发条件
正向触发：
- "导出对话记录"、"保存 AI 对话"
- "生成开发文档"、"导出本次对话"
- "把对话记录存下来"
注意：本技能为一次性导出，不支持实时同步。非 Claude Code 环境需通过 --input 手动指定对话文件。
将 AI 对话记录导出为结构化的 Markdown 文档，方便分享和存档。
命令
openyida export-conversation [options]
| 选项 | 说明 |
|---|---|
--output <path> |
指定输出文件路径（默认 project/conversation-export.md） |
--input <file> |
手动指定对话记录文件（覆盖自动检测） |
--latest |
仅导出最近一次对话（默认行为） |
--list |
列出可用的对话记录供选择 |
支持的 AI 工具环境
| 环境 | 支持方式 |
|---|---|
| Claude Code | 自动检测并读取对话记录 |
| 其他环境 | 通过 --input 手动指定对话文件 |
输出格式
生成的 Markdown 文档包含以下内容：
概要信息
- 应用名称
- AI 工具环境
- 导出时间
- 对话轮次
- 工具调用次数
关键步骤摘要
- 从工具调用中自动提取的操作步骤
完整对话记录
- 用户消息
- AI 回复
- 工具调用及执行结果
使用示例
# 导出最近一次对话（自动检测环境）
openyida export-conversation
# 导出到指定文件
openyida export-conversation --output ./my-conversation.md
# 从指定文件导入对话记录
openyida export-conversation --input ./conversation.jsonl
# 列出可用的对话记录
openyida export-conversation --list
前置条件
- 无需登录宜搭（对话导出是本地操作）
- Node.js ≥ 18
注意事项
- 目前 MVP 版本主要支持 Claude Code 的对话记录自动检测
- 其他 AI 工具环境请使用
--input手动指定对话文件 - 后续版本将支持发布到宜搭社区和钉钉群
异常处理
| 异常场景 | 处理方式 |
|---|---|
| 自动检测失败（非 Claude Code 环境） | 使用 --input 手动指定对话文件路径 |
| 输出文件路径无写权限 | 使用 --output 指定有写权限的路径 |
| 对话文件格式不支持 | 确认文件格式为 .jsonl，其他格式暂不支持 |
| 导出内容为空 | 确认对话记录文件存在且非空，使用 --list 查看可用记录 |
Agent 错误处理策略
当 Agent 执行本技能遇到错误时，必须遵循以下默认行为：
| 错误类型 | 默认处理策略 |
|---|---|
| 命令执行失败 | 停止执行，向用户展示错误信息，询问是否重试或调整参数 |
| 环境检测失败 | 提示用户使用 --input 手动指定对话文件路径 |
| 文件写入失败 | 提示用户使用 --output 指定有写权限的路径，或检查磁盘空间 |
| 对话文件不存在 | 使用 --list 列出可用记录，引导用户选择正确文件 |
| 网络超时 | 本技能为纯本地操作，无网络依赖，检查文件系统权限 |
| 未知错误 | 停止执行，完整展示错误信息，建议用户反馈问题 |