QFO量化回测平台 1.0.2

QFO量化回测平台 v1.0.2 发布日志

本次更新重点重构了跨面板业务数据流，完成了“策略回测 → 组合优化 → 风险管理”全链路上下文联动与历史刷新机制，并全面优化一键启动器，解决新用户在无虚拟环境或网络源不可用时的启动阻断问题。

🔗 跨模块联动闭环

• 回测上下文统一打通：打通“策略回测 → 组合优化 → 风险管理”的数据流。
• 历史回测加载联动刷新：修复从历史记录加载回测详情时遗漏触发组合优化刷新的缺陷。
• 面板来源透明展示：在“组合优化”与“风险管理”面板顶部增加回测来源标签，消除切换 Tab 后的来源困惑。
• 非阻塞式优雅告警反馈：标的不足时追加 warning alert 明确告知原因，不再静默吞错。

🚀 一键启动器重大优化（开箱即用保障）

• 多镜像源全自动容灾降级：run_first_time.bat 放弃单一清华源硬编码，升级为阿里云 → 腾讯云 → 官方 PyPI 三级自动降级。
• 前端 npm 镜像自动容灾：官方 npm registry 失败时自动尝试 npmmirror。
• Windows 批处理变量冻结 Bug 修复：改用动态 if errorlevel 1 判断，避免安装成功后被误判退出。
• 路径含空格安全处理：使用 pushd / popd 目录栈，避免项目路径含空格时启动中断。

🧹 代码健康度与环境兼容

• 依赖审计修复：清理未声明且未生效的冗余 httpx 备用导入。
• FastAPI 0.141+ 兼容：优化路由反射机制，兼容新版 Starlette/FastAPI。
• 自动化测试：69 项前端单测、66 项后端单测以及 34 项平台架构质量审计通过。

🛠️ v1.0.1 首次启动错误说明

如果运行 v1.0.1 时出现：

ERROR: Could not find a version that satisfies the requirement fastapi>=0.104.0
ERROR: No matching distribution found for fastapi>=0.104.0

通常不是 FastAPI 版本不存在，而是 v1.0.1 使用的单一 Python 镜像无法访问，pip 因此无法读取可用版本列表。v1.0.2 已加入阿里云、腾讯云和官方 PyPI 自动降级，并同步增加 npm 备用镜像。

⬆️ 从 v1.0.1 升级

1. 下载本页的 QFO-Quant-Platform.zip，不要下载自动生成的 Source code 源码包。
2. 建议解压到新目录，不要直接覆盖旧目录；如已有本地数据，请先备份 backend/.env、数据库和 cache_data。
3. 确认 Python 3.12+ 和 Node.js 18+ 已安装并加入 PATH：

python --version
node --version
where python
where node

4. 双击运行 run_first_time.bat。如果仍然失败，请保留命令窗口最后 30 行错误信息，并提交 Windows 版本、Python/Node.js 版本和错误截图。

说明：v1.0.2 解决的是启动脚本和依赖源相关问题；如果本机 Python、Node.js、网络代理或安全软件本身不可用，仍需按上述信息进一步排查。

📦 原有数据迁移

从旧版本升级时，不需要重新拉取全部历史数据。请先阅读：更新到新版本，如何复制并迁移原有数据。