验证码邮件收不到
- 检查邮箱的垃圾邮件/广告邮件文件夹，验证码邮件可能被误分类
- 确认邮箱地址拼写正确，没有多余的空格或特殊字符
- 等待 1-2 分钟后重新发送，部分邮箱服务商有延迟
- 企业邮箱可能拦截外部邮件，建议使用 Gmail、QQ 邮箱或 163 邮箱
- 如果使用自建域名邮箱，检查 MX 记录和反垃圾策略
00TROUBLESHOOT
常见问题与故障排除
使用 TheWow 过程中遇到问题？在这里找到解决方案。按类别查找你遇到的问题，按照步骤排查即可。
01LOGIN
登录与账号问题
登录过程中最常见的问题及解决方案。
验证码输入后提示「验证失败」
- 验证码有效期 5 分钟，过期后需重新发送
- 确认输入的是邮件中的 6 位数字，不要包含空格
- 每验证码只能使用一次，重复使用会失败
- 如果多次失败，等待 1 分钟后重新发送新验证码
桌面端登录回调失败
- 确认桌面端有权限打开系统默认浏览器
- 检查浏览器是否阻止了 thewow:// 协议跳转
- 回调超时（超过 5 分钟）会失败，在桌面端重新点击登录
- 如果使用非默认浏览器，尝试将系统默认浏览器切换为 Chrome 或 Edge
登录后立即被踢出
- 检查系统时间是否正确，时间偏差过大会导致 token 验证失败
- 确认没有多个浏览器标签页同时操作登录
- 清除浏览器缓存和 Cookie 后重新登录
- 如果问题持续，联系管理员检查账号状态
02ENTITLEMENTS
权益与兑换问题
礼品码兑换、权益同步和次数相关的常见问题。
兑换礼品码提示「已兑换」
- 每个礼品码只能兑换一次，如果之前已兑换过则无法再次使用
- 检查是否在其他账号下兑换过此礼品码
- 如果确定未兑换过但提示已兑换，联系购买渠道的客服处理
兑换成功但桌面端显示无权益
- 桌面端每 30 秒同步一次权益数据，等待 1 分钟后重试
- 在桌面端退出登录后重新登录，强制刷新权益
- 确认兑换时登录的账号与桌面端登录的账号一致
- 在网页端用户中心查看权益是否已生效
权益次数用完了怎么办
- 购买新的礼品码并兑换，新旧权益会叠加
- 永久权益不会消耗次数，优先使用永久权益的功能
- 在网页端用户中心可以查看剩余次数明细
- 不同版本的权益独立计算，升级版本后原有权益不受影响
权益过期了
- 有次数限制的权益（counted）可能设置了有效期，过期后无法使用
- 永久权益（permanent）不会过期，可永久使用
- 过期权益不会自动恢复，需要兑换新的礼品码
- 在用户中心查看每条权益的过期时间
03AI MODEL
AI 模型问题
模型调用、回答质量和识别准确率相关的常见问题。
AI 不回答 / 回答超时
- 检查网络连接是否正常，部分 API 需要稳定网络
- 如果使用自定义模型，确认 API Key 余额充足
- 免费模型在高并发时可能排队，等待 10 秒后重试
- 尝试切换到其他模型（如从免费模型切换到自定义模型）
- 截图内容过于复杂可能导致处理时间较长，尝试缩小截图范围
回答内容乱码或格式异常
- 检查推理格式是否与当前模型匹配（详见「自定义模型配置」文档）
- 尝试切换推理格式为 none 测试
- 部分模型对特殊字符支持不好，尝试简化问题
- 如果是免费模型出现问题，可能是临时故障，稍后重试
识别不出题目
- 确保截图中文字清晰可读，分辨率过低会影响识别
- 截图区域要完整包含题目，不要裁切掉关键部分
- 如果题目包含公式或代码，尝试使用支持多模态的模型
- 全屏截图时 AI 会自动识别题目区域，但有时可能识别错误，改用区域截图
自定义模型添加后不显示
- 确认 Provider 状态为「启用」
- 确认模型状态为「启用」
- 刷新桌面端设置面板或重启应用
- 检查模型 ID 是否与 API 提供商的模型列表一致
04NETWORK
网络问题
网络连接、代理和 API 访问相关的常见问题。
国内网络无法访问某些 API
- OpenAI、Anthropic 等国外 API 通常需要代理才能访问
- 推荐使用国内 API：通义千问（阿里云）、智谱 GLM、DeepSeek
- 也可以使用 OpenRouter 作为中转，支持几百种模型
- 免费模型由平台代理转发，不受网络限制
网页端操作正常但桌面端报错
- 桌面端和网页端使用不同的网络通道，桌面端可能受防火墙影响
- 检查系统防火墙是否阻止了 TheWow 的网络请求
- 如果使用公司网络，可能有白名单限制，联系 IT 部门
- 尝试切换网络环境（如从公司 WiFi 切换到手机热点）测试
同步数据很慢
- 权益数据同步每 30 秒一次，首次登录可能需要等待
- 模型目录同步依赖网络质量，差网络下可能有延迟
- 如果持续慢，检查是否有 VPN 或代理影响连接速度
05APP
桌面端应用问题
桌面端安装、启动和使用相关的常见问题。
桌面端无法启动
- 确认系统为 Windows 10 或更高版本
- 尝试以管理员权限运行
- 检查是否被杀毒软件拦截，将 TheWow 加入白名单
- 卸载后重新下载安装最新版本
快捷键不生效
- 检查快捷键是否与其他软件冲突（如输入法、录屏软件）
- 在设置面板中查看并修改快捷键配置
- 确认 TheWow 在后台运行中（任务栏有图标）
- 部分远程桌面环境下快捷键可能被拦截
浮窗被其他窗口遮挡
- 在设置中确认「置顶浮窗」选项已开启
- 某些全屏应用（如全屏游戏、远程桌面）可能覆盖置顶窗口
- 按 Alt + E 隐藏再显示浮窗，有时可以恢复置顶状态
- 如果问题持续，尝试以管理员权限运行 TheWow
06DIAGNOSIS
快速诊断流程
遇到问题时，按以下顺序排查，大多数问题可以在 3 分钟内解决。
1
检查网络
打开浏览器访问任意网站，确认网络正常。如果使用代理，确认代理软件运行中。
2
检查登录状态
在网页端用户中心确认已登录。如果未登录，重新走一遍登录流程。如果已登录但桌面端显示未登录，退出后重新登录。
3
检查权益状态
在用户中心查看权益列表，确认有可用的权益次数或永久权益。如果权益为空，需要兑换礼品码。
4
切换模型测试
在桌面端设置中切换到另一个模型（如从免费模型切换到自定义模型，或反之），确认是否是特定模型的问题。
5
重启应用
完全退出 TheWow（任务栏右键 → 退出），等待 5 秒后重新启动。很多临时问题可以通过重启解决。
6
联系支持
如果以上步骤都无法解决问题，收集错误截图和操作步骤，联系管理员或在用户群反馈。
07ERROR CODES
常见错误码说明
桌面端和网页端可能出现的错误码及含义。
| 错误码 | 含义 | 解决方案 |
|---|---|---|
401 | 未登录或登录已过期 | 重新登录账号 |
403 | 没有权限访问该功能 | 确认权益版本是否支持此功能 |
404 | 请求的资源不存在 | 检查模型 ID 是否正确 |
429 | 请求过于频繁 | 等待 30 秒后重试，或切换到其他模型 |
500 | 服务器内部错误 | 稍后重试，如果持续出现请联系管理员 |
503 | 服务暂时不可用 | 平台维护中，等待几分钟后重试 |
missing-supabase | 账号服务未配置 | 管理员需要配置 Supabase 环境变量 |
validation_error | 请求参数错误 | 检查输入内容是否符合要求 |
catalog_unavailable | 模型目录暂时不可用 | 稍后重试，或联系管理员检查服务状态 |