Skip to content
Back to search

微信指定好友聊天导出

只导出用户点名的人的微信一对一聊天记录(Windows 微信 4.x,本机)。用户说要谁就只读谁,没点名的会话不读正文、名字不落盘。触发:「导出我和 XX 的聊天记录」「把 XX 的微信聊天拉下来」「更新 XX 的聊天记录」「更新关注名单的聊天」「我要 XX 和 YY 的聊天记录」。流程:快照解密 → 按点名匹配会话元数据(零正文)→ 重名/模糊的退回用户定 → 只导出点到的人 → 对账打包 → 解压到用户指定目录 → 可选导出图片/语音/视频 → 清明文。全程本机,不联网。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/disuxiaoshuo339-beep--wechat-chat-export-skill/badge.svg)](/listings/disuxiaoshuo339-beep--wechat-chat-export-skill)

HTML

<a href="/listings/disuxiaoshuo339-beep--wechat-chat-export-skill"><img src="/api/listings/disuxiaoshuo339-beep--wechat-chat-export-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/disuxiaoshuo339-beep/wechat-chat-export-skill.git "$env:USERPROFILE\.claude\skills\微信指定好友聊天导出"
cd "$env:USERPROFILE\.claude\skills\微信指定好友聊天导出"
python -m pip install pycryptodomex zstandard openpyxl
copy accounts.example.json accounts.json   # 然后按 SKILL.md「首次使用」填

重开 Claude Code 后直接说:「导出我和 XX 的聊天记录」。

用 Codex 等其他 AI 助手

克隆到任意目录,在 AI 助手里打开这个目录作为项目,然后发:

请先阅读根目录 AGENTS.md 和 SKILL.md,按其中流程帮我导出本机微信里和 XX 的聊天记录,现在先只做只读预检。
账号由我确认;聊天内容、联系人、数据库、密钥和导出结果都不要发到对话或 GitHub;不要执行 git add/commit/push。

预检找不到账号?

预检会自动读取微信记录的存储位置(`%APPDATA%\Tencent\xwechat\config\*.ini`)。仍找不到时,在微信「设置 → 文件管理」看存储位置,把它填进 `accounts.json` 的 `search_roots`,或运行 `python -I scripts/preflight.py --root "<存储位置>"`。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 88 lines
  1. ---
  2. name: 微信指定好友聊天导出
  3. description: 只导出用户点名的人的微信一对一聊天记录(Windows 微信 4.x,本机)。用户说要谁就只读谁,没点名的会话不读正文、名字不落盘。触发:「导出我和 XX 的聊天记录」「把 XX 的微信聊天拉下来」「更新 XX 的聊天记录」「更新关注名单的聊天」「我要 XX 和 YY 的聊天记录」。流程:快照解密 → 按点名匹配会话元数据(零正文)→ 重名/模糊的退回用户定 → 只导出点到的人 → 对账打包 → 解压到用户指定目录 → 可选导出图片/语音/视频 → 清明文。全程本机,不联网。
  4. ---
  5. # 微信指定好友聊天导出(点名版)
  6. ## 特点
  7. | 特点 | 说明 |
  8. |---|---|
  9. | 点名才导 | `select_people.py` 按用户点的名字匹配会话元数据,没点名的人不读正文、不落盘 |
  10. | 点名闸门 | `run_export.py` 只认 `select_people.py` 生成的清单;清单里有点名范围外的行就整体拒绝 |
  11. | 只解密要用的库 | 联系人、会话、一对一消息分库、语音库。朋友圈、收藏、公众号消息等不解密 |
  12. | 媒体导出 | `export_media.py` 导出点名的人的语音(转 mp3)、图片(解密 .dat)、视频,外加一个带媒体的聊天页面 |
  13. | 关注名单 | `watchlist.json` 存下点过名并确认的人,下次「更新关注名单」直接复用 |
  14. | 自定义数据目录 | 微信设置里改过存储位置的,在 `accounts.json` 的 `search_roots` 登记 |
  15. 所有命令在 skill 根目录(`%USERPROFILE%\.claude\skills\微信指定好友聊天导出`)下跑,用 `python -I`。
  16. ## 首次使用
  17. 1. 装依赖:`python -m pip install pycryptodomex zstandard openpyxl`(`openpyxl` 可选,缺了索引降级为 CSV)。
  18. 2. 复制 `accounts.example.json` 为 `accounts.json`,按本机情况填:
  19. - `search_roots`:微信数据根目录(目录名一般是 `xwechat_files`)。在微信「设置 → 文件管理」能看到;用默认位置的可以留空数组。
  20. - `accounts`:别名 → 账号 ID。不知道账号 ID 就先跑 `python -I scripts/preflight.py`,它会列出本机所有账号 ID(形如 `wxid_xxx_xxxx`)。
  21. - `output_root`:运行目录,必须在微信数据目录和 skill 目录之外。`publish_dir`:导出结果默认放哪,可不填,每次用 `--to` 指定;同样不能放在 skill 目录内。
  22. - `silk_python`:只有要把语音转 mp3 才需要。单独建一个 venv 装 `pilk`,填它的 `python.exe` 路径;PATH 里还要有 ffmpeg。
  23. 3. `accounts.json` 和 `watchlist.json` 含本人账号和朋友的微信号,已在 `.gitignore` 里,不要提交、不要外传。运行目录或发布目录落在 skill 目录内时,`prepare_snapshot.py` / `publish.py` 直接报错退出。
  24. ## 三道门(不可越过)
  25. 1. **账号门**:只处理用户点名的账号。别名在 `accounts.json` 里唯一对应一个 account_id 即视为授权,向用户报出这个 ID;没登记的,预检后把账号 ID 原样列出,让用户回复准确 ID。不按目录大小、修改时间猜。用户没说哪个号时,问一次。
  26. 2. **点名门**:只导出用户这次点名的人,或用户明确说「关注名单里的人」。不替用户加人,不按「可能是朋友」推断,不做全量导出。
  27. 3. **只看点到的人**:`select_people.py` 的输出里只有点名命中的候选,可以报给用户核对;其余联系人只报总数。不自己去查解密库里的联系人表,不读正文,不报密钥。导出的聊天内容用户没让看就不打开。
  28. ## 流程
  29. 1. **拿到名单**:用户给名字(备注名、昵称或微信号都行)。没给就问「要谁的」,不往下跑。
  30. 2. **预检(只读)**:`python -I scripts/preflight.py`。看 `weixin_version`、账号列表、缺失依赖。微信必须登录着目标账号且全程保持运行。
  31. 3. **快照 + 解密**:`python -I scripts/prepare_snapshot.py --account-id <别名或ID>`。要读微信进程内存取密钥,耗时数分钟,用后台跑。记下 `run_root`。
  32. 4. **点名**:`python -I scripts/select_people.py --run-root <run_root> --name "<名字>" [--name ...] [--wxid <微信号>] [--from-watchlist]`
  33. - `status: awaiting_export`:每个点名都精确且唯一命中。把 `selected` 里的显示名、消息数、起止时间报给用户,直接进第 5 步。
  34. - `status: needs_attention`(退出码 2):什么都没写。把 `to_confirm`(重名、模糊命中)的候选和 `not_found` 的名字报给用户定,定下来后用 `--wxid <微信号>` 精确重跑;用户说不要的人直接去掉。`to_confirm` 里只有数量没有候选,说明点名太宽,请用户给更完整的名字。
  35. - 模糊命中即使只有一个候选也要用户确认,不自动选。
  36. - `--from-watchlist`:用户说「更新关注名单 / 上次那几个人」时用。
  37. 5. **导出**:`python -I scripts/run_export.py --run-root <run_root>`
  38. 6. **索引表**:`python -I scripts/build_index.py --run-root <run_root>`
  39. 7. **对账打包**:`python -I scripts/finalize_delivery.py --run-root <run_root>`。用户只要文字时加 `--purge-workspace` 当场清明文;还要图片/语音/视频时先不加,留到第 9 步清(媒体导出要用明文库)。明文库含全部私聊,不只是点名的人,流程结束前必须清掉。
  40. 8. **发布**:`python -I scripts/publish.py --run-root <run_root> --to <发布目录>`。发布目录由用户指定,没说就问一次;`accounts.json` 登记了 `publish_dir` 才能省略 `--to`。解压到 `<发布目录>\聊天导出_YYYYMMDD\`:`聊天索引.xlsx`(缺 `openpyxl` 时为 `聊天索引.csv`)、`聊天记录_HTML\`、`聊天记录_CSV\`、`导出摘要.json`、`README.txt`。同目录下上一版(`聊天导出_*`)自动挪进 `_archive\`。
  41. 9. **媒体(用户要图片/语音/视频时)**:`python -I scripts/export_media.py --run-root <run_root> --purge-workspace`。在发布目录里生成 `媒体\<显示名>\语音|图片|视频\`(文件名 = 北京时间_我或对方_消息ID)和 `聊天记录_含媒体\<显示名>.html`(语音可点播、图片视频内嵌),并写 `媒体导出摘要.json`。可重复跑,已导出的文件跳过。
  42. - 语音:`media_N.db` 里的 SILK → mp3。要 `accounts.json` 的 `silk_python`(装了 `pilk` 的独立 venv)和 PATH 里的 ffmpeg;缺了就原样留 `.silk`。
  43. - 图片:解密 `msg\attach\<md5(微信号)>\` 下的 `.dat`,优先原图;只有缩略图的,文件名带「_缩略图」。V2 密钥按 `MD5(uin + 微信号)` 前 16 位推导(uin 取自 `%APPDATA%\Tencent\xwechat` 下各 `kvcomm` 目录的文件名),推不出来才扫微信内存。
  44. - 视频:`msg\video\` 下的 mp4 原样拷贝。
  45. - 用户没在这台电脑上点开过的图片/视频,本机没有文件,摘要里计入 `missing`,如实报。
  46. - 动画表情、文件附件目前不导出。
  47. 10. **汇报**:终态 complete 且对账、ZIP CRC 通过才算完成。报:导出了谁(会话数、消息数)、没导出的私聊会话数、媒体各类的导出数和缺失数、发布目录绝对路径。确认 `source_copy` 和 `private` 已清。
  48. ## 关注名单
  49. - `watchlist.json`(skill 根目录,不入 git):账号 ID → 点过名的人(微信号、当时的叫法、加入日期)。`select_people.py` 成功后自动追加。
  50. - 移除某人:删掉 `watchlist.json` 里对应条目。
  51. - 同一个朋友有两个微信号:两个都用 `--wxid` 点名。
  52. ## 失败处理
  53. - 读微信内存取密钥属于非常规操作。导出后如果遇到微信网络异常、登录异常,先停手,不再碰微信进程。
  54. - 第 3 步(解密并通过 SQLite 校验)已在微信 4.1.x、4.2.0.13 上验证。微信再升级后第 3 步失败就如实报,不绕过检查。
  55. - `validated keys do not cover all databases ... missing: <库>`:先确认登录的就是该账号、聊天列表已加载(把会话列表往下翻一翻),再新建运行重跑。
  56. - 缺 `pycryptodomex` / `zstandard` / `openpyxl`:说明用途,用户同意再装。`openpyxl` 缺失会降级为 CSV 索引,不阻塞。
  57. - 版本不是 4.x、核心库缺失、SQLite 校验失败、数量不守恒:停止并如实报告。不交部分结果。
  58. - 失败的运行目录里若残留 `source_copy`(加密快照)或 `private`(明文库),告诉用户可以删,不要自己删。
  59. - **导完后要去掉某人**:把 `会话清单.csv` 里那一行「是否导出」列的 Y 清掉,跑 `python -I scripts/resync_delivery.py --run-root <run_root>`,它直接在发布目录里删掉这个会话并重写摘要和索引。只能删人;要加人得从第 3 步重来(明文库已清)。
  60. - 要重跑第 5 步:先把 `<run_root>\delivery` 挪走;已 purge 的运行只能从第 3 步重来。
  61. ## 目录约定
  62. - 运行目录:`accounts.json` 里该账号的 `output_root`(`<output_root>\<wxid>\<时间>-run\`),没填时默认 `%LOCALAPPDATA%\WeChatChatExport\runs`。必须在微信数据目录和 skill 目录之外。跑完只剩 `会话清单.csv`(仅点名的人)、`run-state.json`、`delivery\索引数据.json`。
  63. - 解密明文库一律 purge,不留、不归档。
  64. - 微信数据目录只读,不改不删。
  65. ## 维护
  66. - 改代码后跑 `python -B -m pytest -p no:cacheprovider tests -q`(当前 72 条)。`export_media.py`、`image_dat.py` 还没有单元测试,目前只靠实机验证(语音、图片、视频逐个用 ffprobe 校验)。
  67. - 导出时间统一按北京时间(UTC+8)。
  68. - 账号别名、数据根目录、运行与发布目录只改 `accounts.json`。
  69. - `accounts.json` 含本机真实账号 ID,`watchlist.json` 含朋友的微信号,都不入 git,不要推到远端。
  70. - 兼容性与安全细则:`references/compatibility-and-safety.md`;交付物契约:`references/output-contract.md`。
README.md · README · 45 lines
  1. # 微信指定好友聊天导出(Claude Code skill)
  2. 只导出你点名的人的微信一对一聊天记录。Windows 微信 4.x,全程本机处理,不联网。
  3. ## 安装
  4. ```powershell
  5. git clone https://github.com/disuxiaoshuo339-beep/wechat-chat-export-skill.git "$env:USERPROFILE\.claude\skills\微信指定好友聊天导出"
  6. cd "$env:USERPROFILE\.claude\skills\微信指定好友聊天导出"
  7. python -m pip install pycryptodomex zstandard openpyxl
  8. copy accounts.example.json accounts.json # 然后按 SKILL.md「首次使用」填
  9. ```
  10. 重开 Claude Code 后直接说:「导出我和 XX 的聊天记录」。
  11. ### 用 Codex 等其他 AI 助手
  12. 克隆到任意目录,在 AI 助手里打开这个目录作为项目,然后发:
  13. ```text
  14. 请先阅读根目录 AGENTS.md 和 SKILL.md,按其中流程帮我导出本机微信里和 XX 的聊天记录,现在先只做只读预检。
  15. 账号由我确认;聊天内容、联系人、数据库、密钥和导出结果都不要发到对话或 GitHub;不要执行 git add/commit/push。
  16. ```
  17. ### 预检找不到账号?
  18. 预检会自动读取微信记录的存储位置(`%APPDATA%\Tencent\xwechat\config\*.ini`)。仍找不到时,在微信「设置 → 文件管理」看存储位置,把它填进 `accounts.json` 的 `search_roots`,或运行 `python -I scripts/preflight.py --root "<存储位置>"`。
  19. ## 使用前提
  20. - Windows,微信 4.x 已登录目标账号,导出期间保持运行。
  21. - Python 3.11+。
  22. - 只能导出本机微信里的聊天;没在这台电脑上打开过的图片、视频导不出来。
  23. ## 声明
  24. - 本项目不是微信或腾讯官方产品,与其无关联。
  25. - 只用于导出你本人账号、本人电脑上的聊天记录。导出他人聊天内容前,请确认符合当地法律和对方意愿。
  26. - 读取微信进程内存取密钥属于非常规操作,可能违反微信软件许可协议,风险由使用者自行承担。
  27. - 代码使用 [MIT 许可证](LICENSE),按现状提供,不作任何保证。
  28. ## 注意
  29. - `accounts.json`、`watchlist.json` 和导出的聊天记录都含个人信息,不要提交、不要外传。`accounts.json`、`watchlist.json` 已在 `.gitignore` 里;运行目录和发布目录不允许放在 skill 目录内(`prepare_snapshot.py`、`publish.py` 会报错退出),`.gitignore` 另外兜底排除了导出产物和中间文件(`聊天导出_*/`、`_archive/`、`*-run*/`、`*.zip`、`会话清单.csv`、`*.db` 等)。
  30. - 流程、三道门、失败处理见 `SKILL.md`。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.