Chat Exporter - 聊天记录导出工具

功能描述

自动从 macOS 聊天应用（如企业微信、钉钉等）导出聊天记录为 Markdown 格式。

使用场景

当你需要：

• 保存聊天记录作为文档
• 归档工作对话
• 导出沟通记录用于报告或备份

核心功能

1. 自动截图聊天记录

   • 从顶部到底部自动滚动截图
   • 使用 PageDown 键确保每次翻页
   • 保存为高清 PNG 文件

2. 文字提取与整理

   • 识别聊天内容（发送者、消息、时间）
   • 自动去重（去除连续截图的重复内容）
   • 生成结构化的 Markdown 文件

使用方法

方法 1：让呆呆帮你操作（推荐）

1. 打开聊天窗口，并手动滚动到最顶部
2. 告诉呆呆："帮我导出这个聊天窗口的记录"
3. 呆呆会自动：
   • 截图整个聊天记录
   • 提取文字并去重
   • 生成 Markdown 文件

方法 2：使用脚本手动操作

步骤 1：截图聊天记录

# 首先获取窗口信息
peekaboo list windows --app "应用名称" --json

# 记录 PID 和 Window ID，然后运行截图脚本
chat-capture.sh <PID> <WINDOW_ID>

步骤 2：提取文字并生成 Markdown

chat-extract.sh ~/Pictures/聊天截图前缀-*.png

配置选项

截图参数

• COUNTER_START: 起始编号（默认：1）
• LOOP_COUNT: 截图次数（默认：50）
• SLEEP_TIME: 每次滚动间隔秒数（默认：0.5）
• OUTPUT_DIR: 截图保存目录（默认：~/Pictures/）

文字提取参数

• CHAT_NAME: 聊天对象名称（用于 Markdown 标题）
• MY_NAME: "我"的显示名称（默认：我）
• THEIR_NAME: 对方显示名称（从截图识别）

输出文件

• 截图: ~/Pictures/聊天记录-1.png, 聊天记录-2.png, ...
• Markdown: ~/workspace/聊天记录-对象名称.md

技术实现

• 窗口自动化: Peekaboo CLI
• 图像识别: OpenClaw image tool (OCR)
• 去重算法: 比较相邻截图，只添加新消息

注意事项

1. 截图前准备

   • 确保聊天窗口已打开并最大化
   • 手动滚动到聊天记录最顶部
   • 关闭其他可能干扰的窗口

2. 截图过程

   • 不要移动窗口或切换应用
   • 确保 Peekaboo 有屏幕录制权限
   • 如果记录很长，可能需要分批截图

3. 文字提取

   • 依赖图像识别，准确率取决于截图质量
   • 建议手动检查生成的 Markdown 文件
   • 复杂表情、图片可能无法识别

示例

# 示例 1：导出企业微信聊天记录
呆呆：帮我导出和张三的聊天记录

# 示例 2：手动运行截图脚本
./chat-capture.sh 70444 5764

# 示例 3：提取已有截图
./chat-extract.sh ~/Pictures/企业微信-张三-chat-*.png

故障排查

截图失败

• 检查 Peekaboo 权限：peekaboo permissions
• 确认窗口 ID 正确：peekaboo list windows --app "应用名" --json

文字提取不准确

• 检查截图是否清晰（使用 --retina 高清截图）
• 尝试调整窗口大小，确保文字完整显示
• 手动编辑生成的 Markdown 文件修正错误

截图重复

• 检查 PageDown 是否生效
• 调整 SLEEP_TIME 参数，增加等待时间
• 确保聊天窗口有焦点

版本历史

• v1.0 (2026-03-08): 初始版本
  • 支持自动截图和文字提取
  • 基本去重功能
  • Markdown 输出格式

作者

由休语创建，呆呆整理。