版本升级如果项目来自 2024 年的教程，不要只替换安装版本。命令入口、配置结构和查询方法都可能已经变化，建议先用一个干净的小项目确认 3.x 的行为，再改现有项目。旧 CLI 升级到 3.x替换 python -m 入口，对照新命令和参数先建一个干净项目用少量样本确认当前版本可以正常索引和查询