常见问题

免费额度相关问题

免费额度用尽会怎样？

系统自动回退到下一个免费额度模型重试（单请求最多 3 次）；全部用尽后界面提示「请切换到付费模型」，可在 /admin 模型管理手动切换。

为什么我看不到免费额度？

免费额度仅华北2（北京）地域生效。请到百炼控制台「免费额度」页核实开通地域，并在 .env 使用中国内地端点 dashscope.aliyuncs.com。

课堂生成与播放

生成时报 504 超时？

Nginx proxy_read_timeout/proxy_send_timeout 需配置 300s；DashScope 生成期间不返回响应头，undici 超时已调至 600s（PATCH-009）。

课堂无法在智训宝中播放？

依次检查：① 课堂已发布（/admin 发布管理）；② iframe 白名单 ALLOWED_FRAME_ANCESTORS 含网校域名；③ 防盗链白名单已添加网校域名；④ 访问码 ACCESS_CODE 为空或 URL 携带正确令牌。

如何离线导出课堂？

在课堂播放页使用「离线资源包导出」，产物为 PPTX + 交互式 HTML，外部资源全内联，断网可播。

部署与配置

OSS 上传报 503 not configured？

standalone/.env 未 symlink 到根 .env，运行期读不到 OSS_* 配置。执行：rm -f .next/standalone/.env && ln -s <root>/.env .next/standalone/.env && pm2 restart eduopenai。

如何修改默认模型？

方式一：/admin 模型管理运行时切换（持久化，重启保持）；方式二：改 .env 的 DEFAULT_MODEL + pm2 restart。

ACCESS_CODE 和 ADMIN_ACCESS_CODE 有什么区别？

ACCESS_CODE 是站点级访问码（所有页面与 API），当前关闭以支持 iframe 嵌入；ADMIN_ACCESS_CODE 是管理后台独立口令，独立生效。

生产环境（www.eduopenai.com）与开发环境如何同步？

dev 先行验证 → 七哥确认 → prod 同步（Core 由巧匠执行）→ 旺财验收。版本一致（同 commit 基线）、配置分环境管理、密钥不入库。