CLI 使用文档
命令行工具 ew.exe 参考手册（仅 Windows）
安装
随 ExportWeChat 安装包一起分发，无需额外安装。客户端安装后可在任意终端使用 ew 命令。
命令一览
| 命令 | 说明 |
|---|---|
| ew init | 初始化（每个账号必须首先执行） |
| ew list-friend | 列出好友会话 |
| ew list-group | 列出群聊会话 |
| ew list-following | 列出公众号会话 |
| ew export | 导出聊天记录 |
| ew current-wxid | 查看当前账号 |
| ew list-wxid | 列出所有已初始化的账号 |
| ew reset-wxid <wxid> | 切换当前账号 |
ew -h、ew --help 以及各子命令的 -h/--help 可查看帮助。
系统要求：Windows 10/11、微信 4.1.10+。init 需管理员权限。
1. 初始化
首次使用必须执行此命令。
| 参数 | 说明 |
|---|---|
| timeout | 超时秒数，默认 300 |
自动检测微信版本，低于 4.1.10 会提示升级。会重启微信，重启后需扫码登录。 每个微信号只需初始化一次，后续操作无需微信运行。初始化成功后会自动读取昵称并设为当前账号。
2. 列出会话
ew list-group
ew list-following
从已保存的凭证读取数据，列出对应类型的会话：
list-friend：好友会话list-group：群聊会话list-following：公众号会话
输出为 wxid、备注、消息条数三列表格，并按消息条数从高到低排序。
默认使用当前账号（由 ew init 或 ew reset-wxid 设置）。如果有多个账号且未设置当前账号，会提示先选择。
3. 导出聊天记录
| 参数 | 说明 |
|---|---|
| -n, --name <备注> | 按备注选择，可重复；完全匹配优先 |
| -w, --wxid <wxid> | 按 wxid 精确选择，可重复 |
| --all | 选择全部会话，可配合 --category |
| --category <类型> | friend / group / following |
| --dry-run | 只显示匹配结果，不执行导出 |
| -f <格式> | 导出格式：txt / md / json（默认 txt） |
| -o <目录> | 输出目录（默认当前目录） |
| -st <时间> | 起始时间（Unix 时间戳 或 YYYY-MM-DD） |
| -et <时间> | 结束时间（Unix 时间戳 或 YYYY-MM-DD） |
| --v2t | 语音转文字 |
备注包含空格或 Emoji 时请使用引号，空备注请使用 wxid。多个会话会独立导出，单个会话失败不会中断其他会话。
单账号导出流程
初始化
ew init（首次使用，需扫码登录）
查看会话
ew list-friend / ew list-group
导出聊天
ew export -n 张三
多账号导出流程
如果你需要导出多个微信号的聊天记录，可以通过 ew init 逐一初始化每个账号，然后使用 ew reset-wxid 在账号之间切换。
初始化第一个账号
ew init → 扫码登录微信号 A，自动设为当前账号
导出账号 A 的聊天
ew export -n 张三 -f txt
初始化第二个账号
ew init → 扫码登录微信号 B，自动切换为当前账号
导出账号 B 的聊天
ew export -n 李四 -f txt
切换回账号 A 继续操作
ew list-wxid → 查看所有已初始化的账号及 wxidew reset-wxid wxid_xxx → 切换回账号 A
每个账号只需初始化一次，后续切换无需重新扫码，也无需微信处于运行状态。