Regulus Academy

Appearance

AI 模型配置 ​

路由：#/settings/model · 设置 → AI 模型

Regulus 通过 OpenAI 兼容接口调用大模型完成讲解、出题、批改与建课。配置好 API Key 后，首页与左下角会显示「模型已连接」。

三种配置方式 ​

方式适合谁说明
Web 设置页所有用户#/settings/model 添加模型卡片，保存即生效
.env 文件自托管 / Docker首次启动前写入 LLM_API_KEY；可与 Web 配置并存
Cloud BYOK在线 Demo 额度用尽后在设置页填写自己的 Key，消息走你的账户计费

左下角菜单可快速切换当前使用的模型（无需每次进设置页）。

Web 设置页怎么用 ​

  1. 打开 设置 → AI 模型
  2. 填写 显示名称、接口类型（DeepSeek / OpenAI / Ollama 等）、模型 ID
  3. 按需填写 API Key（可留空以沿用全局 Key）
  4. 点 测试 探测连接，点 保存 写入配置
  5. 在左下角将本条设为「使用中」

支持添加多条模型配置（如「DeepSeek 主力」「本地 Ollama」），随时切换。

支持的接口类型 ​

类型说明
deepseek默认推荐；Key 见 DeepSeek 开放平台
openaiOpenAI 官方 API
openrouter多模型聚合
ollama本地 Ollama，通常无需 Key
custom任意 OpenAI 兼容接口，须填 Base URL（只填域名，不要带 /v1/chat/completions）

保存后写入 data/llm-profiles.json；若保存的是当前使用中的模型，会同步更新 .env 运行时配置。

自托管：.env 快速配置 ​

Docker 或 go run 启动前，在仓库根目录：

bash
cp .env.example .env
bash
LLM_PROVIDER=deepseek
LLM_API_KEY=sk-...
# LLM_MODEL=deepseek-chat    # 可选
# LLM_BASE_URL=              # custom 时必填

修改 .env 后需重启后端（docker compose restart 或重新 go run）。

Cloud 在线 Demo ​

  • 无需 Key 即可开始：平台提供每日免费教练消息额度
  • 额度用尽后，在设置页填写自己的 Key（BYOK）继续使用
  • 首页会展示今日剩余额度；用尽时页面会提示配置 Key

详见 在线体验版。

教练行为调优（可选） ​

除模型本身外，还可通过环境变量调整「练多少才点亮」等行为，与模型选择无关：

变量作用
REGULUS_STRICT_CONCEPT_COVERAGE多核心概念时是否建议多练几题
REGULUS_REQUIRE_APPLY_EXERCISE熟悉/精通层是否建议应用级练习
REGULUS_LLM_COMPLETION_CHECK点亮前是否做 LLM 综合评估

完整列表与组合示例见 环境变量。

常见问题 ​

首页显示「未配置 API Key」
自托管：检查 .env 中 LLM_API_KEY 并重启后端；或在 Web 设置页保存一条带 Key 的模型并设为使用中。

建课很慢或超时
可调大 REGULUS_LLM_TIMEOUT_SEC、REGULUS_DOMAIN_BUILD_TIMEOUT_SEC，或换更快的模型。见 环境变量。

Ollama 连不上
确认本机 ollama serve 已启动，且 LLM_BASE_URL 指向正确地址（默认 http://localhost:11434）。

相关 ​