管理員指南
使用者管理
查看和管理平臺所有註冊使用者
查看和管理平臺所有註冊使用者,包括修改角色、配額、分組,以及帳號狀態控制。使用管理員帳號登入後,於左側導覽點擊「使用者管理」,或直接存取 `/console/user`。Web 控制台列表頁與參考設計一致,正在串接中。
| ID | 使用者名稱 | 狀態 | 剩餘/總額度 | 分組 | 角色 | 邀請資訊 | 操作 |
|---|---|---|---|---|---|---|---|
| 1 | admin | 已啟用 | ∞ / ∞ | default | 管理員 | — | 停用 · 編輯 · 降級 · ··· |
| 2 | demo_user | 已啟用 | 1200 / 5000 | default | 一般使用者 | 邀請人 #1 | 停用 · 編輯 · 提升 · ··· |
使用者列表示意:搜尋篩選 + 角色/狀態徽章 + 列內管理操作
編輯使用者
開啟編輯彈窗
- 在使用者列表的該列點擊「編輯」
- 或呼叫
GET /api/user/{id}取得詳情後開啟表單 - 新建使用者請點擊「新增使用者」,對應
POST /api/user
修改使用者資訊
在彈窗中可調整以下欄位:
| 欄位 | 說明 |
|---|---|
nickname · 顯示名稱 | 使用者暱稱,於列表與個人資訊中顯示 |
username · 使用者名稱 | 登入名稱;建立後可修改,需保持唯一 |
password · 密碼 | 新建時必填;編輯時留空表示不修改 |
role · 角色 | 一般使用者 / 管理員 / 超級管理員 |
group · 分組 | 如 default、vip、test 等 |
quota · 額度 | 帳戶總額度上限;可搭配已用額度查看剩餘 |
remark · 備註 | 僅管理員可見的說明 |
列內「提升 / 降級」用於調整 role;「停用 / 啟用」切換 status,也可透過 POST /api/user/{id}/action 執行。
儲存修改
- 編輯既有使用者:點擊「儲存」呼叫
PUT /api/user/{id} - 建立新使用者:填寫使用者名稱與初始密碼後
POST /api/user - 刪除使用者:
DELETE /api/user/{id}(無法復原,請謹慎操作) - Root 可重設使用者 2FA:
DELETE /api/user/{id}/2fa;重設 Passkey:DELETE /api/user/{id}/reset_passkey
搜尋使用者
使用搜尋功能
- 支援依使用者 ID、使用者名稱、顯示名稱(nickname)關鍵字搜尋
- 可依分組下拉篩選,僅顯示該分組使用者
查看搜尋結果
- 點擊「查詢」呼叫 GET /api/users?keyword=;「重設」清空條件並恢復預設列表
- 列表支援分頁與「重新整理列表」重新載入 GET /api/user/
列表由 GET /api/users 分頁回傳;帶 keyword 參數即為搜尋。
列表欄位說明
| 欄 | 欄位 | 說明 |
|---|---|---|
| ID | id | 使用者唯一識別碼 |
| 使用者名稱 | username | 登入帳號,唯一 |
| 狀態 | status | 已啟用 / 已停用;停用後無法登入與呼叫 API |
| 剩餘額度/總額度 | quota - used_quota / quota | 帳戶可用額度與已用額度 |
| 分組 | group | 決定可用模型與渠道路由分組 |
| 角色 | role | 1 一般使用者、10 管理員、100 超級管理員 |
| 邀請資訊 | inviter_id / aff_code | 邀請人 ID 或推廣碼來源 |
- 停用 / 啟用:切換 status;停用後立即無法登入
- 編輯:開啟編輯彈窗,修改配額、分組、角色等
- 提升 / 降級:調整 role(如一般使用者 ↔ 管理員)
- 更多:刪除使用者、重設 2FA / Passkey 等(Root)
管理員側邊欄可在 個人設定 → 側邊欄模組中開啟 sidebar_modules.admin.user。分組與配額說明見 分組管理 與 配額與儲值。