常见问题排查：连接失败、导出失败、数据不显示怎么办
排查前的通用思路
ChatExcel 的问题排查，建议按以下优先级：
- 先看版本：是不是用的最新版？旧版本可能有已知 bug
- 看网络：是网络问题还是 ChatExcel 本身问题？
- 看文档 / 官方 FAQ：FAQ 里已经覆盖了很多高频问题
- 联系官方客服：还解决不了就找客服
问题一：ChatDB 连接失败
典型报错
"连接超时""用户名或密码错误""无法连接到数据库"
排查步骤
- 网络可达性：你的电脑能不能 Ping 通数据库服务器的地址？（防火墙 / VPN / 服务器安全组）
- 端口开放：数据库的端口（MySQL 默认 3306）是否对 ChatExcel 的出口 IP 开放？
- 账号权限：ChatDB 连接用的账号是否正确、密码是否正确？有没有权限访问指定数据库？
- 只读账号：建议用专用只读账号，不给写权限更安全也更不容易误操作
- 数据库类型：ChatDB 网页端当前优先支持 MySQL，其他数据库可能需要 Ultra 桌面版或企业版
问题二：AI PPT / Word 导出失败
典型报错
"导出超时""文件生成失败""导出后打不开"
排查步骤
- 文件大小：生成的 PPT / Word 是否过大？（AI PPT 带很多图表和图片时文件可能较大）
- 网络：导出过程中网络是否稳定？导出是云端生成文件再下载
- 浏览器：如果是网页端，换一个浏览器试试（Chrome / Edge 兼容性最好）
- 客户端：如果客户端导出也失败，可能是本地磁盘空间不足
问题三：数据看板不刷新
排查步骤
- 看版本：自动刷新功能目前只在 Ultra 桌面版支持，网页端的看板需要手动刷新
- 看数据源：Ultra 的数据源（数据库连接 / 文件路径）是否正确？
- 看刷新频率设置：在 Ultra 里检查看板的刷新频率设置是否生效
- 手动触发：在 Ultra 看板界面手动点一下"刷新"按钮，看是否能拉到新数据
问题四：大文件上传慢 / 超时
排查步骤
- 检查版本：Pro 版单个文件最大 5MB，如果文件更大请升级 Max
- 压缩文件：Excel 里如果有很多高分辨率图片，先压缩再上传
- 改用 ChatDB：如果是数据库级的数据，ChatDB 直连比上传 Excel 更高效
- 网络：上传速度取决于你的网络带宽，如果网络波动大建议换个时间再试
问题五：AI 做表识别不准
排查步骤
- 图片质量：照片 / 截图的分辨率够不够？文字够清晰吗？有没有被遮挡？
- PDF 类型：如果是扫描版 PDF，相当于图片，需要 AI OCR 识别；如果是文本型 PDF，识别率更高
- 指令清晰度：对话框里的指令是不是足够具体？"从发票里提取金额、日期、税号"比"看看这是什么"效果好得多
- 多轮对话修正：识别不准的地方直接在对话框里指出来，让 AI 重新识别或手动修正
问题六：仓鼠元元划词 / 截图不触发
排查步骤
- 客户端版本：是不是最新版客户端？旧版本可能不支持某些应用里的划词
- 应用兼容性：在某些全屏应用或游戏里划词可能不触发，这是正常的
- 快捷键冲突：截图快捷键（默认 Ctrl / ⌘ + Shift + o）是否和系统或其他软件冲突？
- 重启客户端：关掉再打开试试
问题七：订阅 / 支付相关
排查步骤
- 订单状态：支付完成后刷新一下 ChatExcel 页面（有时候需要等几十秒到几分钟）
- 登录账号：是不是用支付时的同一个账号登录？
- 联系官方：还不行就找 ChatExcel 官方客服
还解决不了
- ChatExcel 官方提供客服渠道（官网 / 公众号 / 帮助中心）
- FAQ 页面覆盖了高频问题
- 企业版有专属技术支持
声明
以上排查建议基于常见场景整理，具体问题的解决方案以官方最新文档和客服回复为准。