问题排查：调试面板、Service Worker 与常见故障

遇到加载异常、Service Worker 问题、AI 生成失败或存储异常时，本文介绍如何定位并解决常见问题。

调试面板

Opentu 提供了一个内置的调试面板，可以帮助定位问题。

打开调试面板

在浏览器地址栏输入对应环境的调试面板地址：

环境调试面板地址
正式环境https://opentu.ai/sw-debug.html
体验环境https://pr.opentu.ai/sw-debug.html
规则：在当前应用地址后面加 /sw-debug.html

调试面板功能

调试面板界面如下：

调试面板

调试面板提供以下功能：

1. Service Worker 状态

显示当前 Service Worker 的运行状态：

2. 导出诊断日志

点击 导出日志 按钮，会下载一个 JSON 文件，包含：

提示：遇到问题时，导出日志文件发给开发者，可以帮助快速定位问题。

3. 数据备份

在调试面板中也可以进行数据备份：

4. 清除缓存

如果应用出现异常（如页面空白、功能失效），可以尝试清除缓存：

注意：清除缓存不会删除你的项目和素材，只会清除应用程序的缓存文件。

常见问题

AI 生成功能不可用

症状：点击发送后没有反应，或提示错误 排查步骤：

1. 检查网络连接 - 确保网络正常 - 尝试刷新页面

2. 检查 API 配置 - 打开 菜单 → 设置 - 确认 API Key 已正确填写 - 确认 API 地址正确

3. 检查 API 额度 - 登录 API 服务商后台查看余额

4. 查看调试面板 - 打开 sw-debug.html - 查看是否有错误日志

页面加载缓慢或空白

症状：页面长时间白屏或加载很慢 解决方法：

1. 清除浏览器缓存 - 打开调试面板 - 点击 清除缓存 - 刷新页面

2. 硬刷新 - Windows: Ctrl + Shift + R - Mac: Cmd + Shift + R

3. 检查浏览器兼容性 - 推荐使用 Chrome、Edge、Safari 最新版 - 不建议使用 IE 浏览器

素材库图片不显示

症状：素材库中的图片显示为空白或加载失败 解决方法：

1. 检查存储空间 - 浏览器本地存储可能已满 - 删除不需要的素材释放空间

2. 清除并重新缓存 - 打开调试面板 - 查看缓存状态 - 尝试清除异常的缓存项

数据丢失

症状：项目或素材突然消失 可能原因：

1. 浏览器数据被清除 - 检查是否使用了"清理工具" - 检查浏览器隐私设置

2. 使用了无痕/隐私模式 - 无痕模式关闭后数据会丢失 - 请使用正常模式

预防措施：

视频生成一直等待

症状：视频任务长时间显示"处理中" 说明：

视频生成需要较长时间（1-5 分钟甚至更长），这是正常的。

如果超过 10 分钟：

1. 在任务队列中查看任务状态 2. 如果显示失败，点击 重试 3. 检查调试面板中的错误日志

快捷键不生效

可能原因：

1. 焦点在输入框中 - 点击画布空白区域，确保焦点在画布上

2. 与浏览器快捷键冲突 - 某些快捷键可能被浏览器占用 - 尝试使用工具栏按钮代替

3. 输入法干扰 - 切换到英文输入法 - 关闭输入法后重试

获取技术支持

如果以上方法无法解决问题：

1. 收集信息

2. 联系方式

用户交流群二维码

3. 提交问题时请包含