导出 Windows 版微信里指定群聊 / 联系人在某个时间段内的聊天记录到 Markdown 文件，用于生成摘要、导图、Q&A 等。
本项目既是一个可直接运行的命令行 / 图形工具，也自带 SKILL.md，可作为 Claude Code 技能安装——装好后用自然语言说一句「导出 xx群 从…到…」即可完成导出。
核心是一个快速滚动导出器（fast_export.py）：用鼠标滚轮批量上滚 + 只读列表顶部判断加载进度，大群导出速度远快于逐条 PageUp 方案。
- 可作为 Claude Code 技能：自然语言触发，自动解析时间、确认参数、导出并回报结果
- 导出指定群聊 / 联系人的聊天记录到 Markdown
- 自定义时间范围；不给开始时间时自动“接上次导出结束时间”继续导
- 自动去重
- 三种用法：Claude Code 技能 / 命令行 / 图形界面
- 安全校验：打开的聊天标题与目标不符会立刻中止，绝不抓取其它聊天
- 纯本地：结果只写本地，不含任何上传 / 外发功能
- Windows + 微信 PC 版 3.9.12.x（窗口类
WeChatMainWndForPC）。请勿升级微信，高版本 UI 结构变化会导致失效。 - Python 3.11
- 普通权限即可，无需管理员 / UAC。
把整个仓库克隆到 Claude Code 技能目录并装依赖：
git clone https://github.com/qingxuantang/wechatdaily.git ~/.claude/skills/wechatdaily
cd ~/.claude/skills/wechatdaily
pip install -r requirements.txt之后在 Claude Code 里用自然语言触发，例如：
导出 My Group 从昨天9点到现在
Claude 会解析时间、与你确认参数、调用 fast_export.py 滚动加载并导出，再把结果（打开的聊天、是否滚到起点、写入条数、文件路径）报告给你。触发词与完整流程见 SKILL.md。
# 指定时间范围
python fast_export.py --group "My Group" --start "2025-05-30 13:00:00" --end "2025-05-30 18:00:00"
# 不给 --end 时默认导到「现在 - 2 小时」
python fast_export.py --group "My Group" --start "2025-05-30 13:00:00"
# 不给 --start 时自动接上该群上次导出的结束时间（本地 exports 目录里）
python fast_export.py --group "My Group"
# 只查询该群上次导出到哪，不实际导出
python fast_export.py --group "My Group" --show-last运行时请保持微信在前台、不要动鼠标键盘——脚本会接管几下按键/滚轮把群聊搜出来并滚动加载历史。
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
--group |
是 | — | 目标群聊 / 联系人名称，需与微信顶部标题能对上 |
--start |
否 | 接上次导出结束时间 | 起始时间 YYYY-MM-DD HH:MM:SS；不给则从本地 exports/ 里该群上次导出的结束时间接着导 |
--end |
否 | 现在 − 2 小时 | 结束时间 YYYY-MM-DD HH:MM:SS |
--max-scroll |
否 | 2000 |
最大上滚轮数；到顶会自动提前停（活跃大群可能需要上千轮） |
--check-every |
否 | 4 |
每隔几轮打印一次进度日志 |
--show-last |
否 | — | 只查询该群上次导出到哪并退出，不连微信、不导出 |
python wechat_exporter.py按窗口提示选择群聊、时间范围后导出。
上面的技能用法已包含装依赖；若单独使用命令行 / 图形界面：
pip install -r requirements.txt命令行 / 图形界面可用 .env 提供默认值：复制 .env.example 为 .env 并按需修改：
TARGET_GROUP=My Group # 目标群聊名称（也可运行时 --group 指定）
EXPORT_PATH=exports # 导出文件目录
LOG_PATH=logs # 日志目录
START_TIME= # 留空表示不限制；格式 YYYY-MM-DD HH:MM:SS
END_TIME=
MAX_SCROLL_ATTEMPTS=50
SCROLL_WAIT_TIME=0.5群聊列表可复制 groups_config.example.json 为 groups_config.json 自行维护（该文件已被 .gitignore 忽略，不会进版本库）。
- 自动搜进群聊：
Ctrl+F打开搜索 → 用send_keys逐字符发送中文群名（基于KEYEVENTF_UNICODE，不依赖输入法）→ 回车进入第一个结果。若目标聊天已在前台则跳过导航。 - 只用鼠标滚轮上滚：实测滚轮加载历史有效且快（约 3 聊天小时/秒），PageUp 基本加载不动。
- 只读列表顶部判断进度：每轮只读消息列表最前约 12 项找最早时间（O(1)，约 45ms），不做全树遍历，几千条的大群也不卡。
- 到顶自动停：连续多轮无进展且已无“查看更多消息”按钮时判定到顶，提前结束。
导出结果写入 exports/，文件名格式：
{群名}_messages_{开始时间}-{结束时间}_{导出时间}.md
时间均为 yymmddHHMM（如 My Group_messages_2505301300-2505301800_2505302015.md）。文件开头记录群名、起止与导出时间，正文为按时间顺序、已去重的消息。fast_export.py 正是靠这个文件名里的结束时间来实现「接上次导出继续导」。
├── SKILL.md # Claude Code 技能说明（让本仓库可作为技能安装）
├── wechat_exporter.py # 导出引擎 + 图形界面
├── fast_export.py # 快速滚动命令行导出器
├── config.py # 配置（读取 .env）
├── detect_wechat_window.py # 微信窗口检测
├── requirements.txt
├── .env.example # 配置模板 → 复制为 .env
└── groups_config.example.json # 群列表模板 → 复制为 groups_config.json
- 打开的聊天顶部标题必须包含目标名称，否则立即中止，不做任何抓取。
- 导出结果仅写入本地
exports/目录。本项目不包含任何上传 / 外发功能。
见 LICENSE。