TradingAgents-CN 配置系统迁移指南JSON 文件与 ConfigManager 废弃通知及 MongoDB 迁移实战【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN导读本指南围绕 TradingAgents-CN基于多智能体 LLM 的中文金融交易框架于 2025-10-05 发布的废弃通知docs/changes/DEPRECATION_NOTICE.md展开系统梳理旧 JSON 配置文件系统与ConfigManager类的废弃原因、时间表与迁移路径。读者将掌握如何通过迁移脚本将models.json、settings.json、pricing.json、usage.json一键迁移到 MongoDBsystem_configs集合理解新旧 API 端点的对应关系以及环境变量 API 密钥的演进方向确保项目平滑过渡到新版配置体系。一、废弃背景为什么 JSON 配置文件系统被淘汰自 2025-10-05 起TradingAgents-CN 将基于 JSON 文件的旧配置系统正式标记为废弃计划于2025-12-31 完成移除。废弃原因集中在五个方面配置分散配置分散在多个 JSON 文件中难以统一管理缺乏验证JSON 文件缺乏类型验证与格式检查错误配置难以在启动前被发现不支持动态更新任何配置修改都需要重启服务才能生效影响在线运维缺乏审计无法追踪配置变更历史出现问题难以回溯多实例同步困难多个服务实例之间配置同步复杂容易产生配置漂移。替代方案是 MongoDB 持久化配置配置统一存入system_configs集合由 app/services/config_service.py 中的ConfigService提供读写服务天然具备动态更新、版本管理、校验与审计能力。1.1 废弃的文件清单以下四个 JSON 文件均在废弃范围内替代方案明确文件用途替代方案config/models.json大模型配置MongoDBsystem_configs.llm_configsconfig/settings.json系统设置MongoDBsystem_configs.system_settingsconfig/pricing.json模型定价MongoDBsystem_configs.llm_configs[].pricingconfig/usage.json使用统计MongoDBllm_usage集合注意当前仓库根目录的 config 目录下已不再保留这四个 JSON 文件仅剩logging.toml、logging_docker.toml与README.md说明迁移后的项目已全面转向数据库配置这一点与废弃通知中的时间表2026-03-31 移除旧系统相吻合。二、迁移实操从 JSON 到 MongoDB 的五步流程废弃通知给出了完整的迁移步骤配合仓库根目录的 scripts/migrate_config_to_db.py 脚本可一键完成。步骤 1备份现有配置# 自动备份到 config/backup/ python scripts/migrate_config_to_db.py --backup从源码看备份逻辑位于ConfigMigrator.backup_configs()脚本会在config/backup/下按时间戳%Y%m%d_%H%M%S创建备份目录并将存在的models.json、settings.json、pricing.json、usage.json逐一复制进去。备份默认开启也可用--no-backup显式关闭。步骤 2执行迁移Dry Run 预演# 先查看将要迁移的内容不实际写入 python scripts/migrate_config_to_db.py --dry-runDry Run 模式会跳过备份与数据库写入仅打印将要迁移的模型provider、model_name、enabled 状态与系统设置键值对帮助你在正式迁移前核对数据范围。migrate_llm_configs()中对应逻辑为[DRY RUN] 将要迁移的模型: • dashscope: qwen-turbo (enabledTrue)步骤 3执行实际迁移python scripts/migrate_config_to_db.py脚本执行顺序见ConfigMigrator.run()为备份 → 连接数据库基于app.core.config.settings中的MONGODB_*配置构建 URI并ping测试连接→ 迁移大模型配置 → 迁移系统设置 → 验证迁移结果。大模型配置迁移的要点migrate_llm_configs()读取models.json同时加载pricing.json构建provider:model_name → 定价映射将input_price_per_1k、output_price_per_1k、currency一并写入llm_configs若models.json中模型缺少api_key脚本会自动回退读取环境变量如OPENAI_API_KEY、DASHSCOPE_API_KEY、DEEPSEEK_API_KEY、GOOGLE_API_KEY、ZHIPU_API_KEY默认参数兜底max_tokens4000、temperature0.7、enabledFalse第一个enabledTrue的模型会被标记为is_default。系统设置迁移migrate_system_settings()则从settings.json提取max_debate_rounds、max_risk_discuss_rounds、online_tools、online_news、realtime_data、memory_enabled等字段并合并进包含max_concurrent_tasks、cache_ttl、log_level、enable_monitoring、worker_heartbeat_interval、sse_poll_timeout的默认设置模板。写入数据库时若目标system_configs集合中已存在config_type: system的记录且未指定--force脚本会提示“系统配置已存在使用 --force 强制覆盖”并跳过写入避免误覆盖线上配置。步骤 4验证迁移结果# 启动后端服务 python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 # 访问 Web 界面检查配置是否正确 # http://localhost:3000/settings/config迁移脚本本身也内置了验证环节verify_migration()查询system_configs中的系统配置打印大模型配置数量、系统设置数量并列出所有已启用模型及其默认标记。迁移完成后脚本会提示后续步骤启动后端验证配置加载、在 Web 界面检查、确认无误后删除旧 JSON 文件、备份文件位于config/backup/。步骤 5删除旧配置文件可选# 确认迁移成功后可以删除旧的 JSON 文件 # 注意请先确保备份已完成 rm config/models.json rm config/settings.json rm config/pricing.json rm config/usage.json该命令仅为示例说明。实际操作时请务必先确认备份目录config/backup/内容完整、Web 界面配置显示正确后再执行。2.1 迁移脚本参数速查参数说明--dry-run仅显示将要迁移的内容不实际执行同时跳过备份--backup迁移前备份现有配置默认启用--no-backup不备份现有配置--force强制覆盖已存在的数据库配置三、代码层迁移ConfigManager → ConfigService3.1 废弃的类与方法ConfigManager位于 tradingagents/config/config_manager.py同样被标记废弃计划于2026-03-31移除。其废弃原因与 JSON 文件系统一致基于文件的配置管理、不支持动态更新、缺乏类型验证。废弃方法与替代方案对照类/方法位置替代方案ConfigManagertradingagents/config/config_manager.pyapp.services.config_service.ConfigServiceConfigManager.get_models()同上ConfigService.get_llm_configs()ConfigManager.get_settings()同上ConfigService.get_system_settings()ConfigManager.update_model()同上ConfigService.update_llm_config()ConfigManager.update_settings()同上ConfigService.update_system_settings()从源码看废弃状态已实际落地config_manager.py模块顶部包含明确的废弃声明“⚠️ DEPRECATED: 此模块已废弃将在 2026-03-31 后移除”并在导入时通过warnings.warn(..., DeprecationWarning)主动触发警告提示开发者迁移至ConfigService并参考废弃通知文档。3.2 旧代码与新代码对照旧代码基于文件from tradingagents.config.config_manager import ConfigManager # 获取配置 config_manager ConfigManager() models config_manager.get_models() settings config_manager.get_settings() # 更新配置 config_manager.update_model(dashscope, qwen-turbo, {enabled: True})新代码基于 MongoDBfrom app.services.config_service import config_service # 获取配置 config await config_service.get_system_config() llm_configs config.llm_configs system_settings config.system_settings # 更新配置 await config_service.update_llm_config( providerdashscope, model_nameqwen-turbo, updates{enabled: True} )3.3 新配置服务的实现细节ConfigService的实现位于 app/services/config_service.py几个关键方法的行为从源码中可以确认get_system_config()优先从数据库按is_active: True且按version降序读取最新配置避免缓存陈旧若无激活配置则调用_create_default_config()创建默认配置内置 OpenAI GPT-3.5、智谱 GLM-4、通义千问等示例模型以及 AKShare / Tushare 数据源、MongoDB/Redis 数据库配置并自动写入数据库。作为兜底读取失败时会回退到统一配置管理器app.core.unified_config。版本与激活机制save_system_config()每次保存都会version 1并将当前激活配置置为非激活后再写入新版本这正是新系统“配置历史与回滚”能力的实现基础。update_llm_config()/update_system_settings()对应旧update_model()/update_settings()的能力但读写均直接面向数据库集合。此外ConfigService还扩展到市场分类market_categories、数据源分组datasource-groupings、模型目录model-catalog等更细粒度的管理能力远超出旧文件系统能承载的范围。四、API 端点迁移旧端点 → 新端点废弃通知明确了两组旧 API 端点的替代关系端点废弃时间替代端点/api/config/models2025-10-05/api/config/llm/api/config/providers2025-10-05/api/config/llm/providers从 app/routers/config.py 的路由定义router APIRouter(prefix/config, ...)可以确认新端点体系的完整性GET /api/config/llm获取 LLM 配置列表POST /api/config/llm新增 LLM 配置DELETE /api/config/llm/{provider}/{model_name}删除指定模型POST /api/config/llm/set-default设置默认模型GET /api/config/llm/providers、POST /api/config/llm/providers、PUT/DELETE/PATCH /api/config/llm/providers/{provider_id}提供商维度的增删改查与启停切换POST /api/config/llm/providers/migrate-env将环境变量中的密钥迁移入库GET/PUT /api/config/settings、GET /api/config/settings/meta系统设置读取、更新与元数据POST /api/config/reload配置热重载。这意味着旧客户端若仍调用/api/config/models或/api/config/providers需要同步升级为上述新端点所有新端点均依赖get_current_user鉴权见app.routers.auth_db并支持操作日志记录。五、环境变量中的 API 密钥计划废弃与保留范围API 密钥通过环境变量.env文件管理的方式也被列入计划废弃清单标记废弃2025-10-05计划移除2026-03-31废弃原因有二API 密钥应通过 Web 界面统一管理环境变量应仅用于系统级配置数据库、Redis、安全密钥等。迁移建议将 API 密钥从.env文件迁移到 Web 界面设置页面的 LLM 提供商管理保留环境变量作为备用方案且优先级低于数据库——即数据库中的密钥优先使用环境变量仅作为回退。以下环境变量将继续支持用于最小化启动MONGODB_*— 数据库连接REDIS_*— Redis 连接JWT_SECRET— JWT 密钥CSRF_SECRET— CSRF 密钥作为配套能力ConfigService引入了provider_keys模块的normalize_provider_key/canonical_aliases见 tradingagents/llm_clients/provider_keys.py 的引用关系用于规范化不同来源环境变量、JSON、数据库的提供商名称避免同一提供商因大小写或别名差异产生重复配置。六、废弃时间表与过渡机制6.1 时间表2025 年 Q4日期项目状态2025-10-05标记 JSON 配置系统为废弃✅ 完成2025-10-05标记 ConfigManager 为废弃✅ 完成2025-10-15创建配置迁移脚本✅ 完成2025-11-01更新所有代码使用新配置系统 进行中2025-12-01在文档中添加废弃警告 计划中2026 年 Q1日期项目状态2026-01-01在启动时显示废弃警告 计划中2026-02-01在 Web 界面显示迁移提示 计划中2026-03-31移除旧的 JSON 配置系统 计划中2026-03-31移除 ConfigManager 类 计划中6.2 启动时警告从 2026-01-01 开始若检测到使用旧的配置系统启动时会显示警告⚠️ 警告: 检测到旧的 JSON 配置文件 • config/models.json • config/settings.json 这些文件将在 2026-03-31 后不再支持。 请使用迁移脚本迁移到新的配置系统 python scripts/migrate_config_to_db.py 详细信息: docs/DEPRECATION_NOTICE.md6.3 Web 界面迁移提示从 2026-02-01 开始Web 界面会显示迁移提示 提示: 您正在使用旧的配置系统 为了获得更好的体验建议迁移到新的配置系统。 新系统支持 • 动态更新配置无需重启 • 配置历史和回滚 • 更好的验证和错误提示 [立即迁移] [稍后提醒] [不再显示]七、迁移后的能力收益与落地验证迁移到 MongoDB 配置体系后项目获得的实质能力提升可以从源码结构中得到印证动态更新无需重启POST /api/config/reload与PUT /api/config/settings等端点直接读写数据库配合 app/core/unified_config.py 的统一配置层配置变更可即时生效配置历史与回滚system_configs集合按version递增保存配置快照get_system_config()按version降序读取为回滚保留了数据基础更严格的校验配置读写均经过 app/models/config.py 中LLMConfig、SystemConfig、DataSourceConfig等 Pydantic 模型的类型约束提供商标准化normalize_provider_key避免同一提供商多别名导致的数据冗余。对于希望进一步了解迁移设计与背景的读者仓库文档目录中还有配套资料可供参考配置指南、配置分析、配置优化计划 以及 配置迁移文档。迁移脚本本体位于 scripts/migrate_config_to_db.py可随时查阅源码细节。八、FAQ 与排障要点迁移脚本提示“系统配置已存在”怎么办脚本默认不会覆盖已有数据库配置。若确认要覆盖请加--force参数重新执行。迁移后 Web 界面配置不正确先确认迁移脚本的verify_migration()输出中 LLM 配置数量与启用的默认模型是否符合预期再检查后端日志中get_system_config()打印的配置版本号必要时可先通过--dry-run预演核对字段。旧的 JSON 文件删除了还能回退吗可以。--backup默认会在config/backup/时间戳/保留全部旧文件删除前请确认该目录内容完整。新 API 端点需要鉴权吗需要。所有/api/config/*端点均通过get_current_user依赖进行用户鉴权调用前需先完成登录并携带有效凭证。迁移过程中遇到问题找谁优先查看 配置指南 与 配置优化计划也可在项目仓库提交 Issue 反馈。结语TradingAgents-CN 的配置系统废弃与迁移是项目从“文件配置时代”迈向“数据库配置时代”的关键一步。本文从废弃通知出发结合迁移脚本、ConfigService源码与配置路由实现完整梳理了废弃文件、废弃类、API 端点与环境变量的迁移路径。对于仍在维护旧配置的项目实例建议在 2026-03-31 移除日期前完成迁移尽早享受动态更新、配置历史与统一校验带来的运维红利。【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考