管理員指南
系統設定
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 提供者