Streambert 下载队列管理完整指南暂停下载与失败重试的完整逻辑【免费下载链接】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/streambertStreambert 是一款跨平台 Electron 桌面应用支持在线播放并下载电影、剧集和动漫全程零广告零追踪。它的下载队列支持多任务并行、实时进度、字幕打包与失败排查。写这篇指南之前先说结论方便你带着问题快速定位Streambert 没有暂停按钮但取消操作足够干净下载中断时下载器会自己重试三次失败的任务不能原地重跑需要回到详情页重新 Download。下面按入队前 → 下载中 → 失败后 → 日常维护的顺序讲清完整逻辑。下载队列长什么样两个分区、三种按钮打开侧边栏的 Downloads 页面队列分成两个分区界面源码src/pages/DownloadsPage.jsxActive进行中的任务。每张卡片实时显示百分比、速度、分片数如128/352 fragments下方是动态进度条和最新日志行。Local Files已完成的下载 你手动扫描进来的本地视频状态标记为Completed、Error或Local。页面顶部的副标题会实时统计N active · M completed队列规模一眼可见。理解队列关键是把三种按钮的职责分清楚按钮出现在确认实际动作RemoveActive 卡片有终止下载进程清扫临时文件移除队列记录不碰视频DeleteLocal Files 卡片有Delete xxx and its file?删除视频文件 关联字幕 同目录临时残留移除记录View LogError状态卡片无打开该任务完整的日志文件 先记住这张表Remove 管的是正在跑的任务Delete 管的是已经落盘的文件。后面两个章节的所有操作都从这两个入口出发。入队前下载任务如何发起入队路径固定在电影或剧集详情页点Download弹出配置窗口弹窗源码src/components/DownloadModal.jsx。窗口从上到下依次是流地址区顶部标着STREAM URL FOUND展示当前播放页抓到的流地址——这正是下载任务的原料字幕开关打开 Subtitles 后自动搜索并选中默认语言视频完成后字幕以视频名.语言.srt的形式存到同一目录下载器检测显示绿色的✓ Video Downloader found说明二进制目录已就位若路径不对点Wrong binary folder?旁的Change更换保存目录底部Save to: ...同样可点Change切换。确认无误后点红色的Start Download任务立即进入 Active 分区。页面还会自动滚动并高亮闪烁到新卡片约 3 秒方便你确认入队成功。下载中想停为什么没有暂停按钮替代做法是什么先说反直觉的结论Active 卡片上只有 Remove 一个操作按钮暂停功能是刻意不做的设计取舍见 src/ipc/downloads.js。原因是下载任务运行在一个独立的外部下载器进程里支持挂起并恢复需要进程自己具备断点续传能力维护成本远高于收益。Streambert 选择了另一条路不做半途中断但把停做得足够干净。替代做法有两种点 Remove 中断任务先弹二次确认确认后进程被直接杀掉已下载的临时文件.part、.part.tmp、.ytdl等模式被自动清扫磁盘不留半成品关应用时被拦截确认队列里有任务在跑时直接关窗口会触发拦截主进程逻辑见 index.js弹出 N active download(s) will be cancelled and incomplete files will be deleted 的提示。选Keep Downloading取消关闭、任务继续选Cancel Close App则终止所有下载、清理临时文件并退出。⚠️ 注意Remove 和取消并关闭都只清扫临时文件不会删除已完成的视频。想删文件请用 Local Files 卡片上的 Delete。下载失败后如何重试先看自动重试再走手动重发网络抖动时不需要你动手。下载器进程内部自带重试界面只做透传解析逻辑在 src/ipc/downloads.js卡片速度归零日志行变成Retrying… (1/3)说明正在第 1/3 次自动重试重试成功进度条继续推进全程无需操作。三次重试都失败、进程以非 0 退出码结束时任务落入 Local Files 并标记为Error。此时卡片上有两个信息入口错误摘要直接展示从日志中提取的关键报错行匹配error / failed / unable / cannot / denied等关键词加退出码View Log 按钮打开完整日志文件。每次下载独立生成streambert_dl_任务ID.log成功后自动删除失败后保留——这是定位卡在哪一步最快的方式。 排查建议先看日志最后几行。权限或路径类报错就换保存目录超时、连接类报错基本是网络问题稍后再试。手动重试没有一键重跑按钮因为下载依赖详情页里实时的流地址过期地址重发只会再失败。正确流程是 3 步在Error卡片上点标题或海报直接跳回对应的电影/剧集页面卡片已内置跳转重新点播放让页面抓到最新的流地址再点Download新任务会自动顶掉同一条目的旧失败记录——同一部片同一集在队列里只会留一条。 一个容易忽略的点重启应用后正在下载和失败的任务都不会自动恢复。队列持久化只保存Completed状态的记录实现见saveDownloadssrc/ipc/downloads.js进行中和Error的记录启动时即清空需要按上面 3 步重新发起。队列变多之后怎么维护排序、搜索与本地文件扫描排序工具栏支持按Date / Name / Size / Type排序点↓/↑切换升降序偏好自动保存下次打开还在快速搜索按CtrlK或点工具栏的放大镜打开过滤框输入片名即时筛选Esc关闭扫描本地文件在Folder to scan…输入框填路径或点 Browse点⟳ Scan递归扫描最深 3 层目录里的视频文件并入列Untracked 开关扫描进来的非下载文件标记为Local。开关打开显示全部关掉只看你真正下载过的内容开关旁会标注未跟踪文件数量。另外两个维护机制值得知道文件缺失自动清理应用会定期校验已完成任务的视频是否还在磁盘上发现缺失会显示File missing标记并自动把空记录移出队列字幕路径记录同步修剪队列始终反映真实状态字幕独立可补字幕下载与视频主任务互不影响字幕失败不会拖住视频完成。已完成卡片上的字幕语言徽章或No subtitles点开会进入字幕下载器可以换语言、换源补下或管理已下载的字幕。写在最后把这篇指南压缩成五条Active 分区唯一的操作入口是Remove它只杀进程和临时文件不动视频Delete才会删除视频和配套字幕任何删除都有二次确认Retrying… (1/3)是下载器自带的自动重试三次都失败才落Error重发失败任务 回详情页 重播抓流 再点 Download新记录会自动顶掉旧记录进度到 99% 后还要经过Merging…/Processing…转封装阶段才到 100%字幕是可选加餐失败不影响成片。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考