ChatArchiveGuard 是一款面向归档审计的开源工具，专门用来在本人导出归档交付、迁移或备份之前，先在本地做一次只读检查。它不读取他人的聊天记录，也不绕过任何登录，只处理你自己已经导出的文件，帮你发现里面有没有疑似密钥、个人信息格式、编码错误和结构问题。做归档审计这一步的意义很实际：导出文件一旦发出去就收不回来，事前花几分钟跑一次检查，远比事后补救划算。
归档审计先说清边界：它查什么、不查什么
归档审计的第一步是划清边界，这款工具的定位非常明确：它是交付前的门禁，不是阅读器，也不是证据工具。它能告诉你文件能不能正常解析、有没有敏感信息形态、有没有扫描盲区，但它不能证明消息完整、来源真实，也不能证明文件从未被篡改。把这个边界说清楚，后面就不会用错地方。
它适合的输入是你自己导出的文本、JSON、JSONL、NDJSON 和 SQLite 文件。检查过程完全在本地完成，不上传归档数据，不改写源文件，扫描 SQLite 时读取的是私有副本，进一步降低了动到原始数据的风险。对于需要把导出交给分析、迁移或备份流程的人来说，这种只读属性本身就是一道安全线。
一张表看清归档审计的检查项
| 检查维度 | 具体内容 | 对你有什么用 |
|---|---|---|
| 敏感信息形态 | 常见密钥、访问凭证和个人信息格式 | 交付前发现不该外泄的内容 |
| 编码与结构 | UTF-8、JSON、JSONL 结构校验 | 避免对方打不开或解析报错 |
| SQLite 快检 | 数据库完整性、可读文本、配套 WAL 与 SHM 副本 | 发现已提交但未归并的记录 |
| 扫描覆盖 | 遍历范围与实际扫描范围的状态区分 | 知道哪些文件没扫到，不盲目放心 |
| 报告脱敏 | 摘要模式只给类别、计数和状态 | 报告本身不再成为新的泄漏源 |
这里有一个值得单独强调的细节：报告默认不写入命中值，摘要模式还会省略文件名。也就是说，检查报告可以放心地附在交付流程里流转，而不必担心报告本身又把敏感内容带出去。做归档审计时，工具的输出同样要当作敏感物来对待，这个设计正好对上这一点。
版本选择：只用官方发布渠道，不要来路不明的打包
这款工具基于 Python 标准库，运行需要 Python 3.11 或更高版本。它可以在 macOS、Linux 和 Windows PowerShell 中运行，扫描过程不需要网络客户端，也没有遥测和自动更新。选版本时只认一条原则：从官方发布渠道获取，离线安装 wheel 之前先核对同一来源提供的 SHA-256 清单。
不要图方便去用第三方打包或所谓整合版。审计工具本身如果来源不可靠，整个检查就失去了意义。安装时优先使用隔离环境，这样既不污染系统 Python 环境，出了问题也容易清理。升级之后要重新验证一次门禁逻辑，因为扫描上限、退出码和报告字段可能随版本变化。
安装步骤：四步跑通第一次归档审计
- 确认本机 Python 版本在 3.11 或以上，准备一个隔离环境。
- 从官方发布渠道获取安装包，离线安装前核对 SHA-256 清单。
- 把本人导出的归档复制一份到单独的检查目录，原文件不动，只扫副本。
- 先用摘要模式对检查目录跑一次，看类别、计数和状态，确认没有截断状态后再决定是否交付。
第一次跑建议特意选一个你已经知道有问题的小样本，比如故意放一段测试密钥格式的文本，验证工具确实能报出来。门禁工具最怕的就是悄悄失效：跑得很快、报告很干净，但实际上什么都没扫到。用已知样本做一次正向验证，这个习惯值得保留。
必改设置：五个地方不要用默认心态带过
- 扫描范围只指向本次交付的目录：不要顺手指向整个用户目录或上级目录，摘要模式会汇总整个扫描根目录的计数，范围越大，报告越难对应到本次交付。
- 优先使用摘要模式出报告：类别、计数和状态足够做门禁判断，又避免报告里出现文件名和命中值，交付链路上更干净。
- 把退出码接进交付流程：不要只看屏幕输出就放行，让脚本或 CI 根据退出码决定是否阻断交付，人才不会在赶时间时跳过检查。
- 单独处理 SQLite 的配套文件：只拷主数据库会漏掉 WAL 里已提交但未归并的记录，检查目录里要把配套的 WAL 和 SHM 副本一并放好。
- 遇到截断状态必须停下来：文件数量、文本字节、行数或发现数量超限时会出现截断状态，这时报告是不完整的，要拆分目录或调整上限后重扫，不能直接放行。
注意事项：六个容易踩的坑
- 它不是阅读器和搜索器：想看聊天内容、导入其他系统或全文搜索，要另外选工具，不要指望它兼任。
- 压缩文件不会被自动识别为文本：需要先解压再扫描，否则压缩包里的内容会悄悄成为盲区。
- 轮转日志不会自动拼接：它不判断轮转文件覆盖的时间段是否连续，时间线类问题要靠其他流程补。
- 只认支持范围内的最终扩展名：命名不规范的文件可能进不了文本扫描，交付前先统一文件命名。
- 摘要模式不适合跨用户隔离场景：它汇总整个根目录的计数，多个人的目录混在一起扫，报告就无法对应到个人。
- 它不验证消息真实性：完整性证明、来源验证和防篡改需要独立流程，不要把审计报告当成这类证明来用。
适用人群与对比：谁最适合用它
最适合的人群是需要在交付前做检查的开发者、运维人员、数据交付人员和离线工作站使用者。典型场景是：聊天导出要交给分析、迁移或备份流程之前，先在本地跑一次隐私与格式检查；或者在 CI 里把检查设为门禁，报告不合格就不交付。如果你只是偶尔整理自己的导出文件，同样可以用它做一次事前检查，成本很低。
与通用杀毒或通用敏感信息扫描工具相比，它的优势在于专：只读、本地、针对聊天导出格式做了结构检查，还能报告扫描盲区。反过来，如果你需要的是查看内容、搜索归档、处理压缩日志或验证真实性，它就不对口，需要另选工具或补充流程。选型时先问自己一句话：我要的是交付前的检查，还是事后的内容管理？前者选它，后者不要勉强。
总的来看，ChatArchiveGuard 把归档审计做成了一件低成本、可重复的事：只读不改源文件、本地不上传、报告可脱敏、退出码可进 CI。对于经常要交付聊天导出的人，这是一道值得常驻的门禁，而不是一次性的临时检查。
关注公众号，回复 chat-archive-guard 获取下载链接
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
