租户管理员分配积分
功能概述
| 项目 | 内容 |
|---|---|
| 适用角色 | 租户管理员（tenant_admin） |
| 更新日期 | 2026-06-01 |
作为租户管理员，您可以将组织余额池中的积分分配给租户下的成员，让成员能够调用模型。本手册介绍三种分配方式：
| 方式 | 适用场景 | 入口 |
|---|---|---|
| 单个分配 | 仅给某一个成员分配积分 | 余额管理页 → 分配余额 → 单个分配 |
| 批量分配 | 一次给多名成员统一发放相同额度 | 余额管理页 → 分配余额 → 批量分配 |
| 用户列表快捷分配 | 在用户列表中直接给某个成员分配 | 用户管理页 → 该用户行的「分配积分」按钮 |
所有分配操作都会从组织余额池扣减对应积分，并同步增加到目标成员的个人余额。操作记录会保留在余额流水中，方便后续审计。
前置条件
- 您已注册 gahorouter 并以 租户管理员 身份登录
- 组织余额池中有可分配的积分（余额 > 0）
- 租户下已存在要分配的目标成员，且成员处于活跃状态
如果组织余额池为空，请先通过「购买」或「兑换码」功能为组织充值，详见《租户管理员充值与积分兑换》手册。
功能入口
登录控制台后，您可以通过【用户管理】或【余额管理】任一入口发起分配操作：
| 入口 | 菜单路径 | 支持方式 |
|---|---|---|
| 余额管理页 | 左侧导航栏 → 余额管理 | 单个分配 / 批量分配 |
| 用户管理页 | 左侧导航栏 → 用户管理 | 单个快捷分配 |
方式一：单个分配（余额管理页）
适用于您只需要给某一位成员分配积分，并且希望同时查看余额流水的场景。
操作步骤
第一步：进入余额管理页
左侧导航栏 → 余额管理
第二步：点击「分配余额」下拉按钮 → 选择「单个分配」
第三步：填写分配信息
在弹窗中依次填写：
- 选择用户：点击下拉框，在搜索框输入邮箱关键词（如 zhang），系统会实时过滤匹配的成员。点击目标成员邮箱完成选择。
- 分配金额：输入要分配的积分数（至少 0.01，支持两位小数）。
- 备注（可选）：填写本次分配的说明，方便后续对账，最多 200 字。
第四步：点击「确认」
- 系统会从组织余额池扣减对应积分，同时增加目标成员的个人余额
- 成功后弹窗自动关闭，页面顶部弹出成功提示
- 余额流水列表自动刷新，新增一条「分配」类型的记录
方式二：批量分配（余额管理页）
适用于一次给多名成员发放等额积分的场景，例如新团队入职初始额度、月度/季度补贴、项目启动预算等。
操作步骤
第一步：进入余额管理页
第二步：点击「分配余额」下拉按钮 → 选择「批量分配」
第三步：勾选目标成员
- 在搜索框中输入邮箱关键词可以过滤列表
- 勾选单个用户前的复选框即可选中
- 勾选「全选」可一次性选中当前列表中所有成员（含搜索过滤后的结果）
- 已选人数会实时显示在列表下方（「已选 N 人」）
第四步：输入每人分配金额
- 在「每人分配金额」字段输入每位成员要获得的积分数
- 下方会实时显示「分配总计 = 已选人数 × 每人金额」
- 如果总计超过组织余额，会出现黄色警告「租户余额不足」，此时「确认」按钮不可点击
第五步：填写备注（可选）
填写本次批量分配的说明，便于后续对账，最多 200 字。
第六步：点击「确认」
系统开始执行批量分配，按钮显示加载动画，防止重复提交。
第七步：查看分配结果
全部成功：
- 弹窗自动关闭
- 页面顶部弹出提示「批量分配成功，已分配 N 人」
- 余额流水自动刷新
部分失败：
弹窗不关闭，而是切换为结果视图，逐行展示每位成员的分配结果：
- 点击 「重试失败」 可以针对失败的用户再次尝试分配（成功的用户不会重复分配）
- 点击 「关闭」 结束本次操作，成功的部分已经生效
业务规则
- 仅支持等额分配：所有选中的成员获得相同的金额，不支持差异化金额
- 总计不能超过组织余额：系统会实时校验
- 单次金额至少 0.01，支持两位小数
- 批量分配后流水中会为每位成员各生成一条「分配」类型的记录
方式三：用户列表快捷分配
适用于您已经在「用户管理」页面查看成员信息时，想直接给某位成员分配积分的场景，无需切换到「余额管理」页。
操作步骤
第一步：进入用户管理页
用户列表每一行的操作列右侧会显示一组按钮
第二步：点击目标成员行的「+分配积分」按钮
注意：
- 只有活跃状态的成员才会显示「分配积分」按钮，禁用状态成员无此按钮
- 当组织余额为 0 时，「分配积分」按钮会置灰不可点击
与方式一的区别：
- 「选择用户」字段会自动锁定为当前点击的成员（灰色不可编辑），无需再次选择
- 只需要填写「分配金额」和「备注」即可
第三步：输入分配金额和备注
- 分配金额：至少 0.01，支持两位小数
- 备注（可选）：本次分配的说明
第四步：点击「确认」
- 系统从组织余额池扣减积分，增加该成员的个人余额
- 成功后弹窗自动关闭，页面弹出成功提示
- 用户列表自动刷新
业务规则汇总
- 前提：组织余额池必须 > 0，否则入口会被禁用
- 仅活跃成员可分配：禁用或删除的成员无法被选为分配对象
- 金额最小 0.01：不支持 0 或负数，最多两位小数
- 总额校验：分配金额（或批量总计）不能超过当前组织余额，否则确认按钮禁用并提示「租户余额不足」
- 实时扣减：分配成功后立即从组织余额池扣减、增加到成员个人余额
- 流水留痕：每一次分配都会在「余额管理 → 余额流水」中生成一条分配（蓝色标签）类型的记录，含时间、金额、相关用户、操作人、变动前/后余额
- 租户管理员不能分配给自己：分配对象仅限于租户下的其他成员
查看分配记录
所有分配操作的结果都可以在「余额管理」页的余额流水中查看：
- 类型 列显示为蓝色「分配」标签
- 金额 列为负数，表示从组织余额池扣减
- 相关用户 列显示接收积分的成员邮箱
- 说明 列即您填写的备注
- 变动前/变动后 列显示组织余额的前后变化
组织余额池扣减的同时，成员的个人余额增加。成员的余额变化会体现在其个人中心中。
回收余额（反向操作）
如果您发现分配错误，或需要从离职成员处回收积分，可以使用「回收余额」功能。
操作步骤
- 进入 余额管理 页，点击 「回收余额」 按钮
- 在弹窗中：
- 选择用户：下拉列表会显示成员邮箱 + 当前个人余额
- 回收金额：至少 0.01，不能超过该成员当前余额
- 备注（可选）
- 点击 「确认」
业务规则
- 回收金额不能超过成员当前的个人余额，否则提示「该用户余额不足」
- 回收成功后，成员的个人余额减少，组织余额池增加对应金额
- 流水中会生成一条「回收」类型（橙色标签）的记录
常见问题
Q1：为什么「分配余额」按钮点不动？
A：可能原因：
- 组织余额为 0：请先通过「购买」或「兑换码」充值
- 租户下没有活跃成员：请先在「用户管理」页创建或邀请成员
Q2：批量分配时「确认」按钮始终灰色，点不了？
A：请检查：
- 是否已勾选至少 1 位成员
- 是否已输入「每人分配金额」且大于 0
- 「分配总计」是否超过了组织余额（超过时会有黄色警告）
Q3：分配金额可以填 0 吗？
A：不可以。最小分配金额为 0.01，0 或负数会被系统拒绝。
Q4：批量分配时能给每人分配不同金额吗？
A：目前不支持。批量分配仅支持等额分配（所有选中成员获得相同金额）。如需分配不同金额，请使用「单个分配」或「用户列表快捷分配」逐个操作。
Q5：分配后可以撤销吗？
A：不能直接「撤销」，但可以通过「回收余额」功能从该成员处回收对应金额，效果等同于撤销。回收操作同样会在流水中留痕。
Q6：为什么用户列表里有的成员没有「分配积分」按钮？
A：
- 禁用状态的成员不会显示「分配积分」按钮，请先在该成员操作列点击「启用」
- 如果所有成员的按钮都是灰色不可点击，说明组织余额为 0，请先充值
Q7：批量分配时提示「部分用户分配失败」怎么办？
A：
- 弹窗内会逐行列出每位成员的结果和失败原因
- 常见失败原因：成员账号异常、成员在分配过程中被禁用等
- 点击「重试失败」可以只对失败的成员再次发起分配，成功的不会重复扣款
Q8：给成员分配积分后，成员马上就能使用吗？
A：是的，分配成功后立即生效，成员可以立即使用对应的积分调用模型。
Q9：分配后组织余额池的积分被全部扣掉了吗？
A：是的。分配相当于把组织余额池中的积分「转移」到成员个人余额。您可以在流水中看到「变动前」「变动后」的差值等于分配总额。如需恢复，可以使用「回收余额」功能从成员处回收。
注意事项
- 分配金额至少 0.01，不支持 0 或负数
- 禁用成员不能接收分配，请先启用后再操作
- 批量分配仅支持等额分配，差异化分配请使用单个分配
- 分配后立即生效，请谨慎确认金额和目标成员
- 所有操作都会留痕，余额流水可作为审计依据
- 请结合组织预算和成员实际使用情况合理规划分配策略，避免「囤积」或「用超」
- 离职成员请及时使用「回收余额」功能回收未用完的积分
联系我们
如果在使用过程中遇到任何问题，请及时联系我们。