首次数据同步为什么需要 2～4 小时

先看正常耗时范围

同步类型	常见耗时	说明
日常增量同步	约 2 分钟	本地已有数据库水位，只补充新交易日数据。
最新季报或中报财务数据	约 30～50 分钟	财务接口数量多，并受到数据源积分、频率和网络影响。
空库首次建仓或强制补历史	约 2～4 小时	重新拉取股票、ETF、可转债、指数、资金流等历史数据。

为什么首次建仓最慢

QFO 优先读取本地 SQLite 数据库。空库第一次同步时，系统需要按日期和数据类型请求大量历史记录，写入本地并更新各类数据水位。勾选范围越多、开始日期越早，请求和写入量越大。

数据库水位是什么

水位可以理解为“本地已经同步到哪一天”。有水位后，系统只请求缺少的日期，因此日常更新通常很快。水位不是行情预测指标，只是同步进度记录。

什么时候使用“强制补历史”

财务日期为什么不是今天

“财务报表最新 2026-06-30”一类日期是季报或中报的报告期日期，不是同步当天日期。财报按季度披露，天然存在滞后。如果日志显示“财务数据：跳过”，本次同步不会消耗财报拉取时间。

看起来卡住时怎么判断

1. 查看同步日志是否仍在出现新数据类型或日期。
2. 确认网络稳定，并检查 Tushare Token 和积分是否满足所选接口。
3. 首次建仓不要反复关闭和重启；先给慢接口足够时间。
4. 如果长时间没有任何新日志，保存最后一段日志并到 Discussions 交流。