模型下载流程

开始下载

1. 在 Model → Download 选择 OmniCore、Hugging Face 或 ModelScope。
2. 打开模型详情并选择量化版本。
3. 核对能力、许可证和 Total download。
4. 点击 Download，通过全局下载中心跟踪任务。

为什么有些模型包含两个文件

文本模型通常只需要主 GGUF 权重。视觉模型通常还需要 mmproj，用于把图片特征投影到语言模型可以理解的表示中。

OmniStudio 把主权重和 mmproj 作为同一个 bundle：

• Model weights：主 GGUF 文件。
• Vision projector：mmproj 文件。
• Total download：整个 bundle 的完整字节总量。

下载阶段从主权重切换到 mmproj 不代表任务重新开始。较早版本可能在此时调整百分比，因为完整总量是在后续阶段才确定；应以当前阶段、已下载字节和最终完成状态判断。带聚合进度修复的后续版本会在完整总量可确定后保持单调进度，未知时使用不定进度而不是提前显示 100%。

下载完成

整个 bundle 完成后，模型才会出现在 Installed 中。不要只看到主 GGUF 文件落盘就手工启动另一个下载；先检查全局下载中心是否仍在处理 Vision projector。

下载目录可以在 Settings → Model directory 中查看或修改。不要把模型放到 runtime 后端目录；runtime 与用户模型是两类独立数据。