常见问题解答

如果未能列出您的问题，您也可以使用DeepWiki与AI助手交流，这可以解决大部分常见问题。

如果您仍然无法解决问题，您可通过Discord或WeChat加入社区，与其他用户和开发者交流。

Windows 推理很慢或引擎安装失败怎么办？

基础包默认可使用 ONNX / CPU 与 llama.cpp。需要 Torch 小模型和 LMDeploy 时，在原虚拟环境中安装 "mineru[full]>=4.0,<5"，并核对 Torch 的 CUDA 支持、显卡驱动及引擎 wheel 的 Python 范围。

4.0 使用 lmdeploy>=0.17.0,<0.18 和 Transformers 5；不要套用旧版 LMDeploy 0.11.x 的 wheel 或跳过依赖检查。详见扩展模块和档位说明。

升级后旧命令、API 或配置不再工作怎么办？

4.0 WebUI 使用 mineru-kit webui / mineru-webui，解析 API 使用 /v1/*，配置使用 config.yaml。旧 /file_parse、/tasks 和 model.stack 不能直接沿用。见迁移指南。

在WSL2的Ubuntu22.04中遇到报错ImportError: libGL.so.1: cannot open shared object file: No such file or directory

WSL2的Ubuntu22.04中缺少libgl库，可通过以下命令安装libgl库解决：

sudo apt-get install libgl1-mesa-glx

参考：#388