管理员指南
系统设置
Root 专属的全局站点与运营配置
系统设置以 Tab 分类管理站点信息、计费、支付、登录注册、顶栏导航等。仅 Root 角色（role=100）可访问，在左侧边栏「管理员区域 → 系统设置」进入，或直接访问 `/console/setting`。配置读写对应 `GET /api/option/` 与 `PUT /api/option/`。Web 控制台页面与参考设计一致，正在对接中。
通用配置
- 充值链接 · 文档地址 · 失败重试次数 · 额度显示类型
- 演示站点模式 · 自用模式 · 用户最大令牌数量
顶栏管理
系统设置示意：Tab 分类 + 通用配置表单 + 顶栏开关
通用设置
通用配置项
| 配置项 | 字段 | 说明 |
|---|---|---|
| 充值链接 | TopUpLink | 用户充值页或外部收银台 URL |
| 文档地址 | DocumentationLink | 站点顶部「文档」跳转地址，如 https://docs.example.com |
| 失败重试次数 | RetryTimes | 上游请求失败时的自动重试次数 |
| 额度显示类型 | QuotaDisplayType | USD、CNY 或 TOKEN；影响控制台与模型广场展示 |
| 配额查询扣费 | QuotaQueryEnabled | 开启后，若配额查询接口返回非零余额则扣除用户额度 |
| 默认倍率名称 | DefaultRatioName | 模型定价页展示的默认倍率标签 |
| 演示站点模式 | DemoSiteEnabled | 演示环境限制部分写操作 |
| 自用模式 | SelfUseModeEnabled | 关闭公开注册或限制外部分发 |
| 用户最大令牌数 | MaxUserTokens | 每个用户可创建的 API 令牌上限 |
修改后点击「保存通用设置」，调用 PUT /api/setting 写入 setting 表。读取当前值使用 GET /api/settings。
顶栏管理
通过开关控制站点顶栏各入口是否对用户可见：
| 顶栏项 | 说明 |
|---|---|
| 首页 | 站点顶栏 Home 入口 |
| 控制台 | 控制台入口 |
| 模型广场 | 模型定价列表 /models |
| 文档 | 文档中心入口 |
| 模型广场详情 | 模型详情页顶栏入口（可选） |
| 关于 | 关于页入口 |
仪表盘设置
数据看板展示项与统计范围。详细字段与示例见 系统设置详细配置 文档中对应章节。
聊天设置
操练场、聊天页默认模型与相关开关。详细字段与示例见 系统设置详细配置 文档中对应章节。
绘图设置
Midjourney 等绘图类任务相关参数。详细字段与示例见 系统设置详细配置 文档中对应章节。
支付设置
易支付、Stripe、Creem 等充值与支付渠道。详细字段与示例见 系统设置详细配置 文档中对应章节。
分组与模型定价设置
分组倍率、模型 ratio 与同步。详细字段与示例见 系统设置详细配置 文档中对应章节。
速率限制设置
全站或按模型的请求频率限制。详细字段与示例见 系统设置详细配置 文档中对应章节。
模型相关设置
模型列表、映射与全局模型策略。详细字段与示例见 系统设置详细配置 文档中对应章节。
性能设置
缓存、连接池等性能相关选项。详细字段与示例见 系统设置详细配置 文档中对应章节。
系统设置
数据库、日志级别、维护模式等核心参数。详细字段与示例见 系统设置详细配置 文档中对应章节。
其他设置
OAuth、通知、杂项开关。详细字段与示例见 系统设置详细配置 文档中对应章节。
相关说明
- Root 专属：普通管理员（role=10）无系统设置 Tab，边栏模块
sidebar_modules.admin.setting亦仅对 Root 开放 - 与 个人设置（
/setting）不同，后者为当前用户账号与安全配置 - 倍率同步可选
POST /api/ratio_sync/fetch；重置模型倍率POST /api/setting/rest_model_ratio - 第三方 OAuth 扩展见 自定义 OAuth 提供商