Repository navigation
v1.3.3
📦 下载对照表
| 平台 | 架构 | 安装包 |
|---|---|---|
| Windows | x64 | 安装版 .exe(推荐) |
| Windows | x64 | 便携版 .exe |
| macOS | Apple 芯片(M 系列) | .dmg(推荐) |
| macOS | Intel | .dmg(推荐) |
| Linux | x64 | .AppImage(推荐) |
| Linux | x64 | .deb |
| Linux | x64 | .rpm |
| Linux | arm64 | .AppImage |
运行依赖 yt-dlp / ffmpeg 不随安装包分发:启动后会自动识别机器上已安装的版本并复用,
识别不到时在「设置 → 运行依赖」里一键下载即可,无需提前手动安装。
⚠️ 各平台注意事项
- Windows:安装版会创建开始菜单与桌面快捷方式;便携版解压即用,但不支持自动更新
- macOS:应用未做代码签名,首次打开需在「系统设置 → 隐私与安全性」中允许;Apple 芯片请勿选 Intel 版
- Linux:
.AppImage需先chmod +x;.deb/.rpm可通过包管理器安装
📝 更新内容
修复
- 贡献者列表报 403:原先启动时请求 GitHub 的
/contributors与/commits,
而未认证请求限额是 60 次/小时且按来源 IP 共享 —— 一次刷新 3 个请求,
多人共用出口 IP 时很容易耗尽。现改为固定名单,不再请求接口:
稳定、离线可用、也没有失败态 - 「继续下载」点了没反应、任务卡在「下载中」:
resumeTask先把状态置为
downloading,而processProcess开头的守卫正是拒绝该状态,把自己挡了回去 - 字幕任务「继续下载」报
An object could not be cloned:subtitles恢复时
来自响应式对象(Vue Proxy),而 Proxy 无法被 structured clone - 直链断点续传与暂停竞态(@hailaij):保留
.part与逐段检查点,恢复时只请求
未写入范围;校验 URL / 总长度 / ETag / Last-Modified / 文件长度 / 分段布局,
不把预分配长度当作完成进度;快速恢复时旧结果不再覆盖新任务 - 文件名模板重复追加扩展名(@hailaij):模板已含
%(ext)时不再补 - 下载目录生效时机(@hailaij):新任务立即读取最新目录,暂停任务保留原目录以续用片段
- 国内网络下应用完全打不开(@jwfstars):字体样式表改为异步加载,
不再阻塞首屏脚本执行
新增
- 可配置的下载加速(@hailaij):直链改为小块工作队列(默认 8 路、上限 16 路),
快连接不必等慢连接;可选 aria2c(>= 1.36)用于 yt-dlp 的 HTTP 多连接,
缺失自动回退内置、不自动安装、不改系统 PATH。含 429/503 降并发与 Retry-After 等待、
30 秒无数据超时重试、aria2 片段隔离。本地受控场景实测约为旧四段实现的 1.88 倍
(不是对真实站点速度的承诺 —— 多连接解决不了服务器总限速、总带宽与 DRM) - 自动更新可显式控制:设置里新增「更新」分区 —— 「启动时自动检查更新」(默认开)
与「发现新版本时自动下载」(默认关)。此前自动更新是隐式的:启动 3 秒后静默检查一次,
用户既看不到也关不掉 - 关于页贡献者改为固定名单 + 格子布局:不再显示提交次数(那是个会变的数字),
也不再需要缓存与失败态 - 产品官方落地页(Vercel 静态托管):新增
website/单文件落地页(无第三方打包依赖、响应式、纯前端双语),由vercel.json托管静态目录并以 Vercel 的 Git 集成自动发布,提供直观的跨平台下载与功能介绍 - 官网展示累计下载量:hero 增加「已被下载 N 次」,数字取 GitHub Releases 全部产物的
download_count之和。
刻意不做实时拉取(官网零第三方依赖,且未认证 API 限额按出口 IP 共享,见上一节),
改为pnpm website:stats一条命令刷新
改进
- 更新弹窗里正确渲染 Markdown:此前
v-html直接把 Release 正文当 HTML 显示,
而它是 Markdown,于是### 修复、- **…**原样显示成一大坨纯文本。
现用marked转换,并关掉breaks(否则 CHANGELOG 里 ~80 字符的手工折行
会被当成硬换行,一段话被切成好几行) - 关于页区块顺序调整为「贡献者 → 开源组件 → 技术栈 → 开源协议 → 支持」,顶部描述精简
- 真人贡献者此前没有任何身份标(只有 DEV / BOT / AI),现补上
CONTRIBUTOR - README 徽章与视觉全面升级:
- 徽章栏全线升级为带品牌官方矢量 Logo 与专属配色(Downloads、Release、Stars、AlternativeTo、CodeQL、License)
- 中英文 README 项目简介(About)大幅充实扩展,结构化呈现跨平台与无水印下载亮点
- 新增
### 贡献者动态头像网格(contrib.rocks),展示社区贡献者 - 新增 AlternativeTo 软件条目收录链接与 CodeQL 自动化安全扫描状态
- 补充 OpenGraph 社交预览卡片与生成脚本(
scripts/gen-social-preview.mjs)
package.json补齐中英双语详细描述与搜索关键词标签(keywords)
工程
Dependency Review在仓库未开启 Dependency graph 时不再报错,改为给出明确提示并跳过
(该开关只能手动在网页设置里打开,GitHub API 不提供)。此前多位贡献者被这个红叉误导- 删除已无用的
electron/utils/contributors.ts(163 行)与相关 IPC、缓存、脚本 - 删除
Deploy website工作流(pages.yml):仓库从未在 Settings → Pages 里选过发布源,
actions/configure-pages因此每次都稳定报Get Pages site failed,却没有任何东西依赖它。
官网改由 Vercel 的 Git 集成发布,原先那套站点自检(引用资源存在、中英词条成对)
重写成可本地运行的pnpm lint:website,挂到test.yml的 frontend job——
官网的坑是「改完不报错、线上才裂」,值得留在 CI 里而不是随工作流一起删掉
完整历史见 CHANGELOG.md · 遇到问题请先看 故障排除