AI-Hub管理端操作手册

版本:v1.0.0 | 更新日期:2026-04-23


1. 用户系统

1.1 用户管理

用户管理是平台用户全生命周期操作的集中入口。您可在此查看所有注册用户、筛选定位目标账号、并快速执行额度调整、角色变更、密码重置等关键管理动作。

界面预览

▲ 用户管理主界面:顶部为筛选搜索栏,中部为操作按钮区,主体为包含关键属性与操作入口的用户列表。

功能布局说明

区域编号 功能区域 包含元素 用途简述
筛选搜索栏 用户ID/用户名/邮箱搜索框、分组下拉筛选、创建时间范围选择、查询/重置按钮 快速从全量用户中定位目标账号
核心操作区 「添加用户」按钮 手动创建新用户账号
用户列表 表格展示用户名、状态、额度信息、角色、创建时间、操作列 集中浏览与管控用户数据
分页控件 数据条数统计、页码切换 当用户量较大时分批加载查看

用户列表字段详解

字段名称 说明
用户名 用户登录平台的唯一标识,支持点击跳转至该用户的「详情页」。
状态 显示账户当前生命周期状态(已启用/已禁用/已过期)。
剩余额度 / 总额度 展示当前Token余量及分配的总上限,是进行额度调整的直观参考。
角色 展示用户当前所属角色(普通用户/管理员/超级管理员),与后台菜单及接口权限关联。
创建时间 账号注册成功的时间戳。

常用操作指南

列表右侧「操作」列提供针对单个用户的快捷管理入口,具体功能如下:

  1. 调整角色:变更用户角色,从而修改其后台菜单可见性与接口调用权限。点击目标用户对应的「调整角色」→ 在弹出的下拉框中选择新角色(普通用户/管理员)→ 点击「确认」。变更即时生效,用户无需重新登录。
  2. 基本信息:查看并编辑用户的显示名称、绑定手机号、邮箱、所属分组等基础资料。点击「基本信息」→ 在抽屉弹窗中修改信息 → 点击「保存」。
  3. 重置密码:当用户遗忘密码时,管理员可强制为其重置登录凭证。点击「重置密码」→ 确认二次弹窗 → 系统将向用户绑定邮箱/手机发送新密码通知(或生成临时密码供管理员转发)。
  4. 调整额度:针对单个用户增加或减少Token总额度、并发数限制。点击「调整额度」→ 输入新的总额度数值与并发上限 → 点击「确认」。调整记录将同步至「钱包管理」消费明细。
  5. 修改分组:将用户移入或移出自定义分组,以应用该分组的特定折扣或调用策略。点击「修改分组」→ 勾选目标分组名称(可多选)→ 点击「保存」。

高级筛选技巧

当平台用户数量庞大时,建议利用顶部筛选栏快速锁定范围:

  • 多条件组合查询:支持同时按用户名模糊搜索、指定分组、限定注册时间范围。
  • 分组筛选:下拉框默认展示「全部」,可按「默认分组」、「VIP分组」或自定义业务分组进行过滤。
  • 重置功能:点击「重置」按钮可一键清空所有筛选条件,恢复全量视图。

注意事项

  • 批量操作限制:当前版本仅支持单个用户的调整操作,若需批量调整额度或分组,请前往「用户组管理」模块配置策略。
  • 状态联动:当钱包余额欠费时,用户状态将自动变更为“已冻结”,此时「操作」列的部分按钮(如调整额度)仍可用,但用户无法调用API。
  • 审计追踪:管理员在后台执行的“重置密码”、“调整角色”等敏感操作均会记录至「安全审计」日志。

1.2 用户组管理

用户组管理用于按等级、业务类型、渠道或组织创建自定义分组,并对不同分组单独配置折扣比例、优惠规则及适用模型范围,实现精细化定价与权益管控。本章节重点介绍运营后台中与分组相关的核心配置项。

界面预览

▲ 用户组管理配置界面(左侧为系统设置菜单,右侧为分组折扣与规则配置面板)

功能布局说明

区域编号 功能模块 对应配置项 用途简述
系统设置导航 分组与模型定价设置、速率限制设置等 进入分组配置的入口
企业折扣(模型倍率设置) 分组倍率 JSON 配置 为不同分组设置模型调用成本倍率,实现差异化定价
分组专属折扣 分组专属折扣 JSON 配置 定义某分组用户在使用其他分组令牌时的专属折扣率
分组特殊可用分组 特殊可用分组 JSON 配置 控制某分组可见或不可见哪些令牌分组
自动分组 自动分组列表 JSON 配置 指定用户新建令牌时默认预选的分组顺序

1.2.1 创建自定义分组

自定义分组支持按业务属性灵活创建,如按客户等级(VIP、企业版)、业务类型(测试组、生产组)或渠道来源区分。分组创建后可在「企业折扣」配置中以 JSON 键名形式出现。

操作步骤如下:

  1. 进入「系统设置」→「用户组管理」页面。
  2. 点击页面中的「添加分组」按钮。
  3. 在弹出的对话框中填写分组名称(如“VIP分组”)、分组标识码和描述信息。
  4. 点击「保存」,新分组即刻出现在分组列表中,可供后续分配用户和配置折扣使用。

1.2.2 配置分组折扣比例

分组折扣比例通过「企业折扣」(即模型倍率设置)进行配置。该倍率将直接作用于模型基础价格,实现不同分组的差异化定价。

配置位置系统设置分组与模型定价设置企业折扣

操作步骤如下:

  1. 进入「系统设置」→「分组与模型定价设置」→「企业折扣」配置区。
  2. 在 JSON 编辑器中,以分组名为键,以倍率(如 0.8 表示八折)为值,添加或修改配置项。
  3. 确认 JSON 格式无误后,点击「保存」生效。
  4. 保存后,对应分组下的用户调用模型时将自动按该倍率计算实际扣费金额。

1.3 用户限额配置

1.3.1 设置Token调用量上限

操作步骤如下:

  1. 进入「用户管理」列表页,找到目标用户。
  2. 点击操作列中的「调整额度」按钮。
  3. 在弹出的对话框中,找到“总额度”或“Token调用量上限”字段。
  4. 输入新的上限数值(需为整数,单位为Token),并根据需要选择生效周期(如单日上限、月度上限或永久额度)。
  5. 点击「确认」保存,新额度即时生效。

1.3.2 设置并发数上限

操作步骤如下:

  1. 进入「用户管理」列表页,找到目标用户。
  2. 点击操作列中的「调整额度」按钮。
  3. 在弹出的对话框中,找到“并发上限”字段。
  4. 输入允许的最大并发调用数(如10、50等整数)。
  5. 点击「确认」保存。当用户并发调用达到此上限后,后续请求将被网关限流并返回429状态码。

1.4 用户生命周期管理

1.4.1 用户信息更新


操作步骤如下:

  1. 进入「用户管理」列表页,找到目标用户。
  2. 点击该用户操作列中的「基本信息」按钮。
  3. 系统右侧将弹出抽屉式编辑面板,展示当前用户的全部基础信息。
  4. 在对应字段中修改显示名称、手机号、邮箱或所属分组等信息。
  5. 确认无误后,点击面板底部的「保存」按钮,系统将校验格式并保存更新。

1.4.2 用户状态控制(启用/禁用)


操作步骤如下:

  1. 进入「用户管理」列表页,找到目标用户。
  2. 点击操作列中的「更多」下拉菜单,选择「启用」或「禁用」选项。
  3. 系统弹出二次确认弹窗,提示禁用后该账号将被暂停使用。
  4. 点击「确认」后,用户状态立即变更。禁用后令牌鉴权接口将拒绝该用户的请求;重新启用后令牌自动恢复有效。

1.4.3 用户到期与注销处理


操作步骤如下:

  1. 进入「用户管理」列表页,找到目标用户。
  2. 点击操作列中的「更多」下拉菜单,选择「到期设置」或「注销账号」。
  3. 若选择「到期设置」:在弹出的日期选择器中设定账号的过期日期和时间,点击「确认」。
  4. 若选择「注销账号」:系统会弹出警告提示,说明注销将清除所有用户数据且不可恢复。管理员需输入确认文字后点击「最终确认」。
  5. 注销完成后,该用户将从列表中移除,其持有的所有令牌同步失效。操作记录写入安全审计日志。

2. 认证中心

2.1 多因子认证

2.2 权限管理(RBAC)

2.2.1 配置用户与角色关联


操作步骤如下:

  1. 进入「用户管理」页面。
  2. 在左侧用户列表中选中目标用户,在右侧角色列表中勾选要分配的角色。
  3. 点击「关联」或「保存」按钮,完成角色绑定,即时生效。
  4. 若要移除角色,取消勾选对应角色后保存即可。操作记录将写入安全审计日志。

2.2.2 配置角色与权限关联

2.3 安全审计

2.3.1 查看登录操作日志


操作步骤如下:

  1. 进入「使用日志」页面。
  2. 使用顶部筛选条件可按时间范围、用户名、登录结果、IP地址等维度过滤日志。
  3. 每条记录包含用户名、登录时间、IP地址、登录方式、登录结果等信息。
  4. 点击单条记录可展开查看详细信息。

4. 计费系统

4.1 计费维度配置

4.1.1 按Token消耗量计费


操作步骤如下:

  1. 进入「使用日志」页面。
  2. 可查看和配置:计费单位、输入/输出Token分离计费开关、阶梯定价规则。

4.1.2 按调用次数计费

操作步骤如下:

  1. 配置项包括:单次调用价格、适用接口列表、每日/每月免费调用次数。

4.1.3 按并发时长计费

4.1.4 按模型版本与类型计费

操作步骤如下:

  1. 进入「数据概览」页面。
  2. 可为每个模型版本单独设置按Token计费单价、按次计费单价或按时长计费单价。

4.2 计费数据监控

4.2.1 实时统计消费金额


操作步骤如下:

  1. 进入「使用日志」页面。
  2. 页面顶部展示核心指标卡片:今日总消费金额、今日总收入金额等。
  3. 中部展示消费金额趋势折线图,可按小时或分钟粒度查看。
  4. 底部可按用户等级、模型类型、分组等维度查看消费金额排行。支持设置自动刷新间隔。

4.2.2 实时统计Token消耗与调用次数


操作步骤如下:

  1. 进入「使用日志」页面。
  2. 页面以双轴折线图展示Token消耗量趋势和调用次数趋势。
  3. 可按模型维度筛选,按时、日、周、月切换统计周期。

5. 模型渠道

5.1 AI渠道接入管理

5.1.1 主流AI模型渠道接入列表

操作步骤如下:

  1. 进入「模型广场」页面。
  2. 页面以卡片或表格形式展示各渠道,包括名称、提供商、状态、支持模型数量。
  3. 点击目标渠道卡片可查看详细接入参数。点击「添加渠道」按钮可新增加入。
  4. 对于已连接的渠道,可点击「测试连接」验证API Key是否有效。

5.1.2 统一接口封装说明

操作步骤如下:

  1. 进入「开发文档」页面。
  2. 页面展示平台标准API接口规范文档。
  3. 管理员可配置每个渠道的“参数映射表”,将渠道原生参数映射到平台标准参数。
  4. 映射配置保存后,用户通过平台API调用模型时无需关心底层渠道差异。

5.1.3 协议适配配置

操作步骤如下:

  1. 进入「模型管理」页面。
  2. 在渠道列表中选择目标渠道,点击「编辑」。
  3. 配置协议类型(REST/gRPC)、请求序列化格式、认证方式、流式支持等。
  4. 配置完成后点击「测试连接」验证,然后「保存」生效。

5.1.4 渠道状态监控查看

操作步骤如下:

  1. 进入「供应商管理」页面。
  2. 页面以红黄绿指示灯展示每个渠道的实时健康状态。
  3. 每个渠道展示其关键指标:可用率、平均响应延迟、错误率、当前QPS等。

5.2 渠道分组管理

5.2.1 按厂商/模型类型/业务线创建分组

操作步骤如下:

  1. 进入「供应商管理」页面。
  2. 点击「添加供应商」按钮,填写分组名称、标识、分组维度(按厂商/模型类型/业务线)和描述。
  3. 点击「确认」保存新分组。可在后续的模型绑定和调度策略配置中引用该分组。

5.2.2 批量管理与配置

操作步骤如下:

  1. 勾选需要批量操作的渠道记录,点击「批量操作」按钮。
  2. 可选操作包括:批量移动分组、批量启用/禁用等。
  3. 选择操作类型后,设置相应参数,确认后执行。

6. 令牌管理

6.1 令牌生成

6.1.1 为用户/应用生成专属令牌

操作步骤如下:

  1. 进入「API KEY」页面。
  2. 点击「添加 api key」按钮,填写所属用户、令牌名称、有效期限、模型范围、额度限制等信息。
  3. 点击「生成」,系统将生成唯一的令牌字符串。

6.1.2 令牌唯一标识说明

操作步骤如下:

  1. 进入「API KEY」页面页面。
  2. 页面展示令牌的两种标识形式:令牌前缀(如 sk-)。
  3. 管理员可在令牌列表中通过令牌ID快速搜索定位令牌,也可通过前缀识别令牌类型。此信息为只读展示。

6.2 令牌权限控制

6.2.1 绑定可调用AI模型范围

操作步骤如下:

  1. 进入「API KEY」页面
  2. 点击「编辑」按钮。
  3. 在模型授权页面中,勾选该令牌允许调用的模型(支持全选、按分组批量选择或单个勾选)。
  4. 点击「保存」,未被勾选的模型将对该令牌不可见且不可调用。

6.3 令牌限额管理

6.3.1 配置Token消耗量上限

操作步骤如下:

  1. 进入「API KEY」页面
  2. 点击「编辑」按钮。
  3. 输入“金额”数值,可设置超限后行为(拒绝或排队)。
  4. 点击「保存」。

6.4 令牌状态管理

6.4.1 启用/禁用令牌

操作步骤如下:

  1. 进入「API KEY」页面
  2. 点击「编辑」按钮。在令牌列表中找到目标令牌,点击状态列的切换开关,或点击操作列的「启用」/「禁用」。

6.4.2 设置令牌过期时间

操作步骤如下:

  1. 进入「API KEY」页面
  2. 点击「编辑」按钮。
  3. 在弹出的日期时间选择器中设置新的过期时间。
  4. 点击「确认」,新的过期时间立即生效。

6.4.3 重置令牌操作

操作步骤如下:

  1. 进入「API KEY」页面
  2. 点击「禁用」按钮。

7. 用量统计

7.1 用量统计维度管理

7.1.1 内置维度说明(充值/消费/管理/系统/错误/退款)

操作步骤如下:

  1. 进入「使用日志」页面。
  2. 页面展示各内置维度的定义和应用场景:充值、消费、管理、系统、错误、退款。

7.2 分类明细查询

7.2.1 查看每笔操作记录

操作步骤如下:

  1. 进入「使用日志」页面。
  2. 页面展示明细表格,按系统时间倒序排列,每笔记录包含时间、统计分类、操作详情等字段。

8. 钱包管理

8.1 钱包账户管理

8.1.1 用户专属钱包账户查看

操作步骤如下:

  1. 进入「钱包管理」页面。
  2. 页面以列表形式展示所有用户的钱包账户,包含当前余额、累计消费等。

8.1.2 账户余额查询

操作步骤如下:

  1. 进入「钱包管理」。
  2. 点击刷新按钮查询。

8.2 充值管理

8.2.2 对公转账充值流程

操作步骤如下:

  1. 进入「钱包管理」页面。
  2. 核实汇款信息与后台银行流水,确认资金已到账。

8.2.3 充值码兑换流程

操作步骤如下:

  1. 进入「钱包管理」。
  2. 用户兑换:在前台输入充值码后,系统自动校验有效性并将对应额度充入钱包。

8.2.4 充值明细查询与对账

操作步骤如下:

  1. 进入「钱包管理」页面。
  2. 点击「账单」按钮。
  3. 每条记录包含充值时间、用户名、充值方式、金额、支付流水号、状态等字段。

8.3 消费扣费管理

8.3.1 消费明细查询与筛选


操作步骤如下:

  1. 进入「用量统计」页面。
  2. 点击「查询」按钮。

8.4 兑换码管理

8.4.1 批量生成Token兑换码

操作步骤如下:

  1. 进入「兑换码管理」页面。
  2. 点击「添加兑换码」按钮,填写生成数量、兑换码前缀、兑换额度、有效期。
  3. 点击「提交」,系统将批量创建兑换码并展示结果列表。

8.4.2 自定义兑换额度与有效期

操作步骤如下:

  1. 进入「兑换码管理」页面。
  2. 点击「添加兑换码」按钮,填写生成数量、兑换码前缀、兑换额度、有效期。
  3. 在弹出的面板中修改兑换Token额度和有效期,保存后即时更新。

9. 监控告警

9.1 系统资源实时监控

9.1.1 CPU使用率监控

操作步骤如下:

  1. 进入「系统管理」页面 →「性能设置」。
  2. 页面顶部展示所有服务器节点的CPU使用率概览卡片,过高节点以红色高亮显示。
  3. 点击某台服务器节点,下方趋势图展示该节点近期的CPU使用率变化曲线。
  4. 管理员可在「阈值配置」页面设置CPU告警阈值,超过阈值时系统自动发送通知。

9.1.2 内存使用率监控

操作步骤如下:

  1. 进入「系统管理」页面 →「性能设置」。
  2. 页面展示各节点的内存使用率,以百分比进度条形式直观展示。
  3. 点击某节点可查看内存使用率历史趋势图。

9.1.3 磁盘使用率监控

操作步骤如下:

  1. 进入「系统管理」页面 →「性能设置」。
  2. 页面展示各节点各挂载点的磁盘使用情况。
  3. 日志存储盘和数据库数据盘应重点监控。

9.1.4 阈值配置与实时告警设置

操作步骤如下:

  1. 进入「系统管理」页面 →「性能设置」。
  2. 页面以表格形式列出所有可配置的监控指标(CPU、内存、磁盘等)。
  3. 点击某指标所在行的「编辑」,配置告警阈值、持续时间、告警级别、通知渠道和通知频率。
  4. 点击「保存」使告警规则生效。

作者:李志强  创建时间:2026-04-24 09:32
最后编辑:李志强  更新时间:2026-06-05 14:36