导入已有 GGUF 模型

如果模型已经保存在本机，无需重新下载。进入 Model → Installed，点击 Import Model，然后选择单个 GGUF 文件或包含模型的文件夹。

导入前检查

• 主模型必须是 OmniStudio 当前支持的 GGUF 文件。
• 视觉模型的 mmproj 应与主模型放在同一目录。
• 原文件应位于长期保留的位置，不要从临时目录、移动磁盘或即将删除的下载目录导入。

导入过程

1. 点击 Import Model。
2. 使用系统原生文件选择器选择 GGUF 文件或文件夹。
3. OmniStudio 扫描主模型和相邻的 mmproj。
4. 导入完成后，在 Installed 中确认模型名称、量化和能力标签。

OmniStudio 会优先以链接方式把外部模型登记到用户模型目录，避免复制大型权重。是否能创建链接取决于操作系统权限和文件系统；失败时应用会显示错误，不会静默删除或移动原文件。

导入后无法使用

• 检查主模型与 mmproj 是否确实属于同一模型版本。
• 确认文件没有被其他程序删除、改名或移动。
• 在设置中打开当前模型目录，检查登记结果。
• 打开 Developer Logs，保留最近的导入或加载错误并提交反馈。