Skip to content

About

Windows AList folder downloader that reconstructs directory trees and downloads files through aria2-next.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

AList Folder Downloader

Version Platform UI

AList Folder Downloader 是面向 Windows 的 AList 文件夹下载器。它读取 AList 的真实文件列表,先在本地重建“所选文件夹 / 子目录 / 文件”,再把每个文件作为独立任务交给 aria2-next;不会把目录打包下载。

AList Folder Downloader 主页

安装与运行

从 GitHub Release 下载并解压 AList-Folder-Downloader-1.0.3.7z,双击 start.bat 或 AListFolderDownloader.exe 即可。发布包已包含 Qt(含 Qt6Concurrent.dll)、MinGW 运行库、SQLite 驱动、OpenSSL 和 tools/aria2-next.exe,无需安装 Python、PyQt/PySide 或执行 setup。

系统要求:64 位 Windows 10 或 Windows 11。1.0.3 便携包使用 Qt 6.10.2 / MinGW 构建,请完整解压运行,勿与旧版 Qt DLL 混用。发布包不携带站点历史、密码或本地数据库。

主要功能

  • C++20 + Qt 6.8 Quick Controls 的 FluentWinUI3 风格界面,使用 Direct3D 11 渲染。
  • 左侧三横栏仪表板包含主页、文件、传输、设置四页;小窗口自动收为 48 px 图标栏。
  • “文件”页只负责 AList 连接、凭据和远程文件树,“传输”页只负责下载任务、进度与速度。
  • 支持 AList 网页链接、/d/ 链接、#/path 和 ?path=/path 路由。
  • 同时支持匿名 guest、账户密码登录、AList 目录密码和临时 2FA 验证码。
  • 当前层按需读取,展开文件夹时再加载子项;已加载目录可反复收起和展开,不会重复请求服务器。
  • 文件和文件夹均可右键使用默认目录下载,或通过 Windows 文件夹选择器指定本次路径。
  • 支持 Ctrl 点击切换多选、Shift 点击连续选择、Ctrl+Shift 追加范围选择;右键已选项目可批量下载,右键未选项目则只下载该项。
  • 下载目录保留所选父文件夹及其全部子目录,包括空目录,而不是把子项直接散落到目标目录。
  • 每次添加形成一个传输组;文件夹可展开查看每个文件的进度、当前/最小/最大/平均速度和耗时。
  • 每个传输组或文件明细均可右键暂停/恢复、停止或删除;顶部可统一暂停、停止和删除任务。
  • 超时等错误任务可通过右键或顶部“重试错误任务”重新下载;优先沿用已下载部分,服务端不支持续传时从头下载,已完成的文件不会重复添加。
  • 高、正常、低三级优先级;可调整 aria2-next 同时下载任务数。
  • 按小/中/大文件分别设置连接分片数。
  • 显示总进度、当前速度、会话最大速度和最近 30 秒平均速度。
  • 访问历史按站点 Origin 去重;主页双击最近访问项可直接连接。闲时索引递归保存每个目录和文件,计算各级文件夹累计大小,并在文件列表的大小列显示。
  • 用户触发的递归读取使用 8 路普通优先级并发;闲时默认延迟 2 秒启动,可在设置中调整,无前台操作时最多并发读取 12 个目录。索引可随时停止,并保留已经获取的文件、文件夹及累计大小。顶部右侧按名称顺序显示当前目录及已完成/已发现目录数。
  • 关闭窗口可选择首次询问、直接退出或最小化到系统托盘;托盘菜单持续显示当前下载速度。

快速开始

  1. 打开“文件”页,粘贴目标 AList 文件夹或文件链接。
  2. 公共站点使用 guest 并留空密码;受保护站点填写账户密码,必要时填写目录密码或 2FA。
  3. 点击“获取列表”。单击文件夹只加载该层内容。
  4. 单击选择文件,按 Ctrl 多选或 Shift 连选;右键所选文件或文件夹,选择默认目录下载或“选择自定义下载路径…”。
  5. 打开“传输”页调整优先级、展开文件夹任务并查看进度。

删除传输任务只移除队列记录并停止对应下载,不会删除已经写入磁盘的文件。

默认保存位置是 Windows 系统“下载”文件夹。用户修改后的默认目录、并发数和分片策略会自动记住。

安全与本地数据

  • 账户密码与目录密码先经 Windows DPAPI 设备级保护,再保存到本地 SQLite;复制数据库到另一台设备后无法解密。
  • 2FA 验证码只用于当前登录,不写入历史。
  • 使用过 2FA 或服务端提示需要 OTP 的历史站点不参与后台索引,重启后仍有效;手动浏览和下载照常使用。旧历史首次遇到 OTP 提示后会自动标记,其他索引失败在本次运行中也不会连续重试。
  • 数据库位于当前用户的 %LOCALAPPDATA%/ARXChem/AList Folder Downloader/alist-index.sqlite。
  • 软件仅调用 AList 读取接口,不执行远程写入、删除或管理员操作。
  • Windows 非法文件名会明确报错,不会静默改名或写出目标目录。

从源码构建

需要 Visual Studio 的 MSVC x64 工具链、CMake 3.24+、Ninja,以及 Qt 6.8 的 Core、Gui、Qml、Quick、QuickControls2、Network、Sql、Concurrent 和 Test 模块。

cmake -S . -B build-release -G Ninja `
  -DCMAKE_BUILD_TYPE=Release `
  -DCMAKE_PREFIX_PATH=C:\Qt\6.8.3\msvc2022_64
cmake --build build-release --parallel
ctest --test-dir build-release --output-on-failure

AListProbe 是手动 AList 连通性诊断程序;它不进入发布包。

常见问题

为什么读取大型资源库很快,但下载文件夹前仍需等待? 首屏只读取当前层;只有用户决定下载文件夹时才递归收集其内容并建立完整下载计划。

闲时索引的进度为什么不是固定百分比? 目录总数只有递归过程中才能逐步发现,因此顶部显示“当前目录(已完成/已发现)”。目录按名称排序处理,可以直接看出当前索引位置;分母会随新目录出现而增加。

下载文件夹会生成压缩包吗? 不会。每个文件都是独立 aria2-next 任务,本地路径由远程相对路径逐级重建。

为什么另一台电脑读不到历史密码? 这是 DPAPI 的预期保护;请在新设备重新输入并保存凭据。

公网测试链接无法连接怎么办? 先确认系统代理、TLS/证书和站点本身可用。发布版优先使用随包 OpenSSL,并保留 Windows Schannel 作为回退。

第三方组件及许可入口见 THIRD_PARTY_NOTICES.md,界面改动必须遵守 UI_RULES.md,内部设计与维护说明见 PROJECT.md,版本变化见 CHANGELOG.md。

About

Windows AList folder downloader that reconstructs directory trees and downloads files through aria2-next.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages