Appearance
快速上手：下载你的第一个模型
欢迎使用 Model Downloader！这篇文章会带你从零开始，一步步下载到你的第一个模型。全程不用懂任何技术，跟着做就行，大约 5 分钟即可完成。
一、先认识两个「模型库」
打开软件后，你会看到两个模型来源，它们就像两个大超市，只是卖的东西不同：
| 模型库 | 是什么 | 特点 |
|---|---|---|
| HF 模型库 | HuggingFace（全球最大的模型平台） | 模型数量多、更新快，很多热门大模型都先在这里发布 |
| 魔搭模型库 | ModelScope（阿里达摩院出品） | 国内访问速度快，中文模型丰富，下载通常更顺畅 |
小提示：如果你在国内网络环境，刚开始练手建议先选魔搭模型库，访问更稳定。两个库的操作方式完全一样，学会一个就都会了。
二、找一个想下载的模型
方式一：直接浏览（最简单）
- 点击左侧菜单进入「HF 模型库」或「魔搭模型库」。
- 页面会直接展示模型列表，就像逛超市货架一样，随意浏览即可。
- 列表上方可以切换排序方式（如「最多下载」「最多喜欢」），把热门模型排到前面来。
方式二：搜索（最快）
在页面顶部的搜索框输入关键词，回车即可：
- 常规搜索：输入模型名或关键词，例如
qwen、deepseek，会列出相关模型和作者。 - ID 搜索：如果你已经知道模型的准确编号（例如
Qwen/Qwen2.5-7B-Instruct），切换到这个模式，输入编号就能精确定位。 - 作者搜索：想看某家公司/团队的所有模型，输入作者名，例如
openai。
小提示：在搜索框直接粘贴一个模型网页链接（如
https://huggingface.co/Qwen/Qwen2.5-7B-Instruct），软件会自动识别并直达对应模型页面，非常方便。
方式三：按作者逛
如果目标不明确，也可以先搜作者，点进作者卡片，浏览他发布的所有模型。
三、看懂模型详情页
找到感兴趣的模型后，点击模型卡片，就进入了模型详情页。这里主要看两块内容：
- 上半部分：模型的简介、参数规模、任务类型（如「文本生成」「图像分类」）、许可证等，还有完整的 README 文档（相当于模型的说明书），帮你判断这个模型适不适合你。
- 文件列表：这个模型的所有文件都在这里，比如模型权重文件（
.safetensors、.bin）、分词器（tokenizer.json）等。文件大的通常就是核心的权重文件。
小提示：动手下载前，先留意一下文件大小（如 10 GB），确保磁盘空间和网络都够用。
四、多选下载文件
一个模型往往由多个文件组成，你可以只挑需要的下载：
- 在文件列表中，逐个勾选要下载的文件；文件很多时，可以点「展开全部 / 收起全部」快速浏览。
- 嫌麻烦？直接点「下载全部模型」，一键打包带走所有文件。
- 点击下载后，会弹出确认窗口，选择保存目录（或使用默认路径），确认即开始。
小提示：勾选下载前，如果列表里能看到
SHA256校验信息，下载完成后可以核对文件完整性。
五、查看下载进度
下载开始后，进入左侧「下载管理」，在这里可以随时掌握一切：
- 一级视图：每个模型一行，显示整体进度条、下载速度、剩余文件数。多个模型同时下载时会自动排队。
- 二级视图：点进某个模型，能看到每个文件的下载状态。
- 线程进度：点击进度条，还能看到每个下载线程的实时分片进度——这就是「多线程加速」的直观体现。
常用的操作按钮：
| 操作 | 作用 |
|---|---|
| 暂停 / 恢复 | 随时暂停，随时继续，进度不会丢 |
| 重试 | 网络出问题导致中断时，点击重试会从断点继续，不用重新下载 |
| 取消 / 删除 | 不再需要时清理任务，残留的分片也会一并清除 |
小提示：下载完成后，可以在任务里点「文件夹中显示」，快速定位到已下载的文件。
六、遇到问题怎么办？
下载速度慢？ 在「设置」里打开 HuggingFace 国内镜像代理（下载 HF 模型时特别有效），或调高下载线程数（1-32）。
提示「需要访问权限」？ 该模型是 gated 模型，需要在「设置」里填写你的 HuggingFace 访问令牌（Access Token） 后才能下载。
下载中断了？ 别慌，点「重试」即可从断点继续，之前下载的字节不会白费。
现在，去下载你的第一个模型吧！如果还有疑问，欢迎通过官网右下角的交流入口加入我们的飞书交流群。