TradingAgents-CN V2.1.0 bug 修复和优化

2026-06-12 6282点热度 0人点赞 0条评论

📋 概述

V2.1.0 发布后，我们围绕“能不能稳定交付、能不能稳定运行、升级后会不会出问题”这三件事，继续补齐了一批真实部署和升级场景中的高频问题。

这一轮更新主要覆盖以下几个方向：

Windows 安装包与 Docker 镜像缺失高级课程正文
Akshare 数据源 无法同步数据，导致股票筛选模块无法搜到结果
多架构镜像脚本 在服务器环境中无法直接构建
Docker 代理层偶发 503，前端动态模块加载失败
覆盖升级后分析任务提示 “工作流不存在”
股票同步链路阻塞前端请求，导致长时间无响应
模型兼容性、测试环境健康检查、数据源选择不一致等细节问题

这次修复的核心目标只有一个：让 2.1.0 在真实用户环境中更稳定、更可复现、更容易排查。

🎯 本轮更新的 5 个重点方向

1. 安装包与 Docker 交付闭环补齐

本轮最直接的一类问题，来自“代码已经有了，但最终交付物里没有”。

最典型的例子就是 高级课程正文。此前 Windows 安装包同步脚本排除了 docs/courses/advanced/expanded，而 Docker 构建上下文又通过 .dockerignore 把 Markdown 全局排除了，结果就是：

本地开发环境看起来正常
但安装版和 Docker 版运行时读取不到课程正文
用户点击高级课程后直接出现 404

针对这个问题，我们做了两层修复：

Windows 安装包 和更新包重新纳入高级课程正文与相关文档目录
Docker 构建上下文 显式放行高级课程运行时依赖的 Markdown 与配图目录

这意味着高级课程不再只是“源码里存在”，而是真正能跟随安装包与镜像一起交付。

同时，多架构构建脚本 也补齐了两个关键缺口：

服务器环境下如果没有 BUILD_INFO 生成脚本，也能自动兜底生成构建元数据
多架构构建前会先在宿主机构建前端产物，避免 frontend/dist 缺失导致构建中断

这类修复看起来偏工程细节，但它们解决的是交付流程里最容易被忽略、却最影响上线效率的问题。

2. Docker 部署稳定性显著提升

另一个典型问题发生在 Docker 部署链路。

我们排查到一个很隐蔽的配置漂移：真正被编排挂载的 Nginx 配置文件，仍然使用静态 upstream；而仓库里较新的动态 DNS 修复版本，并没有被实际部署引用。这会导致当前端或后端容器重建后，Nginx 继续使用旧 IP，最终出现：

静态 chunk 返回 503
浏览器报 “动态导入模块失败”
页面偶发白屏或局部模块加载失败

这一轮修复中，我们把实际挂载的 Pro Nginx 配置 统一切到动态 DNS 解析模式，并补齐了：

静态资源代理策略
API 禁缓存策略
WebSocket / 长连接超时设置
明确的 /health 健康探针

另外，前端容器和 Nginx 容器的健康检查也同步修正。此前使用的 wget --spider 在 Alpine / busybox 环境下兼容性并不稳定，服务明明可用，容器状态却长期显示 unhealthy。现在统一改成更稳妥的探测写法后，监控状态和实际服务可用性终于一致了。

3. 升级兼容性继续补强

升级问题往往不是“新功能不能用”，而是“旧配置把新流程拖垮”。

这次我们修复了一个典型场景：Windows 安装版覆盖升级到 2.1.0 后，部分用户创建分析任务会提示 “工作流不存在”。根因并不在任务创建本身，而是历史配置里残留的 default_workflow_id 仍指向旧版本自定义 UUID。统一分析引擎此前直接信任这个 ID，没有在运行前校验它是否仍然有效。

修复后，系统会在任务真正执行前先验证活动工作流是否还能加载：