init update

2026-04-01 17:17:24 -04:00 · 2025-10-24 00:35:21 +08:00
commit df5c25c98d
205 changed files with 81998 additions and 0 deletions
--- a/configs/README.md
+++ b/configs/README.md
@@ -0,0 +1,131 @@
+# Configuration Files
+
+This directory contains configuration files for the AI-Trader Bench. These JSON configuration files define the parameters and settings used by the trading agents during execution.
+
+## Files
+
+### `default_config.json`
+
+The main configuration file that defines all system parameters. This file is loaded by `livebaseagent_config.py` and contains the following sections:
+
+#### Agent Configuration
+- **`agent_type`**: Specifies which agent class to use 
+- **`agent_config`**: Agent-specific parameters
+  - `max_steps`: Maximum number of reasoning steps per trading decision (default: 30)
+  - `max_retries`: Maximum retry attempts for failed operations (default: 3)
+  - `base_delay`: Base delay between operations in seconds (default: 1.0)
+  - `initial_cash`: Starting cash amount for trading (default: $10,000)
+
+#### Date Range
+- **`date_range`**: Trading period configuration
+  - `init_date`: Start date for trading simulation (format: YYYY-MM-DD)
+  - `end_date`: End date for trading simulation (format: YYYY-MM-DD)
+
+#### Model Configuration
+- **`models`**: List of AI models to use for trading decisions
+  - Each model entry contains:
+    - `name`: Display name for the model
+    - `basemodel`: Full model identifier/path
+    - `signature`: Model signature for API calls
+    - `enabled`: Boolean flag to enable/disable the model
+
+#### Logging Configuration
+- **`log_config`**: Logging parameters
+  - `log_path`: Directory path where agent data and logs are stored
+
+## Usage
+
+### Default Configuration
+The system automatically loads `default_config.json` when no specific configuration file is provided:
+
+```bash
+python livebaseagent_config.py
+```
+
+### Custom Configuration
+You can specify a custom configuration file:
+
+```bash
+python livebaseagent_config.py configs/my_custom_config.json
+```
+
+### Environment Variable Overrides
+Certain configuration values can be overridden using environment variables:
+- `INIT_DATE`: Overrides the initial trading date
+- `END_DATE`: Overrides the end trading date
+
+## Configuration Examples
+
+### Minimal Configuration
+```json
+{
+  "agent_type": "BaseAgent",
+  "date_range": {
+    "init_date": "2025-01-01",
+    "end_date": "2025-01-31"
+  },
+  "models": [
+    {
+      "name": "gpt-4o",
+      "basemodel": "openai/gpt-4o-2024-11-20",
+      "signature": "gpt-4o-2024-11-20",
+      "enabled": true
+    }
+  ],
+  "agent_config": {
+    "max_steps": 10,
+    "initial_cash": 5000.0
+  },
+  "log_config": {
+    "log_path": "./data/agent_data"
+  }
+}
+```
+
+### Multi-Model Configuration
+```json
+{
+  "agent_type": "BaseAgent",
+  "date_range": {
+    "init_date": "2025-01-01",
+    "end_date": "2025-01-31"
+  },
+  "models": [
+    {
+      "name": "claude-3.7-sonnet",
+      "basemodel": "anthropic/claude-3.7-sonnet",
+      "signature": "claude-3.7-sonnet",
+      "enabled": true
+    },
+    {
+      "name": "gpt-4o",
+      "basemodel": "openai/gpt-4o-2024-11-20",
+      "signature": "gpt-4o-2024-11-20",
+      "enabled": true
+    },
+    {
+      "name": "qwen3-max",
+      "basemodel": "qwen/qwen3-max",
+      "signature": "qwen3-max",
+      "enabled": false
+    }
+  ],
+  "agent_config": {
+    "max_steps": 50,
+    "max_retries": 5,
+    "base_delay": 2.0,
+    "initial_cash": 20000.0
+  },
+  "log_config": {
+    "log_path": "./data/agent_data"
+  }
+}
+```
+
+## Notes
+
+- Configuration files must be valid JSON format
+- The system validates date ranges and ensures `init_date` is not greater than `end_date`
+- Only models with `enabled: true` will be used for trading simulations
+- Configuration errors will cause the system to exit with appropriate error messages
+- The configuration system supports dynamic agent class loading through the `AGENT_REGISTRY` mapping
--- a/configs/README_zh.md
+++ b/configs/README_zh.md
@@ -0,0 +1,153 @@
+# 配置文件
+
+此目录包含AI-Trader Bench的配置文件。这些JSON配置文件定义了交易代理在执行过程中使用的参数和设置。
+
+## 文件说明
+
+### `default_config.json`
+
+主要的配置文件，定义了所有系统参数。该文件由`livebaseagent_config.py`加载，包含以下部分：
+
+#### 代理配置
+- **`agent_type`**: 指定要使用的代理类
+- **`agent_config`**: 代理特定参数
+  - `max_steps`: 每次交易决策的最大推理步数（默认：30）
+  - `max_retries`: 失败操作的最大重试次数（默认：3）
+  - `base_delay`: 操作间的基础延迟时间（秒）（默认：1.0）
+  - `initial_cash`: 交易起始资金（默认：$10,000）
+
+#### 日期范围
+- **`date_range`**: 交易周期配置
+  - `init_date`: 交易模拟开始日期（格式：YYYY-MM-DD）
+  - `end_date`: 交易模拟结束日期（格式：YYYY-MM-DD）
+
+#### 模型配置
+- **`models`**: 用于交易决策的AI模型列表
+  - 每个模型条目包含：
+    - `name`: 模型的显示名称
+    - `basemodel`: 完整的模型标识符/路径
+    - `signature`: API调用的模型签名
+    - `enabled`: 启用/禁用模型
+
+#### 日志配置
+- **`log_config`**: 日志参数
+  - `log_path`: 存储代理数据和日志的目录路径
+
+## 使用方法
+
+### 默认配置
+当未指定特定配置文件时，系统会自动加载`default_config.json`：
+
+```bash
+python livebaseagent_config.py
+```
+
+### 自定义配置
+您可以指定自定义配置文件：
+
+```bash
+python livebaseagent_config.py configs/my_custom_config.json
+```
+
+### 环境变量覆盖
+某些配置值可以通过环境变量覆盖：
+- `INIT_DATE`: 覆盖初始交易日期
+- `END_DATE`: 覆盖结束交易日期
+
+## 配置示例
+
+### 最小配置
+```json
+{
+  "agent_type": "BaseAgent",
+  "date_range": {
+    "init_date": "2025-01-01",
+    "end_date": "2025-01-31"
+  },
+  "models": [
+    {
+      "name": "gpt-4o",
+      "basemodel": "openai/gpt-4o-2024-11-20",
+      "signature": "gpt-4o-2024-11-20",
+      "enabled": true
+    }
+  ],
+  "agent_config": {
+    "max_steps": 10,
+    "initial_cash": 5000.0
+  },
+  "log_config": {
+    "log_path": "./data/agent_data"
+  }
+}
+```
+
+### 多模型配置
+```json
+{
+  "agent_type": "BaseAgent",
+  "date_range": {
+    "init_date": "2025-01-01",
+    "end_date": "2025-01-31"
+  },
+  "models": [
+    {
+      "name": "claude-3.7-sonnet",
+      "basemodel": "anthropic/claude-3.7-sonnet",
+      "signature": "claude-3.7-sonnet",
+      "enabled": true
+    },
+    {
+      "name": "gpt-4o",
+      "basemodel": "openai/gpt-4o-2024-11-20",
+      "signature": "gpt-4o-2024-11-20",
+      "enabled": true
+    },
+    {
+      "name": "qwen3-max",
+      "basemodel": "qwen/qwen3-max",
+      "signature": "qwen3-max",
+      "enabled": false
+    }
+  ],
+  "agent_config": {
+    "max_steps": 50,
+    "max_retries": 5,
+    "base_delay": 2.0,
+    "initial_cash": 20000.0
+  },
+  "log_config": {
+    "log_path": "./data/agent_data"
+  }
+}
+```
+
+## 注意事项
+
+- 配置文件必须是有效的JSON格式
+- 系统会验证日期范围，确保`init_date`不大于`end_date`
+- 只有`enabled: true`的模型才会用于交易模拟
+- 配置错误会导致系统退出并显示相应的错误消息
+- 配置系统通过`AGENT_REGISTRY`映射支持动态代理类加载
+
+## 配置参数详解
+
+### 代理类型 (agent_type)
+目前支持的类型：
+- `BaseAgent`: 基础交易代理，使用MCP工具链进行交易决策
+
+### 模型配置 (models)
+每个模型需要包含以下字段：
+- `name`: 用于日志和显示的名称
+- `basemodel`: 完整的模型路径，用于API调用
+- `signature`: 模型签名，用于标识特定模型版本
+- `enabled`: 是否启用该模型参与交易
+
+### 代理参数 (agent_config)
+- `max_steps`: 控制AI代理的推理深度，数值越大分析越深入但耗时越长
+- `max_retries`: 操作失败时的重试次数，提高系统稳定性
+- `base_delay`: 操作间延迟，避免API调用过于频繁
+- `initial_cash`: 初始资金，影响交易策略和风险控制
+
+### 日志路径 (log_config)
+- `log_path`: 所有代理数据、交易记录和日志的存储位置
--- a/configs/default_config.json
+++ b/configs/default_config.json
@@ -0,0 +1,49 @@
+{
+  "agent_type": "BaseAgent",
+  "date_range": {
+    "init_date": "2025-10-01",
+    "end_date": "2025-10-21"
+  },
+  "models": [
+    {
+      "name": "claude-3.7-sonnet",
+      "basemodel": "anthropic/claude-3.7-sonnet",
+      "signature": "claude-3.7-sonnet",
+      "enabled": false
+    },
+    {
+      "name": "deepseek-chat-v3.1",
+      "basemodel": "deepseek/deepseek-chat-v3.1",
+      "signature": "deepseek-chat-v3.1",
+      "enabled": false
+    },
+    {
+      "name": "qwen3-max",
+      "basemodel": "qwen/qwen3-max",
+      "signature": "qwen3-max",
+      "enabled": false
+    },
+    {
+      "name": "gemini-2.5-flash",
+      "basemodel": "google/gemini-2.5-flash",
+      "signature": "gemini-2.5-flash",
+      "enabled": false
+    },
+    {
+      "name": "gpt-5",
+      "basemodel": "openai/gpt-5",
+      "signature": "gpt-5",
+      "enabled": true
+    }
+  ],
+  "agent_config": {
+    "max_steps": 30,
+    "max_retries": 3,
+    "base_delay": 1.0,
+    "initial_cash": 10000.0
+  },
+  "log_config": {
+    "log_path": "./data/agent_data"
+  }
+}
+