1639 Spec Da992562

# 多Agent竞技场核心能力规范

## ADDED Requirements

### Requirement: Arena Lifecycle Management
系统 SHALL 提供多Agent竞技场的完整生命周期管理，包括创建、启动、暂停、恢复和销毁。

#### Scenario: Create arena with configurable agents
- **WHEN** 用户请求创建竞技场并指定Agent数量和配置
- **THEN** 系统创建竞技场实例
- **AND** 初始化指定数量的异质化Agent
- **AND** 返回唯一的arena_id

#### Scenario: Start arena competition
- **WHEN** 用户启动已创建的竞技场
- **THEN** 系统异步启动所有Agent的策略生成任务
- **AND** 进入讨论阶段
- **AND** 开始推送思考流

#### Scenario: Pause and resume arena
- **WHEN** 用户暂停运行中的竞技场
- **THEN** 系统保存当前状态
- **AND** 暂停所有异步任务
- **WHEN** 用户恢复竞技场
- **THEN** 从保存的状态继续执行

### Requirement: Agent Heterogeneity Support
系统 SHALL 支持异质化Agent配置，允许不同Agent使用不同的LLM模型和策略生成逻辑。

#### Scenario: Configure heterogeneous agents
- **WHEN** 用户配置竞技场时指定不同Agent的模型类型
- **THEN** 系统为每个Agent分配指定的LLM适配器
- **AND** 每个Agent可独立生成差异化策略

#### Scenario: Dynamic agent model switching
- **WHEN** 管理员需要更换某Agent的底层模型
- **THEN** 系统支持热更新Agent的LLM配置
- **AND** 不影响竞技场的整体运行

### Requirement: Thinking Stream Real-time Output
系统 SHALL 提供Agent思考过程的实时流式输出，支持类似聊天界面的展示方式。

#### Scenario: Subscribe to thinking stream via SSE
- **WHEN** 用户连接到 `/api/arena/{id}/thinking-stream` SSE端点
- **THEN** 系统实时推送每个Agent的思考消息
- **AND** 消息包含Agent标识、消息类型和时间戳
- **AND** 延迟不超过500ms

#### Scenario: Reconnect and resume stream
- **WHEN** 用户SSE连接断开后重新连接
- **AND** 提供上次接收的消息ID
- **THEN** 系统从断点继续推送消息
- **AND** 不丢失任何思考消息

#### Scenario: Persist thinking messages
- **WHEN** Agent产生思考消息
- **THEN** 系统同时写入持久化存储
- **AND** 支持历史回溯查询

### Requirement: Asynchronous Execution
系统 SHALL 确保所有长时间运行的任务异步执行，用户可在等待期间切换页面执行其他操作。

#### Scenario: Background task execution
- **WHEN** 用户启动竞技场后切换到其他页面
- **THEN** 策略生成和讨论任务继续在后台运行
- **AND** 用户返回时可查看最新状态

#### Scenario: Task status polling
- **WHEN** 用户查询竞技场状态
- **THEN** 系统返回当前阶段、进度和活跃任务信息
- **AND** 不阻塞用户界面

### Requirement: Market Context Integration
系统 SHALL 整合实时市场数据，为Agent提供全面的市场环境分析。

#### Scenario: Provide real-time quotes
- **WHEN** Agent需要分析特定股票
- **THEN** 系统提供最新的实时行情数据
- **AND** 包括价格、成交量、涨跌幅等

#### Scenario: Provide technical analysis
- **WHEN** Agent需要技术面分析
- **THEN** 系统计算并提供MA、MACD、RSI、KDJ等技术指标
- **AND** 包括趋势判断和形态识别

#### Scenario: Provide fundamental data
- **WHEN** Agent需要基本面数据
- **THEN** 系统提供PE、PB、ROE等估值指标
- **AND** 包括财务报表关键数据

#### Scenario: Provide market sentiment
- **WHEN** Agent需要市场情绪判断
- **THEN** 系统提供资金流向、涨跌比、VIX等情绪指标
- **AND** 整合新闻舆情分析结果

### Requirement: Arena Configuration
系统 SHALL 提供灵活的竞技场配置选项。

#### Scenario: Configure agent count
- **WHEN** 用户创建竞技场
- **THEN** 可配置Agent数量（范围3-10个，默认5个）
- **AND** 系统根据资源限制验证配置有效性
- **AND** 低于3个时提示警告，超过10个时需管理员确认

#### Scenario: Configure competition parameters
- **WHEN** 用户配置竞技场
- **THEN** 可设置回测周期、初始资金、手续费率等参数
- **AND** 可设置评估周期（日/周/月）
- **AND** 可设置淘汰比例

#### Scenario: Configure discussion modes
- **WHEN** 用户配置讨论机制
- **THEN** 可选择启用的讨论模式（辩论/协作/评审）
- **AND** 可设置每种模式的轮次（默认每种模式1轮，共3轮）

### Requirement: Thinking Stream Retention Policy
系统 SHALL 实施思考流历史数据保留策略。

#### Scenario: Retain thinking history for 30 days
- **WHEN** 思考消息产生
- **THEN** 系统保存消息到持久化存储
- **AND** 消息默认保留30天
- **AND** 超过30天的消息自动归档到冷存储

#### Scenario: Query archived thinking history
- **WHEN** 用户查询超过30天的历史思考流
- **THEN** 系统从归档存储中检索
- **AND** 返回归档数据（查询延迟可能较高）