对话历史导出工具

---

description: 对话历史导出工具 - 将 WorkBuddy 的对话历史导出为多种格式（JSON/Markdown/TXT），包含时间线、元数据、统计数据、成就里程碑和 Skills 使用记录，便于归档分析和分享

---

# 对话历史导出工具

将 WorkBuddy 的对话历史导出为多种格式（JSON、Markdown、TXT），便于归档、分析和分享。

触发条件

当用户需要以下操作时使用此 Skill：

功能特性

支持的导出格式

1. **JSON 格式**（`conversation_history.json`）

- 结构化数据，便于程序处理

- 包含完整的时间线、元数据、统计信息

- 支持数据导入到其他系统

2. **Markdown 格式**（`conversation_history.md`）

- 易读的文档格式

- 适合归档和查看

- 支持语法高亮和富文本

3. **TXT 格式**（`conversation_history.txt`）

- 纯文本，兼容性最好

- 无格式干扰

- 适合日志分析

导出内容

安全特性

使用指南

基本用法

用户请求导出对话历史时：

1. **确定导出格式**

- 默认导出所有三种格式

- 用户可指定特定格式（如 "只导出 JSON"）

2. **读取工作记忆**

- 读取长期记忆文件

- 读取最近的日期文件（今天 + 过去 7 天）

- 读取自动化任务目录获取自动化任务信息

3. **构建导出数据**

- 解析时间线事件

- 统计数据

- 生成摘要

4. **输出文件**

- 文件名格式：`对话历史_YYYY-MM-DD.{ext}`

- 保存到工作区根目录

- 使用 UTF-8 BOM 编码（增强兼容性）

高级选项

数据结构

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] 事件类型：操作描述

## 统计数据
...

## 成就里程碑
...

配置选项

文件编码

文件路径

注意事项

1. **隐私保护**

- 自动过滤 API Keys、密码等敏感信息

- 不导出完整的对话内容，只保留摘要

- 用户可手动编辑导出文件删除敏感信息

2. **性能考虑**

- 大量历史数据可能影响导出速度

- 建议定期清理工作记忆（7天以上数据可归档）

3. **编码问题**

- 始终使用 UTF-8 编码

- 对于 Windows 系统，建议使用 `utf-8-sig` 避免 Excel 打开乱码

示例工作流

完整导出

1. 用户请求："导出对话历史"

2. 读取工作记忆文件

3. 解析并构建数据结构

4. 生成三种格式的文件

5. 显示导出摘要和文件路径

部分导出

1. 用户请求："导出最近的 3 天对话"

2. 按日期范围过滤数据

3. 生成指定格式文件

4. 返回结果

类型过滤

1. 用户请求："导出 Skills 安装记录"

2. 过滤事件类型为 `skill_installation`

3. 生成导出文件

4. 返回结果

错误处理

技术实现

依赖工具

无需外部依赖

更新日志

- 初始版本

- 支持 JSON、MD、TXT 三种格式

- UTF-8 编码，避免乱码

- 完整的工作记忆解析