CF Download1. 安装与首次启动
两种版本
- 安装版（Setup）：双击
CF.Download.Setup.3.2.1.exe，按向导安装。安装完成后自动创建开始菜单与桌面快捷方式。 - 便携版（Portable）：单文件
CF.Download.Portable.3.2.1.exe，双击即用，不写注册表，可以放 U 盘随身带。配置数据统一存放在%APPDATA%\cfdownload\，两种版本互相兼容。
首次启动
- 主界面自上而下：菜单栏 → 工具栏 → 搜索/筛选条 → 任务列表 → 状态栏。左侧分类栏按视频 / 音乐 / 程序 / 压缩包 / 文档自动归类已完成文件。
- 工具栏右侧的「Comfy 下载」「Comfy 模型」「GitHub」「模型搜索」「模型加载」「AI 工具」「资源站」是各功能入口，一键直达。
- 右上角 ☀ / 🌙 切换浅色 / 深色主题；设置里还可以自定义背景图片和透明度。
- 首次下载建议先到 设置 里确认「默认下载目录」（见第 9 节）。
任务数据（tasks.json）与授权（license.json）都在
%APPDATA%\cfdownload\，重装或换机时备份这个目录即可完整迁移。2. 添加下载任务
添加 URL
- 点击工具栏 「添加 URL」（或菜单 任务 → 添加 URL），粘贴下载直链。
- 支持 HTTP / HTTPS 直链。粘贴的是 网页链接 时，程序会先探测目标类型：是视频分享链接会进入解析流程（见第 4 节），是文件直链则直接进入新建对话框。
- 新建对话框中可设置：文件名（可改）、保存目录、连接数（默认 8 线程，最高 32）、自定义请求头。确认后立即入队。
批量任务
- 批量准备：工具栏「批量准备」可一次粘贴多条链接批量入队。
- 导入 / 导出：菜单 文件 里可把全部任务导出为 tasks.json 备份，换机或重装后再导入，进度和状态一并恢复。
把链接直接拖进主窗口，或使用浏览器扩展捕获（第 5 节），都可以快速建任务。
3. 任务管理
列表操作
- 右键单个任务：暂停 / 恢复 / 重新下载 / 打开文件 / 打开文件夹 / 校验文件 / 复制下载链接 / 删除。
- 勾选 + 批量栏：勾选多个任务后，顶部批量栏可批量暂停、恢复、删除；「全部开始」「全部暂停」「全部删除」按钮作用于全队列。
- 搜索与筛选：顶部搜索框按文件名 / URL 过滤；「全部状态」下拉按下载中 / 已完成 / 排队中等筛选；点击表头排序，表头边缘可拖拽调列宽。
校验文件
右键已完成任务 → 校验文件，选择 SHA-256 / SHA-1 / SHA-512 算法后自动计算哈希，与发布方公布的值比对，确认文件完整。设置里可开启「完成后自动校验」（见第 9 节）。
状态栏
底部状态栏实时显示：任务总数、活动数、已完成数与总速度；状态栏左侧是网络蜗牛动画，速度越快爬得越欢。
4. 视频解析（yt-dlp 引擎）
- 复制视频分享链接或整段分享文案，粘贴进「添加 URL」。
- 程序识别为视频链接后，自动打开 解析窗口（窗口带
yt-dlp徽章），列出可用的清晰度与格式。 - 选择想要的画质 / 格式 → 下载，视频直链自动入队，走同一个多线程引擎。
- 解析等待时窗口提示「yt-dlp 正在解析视频，探测格式与清晰度…」，解析失败时按提示安装 / 更新 yt-dlp 组件。
部分平台的页面链接存在访问限制，请使用 App 的「复制链接」得到的分享直链；如仍解析失败，可在设置 →「视频 Cookies」里选择浏览器（Chrome / Edge / Firefox）借用登录态后重试。
5. 浏览器嗅探扩展
安装（Chrome / Edge / Opera / 360 / QQ / 搜狗）
- 打开浏览器扩展管理页（地址栏输入
chrome://extensions类似入口），打开右上角 开发者模式。 - 点击 「加载已解压的扩展程序」，选择软件目录下的 resources\extension\ 里对应浏览器文件夹（Firefox 可直接导入自带
.xpi）。 - 也可以在 设置 → 浏览器扩展 里选择「扩展位置」与「目标浏览器」，一键安装 / 卸载，无需手动加载。
接管规则
- 扩展默认全类型接管：视频、音频、压缩包、程序、文档、模型、种子——浏览器里触发的下载自动转给 CF Download 的多线程引擎。
- 点扩展图标打开弹窗，可按类型开关接管、查看刚捕获到的媒体列表；嗅探到的视频可直接拉起解析。
- 捕获通过
cfdownload://协议回传：任务数据随协议一起带过去，即使软件没启动也会先拉起软件再入队，不丢任务。
6. GitHub 项目搜索
- 工具栏点 「GitHub」 打开搜索面板。不输关键词直接开窗就是热榜：项目 / AI / Skill 三个分类 × 本周 / 本月热度，各取 TOP 20。
- 关键词搜索：输入名称或描述回车；匿名搜索每分钟约 10 次，热榜有 10 分钟缓存不占额度。
- 按链接直达：直接粘贴
https://github.com/owner/repo（带/tree/分支、.git后缀都行），或输入owner/repo短格式，绕过搜索限速直达仓库卡片。 - 下载源码 ZIP：打包默认分支最新快照。
- Releases 文件：点开列出全部版本（默认折叠，点版本行展开资产列表），每个资产带大小与下载按钮。
- 按 SHA 下载：填 commit SHA（7–40 位）/ 标签 / 分支名，下载该快照的源码 zip；「取最新 SHA」一键填入 HEAD。三个按钮互斥展开，再点一次收起。
- 翻译为中文：一键把全部项目描述翻成中文。
GitHub 下载自动走「自有加速 → 镜像 → 直连」择优链路，坏源自动沉底、恢复后自动回归，大仓库也能跑满带宽。
7. AI 工具面板
- 工具栏点 「AI 工具」：内置 上百款 AI 工具目录（当前 173 款），按「推荐 / AI 助手（国内·海外）/ AI 智能体 / 编程编码 / 工作台…」分组展示，官方图标一目了然。
- 点卡片：内置窗口自动检测本机是否已安装该工具、当前版本与官方最新版差异。
- 一键安装：未安装或可升级时，直接拉取官方安装包，走同一下载引擎，完成后自动运行安装程序。
- 编辑布局：右上角「编辑」进入编辑模式，可拖动排序、新建自定义卡片、隐藏分组；布局保存在本机，升级后新增工具会自动补进对应分组。
- AI 智能体分组：收录 Manus / Devin / Claude Code / ZCode / AutoClaw / MiniMax Code / Agnes Code 等主流编程智能体的官方下载页。
8. 模型下载与 ComfyUI
模型搜索 / HuggingFace 直下
- 工具栏 「模型搜索」：搜索 HuggingFace 模型与数据集，浏览文件树后勾选下载。
- 大文件在官方源与国内镜像间双向自动回源：官方失联回落镜像，镜像失效切回官方，带冷却防抖；受限仓库秒级明确报错提示换源。
模型加载器
工具栏 「模型加载」：识别本机 Ollama / LM Studio / llama.cpp / vLLM 等本地推理引擎与已装模型，新模型直接推送到对应引擎目录。
ComfyUI 集成
- Comfy 下载：ComfyUI Desktop 安装包、按显卡划分的实例环境（Intel / NVIDIA / AMD 便携包）、源码包（zip / tar.gz，只有 tag 没有 release 资产的版本也能下）——按类型自动检测最新版本并归档。
- Comfy 模型：常用模型权重一键入队，可在设置里指定「ComfyUI models 根目录」，下载后自动放到位。
- 这两类任务右键菜单不提供「复制下载链接」——链接是镜像改写后的内部地址，复制出来无意义。
9. 下载引擎与设置
| 设置项 | 说明 |
|---|---|
| 默认线程数 | 单任务分片连接数，1–16，默认 16。 |
| 同时下载任务数 | 并行任务上限，超出自动排队。 |
| 默认下载目录 | 新建任务的默认保存位置。 |
| ComfyUI models 根目录 | Comfy 模型任务的自动归档位置。 |
| 开机自动启动 | 随 Windows 登录启动（可配合托盘常驻）。 |
| 自动下载更新 | 检测到新版本自动后台下载，提示一键安装。 |
| 浏览器扩展 | 扩展位置与目标浏览器，一键安装 / 卸载。 |
| 全局限速 | KB/s，0 为不限。 |
| 全部任务完成后 | 无动作 / 关机 / 睡眠 / 退出程序 / 运行外部程序（支持 %path% 占位符）。 |
| 完成后自动校验 | SHA-1 / SHA-256（推荐）/ SHA-512，下载完自动算哈希；关闭后可右键手动校验。 |
| 视频 Cookies | 借 Chrome / Edge / Firefox 登录态提升解析成功率（不配置时部分受限站点可能解析失败）。 |
| 文件类型过滤 | 排除的扩展名（如 exe, dll, tmp）捕获后不自动开始。 |
| 站点规则 | 每行一条：主机名 | 线程数 | 限速KB/s(0不限) | 自定义请求头，按主机定制下载行为。 |
引擎要点：最高 32 连接分片、实时断点续传（暂停 / 恢复不丢进度）、失败自动重试与镜像换源、任务计划（定时开始）、托盘最小化常驻。
10. 常见问题
启动时提示「程序文件已损坏」？
完整性自检发现文件被改动或损坏（常见于只替换了部分文件）。请使用官网完整安装包重新安装 / 覆盖，不要混用不同版本的 exe 与 resources 文件。
下载速度上不去？
依次检查：① 是否命中全局限速；② 单任务线程数是否为 16；③ 大文件任务是否被站点规则限速；④ GitHub 类任务观察右下角日志，命中镜像换源会自动择优重试。
视频解析一直失败？
① 确认粘贴的是分享直链而不是页面链接；② 设置里选择「视频 Cookies」浏览器后重试；③ 提示缺组件时按引导安装 / 更新 yt-dlp 组件。
浏览器下载没有接管？
① 扩展是否已在扩展管理页启用；② 扩展弹窗里对应类型是否被关掉；③ 软件是否在运行——扩展通过 cfdownload:// 协议拉起软件，如浏览器弹「打开 CF Download？」请选允许并勾选「始终」。
怎么检查更新？
菜单 帮助 → 检查更新（或「关于」窗口的检查更新按钮）。开启「自动下载更新」后新版本会自动下载并提示安装。
日志与数据在哪？
全部用户数据在 %APPDATA%\cfdownload\：tasks.json（任务）、license.json（授权）、capture-debug.log / ytdlp-debug.log（排障日志）。反馈问题时附上对应日志即可。