悬浮球没有出现
按顺序检查：
- 打开插件配置，确认悬浮球全局开关已开启；
- 确认当前网站不在禁用网站列表里；在禁用列表中的网站可以一键恢复；
- 确认目标图片足够大——过小的图片（图标、头像）不会触发悬浮球；
- 插件刚更新或刚安装时，刷新当前页面一次。
以上都正常仍不出现时，重启浏览器后再试。
反推或生成无法开始
- 确认已登录（工具栏图标点开可见登录状态）；
- 确认积分余额足够本次操作：反推 1 积分，生成每张 6 积分，动作参考 6 积分；
- 余额不足时：可升级付费计划或购买积分加油包；付费会员的每日免费积分每天统一刷新，见获得积分；
- 余额与登录都正常时，稍候几分钟重试。
任务长时间停在排队或创作中
- 高峰时段上游模型通道限流，任务会自动排队等待，一般几分钟内恢复；
- 刷新页面不会丢失任务，进行中的任务会继续同步状态；
- 单个任务超时会按失败处理，预占积分自动退回（见积分处理规则）。
生成失败的常见类型
| 失败提示 | 原因 | 处理 |
|---|---|---|
| 内容安全 | 参考图或提示词触发模型安全策略 | 更换参考图或调整提示词后重试 |
| 限流 | 上游模型通道繁忙 | 等几分钟再试 |
| 超时 | 单次调用超过时限 | 直接重试；批量任务在画函内补全 |
| 服务不可用 | 云端或模型服务异常 | 稍后重试；持续出现请反馈 |
所有失败任务的预占积分都会自动退回。
积分没有退回
- 失败退分最迟在 30 分钟内生效，先等待并刷新余额；
- 超过 30 分钟仍未退回：记下任务 ID（任务详情内可复制），通过官网页脚的联系入口反馈。
登录状态经常丢失
- 无痕窗口不保留登录态，属正常现象；
- 清理浏览器 Cookie 会同时清除 Viko 登录态；
- 重新登录即可，云端任务与资产不受影响。
Eagle 未检测到
- 确认本机 Eagle 已启动；
- 在插件配置中确认已启用 Eagle 连接，并点击测试连接；
- 确认 Eagle 默认端口
41595未被修改或占用。
还是没解决
通过官网页脚的联系入口反馈，附上：出问题的操作、任务 ID（如有）、大致时间。文档会随高频问题持续更新。