- description
- 对话历史导出工具 - 将 WorkBuddy 的对话历史导出为多种格式（JSON/Markdown/TXT），包含时间线、元数据、统计数据、成就里程碑和 Skills 使用记录，便于归档分析和分享
对话历史导出工具
将 WorkBuddy 的对话历史导出为多种格式（JSON、Markdown、TXT），便于归档、分析和分享。
触发条件
当用户需要以下操作时使用此 Skill：
- 导出对话历史
- 保存会话记录
- 生成对话摘要
- 分析对话数据
- 归档工作记忆
功能特性
支持的导出格式
- JSON 格式（
conversation_history.json）
- 结构化数据，便于程序处理 - 包含完整的时间线、元数据、统计信息 - 支持数据导入到其他系统
- Markdown 格式（
conversation_history.md）
- 易读的文档格式 - 适合归档和查看 - 支持语法高亮和富文本
- TXT 格式（
conversation_history.txt）
- 纯文本，兼容性最好 - 无格式干扰 - 适合日志分析
导出内容
- 时间线：按时间顺序的所有交互事件
- 元数据：日期范围、项目信息、统计数据
- 工作记忆：从 WorkBuddy 工作记忆目录提取的长期记录
- 项目信息：项目名称、描述、关键文件路径
- 成就里程碑：完成的功能、版本迭代、重要决策
- Skills 使用记录：已安装的 Skills 列表和使用统计
安全特性
- ✅ UTF-8 编码：避免中文乱码
- ✅ 本地处理：不涉及外部服务
- ✅ 数据过滤：自动过滤敏感信息
- ✅ 格式验证：导出前验证数据完整性
使用指南
基本用法
用户请求导出对话历史时：
- 确定导出格式
- 默认导出所有三种格式 - 用户可指定特定格式（如 "只导出 JSON"）
- 读取工作记忆
- 读取长期记忆文件 - 读取最近的日期文件（今天 + 过去 7 天） - 读取自动化任务目录获取自动化任务信息
- 构建导出数据
- 解析时间线事件 - 统计数据 - 生成摘要
- 输出文件
- 文件名格式：对话历史_YYYY-MM-DD.{ext} - 保存到工作区根目录 - 使用 UTF-8 BOM 编码（增强兼容性）
高级选项
- 日期范围：导出指定时间段的对话
- 事件过滤：按类型过滤事件（如 "只导出 Skills 安装记录"）
- 详细程度：简洁模式 vs 完整模式
- 包含附件：是否包含生成的文件列表
数据结构
JSON 格式结构
{
"conversation_history": {
"metadata": {
"export_date": "ISO 8601 日期时间",
"date_range": {
"start": "YYYY-MM-DD",
"end": "YYYY-MM-DD"
},
"workspace": "工作区路径",
"project": "项目名称"
},
"timeline": [
{
"date": "YYYY-MM-DD",
"time": "HH:MM",
"type": "事件类型",
"action": "操作描述",
"details": {}
}
],
"statistics": {
"total_days": 0,
"total_events": 0,
"events_by_type": {}
},
"achievements": [],
"skills_summary": {},
"automations": []
}
}Markdown 格式结构
# 对话历史摘要
## 元数据
- 导出日期：...
- 时间范围：...
- 项目：...
## 时间线
### YYYY-MM-DD
- [HH:MM] 事件类型：操作描述
## 统计数据
...
## 成就里程碑
...配置选项
文件编码
- JSON/MD:
utf-8-sig（带 BOM，增强兼容性） - TXT:
utf-8-sig
文件路径
- 默认：工作区根目录，文件名格式为
对话历史_{date}.{ext} - 可通过参数指定自定义路径
注意事项
- 隐私保护
- 自动过滤 API Keys、密码等敏感信息 - 不导出完整的对话内容，只保留摘要 - 用户可手动编辑导出文件删除敏感信息
- 性能考虑
- 大量历史数据可能影响导出速度 - 建议定期清理工作记忆（7天以上数据可归档）
- 编码问题
- 始终使用 UTF-8 编码 - 对于 Windows 系统，建议使用 utf-8-sig 避免 Excel 打开乱码
示例工作流
完整导出
- 用户请求："导出对话历史"
- 读取工作记忆文件
- 解析并构建数据结构
- 生成三种格式的文件
- 显示导出摘要和文件路径
部分导出
- 用户请求："导出最近的 3 天对话"
- 按日期范围过滤数据
- 生成指定格式文件
- 返回结果
类型过滤
- 用户请求："导出 Skills 安装记录"
- 过滤事件类型为
skill_installation - 生成导出文件
- 返回结果
错误处理
- 工作记忆文件不存在：提示用户首次使用，无历史数据
- 编码错误：自动尝试多种编码方式
- 文件写入失败：检查权限和磁盘空间
技术实现
依赖工具
- 文件读取工具：读取工作记忆文件
- 文件写入工具：写入导出文件
- 目录列表工具：列出工作记忆目录
无需外部依赖
- 本 Skill 不依赖外部 API
- 不使用网络连接
- 完全本地处理
更新日志
- v1.0 (2026-03-25)
- 初始版本 - 支持 JSON、MD、TXT 三种格式 - UTF-8 编码，避免乱码 - 完整的工作记忆解析