管理员指南
用户管理
查看和管理平台所有注册用户
查看和管理平台所有注册用户，包括修改角色、配额、分组，以及账号状态控制。使用管理员账号登录后，左侧导航点击「用户管理」，或直接访问 `/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。分组与配额说明见 分组管理 与 配额与充值。