软件官网（国内可访问）：https://zgb.cc.cd/
中转链接订阅页：https://zgb.cc.cd/go
建议：将
https://zgb.cc.cd/go/资源名作为长期订阅地址，源站更新夸克原链后可自动跟随。
- 🔍 自动监测 — 定时检查分享链接，发现新文件自动下载
- 🎞️ 同集补高清自动替换 — 如果同一天先上传普通版、后面又补传同序号的
4K / 2160p或明显更大的版本，会自动下载后者并清理前面那份较糊旧文件 - ⚡ 多线程下载 — 8 线程并发分片下载，充分利用带宽
- 📊 实时进度 — 下载速度、进度条、剩余时间一目了然
- 🔔 系统通知 — 新文件下载完成后弹出 Windows 通知，点击通知打开下载文件夹
- 🗑️ 智能删除 — 默认按 PotPlayer 总进度达到
84%，且自然播放至少50%后，并在结束当前播放会话时自动清理；手动跳过片头也能兼容，双击编辑任务还可单独改阈值；不想安装播放器时也可按天数自动删除旧文件 - 📦 全存模式 — 将链接内所有文件保存到独立子文件夹，适合一次性归档
- 📋 可视化任务管理 — 双击编辑任务参数、右键查看文件历史、显示运行模式；任务管理主表会对当前正在播放的任务按秒局部刷新，历史弹窗支持复选框批量标记、批量重下误删文件、逐集播放和每秒查看实时进度；手动下载会自动判断监测空窗期，多个重下请求会排队执行并在完成后恢复监测
- 🔄 远程同步 — 支持从远程 URL 自动同步任务配置
- 🔁 中转链接支持 — 支持非夸克直链（302/参数包裹中转），自动解析并跟随到最新夸克链接
- ⚙️ 兼容配置 — 支持导入 quark-auto-save (QAS) 的配置文件，迁移零成本
- ☁️ 统一配置包与账号级同步 — 软件总配置导出已统一为
quark_full_config_bundle，会连同任务、Cookie 和文件级下载记录一起导出；现在桌面端设置页已可直接“拉取账号云同步 / 推送账号云同步”，并与安卓端共用同一份 JSON 协议和客户端加密格式 - 🔒 最小化到托盘 — 关闭窗口自动最小化，后台静默运行
- 🆕 自动更新 — 启动时自动检查新版本，支持程序内后台下载并安装更新；更新链路会结合轻量测速动态选择更快镜像，并在失败时自动回退
- 🔐 授权机制 — 提供 7 天免费试用，支持在线激活；运行期间需联网校验授权状态
直接下载最新版：QuarkAutoDownloader-latest.exe，双击即可运行，无需安装任何环境。
💡 从安装版开始，正式发布建议优先使用“安装器 + 固定安装目录”模式： 默认安装到
%LOCALAPPDATA%\Programs\QuarkAutoDownloader\QuarkAutoDownloader.exe， 这样开机自启、桌面快捷方式和后续自动更新会比手动移动单文件 exe 更稳定。💡 安装版会自带标准卸载入口：可从 Windows“已安装的应用”、开始菜单里的“卸载 追更宝”或卸载程序移除；若用户是通过安装版卸载，Worker 后台也会记录最近一次卸载时间，方便区分“没开软件”和“已经主动卸载”。
💡 当前 Windows 打包链路也已优先切到
onedir目录版，主要是为了降低PyInstaller onefile自解压壳带来的杀软误报概率；如果本机安全软件对单文件 exe 比较敏感，优先使用安装版或完整目录版更稳。
如果要进一步降低“未知发布者 / Python loader”带来的拦截概率，当前仓库已经接入微软 Trusted Signing 的本地打包流程。
准备步骤：
- 安装微软 Artifact Signing Client Tools：
winget install -e --id Microsoft.Azure.ArtifactSigningClientTools - 复制
tools/trusted_signing.metadata.sample.json为本地文件tools/trusted_signing.metadata.local.json - 按 Azure Artifact Signing 账户信息填写：
EndpointCodeSigningAccountNameCertificateProfileName也可以直接用脚本生成：
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\write_trusted_signing_metadata.ps1 `
-CodeSigningAccountName "<你的 account>" `
-CertificateProfileName "<你的 profile>" `
-Endpoint "https://eus.codesigning.azure.net"- 先完成 Azure 登录，确保当前环境可被
DefaultAzureCredential取到身份，例如：
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\azure_login_trusted_signing.ps1 -ShowAccount手动签名：
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\sign_windows_artifacts.ps1 `
-TargetPaths ".\dist\QuarkAutoDownloader-v1.0.69\QuarkAutoDownloader.exe"自动签名：
- 运行
build_installer.bat时，在QUARK_TS_AUTO_SIGN=1且 metadata 已配置完成的前提下，会在打包后自动对目录版入口 exe 和安装包执行 Trusted Signing。 - 如果要开启自动签名，需要显式先设置
QUARK_TS_AUTO_SIGN=1，避免占位模板被误当成真实配置。
🌐 也可从官网获取最新版与更新说明（免翻墙，下载速度通常更快）：https://zgb.cc.cd/
💡 配置文件默认保存在
%APPDATA%\QuarkDownloader\config.json。若检测到 exe 同目录下有旧版config.json，程序会在首次启动时自动迁移并保留备份。
⚠️ 软件启动与运行期间需要联网（用于授权状态校验与心跳）。
GitHub README 为保证稳定显示，优先使用仓库内
screenshots/图片；软件下载和更新页当前临时改为走 NodeImage 图床。
| 监控面板 | 任务管理 |
|---|---|
 |
 |
| 设置 | 关于 |
|---|---|
 |
 |
仓库里已经新增独立安卓客户端工程 android/，当前首版按下面这条技术线搭好了基础骨架：
Kotlin + Jetpack Compose + Retrofit/OkHttp + WorkManager + Room + DataStore- 激活码即账号，不要求输入电脑机器码
- 安卓本地生成自己的
machine_id / install_id / device_fingerprint - 统一复用桌面端
quark_full_config_bundle，导入导出文件格式与云同步载荷保持一致 - 云端同步包走客户端加密上传，AList(OneDrive) 只保存密文和元数据
当前仓库已经能在本地编译出安卓 APK，后续桌面端与安卓端会继续围绕同一套 Worker 同步接口和统一 bundle 协议迭代。
Cookie 是程序访问你夸克网盘账号的凭证。当前推荐轻量扫码，不需要 F12 手动复制，也不必默认启动内嵌浏览器：
- 打开软件，进入 ⚙️ 设置 页面
- 点击「轻量扫码 Cookie」
- 用夸克 App 扫描弹窗里的二维码并确认登录
- 等待 Cookie 自动回填，并点击「保存设置」
- 如果轻量扫码异常，可直接点击弹窗里的「打开扫码页」或复制链接到外部浏览器打开；也可以手动粘贴现成 Cookie
进入 📋 任务管理 页面，点击「添加任务」，输入任务名称后可自动联想中转资源，点「确定」保存。 如需看图文步骤，可直接点击任务弹窗里的「联想教程」按钮。
日常排查时，也可以在任务管理里右键任务查看文件历史，直接看到每个文件的状态、更新时间、下载时间和播放进度；任务管理主表会对当前正在播放的任务按秒局部刷新，历史弹窗也会按秒刷新当前播放进度，还能逐集点播调试。文件历史左侧复选框可批量重新下载或批量标记“已看完删除”；多个重新下载请求会排队执行，不会因为已有手动下载在运行就直接拒绝。仅网盘存在、暂无本地路径的记录被标记删除时，只会写入本地跳过标记，不会删除夸克网盘远端文件。
进入 📡 监控面板，点击「启动监测」，程序立即开始第一次检测，之后按设置的间隔自动运行。 如果你在任务管理里临时点了“手动下载”，程序会先判断当前是不是监测空窗期：空窗期会临时暂停并在下载后自动恢复；如果正处于本轮检查中，则会提示等待，避免和监测下载打架。
| 配置项 | 说明 |
|---|---|
| Cookie | 夸克网盘账号的登录凭证，用于下载文件。推荐直接用「轻量扫码 Cookie」自动回填，过期后重新扫码即可；扫码页异常时可复制链接到外部浏览器打开，或手动粘贴 Cookie |
| 验证 Cookie | 点击后连接夸克服务器验证 Cookie 有效性，并显示绑定的账号昵称 |
| 登录教程 | 打开文档站里“扫码登录获取 Cookie（新流程）”对应教程 |
| 联想教程 | 打开文档站里“任务名称联想怎么用”对应教程 |
| 配置项 | 说明 |
|---|---|
| 下载目录 | 文件下载到本地的保存位置。点击「浏览...」选择文件夹，或直接输入路径 |
| 检查间隔 | 每隔多少秒检查一次所有任务是否有新文件。默认 300 秒（5 分钟），建议不低于 60 秒，避免请求过于频繁 |
| 自动启动 | 程序打开后自动开始监测，无需手动点「启动监测」 |
| 按预计时间运行 | 开启后，每个任务会尽量等到“预计下次更新时间”到点后再运行，并持续下载到本次任务完成；无法判断预计时间的任务仍按原检查间隔兜底 |
| 开机自启 | Windows 开机时自动启动本程序，适合长期追更使用 |
| 系统通知 | 新文件下载完成后弹出 Windows 右下角通知。点击通知可直接打开下载文件夹 |
点击「添加任务」或双击任务进入编辑时，有以下配置项：
| 配置项 | 说明 |
|---|---|
| 任务名称 | 任务的标识名，会出现在下载文件名中（格式：日期-任务名-文件名） |
| 分享链接 | 支持夸克直链（https://pan.quark.cn/s/xxxxxxxxxx）和中转链接（非夸克域名，访问后会跳转到夸克链接） |
| 运行模式 | 追更模式：只保存最近更新的文件，默认按 PotPlayer 总进度达到 84% 且自然播放至少 50% 后，并在结束当前播放会话时智能删除，双击编辑任务可单独改阈值；只有在未启用 PotPlayer 智能删除时，才按“追更保留天数”自动清理旧文件，适合追剧/追番；全存模式：下载链接内所有文件到独立子文件夹，适合一次性归档资源 |
| 更新星期 | 勾选哪几天运行此任务。例如只勾「周五周六周日」适合只在周末更新的剧集。全不勾选等同于每天都运行 |
| 配置项 | 说明 | 示例 |
|---|---|---|
| 截止日期 | 超过此日期后停止检测该任务，适合有结束日期的连载内容。格式 YYYY-MM-DD，留空表示永不停止 |
2026-06-30 |
| 文件过滤（正则） | 只下载文件名匹配此正则表达式的文件，留空则下载全部文件 | .*\.(mp4|mkv) 只下载视频文件 |
| 更新子目录 | 分享链接有多层文件夹时，指定只监测某个子目录的文件名，支持部分匹配 | 填 1080p 只处理名为「1080p」的子目录 |
| 重命名替换 | 下载后对文件名做正则替换，格式为 匹配Pattern|替换内容，支持捕获组 \1\2\3 |
S01E(\d+).*\.mp4|第\1集.mp4 |
| 网盘路径 | 兼容 QAS 的字段，用于指定网盘转存路径，本软件直接下载到本地时可留空 | /我的追更/某某剧 |
| 功能 | 说明 |
|---|---|
| 导入本地配置文件 | 支持导入 QAS 的 quark_config.json，也支持导入本软件导出的统一总配置包；总配置包会同时带上任务、软件设置和下载记录 |
| 从剪贴板导入 JSON | 将配置 JSON 内容复制到剪贴板后点击，直接粘贴导入；同样兼容旧配置和统一总配置包 |
| 导出软件总配置 | 导出统一总配置包，默认包含 Cookie、下载目录、同步设置、任务列表以及文件级下载/播放记录，便于电脑和手机之间互导 |
| 拉取账号云同步 / 推送账号云同步 | 使用当前激活码对应的账号云同步空间，和安卓端共用同一套加密配置包；手动点击即可在电脑和手机之间同步总配置 |
| 启用远程配置定期同步 | 勾选后定期从「远程地址」拉取配置，实现远程更新任务列表 |
| 远程地址 | 配置文件的直链 URL，需能直接返回 JSON 内容（如 GitHub Raw 链接） |
| 同步间隔 | 多久同步一次远程配置，默认 3600 秒（1 小时） |
| 立即同步远程配置 | 手动触发一次远程同步，不等待定时器 |
资源常见场景是：原始夸克链接随时可能失效，资源提供方会换新链接。
如果你每次都手动翻找最新链接再回软件改任务，成本高且容易漏更。
我们提供的中转链接订阅入口：https://zgb.cc.cd/go
用法建议：
- 在 Cloudflare Worker 部署中转页（当前项目已内置
/go与/go/:资源名）。 - 对外只分发中转链接，例如
https://zgb.cc.cd/go/剑来2（或你自己的域名）。 - 当源站更新到新的夸克链接时，中转地址保持不变，软件会自动跟随到新链接。
这相当于把单次分享链接升级为可持续订阅入口，可显著降低封链带来的维护成本。
文件的保存位置和命名方式取决于任务的运行模式：
文件直接保存在下载目录根目录下，命名格式：
日期-任务名称-原文件名
例如：
2026-03-01-追光者-EP01_1080P.mp4
2026-03-02-追光者-EP02_1080P.mp4
2026-03-02-某纪录片-第1集.mp4
追更模式默认只保留最近更新的内容。若已启用 PotPlayer 并开启“记忆播放进度”，视频默认会在总进度达到 84% 且自然播放至少 50% 后，并在结束当前播放会话时自动清理；这样既能兼容手动跳过片头，又能避免只靠拖动进度条误删，而且启用 PotPlayer 后视频不再按“追更保留天数”删除。如果某个任务想更保守或更激进，可双击任务进入编辑后单独调整阈值；如果不想安装 PotPlayer，则按“追更保留天数”自动清理旧文件，避免占用过多磁盘空间。
文件保存在下载目录下以任务名称命名的独立子文件夹内，使用原始文件名，不添加日期前缀，不自动清理：
下载目录/
└── 追光者/
├── EP01_1080P.mp4
├── EP02_1080P.mp4
└── EP03_1080P.mp4
适合一次性归档整个资源包，或需要保留所有历史文件的场景。
如果你是 quark-auto-save (QAS) 项目的用户，可以一键导入任务配置，无需重新录入：
Docker 部署的用户：
docker cp 容器名:/app/data/quark_config.json ./quark_config.json本地部署的用户：
直接找到 QAS 项目目录下的 quark_config.json 文件。
- 打开本软件，进入 ⚙️ 设置 页面
- 找到「配置导入与远程同步」区域
- 点击「📂 导入本地配置文件」，选择刚才导出的
quark_config.json - 任务列表自动导入完成 ✅
⚠️ 注意：本软件配置格式在 QAS 基础上扩展了更多字段（本地下载路径、运行星期等），本软件导出的配置不能反向导入 QAS。
Q: 下载速度很慢怎么办？
夸克网盘对非会员有下载限速（约 100-200 KB/s）。软件已使用 8 线程并发下载最大化利用带宽，但总速度仍受限于夸克的限速策略。
如果想提升速度，推荐去闲鱼购买 88VIP 夸克会员（约 5 元/年），非高峰期基本不限速，性价比极高。
Q: Cookie 过期了怎么办？
Cookie 过期后，优先重新点击「轻量扫码 Cookie」扫码登录即可；如果轻量扫码异常，可复制扫码链接到外部浏览器打开，或手动粘贴新的 Cookie 后再保存。
Q: 文件过滤（正则）怎么写？
只有文件名匹配正则的文件才会被下载：
- 只下载 mp4/mkv：
.*\.(mp4|mkv) - 只下载含「1080p」的文件：
1080p - 只下载第 1-9 集：
EP0[1-9]
留空则下载分享链接中的全部文件。
Q: 更新子目录怎么用？
当分享链接里有多个子文件夹（如「1080p」「4K」「花絮」），只想下载其中某个文件夹时使用。填入文件夹名关键词即可，支持部分匹配。填 1080p 则只处理名为「1080p」的子目录。留空则处理根目录下所有文件。
Q: 程序关闭后还在运行吗？
点击「×」关闭窗口时，程序会最小化到系统托盘（任务栏右下角），继续后台运行。右键托盘图标 → 选择「退出」可彻底关闭。
Q: 如何从 QAS (quark-auto-save) 迁移？
详见上方「从 QAS 项目迁移」章节。简单来说：导出 quark_config.json → 在本软件设置页点击「导入本地配置文件」即可。
Q: 支持 Mac / Linux 吗？
目前仅支持 Windows。
Q: 追更模式和全存模式有什么区别？
| 对比项 | 🔄 追更模式 | 📦 全存模式 |
|---|---|---|
| 适用场景 | 连载追剧/追番，只关心最新更新 | 一次性归档整个资源包 |
| 保存位置 | 下载目录根目录 | 下载目录 / 任务名称 / 子文件夹 |
| 文件命名 | 日期-任务名-原文件名 |
原文件名（不加日期前缀） |
| 自动清理 | ✅ 默认按 PotPlayer 总进度 84% + 自然播放至少 50% 智能删除，并在结束当前播放会话时执行；双击编辑任务可单独改阈值；仅未启用 PotPlayer 时按“追更保留天数”清理旧文件 |
❌ 不清理，保留所有文件 |
| 检测范围 | 只检测当天新增文件 | 检测链接内所有文件 |
Q: 试用过期后还能用吗？为什么提示需要联网？
- 免费试用期为 7 天。试用到期后，仍可查看任务和设置，但无法启动监测下载，输入激活码后可恢复完整功能。
- 当前版本使用在线授权校验：启动时会联网校验，运行期间会定期心跳校验。
- 若长时间无法连接授权服务器（超过缓存有效期），程序会提示并停止运行；恢复网络后重启即可。
- 紧急清理默认配置模板，移除本机 Cookie、推送凭据和个人任务，避免账号配置进入新安装包
- 新增发布前安全检查，带账号 Cookie 或个人任务的配置会阻断构建
- 旧构建入口同步移除
config.json打包项，降低误用旧脚本造成配置泄露的风险
- PotPlayer 实时进度采集改为优先按启动进程 PID 精确关联文件，修复剧集类视频进度卡在旧值的问题
- 保留标题匹配与 DPL 记录作为回退，避免手动启动播放器时完全失去进度刷新
- 播放进度采集优化：优先实时读取 PotPlayer 当前播放位置，DPL 记录继续作为兜底
- 保留现有自动清理策略，视频达到阈值后仍按播放进度执行删除
- 授权校验链路升级：客户端优先使用 WebSocket 获取实时授权状态，HTTP checkin 作为回退，显著降低高频 KV 请求
- Durable Object 新增授权状态缓存与在线状态聚合，后台“在线时间”改为更准确的累计值
- 在线时长持久化：总在线时长写入 DO Storage，Worker 重启后仍可保留历史累计时长
- 管理后台用户列调整为「最后上报时间 / 上报次数 / 在线时间 / 最后一次上报内容」
- 客户端购买入口链接同步更新为新的闲鱼链接
- 🔁 新增中转链接订阅能力：支持使用中转 URL 自动跳转到最新夸克分享链接
- 🌐 Worker 新增
/go订阅列表页与/go/:资源名动态跳转入口，可直接分发稳定订阅地址 - 📚 文档补充防封链场景说明：通过中转链接避免频繁手动替换任务链接
- 🆕 Worker 管理后台增强：新增「前台首页」与「GitHub」快捷入口
- 🎨 后台状态显示优化：
试用中（7天）与试用状态统一为黄色标识 - 🔄 自动刷新体验修复：倒计时区域新增“当前时间/下一次刷新时间”，并修复计时触发后列表不刷新的问题
- 🔒 在线授权协议升级：校验链路更新为
heartbeat + instance_secret + HMAC-SHA256，并加入时间窗与 nonce 防重放 - 🔁 新增中转链接能力：客户端支持中转 URL 自动解析，Worker 新增
/go订阅列表和/go/:资源名动态跳转
- 🆕 升级到在线授权体系：提供 7 天免费试用，支持激活码在线激活永久授权
- 🆕 新增授权状态实时展示（试用剩余天数、服务器连接状态、缓存剩余时间）
- 🔒 授权校验加强：启动时联网校验，运行期间按 5 分钟周期心跳校验
- 🔧 更新检查流程与版本信息对齐 GitHub Releases（当前正式版 v1.0.8）
- 🆕 新增「追更模式」与「全存模式」，追更只保留当天文件，全存归档所有文件到独立子目录
- 🆕 任务管理表格新增「模式」列（🔄 追更 / 📦 全存）
- 🆕 任务管理双击行直接编辑，右键菜单支持编辑/打开分享链接/查看文件历史/删除
- 🆕 新增导出配置文件功能（任务管理页和设置页均可导出）
- ✨ 优化日志：先展示跳过/执行摘要，再逐个显示"第 N/M 个任务"执行进度
- ✨ 优化窗口布局，任务表格列宽自适应
- ✨ 进阶列切换时窗口自动跟随调整宽度
- ✨ 账号设置区域高度固定，不随窗口拉伸
- 🔧 修复启动崩溃问题（移除已废弃的支付模块依赖）
- 🔧 配置文件迁移至 AppData 目录，支持自动备份与恢复
- 🎉 首个正式版本发布
- 自动监测分享链接更新并下载到本地
- 8 线程并发分片下载，实时进度与速度显示
- 系统托盘后台运行，点击通知打开下载文件夹
- 支持导入 quark-auto-save (QAS) 配置文件
- 按日期自动清理过期文件
- 启动自动检查更新
- quark-auto-save (QAS) — 配置格式参考，本软件支持导入其配置文件
- PyQt6 — GUI 框架