安装与使用准备
项目现名「聊记」；历史安装器及合成图示可能显示旧名「留痕」。界面请对照适用版本。
本页目录
产品和安装来源
本手册面向 聊记 chat-archive。仓库名 pywxdump 不表示这里使用旧 PyWxDump 网页工具。 普通用户使用 Windows 桌面安装包，不需要先安装 Python、Node.js 或数据库。
当前已核验安装包为 0.2.68；下文操作步骤仍按本手册基线说明： 聊记 0.2.68 Windows x64 安装包。
2026-10-20 已按既有可信 Ed25519 公钥验签，并从公网完整下载核对字节与 SHA-256；未执行安装器。安装包地址取自 公开发布清单。
| 核对项 | 0.2.68 的记录 |
|---|---|
| 文件名 | chat-archive-0.2.68-win-x64-setup.exe |
| 长度 | 57,142,685 字节，约 54.5 MiB |
| 安装包 SHA-256 | 66dff8f9e2250df15a6db2fa8a6ea52a8ba697ac7637a6ebe7fe008668b90448 |
| 包类型 | Windows x64 安装器，非源码 ZIP |
| 当前版本查询 | 聊记的设置 → 使用偏好 → 应用更新 |
如需手工核验下载文件，可在 PowerShell 对自己下载的安装器运行：
Get-FileHash -Algorithm SHA256 -LiteralPath "$env:USERPROFILE\Downloads\chat-archive-0.2.68-win-x64-setup.exe"只有下载文件的摘要与对应可信发布清单一致才继续。 这个命令以默认“下载”目录举例；若浏览器保存到了其他目录，改为实际文件位置。 不把这里记录的旧版本摘要用于校验未来新版本。
安装行为
安装器的默认程序目录是 %LOCALAPPDATA%\Programs\chat-archive。
安装为当前 Windows 用户安装，默认不要求管理员权限。
安装程序不提权，不代表调试器取密钥也不提权。
下载安装器后，在 Windows 文件管理器中打开它，按安装向导完成。 首次启动使用桌面或开始菜单中的 留痕（历史安装器）快捷方式。 需要确认 Windows 的任何安全提示时先核对来源，不以手册为由关闭系统保护。 本手册基线核对时没有覆盖安装现有客户端，安装界面文字以实际向导为准。
第一次建档前的检查项
| 条件 | 怎样检查 | 不满足时 |
|---|---|---|
| 电脑 | 具有 x64 兼容 Windows 环境；本手册只覆盖 Windows 采集端 | 其他系统不要套用本地取键流程 |
| 微信账号 | 电脑上已登录本人账号，账号页可核对身份 | 登录后重新检测 |
| 聊天来源 | 想归档的聊天确实已在电脑微信中保存 | 聊记不会凭空获取手机上未迁入电脑的历史 |
| 可用磁盘 | 留出归档库、快照、索引、媒体与导出的余量 | 先用短时间、单会话测试，不承诺固定空间比例 |
| 电源和运行状态 | 长任务期间保持电脑醒着，聊记后台运行 | 休眠或退出会影响进度，恢复后检查任务状态 |
| 授权 | 只处理本人或已经取得合法授权的数据 | 不使用他人账号或越权取得密钥 |
软件检测结果决定可用取键方式，不靠手册指定版本号强行打开某个方式。
被动扫描的代码边界为微信版本低于 4.1.10.31 且客户端运行、版本可识别。
较新版本通常只提供调试器方式；未知版本或脚本不可用不能保证成功。
此界限来自当前代码，不是所有微信版本的兼容承诺。
程序、档案和导出分别在哪里
| 对象 | 默认位置或入口 | 含义 |
|---|---|---|
| 程序 | %LOCALAPPDATA%\Programs\chat-archive | 可执行程序与运行依赖 |
| 聊天档案 | %LOCALAPPDATA%\chat-archive | 本地归档与应用状态；不等于微信源目录 |
| 微信源文件 | 由检测得到，本手册不固定账号目录 | 聊记读取的来源；不要手工猜目录或删除 |
| 导出 | 导出记录 → 打开保存目录，或 下载网页包 | 可交给别人阅读的独立文件 |
| 运行日志 | 托盘菜单 打开日志 | 排错入口；转发前检查敏感字段 |
卸载确认说明明确表示：卸载程序不会删除聊天档案。 如果还要删除档案，应先完成备份与恢复核验，再单独处理数据目录； 手册不提供一键删除真实档案的命令。
窗口和后台
桌面窗口关闭通常收进托盘，后台任务和自动同步可以继续。 托盘菜单 显示窗口 恢复界面，退出 才是退出聊记；有运行任务或更新时按提示处理。 若桌面 WebView2 初始化失败，代码会退回浏览器打开本机界面。 看到浏览器窗口并不等于软件未启动。
手机要访问的是已经部署的远程 HTTPS 服务。 电脑的回环地址不能在手机上打开，也不应把本机默认无登录的采集服务暴露到局域网。
最短检查路径
首次只归档一个会话的一小段日期，确认总览、会话与附件状态后再扩大范围。 关键字搜索需另建索引，远程阅读需先配对和同步，公开分享需单独生成链接。 具体操作见首次建档、同步和故障排查。