WINDOWS 10 · 11 / x64 · 自包含 .NET 8 · v1.0.0

把下载,做成一件确定的事

云梭下载器用 aria2 承担多连接分片,用自研 HTTP 引擎在缺少外部程序时兜底, 用 yt-dlp 与 ffmpeg 接管视频与 HLS / DASH 流。浏览器里看到的东西,点一下就进队列。

v1.0.0 安装包即将发布到 GitHub Releases,当前可从源码构建。

  • Windows 10 / 11 x64
  • 无需预装 .NET
  • 按当前用户安装,不弹 UAC
  • 三引擎自动切换

CAPABILITY / 能力

六件事,都落在实处

下载器的价值不在于按钮多,而在于每一个字节的去向都可预期。下面这六件事,是这个版本的全部重心。

多引擎分片

aria2 以独立进程 + JSON-RPC 承担主力,单文件最多 16 个连接。 没放 aria2c.exe 时,自研 HTTP 分片引擎按偏移并发写同一文件兜底,下载照常继续。

视频与流

yt-dlp 覆盖 1800+ 站点,做画质枚举与下载;m3u8 / mpd 并发拉取分片后由 ffmpeg 合并为 MP4。 网页里的内嵌播放器地址会自动还原成可解析的内容页。

浏览器联动

Chromium MV3 扩展用 webRequest、MAIN world 拦截 fetch/XHR、DOM 扫描三层并行嗅探, 一键把页面里的视频或播放列表投递进队列,并自动带上 Cookie 与 Referer。

磁力 · 种子 · 迅雷

magnet: 与 .torrent 交给 aria2 的 BT 内核;thunder:// 自动解码出真实地址再下载。 链接或种子文件都可以直接拖进窗口。

断点续传与智能线程

暂停后继续,程序关掉再打开也能接着下。线程数按文件大小与服务器是否支持分片在 1~16 之间自动推荐, 也可以全局固定,或只给某一个任务单独指定。

命令行 ysd

桌面程序之外还有 ysd.exe:add / probe / list / tools / update / extension / selftest。 selftest 会在本地起一个 HTTP 服务,把各引擎与插件协议跑一遍,全程不联网。

INTERFACE / 界面

Fluent 2 的克制,用在有用的地方

左导航五页:最近下载、新建任务、浏览器插件、设置、关于与开源致谢。 列表每行都显示下载时间与已用时长;所有设置改完即存,没有「保存」按钮。

云梭下载器「最近下载」页面:任务列表显示状态、进度、大小、速度、剩余时间、连接线程数与下载时间
最近下载 · 每行固定显示下载时间与已用时长
云梭下载器「新建任务」页面:链接输入框、保存位置、清晰度与下载线程选择
新建任务 · 线程数与清晰度可按任务单独指定
云梭下载器「浏览器插件」页面:本机服务状态、连接令牌与五步安装指引
浏览器插件 · 本机服务状态、连接令牌与安装指引
云梭下载器「设置」页面:下载位置、下载性能、下载行为、外观与运行等分组
设置 · 改动即时生效并自动保存

TELEMETRY / 实测

硬的部分,写在日志里

不靠形容词。下面是一次调用的形状,以及仓库里跑出来的数字。

  • HTTP 多连接分片、暂停续传与哈希一致
  • 插件 WebSocket 握手与令牌校验
  • HLS 并发分片后合并,ffprobe 校验时长
示例 · 命令与参数取自仓库实际实现
$ ysd add "https://example.com/big.iso" --dir D:\Downloads

[resolve]  generic/http
[engine]   aria2  --split=16 --max-connection-per-server=16
[engine]   fallback  http-shard  偏移并发写 + 边车状态
[bridge]   ws://127.0.0.1:16888/media  握手完成 · 令牌校验通过
[write]    D:\Downloads\big.iso
单任务连接数
1~16
按文件大小与服务器分片能力自动推荐,可固定,也可按任务指定
下载引擎
3
aria2 · 自研 HTTP 分片 · yt-dlp,按链接类型自动选择
插件嗅探层级
3
webRequest · MAIN world 拦截 fetch/XHR · DOM 扫描
离线自检项
80+
ysd selftest:本地起 HTTP 服务验证各引擎,全程不联网

INSTALL / 安装

装它不需要管理员

安装包按当前用户装进 %LOCALAPPDATA%\Programs,不写系统目录、不弹 UAC,卸载也干净。

发布状态

v1.0.0 的安装包正在准备发布到 GitHub Releases。按钮已经指向发布页, 发布后就是最新版安装包的入口;在那之前,可以按下面的命令从源码构建一份自包含版本。

从源码构建(需要 .NET 8 SDK;三个内核会由脚本自动下载)

dotnet build YunsuoDownloader.sln -c Release
powershell -ExecutionPolicy Bypass -File scripts\build.ps1 -SelfContained

系统要求

  • 系统 Windows 10 1809 及以上,或 Windows 11(64 位)
  • 运行时 无需预装 .NET,安装包自包含 .NET 8
  • 磁盘 约 500 MB,含 aria2 / yt-dlp / ffmpeg 三个内核
  • 权限 按当前用户安装,不需要管理员
  • 浏览器 插件需 Chromium 内核浏览器,以「加载已解压的扩展程序」方式安装

三步开始

  1. 01

    下载安装包

    从 GitHub Releases 取最新的 YunsuoDownloader-Setup 安装包。

  2. 02

    双击安装

    向导为简体中文,安装前会展示用户协议与安装前必读,一路下一步即可。

  3. 03

    走完四步引导

    欢迎与合规提示 → 下载位置 → 下载性能 → 浏览器插件。设置会被记住,以后不再出现。

FAQ / 常见问题

先看这几条

需要先安装 .NET 吗?

不需要。安装包是自包含的,自带 .NET 8 运行时,装完即可运行。

安装要管理员权限吗?

不需要。程序装在当前用户目录下,全程不弹 UAC。也可以直接用编译产物做绿色版运行,不写注册表。

设置和下载的文件存在哪?卸载会删掉吗?

设置与历史在 %APPDATA%\YunsuoDownloader, 默认下载目录是 %USERPROFILE%\Downloads\YunsuoDownloader。 卸载不会删除设置,也不会删除已下载的文件。

为什么有些视频站直接粘链接会失败?

快手没有对应的 yt-dlp 提取器,需要装浏览器插件在网页上嗅探后发送; 抖音与小红书要求登录态,在浏览器里正常登录过一次,插件会把 Cookie 带过来。 yt-dlp 的站点支持是社区日更的,遇到解析失败可以先换一份最新的 yt-dlp.exe。

加密的流能下吗?

带 #EXT-X-KEY 的加密流只会被标记出来; 密钥可以公开获取时仍能下载,真正的 DRM 保护内容会直接失败 —— 本程序不做任何破解。

支持 macOS 或 Linux 吗?

当前版本只支持 Windows:界面基于 WPF,登录态加密使用 Windows DPAPI。

怎么检查更新?

走 GitHub Releases:设置里可以开关启动时自动检查,发现新版本会提示并下载安装包。

好的下载器,不该让你盯着进度条。

云梭下载器 · 设计原则