ChatVault 文档

故障排查

确定失败阶段，检查可用数据，再以可验证结果的方式重试。

弹出窗口无法加载聊天

确认 web.whatsapp.com 是活动标签页且已经登录。等待聊天列表加载，再使用“联系人/聊天”中的“刷新”。检查 ChatVault 在同一个浏览器配置文件中已启用。

扩展更新或连接错误后，关闭弹出窗口，刷新 WhatsApp Web，再重新打开 ChatVault。如果扩展仍无法访问页面，请检查浏览器的网站访问限制。

检查所选对话及“开始日期”“结束日期”的值，再与 WhatsApp Web 对照。确认所需历史时段实际能在该网页会话中打开。

尝试一个更短但有实际意义的时段，两端附近应有可识别的消息。记下检查内容。下载成功或消息数量很多，并不能证明不可用或已删除的记录也被保存。

首先完整解压 ZIP。从解压文件夹打开主文档，并将媒体文件夹放在旁边。如果移动前文件正常、移动后失败，请检查相对文件夹结构。

附件缺失时，阅读 report.txt，并在 WhatsApp Web 中测试原始项目。只有原始文件仍可访问时，才在刷新页面后重试。对于 Excel，解压 ZIP，在兼容的电子表格应用中打开 .xlsx 工作簿。如果应用无法打开，可尝试 CSV，并按照导出格式指南操作。

操作期间保持弹出窗口和 WhatsApp Web 都打开。导出工具收集消息或获取媒体时，避免切换对话、刷新标签页或关闭浏览器。

如果停止运行或看到失败状态，不要将其视为已验证的存档。返回 ChatVault，检查活动对话，并重试一个便于处理的范围。作为最终副本存储前，检查生成的 ZIP。

记录浏览器和 ChatVault 版本、所选格式、对话的大致时段及可见错误。说明失败发生在加载聊天、收集消息、获取媒体，还是打开下载文件时。

联系支持时提供这些细节，必要时附上已遮盖敏感内容的示例。首次消息不要发送完整对话、登录信息或许可证密钥。