配置向导与配置验证功能使用指南TradingAgents-CN 快速上手指南【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN版本: 1.0 更新日期: 2025-10-05 适用版本: v1.0.0-preview本文档介绍如何使用 TradingAgents-CN 的配置向导ConfigWizard和配置验证ConfigValidator功能帮助用户快速完成系统配置实现从零到可用的开箱即用体验。 概述TradingAgents-CN 是一个基于多智能体 LLM 的中文金融交易框架。系统涉及数据库MongoDB/Redis、大模型 API、行情数据源等多类配置手工配置繁琐且易出错。为此项目内置了两大配置能力配置向导ConfigWizard首次使用时自动弹出的 5 步引导流程帮助新用户在几分钟内完成最小必需配置配置验证ConfigValidator实时校验配置完整性区分必需/推荐配置以可视化状态呈现并提供详细的错误提示。两者的关系是向导负责快速起步验证负责持续体检。本文将从首次使用流程、配置验证说明、配置方法、界面说明、常见问题、API 文档、最佳实践七个维度展开。 功能特性1. 配置向导 (ConfigWizard)功能首次使用时自动显示5 步引导流程欢迎 → 数据库 → 大模型 → 数据源 → 完成友好的帮助信息含 API 密钥获取指引配置摘要显示完成步骤汇总触发条件首次启动应用检测到缺少必需配置/api/system/config/validate返回missing_required非空用户未完成过配置向导localStorage无config_wizard_completed标记2. 配置验证 (ConfigValidator)功能实时验证配置完整性区分必需/推荐配置级别由ConfigLevel枚举定义可视化状态显示✅/❌/⚠️详细的错误提示访问路径配置管理页面 → 配置验证 快速开始首次使用流程步骤 1: 启动应用# 启动后端服务 cd TradingAgents-CN .\.venv\Scripts\python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 # 启动前端服务新终端 cd frontend npm run dev步骤 2: 打开浏览器访问:http://localhost:3000步骤 3: 配置向导如果是首次使用系统会自动显示配置向导5 步流程步骤 0: 欢迎阅读欢迎信息点击开始配置或跳过向导步骤 1: 数据库配置MongoDB 主机:localhostMongoDB 端口:27017MongoDB 数据库:tradingagentsRedis 主机:localhostRedis 端口:6379⚠️ 注意: 数据库配置需要在.env文件中设置此处仅用于验证连接。步骤 2: 大模型配置选择大模型提供商推荐 DeepSeek 或通义千问输入 API 密钥选择模型名称根据提供商动态更新步骤 3: 数据源配置选择数据源推荐 AKShare免费无需密钥如果选择 Tushare需要输入 Token如果选择 FinnHub需要输入 API Key步骤 4: 完成查看配置摘要点击完成步骤 4: 开始使用配置完成后您可以访问仪表盘查看系统概览访问单股分析开始分析股票访问配置管理调整详细设置 配置验证访问配置验证点击左侧菜单设置选择配置管理在左侧菜单选择配置验证验证结果说明必需配置6项配置项说明示例MONGODB_HOSTMongoDB 主机地址localhostMONGODB_PORTMongoDB 端口27017MONGODB_DATABASEMongoDB 数据库名称tradingagentsREDIS_HOSTRedis 主机地址localhostREDIS_PORTRedis 端口6379JWT_SECRETJWT 认证密钥your-secret-key推荐配置3项配置项说明获取方式DEEPSEEK_API_KEYDeepSeek API 密钥https://platform.deepseek.com/DASHSCOPE_API_KEY通义千问 API 密钥https://dashscope.aliyun.com/TUSHARE_TOKENTushare Tokenhttps://tushare.pro/状态图标✅ 绿色勾号 已配置❌ 红色叉号 未配置必需⚠️ 黄色警告 未配置推荐 配置方法方法 1: 通过 .env 文件推荐1. 复制示例文件cp .env.example .env2. 编辑 .env 文件# 必需配置 MONGODB_HOSTlocalhost MONGODB_PORT27017 MONGODB_DATABASEtradingagents REDIS_HOSTlocalhost REDIS_PORT6379 JWT_SECRETyour-super-secret-jwt-key-change-in-production # 推荐配置 DEEPSEEK_API_KEYyour_deepseek_api_key_here DASHSCOPE_API_KEYyour_dashscope_api_key_here TUSHARE_TOKENyour_tushare_token_here提示.env.example中还包含MONGODB_USERNAME、MONGODB_PASSWORD、REDIS_PASSWORD、JWT_ALGORITHM等扩展配置可按需启用。3. 重启后端服务# 停止当前服务CtrlC # 重新启动 .\.venv\Scripts\python -m uvicorn app.main:app --host 0.0.0.0 --port 8000方法 2: 通过 Web 界面1. 访问配置管理设置 → 配置管理路径/settings/config2. 配置大模型选择厂家管理点击添加厂家填写厂家信息和 API 密钥保存3. 配置数据源选择数据源配置添加或编辑数据源填写必要信息保存 界面说明配置向导界面┌─────────────────────────────────────────────────┐ │ ⭐ → → → → ✅ │ │ 欢迎 数据库 大模型 数据源 完成 │ ├─────────────────────────────────────────────────┤ │ │ │ [当前步骤内容] │ │ │ │ [帮助信息] │ │ │ ├─────────────────────────────────────────────────┤ │ [上一步] [下一步] │ └─────────────────────────────────────────────────┘配置验证界面┌─────────────────────────────────────────────────┐ │ ✓ 配置验证 [重新验证] │ ├─────────────────────────────────────────────────┤ │ [✓] 配置验证通过 │ │ 所有必需配置已正确设置 │ │ │ │ ⭐ 必需配置 │ │ ┌───────────────────────────────────────────┐ │ │ │ ✓ MongoDB 主机 [已配置] │ │ │ │ ✓ MongoDB 端口 [已配置] │ │ │ │ ✓ JWT 密钥 [已配置] │ │ │ └───────────────────────────────────────────┘ │ │ │ │ ⚠️ 推荐配置 │ │ ┌───────────────────────────────────────────┐ │ │ │ ⚠️ DeepSeek API [未配置] │ │ │ │ ✓ 通义千问 API [已配置] │ │ │ └───────────────────────────────────────────┘ │ └─────────────────────────────────────────────────┘ 常见问题Q1: 配置向导不显示原因:已经完成过配置向导所有必需配置已设置解决方法:// 在浏览器控制台执行 localStorage.removeItem(config_wizard_completed) // 刷新页面Q2: 配置验证失败原因:缺少必需配置配置值无效解决方法:查看验证结果中的错误提示按照提示修改.env文件重启后端服务点击重新验证Q3: API 密钥配置后还是显示未配置原因:环境变量未生效后端服务未重启解决方法:确认.env文件已保存重启后端服务清除浏览器缓存刷新页面Q4: 如何跳过配置向导方法 1: 点击跳过向导按钮方法 2: 在浏览器控制台执行localStorage.setItem(config_wizard_completed, true)Q5: 如何重新显示配置向导方法: 在浏览器控制台执行localStorage.removeItem(config_wizard_completed) location.reload() API 文档配置验证 API端点GET /api/system/config/validate响应{ success: true, data: { success: true, missing_required: [], missing_recommended: [ { key: DEEPSEEK_API_KEY, description: DeepSeek API 密钥 } ], invalid_configs: [], warnings: [] }, message: 配置验证完成 } 相关文档配置指南 - 详细的配置说明配置验证器文档 - 验证器技术文档Phase 3 实施文档 - Web UI 优化文档 最佳实践1. 首次配置✅ 使用配置向导完成基本配置✅ 至少配置一个大模型 API✅ 选择合适的数据源✅ 定期验证配置状态2. 生产环境✅ 修改默认的 JWT_SECRET✅ 使用强密码✅ 定期更新 API 密钥✅ 备份配置文件3. 开发环境✅ 使用 AKShare 数据源免费✅ 配置至少一个大模型✅ 定期检查配置状态✅ 保持配置文件同步 总结配置向导和验证功能大大简化了系统配置流程首次配置时间: 从 30-60 分钟 → 5-10 分钟 (-80%)配置错误定位: 从查看日志 → 可视化显示 (80%)用户体验: 从复杂 → 简单友好 (100%)开始使用 TradingAgents-CN享受智能股票分析的乐趣需要帮助 提交 Issue: https://github.com/hsliuping/TradingAgents-CN/issues 查看文档:docs/目录 加入讨论: GitHub Discussions【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 配置向导与配置验证功能使用指南：TradingAgents-CN 快速上手指南
配置向导与配置验证功能使用指南TradingAgents-CN 快速上手指南【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN版本: 1.0 更新日期: 2025-10-05 适用版本: v1.0.0-preview本文档介绍如何使用 TradingAgents-CN 的配置向导ConfigWizard和配置验证ConfigValidator功能帮助用户快速完成系统配置实现从零到可用的开箱即用体验。 概述TradingAgents-CN 是一个基于多智能体 LLM 的中文金融交易框架。系统涉及数据库MongoDB/Redis、大模型 API、行情数据源等多类配置手工配置繁琐且易出错。为此项目内置了两大配置能力配置向导ConfigWizard首次使用时自动弹出的 5 步引导流程帮助新用户在几分钟内完成最小必需配置配置验证ConfigValidator实时校验配置完整性区分必需/推荐配置以可视化状态呈现并提供详细的错误提示。两者的关系是向导负责快速起步验证负责持续体检。本文将从首次使用流程、配置验证说明、配置方法、界面说明、常见问题、API 文档、最佳实践七个维度展开。 功能特性1. 配置向导 (ConfigWizard)功能首次使用时自动显示5 步引导流程欢迎 → 数据库 → 大模型 → 数据源 → 完成友好的帮助信息含 API 密钥获取指引配置摘要显示完成步骤汇总触发条件首次启动应用检测到缺少必需配置/api/system/config/validate返回missing_required非空用户未完成过配置向导localStorage无config_wizard_completed标记2. 配置验证 (ConfigValidator)功能实时验证配置完整性区分必需/推荐配置级别由ConfigLevel枚举定义可视化状态显示✅/❌/⚠️详细的错误提示访问路径配置管理页面 → 配置验证 快速开始首次使用流程步骤 1: 启动应用# 启动后端服务 cd TradingAgents-CN .\.venv\Scripts\python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 # 启动前端服务新终端 cd frontend npm run dev步骤 2: 打开浏览器访问:http://localhost:3000步骤 3: 配置向导如果是首次使用系统会自动显示配置向导5 步流程步骤 0: 欢迎阅读欢迎信息点击开始配置或跳过向导步骤 1: 数据库配置MongoDB 主机:localhostMongoDB 端口:27017MongoDB 数据库:tradingagentsRedis 主机:localhostRedis 端口:6379⚠️ 注意: 数据库配置需要在.env文件中设置此处仅用于验证连接。步骤 2: 大模型配置选择大模型提供商推荐 DeepSeek 或通义千问输入 API 密钥选择模型名称根据提供商动态更新步骤 3: 数据源配置选择数据源推荐 AKShare免费无需密钥如果选择 Tushare需要输入 Token如果选择 FinnHub需要输入 API Key步骤 4: 完成查看配置摘要点击完成步骤 4: 开始使用配置完成后您可以访问仪表盘查看系统概览访问单股分析开始分析股票访问配置管理调整详细设置 配置验证访问配置验证点击左侧菜单设置选择配置管理在左侧菜单选择配置验证验证结果说明必需配置6项配置项说明示例MONGODB_HOSTMongoDB 主机地址localhostMONGODB_PORTMongoDB 端口27017MONGODB_DATABASEMongoDB 数据库名称tradingagentsREDIS_HOSTRedis 主机地址localhostREDIS_PORTRedis 端口6379JWT_SECRETJWT 认证密钥your-secret-key推荐配置3项配置项说明获取方式DEEPSEEK_API_KEYDeepSeek API 密钥https://platform.deepseek.com/DASHSCOPE_API_KEY通义千问 API 密钥https://dashscope.aliyun.com/TUSHARE_TOKENTushare Tokenhttps://tushare.pro/状态图标✅ 绿色勾号 已配置❌ 红色叉号 未配置必需⚠️ 黄色警告 未配置推荐 配置方法方法 1: 通过 .env 文件推荐1. 复制示例文件cp .env.example .env2. 编辑 .env 文件# 必需配置 MONGODB_HOSTlocalhost MONGODB_PORT27017 MONGODB_DATABASEtradingagents REDIS_HOSTlocalhost REDIS_PORT6379 JWT_SECRETyour-super-secret-jwt-key-change-in-production # 推荐配置 DEEPSEEK_API_KEYyour_deepseek_api_key_here DASHSCOPE_API_KEYyour_dashscope_api_key_here TUSHARE_TOKENyour_tushare_token_here提示.env.example中还包含MONGODB_USERNAME、MONGODB_PASSWORD、REDIS_PASSWORD、JWT_ALGORITHM等扩展配置可按需启用。3. 重启后端服务# 停止当前服务CtrlC # 重新启动 .\.venv\Scripts\python -m uvicorn app.main:app --host 0.0.0.0 --port 8000方法 2: 通过 Web 界面1. 访问配置管理设置 → 配置管理路径/settings/config2. 配置大模型选择厂家管理点击添加厂家填写厂家信息和 API 密钥保存3. 配置数据源选择数据源配置添加或编辑数据源填写必要信息保存 界面说明配置向导界面┌─────────────────────────────────────────────────┐ │ ⭐ → → → → ✅ │ │ 欢迎 数据库 大模型 数据源 完成 │ ├─────────────────────────────────────────────────┤ │ │ │ [当前步骤内容] │ │ │ │ [帮助信息] │ │ │ ├─────────────────────────────────────────────────┤ │ [上一步] [下一步] │ └─────────────────────────────────────────────────┘配置验证界面┌─────────────────────────────────────────────────┐ │ ✓ 配置验证 [重新验证] │ ├─────────────────────────────────────────────────┤ │ [✓] 配置验证通过 │ │ 所有必需配置已正确设置 │ │ │ │ ⭐ 必需配置 │ │ ┌───────────────────────────────────────────┐ │ │ │ ✓ MongoDB 主机 [已配置] │ │ │ │ ✓ MongoDB 端口 [已配置] │ │ │ │ ✓ JWT 密钥 [已配置] │ │ │ └───────────────────────────────────────────┘ │ │ │ │ ⚠️ 推荐配置 │ │ ┌───────────────────────────────────────────┐ │ │ │ ⚠️ DeepSeek API [未配置] │ │ │ │ ✓ 通义千问 API [已配置] │ │ │ └───────────────────────────────────────────┘ │ └─────────────────────────────────────────────────┘ 常见问题Q1: 配置向导不显示原因:已经完成过配置向导所有必需配置已设置解决方法:// 在浏览器控制台执行 localStorage.removeItem(config_wizard_completed) // 刷新页面Q2: 配置验证失败原因:缺少必需配置配置值无效解决方法:查看验证结果中的错误提示按照提示修改.env文件重启后端服务点击重新验证Q3: API 密钥配置后还是显示未配置原因:环境变量未生效后端服务未重启解决方法:确认.env文件已保存重启后端服务清除浏览器缓存刷新页面Q4: 如何跳过配置向导方法 1: 点击跳过向导按钮方法 2: 在浏览器控制台执行localStorage.setItem(config_wizard_completed, true)Q5: 如何重新显示配置向导方法: 在浏览器控制台执行localStorage.removeItem(config_wizard_completed) location.reload() API 文档配置验证 API端点GET /api/system/config/validate响应{ success: true, data: { success: true, missing_required: [], missing_recommended: [ { key: DEEPSEEK_API_KEY, description: DeepSeek API 密钥 } ], invalid_configs: [], warnings: [] }, message: 配置验证完成 } 相关文档配置指南 - 详细的配置说明配置验证器文档 - 验证器技术文档Phase 3 实施文档 - Web UI 优化文档 最佳实践1. 首次配置✅ 使用配置向导完成基本配置✅ 至少配置一个大模型 API✅ 选择合适的数据源✅ 定期验证配置状态2. 生产环境✅ 修改默认的 JWT_SECRET✅ 使用强密码✅ 定期更新 API 密钥✅ 备份配置文件3. 开发环境✅ 使用 AKShare 数据源免费✅ 配置至少一个大模型✅ 定期检查配置状态✅ 保持配置文件同步 总结配置向导和验证功能大大简化了系统配置流程首次配置时间: 从 30-60 分钟 → 5-10 分钟 (-80%)配置错误定位: 从查看日志 → 可视化显示 (80%)用户体验: 从复杂 → 简单友好 (100%)开始使用 TradingAgents-CN享受智能股票分析的乐趣需要帮助 提交 Issue: https://github.com/hsliuping/TradingAgents-CN/issues 查看文档:docs/目录 加入讨论: GitHub Discussions【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考