从旧 CLI 迁移到 GraphRAG 3.x
命令映射
| 旧教程写法 | 3.x 写法 |
|---|---|
python -m graphrag.index --init --root ./ragtest | graphrag init --root ./ragtest |
python -m graphrag.index --root ./ragtest | graphrag index --root ./ragtest |
python -m graphrag.query --root ./ragtest --method global "..." | graphrag query --root ./ragtest "..." --method global |
| 重新运行完整索引来吸收新增数据 | graphrag update --root ./ragtest |
| 旧提示调优入口 | graphrag prompt-tune --root ./ragtest |
推荐迁移顺序
- 在独立虚拟环境安装
graphrag==3.3.0。 - 新建空目录运行
graphrag init，得到当前默认配置。 - 逐项迁移模型、输入、缓存和存储配置，不直接覆盖新文件。
- 运行
graphrag index --dry-run。 - 用小型数据执行索引，并用固定的 Global、Local、DRIFT、Basic 问题集验证。
- 验证通过后再替换正式流程。
--dry-run 只证明配置和工作流可解析，不证明真实模型调用、费用或结果质量已经验收。