内置 HuggingFace 客户端：搜索、热门、趋势榜，断点续传与完整性校验，国内网络自动回退 hf-mirror 镜像。
为什么在面板里下载
- 不用浏览器找链接、点错版本
- 断点续传：中断后自动续传，不怕大文件
- SHA-256 完整性校验：下载完自动校验，失败自动删除重下，杜绝坏文件
- 多目录回退：主目录空间不足自动下载到备用目录
演示图占位
此处放：模型下载页界面
说明：搜索 / 热门 / 趋势榜与模型详情、GGUF 文件选择
操作步骤
- 进入「模型下载」页
- 三种浏览方式：
- 搜索：输入模型名关键词（如
Qwen3、gemma） - 热门：查看当前热门模型榜
- 趋势：查看上升趋势模型
- 打开目标模型详情，选择 GGUF 格式文件（注意量化标签，如
Q4_K_M） - 点击下载，任务进入下载列表，显示进度与速度
选择正确的文件
GGUF 文件名里的量化等级决定显存占用与质量：
| 量化 | 大小 / 质量 | 适用 |
|---|---|---|
| Q8_0 | 大 / 高 | 显存充足，追求质量 |
| Q6_K | 中 / 较高 | 均衡之选 |
| Q5_K_M / Q4_K_M | 中 / 中 | 最常用，性价比高 |
| Q3_K / IQ 系列 | 小 / 较低 | 小显存救急 |
拿不准就选
Q4_K_M，这是绝大多数场景的平衡点。 还需确认该文件是否带mmproj（多模态投影）——要跑视觉模型时需要一起下载。
演示图占位
此处放：下载任务列表
说明：进度、断点续传与 SHA-256 校验结果
下载目录
- 默认下载到
models目录 - 可在设置中配置多个下载目录：主目录空间不足时自动回退备用目录
- 下载完成后自动归入模型库，可直接新建模型卡引用
网络与镜像
- 官方源不可达时，自动回退 hf-mirror 国内镜像
- 顶部提示「未检测到网络连接」时，搜索/下载不可用，但本地已启动的模型不受影响
常见问题
| 现象 | 处理 |
|---|---|
| 下载到一半失败 | 重新点下载，会从断点续传 |
| 校验失败 | 文件损坏，自动删除重下，无需手动处理 |
| 下载很慢 | 检查网络；镜像回退后通常有明显改善 |
| 磁盘不足 | 增加备用下载目录 |
下一步
- 下载完怎么配置模型 → 05 · 模型管理
- 显存不够时选量化 → 12 · 故障排查