软件设置指南

「设置」页集中了 Model Downloader 的所有个性化选项，分为网络与代理、下载设置、通用三块。本文逐项说明每个设置的作用，并给出推荐值，让你配置一次、用得舒心。

进入方式：点击左侧菜单「设置」。修改后记得点右上角**「保存设置」**；「恢复默认」可一键回到初始配置。

---

一、网络与代理

这部分解决「连不上、下载慢」的问题，在国内网络环境下尤其重要。

1. HuggingFace 国内镜像代理（推荐开启）

• 作用：开启后，浏览和下载 HuggingFace 的模型会走 hf-mirror.com 镜像加速，避免直连官方域名卡顿或超时。
• 推荐：默认已开启，建议保持开启。下载 HF 模型变慢时，先确认它没有被关掉。

2. 自定义代理

• 作用：如果你使用了代理软件（如 Clash、V2Ray），可以把代理地址填在这里，例如 http://127.0.0.1:7890。
• 说明：留空表示不用自定义代理，仅使用系统代理。只有当你确定需要时才填写，一般用户留空即可。

3. HuggingFace 访问令牌（Access Token）

创建令牌时，必须启用网络代理才可访问huggingface，网络问题请自行解决！！

• 作用：下载需要访问权限的 gated 模型时必须填写，相当于你的「通行证」。
• 怎么获取：打开 https://huggingface.co/settings/tokens（详情页「去创建」按钮可直接跳转），登录后创建一个 Token 复制进来。
• 说明：只下载公开模型的话，留空即可。

---

二、下载设置

这部分决定「文件存哪、下载多快」。

1. 下载保存路径

• 作用：模型文件默认保存的位置，默认是你的「下载」文件夹。
• 操作：点「选择目录」挑选你希望存放的位置（建议放到剩余空间充足的盘符），选择后会立即保存，无需再点「保存设置」。

2. 下载线程数（1-32）

• 作用：单个文件被拆成多少个分片并发下载，数值越大通常速度越快。
• 推荐：默认 4。宽带较好可以调到 8-16；老电脑或网络不稳时建议保持低值，避免占用过多资源。调整后立即生效，无需重启。

3. 下载队列大小（1-8）

• 作用：最多能同时下载几个模型，超出部分自动排队等待。
• 说明：适合「一次想下好几个模型」的场景。队列满后新任务会自动排队，不会出错。注意：队列是模型级别，多线程是文件级别，两者互不影响。

---

三、通用

这部分决定软件的「使用习惯」。

1. 默认模型来源

• 作用：启动软件时默认打开哪个模型库——HuggingFace 或魔搭。
• 推荐：国内网络建议选「魔搭」，追求模型数量选「HuggingFace」。

2. 主题模式

• 作用：切换软件暗色 / 亮色外观。
• 说明：切换后实时生效并自动保存，无需额外点保存；Windows 原生标题栏也会同步适配。

3. 下载完成声音通知

• 作用：一个模型下载完成后播放提示音，方便你离开电脑也能知道进度。
• 推荐：需要长时间挂机下载时建议开启。

---

四、一键配置参考

按照下面的组合配置，覆盖大多数使用场景：

场景	推荐配置
国内用户日常下载 HF 模型	开启 HF 国内镜像代理；线程数 8
下载 gated 私有模型	填入 HuggingFace 访问令牌
一次下载多个模型	队列大小调到 4-8
磁盘空间紧张	将保存路径改到空间大的盘符
后台挂机下载	开启下载完成声音通知

配置完成后，在「设置」页右上角点击**「保存设置」**即可生效，所有配置都会保存在本机，下次启动自动沿用。