TradingAgents-CN v0.1.11 多LLM提供商集成与模型选择持久化实战指南【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN本文基于 TradingAgents-CN 仓库 v0.1.11 发布说明 编写。该版本是项目的一次重大功能更新将原本单一的 LLM 接入方式扩展为 4 大主流提供商、60 模型的可视化选择体系并首次实现了基于 URL 参数的模型选择真正持久化。读完本文你将掌握 v0.1.11 的完整配置流程、侧边栏模型选择与快速切换操作、持久化机制的底层实现原理以及从旧版本平滑升级的完整路径。版本概览v0.1.11版本号cn-0.1.11发布于 2025 年 7 月 27 日以多 LLM 提供商集成与模型选择持久化为主题属于重大功能更新且完全向后兼容 v0.1.10。其核心成果集中在三个方面多 LLM 提供商全面集成由单一提供商扩展到 4 大主流提供商提供 60 个可选择的 AI 模型覆盖 Claude 4 Opus、GPT-4o、Llama 4、Gemini 2.5 等当时的主流模型模型选择真正持久化基于 URL 参数的存储方案页面刷新后配置不再丢失支持通过 URL 分享特定模型配置并在页面加载时自动恢复上次使用的设置Web 界面全面优化320px 紧凑侧边栏、快速选择按钮、响应式布局与详细模型说明显著改善选择模型的交互体验。配套的详细更新日志见 docs/releases/CHANGELOG_v0.1.11.md其中记录了 8 个文件修改、763 行新增与 408 行删除的完整变更明细。多 LLM 提供商全面集成v0.1.11 之前Web 界面只能接入单一 LLM 提供商该版本在侧边栏 web/components/sidebar.py 中重构了提供商选择逻辑实现了对以下 4 大提供商的统一管理。DashScope阿里百炼国产云厂商渠道面向国内网络环境稳定接入✅ qwen-turbo - 快速响应 ✅ qwen-plus-latest - 平衡性能 ✅ qwen-max - 最强性能从 sidebar.py 源码可以看到DashScope 的三个模型分别标注为 Turbo - 快速、Plus - 平衡、Max - 最强默认选中qwen-plus-latest。对应环境变量为DASHSCOPE_API_KEY见 .env.example。DeepSeek V3国产高性价比选择官方发布说明明确推荐✅ deepseek-chat - 最新V3模型在 .env.example 中DeepSeek 提供了DEEPSEEK_API_KEY、DEEPSEEK_BASE_URLhttps://api.deepseek.com与DEEPSEEK_ENABLEDfalse三个配置项且支持多种布尔值格式true/True/TRUE/1/yes/on表示启用。Google AI面向 Gemini 系列模型✅ gemini-2.0-flash - 推荐使用 ✅ gemini-1.5-pro - 强大性能 ✅ gemini-1.5-flash - 快速响应对应环境变量为GOOGLE_API_KEY见 .env.example。OpenRouter60 模型OpenRouter 作为国际聚合平台是 v0.1.11 模型数量扩展的关键。侧边栏按厂商分为 5 个类别sidebar.py OpenAI类别 ✅ o4-mini-high - 最新o4系列 ✅ o3-pro - 最新推理专业版 ✅ o1-pro - 专业推理 ✅ gpt-4o - 旗舰模型 Anthropic类别 ✅ claude-opus-4 - 顶级性能 ✅ claude-sonnet-4 - 平衡版本 ✅ claude-3.5-sonnet - 经典版本 Meta类别 ✅ llama-4-maverick - 最新Llama 4 ✅ llama-4-scout - Llama 4变体 ✅ llama-3.3-70b - 高性能版本 Google类别 ✅ gemini-2.5-pro - 多模态专业版 ✅ gemini-2.5-flash - 快速版本 自定义模型 ✅ 支持任意OpenRouter模型ID ✅ 5个快速选择按钮从源码结构看OpenRouter 类别的模型均使用厂商/模型的完整路由格式如anthropic/claude-opus-4、meta-llama/llama-4-maverick、google/gemini-2.5-pro与 OpenRouter 平台的模型路由规范一致。自定义类别还内置了 5 个快速选择按钮Claude 3.7 Sonnet、Claude 4 Opus、GPT-4o、Llama 4 Scout、Gemini 2.5 Prosidebar.py点击即可一键填充模型 ID 并写入持久化存储。模型选择持久化机制页面刷新后模型选择丢失是 v0.1.11 之前被高频反馈的问题。该版本通过新增的 web/utils/persistence.py 模块采用URL 参数 Session State双重存储方案从根本上解决。核心实现ModelPersistence持久化逻辑封装在ModelPersistence类中web/utils/persistence.py提供三个核心方法方法作用关键行为save_config(provider, category, model)保存配置同时写入st.session_state[model_config]与st.query_paramsprovider/category/model 三个参数load_config()加载配置优先从 URL 参数恢复失败则回退 Session State均无则返回默认配置dashscope / openai / 空模型clear_config()清除配置删除 Session State 键并调用st.query_params.clear()save_config的源码逻辑persistence.py验证了双写策略配置先存入内存中的 Session State 保证当前会话快速访问再通过st.query_params.update(...)写入浏览器地址栏使配置随 URL 天然具备可分享、可收藏、可刷新恢复的特性。URL 保存失败时仅记录 warning 日志而不中断操作体现了容错设计。模块底部导出三个全局函数save_model_selection、load_model_selection、clear_model_selectionpersistence.py供侧边栏组件直接调用。侧边栏如何消费持久化配置在 sidebar.py 中页面渲染时首先调用load_model_selection()读取保存的配置并用它初始化llm_provider、model_category、llm_model三个 Session State 变量每次用户切换提供商、类别或模型时则立即调用save_model_selection(...)同步写入持久化存储。此外还通过 localStorage 辅助脚本做浏览器端兜底恢复sidebar.py。调试与监控支持持久化流程贯穿了完整日志追踪便于定位配置问题见 CHANGELOG_v0.1.11.md [Persistence] 恢复 llm_provider: xxx—— 页面加载时从持久化存储恢复 [Persistence] 模型变更: xxx → yyy—— 用户切换模型时记录变更轨迹 [Persistence] 模型已保存: xxx—— 每次保存成功都会落日志 [Persistence] 返回配置 - provider: xxx, model: yyy—— 侧边栏最终返回给分析系统的配置。侧边栏底部还会实时显示当前 AI 模型配置AI模型: {provider} - {model}与版本号从仓库根目录VERSION文件读取sidebar.py做到状态可视化。后端配置传递链路侧边栏render_sidebar()最终返回{llm_provider, llm_model, enable_memory, enable_debug, max_tokens}字典sidebar.py其中enable_memory、enable_debug来自高级设置折叠面板sidebar.pymax_tokens为 10008000 可调的滑块默认 4000。这组配置随后传入分析系统解决旧版模型配置传递给分析系统的延迟问题。Web 界面全面优化320px 侧边栏通过内联 CSS 对section[data-testidstSidebar]进行全面样式定制包括收紧内边距、压缩下拉框与按钮尺寸sidebar.py使空间利用更高效同时保证下拉框选项最小 260px在 320px 宽度下完全可见快速选择按钮OpenAI 类别内置 GPT-4o / ⚡ GPT-4o Mini 双按钮sidebar.pyOpenRouter 自定义类别内置 5 个热门模型按钮点击后立即写入 Session State 并调用save_model_selection随后st.rerun()刷新界面实现一键切换响应式布局针对小屏幕适配侧边栏宽度与间距官方发布说明称解决侧边栏宽度在小屏幕上的显示问题详细模型说明每个模型选项均通过format_func提供中文功能标注如 Gemini 2.5 Pro - 最新旗舰模型、GPT-4o Mini - 轻量旗舰辅助用户快速决策。快速开始1. 获取 API 密钥选择至少一个 LLM 提供商并前往其官方平台注册、创建 API Key。官方发布说明的推荐组合为国产高性价比DeepSeek V3DEEPSEEK_API_KEY、DashScope 阿里百炼DASHSCOPE_API_KEY国际功能型OpenRouterOPENROUTER_API_KEY、Google AIGOOGLE_API_KEY。API Key 的完整说明与格式校验逻辑见 .env.example例如 DeepSeek/DashScope 密钥需以sk-开头且长度 ≥ 32Google 密钥以AIza开头且长度 ≥ 32校验函数在 sidebar.py 中侧边栏API 密钥状态区域会实时显示每个提供商的配置状态。2. 配置环境变量# 复制配置模板 cp .env.example .env # 编辑配置文件填入API密钥 # 至少配置一个LLM提供商的API密钥以 v0.1.11 新增的密钥为例# 新增 - DeepSeek V3 (推荐) DEEPSEEK_API_KEYyour_deepseek_api_key_here # 新增 - OpenRouter (60模型) OPENROUTER_API_KEYyour_openrouter_api_key_here # 新增 - Google AI GOOGLE_API_KEYyour_google_api_key_here启动时 web/app.py 会调用load_dotenv(project_root / .env, overrideTrue)加载环境变量。3. 启动应用# 安装依赖 pip install -r requirements.txt # 启动Web界面 streamlit run web/app.pyWeb 入口为 web/app.py页面标题 TradingAgents-CN 股票分析平台采用 wide 布局并默认展开侧边栏。4. 体验新功能选择 LLM 提供商在侧边栏LLM 提供商下拉框中选择已配置密钥的提供商选择具体模型根据功能标注选择合适的模型OpenRouter 需先选类别再选模型测试持久化按 F5 刷新页面验证配置是否保持分享配置复制浏览器地址栏 URL 分享给他人对方打开即可加载相同的模型配置。功能验证官方发布说明提供了三组可直接照做的验证步骤基础持久化测试1. 选择 DashScope → qwen-max 2. 刷新页面 (F5) 3. ✅ 验证选择保持为 qwen-maxOpenRouter 测试1. 选择 OpenRouter → Anthropic → claude-opus-4 2. 刷新页面 (F5) 3. ✅ 验证选择保持为 claude-opus-4 4. ✅ 检查URL包含正确参数成功时浏览器地址栏应包含?provideropenroutercategoryanthropicmodelanthropic/claude-opus-4形式的参数。快速按钮测试1. 选择 OpenRouter → Custom 2. 点击 Claude 4 Opus 按钮 3. 刷新页面 (F5) 4. ✅ 验证模型为 anthropic/claude-opus-4按 CHANGELOG_v0.1.11.md 的测试矩阵DashScope / DeepSeek / Google 三个原生提供商、OpenRouter 四个厂商类别以及自定义模型输入均需逐一验证刷新保持。判断成功的关键标志日志中出现 [Persistence] 恢复而非初始化路径且 URL 参数完整。性能提升与升级指南官方发布说明给出的 v0.1.11 关键指标变化如下数值均为官方发布说明所声明维度v0.1.10v0.1.11模型支持3 个60 个提供商支持1 个4 个配置持久化可靠性0%100%官方声明解决刷新丢失问题此外官方发布说明还声称配置保持率 100%、操作效率提升 80%快速选择按钮、界面响应提升 60%优化布局、错误恢复提升 90%智能异常处理代码层面新增 763 行、优化 408 行。这些数字为发布方自述指标实际效果以本机运行体验为准。从 v0.1.10 升级# 1. 备份当前配置 cp .env .env.backup # 2. 拉取最新代码 git pull origin main # 3. 检查新的配置选项 diff .env.example .env # 4. 重新启动应用 streamlit run web/app.pyv0.1.11 完全兼容 v0.1.10 的配置无需额外迁移步骤新增的DEEPSEEK_API_KEY、OPENROUTER_API_KEY、GOOGLE_API_KEY均为可选配置不配置也能以原有提供商继续运行。已知问题与注意事项该版本已修复的问题官方发布说明页面刷新后模型选择丢失ChromaDB 并发冲突导致的内存错误对应 tradingagents/agents/utils/memory.py 的内存模块改进侧边栏宽度在小屏幕上的显示问题模型配置传递给分析系统的延迟。使用注意事项URL 参数较长时可能影响分享链接美观度某些浏览器可能对 URL 长度有限制建议使用现代浏览器以获得最佳体验。结语v0.1.11 是 TradingAgents-CN 在多 LLM 支持维度上的里程碑版本通过web/utils/persistence.py的 URL 参数持久化方案彻底解决了模型选择刷新丢失问题借助 OpenRouter 聚合渠道将可选模型数量提升至 60并配合 320px 紧凑侧边栏、快速选择按钮与完整调试日志重塑了配置体验。升级路径向后兼容旧用户只需备份.env、拉取代码并重启即可平滑过渡。需要进一步查阅的仓库资料完整更新日志、环境变量配置模板、侧边栏组件源码、持久化模块源码、Web 入口。【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考