v1.4.0 - 同步加速 + 进度优化 + API 配额保护

新功能

同步速度大幅提升

• 启动同步时自动并发查询所有产品的最新日期，Plan 阶段从 ~50s 降到几秒
• API 日期结果本地缓存（5 分钟 TTL），刚检查过更新后同步启动几乎瞬间

同步进度一目了然

• 进度条下方实时显示"已完成 N/M · 最新: 产品名"
• 已完成产品倒序排列（最新在上），无需滚动
• 等待中产品默认折叠，界面更清爽

API 配额保护

• Setup Wizard 新增课程类型选择（股票/币圈课程 或 分享会）
• 同步前自动预估 API 调用量，超阈值时提醒确认
• 避免长期未同步时意外耗尽 API 配额

修复

• 日期解析兼容 ISO datetime 格式，修复部分产品在总览页误显示为"异常"
• 后处理阶段（币圈预处理）新增进度反馈，不再静默等待

升级方式

覆盖解压即可，数据和配置不受影响。已有用户无需重新配置。

v1.3.1: 配置校验 + 迁移兼容

优化

• data_root 配置校验：检测到 data_root 误指向产品子目录时，提前报错并给出修复建议（重跑 setup 或编辑 user_config.json），不再静默失败
• 无 timestamp 时自动推断：从官方客户端迁移后缺少 timestamp.txt 时，从 CSV 数据内容推断本地最新日期，自动回补缺失数据（不再只下载最新一天）
• 健康检查增强：无 timestamp 的产品也能参与日期连续性检查，发现数据缺口

修复

• discover_local_products 不再把点目录（.cache、.quantclass_sync）误识别为产品
• 推断日期经过 normalize_data_date 校验，过滤伪日期值

从旧版升级：下载新版覆盖解压即可，数据和配置不受影响。

v1.3: GUI 重构 + 数据质量校验

新功能

• 数据质量检查：总览页新增"数据健康"按钮，一键全面扫描所有产品数据。检查重复行、字段空值、文件缺失、日期连续性等 10 项指标，发现问题后可一键修复
• GUI 全面重新设计：总览、同步、历史三个页面重构，信息更紧凑、视觉更统一
  • 总览页：水平统计卡片、6 列产品表格（新增错误信息列）、底部可点击打开数据目录
  • 同步页：实时产品列表（已完成/等待中），失败原因内联显示，阶段耗时拆分（探测 + 同步），支持重试失败产品
  • 历史页：列表新增失败产品标签列，详情页改用紧凑产品列表

优化

• 追加快捷路径改用原子写入，防止进程意外中断时产生损坏数据
• GUI 关闭后自动清理终端窗口

修复

• 总览页"错误信息"列不再显示正常跳过的原因（仅失败时显示）

命令行新增

# 数据质量全面检查
python3 quantclass_sync.py audit

# 检查并自动修复可修复问题（重复行去重、临时文件清理等）
python3 quantclass_sync.py audit --fix

从旧版升级：下载新版覆盖解压即可，数据和配置不受影响。

v1.2: 检查更新 + 性能优化

新功能

• 检查更新按钮：GUI 总览页一键查询所有产品 API 最新日期，无需下载即可确认数据状态
• 落后天数准确性：改为对比 API 最新日期，解决周末/节假日的误报问题（#1）
• 3 天宽限期：缓存的 API 日期在宽限期内可信，过期自动降级，兼顾准确与省额度
• 新增 20 个产品已知规则：更多产品支持增量合并
• CSV 追加快捷路径：数据严格递增时跳过完整合并，提升同步性能

优化

• GUI 并发提升至 4 + 合并后跳过冗余排序校验
• 向量化复牌检测逻辑，大幅减少循环
• 全项目代码审查修复（复用、质量、效率）
• conda 环境名统一迁移到 user_config.json

修复

• 多项总览状态准确性修复

从 v1.0/v1.1 升级：下载新版覆盖解压即可，数据和配置不受影响。

v1.1: Setup Wizard 首次启动引导

新功能

• 首次启动向导：双击即用，自动安装依赖、引导配置，全程不需要命令行
• 总览页新增"重新配置"入口，无需 CLI 即可修改凭证

修复

• 多项稳定性修复

从 v1.0 升级：下载新版覆盖解压即可，数据和配置不受影响。

v1.0: CLI + GUI 首个正式版

新功能

• 图形界面（GUI）：总览、同步、历史三个页面
• 并发下载：--workers 参数支持 1-8 线程
• status 命令：一屏查看全局同步状态
• .command 双击启动 GUI（macOS）

解压后参照 README.md 三步开始用。