# 机器人房间产品文档

## 背景

语音房冷启动阶段，房间列表和新房首屏容易显得冷清。机器人房间用于在内部可控范围内营造房间活跃氛围：机器人账号创建房间、进入房间、静音上麦，并在房间内相互送礼，触发客户端已有的礼物动效和幸运礼物展示。

机器人房间不面向真人主播发放收益，不参与真实抽奖、真实奖池、榜单和结算。

## 产品目标

- 后台可创建和控制机器人房间。
- 每个机器人房间自动拉取一批未被占用的机器人账号进房。
- 机器人可静音上麦，让房间麦位呈现活跃状态。
- 机器人之间自动送普通礼物和幸运礼物。
- 幸运礼物展示复用客户端现有飘屏/房间展示协议，但不影响真实幸运礼物奖池和流水。
- 机器人房间积分和麦位热度正常增长，用于房间内氛围展示。
- 机器人礼物不产生真人收益，不污染充值、消费、结算和排行榜数据。

## 使用入口

后台管理系统路径：

`房间管理 / 机器人房间`

权限：

- `room-robot:view`：查看机器人房间。
- `room-robot:create`：创建机器人房间。
- `room-robot:update`：启动/停止机器人房间。

## 创建机器人房间

点击 `增加机器人房间` 后配置：

- 房间名称：机器人房间对外展示名称。
- 房主机器人：从未被机器人房间占用的房间机器人账号中选择。
- 候选机器人：从未被机器人房间占用的机器人账号中选择，默认可选择全部可用机器人。
- 进房人数范围：例如 `6-10`，系统会从候选机器人中随机抽取一个人数。
- 礼物合集：普通礼物池，机器人普通送礼时随机选择。
- 幸运礼物合集：幸运礼物展示池，机器人幸运送礼时随机选择。
- 普通礼物频次：每个机器人每隔固定毫秒数送一次普通礼物。
- 幸运礼物连击范围：每轮幸运礼物随机生成连击次数。
- 幸运礼物间隔范围：一轮幸运礼物结束后，随机等待一段时间再开始下一轮。

## 送礼规则

### 普通礼物

- 每个机器人独立执行。
- 到达配置间隔后，从普通礼物合集中随机选择 1 个礼物。
- 随机选择同房间另一个机器人作为收礼人。
- 每次只送 1 个目标机器人。

### 幸运礼物

- 每个机器人独立执行。
- 从幸运礼物合集中随机选择 1 个礼物。
- 当前机器人向同房间所有其他机器人送礼。
- 按配置范围随机生成连击次数，例如 `100-10000`。
- 连击完成后，按配置间隔范围随机等待，例如 `5-20 秒`，再开始下一轮。

## 状态管理

机器人房间支持：

- 运行中：机器人送礼循环运行。
- 已停止：机器人送礼循环停止，配置和房间占用保留。

后台列表中可使用状态开关快速启动或停止。

## 数据隔离

机器人房间遵循以下隔离规则：

- 机器人只给同房间机器人送礼。
- 服务端禁止机器人给真人送礼。
- 机器人礼物使用机器人专用金币 `ROBOT_COIN`。
- 不消耗真人金币 `COIN`。
- 不产生主播钻石和工资周期钻石。
- 不写真实礼物墙。
- 不参与真实幸运礼物奖池、抽奖、返奖和统计。
- 不参与房间排行榜、活动排行榜和结算。

## 运营建议

- 单房机器人数量建议从 `6-10` 开始。
- 普通礼物频次建议不要过低，避免房间消息过密。
- 幸运礼物连击范围建议根据活动氛围配置，测试环境可用较小范围验证。
- 礼物合集应选择低价或专门用于展示的礼物，避免用户误解真实返奖。
- 机器人房间应优先用于冷启动、活动预热和列表氛围补足。

## 风险与限制

- 机器人房间不应和真人主播收益挂钩。
- 不建议使用真人主播账号作为机器人账号。
- 如果候选机器人不足，创建会失败。
- 同一个机器人不能同时被多个 active 机器人房间占用。
- 停止房间只停止送礼循环，不删除房间配置。