FluxDown: vanhemmat versiot ja versiohistoria

📦 下载与安装说明（服务器 / CLI / Android）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.6.3-windows-{x64,arm64}.zip
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.6.3-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用） │FluxDown-Server-0.6.3-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由 24.10 及更早（opkg，x86_64 / aarch64 各子架构）│fluxdown-server_0.6.3_<arch>.ipk +
│luci-app-fluxdown_0.6.3_all.ipk
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由 25.12 起（apk，x86_64 / aarch64 各子架构） │fluxdown-server_0.6.3_<arch>.apk +
│luci-app-fluxdown_0.6.3_all.apk
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.6.3-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.6.3-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
飞牛 fnOS NAS（x86 / ARM） │FluxDown-Server-0.6.3-fnos-{x64,arm64}.fpk
──────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：24.10 及更早用 opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk；25.12 起用 apk add --allow-untrusted fluxdown-server_*.apk luci-app-fluxdown_*.apk（包未用 OpenWrt 官方密钥签名）。<arch> 取路由器 /etc/apk/arch（或 opkg print-architecture）中的架构名。LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
飞牛 fnOS：应用中心 → 手动安装 .fpk；x86 机型选 x64，ARM 机型选 arm64。以专用应用用户 fluxdown 运行，默认保存到安装时创建的 fluxdown 共享文件夹，其他目录在应用设置「授权目录」中添加。装完点桌面图标直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.6.3
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.6.3
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.6.3-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.6.3-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.6.3-linux-{x64,arm64}.tar.gz
────────────

📦 下载与安装说明（服务器 / CLI / Android）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.6.2-windows-{x64,arm64}.zip
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.6.2-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用） │FluxDown-Server-0.6.2-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由 24.10 及更早（opkg，x86_64 / aarch64 各子架构）│fluxdown-server_0.6.2_<arch>.ipk +
│luci-app-fluxdown_0.6.2_all.ipk
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由 25.12 起（apk，x86_64 / aarch64 各子架构） │fluxdown-server_0.6.2_<arch>.apk +
│luci-app-fluxdown_0.6.2_all.apk
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.6.2-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.6.2-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
飞牛 fnOS NAS（x86 / ARM） │FluxDown-Server-0.6.2-fnos-{x64,arm64}.fpk
──────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：24.10 及更早用 opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk；25.12 起用 apk add --allow-untrusted fluxdown-server_*.apk luci-app-fluxdown_*.apk（包未用 OpenWrt 官方密钥签名）。<arch> 取路由器 /etc/apk/arch（或 opkg print-architecture）中的架构名。LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
飞牛 fnOS：应用中心 → 手动安装 .fpk；x86 机型选 x64，ARM 机型选 arm64。以专用应用用户 fluxdown 运行，默认保存到安装时创建的 fluxdown 共享文件夹，其他目录在应用设置「授权目录」中添加。装完点桌面图标直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.6.2
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.6.2
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.6.2-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.6.2-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.6.2-linux-{x64,arm64}.tar.gz
────────────

📦 下载与安装说明（服务器 / CLI / Android）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.6.1-windows-{x64,arm64}.zip
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.6.1-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用） │FluxDown-Server-0.6.1-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由 24.10 及更早（opkg，x86_64 / aarch64 各子架构）│fluxdown-server_0.6.1_<arch>.ipk +
│luci-app-fluxdown_0.6.1_all.ipk
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由 25.12 起（apk，x86_64 / aarch64 各子架构） │fluxdown-server_0.6.1_<arch>.apk +
│luci-app-fluxdown_0.6.1_all.apk
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.6.1-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.6.1-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
飞牛 fnOS NAS（x86 / ARM） │FluxDown-Server-0.6.1-fnos-{x64,arm64}.fpk
──────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：24.10 及更早用 opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk；25.12 起用 apk add --allow-untrusted fluxdown-server_*.apk luci-app-fluxdown_*.apk（包未用 OpenWrt 官方密钥签名）。<arch> 取路由器 /etc/apk/arch（或 opkg print-architecture）中的架构名。LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
飞牛 fnOS：应用中心 → 手动安装 .fpk；x86 机型选 x64，ARM 机型选 arm64。以专用应用用户 fluxdown 运行，默认保存到安装时创建的 fluxdown 共享文件夹，其他目录在应用设置「授权目录」中添加。装完点桌面图标直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.6.1
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.6.1
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.6.1-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.6.1-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.6.1-linux-{x64,arm64}.tar.gz
────────────

[0.6.0] - 2026-10-22
🚀 Features
- (website) 主域名切换到 fluxdown.com
- 客户端官网链接与默认服务端点改用 fluxdown.com
- (android) 本机保存目录改用应用内目录浏览器
- (website) 大陆访客下载分流到阿里云 CDN 并为下载链接签名
- (website) 官网静态页面走 Cloudflare 边缘缓存,部署后按主机名清除
- (website) 官网与下载迁到阿里云 CDN，国际下载直跳 GitHub
- (website) CDN 下载只发给读过发布清单的非脚本大陆访客
- (website) 同一 IP 15 分钟内超过 20 次下载封禁 12 小时
- (website) 手动接入 Cloudflare Web Analytics
- (plugin) 开发模式插件的 flux.fetch 允许访问非公网地址
- (plugin) 插件包替换后桌面端重新挂载脚本视图
- (plugin) 拦截补丁支持 maxRangeBytes 限制 Range 跨度
- (app) Windows / Linux 标题栏应用菜单栏改为可选显示
- (plugin-sdk) 支持页面脚本 pageScripts 并发布 0.2.0
- (plugin) 支持插件页面脚本 pageScripts
- (downloads) 保存目录支持最近路径历史下拉
- (web) 新建下载保存目录支持最近路径历史下拉
- (downloads) 对齐 qBittorrent 做种交互并支持任务组文件夹行
- (android) 外部唤起下载按分类预填保存目录
- (plugin) 插件视图支持自定义活动栏图标
- (plugin-sdk) 校验视图 icon 并发布 0.3.0
- (plugin-sdk) 统一包准入与审核摘要并发布 0.4.0
- (extensions) 插件市场支持收藏与排序
- (link) 配对即授权远程控制并支持设备控制凭据
- (account) GPUI 配对弹窗支持请求完全控制
- (web) 配对弹窗支持请求完全控制
- (android) 添加主机支持局域网配对
- (ios) 添加主机支持局域网配对
- (settings) 设置行说明限制单行并收进信息图标
🐛 Bug Fixes
- (web) 修复 server 模式直连配对误报局域网未开启
- (website) Deploy.sh 拉取后重新执行自身,避免执行新旧拼接的脚本
- (extension) 修复 Firefox 注入页面钩子卡死导致视频浮钮不显示
- (agent) 默认端口不可用时回退系统端口并发布端点
- (gpui) 桌面连接 agent 加超时并展示拉起失败原因
- (protocol) 放宽客户端 WebSocket 帧与消息上限
- (account) 当前与不可选套餐不再套用抵扣额
- (engine) 优先下载只接受未结束任务并兜底结束 Boost
- (website) Download-route 测试的 geoip mock 保留真实导出，修复测试顺序相关的 CI 失败
- (daemon) 端点发布测试等待文件出现而非仅等端口监听
- (plugin-sdk) 补充 repository 字段以通过 npm provenance 校验
- (app) 进度窗口按主窗口与选择请求状态判定弹出
- (downloads) 批量继续跳过已完成任务，避免重新下载
- (extension) 修复内嵌 PDF 无法被嗅探收录
- (android) 修复无文件选择器与存储卡文件打开时崩溃
- (agent) MacOS 托盘右键改为主线程弹出菜单
💼 Other
- 升级 gpui-kit 至 0.8 与 gpui-fast 对应快照
🚜 Refactor
- (agent) 移除更新端点的 with_base 包装
- (theme) 主题导出的 $schema 改用 fluxdown.com
- (android) 导航坞改为常驻的图标在上标签在下样式
- (components) 抽取统一的 tooltip_view 并替换各处 Tooltip
📚 Documentation
- 文档、打包元数据与仓库模板改用 fluxdown.com
- (ops) 下载分发说明对齐准入规则
- 记录本机端口回退与端点发现规则
- 登记保存目录历史的 GPUI 与 Web 镜像契约
- (release) 补充旧版升级时可能出现的安装失败提示
⚡ Performance
- [breaking] 优化大任务量下的导入、事件同步与界面刷新
🧪 Testing
- (downloads) 复现 #935 批量继续会重下已完成任务
- (android) 同步移除导航坞迷你态的测试断言

📦 下载与安装说明（服务器 / CLI / Android）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.5.9-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.5.9-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-Server-0.5.9-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由（x86_64 / aarch64 各子架构） │fluxdown-server_0.5.9_<arch>.ipk +
│luci-app-fluxdown_0.5.9_all.ipk
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.5.9-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.5.9-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
飞牛 fnOS NAS（x86 / ARM） │FluxDown-Server-0.5.9-fnos-{x64,arm64}.fpk
──────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
飞牛 fnOS：应用中心 → 手动安装 .fpk；x86 机型选 x64，ARM 机型选 arm64。以专用应用用户 fluxdown 运行，默认保存到安装时创建的 fluxdown 共享文件夹，其他目录在应用设置「授权目录」中添加。装完点桌面图标直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.5.9
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.5.9
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.5.9-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.5.9-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.5.9-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┴───────────────────────────────────────────
解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用；也可从源码安装：
cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli。
fluxdown ping # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls
服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），管理 token 经 --token 或 FLUXDOWN_TOKEN。
📱 Android
─────────────────────────────┬──────────────────────────────────────
设备 │资产
─────────────────────────────┼────────────────

📦 下载与安装说明（服务器 / CLI / Android）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.5.7-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.5.7-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-Server-0.5.7-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由（x86_64 / aarch64 各子架构） │fluxdown-server_0.5.7_<arch>.ipk +
│luci-app-fluxdown_0.5.7_all.ipk
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.5.7-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.5.7-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.5.7
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.5.7
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.5.7-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.5.7-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.5.7-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┴───────────────────────────────────────────
解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用；也可从源码安装：
cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli。
fluxdown ping # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls
服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），管理 token 经 --token 或 FLUXDOWN_TOKEN。
📱 Android
─────────────────────────────┬──────────────────────────────────────
设备 │资产
─────────────────────────────┼──────────────────────────────────────
不确定架构（通用包） │FluxDown-0.5.7-android-universal.apk
─────────────────────────────┼──────────────────────────────────────
64 位 ARM（绝大多数手机） │FluxDown-0.5.7-android-arm64-v8a.apk
─────────────────────────────┼──────────────────────────────────────
32 位 ARM │FluxDown-0.5.7-android-armeabi-v7a.apk
───────────────

📦 下载与安装说明（服务器 / CLI / Android）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.5.6-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.5.6-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-Server-0.5.6-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由（x86_64 / aarch64 各子架构） │fluxdown-server_0.5.6_<arch>.ipk +
│luci-app-fluxdown_0.5.6_all.ipk
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.5.6-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.5.6-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.5.6
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.5.6
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.5.6-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.5.6-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.5.6-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┴───────────────────────────────────────────
解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用；也可从源码安装：
cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli。
fluxdown ping # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls
服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），管理 token 经 --token 或 FLUXDOWN_TOKEN。
📱 Android
─────────────────────────────┬──────────────────────────────────────
设备 │资产
─────────────────────────────┼──────────────────────────────────────
不确定架构（通用包） │FluxDown-0.5.6-android-universal.apk
─────────────────────────────┼──────────────────────────────────────
64 位 ARM（绝大多数手机） │FluxDown-0.5.6-android-arm64-v8a.apk
─────────────────────────────┼──────────────────────────────────────
32 位 ARM │FluxDown-0.5.6-android-armeabi-v7a.apk
───────────────

📦 下载与安装说明（服务器 / CLI）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.5.5-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.5.5-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-Server-0.5.5-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由（x86_64 / aarch64 各子架构） │fluxdown-server_0.5.5_<arch>.ipk +
│luci-app-fluxdown_0.5.5_all.ipk
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.5.5-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.5.5-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.5.5
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.5.5
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.5.5-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.5.5-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.5.5-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┴───────────────────────────────────────────
解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用；也可从源码安装：
cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli。
fluxdown ping # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls
服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），管理 token 经 --token 或 FLUXDOWN_TOKEN。
0.5.5 - 2026-10-09
🚀 新功能
- 新增「启用 BitTorrent」总开关：关闭后不再监听 BT 端口、不建立 peer 连接；此时新建或恢复 BT 任务会明确提示原因，排队中的 BT 任务会被暂停而不是报错失败。桌面、Web、Android、iOS 设置页均可设置，并随云同步
- 新增应用内更新：关于页与顶栏/菜单可查看更新状态，支持下载、安装与取消（桌面与 Web 控制台）
- 「文件已存在」处理新增「询问」选项：遇到同名文件时弹出冲突窗口让你逐个选择处理方式（桌面、Web、Android、iOS）
- 新增可切换的文件图标包，内置 Lucide / Material / Catppuccin 三套，可在外观设置中选择，并随云同步
- 下载列表的「宽松」密度视图将大小、进度、速度、剩余时间与元信息并入主列，桌面与 Web 显示一致
- 桌面活动栏改为显示账户头像（含会员徽标），点击进入账户设置；明暗主题切换仍可在命令面板中使用
- 桌面侧栏导航加入滑动高亮与颜色过渡动效，系统开启「减弱动态效果」时自动关闭

📦 下载与安装说明（服务器 / CLI）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.5.4-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.5.4-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-Server-0.5.4-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由（x86_64 / aarch64 各子架构） │fluxdown-server_0.5.4_<arch>.ipk +
│luci-app-fluxdown_0.5.4_all.ipk
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.5.4-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.5.4-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.5.4
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.5.4
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.5.4-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.5.4-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.5.4-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┴───────────────────────────────────────────
解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用；也可从源码安装：
cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli。
fluxdown ping # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls
服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），管理 token 经 --token 或 FLUXDOWN_TOKEN。
0.5.4 - 2026-10-06
🚀 新功能
- 桌面客户端支持调整界面字体大小（10~24 px），设置页「外观」中可选择，也可选「跟随主题」；与界面缩放叠加生效，文字不会被裁切
- 账户新增密码管理：可修改密码、设置密码（通过当前密码或邮箱验证码验证），登录框内提供「忘记密码」重置流程，安全页面新增对应入口；验证码发送后重开对话框会继续倒计时
- 自定义主题库现在随账户同步，在多台设备间共享；旧版本地主题文件会自动迁移
- Web 控制台：当服务器与浏览器在同一台机器上（本机回环访问）时，任务右键菜单提供「打开文件」「打开所在文件夹」，进行中的任务也可打开所在文件夹；远程或经反向代理访问时不会出现该菜单。如需在服务器模式下显式放行，可设置 FLUXDOWN_ALLOW_LOCAL_PLATFORM
- yt-dlp 插件升级：优先选择 H.264，下载后检测实际文件编码，对 AV1/VP9/HEVC 等系统播放器（如 QuickTime）无法解码的视频自动转码为 H.264/AAC/MP4（受 preferMp4 开关控

📦 下载与安装说明（服务器 / CLI）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.5.3-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.5.3-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-Server-0.5.3-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由（x86_64 / aarch64 各子架构） │fluxdown-server_0.5.3_<arch>.ipk +
│luci-app-fluxdown_0.5.3_all.ipk
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.5.3-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.5.3-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.5.3
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.5.3
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.5.3-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.5.3-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.5.3-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┴───────────────────────────────────────────
解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用；也可从源码安装：
cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli。
fluxdown ping # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls
服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），管理 token 经 --token 或 FLUXDOWN_TOKEN。
0.5.3 - 2026-10-03
⚠️ 注意事项
- 本机通信协议升级到 v7：桌面客户端、agent 与 daemon 必须同步更新并一起重启，请勿混用新旧版本。
🚀 新功能
- 账户支持编辑个人资料与邮箱。
- 设备在线状态与云连接恢复更可靠：断线重连前会先处理已收到的控制命令，切换账号时不会再被旧账号的响应干扰，桌面端与 Web 对连接状态、未知设备状态和手动重试的表现保持一致。
- 桌面端支持热切换 API 服务端口：新端口验证通过并保存成功后才会替换旧服务，桌面客户端与局域网发现会自动使用新端口；设置页可一键复制并注入当前端口与访问令牌的油猴脚本。
- 下载进度窗口可调整大小，并会记住窗口尺寸与位置，不再随内容自动缩放；完成窗口的展示改为读取全局偏好。
- 下载列表新增「宽松」行密度（共三档，桌面端与 Web 均可持久化），行高更大、双行内容间距更舒展，悬浮与选中背景样式也更统一。
- 支持清理选中范围内的无效任务。
- 可从系统托盘直接打开设置窗口。
- 桌面端完善字体设置、系统通知与多平台兼容性。
- 浏览器扩

📦 下载与安装说明（服务器 / CLI）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.5.2-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.5.2-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-Server-0.5.2-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由（x86_64 / aarch64 各子架构） │fluxdown-server_0.5.2_<arch>.ipk +
│luci-app-fluxdown_0.5.2_all.ipk
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.5.2-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.5.2-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.5.2
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.5.2
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.5.2-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.5.2-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.5.2-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┴───────────────────────────────────────────
解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用；也可从源码安装：
cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli。
fluxdown ping # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls
服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），管理 token 经 --token 或 FLUXDOWN_TOKEN。
[0.5.2] - 2026-10-01
🚀 Features
- (doctor) 支持动态权限诊断与显式修复
- (downloads) 支持插件清单预览与批量建组
- (sidebar) 统一侧栏收起与调宽行为
- (settings) 按系统语言显示更新说明
- (downloads) 支持在状态栏切换代理模式
🐛 Bug Fixes
- (gpui) 统一关于入口与设置定位
- (rust) 强制处理错误并启用禁止忽错门禁
- (build) 用轻量启动器兼容旧版 Windows 便携升级
- (engine) 修复插件市场代理配置与下载诊断
- (gpui) 修复插件登录二维码并同步 Web 展示
- (rust) 修复 Rust 1.99 的 Clippy 兼容性
- (engine) 修复慢代理尾段抢占延迟

📦 下载与安装说明（服务器 / CLI）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.5.1-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.5.1-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-Server-0.5.1-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由（x86_64 / aarch64 各子架构） │fluxdown-server_0.5.1_<arch>.ipk +
│luci-app-fluxdown_0.5.1_all.ipk
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.5.1-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.5.1-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.5.1
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.5.1
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.5.1-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.5.1-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.5.1-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┴───────────────────────────────────────────
解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用；也可从源码安装：
cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli。
fluxdown ping # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls
服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），管理 token 经 --token 或 FLUXDOWN_TOKEN。
0.5.1 - 2026-10-01
🚀 新功能
- Webhook 端点配置更健壮：配置中格式有误的条目会被跳过或回退为默认值，不再影响其他端点；桌面端与 Web 控制台同时编辑端点时会基于最新内容合并，不会覆盖他人的修改
- Webhook 的任务创建 / 开始事件现在会根据来源链接推断临时文件名；投递日志按记录合并，并在重启后保留
- 下载进度窗口改为固定尺寸，宽度随内容自适应且只增不减，避免窗口来回抖动；Windows / Linux 上标题栏仅保留最小化与关闭按钮
🐛 问题修复
- 修复桌面端任务列表右键菜单按旧选区弹出的问题（无选中时不弹出，或作用于上一次选中的任务）
- 修复在简体中文等非 UTF-8 系统上，因 whoami 输出编码导致获取用户 SID 失败的问题
- 修复极慢连接（如约 2 KiB/s）长期占着最后一小段数据、导致下载尾部迟迟无法完成的问题
- 桌面端界面字体改用系统默认字体，修复 Windows 上同一行文字字号、粗细不一致的问题
0.5.1 - 2026-10-01
🚀 Feature

📦 下载与安装说明（服务器 / CLI）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
──────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-Server-0.5.0-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-Server-0.5.0-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-Server-0.5.0-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
OpenWrt 软路由（x86_64 / aarch64 各子架构） │fluxdown-server_0.5.0_<arch>.ipk +
│luci-app-fluxdown_0.5.0_all.ipk
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
QNAP NAS（QTS x86_64 / ARM64） │FluxDown-Server-0.5.0-qnap-{x64,arm64}.qpkg
──────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） │FluxDown-Server-0.5.0-synology-{dsm7,dsm6}-{x64,arm64}.spk
──────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────
解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。
OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。agent 二进制含完整 Web UI，另附 fluxdownd，需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。
🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）
docker pull ghcr.io/zerx-lab/fluxdown-server:0.5.0
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.5.0
Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
──────────────────────────────────────────────────┬───────────────────────────────────────────
平台 │资产
──────────────────────────────────────────────────┼───────────────────────────────────────────
Windows x64 / ARM64 │FluxDown-CLI-0.5.0-windows-{x64,arm64}.zip
──────────────────────────────────────────────────┼───────────────────────────────────────────
macOS Intel / Apple Silicon │FluxDown-CLI-0.5.0-macos-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┼───────────────────────────────────────────
Linux x64 / ARM64（musl 静态链接，任意发行版可用）│FluxDown-CLI-0.5.0-linux-{x64,arm64}.tar.gz
──────────────────────────────────────────────────┴───────────────────────────────────────────
解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用；也可从源码安装：
cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli。
fluxdown ping # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls
服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），管理 token 经 --token 或 FLUXDOWN_TOKEN。
0.5.0 - 2026-09-30
⚠️ 注意事项
- 桌面端现在发布全新的 GPUI 客户端：Windows 安装器沿用原 AppId 覆盖升级 Flutter 版，并把 .torrent 关联与 fluxdown/ed2k/magnet 协议改指向新客户端；Windows 安装包改为仅每用户安装，检测到旧的「所有用户」安装时会提权一次运行其卸载器；Windows 产物暂不签名
- 局域网配对协议升级为 v2，与旧版对端不兼容，需两端同时升级
- 站点保存的凭据现在按 scheme://host[:port] 区分，升级后已保存的站点凭据需重新输入一次
- 开启局域网或 CORS 且启用接管/aria2 接口时会自动生成访问密钥，局域网内的 aria2 客户端需配置一次该密钥；headless 服务器首次设置完成前不再对外开放接口
- 浏览器扩展的原生消息中继需与本版 agent 一同升级，否则扩展可能显示「未连接」
- 浏览器扩展的远程验证状态与地址、密钥绑定，修改后需重新验证
- 已安装 deb 预发布（-rc）版本的用户

v0.4.8 - 2026-09-20
🚀 新功能
- 桌面客户端（Windows / macOS / Linux）全新多窗口体系：新增队列管理、快捷抓取、任务详情、分组详情、多选等独立窗口，并加入系统托盘图标、原生菜单、剪贴板监控自动建任务、单实例启动与外部唤起
- macOS 端补充原生窗口与菜单操作：新增 Hide/Show All/Window 等菜单项及 ⌘W/⌘M/⌘H/⌥⌘H/⌃⌘F 快捷键；关闭窗口时若有任务正在下载会弹出确认提示，且不会因反复按 ⌘W/⌘Q 而重复弹窗
- 新增插件通用登录认证能力：支持 Cookie、Basic、Bearer、Headers 等认证方式，登录态自动注入并在过期时提示重新登录；Web、Flutter 与桌面端（GPUI）均提供登录界面，支持二维码扫码登录、状态恢复与注销
- RSS 订阅支持插件来源：除内置 RSS 外，可通过安装插件扩展订阅来源，插件返回的订阅条目可直接解析并创建下载任务
- 浏览器扩展媒体嗅探全面升级：自动解析 DASH 播放清单，将同一视频按画质（含60帧标注）聚合为可读候选并生成可读文件名，音视频轨保留标签页上下文、Cookie、请求头、Referer 与文件大小，支持批量下载；新增嗅探/聚合调试日志导出，便于反馈问题
- 浏览器扩展：拦截模式下对网页本地生成、无法被接管的 blob:/data: 资源新增提示；修复 fxplug 插件安装问题
- 桌面端视觉密度优化：统一输入框、下拉框、按钮的高度与正文字号，下载/扩展/RSS 页面视觉更紧凑一致；设置页改为「分类导航 + 子 Tab + 分组卡片」布局，与移动端分类顺序保持一致，分类目录管理迁移至下载页侧栏
- 下载任务列表支持自然排序：任务名称与分组成员路径中的数字按数值大小排序
🐛 问题修复
- 修复中文（含繁体）文件名下载后出现乱码的问题
- 修复保存目录不存在时下载失败并提示 Windows 系统错误 (3) 的问题：HTTP/DASH/HLS/FTP/ED2K/BT 各类下载现会在写入前自动创建目标目录
- 修复插件登录流程的多处问题：验证码/二维码挑战渲染异常、注销后状态未重置、轮询失败无提示且不停止、切换站点未释放登录会话等
- 修复插件登录凭据的安全问题：https 站点登录态不再被同域 http 请求误用；卸载、禁用、安装失败回滚等场景下的凭据清理逻辑已修正，避免凭据误删或残留
- 修复浏览器扩展媒体聚合问题：批量下载丢失音轨、DASH 候选去重及序号显示错误、多码率视频未正确合并等
- 修复网页复制文本时会带上资源下载浮层文字的问题
- 修复切换界面语言后下载页搜索框占位文字未同步更新的问题
- 敏感配置（如插件与站点登录凭据）禁止通过通用配置接口写入，避免误操作导致凭据被覆盖
v0.4.8 - 2026-09-20
🚀 Features
- Brand-new multi-window architecture for the desktop client (Windows / macOS / Linux): dedicated windows for queue management, quick capture, task details, group details, and multi-select, plus a system tray icon, native menus, clipboard-watch auto task creation, and single-instance launch/external activation
- Native macOS window and menu actions: added Hide/Show All/Window menu entries and ⌘W/⌘M/⌘H/⌥⌘H/⌃⌘F shortcuts; closing a window with active downloads now shows a confirmation prompt that no longer stacks when ⌘W/⌘Q is pressed repeatedly
- New plugin login/authentication support: Cookie, Basic, Bearer, and Headers auth methods with automatic credential injection and expiry prompts; login UI is now available on Web, Flutter, and the desktop (GPUI) client, including QR-code login, session restore, and logout
- RSS subscriptions now support plugin-provided sources: besides the built-in RSS source, installed plugins can supply subscription sources whose entries are resolved directly into download tasks
- Overhauled media sniffing/aggregation in the browser extension: DASH manifests are parsed automatically and grouped into readable, per-quality candidates (with 60fps distinguished) with generated filenames; audio/video tracks keep tab context, cookies, headers, Referer, and file size, and support batch download; added a debug log export for sniffing/aggregation to help with bug reports
- Browser extension: added a notice when a page-generated blob:/data: resource can't be taken over in interception mode; fixed fxplug plugin installation
- Desktop UI density polish: unified input/dropdown/button heights and body font size for a more consistent look across the Downloads/Extensions/RSS pages; the Settings page was redesigned with a category navigation + sub-tabs + grouped cards layout matching the mobile app's category order, with category management now living in the Downloads page sidebar
- Download task lists now sort naturally: numeric segments in task names and group member paths are compared by value instead of as plain text
🐛 Bug Fixes
- Fixed garbled Chinese (including Traditional Chinese) filenames after download
- Fixed downloads failing with a Windows error (3) when the save directory doesn't exist: HTTP/DASH/HLS/FTP/ED2K/BT downloads now create the target directory automatically before writing
- Fixed several issues in the plugin login flow: broken QR-code/challenge rendering, stale state after logout, silent/never-stopping polling failures, and sessions not released when switching sites
- Fixed security issues in plugin login credential handling: an HTTPS site's login state is no longer applied to same-host HTTP requests; credential cleanup on uninstall, disable, and failed install rollback has been corrected to prevent 

[0.4.7] - 2026-08-16
🐛 Bug Fixes
- (installer) Windows 包随附 MSVC CRT 运行库
- (nmh) 裸运行与 --help/--version 立即退出
- (cloud) 保留下架套餐的展示快照

[0.4.6] - 2026-08-14
🚀 新功能
- 推介说明页现在会先展示上次浏览时缓存的总览数据，再在后台静默刷新，不用每次打开都等待加载
- 文件名在探测 / BT 元数据取回之前，改为显示来源 URL 作为占位，方便区分任务；过长的链接（尤其是 magnet 链接）会截断显示
🐛 问题修复
- 修复删除一个尚未开始下载的任务时，可能误删同链接此前已下载完成的同名文件的问题
- 修复 Windows 系统在高分屏（缩放 ≥125%）下任务栏图标有时不刷新的问题
[0.4.6] - 2026-08-14
🚀 Features
- The referral info page now shows the previously cached summary instantly on open, then refreshes it silently in the background, instead of showing a loading spinner every time
- Before a file name is confirmed (i.e. before probing or BT metadata arrives), the task now shows its source URL as a placeholder instead of being blank; very long links (especially magnet links) are truncated for display
🐛 Bug Fixes
- Fixed an issue where deleting a task that hadn't started downloading could accidentally delete an already-completed file of the same name from an earlier download of the same link
- Fixed the Windows taskbar icon sometimes failing to update on high-DPI displays (≥125% scaling)

[0.4.5] - 2026-08-14
🐛 问题修复
- 修复部分环境下（旧卸载程序被标记为只读、ACL 权限受限）覆盖升级安装时报 "access denied" 失败的问题；此类环境下现在可以手动选择以管理员身份安装，静默自动更新仍按最低权限执行，不受影响
- 修复应用内更新弹窗把中英文更新日志混排显示的问题，现在会按当前界面语言只显示对应语言的内容
- 修复部分 Windows 系统上任务栏的资源管理器等固定图标被错误替换成 FluxDown 图标的问题，并会在启动时自动检测、修复此前已被影响的固定图标
[0.4.5] - 2026-08-14
🐛 Bug Fixes
- Fixed an "access denied" failure during upgrade installs in certain environments (a read-only leftover uninstaller, or restricted ACL permissions); you can now choose to install as administrator in these cases, while silent auto-updates continue to run with the lowest privileges as before
- Fixed the in-app update dialog showing the Chinese and English changelog mixed together; it now shows only the content matching your current interface language
- Fixed an issue on some Windows systems where pinned taskbar icons (e.g. File Explorer) could be incorrectly overwritten with the FluxDown icon; the app now also detects and repairs any pinned icons affected by this on startup

[0.4.4] - 2026-08-14
🚀 新功能
- 下载列表支持批量选择：Ctrl/Cmd+点击勾选单个任务、Shift+点击选中区间、鼠标拖动框选批量任务，拖动到列表边缘会自动滚动
- 设置页新增「推介有奖」入口，登录后可查看收益总览、管理推荐码、查询返利台账；活动说明由云端远程配置，支持 Markdown 富文本并实时更新
- 会员套餐徽标现在会缓存到本地，启动应用即可立刻看到上次的套餐标识，不再先显示默认样式再刷新
- 注册页密码输入框新增明文切换按钮，方便核对输入
- 点击搜索结果可直接跳转并高亮定位到对应任务，列表会自动展开分组并滚动到屏幕居中位置
- 购买套餐因参与推介活动被排除时，会显示明确的提示文案
🐛 问题修复
- 修复 Webhook 通知预设（如 Server酱³）在消息中包含 URL 或空格时被错误编码为 %2F、+ 等符号的问题，通知预设已统一改用 JSON 请求体发送
- 修复深色主题下「回到顶部」按钮背景为白色、观感刺眼的问题，现在跟随主题配色
- 修复搜索框获得焦点时按 Cmd+A 会全选任务列表而非选中输入内容的问题
[0.4.4] - 2026-08-14
🚀 Features
- Batch selection in the download list: Ctrl/Cmd+click to toggle a single task, Shift+click to select a range, and click-and-drag to box-select multiple tasks, with auto-scroll when dragging near the list edges
- A new "Referral Rewards" entry in Settings (visible after sign-in) showing earnings overview, referral code management, and rebate history; the campaign description is fetched from the cloud and supports Markdown, always showing the latest content
- Membership plan badges are now cached locally, so they render instantly on cold start instead of briefly showing a default placeholder before refreshing
- Added a show/hide toggle for the password field on the sign-up screen
- Clicking a search result now jumps straight to the matching task, auto-expanding its group and scrolling it to the center of the list
- A clear message is now shown when a plan purchase is excluded from an active referral promotion
🐛 Bug Fixes
- Fixed webhook notification presets (e.g. Server酱³) mangling URLs or spaces in messages into %2F, +, and similar sequences — presets now send JSON bodies consistently
- Fixed the "back to top" button showing a jarring white background in dark theme; it now follows the app's theme color
- Fixed Cmd+A selecting all tasks in the list instead of the text when the search box was focused

[0.4.3] - 2026-08-13
🚀 新功能
- 应用图标自定义（默认 / 闪电 / 自定义）现已支持 macOS 与 Linux，此前仅 Windows 支持；切换图标后，桌面快捷方式、开始菜单、任务栏、Dock、托盘等位置会一并同步更新。
- 账户页昵称支持自助编辑，悬浮即可看到编辑入口，保存后立即刷新当前登录状态。
- 套餐徽标新增 outline / solid / medal / ribbon 等多种视觉样式，购买对话框与账户信息区随之更新；部分套餐还可展示专属编号（如「创始会员 No.0007」）。
- 购买买断制套餐时，若当前已持有更高档位，购买弹窗会禁止选择较低档位，避免误购导致权益降级。
🐛 问题修复
- 修复 macOS 下将窗口关闭到托盘后，Dock 图标仍然常驻不消失的问题。
- 注册时的错误提示更加明确：邮箱格式错误与密码长度不足现在会分别提示，不再是笼统的一条错误信息。
[0.4.3] - 2026-08-13
🚀 Features
- App icon customization (default / lightning / custom) now works on macOS and Linux, not just Windows — switching the icon also updates the desktop shortcut, Start menu, taskbar, Dock, and tray icon to match.
- Account nicknames can now be edited directly from the account page — hover to reveal the edit button, and changes take effect immediately after saving.
- Plan badges (in the purchase dialog and account header) now support multiple styles — outline, solid, medal, and ribbon — and some plans can display a personal member number (e.g. "Founding Member No.0007").
- When purchasing a buyout plan, the purchase dialog now blocks selecting a tier lower than the one you already own, preventing accidental downgrades.
🐛 Bug Fixes
- Fixed the Dock icon staying visible on macOS after closing the window to the tray.
- Registration error messages are now more specific — an invalid email format and a too-short password now show separate messages instead of one generic error.

[0.4.2] - 2026-08-12
🚀 新功能
- 账户设置页新增 Origin ID 自助修改入口：符合套餐条件且尚未使用过修改机会时，可手动输入新的 Origin ID（自动校验是否可用）或点击骰子获取随机推荐号码，确认后立即生效。该操作仅可进行一次，请谨慎选择。
[0.4.2] - 2026-08-12
🚀 Features
- Added a self-service Origin ID editor in Account Settings: if your plan supports it and you haven't used your one-time change yet, you can manually enter a new Origin ID (with a live availability check) or roll the dice for a random suggestion, taking effect immediately. This can only be done once, so choose carefully.

[0.4.1] - 2026-08-12
🚀 新功能
- 账户设置新增「修改 Origin ID」入口（仅当当前套餐支持该权益且修改机会尚未用过时展示）：可手动输入新 ID 并实时校验是否已被占用，也可点击骰子随机获取一个推荐 ID，确认后立即生效。该操作全局仅可成功一次，请谨慎选择。
[0.4.1] - 2026-08-12
🚀 Features
- Account settings now offer an "Edit Origin ID" option (shown only when your plan grants this entitlement and you haven't used your one-time change yet): type a new ID with live availability checking, or roll the dice for a random suggestion, then confirm to apply it immediately. This can only be done once per account, so choose carefully.

[0.3.2] - 2026-08-05
🚀 新功能
- 桌面端与 Web 端的下载任务现已互通：可在多台设备间协同执行任务，状态实时同步。
- 设置页新增「环境诊断」(Doctor)：一键自检本地服务、协议关联、日志目录等状态，支持一键修复并复制诊断报告。
- 下载完成后若源文件被移动或删除，可选择自动清除该任务记录；非 BitTorrent 任务支持一键清空产物、从零重新下载；任务管理栏支持批量清理失效任务。
- 任务列表新增「复制文件」到系统剪贴板，可直接粘贴到文件管理器；文件丢失状态与清理操作现已跨设备同步。
- 分类目录管理支持一键应用默认下载目录下的同名子目录（或一键清除），Web 端新建下载也按此规则保存文件，与桌面端行为一致。
- RSS 条目标题过长被省略号截断时，鼠标悬浮即可查看完整标题，Web 端同步支持。
- 本机服务新增跨域访问开关（默认关闭）与局域网访问地址选择，方便第三方站点探测本机下载服务、或在局域网内访问。
- 任务列表的图标按钮新增悬浮说明气泡，暂停/继续/删除等操作意图更清晰。
🐛 问题修复
- 修复设置页部分输入框（自定义 User-Agent、主题色、文件管理器命令、API 端口/Token 等）未按回车确认就切换页面或最小化窗口时，编辑内容会丢失的问题；移动端输入面板也改为关闭即保存。
- 修复 Linux 部分桌面环境（如 GNOME）下托盘图标可能不显示或丢失的问题。
- 修复默认下载目录未正确读取系统当前设置（如已手动迁移下载文件夹）的问题，现在会按操作系统实际配置解析。
- 修复部分服务器（如腾讯云 COS）返回带引号的 Content-Disposition 文件名时，下载文件名末尾出现多余下划线的问题。
[0.3.2] - 2026-08-05
🚀 Features
- Desktop and Web downloads are now connected: tasks can be executed and tracked across multiple devices with real-time status sync.
- Added a "Doctor" diagnostics panel in Settings: self-checks the local service, protocol association, and log directory, with one-click repair and a copyable diagnostic report.
- When a completed task's file is moved or deleted, you can choose to auto-clear its record; non-BitTorrent tasks can be restarted from scratch, clearing old artifacts. The task manager bar now supports bulk cleanup of tasks with missing files.
- Added "Copy File" to the system clipboard from the task list, ready to paste into a file manager; missing-file status and cleanup now sync across devices.
- Category folders can now be applied or cleared with one click under the default download directory; new downloads on Web follow the same category rules as desktop.
- Long RSS item titles that get truncated with an ellipsis now show the full text on hover, on both desktop and Web.
- Added a CORS exemption toggle (off by default) and a LAN address picker for the local service, making it easier for third-party sites to detect the local service (e.g. aria2 compatibility) or access it over the local network.
- Icon-only action buttons in the task list now show hover tooltips, making actions like pause/resume/delete clearer.
🐛 Bug Fixes
- Fixed several Settings inputs (custom User-Agent, theme color, file manager command, API port/token, etc.) losing edits when you switched pages or minimized the window without pressing Enter; mobile input sheets now also save on close.
- Fixed the tray icon sometimes failing to appear or disappearing on some Linux desktop environments (e.g. GNOME).
- Fixed the default download directory not reflecting the OS's actual current setting (e.g. after manually relocating the Downloads folder); it now resolves via the system API.
- Fixed a trailing underscore appearing in downloaded filenames when some servers (e.g. Tencent Cloud COS) return a quoted Content-Disposition filename.

[0.3.1] - 2026-08-01
🐛 问题修复
- 修复 Windows 下无标题栏窗口最大化时会盖住任务栏的问题
- SOCKS5 代理改为使用代理侧 DNS 解析，避免本地 DNS 被污染时代理连接失败；新增对 socks4a:// 的支持，未知代理类型不再被静默当成 HTTP 处理
- 修复 macOS 下弹出窗口显示卡顿的问题，并修复日志文件在并发写入时相互覆盖、导致日志内容丢失的问题
[0.3.1] - 2026-08-01
🐛 Bug Fixes
- Fixed borderless windows covering the taskbar when maximized on Windows
- SOCKS5 proxy connections now resolve DNS on the proxy side instead of locally, preventing connection failures caused by local DNS pollution; added support for socks4a://, and unknown proxy schemes are no longer silently treated as HTTP
- Fixed a laggy/stuttering popup window on macOS, and fixed log files being overwritten by concurrent writes, which could lose log content

0.3.0 - 2026-07-31
🚀 新功能
- 新建下载与快速下载支持按站点保存 HTTP Basic 认证凭据：设置页可搜索、新增、编辑与删除已保存的站点凭据；同一站点的后续任务会自动回填用户名密码
- 新增「无人值守」下载模式：HLS/DASH 等需要用户二次确认的下载变体会自动选取默认项、不再弹窗打断，并可通过子开关控制是否交由其他客户端接管
- 新增「文件已存在时」设置，支持在下载时选择保留原名或覆盖旧文件
- 支持将 FluxDown 注册为 magnet: 链接的系统默认处理程序（设置页开关控制，可随时关闭）；若已有其他客户端占用该关联则不会自动抢占，卸载时会清理注册信息
- BT 任务：暂停不再销毁做种会话，恢复暂停的种子可秒级生效，无需重建会话与重新执行完整校验；Windows 上的分段占位文件改为稀疏写入，减少磁盘预留和写入放大；初次校验阶段的下载详情统一展示「校验文件中」及实际校验进度
- 自动代理路由的判定结果会持久化保存，重启应用后可直接沿用此前验证过的最优代理，无需重新采样；连接类失败会及时清除已失效的历史判定
- 下载详情的日志 Tab 新增代理链路切换的记录事件，便于追溯下载过程中使用过哪些代理
🐛 问题修复
- 修复恢复下载时如果连接数被收敛为 1，会丢弃此前已下载的多段进度并从头重新下载的问题
- 修复部分服务器返回非标准 Content-Encoding: none 响应头时，下载被永久拒绝且无法通过重试恢复的问题
- 修复登录态过期后，多个并发请求可能相互干扰导致误判会话失效、清空本地登录凭据的问题
- 修复登录对话框中「发送验证码」按钮不会随账号输入内容更新的问题
- 修复新创建的任务在按队列筛选任务列表时可能不显示的问题
0.3.0 - 2026-07-31
🚀 Features
- New downloads and quick downloads now support per-site HTTP Basic auth credentials: manage (search, add, edit, delete) saved site credentials from Settings, and subsequent tasks for the same site auto-fill the saved username/password
- Added an "unattended" download mode: variants that normally require a manual choice (HLS/DASH, etc.) now pick a sensible default automatically instead of prompting, with a sub-toggle to control whether such links are handed off to other clients
- Added a "when file exists" setting to choose between keeping the original name or overwriting the existing file on disk
- FluxDown can now register itself as the system default handler for magnet: links (toggle in Settings, off anytime); it won't take over an association already claimed by another client, and the registration is cleaned up on uninstall
- BitTorrent: pausing a task no longer tears down its seeding session, so resuming a paused torrent takes effect instantly without rebuilding the session or re-running a full fastresume check; on Windows, staged segment files now use sparse writes to cut disk pre-allocation and write amplification; the initial verification phase now shows a "Verifying files" status with real progress across task details
- Auto proxy routing decisions are now persisted across restarts, so a previously proven best proxy route is reused immediately instead of being re-sampled; connection-level failures promptly invalidate stale route decisions
- The Log tab in task details now records proxy route switch events, making it easier to trace which proxy was used during a download
🐛 Bug Fixes
- Fixed a bug where resuming a download whose connection count collapsed to 1 would discard already-downloaded multi-segment progress and restart from scratch
- Fixed downloads being permanently rejected (and unrecoverable via retry) when a server returned the non-standard Content-Encoding: none header
- Fixed a race where concurrent requests after session expiry could misinterpret each other's failures and incorrectly clear locally stored login credentials
- Fixed the "send verification code" button on the login dialog not updating when the account field changed
- Fixed newly created tasks sometimes not appearing when the task list was filtered by queue

[0.2.4-rc.1] - 2026-07-17
🚀 新功能
- (settings) 新增账户设置分类（UI 预览）
- (settings) 账户云功能合并为多设备协同一项
- (website) 官网多语言首页与文案重构
- (analytics) 新增匿名使用统计功能
- (settings) 新增 FluxCloud 云账户设置与设备身份
- (cloud) 客户端接入 Origin ID 与跨设备配置同步
🐛 问题修复
- (sidebar) 修复队列添加按钮悬浮闪烁
- (settings) 持久化保存 .torrent 关联的退出选项，避免开关关闭后不生效 (#108)
💼 其他
- 将 main（BT 文件选择修复 #90）合并到 develop
🎨 界面样式
- (ui) 加快页面路由与弹窗转场动效速度
⚙️ 杂项任务
- (tray_manager_local) 更新 example 生成文件与依赖锁定
- (release) Flutter 构建注入 FLUXCLOUD_BASE_URL 云服务地址
- (release) Web SPA 构建注入 VITE_FLUXCLOUD_BASE_URL 云服务地址
[0.2.4-rc.1] - 2026-07-17
🚀 Features
- (settings) Add account settings category (UI preview)
- (settings) Merge account cloud features into a single multi-device sync entry
- (website) Redesign official website with multi-language homepage and copy
- (analytics) Add anonymous usage analytics
- (settings) Add FluxCloud account settings and device identity
- (cloud) Client now integrates Origin ID and cross-device config sync
🐛 Bug Fixes
- (sidebar) Fix hover flicker on the queue add button
- (settings) Persist .torrent association opt-out so toggle-off sticks (#108)
💼 Other
- Main (BT file selection fix #90) into develop
🎨 Styling
- (ui) Speed up page routing and dialog transition animations
⚙️ Miscellaneous Tasks
- (tray_manager_local) Update example generated files and dependency lock
- (release) Inject FLUXCLOUD_BASE_URL cloud service URL into Flutter build
- (release) Inject VITE_FLUXCLOUD_BASE_URL cloud service URL into Web SPA build

[0.1.55] - 2026-07-05
🚀 新功能
- (settings) 新增 MCP 端点开关
- (mobile) 支持系统分享/URL scheme 唤起新建下载
- (win) 为 nmh 与 updater 嵌入 PE 版本信息资源
- (cli) 新增 add --local 内嵌引擎独立下载模式
- (extension) 简化 popup 拦截设置，移除文件类型编辑
- (feedback) 反馈可附带当天脱敏日志
- (release) 下载总数叠加历史旧渠道基础量
- (settings) 便携模式改用 exe 目录 settings.json 存储
- (scoop) 新增 Scoop 安装支持，提供官方与自托管 bucket
- (extension) 深扫响应体清单与 JSON 内嵌媒体 URL
- 检测已完成任务文件被删除/移动
🐛 问题修复
- (website) 下载量改为纯 GitHub 全量统计并缓存 12 小时
- (scoop) 调整 manifest 以对齐 Extras 规范
- (open-file) 改用裸路径打开修复 UWP 关联类型无反应
- (promotion) 修正 Unraid CA 模板通过扫描校验
- (promotion) CasaOS compose 补 x-casaos.id 字段
- (scoop) 移除官网中的官方 extras 源，直到满足准入条件
- (settings) 修复文件管理器命令无法清空
💼 其他
- 修复了Windows预览体验版 Experimental 的 Future Platforms (老 Canary 频道，29xxx版本) 分支长期出现的启动软件后出现白屏的情况 (#10)
🚜 重构
- (reveal) 合并定位文件与打开目录为单条命令
📚 文档
- (promotion) 新增 NAS 与开源生态推广物料
- (promotion) MCP 改走社区清单并记录渠道进展
- (website) 新增 Docker 与 NAS 部署文档
- (openapi) 同步 TaskDto 新增 fileMissing 字段
🎨 样式
- (mobile) 任务操作面板按控制/常规/危险分组
⚙️ 杂项任务
- 更新官网域名为 fluxdown.zerx.dev
[0.1.55] - 2026-07-05
🚀 Features
- (settings) Add MCP endpoint toggle
- (mobile) Support creating new downloads via system share/URL scheme
- (win) Embed PE version info resources for nmh and updater
- (cli) Add add --local standalone download mode with embedded engine
- (extension) Simplify popup interception settings, remove file type editing
- (feedback) Feedback can include the day's redacted logs
- (release) Add historical legacy channel base count to total downloads
- (settings) Portable mode now stores settings.json in the exe directory
- (scoop) Add Scoop install support with official and self-hosted buckets
- (extension) Deep scan response body manifests and JSON-embedded media URLs
- Detect completed task files being deleted/moved
🐛 Bug Fixes
- (website) Switch download count to pure GitHub full-count stats, cached for 12 hours
- (scoop) Align manifest with Extras conventions
- (open-file) Fix UWP-associated file types not responding by opening with a bare path
- (promotion) Fix Unraid CA template to pass scan validation
- (promotion) Add missing x-casaos.id field to CasaOS compose
- (scoop) Drop official extras source from site until criteria met
- (settings) Fix file manager command unable to be cleared
💼 Other
- Fixed a long-standing white screen issue after launching the app on the Windows Insider Experimental Future Platforms branch (the old Canary channel, 29xxx builds) (#10)
🚜 Refactor
- (reveal) Merge "locate file" and "open folder" into a single command
📚 Documentation
- (promotion) Add NAS and open-source ecosystem promotional materials
- (promotion) Move MCP to community list and track channel progress
- (website) Add Docker and NAS deployment docs
- (openapi) Sync TaskDto with new fileMissing field
🎨 Styling
- (mobile) Group task action panel by control/general/danger
⚙️ Miscellaneous Tasks
- Update official website domain to fluxdown.zerx.dev