# 自动建群（group-create）新增字段说明

## 新增字段列表

相对于旧的 auto-group 模块，新版本（group-create）新增了以下字段：

### 1. planType (计划类型)
- **类型**: number
- **取值**: 0-全局计划, 1-独立计划
- **默认值**: 1 (独立计划)
- **说明**: 计划类型，用于区分全局计划和独立计划

### 2. executor / executorId (执行智能体)
- **类型**: FriendSelectionItem / number
- **说明**: 执行智能体（执行者），单个微信号选择
- **必填**: 是
- **替换**: 原 `devices` 字段（原为设备选择，现改为微信号选择）

### 3. fixedWechatIds / fixedWechatIdsOptions (固定微信号)
- **类型**: number[] / FriendSelectionItem[]
- **说明**: 固定微信号，必须选择3个
- **必填**: 是
- **新增**: 完全新增的字段，旧版本没有对应字段
- **功能**: 支持搜索选择，也支持手动输入微信号添加

### 4. groupAdminEnabled (群管理员开关)
- **类型**: boolean
- **默认值**: false
- **说明**: 是否启用群管理员功能
- **新增**: 完全新增的字段

### 5. groupAdminWechatId / groupAdminWechatIdOption (群管理员微信号)
- **类型**: number / FriendSelectionItem
- **说明**: 群管理员微信号（当 groupAdminEnabled 为 true 时选择）
- **必填**: 否（仅在 groupAdminEnabled 为 true 时选择）
- **新增**: 完全新增的字段
- **替换**: 原 `admins` 字段（原为多个管理员，现改为单个可选的管理员）

### 6. groupName (群名称)
- **类型**: string
- **说明**: 群名称
- **必填**: 是
- **替换**: 原 `groupNameTemplate` (群名称模板)
- **变更**: 从模板改为直接输入群名称

### 7. executeType (执行类型)
- **类型**: number
- **取值**: 0-立即执行, 1-定时执行
- **默认值**: 1 (定时执行)
- **说明**: 执行类型
- **新增**: 完全新增的字段

### 8. executeDate (执行日期)
- **类型**: string (YYYY-MM-DD)
- **说明**: 执行日期，仅在 executeType === 1 (定时执行) 时必填
- **新增**: 完全新增的字段

### 9. executeTime (执行时间)
- **类型**: string (HH:mm)
- **说明**: 执行时间，仅在 executeType === 1 (定时执行) 时必填
- **新增**: 完全新增的字段

## 已删除的字段

以下字段在新版本中不再使用：

1. **devices / devicesOptions** - 被 executor / executorId 替换（从设备选择改为微信号选择）
2. **admins / adminsOptions** - 被 groupAdminWechatId / groupAdminWechatIdOption 替换（从多个管理员改为单个可选管理员）
3. **poolGroups / poolGroupsOptions** - 流量池选择，新版本不再需要
4. **startTime / endTime** - 允许建群的时间段，新版本改为 executeDate + executeTime
5. **groupNameTemplate** - 被 groupName 替换（从模板改为直接输入）
6. **groupDescription** - 群描述，新版本不再需要

## 保留的字段

以下字段在新版本中继续使用：

1. **id** - 任务ID
2. **name** - 计划名称（保持原有逻辑）
3. **maxGroupsPerDay** - 每日最大建群数（保持原有逻辑）
4. **groupSizeMin** - 群组最小人数（保持原有逻辑）
5. **groupSizeMax** - 群组最大人数（保持原有逻辑）
6. **status** - 是否启用（保持原有逻辑）
7. **type** - 任务类型（固定为4，与旧版保持一致）

## 接口说明

接口路径保持与旧版一致：
- 创建: POST /v1/workbench/create
- 更新: POST /v1/workbench/update
- 详情: GET /v1/workbench/detail
- 列表: GET /v1/workbench/list
