企业官网建设流程全解析

Streambert 下载队列怎么管：取消、失败重试、队列维护 5 个操作一次讲清

【免费下载链接】streambertA cross-platform Electron Desktop App to stream and download any Movie, TV Series or Anime in the World. Zero Ads and Tracking项目地址: https://gitcode.com/GitHub_Trending/st/streambert

Streambert 的下载队列没有暂停键——想停只有 Remove 和关应用两条路；任务失败后怎么重发、队列越攒越乱怎么理，这篇按一次下载的完整生命周期讲清，照着点按钮就行。

第一次入队前的三件事

入队入口很简单：在任意电影、剧集或动漫详情页点Download，弹窗里依次确认三件事。

1. 播放流地址。弹窗顶部要出现Stream URL found——地址来自你正在播放的页面，所以没点过播放的话这里会一直显示Waiting for stream URL … (start the video first)，回去点下播放再回来。
2. 下载器检测。看到绿色✓ Video Downloader found徽章才算就绪。没有的话，弹窗里会列出三步：下载 vid-dl-cli-only 的对应系统版本（Windows 选Windows_x64-portable，Linux 选Linux_x64-portable）、解压到一个专门文件夹、点Choose folder …选定。文件夹里必须同时有_internal目录和可执行文件，少一样都会给出对应报错（缺_internal或No executable binary found）。检测逻辑见 src/components/DownloadModal.jsx。
3. 保存目录与字幕。底部Save to:显示当前保存目录，旁边Change可换；首次使用会先弹出Set Download Folder让你定一次。字幕开关默认开着：在 Settings 配过 Wyzie 或 SubDL API key 时，弹窗会自动搜索默认语言并预选第一条字幕，点Browse能换语言、换源，没配 key 就显示No subtitle API key set提示。字幕可开可关，不影响视频本身。

三项都确认后点Start Download，弹窗显示✓ Download started!。此时跳到侧边栏的 Downloads 页，页面分 Active（进行中）和 Local Files（已完成加手动扫描的本地文件）两块，刚入队的任务在 Active 区，卡片会高亮闪烁约 3 秒提醒你它在这里。卡片上实时显示百分比、速度、分片数（如128/352 fragments），下方是进度条和最新日志行。进度条最高只走到 99%——后面还有转封装阶段，后面会说。

下载中想停：只有 Remove 和关应用两条路

先给结论：没有暂停按钮，Active 卡片右上角只有垃圾桶样式的Remove。

它这么做的原因不复杂：下载跑在一个外部下载器进程里，"停止"就是杀进程，半截的.part、.ytdl临时文件留着没有任何意义，与其让你留着半成品占空间，不如停下就清干净。

所以想停，两条路：

• 点 Remove：先弹一次确认框，确认后进程被终止、该目录下的临时文件被清扫、队列记录删除。误触点 No 即可，不会误删。
• 关应用：队列里还有任务时直接关窗口，会弹确认框N active downloads will be cancelled and incomplete files will be deleted，选Keep Downloading取消关闭继续下，选Cancel & Close App则全部取消并清理。这个拦截逻辑在主进程入口，见 index.js。

两种方式的结果一致：进行中的任务不会保留。重启应用后，队列记录只留下已完成的任务，进行中的不会自动恢复，想继续得重新发起（方法见后文）。

下载卡住：先等自动重试，再看日志定位

网络抖一下别急着操作。卡片速度归零、日志行变成Retrying… (1/3)时，是下载器进程在自动重试，三次内成功进度条就继续走，不用管它。解析逻辑在 src/ipc/downloads.js。

三次都失败、进程非 0 退出时，任务落到 Local Files 并标记Error。此时卡片直接展示从日志里提取的最后一条报错（匹配error、failed、unable、cannot、denied等关键词）加退出码，旁边多出一个View Log按钮——每次下载都会单独生成一份streambert_dl_任务ID.log，失败的保留下来，点它一键打开。

读日志只盯最后几行就够：权限、路径类报错，换保存目录重来；超时、连接类报错，基本是网络问题，稍后再试。成功的下载日志会自动删掉，不会堆积。

彻底失败后：为什么没有重跑按钮，以及 3 步重新发起

先回答"为什么没有一键重跑"：下载依赖的是页面里实时的播放流地址，旧任务里存的那份地址过一会儿就失效了，重跑旧地址等于必然再失败一次，所以干脆不给你这个按钮。重新发起就三步：

1. 在 Error 卡片上点标题或海报，直接跳回对应的电影/剧集页面；
2. 重新点播放，让页面抓到最新的流地址；
3. 再点Download，走一遍上面的准备流程入队。

同一片同一集的新任务会自动替换掉旧的失败记录，队列里不会出现两条重复，盯新进度就行。另外，重启应用后未完成的下载不会自动续跑，需要按这三步重新来一遍。

队列多了以后的四个整理工具

任务攒到几十个以后，Downloads 页工具栏和 Local Files 区自带四样东西：

• Sort by：按Date / Name / Size / Type排序，旁边↓/↑键切升降序，你的偏好自动记住；
• 过滤框：按Ctrl+K（或点工具栏右侧放大镜）打开，输入片名即时筛选，Esc关闭；
• Folder to scan：填路径或点Browse选目录，点⟳ Scan递归扫描（最深 3 层）视频文件并入列，扫进来的标为Local，和真正下载的Completed、Error区分开；
• Untracked开关：控制是否显示扫进来的本地文件，关掉就只看自己下过的，开关旁还会标注未跟踪文件数量。

另外，应用会定期校验文件还在不在：发现被外部删掉的已完成任务会自动移出队列，对应的字幕路径记录也同步修剪，队列不会留下一堆空壳。

高频疑问速答

三个反复被问到的情况，按"看到什么 → 为什么 → 怎么办"列在这里：

• 进度条卡在 99%→ 分片下完后还要过 ffmpeg 转封装/合并阶段，卡片此时显示Processing…或Merging…，属于正常收尾，别取消，等它跳到 100% 并改名入库；
• 卡片上出现File missing→ 应用校验时发现视频文件被外部删了，这条记录会移出队列，文件本身想找回得去保存目录手动看；
• 字幕没下下来→ 字幕和视频是两条独立链路，字幕失败不影响成片，点卡片上的字幕语言徽章（或No subtitles）打开字幕下载器，重选语言补下即可。

💡 已完成的下载记录保存在本地downloads.json，重启后完整保留——随时回 Local Files 区继续看、定位文件夹或删除。

【免费下载链接】streambertA cross-platform Electron Desktop App to stream and download any Movie, TV Series or Anime in the World. Zero Ads and Tracking项目地址: https://gitcode.com/GitHub_Trending/st/streambert