更新记录

未发布

抖音

• 高码率原画自动探测：部分作品的网页详情只给出低码率转码档，例如 7698054262056552561 的 1080p 只有约 0.69 Mbps，但通过 play_addr.uri + ratio=default 能拿到同分辨率、约 6.83 Mbps 的 HEVC 原片。现在下载前会先探测该候选，只有文件更大且实际分辨率、编码符合画质设置时才采用；普通 4K 作品如果该接口只返回 720p，会继续使用原来的最高档，不会反向降画质。设置页「视频质量」和抖音源级过滤设置新增「优先使用抖音高码率原画」开关；默认开启，关闭后不再探测该接口，避免为观感提升有限的视频下载明显更大的文件。

v3.1.5 (2026-10-14)

数据库

• 修复数据库索引建错列名，导致「压缩数据库 / 备份数据库」失败：page 表的状态查询索引 idx_page_status_query 在早前的数据库升级里被错建在不存在的列上（写成了 status，实际列名是 download_status）。SQLite 的双引号兼容行为会把不存在的 "status" 当成一段字符串，于是这个索引变成一个恒真的常量表达式索引——对状态查询完全不起作用，PRAGMA integrity_check 也检查不出来，属于能长期潜伏的问题。更麻烦的是，在较新的 SQLite（以及关闭了双引号字符串兼容的构建）上，解析这个索引会直接报 no such column: "status"，导致设置页「数据库管理」里的 VACUUM 压缩和生成快照备份（VACUUM INTO） 直接失败，自动 VACUUM 也会被跳过。现在索引按真实列名重建；已经升级过的老库会在程序启动时自动修正这个索引，不需要手动操作。顺带补了回归测试，这类「索引列名写错」的问题以后会被测试直接挡住。

Docker / 部署

• 镜像多了版本号标签，方便锁定版本和回滚：发布 v* 标签时，除了原有的 latest，还会额外推送一个与标签同名的镜像标签（例如 qq1582185982/bili-sync:v3.1.5，CNB 同理）。群晖、威联通等 NAS 用户可以把容器固定到某个版本，新版本出问题时直接改回上一个版本号即可，不用再跟着 latest 走。

v3.1.4 (2026-10-04)

B 站漫画

• 新增「漫画」视频源，可贴漫画链接或 mc ID 添加
• 「添加视频源 → 漫画」支持按漫画名 / 作者名搜索
• 整部漫画按「一话一条」列出，一话下载成一个 CBZ（包内附 ComicInfo.xml）
• 每部作品一个文件夹：各话 CBZ + cover.jpg + .nomedia；特典 / 番外放 Specials/，按 SP01、SP02… 编号
• 支持断点续传，中断后只补没下完的页
• 付费 / 未购买章节自动跳过，不会反复报错
• 加密原图（mangaup.hdslb.com + cpx）自动解密后打包
• 详情页内置网页漫画阅读器：单页 / 连续滚动、翻页、页码跳转、进度条、键盘与触屏翻页、全屏（F）
• 漫画与番剧、课程同属 B 站源，共用凭证、筛选、命名模板、通知和任务队列
• 设置新增「漫画快捷订阅路径模板」，添加漫画源时自动带出保存路径
• 设置页「快捷订阅路径模板」六项统一两列

修复

• 漫画话标题带上话号，管理页和详情页能看出是第几话
• 阅读器按窗口大小缩放，整页图不再被截断
• 下载时不再弹出控制台窗口
• 加密页解不开时按页报错，不再把坏数据打进 CBZ
• 抖音 / YouTube / TikTok 视频 NFO 补上 UP 头像（演员缩略图）
• 外源视频在「编辑状态」里把已完成任务重置为「未开始」后会真正重跑（此前媒体会被“复用现有文件”跳过，不重新下载）
• 抖音合集 / 放映厅 / 收藏源的「UP主头像 / UP主信息」重置后能正常重建（此前会报「无法识别 sec_user_id」）
• 外源（抖音 / YouTube / TikTok）视频源互斥：同一个源不能重复添加，重复添加会被直接拒绝并提示已存在；添加源页面里已添加的结果直接置灰显示「已添加」
• UP主投稿源里已下载的视频，B 站后续补上的分P现在能自动发现并补齐下载（此前投稿源只在第一次解析分P，站内 7 个分P本地只有 1 个）

v3.1.3 (2026-10-03)

B 站课程（付费课 / 课堂）

• 新增「课程」视频源：现在可以直接把 B 站课程链接贴进来同步整门课，例如 「https://www.bilibili.com/cheese/play/ss713799843」。在「添加视频源」里把类型选成「课程」，ID 框里既可以粘贴整条课程链接，也可以只填 ss 后面的数字。添加后程序会走课程专用接口拉取全部课时，尚未开播的直播课、回放还在生成的课时会自动跳过，等它们真正上线后下一轮扫描会自动补下。
• 课程课时改用课程专用接口取流：课程的课时 id 走普通稿件接口会直接返回「啥都木有」，现在改走课程的取流接口，并且沿用和番剧一样的画质逐级回退。已购买的账号能正常拿到付费课时的流；没有购买权限的课时会明确报「访问权限不足」，而不是看起来像解析失败。每轮扫描还会在日志里打一行当前账号在这门课上的购买状态，凭证失效时一眼能看出来。
• 课程在媒体库里按普通视频展示：课时沿用现有的单 P 命名规则（UP主目录 / 课时名），封面、fanart、NFO、弹幕、字幕、UP 主头像都会照常生成；弹幕仍然按 cid 抓取，不需要番剧那套专用接口。
• 可以用「搜索 UP 主 -> 勾选课程」的方式添加课程了：在「添加视频源」把类型选成「课程」，直接搜讲师名字（例如「颉斌斌老师」），选中后右侧会列出该 UP 主名下的全部课程（封面、课时数、更新进度、课程 ID），勾选哪门就添加哪门；一门都不勾就按「全部下载」把该 UP 主的课程一次加完。已经加过的课程会显示「已添加」并置灰，不会重复添加；面板上还有「全选 / 取消全选」。
• 不选讲师时仍然可以直接贴课程链接：原来的「课程 Season ID」输入框保留，可以填 ss713799843 或直接粘贴整条课程链接；选了讲师之后这一栏可以留空，添加时会自动使用勾选课程各自的课程 ID。
• 首页「当前监听」把课程算进来了：以前 B 站视频源那一栏只统计收藏夹、合集、投稿、稍后再看、番剧，课程既不在分类格里显示，也不计入「监听源」总数。现在多了「课程」一项（例如 1 / 1），监听源总数也会把它算在内。
• 设置页新增「课程快捷订阅路径模板」：原来只有收藏夹、合集、UP主投稿、番剧四项，课程源没有对应的快捷路径。现在设置页的「快捷订阅路径模板」里多了「课程快捷订阅路径模板」一栏（默认留空，示例写法 /Downloads/课程/）。添加课程源时——不管是用链接直接贴课程、还是搜索 UP 主勾选课程、还是批量添加——保存路径都会按这个模板自动带出来， 会替换成课程名称；模板留空则和以前一样不自动填路径。

推送通知

• 外源的「扫描完成」推送与 B 站源对齐：以前这个推送只统计 B 站视频源，YouTube / 抖音 / TikTok 扫到多少新视频都不会显示；如果整个程序只挂了外源、没有启用任何 B 站源，连推送都不会发。现在两边合并成同一份摘要——扫描视频源数、新增视频数一起算，「最少新增视频数」这个推送门槛也按合并后的总数判断。推送正文会按平台分组（YouTube ▶️、抖音 🎵、TikTok 🎶），视频标题点开直接跳到对应平台的视频页，不再一律指向 B 站。

修复

• 免费课程不再被误报「未检测到购买记录」：B 站课堂里 0 元的课程（「0元抢学」「免费试听」这类）本身就没有购买记录，user_status.payed 恒为 0，程序原先只看这个字段，于是每轮扫描都刷一条「当前账号未检测到购买记录……付费课时将无法取流」的黄色告警，看着像凭证失效、课程下不了（其实整门课都是免费的，课时能正常取流）。现在会先看课程价格：价格为 0 的按免费课处理，日志改成一条「为免费课程（价格 0），无需购买，全部课时可直接取流」的普通提示；真正的付费课（例如 188 元的全程班）在未购买时仍会照常告警。

• av 形态的视频 ID 不再让 NFO 生成失败：课程没有 BV 号，程序用 av<aid> 占位，而 NFO 校验原本只认 BV 开头，于是课时下载完成之后会在「详情」这一步报 Invalid NFO data 并把整条视频判为失败。现在 av 形态同样被接受。

• 没有 BV 号的内容不再带着 bvid 去请求字幕接口：字幕接口收到 bvid=av... 会返回 -400 请求错误，现在没有真实 BV 号时只传 aid + cid，字幕子任务不再无谓失败。

• 按「课程」视频源筛选不再失效：视频管理页的「筛选 → 按视频源筛选」里能列出课程源、点下去也会出现「当前筛选」标签，但列表实际没有过滤——点某一门课，列表照样显示全部视频（例如 21776 个），看起来像筛选功能坏了。原因是只有收藏夹 / 合集 / UP主投稿 / 稍后再看 / 番剧的源 ID 会发给后端，课程源的 ID 在拼请求那一步被丢掉了。现在课程源 ID 会正常带上，后端也按课程源过滤，列表只剩这门课的课时；「按当前筛选批量重置」同样生效（以前会把所有视频一起重置）。

• 不再让人猜「为什么没推送」：如果某一轮确实没有新增视频（没达到设置的推送门槛），普通日志里会明确写一行「本轮新增视频 0 个，未达到推送阈值 1，跳过扫描完成推送」，而不是默默不发。

• 每轮扫描日志把外源一起算进来，并且写平台名：以前每轮结束的日志只统计 B 站源，明明抖音这一轮已经扫到并下载了新作品，日志还是写「成功扫描 15 个视频源（均无新内容）」，看着像漏扫了。现在每轮汇总把 B 站和各平台分开列，例如「本轮扫描完成 - 视频源数量: 22（B站 15 + 抖音 7），新增作品: B站 1 个、抖音 2 个」；抖音扫到新作品的日志也会写清是哪个源、几条，例如「抖音视频源「001」发现 2 个新视频」，不再只写一句「发现新作品」。推送那边用的是同一份计数，日志和推送不会再对不上。

• 修复外源 UP 头像偶发下载失败：多个视频同时下载时，会同时往同一个临时文件里写 UP 头像、UP主信息文件和剧集信息文件，先完成的一方把文件改名走了，另一方读到的就是 0 字节，于是报「断点续传后文件大小不一致: 0 != 1801」，把这几个子任务判成失败。现在每个任务各用各的临时文件，互相不再干扰；失败时也会把断点续传留下的状态文件一起清理，共享目录里不会攒下残渣。

• 日志降噪：B 站刚发布的视频，第一个 CDN 节点往往还没同步，第一次取分片会 404、程序换一个备用节点就下成功了——这属于正常切换，以前日志里会留一条红色「HTTP状态码错误」加一条黄色「下载资源失败」，看着像出故障。现在这类能自己好的单次失败只写进调试日志；真正所有直链都取不到时仍会照常告警。

• 抖音图文里的视频片段不再丢失：有些抖音图集是「视频 + 图片」混排（作者在最前面放了一段 live photo 或短视频，后面跟着几张图）。以前程序只抓图片，开头那段视频会被整段跳过，看起来就像作品被截了一段。现在作品里的每一段都按原顺序下载：图片段仍存成 01.jpg、02.jpg…，视频段存成同序号的 01.mp4，然后把各段按顺序合成到一个 MP4 里（图片段每张 3 秒、视频段按原速），中转片段用完即清。某一段视频实在取不到时，会退回用这一段的封面静图顶替，整篇作品照常能播放。整篇都是视频片段的图集（例如只有一段 live photo）以前会被当成普通视频、跟着下载失败，现在也能正常下载。注意：之前已经下好、少了开头视频段的旧图集不会自动重下，需要在这一条视频上点一次「重置」，它才会按新逻辑重新下载并合成。

• 「多段视频」作品单独标出来，不再看着像原图丢了：有些抖音 / TikTok 图集整条都是视频片段（比如一条 live photo，或者多段视频拼在一起），本来就没有原图。以前它在卡片上和普通图文一样显示「图文」徽标，点进详情页还会出现一个灰色的「图片尚未下载」按钮，看着像下载失败。现在这类作品在卡片上显示紫色的「动态」徽标，详情页不再显示图片按钮，而是直接说明「本条作品由多段视频组成」，点「播放视频」看合成好的完整视频即可；带原图的图文作品仍是原来的「图文」徽标和「查看图片」按钮。

• 修复 TikTok 图文作品的图片、封面打不开：TikTok 的封面和图文原图是浏览器直接加载的（不带登录凭证），而后台免登录名单里只放行了抖音，导致 TikTok 图文作品点开全是裂图，日志里刷「图片下载状态码错误 401」。现在 B 站、YouTube、抖音、TikTok 的封面与原图统一放行，TikTok 的图文原图和封面都能正常显示。

• 多段动态作品不再被合并成一条长视频：抖音图集里每一段视频（live photo、多段动态）现在各自存成一个独立视频，按作品名加 P01、P02… 编号，视频管理页点每一段的「播放视频」就能逐段切换、想看哪段看哪段。以前它们会被强行合成一条长视频，既慢又看不出原来有几段，整篇都是动态的作品还会被塞进一堆静止画面。升级后请对已经下过的多段动态作品点一次「重置」，它会按新规则重新落成多个视频。

• 「动态 + 图文」的作品，播放视频播的就是那段真实视频：这类作品以前点「播放视频」播放的是程序合成的幻灯片（静止图 + 配乐），看着像视频丢了；现在播的就是作品里那段动图视频，几张原图仍然在「查看图片」里，各自独立。

• 多段动态的每一段在媒体库里也都能正常显示：每个分段都会生成自己的封面、fanart 和 NFO，Emby / Jellyfin 里不会出现只有第一段有封面和简介、其余都是空白条目的情况。

• 修复老视频弹幕被反复重复刷新：开着「弹幕增量更新」时，发布时间超过冷冻期天数的老视频本该在补刷最后一次之后彻底停下来，但这个「已冻结」标记没写进数据库，程序每轮扫描都以为还差最后一次补刷，于是这些老视频的弹幕被一轮一轮重复拉取，日志里刷满「弹幕已刷新 -> 阶段=老化期」。有位用户三天里被刷了二十六万多次，涉及两千多个视频、一万两千多个分页，B 站请求也跟着一直被消耗。现在调度和写回保持一致，到点补刷最后一次后就标记「已冻结」，之后不再轮询；同时这最后一次补刷也要等满老化期的刷新间隔，不会刚刷完下一轮又刷一遍。升级后不用做任何操作，正在被反复刷的源会自动安静下来，之前卡在「老化期」的分页会在间隔到点后补刷最后一次再冻结。

外源命名

• 外源的文件夹名不再又长又乱：抖音 / TikTok / YouTube 的作品标题里往往塞着一大串话题标签、多行署名和「回复 @某人 的评论」，以前这些会原样变成文件夹名字，一个文件夹名能拖到六十多个字，看着又长又乱。现在生成文件名和文件夹名时会自动清理：只取标题第一行（后面的曲编、歌手、混音等署名不进名字）、去掉所有话题标签、去掉评论回复前缀，剩下的正文照原样保留。媒体库里显示的标题仍是平台完整原标题，不受影响。文件名、文件夹名的长度上限与 B 站完全一致（同样按 200 字节一段截断），不会出现超长目录。
• 存量的旧文件夹不会被改名：这次只影响之后新下载的作品，已经下载好的目录原样不动，不会重复下载，也不会被批量重命名。
• 想要完整原标题做名字也能用：命名模板里新增了「完整原标题」变量（title_full，仅外源可用），不做任何清理；默认的标题变量对抖音 / TikTok / YouTube 已经自动清洗过。

v3.1.2 (2026-09-20)

• 修复抖音视频成批下载失败（HTTP 403）：抖音最近把「作品详情」接口也纳入了新版风控校验，旧的签名会被直接拒绝。表现是：新添加一个抖音源，里面的视频成批下载失败，每个都重试几次后停在失败，日志里反复出现「抖音原生详情接口失败：抖音 Web API 返回 HTTP 403 Forbidden」。现在这个接口和「作者作品 / 我的喜欢 / 收藏夹」一样改用官方签名，连续请求能稳定通过。升级后请把之前失败的那批视频重置一次，它们会重新下载。
• 修复抖音偶发「缺少签名会话」导致的下载失败：多个视频同时下载时，程序会同时改写同一份签名会话文件，另一个下载任务偶尔读到写了一半的文件，于是报「缺少抖音 secsdk 签名会话」并判定下载失败——其实凭证明明是好的。现在会话文件改为安全写入，并发下载不再互相干扰；即使签名当场失败，也会自动退回旧签名尽力尝试，不再直接判死。
• 修复外源下载失败后卡片状态不对：YouTube / 抖音 / TikTok 的视频重试次数用满、已经放弃后，卡片右上角一直显示灰色的「进行中」，看不出它其实已经失败了。现在与 B 站保持一致，显示红色的「部分失败」，一眼能看出哪些视频需要处理；点重置后也会正确重新排队下载。
• 修复 Docker 镜像发布失败：镜像构建时被其中一个镜像仓库拒收，导致整次发布判失败、镜像没能完整推送。现已修正，Docker 镜像可正常发布。

v3.1.1 (2026-09-17)

v3.1.0 之后连续推送的几次更新都还是测试版、没有正式发布版本号，这里合并成一条 v3.1.1。

抖音

• 修复添加抖音源时「关注的 UP」历史选择窗口频繁报 403：以前选完关注的 UP 后，历史选择窗口经常提示「抖音 Web API 返回 HTTP 403 Forbidden」，作者扫描也一样。现在只要之前用电脑端登录助手同步过一次登录状态，历史选择和作者扫描都能稳定通过。
• 只导入 cookies.txt 也能继续用：没同步过签名会话的用户，作者作品接口仍会尽力按旧方式请求，不会直接报错；如果频繁被平台拒绝，会提示用电脑端登录助手完整传输一次登录状态。

TikTok

• 修复图片作品（幻灯片）下载失败：TikTok 上有的作品不是视频，而是一组图片配一首背景音乐（左右滑动看图的那种）。以前会被当成普通视频解析，因为没有视频流，每次都会下载失败、重试几次后停在失败状态。现在会把全部原图下载到作品目录、配上原声合成一个能正常播放的幻灯片视频，封面、简介、演员信息一并生成，Emby/Jellyfin 里和普通视频一样显示。升级后之前失败的这类作品会自动重新下载，不需要手动点重试。
• 修复 UP 头像一直下载失败：以前 TikTok 视频源的作者头像始终取不到，日志里反复出现「TikTok 作者作品接口没有返回头像地址」。现在头像和人物信息文件都能正常生成。已经下载过的视频，可以在视频详情的「编辑状态」或列表的「批量重置」里重置「UP头像/UP主信息」重新生成，不用删文件重下。
• 图片作品不再强制要求登录：公开作者的图片作品在没导入 TikTok 登录状态时也能正常下载；视频类作品仍建议保持登录，解析更稳定。
• 媒体已被平台移除的作品不再反复失败：TikTok 上有一类作品，平台只保留了标题、作者、播放量，视频和封面在服务端已经被摘掉——自己在浏览器里打开这条作品，播放器同样是一直转圈、画面全灰。以前程序把它当成普通下载失败，每轮扫描都重试一遍，日志里反复出现「媒体直链解析失败」。现在这类作品会先按普通失败正常重试两次（万一是换了出口节点就能取到），第三次依然取不到时才按「无法下载视频」处理：生成占位文件、卡片左上角显示明黄色的「无法下载视频」标签，并停止自动重试。换到别的节点、或作者后来恢复了作品，在视频管理页对该视频点「重置」就能重新探测，不会因为一次判定被永久跳过。

设置 / 配置

• 修复命名模板填错导致整份配置失效：如果命名模板（如“单P文件名模板”）里填了本程序不支持的写法——比如在 pubtime 变量后面用竖线 | 跟一个日期格式（这是其它模板引擎的习惯写法）——程序启动时整份数据库配置（下载路径、时间格式、视频质量等）都不生效，看起来像设置全丢了。现在某一条模板写错只会让这一条自动回退成默认模板并明确提示错误原因，其它配置照常加载，程序不会再用不了。
• 保存时直接提示正确写法：在设置页保存命名模板时，语法不合法会直接提示并拒绝保存，不再把坏模板写进配置。模板里 pubtime / fav_time 这类时间变量的日期格式统一由设置页「时间格式」控制——例如想要 2026-09-09 - UP主 - BV号 这种效果，应把「时间格式」设为 %Y-%m-%d，模板里正常写 pubtime - upper_name - bvid 这几个变量，不要在变量后面用竖线直接跟日期格式。

v3.1.0 (2026-08-22)

• 修复升级后外源全部变成未下载：外源视频改为 B 站式子任务状态位后，升级只会给状态已经是「已完成/已跳过」的视频补状态位；以前因为中断、重置等原因状态停在「等待中」、但实际已经下载完成的老视频，升级后会被误判成未下载并整库重新下载。现在升级时会分两种情况补回状态位：① 媒体文件仍在盘上且 NFO 已生成（说明完整下载成功过）→ 标为已完成；② 媒体文件已被移走/替换成网盘 .strm 播放文件、但 NFO 仍在媒体库（旧版只有整条下载成功才会写输出路径，NFO 在说明这条曾完整下载过）→ 同样标为已完成，不会因为升级去重复下载已被移走的视频；媒体与 NFO 都被删除（用户主动重置等待重新下载）的行不会被误标。文件缺失、下载中断留下的半成品、以及正在下载中的行不会被误标，仍按原逻辑续传或重新下载。

• 外源子任务状态位（对齐 B 站）：YouTube/抖音/TikTok 视频之前只有一个整体下载状态，视频详情「编辑状态」或列表「批量重置」重置“视频信息/NFO”时不会真正重新生成文件，反而会把整条视频打成待下载——媒体被移走的已完成视频会重新显示“未下载”。现在外源视频增加与 B 站完全相同的子任务状态位（封面 / 视频信息 / UP头像 / UP主信息 / 分P下载，分页另有一组），重置只把对应子任务打回“未开始”，下载任务按位只重跑该子任务（重新解析平台元数据并重建文件），不会重下媒体、也不会动已完成的分P下载；只有重置“分P下载/视频内容”才会整条重新下载。升级后旧数据库自动增加字段并回填状态。

• YouTube 联合投稿演员补全：联合投稿（多人合作上传）视频的 movie.nfo 之前只写了主频道一个演员，合作频道全部缺失，媒体播放器里演员列表不全。现在会自动读取 YouTube 的联合创作者名单，把主频道和所有合作频道逐个写进演员列表；单作者/普通音乐视频不会误加重复演员。已下载的视频可在视频详情的「编辑状态」或视频列表的「批量重置」里重置「视频信息」，程序会自动重新生成 NFO（封面/UP头像/UP主信息同理），无需手动删文件或重新下载。

• 新增 YouTube 视频源：可以添加 YouTube 频道、播放列表、收藏夹、稍后再看等作为同步源，自动下载新视频。登录状态用「外部平台登录助手」一键同步，或用浏览器导出的 cookies 导入，程序会自动维护登录状态不掉线；可以单独给 YouTube 配置网络代理。Docker 部署开箱即用，不需要额外安装组件。

• 新增抖音视频源：支持作者搜索、关注列表、我的喜欢、收藏夹、系列短剧、放映厅、稍后再看等完整视频源。系列内容按 B 站式分集目录整理，自动生成封面和简介（NFO），方便 Emby/Jellyfin 识别；付费视频不再下载无法播放的文件，显示「付费」标记；扫描节奏经过优化，减少触发平台风控。

• 新增 TikTok 视频源：支持收藏夹、我的喜欢、关注列表、作者历史视频等。收藏夹不用填链接就能直接选自己的列表；关注/喜欢/收藏请求自动处理平台的签名和风控，稳定可用，也可以走外源代理。

• TikTok 登录与会话：支持用电脑浏览器一键同步登录状态（不用手动复制 Cookie）；也支持远程浏览器会话读取关注/喜欢列表；没有浏览器环境时自动改用服务端直连，还可以手动填账号 ID。

• TikTok 下载修复：适配平台最新接口，下载失败会自动换方式重试；明确无法下载的视频显示占位提示，不再静默失败；封面过期自动刷新；手机/窄屏下内嵌播放不再错位遮挡。

• 抖音播放体验修复：取消抖音在线播放（官方播放器没法隐藏信息条），保留本地播放；内嵌播放适配手机窗口大小；图文视频点播放后不再残留图片。

• 外部平台管理统一：YouTube/抖音/TikTok 与 B 站共用同一套添加、删除、下载流程，操作一致；修复外部平台登录状态同步失败的问题。

• 外源重设路径修复：YouTube/抖音/TikTok 重设路径时改为与 B 站共用同一套逻辑——移动文件后正确显示实际移动数量，并自动清理旧路径遗留的空文件夹，不会再出现「提示移动 0 个但文件其实已经搬走」的情况。

• TikTok 封面加载修复：TikTok 封面直链带签名会过期，过期后不再刷 ERROR 日志、也不再误报「出口被风控」（实际是官方详情接口需要浏览器 BotGuard 验证）。过期封面会自动改用第三方解析服务刷新直链并缓存；作者源扫描时也会同步刷新已存在视频的封面直链。本地已有封面时始终优先使用本地封面，只有未下载成功的视频才回源显示。

• TikTok 作者源只收录一页修复：TikTok 官方作品接口最近不再返回翻页游标，导致作者源只收录最新一页（约 15 个）视频。现在自动改用发布时间作为翻页游标，可完整收录作者全部历史视频；已添加的作者源如需补全历史，删除后重新添加（或开启「扫描已删除视频」）即可。

• B 站扫描稳定性修复：修复个别异常视频导致整轮扫描中断的问题，遇到异常自动跳过继续；启动扫描更快，日志输出更稳定。

• 首页与添加源界面优化：首页监听状态按平台切换显示；添加源界面文案统一、切换后不残留旧数据。

• 最低分辨率过滤：B站/YouTube/抖音/TikTok 的视频未达到设置的最低清晰度时自动跳过，不再下载低清文件；被跳过的视频标记为“已跳过”而不是报错。

• 未达最低下载标准提示：被跳过的低清视频在视频管理卡片左上角显示黄色「未达到最低下载标准」标签，详情页和播放页同步提醒。

• 抖音我的喜欢/收藏夹修复：修复抖音「我的喜欢」「收藏夹」被平台风控导致拉不到列表的问题，现在稳定可用。

• 抖音收藏夹支持搜索 UP 主：添加抖音「收藏夹」源时不用再手填链接，输入 UP 昵称、抖音号或主页链接即可搜到对方公开的收藏夹，点选后自动填入名称和链接；获取他人公开收藏夹走移动端接口，不依赖登录 Cookie，Docker/群晖等新环境也能直接使用。

• YouTube 下载画质修复：修复 YouTube 视频最高只能下到 1080p 的问题（部分高码率源改用 SABR 协议后 web 客户端不再返回签名直链）。媒体解析新增 visionos 客户端兜底（需要 yt-dlp ≥2026.08.19），这类源现在能拿到最高 4K 的签名直链，按清晰度设置可正常下载 4K；yt-dlp 版本过旧时程序会自动重新下载最新版（优先走外源代理，代理失败自动回退直连，且升级失败不影响当前任务）。

• YouTube 高画质 VP9 兜底：部分 YouTube 视频的 1440p/4K/8K 只有 VP9 编码，而编码偏好列表默认不含 VP9，导致这些视频下载时拿不到最高画质。现在当偏好编码（AV1/HEVC/AVC）无法达到更高分辨率时，会自动放行 VP9 保证最高画质；同一分辨率下仍优先使用您选择的编码，不会破坏设备兼容性。命中兜底时会记录日志说明。

• YouTube/抖音/TikTok NFO 工作室字段修复：外部视频的 movie.nfo 里「工作室（studio）」标签之前误填成了上传日期（如 2026-09-01），「首播日期（aired）」反而填成了平台名，导致媒体播放器里显示「工作室：2026-09-01」这种错误信息；且 TikTok 视频的工作室会被误写成「YouTube」。已修正为：工作室=平台名（YouTube / TikTok / 抖音），首播/播出日期=实际上传日期。已下载的视频需要重新生成一次 NFO（视频信息重置或重新生成 NFO）才会更新。

• 数据库恢复：数据库管理页新增备份列表与一键恢复——选择备份并确认后，重启 bili-sync 即自动替换当前数据库；恢复前自动保留一份当前库快照（data.sqlite.pre-restore-*）便于回滚，并校验备份文件有效性，防止误恢复损坏文件。

• 数据库管理：设置页新增「数据库管理」入口，可查看数据库文件路径、大小与各表数据量统计；支持清理图片代理缓存、AI 对话历史、任务队列历史与孤立记录（来源已删除的 YouTube 视频、无主分P），执行 VACUUM 压缩释放磁盘空间，以及生成数据库快照备份（不锁库、不影响运行）。

• 首页数据面板完善：当前监听 TikTok 页签显示「我的喜欢」「收藏夹」统计；入库概览图表按 B站/YouTube/抖音/TikTok 四平台分组展示；最新入库/最近处理弹窗支持按平台切换，每条记录带平台标识。

• 抖音登录状态同步完善：电脑端登录助手「传输抖音登录状态」现在会同时同步「我的喜欢」「收藏夹」接口签名所需的会话密钥（含浏览器 IndexedDB 中的安全会话），Docker/群晖 等新环境重新导入后即可正常使用「我的喜欢」「收藏夹」；仅手动导入 cookies.txt 时页面会提示需用登录助手完整同步。

• 配置目录可自定义：新增环境变量 BILI_SYNC_CONFIG_DIR，可覆盖默认配置目录，方便多实例部署、Docker 迁移配置或隔离测试环境（不设置时行为与之前完全一致）。

• 外部平台登录提示优化：YouTube/抖音/TikTok 登录面板不再显示 Cookie 临时文件路径，统一提示凭证已保存到数据库、重启不丢失；导入与登录状态相关提示改为“登录凭证”表述，签名器错误不再暴露临时目录路径。

• 清理旧日志：数据库管理页新增「清理旧日志」按钮，确认时可自由设定保留天数（1-365 天），删除保留期以外的日志文件释放磁盘空间，当前正在写入的日志不受影响；启动与每轮轮转时的自动清理策略同步改为保留最近 7 天。

• 外部平台凭证入库：YouTube/抖音/TikTok 的登录凭证（cookies、secsdk 签名会话、msToken/webid/verifyFp、TikTok localStorage 与手动 secUid/设备 ID）从配置目录的单独文件改为保存到数据库，升级后旧文件自动迁移入库并删除，重启不丢登录状态，Docker/群晕 等环境不再依赖卷里的凭证文件；给 yt-dlp/签名器的真实文件由程序在系统临时目录动态生成。

• 数据库恢复支持导入外部备份包：数据库管理页可直接选择其他电脑导出的 .sqlite 备份文件上传并恢复（重启后生效）；外部备份会保存在本机备份列表中并标记「外部导入」，之后可再次选择恢复。

• 抖音「日常」作品支持：抖音作者源扫描时会自动把作者最近 7 天的「日常」（story）作品一并入库，不用额外配置；日常作品在视频管理卡片左上角显示青色「日常」标签，图文类日常会同时显示「图文」和「日常」两个标签。

• 抖音日常图文下载修复：日常作品在抖音属于独立数据空间，普通详情接口查不到，之前会导致日常图文下载失败。现在下载时会自动改用移动端日常接口获取原图与配乐，日常图文可以正常下载并生成可播放的幻灯片视频。

• 抖音收藏夹源扫描修复：抖音部分收藏夹是「仅自己可见」的，匿名读取会返回“状态码 4”，导致这类收藏夹一直扫不到新视频。现在扫描时会自动用已导入的抖音登录状态重试，私密收藏夹也能正常同步；没导入登录状态时会给出明确提示。

• 媒体下载断点续传：B站等多平台大文件下载支持断点续传——并发分片下载中某个分片失败、或下载中断后，已完成的分片会记录在临时文件旁的 .resume 状态文件中，之后重试（包括刷新直链后的重试）会从断点继续，不再整文件从头下载；并发分片失败后自动改为顺序补下未完成分片，CDN 掐流也能稳定下完。

• 修复音频下载失败误删视频文件：之前音频流下载失败时会异步删除已下载完成的视频临时文件，可能与新一次重试下载产生竞态、误删刚下好的文件导致页面反复失败；现在保留已下载的视频文件，重试直接续传，同时不再因分片重试刷屏大量警告（改为 debug 日志）。

• 外源扫描提速与稳定：之前 YouTube/抖音/TikTok 的「我的喜欢」「收藏夹」「稍后再看」每轮都从第一页翻到最后一页，视频多时会很慢还容易触发平台限流；现在翻到整页都是已收录视频就提前停止（增量扫描），扫描时间大幅缩短；用 yt-dlp 扫描时加了连接超时和重试次数限制，网络不好时单个源不会再卡住整轮扫描。

• 首页下载进度显示：首页「下载任务状态」里新增实时「正在下载」卡片，能看到正在下载的视频——进度百分比、已下载/总大小、实时速度、剩余时间和当前阶段（下载视频流/下载音频流/合并中等），进度平滑刷新不用干等；B站视频精确到字节，YouTube/抖音/TikTok 显示阶段与状态。卡片默认只显示当前正在下载的一个任务，右上角「⋯」按钮可展开查看全部正在下载的视频。

• B站收藏夹更新修复：之前收藏夹里收藏了「视频合集」后，整个收藏夹会被 B站接口过滤、扫不到任何视频；同时已收藏的多P视频新增分P时不会同步下载。现在收藏夹接口改为带 platform=web，含合集的收藏夹也能正常扫描；收藏夹只同步「收藏的视频」本身，合集条目不再展开成几十集全部下载（合集分集请单独添加合集源）；已收藏的多P视频每轮限量抽查分P数（不会一次拉太多触发风控），发现 UP主 新增分P 就自动重新拉取详情并下载新分P，不用手动操作。

• 外源视频文件移动后任务状态保持完成：已下载完成的 YouTube/抖音/TikTok 视频，即使媒体文件被手动移走或清理，视频管理卡片仍显示「全部完成」，与 B 站行为一致，不会再错误变回「进行中/未开始」。

• 单P/分页命名模板变量说明补全：设置页「文件命名」的变量说明补齐 、、、、、、 等单P/多P模板都可用的字段，避免误以为单P不支持这些变量。

• 多P视频文件夹 AI 重命名：多P视频独占文件夹（如「UP主/视频标题」结构）现在会跟随 AI 重命名，文件夹名与内部分P文件名风格统一；自动跳过被多个视频共享的目录（UP 分组、合集统一目录等）避免改乱路径；Season 结构下只重命名视频文件夹本身，不触碰 Season 子目录；重命名后自动同步数据库中的视频与分页路径。抖音短剧/放映厅/合集等按 S01E01 结构组织的剧集源保持结构不变，不再被 AI 重命名破坏 Season 目录。

• AI 重命名按视频类型返回对应文件名：多P、番剧、合集等按结构组织的视频，AI 现在会按文件数量一一对应地生成文件名（第几个文件就给第几个名字，不打乱、不合并、不漏一个），多P/番剧的序号（P1/P2、S01E01）会完整保留，方便区分同一视频的不同分P/剧集；发送给 AI 时也会标明当前视频是单P、多P还是番剧，以及使用的目录结构，让生成的风格与目录一致。

• AI 重命名保留命名模板变量：AI 重命名后会自动按各类型命名模板把缺失的变量内容补回来——单P 文件名和文件夹名会重新附加上 BV 号和发布时间（按「单P视频文件名模板」，默认 - 格式），不再被 AI 结果覆盖清除；多P 保持多P视频模板规则（P1/P2 序号不丢），番剧保持番剧模板规则（S01E01 序号不丢）。AI 名字里已经包含的变量不会重复附加；模板中没配置的变量不会强行加。

• 未达最低下载标准视频清理空文件夹：被跳过低清视频残留的空视频文件夹会自动删除；如果上级 UP 目录下没有文件也没有子文件夹，UP 目录本身也会一并清理，直到视频源根目录为止。清理只针对空目录，目录内还有其他视频文件时不会误删。

v3.0.9.5 (2026-07-19)

• 番剧 NFO 重置和锁定修复：批量重置“视频信息”会同时重置番剧根目录 tvshow.nfo、季度 season.nfo 和单集 NFO，不再只重置单集；番剧单集 NFO 不再重复写整季简介，媒体 NFO 会写入 <lockdata>true</lockdata>，减少 Jellyfin 回写旧元数据导致的重复标签。
• 下拉框和抽屉暗色闪烁修复：设置页、添加视频源、视频源管理、视频列表和日志页的原生下拉框改为自绘下拉，避免深色主题下打开瞬间出现系统白框；抽屉和弹窗会在首帧就使用当前主题背景，减少打开时的浅色闪烁。
• 下拉框定位和交互修复：自绘下拉改为贴着按钮的内联锚定方式，窗口移动、抽屉滚动或弹窗内操作时不会再漂移、跳位，也不会被抽屉/弹窗的焦点限制拦截，鼠标可以正常选择选项。

v3.0.9.4 (2026-07-11)

• 充电视频可按视频源关闭下载：添加视频源和视频源管理页新增“下载充电视频”开关；关闭后该源识别到的充电专享视频只保留元数据，不下载媒体或占位文件，视频列表和批量重置也不会再显示/处理这些被禁用源下的充电视频。
• 视频源级码率设置：视频源管理页和添加新视频源页面都可以给单个合集、UP 主投稿、收藏夹、稍后观看或番剧源单独设置视频/音频质量、编码优先级以及杜比、HDR、Hi-Res 过滤；未单独设置时继续继承全局视频质量配置，批量添加时也可以把同一套源级规则应用到本次新增的所有源。
• 仅音频封面内嵌修复：仅下载音频时会把封面写入 .m4a；开启分章下载后，每个切分出的章节音频也会补写封面，避免只有第一个章节有封面。“仅保留 M4A”模式会临时下载封面用于内嵌，完成后自动清理临时图片。
• FLAC 音频封面内嵌兼容：检测到 B 站无损音频这类 FLAC 流但文件扩展名为 .m4a 的场景时，封面内嵌会改用 MP4 封装器，避免 ffmpeg 因 ipod 封装不支持 FLAC 而对每个分P刷警告。
• 大源保护补充分P判定：少量视频但超多分P的投稿源现在也会按分P阈值触发大源下载保护，下载阶段继续限制并发和 playurl 频率，避免因分P量大但视频数不够而未进入保护。

v3.0.9.3 (2026-07-04)

• B站 AI 字幕下载：视频源可单独开启/关闭 B 站自动生成的 AI 字幕，并设置优先语言，默认中文；目标语言没有 AI 字幕时会回退中文，同语言下仍优先保留人工字幕，避免同名 .srt 被覆盖。
• 下载风控与大源续传更稳：下载阶段遇到 playurl 412 这类请求过快风控时，会按当前视频源记录冷却断点并递增退避；冷却期间仍会刷新远端列表保证新投稿入库，但跳过详情补全和下载，避免每轮反复撞风控。超大 UP 主投稿源默认按 1000 个视频启用下载保护，视频数不限制、分页上限 2000、下载并发保持 1、playurl 默认 1 次/秒，未进入本轮预算的视频不会写成完成断点，下轮继续处理；失败重启时会递归检查已有 Season 分P和文件，未下载完成则优先复用原目录，不再误判同名冲突后反复追加发布时间和 BV 号后缀。

v3.0.9.2 (2026-06-25)

• 长标题路径截断更稳：文件名安全化的单段长度保护从 100 字节放宽到 200 字节，并在截断后再次清理末尾英文点号，避免长中文标题刚好截到 .. 结尾时 Windows 创建封面或目录失败。

v3.0.9.1 (2026-06-22)

• UP 主投稿增量扫描修复：修复投稿源发现新视频时，分页运行断点被误当成断点恢复、选择性下载过滤后水位不推进的问题；扫描时间比较统一使用北京时间 NaiveDateTime，不会再因为 UTC 混用或旧水位导致有新投稿的 UP 主每轮扫到底。

v3.0.9 (2026-06-11)

• 新增分章下载：视频源可以单独开启“分章下载”，下载后会按 B 站章节生成独立视频或音频；多P/合集的 Season 目录、集数编号、NFO、封面、弹幕这些配套文件会一起处理好，也可以和“仅下载音频”“仅保留 M4A”“平铺目录”一起使用。

v3.0.8.6.1 (2026-06-16)

• DeepSeek Web 免费改名重新可用：DeepSeek 网页端改了前端文件地址和会话返回格式，导致程序下载不到 POW 用的 WASM，或者创建会话时直接报“响应体解码失败”；现在会自动识别新的 WASM 地址，也能兼容新的会话返回结构。
• DeepSeek Web 请求更贴近网页端：请求头更新到当前网页端版本，并要求返回普通文本流，减少 SSE 响应被压缩后读取失败的情况。
• 日志里不再直接打印敏感配置：配置加载失败或调试日志里会把 token、API Key、Cookie、Webhook 这类内容脱敏，避免排查问题时把敏感信息贴出来。

v3.0.8.6 (2026-06-04)

• NFO 时间选择不再假生效：设置里选“收藏时间”或“发布时间”后，后面生成出来的 NFO 会真的按这个选择写时间，不会再出现页面显示保存了、文件里还是旧时间的情况。
• NFO 会写入更具体的时间：以前很多媒体库只能看到日期，现在 NFO 里会多写一份带“几点几分几秒”的时间，按时间排序和识别会更准。
• 多 P 视频的总 NFO 也会跟着刷新：切换收藏时间/发布时间后，不只是单 P 和分集会更新，多 P 视频目录里的总 NFO 也会一起重做，不会再残留上一次的时间。
• AI 改名后的文件名更干净：AI 返回的名字如果还有中文括号、多余空格、问号、冒号、结尾横杠这些问题，程序会再兜底清一遍，减少文件名看着乱或者 Windows 不好保存的问题。

v3.0.8.5 (2026-05-28)

• 自定义源名称不再被改回接口名：修复合集、收藏夹和 UP 主投稿源在扫描时，会把用户手动改过的显示名称重新覆盖成 B 站接口返回名称的问题；现在已有源会保留本地自定义名称，只同步保存路径等必要信息。
• 文件命名可以先预览：设置文件名模板时，页面会直接预览最后生成出来的视频文件名，每行一个 .mp4，不用保存后再猜会下载成什么名字。
• 改文件名模板后不会把视频路径记成 NFO：以前文件名从标题改成 BV 号这类模板后，重命名时可能把 .nfo 当成视频文件记进数据库，导致后面继续处理文件时出错；现在只会把真正的视频文件记进去。
• DeepSeek 改名不再空响应误报：AI 重命名使用 DeepSeek 付费 API 时，会关闭不需要的思考模式，避免模型只返回推理内容却没有给出文件名 JSON，导致批次报“解析 JSON 数组失败”。
• 自动续登确认更稳：刷新 B 站 Cookie 时，会固定用刷新前的 ac_time_value 完成确认，再保存接口返回的新凭据，避免新旧刷新口令混用导致自动续登失败。

v3.0.8.4 (2026-05-26)

• 单P文件名模板重新生效：修复 v3.0.8 后单P视频即使配置了“单P视频文件名模板”，下载出来仍只用标题命名的问题；现在会按设置里的日期、BV号、标题截断等模板生成视频、NFO、弹幕、字幕和封面文件名。
• 应用文件名模板不再乱追加目录后缀：修复手动应用文件名模板时，已经正确的父目录被误判为同名冲突、反复追加“完整发布时间-BV号”后缀的问题；真正同标题视频的目录去重规则仍会保留。

v3.0.8.3 (2026-05-16)

• 自动续登不再乱报过期：每天 1 点会直接跑完整的 B 站登录刷新流程；如果只是网络断了、请求超时，或者 B 站临时抽风，不会再提示“登录过期、请重新扫码”，而是提示“凭据自动刷新暂时失败”。
• 设置页可以手动测续登：B 站凭据那里新增“测试刷新”和“强制刷新”，可以直接看刷新卡在哪一步；强制刷新会真的跑完整个续登流程，方便排查到底是网络、B 站返回，还是登录信息本身有问题。
• 续登时间按 B 站为准：刷新登录信息时会尽量用 B 站给的时间，不再完全依赖本机时间，减少电脑时间不准导致刷新失败的情况。
• 添加源搜索先走原来的方式：添加视频源时，默认仍先用原来的搜索接口；如果这个接口被 B 站拦住或返回内容不对，再换网页端的新搜索方式兜底。
• 搜索会带上登录信息和指纹：搜索请求会带上已经配置好的 B 站登录信息和浏览器指纹，减少像无痕浏览那样没有指纹导致被 412 拦住的问题；如果带了以后还被拦，会明确提示是 B 站风控。
• UP 主搜索结果能拉全：搜索“小王纸”这类 UP 主时，不再只显示第一页，会按 B 站返回的实际页数继续加载，把后面的结果也拉出来。

v3.0.8.2 (2026-05-13)

• 合集分页临时超时重试：获取 B 站合集分页时如果遇到临时超时，会自动短暂重试，减少合集源因为单次 -504 服务超时就中断整轮扫描的问题。
• 登录失效通知补齐：检测到 B 站登录状态过期或未登录，并且自动刷新 Cookie 失败时，会通过已配置的通知渠道提醒处理，避免只写日志导致长期无法发现。
• 凭据每日自动刷新：程序会在每天 1 点检查并刷新 B 站 Cookie，正常过期时会自动保存新凭据到数据库，降低扫描开始时才发现登录失效的概率。
• 刷新失败原因更清楚：Cookie 刷新链路会区分缺少凭据、刷新页面取不到 refresh_csrf、刷新接口失败等情况；如果手动退出登录或清除登录状态，仍需要重新扫码登录或更新整套凭据。

v3.0.8.1 (2026-05-09)

• 签名信息获取更稳：获取播放地址前需要用到的 B 站签名信息如果偶发请求失败，会自动再试几次，减少因为短暂网络波动导致整轮下载失败的问题。
• 坏 CDN 地址自动换路：下载时如果某个 B 站 CDN 节点返回的证书和地址对不上，会先跳过这个坏地址继续试备用地址；一批地址都不行时，会重新获取播放地址再试，减少单个异常 CDN 节点拖垮整个视频下载的问题。

v3.0.8 (2026-04-28)

• 签名信息获取更耐抖：扫描开始时如果网络、DNS 或代理短暂连不上，会先短暂重试几次，不再因为一瞬间连接失败就直接跳过整轮扫描、留下错误日志。
• 超长文件名截断：默认生成的文件名和目录名会按 100 字节截断，减少长中文标题在生成弹幕、字幕、封面等配套文件时超过文件系统限制的问题。
• 弹幕更新顺序优化：视频源还有未下载、未修复或待重试的视频时，会先处理这些下载任务，不再一开局把旧视频的到期弹幕一起塞进主流程；等该源下载处理完后，下一轮再按规则更新旧弹幕，减少大 UP 主源触发风控的概率。
• 添加视频源页面修复：添加 UP 主投稿、合集或收藏夹时，搜索结果、关注列表、合集列表和收藏夹列表不会再同时残留在页面上，选择目标后会自动收起无关列表。
• 同名视频目录冲突修复：同一个 UP 主下出现多个同标题视频时，不再把后下载的视频挤进同一个裸标题目录；发生冲突的视频会使用“标题-完整发布时间-BV号”作为目录名，避免不同视频文件混在一起。
• 单P文件名更稳定：如果视频已经单独占用一个目录，目录内的视频文件会保留标题文件名；只有多个视频确实共用同一个目录时，才会在文件名里加完整发布时间和 BV 号。
• 重设路径保留 AI 改名目录：AI 重命名父目录后，再重设视频源路径会保留当前 AI 改过的目录名，只把目录整体迁到新路径下，不再退回默认文件夹格式。
• 重设路径迁移修复：重设视频源路径时会把实际移动后的目录同步写回数据库，减少目录被追加 _1、_2 后页面路径和本地文件不一致的问题。
• 发布时间格式统一：命名、通知、投稿选择和视频源最新时间等位置的发布时间统一使用完整时间戳，例如 20260428170830，避免只显示日期导致同一天视频难以区分。
• 前端显示同步：设置页默认时间格式和分页命名提示已同步更新，视频源管理页、投稿选择页会按完整时间戳展示相关发布时间。

v3.0.7 (2026-04-23)

• 视频详情来源标签：视频详情页会显示该视频来自哪个视频源，方便确认它是从收藏夹、合集、UP主投稿、稍后再看还是番剧入库的。
• 入库概览修正：把“最新入库”和“最近处理”分开，真正新加的视频才进最新入库，补弹幕或重处理的老视频只进最近处理，避免误以为新视频丢了。
• DeepSeek 重命名修复：修复批量重命名时偶发漏掉返回开头、导致整批解析失败的问题；默认模型也已换成 DeepSeek 新模型，设置页提示同步更新。
• 视频封面本地兜底：视频管理页远程封面打不开时，会继续尝试读取已经下载到本地的封面；B 站返回失效占位时，也不会把已有标题和封面改成空信息，历史占位标题会用已下载分页名兜底显示。
• 删除队列卡住修复：修复删除视频或视频源后，队列状态可能一直停在“处理中”、后续删除只能排队不继续执行的问题。
• 删除残留任务清理：程序启动恢复删除任务时，如果目标视频源已经不存在，会继续检查并清理残留的视频和分页记录；删除本地文件后只沿本次删除路径向上回收空目录，不再全量扫描媒体根目录。
• 暂停后删除视频源修复：修复下载任务刚暂停、后台还在收尾时立即删除视频源，可能导致本地文件夹被晚到的下载任务重新生成、网页端却已经搜不到的问题；现在会等当前任务真正结束后再执行删除。

v3.0.6 (2026-04-20)

• 平铺目录重设路径修复：修复稍后观看等视频源在平铺目录模式下重设保存路径时，只在目标位置留下空文件夹、真实视频和配套文件没有一起搬走的问题；现在会把视频、本地封面、NFO、弹幕、字幕一起迁到新位置。
• 简介页显示更干净：修复媒体库里简介区域把原始视频链接和一堆标签文字直接显示出来的问题，现在详情页看起来更清爽。
• 仅自己可见的视频不再反复重试：有些被作者设成“仅自己可见”或已经看不到的视频，现在会更早跳过，不会一轮里反复报错、重复尝试。
• 通知没配完整时不再刷失败日志：如果你把 Webhook 选成了自定义方式，但内容没填完整，程序会先跳过这类通知，不再一遍遍提示发送失败；手动点测试时还是会明确告诉你哪里没配好。
• NFO 分类标签设置：关掉这个设置后，只会影响后面新生成的 NFO；以前已经生成好的 NFO 不会被重做，也不会被改掉。

v3.0.5 (2026-04-17)

• 弹幕增量更新：新增弹幕分阶段刷新策略，支持按日期增量追加写入、详情页查看同步状态和手动刷新；首次启用时会更合理地继承已有下载记录，避免旧视频被误判为刚刚同步；当视频详情接口受限时，会自动回退使用已存分页信息继续刷新。
• 前端体验整理：统一了多处页面的加载、空状态、批量选择和公共操作区域，界面表现更一致，后续维护和迭代也更稳定。
• 配置留空默认值：设置页中的常规配置项支持留空后自动回退到默认值，不再因为“不能为空”阻止保存；可选敏感字段在留空时会按清空处理，避免界面看起来已清空但实际仍保留旧值。
• 前端构建校验补齐：补齐了统一的前端构建和校验流程，减少开发和发版时因环境差异带来的问题。
• 分页卡片布局优化：视频详情页将分页下载进度移入卡片内部，信息层级更集中，查看和操作更顺手。
• 悬浮说明补齐：补充首页、视频管理、视频详情、视频源管理、设置页以及视频卡片常用标题和按钮的悬浮说明，减少首次使用时的理解成本。
• 视频源最新视频时间：视频源管理页新增“最新视频时间”显示，并按最近 7 天、8 到 30 天、31 天以上分别用绿、黄、红标记更新活跃度，方便快速识别长期未更新的视频源。
• Season 目录结构下的视频简介修正：修复多P视频启用 Season 目录结构后，媒体库详情页可能显示为 UP 主简介的问题；现在会优先写入视频自身简介，同时保持原有的 Season 目录与元数据结构。
• NFO 文本兼容性优化：优化 .nfo 生成时的文本清洗逻辑，自动移除不符合 XML 规范的异常字符，降低个别标题、简介或演员信息导致媒体库解析失败或显示异常的概率。

v3.0.4 (2026-04-01)

• 快捷模板按钮显示修复：修复添加视频源页面默认进入合集类型时，“套用快捷模板”按钮未及时显示的问题。
• 文件名保留优化：文件名清理规则改为保留合法的中文括号和书名号，减少标题样式被过度替换的问题。
• 重设路径多P修复：修复重设视频源路径后，多P视频分页本地路径被错误重建，导致本地播放失败的问题。
• 扫描异常处理优化：缓解下载过程中偶发的数据库锁冲突，并在稿件不可见时自动跳过处理，减少重复报错和无效重试。
• 任务刷新立即生效：修复任务刷新后仍停留在等待状态的问题，点击刷新后会立即唤醒扫描循环并尽快开始下一轮扫描。
• 大量扫描卡顿优化：优化大量视频扫描和下载时的保存顺序，减少数据库排队导致的长时间卡住和任务不继续的问题。
• 数据库日志降噪：轻微排队等待不再作为告警显示，只保留真正锁住、写入失败或耗时过长的提示，排查问题时更容易看清重点。
• 投稿源超时提示优化：投稿源公开信息接口偶发超时或网络抖动时，会优先使用已有信息继续处理，并减少重复错误日志刷屏。
• 视频总大小写入优化：下载阶段会直接合并并写入视频总大小，不再额外走一次独立重算，减少保存阶段的排队等待。
• 番剧季度请求优化：番剧季度信息改为走公开接口请求，不再附带登录凭证，减少因脏凭证或风控头带来的误判失败。

v3.0.3 (2026-03-29)

• Webhook 自定义请求头：通知模块支持为 Webhook 配置自定义请求头，便于适配需要额外鉴权或分流头的通知服务。
• Rust 工具链升级：Rust 工具链升级到 1.94.1，保持构建环境与最新稳定补丁版本一致。
• 稍后再看源自动停用：稍后再看源为空时，会自动停用该源并发送一次通知，避免每轮扫描重复提醒。
• 播放模式分离：视频详情页将本地播放和 B 站内嵌播放分开显示，可直接切换到 B 站官方播放器播放，减少远程访问时对宿主机流量的占用。
• 视频文件大小排序：视频管理页新增按文件大小排序，并会在后台逐步补全旧视频的文件大小统计，减少首次排序时的等待。
• 充电视频说明补充：视频卡片中的充电视频标识新增悬浮说明，便于快速理解该标识含义。
• 移动端日志分页优化：修复移动端系统日志页分页区域挤出界面和统计文字竖排显示的问题，分页信息与翻页按钮在小屏设备上显示更稳定。
• 编辑状态弹窗适配优化：视频详情页的编辑状态改为中间弹窗显示，并针对手机、小屏和短高度设备优化了内容区与按钮区域的可用空间。

v3.0.2 (2026-03-28)

• 视频源删除修复：修复部分情况下删除视频源后出现卡住、重复删除报错，或本地文件已删除但源列表仍残留的问题。
• 列表刷新修复：修复视频管理和源管理列表状态更新不及时的问题，新增、删除、重置和源配置变更后会更快同步到页面显示。
• 视频列表显示修复：修复部分情况下视频总数显示正常但列表为空的问题。
• 扫描已删除视频模式优化：视频源支持“持续启用”和“本轮启用一次”两种模式，本轮模式会在扫描完成后自动关闭，减少忘记关闭后带来的额外扫描开销。
• 快捷订阅路径模板：设置页新增收藏夹、合集、UP主投稿和番剧的快捷订阅路径模板，添加视频源时可自动带出保存路径。
• 批量添加路径优化：批量添加视频源时，会按当前源类型的快捷订阅路径模板为每个选中项分别生成保存路径，无需重复手动填写。

v3.0.1 (2026-03-25)

• 优化日志：优化错误信息日志明确操作。
• 关键词过滤保存修复：修复关键词过滤弹窗在填写“最短时长/最长时长”后再次保存时报错的问题，并同步修复添加源页面中的同类过滤条件保存逻辑。
• 优化编译：优化编译时不再打包aria2c进入程序包，改为自动下载。
• 构建目标补充：新增 Linux armv7l musl 二进制构建目标，并统一 macOS 构建任务与产物命名为 macos-*。
• 投稿选择搜索修复：修复投稿选择弹窗在搜索投稿视频时过滤状态错乱的问题，并同步修正搜索态下的空状态提示与“加载更多”按钮显示逻辑。

v3.0.0 (2026-03-21)

• 版本升级：项目版本号更新为 3.0.0。
• 失效合集源自动停用：合集被删除、隐藏或已不存在时，会自动停用对应合集源并发送通知。
• 投稿源停用通知补齐：UP主投稿源因已注销、已封禁或无视频投稿而被自动停用时，现在会同步发送通知。
• 稍后再看空列表优化：稍后再看为空时不再按错误处理，会记录“该源为空”并发送通知。

v2.8.0.20260315 (2026-03-15)

• 在线播放失效提示优化：视频详情页切换到已删除或失效视频时，不会再一直卡在加载状态，现在会直接提示当前视频无法在线播放。
• 视频源管理页局部刷新：视频源管理页在启用、禁用、删除和修改设置后，会直接刷新当前视频源状态，不再整页刷新并跳回顶部。

v2.8.0.20260314-4 (2026-03-14)

• 图片缓存瘦身：图片代理缓存不再保存数据库中的图片二进制内容，降低数据库体积增长。
• 历史缓存清理：升级后会自动清理历史图片缓存大字段，并执行数据库空间回收。

v2.8.0.20260314-3 (2026-03-14)

• 合集封面修复：合集源重置封面后，会正确使用合集封面，不再混入分集封面。
• 投稿合集封面修复：UP主投稿中的合集视频重置封面后，也会正确使用对应合集封面。

v2.8.0.20260314-2 (2026-03-14)

• 视频管理页实时推送：视频管理页的下载状态与下载进度改为实时推送更新，不再依赖手动刷新查看变化。
• 新入库视频显示优化：在视频管理页第1页时，新入库视频会直接实时插入列表；不在第1页时，只提示有新入库视频，避免打断当前浏览和操作。

v2.8.0.20260314 (2026-03-14)

• 合集季封面来源修复：独立添加的合集源在补齐季级封面时，只会使用合集封面并在缺失时自动回查，不再回退为首集或任意分集封面。
• 日志页实时推送优化：系统日志页改为使用实时推送增量更新，不再定时整页强制刷新日志内容。
• 日志阅读与复制保护：查看系统日志时，鼠标停留或选中文本复制期间会暂缓应用新日志，避免刷新打断阅读和复制操作。

v2.8.0.20260311 (2026-03-11)

• 登录过期自动续登补齐：修复部分情况下扫描刚开始就因登录过期停止、却没有触发自动续登的问题。现在启动扫描前若检测到登录失效，会先尝试自动续登并重试，减少因凭证短暂过期导致的整轮扫描中断。

v2.8.0.20260309-5 (2026-03-09)

• 已注销投稿源自动停用：UP主投稿源扫描到账号已注销时，不再反复报错，会自动停用该源，避免后续继续扫描。
• 已封禁投稿源自动停用：UP主投稿源扫描到已封禁、被禁言或无视频投稿的账号时，也会自动停用该源，避免这类无法继续扫描的账号持续参与扫描。
• 视频删除状态落库顺序优化：删除视频时会更早写入删除状态并清理分页记录，避免旧版本那种“文件已删但视频列表仍显示、点播放报错”的残留问题。
• 视频删除队列显示修复：任务队列页面新增“视频删除队列”显示，扫描中或冲突状态下入队的视频删除任务现在可以在前端直接看到。
• 视频删除卡顿优化：删除单个视频或批量删除视频时，不再递归扫描整个视频源目录清理空文件夹，避免大视频源下首个删除任务长时间卡住、后续删除全部排队。

v2.8.0.20260309-4 (2026-03-09)

• 管理页优先启动：程序启动时会先打开管理页，再继续恢复和处理待处理任务，避免启动阶段因历史任务较多而长时间无法进入前端。
• 任务入队超时保护：添加、删除和配置变更等排队操作新增超时保护，避免任务加入队列时长时间卡住。
• 删除视频残留记录修复：删除本地文件已丢失的视频时，会同步清理对应的分页记录，避免后续播放或再次删除时反复卡住。
• 投稿源扫描已删除视频修复：UP主投稿源启用“扫描已删除视频”后，会改为全量扫描历史投稿，已删除的旧视频现在也能被正确恢复和重新下载。
• 投稿源名称统一：前端各页面的投稿源显示名统一为“UP主投稿”，不再混用“用户投稿”等不同叫法。

v2.8.0.20260309-3 (2026-03-09)

• Webhook自定义请求体：推送通知的 Webhook 新增“自定义 JSON”模式，可自行填写 POST 请求发送的 JSON 结构。
• 占位符模板支持：自定义请求体支持标题、正文、渠道、事件类型、发送时间等占位符，方便适配不同通知服务。
• 测试与正式推送同步生效：测试推送和正式扫描通知都会使用当前配置的自定义请求体发送。
• 设置说明补充：设置页补充了占位符说明，便于直接按示例编写自定义 JSON。

v2.8.0.20260309-2 (2026-03-09)

• 扫描中视频删除排队修复：扫描任务运行时，删除单个视频和批量删除视频会自动加入队列，待扫描结束后继续处理，不再出现删除无响应或未进入删除流程的问题。
• 视频删除提示优化：视频详情页和视频管理页会明确区分“已删除成功”和“已加入队列”，方便判断当前删除状态。
• 视频源删除提示优化：删除视频源在进入队列等待处理时，前端会明确提示“删除任务已入队”，避免误以为已经立即删除完成。

v2.8.0.20260309 (2026-03-09)

• 收藏夹批量添加修复：修复批量添加收藏夹时名称显示错误、识别到错误收藏夹，以及添加后未立即触发下载的问题。
• 删除遗留空目录修复：修复先批量删除视频、再删除视频源后仍遗留空文件夹的问题，后续删除会同步清理空季目录、空视频目录和空上级目录。
• 充电视频播放切换修复：修复视频详情页在充电视频与普通视频之间切换时，播放器状态未正确重置、上下切换后仍停留在上一条视频状态的问题。
• 充电视频提示优化：充电视频未解锁时，前端统一显示“充电视频未充电”，并减少冗长错误提示与无意义告警日志。
• 充电占位文件播放稳定性修复：修复充电视频占位文件播放时可能触发崩溃的问题，占位文件现在会稳定返回不可播放提示。

v2.8.0.20260308 (2026-03-08)

• 合集视频序号修正：修复合集源视频集序方向判断逻辑，为后续新合集源自动校正“第一集”。
• 新合集源集序方向修正：新添加的合集源会自动比较首个与末尾视频的投稿日期，必要时整体反转，确保第一集位于更旧的一端。
• 旧合集源顺序保持不变：已有合集源继续沿用原有集序，不会因本次修复被重新改号。
• 充电视频保留入库：充电专享视频不再直接删除，现在会保留目录、封面和元数据，并生成可替换的视频占位文件，方便后续手动覆盖。
• 充电视频标识显示：视频管理页的充电专享视频卡片会显示专用标识，便于快速区分。
• 视频管理排序增强：视频管理页新增“充电视频在前”排序，方便优先查看和处理充电专享视频。

v2.8.0.20260307-5 (2026-03-07)

• 单P视频元数据类型修复：修复普通单P投稿仅因带有季号信息就被误判为剧集型元数据的问题，避免媒体库错误识别。
• 季级海报兼容补齐：为投稿源聚合、合集源聚合和多P季结构补充生成季级海报文件，复用现有横版封面，提升 Emby 识别兼容性。

v2.8.0.20260307-4 (2026-03-07)

• 投稿源合集归属修复：修复部分 UP 投稿源明明命中本人合集却没有进入 UP 主合集季目录的问题，单P合集成员现在可正常并入聚合目录。
• 投稿源季号冻结：在“同UP合集分季”模式下，已有季度编号保持不变，新出现的合集或多P分组只会在当前最大季号后继续追加。
• 合集源逻辑不变：本次只调整投稿源“同UP合集分季”的季号分配策略，合集源聚合与绝对季号规则保持原样。

v2.8.0.20260307-3 (2026-03-07)

• 季级元数据标题修正：合集聚合后的季目录元数据文件不再自动附加“合集·”前缀，标题、原始标题、排序标题与系列名称保持干净一致。
• 季级标题精简：合集聚合与普通多P生成的季目录元数据标题不再自动附加“第x季”，直接使用实际合集名或视频标题。
• 合集聚合季号获取优化：修复部分 UP 的合集聚合季号获取异常问题，减少重复警告，提升绝对季度编号识别稳定性。
• 活动专题误归类修复：投稿视频若命中站内活动或专题合集但不属于当前 UP，本地不再误归入 UP 主合集季目录，旧错误归属也会自动清理。

v2.8.0.20260307-2 (2026-03-07)

• 合集源合集聚合：合集源支持按同一 UP 聚合到统一根目录，并按季度目录结构管理。
• 绝对季度编号：聚合后的季度编号按该 UP 在 B 站合集/系列列表中的顺序映射，不再受本地已添加数量影响。
• 批量添加支持：批量添加合集源时也可直接开启“合集聚合”。
• 设置入口：添加源 → 合集 → 合集聚合，以及 批量添加配置 → 合集聚合。

v2.8.0.20260307 (2026-03-07)

• 投稿时间过滤：关键词过滤新增投稿时间起止范围，可按投稿日期筛选视频。
• 时长过滤：关键词过滤新增最短/最长时长，可按视频时长范围筛选视频。
• 设置入口：添加源页面与 视频源管理 → 关键词过滤 弹窗中，新增“附加过滤条件”区域。

v2.8.0.20260306-2 (2026-03-06)

• 历史选择回补修复：修复 UP 投稿源中“删除视频后再次选择同一 BV”不再触发回补下载的问题。
• 重选同BV自动恢复：当选择集未变化但所选 BV 处于已删除状态时，系统会自动恢复并重新入队下载。

v2.8.0.20260306 (2026-03-06)

• 动态API节流配置：新增动态API请求延迟开关与延迟倍数配置。
• 设置入口：设置 → 风控配置 → 动态 API 配置（可调整“启用动态 API 延迟”和“动态 API 延迟倍数”）。
• 动态API节流日志：新增动态API请求节流日志输出，便于确认节流是否生效与当前延迟值。
• 多P删除卡加载修复：在视频详情页删除多P视频的非首个分页（如 P2/P3/P4）时，不再卡在“加载中”状态。

v2.8.0.20260304-2 (2026-03-04)

• 测试推送即时生效：测试推送会优先使用当前页面输入的 URL/Key（未保存也可直接测试）。
• 测试提示补充：设置页“测试推送”区域新增说明，明确测试与保存配置的关系，避免误判。

v2.8.0.20260304 (2026-03-04)

• Webhook openSend 兼容：兼容 openSend 请求格式与 apikey 鉴权，测试推送可正常发送。
• 推送结果判定修复：对部分“状态码非成功但返回内容显示成功”的网关按成功处理，避免误报失败。
• 测试失败提示优化：前端优先展示后端返回的具体错误信息，不再只显示通用状态码提示。

v2.8.0.20260303-2 (2026-03-03)

• 删除视频源并发修复：删除视频源时若已有删除任务在执行或排队，新的删除请求会自动进入队列顺序处理，不再因并发操作报“数据库被锁定”。
• 删除队列即时处理优化：非扫描状态下，删除任务入队后会立即触发后台处理，不再等待下一轮扫描。
• 数据库锁兜底：直删过程中若遇到数据库锁，自动回退为队列处理并继续执行。

v2.8.0.20260303 (2026-03-03)

• 投稿目录模式修复：修复投稿源在统一模式和分离模式下仍误走“同UP合集分季”逻辑的问题。
• 误建目录修复：统一模式和分离模式下不再错误创建 UP 主合集季目录。
• NFO根名锁定范围修复：合集根名锁定仅在“同UP合集分季”模式生效，避免非该模式写入错误结构。
• 目录冲突误判修复：修复“上一轮失败、下一轮成功”场景下误触发“检测到下载文件夹名冲突，追加发布时间”的问题，不再错误追加日期后缀。

v2.8.0.20260301-2 (2026-03-01)

• Rust 版本统一：项目运行与构建统一升级到 Rust 1.93.1。
• CI 工具链统一：GitHub Actions 中的 Rust 工具链统一为 1.93.1，避免本地与 CI 版本不一致。
• 未来兼容告警清理：同步升级相关依赖，清除未来兼容性告警。

v2.8.0.20260301 (2026-03-01)

• 新增 Webhook 推送：通知渠道新增 Webhook，支持 URL 与可选 Bearer Token，前端可直接保存并测试。
• Server酱3 测试修复：修复 Server酱3 测试推送被误判为未知渠道导致失败的问题。
• 封面处理优化：整合目录根封面改为同源去重处理，并减少重复日志输出。

v2.8.0.20260228 (2026-02-28)

• 批量添加合集修复：修复批量添加合集源时“合集 / 系列”类型识别错误导致部分列表不下载的问题。
• 合集去重判定修复：合集已存在判定改为按“合集ID + UP主ID + 合集类型”区分，避免合集与系列互相冲突。
• 添加页显示一致性优化：添加页中合集/系列的“已添加”状态与批量选择键统一按类型区分，避免误禁用和误覆盖。

v2.8.0.20260226-03 (2026-02-26)

• Windows ffmpeg 配置增强：设置页新增 ffmpeg 路径配置，支持填写可执行文件或目录路径，不再只依赖系统环境变量。
• 配置更新日志可读性优化：配置保存后的日志改为显示中文配置名称，不再显示内部字段键名。
• 配置保存提示同步优化：前端配置保存成功提示中的“已更新字段”同步显示中文名称，便于直接识别变更项。

v2.8.0.20260226-2 (2026-02-26)

• 历史收藏视频下载修复：修复部分老视频被错误标记为“无效”后无法进入下载的问题。
• 重置后可重下修复：重置视频后会自动恢复可下载状态，避免仍停留“无效”导致不执行下载。

v2.8.0.20260226 (2026-02-26)

• 同集重命名同步完善：优化修复。
• 数据库路径同步修复：优化修复。

v2.8.0.20260225 (2026-02-25)

• 推送通知保存提示修复：修复推送通知配置保存成功后仍提示“保存失败”的问题。
• 通知配置保存兼容优化：统一保存结果判定逻辑，避免因返回格式差异导致误报失败。

v2.8.0.20260223 (2026-02-23)

• 投稿归属判断优化：取消基于标题关键词（如“合集/全系列”）的归属推断，避免普通单P被误判。
• 补抓范围收敛：仅对真正需要归属补抓的视频执行合集/系列归属流程，减少无效请求与等待时间。
• 目录判定更稳定：合集归属、单P状态与来源类型联合判定生效，多P、合集、系列与普通单P分流更清晰。

v2.8.0.20260222 (2026-02-22)

• 在线播放请求优化：重复播放同一视频时会优先使用已缓存播放地址，减少重复请求，加载更快。
• 播放失效自动恢复：当缓存播放地址失效时会自动刷新最新地址并继续播放，减少手动重试。
• 播放日志可观测性增强：新增播放链路 Debug 日志，支持更快定位缓存命中、回源与代理流状态。
• 封面缓存排查增强：新增封面代理缓存 Debug 日志（命中/未命中/回源/写入），强制刷新时可直接判断是否命中缓存链路。

v2.8.0.20260220 (2026-02-20)

• 白名单补抓体验优化：UP主白名单历史补抓改为后台执行，保存设置不再卡住前端页面。
• 添加UP源暗色适配修复：修复“添加UP源/历史投稿选择”中视频标题在深色主题下显示不清晰的问题。

v2.8.0.20260219 (2026-02-19)

• 历史选择下载修复：修复 UP 主历史投稿选择后偶发不触发下载的问题，已选视频可稳定进入下载流程。
• 归属告警优化：优化历史选择场景下的归属处理，减少不必要的归属失败告警。
• 入队统计修复：历史选择后的“新增入队”数量改为按实际结果统计，提示更准确。

v2.8.0.20260218-2 (2026-02-18)

• UP头像目录兼容修复：UP头像目录统一按小写首字母归档，修复英文大写UP名称在 Emby 中头像不识别的问题。
• 历史头像自动兼容：启动后会自动兼容旧的大写目录头像文件，无需手动改名。

v2.8.0.20260218 (2026-02-18)

• UP合集元数据同步修复：合集总季数与总集数现与实际季目录和视频数量一致。
• 启用方式说明：前端进入 设置 → 合集目录结构配置 → 合集文件夹模式，选择“同UP合集分季”并保存；随后对对应源执行重置或重新扫描后即按当前统一目录结构落盘。
• 多P元数据优化：分P详情文件使用分页级唯一标识，提升媒体库识别稳定性。
• 多P总集数写入：多P总集信息文件现在会写入总集数，媒体库展示更准确。
• 多P目录结构统一：同UP合集分季模式下，投稿多P不再单独建视频文件夹，统一并入同UP合集季目录。
• 多P命名防覆盖：并入合集目录后的多P文件改为包含季度、集数和分页的统一命名规则，避免同名覆盖。

v2.8.0.20260216-2 (2026-02-16)

• 任务队列可取消：任务队列页面新增“取消任务”操作，可直接取消等待中的队列任务。
• 队列状态展示优化：任务队列改为显示真实任务标识，状态反馈更准确。
• 前端悬浮说明补全：主要设置项与操作按钮支持鼠标悬浮查看详细解释，降低使用门槛。
• 队列取消提示优化：任务队列页“取消任务”按钮增加专用悬浮说明，语义更清晰。

v2.8.0.20260216 (2026-02-16)

• 分P归档优化：UP源中的分P视频统一并入同UP合集目录，不再散落到独立目录。
• 分P目录结构优化：分P内容按合集规则统一组织，媒体库识别与管理更稳定。

v2.8.0.20260215 (2026-02-15)

• 合集统一命名可配置：新增“合集统一命名模板”设置（统一模式和同UP合集分季生效），默认保持常见的季集编号命名格式。
• 同UP合集分季目录：新增“同UP合集分季”模式，同一UP的多个合集会归并到统一根目录，并按季度目录自动分季存放。
• 任务刷新立即生效：重置后点击“任务刷新”会立刻开始新一轮扫描，不再出现“已刷新但未扫描”的情况。
• 合集媒体库标题修复：同UP合集分季模式下，合集根目录元数据标题统一为合集根目录名称，媒体库展示更一致。

v2.8.0.20260201 (2026-02-01)

• AI 重命名稳定性提升：批量重命名合集或多P视频时，将跳过文件夹重命名，避免路径错乱与后续任务异常。

v2.8.0.20260128 (2026-01-28)

• 投稿源分批扫描：UP主投稿支持“每轮仅扫描 N 个源”，降低请求密度，减少风控风险（可在视频源管理页配置）。
• 投稿源自适应降频：连续无更新的投稿源会自动降低扫描频率，减少无效请求；活跃投稿源仍保持更高频率（可配置最大降频时长）。

v2.8.0.20260127 (2026-01-27)

• 日志导出体验优化：日志页支持选择并下载“每轮生成”的历史日志文件；内存导出与后端上限一致（最多 10000 条）。
• 重置删除视频兜底：重置视频后若视频已被B站删除/不可访问，会自动跳过并恢复为未重置状态，并在日志中提示。
• 视频源批量操作：视频源管理支持批量启用/禁用（全选/清空），视频源较多时更方便。

v2.8.0.20260126 (2026-01-26)

• 暂停下载状态修复：停止任务后不再错误显示“已下载完成”，恢复任务可继续下载。
• 暂停恢复扫描修复：修复暂停后恢复时偶发不扫描视频源的问题。
• 扫描稳定性提升：扫描异常时会自动重试并恢复扫描，减少手动干预。
• 演职人员元数据修复：普通视频的演员名称使用UP主昵称，不再写成数字 UID，媒体库按演员归类不再漏视频。
• 稳定标识增强：为 UP 主和合作成员写入个人主页链接，便于后续按 UID 做稳定映射。
• 横版背景图补全修复：修复部分视频只生成缩略图、未生成横版背景图的问题。
• 路径变更同步修复：修改视频源目录后，重置/更新视频信息时会自动迁移合作类视频到新位置。

v2.8.0.20260125 (2026-01-25)

• 配置自动迁移：启动时自动识别旧项目配置并完成迁移，无需手动干预。
• 零损耗迁移保障：旧配置完整保留，无法映射项会单独记录，确保可回溯。
• 迁移状态接口：新增配置迁移状态/执行接口，便于后续升级维护。
• 迁移报告日志：启动迁移时会输出已映射/未映射字段清单，便于核对。
• 投稿动态API开关：UP主投稿支持切换动态API获取，解决动态视频获取需求，并在界面提示其请求特性。
• 动态API拉取策略：首次启用时全量拉取，后续自动按增量更新。
• aria2 单实例模式：固定单实例多线程下载，避免多进程分流导致速度不稳定。
• aria2 线程判断优化：通过 Range 探测真实文件大小，避免被误判为小文件而降到单线程。
• 暂停日志降噪：暂停任务时不再输出“分页下载失败/状态码 0”与无意义错误提示。
• 暂停状态保护：任务已暂停时不再报“没有可用的aria2实例”。
• 分辨率筛选标准化：按相邻档位中点划分分辨率区间。

v2.8.0.20260124 (2026-01-24)

• 日志分轮归档：每轮扫描会生成独立日志文件，排查问题更方便。
• 日志自动清理：自动只保留今天与昨天的日志，较早日志会自动清理。
• 视频管理自定义显示：支持自定义每页视频数量与每行列数，并自动保存。

v2.8.0.20260122 (2026-01-22)

• AI 重命名优化：移除旧流程，统一使用批量 AI 重命名，体验更稳定。
• 番剧元数据修复：修复番剧标题/排序写入异常（系列名不再带“第X季”）。
• 番剧封面修复：修复番剧根目录封面显示错误（不再跟随当前季）。
• 封面重置修复：修复重置视频封面后，部分封面文件未重新下载的问题。
• NFO 标签增强：现在也会包含“发现《xxx》”等音乐识别标签。
• 日志提示优化：重置后会更明确提示下载阶段的开始与完成，避免误解。
• 性能优化：番剧封面避免重复下载。
• 删除视频源优化：删除视频源并选择删除本地文件时，会自动清理遗留空目录。

v2.8.0.20260121-2 (2026-01-21)

• 窄屏适配优化：在 1080px 及以下 宽度时，侧边栏会自动切换为抽屉模式（不再挤占内容区），顶栏按钮更紧凑，页面布局更合理。

v2.8.0.20260121 (2026-01-21)

• 在线播放支持进度条拖动：观看老视频时，现在可以自由拖动进度条了。
• 视频下载兼容性提升：修复了某些老视频因格式问题无法下载的错误。
• 版本更新提醒：当前版本按钮会显示是否有新版本可用，点击版本号可查看详情弹窗（移动端同样可用）。
• 时间显示优化：页面所有时间统一显示为北京时间。

v2.8.0.20260120 (2026-01-20)

• 画质选择更智能：修复了部分视频在低画质设置下无法下载的问题，现在会按您设置的画质范围智能选择。
• 番剧下载修复：修复了部分番剧因分集信息错误导致弹幕、字幕下载失败的问题。
• 文件删除更安全：修复了在特定目录模式下，删除一个视频可能误删其他文件的问题。
• 老视频播放兼容：修复了部分仅支持FLV格式的老视频在网页端无法播放的问题。

v2.8.0.20260119 (2026-01-19)

• 设置页体验升级：所有设置面板改为弹窗形式，操作更统一、直观。
• 界面优化：移除了设置页面的随机背景图，专注于内容。
• 前端性能提升：优化了页面组件和大型列表的交互流畅度。

v2.8.0.20260116 (2026-01-16)

• 新增原生多线程下载：即使不安装 aria2，现在也支持多线程分片下载，提升下载速度。
• 下载器选择更灵活：新增开关，可自由选择优先使用原生多线程下载还是 aria2。
• aria2 稳定性增强：优化了连接与任务管理，在多任务环境下更稳定。
• 大收藏夹扫描优化：大幅提升大型收藏夹的扫描速度和成功率。
• 错误信息更清晰：扫描失败时，提示信息更具体，便于定位问题。

v2.8.0.20260115 (2026-01-15)

• 联合投稿支持增强：现在可以下载联合投稿视频中所有创作成员的头像。

v2.8.0.20260113 (2026-01-13)

• 充电视频识别优化：减少对非充电视频的误判。
• 新增推送渠道：支持使用 Server酱3 发送通知。
• 视频流兼容性提升：更好地支持多种视频格式。

v2.8.0.20260109 (2026-01-09)

• 修复批量重命名重复执行问题：通过API批量重命名后的文件不会再被重复处理。
• 批量重命名支持重命名文件夹：批量重命名视频时，其所在文件夹（单P视频）也会同步改名。

v2.8.0.20260108-2 (2026-01-08)

• AI重命名设置简化：将高级选项移至各视频源的独立设置中，全局设置页面更简洁。
• 修复重命名冲突：修复了AI批量重命名时可能和扫描任务产生冲突的问题。

v2.8.0.20260108 (2026-01-08)

• AI重命名效率提升：改为批量处理模式，减少请求次数，同一批文件命名风格更一致。
• 重命名状态追踪更准：新增标记字段，准确记录文件是否已被AI重命名，避免误判。
• AI更“听话”：强化提示词指令，确保AI严格遵循您自定义的命名格式。
• 新增操作指引：在相关页面添加了提示词写法的说明。
• AI会话自动恢复：当AI服务达到会话上限或出错时，会自动恢复并保持命名风格。

v2.8.0.20260105-2 (2026-01-05)

• AI批量重命名功能增强：
  • 修复自定义提示词不生效的问题。
  • 自动处理重名文件，避免跳过。
  • 为需要集数编号的格式（如s01e001）提供排序信息。
  • 番剧视频源现在也支持批量历史重命名。

v2.8.0.20260105 (2026-01-05)

• 新增DeepSeek免费API支持：无需API Key，配置Token即可使用AI重命名功能。
• AI服务自动维护：自动下载并更新所需的AI组件；Token过期时会发出提醒。

v2.8.0 (2026-01-05)

• AI重命名功能上线：支持使用AI（如DeepSeek）智能优化视频文件名，可全局或按视频源单独设置。
• 文件夹同步重命名：AI重命名视频文件时，其所在子文件夹也会一同改名（单P视频）。
• 数据库性能优化：修复了高并发时可能出现的数据库锁冲突问题。

v2.7.8.20260104-2 (2026-01-04)

• 新增“仅保留M4A”模式：在仅下载音频时，可选择只保留音频文件，跳过封面、字幕等。
• 新增“平铺目录”模式：启用后所有文件直接存放在视频源根目录，不创建子文件夹，适合作为音乐库管理。

v2.7.8.20260104 (2026-01-04)

• 首页显示优化：番剧入库时显示具体的系列名称，而非“番剧”标签。
• UP主扫描性能提升：修复了选择性下载模式下每次仍需全量扫描的问题，后续扫描速度大幅提升。

v2.7.8.20260102-4 (2026-01-02)

• 新增错误通知推送：程序运行发生关键错误（如下载失败、API请求失败等）时，会自动推送通知到您配置的渠道。

v2.7.8.20260102-3 (2026-01-02)

• 多P视频增量下载：支持仅下载UP主后续新增的分P视频，已下载的内容不受影响。
• 单P变多P自动处理：当单P视频被UP主改为多P时，会自动触发全部重新下载并通知您。

v2.7.8.20260102-2 (2026-01-02)

• 首页信息显示优化：“最新入库”以弹窗形式展示，状态区分更清晰；“下载任务”、“当前监听”等状态的描述文字更明确易懂。

v2.7.8.20260102 (2026-01-02)

• 视频源管理快捷操作：在管理页面为每个视频源添加了快捷按钮，可一键切换“仅下载音频”、“下载弹幕”、“下载字幕”选项。

v2.7.8.20260101 (2026-01-01)

• 新增视频源下载选项：
  • 仅下载音频：可为每个视频源单独设置，开启后只下载M4A音频文件。
  • 弹幕/字幕开关：可独立控制每个视频源是否下载弹幕和字幕文件。

v2.7.8.20251222 (2025-12-22)

• 修复磁盘空间显示：修复了Docker/群晖环境下磁盘空间被重复计算导致显示异常的问题。

v2.7.8.2025122102 (2025-12-21)

• 联合投稿信息完善：NFO文件现在会包含联合投稿视频的所有创作团队成员信息。

v2.7.8.20251221 (2025-12-21)

• 首页磁盘空间显示优化：智能去重，更准确地显示各磁盘的实际剩余空间。

v2.7.8.20251211 (2025-12-11)

• 关键词过滤器升级：
  • 支持同时设置白名单和黑名单，规则更灵活。
  • 新增大小写敏感设置选项。
  • 支持在添加视频源时直接配置过滤规则。

v2.7.8.20251207 (2025-12-07)

• 操作体验修复：修复了视频详情页删除视频后页面跳转异常的问题。

v2.7.8.20251206 (2025-12-06)

• 页面显示修复：修复了视频管理页面翻页时内容显示错误的bug。

v2.7.8.202512054 (2025-12-05)

• 新增“选择历史投稿”功能：添加UP主投稿源时，可以通过弹窗直接勾选其历史视频进行下载，已下载的会自动排除。

v2.7.8.202512053 (2025-12-05)

• 修复添加收藏夹/合集错误：修复了从“我追的”列表中添加时，因ID识别错误导致添加不对的问题。

v2.7.8.202512052 (2025-12-05)

• 推送消息优化：修复了企业微信推送消息过长导致失败的问题，超长内容会自动截断。

v2.7.8.20251205 (2025-12-05)

• 修复合集集数错误：修复了UP主非顺序上传时，合集中视频集数显示错误的问题，现在使用B站官方定义的顺序。

v2.7.7.5.15 (2025-12-04)

• 视频详情页导航增强：
  • 新增“上一个/下一个”视频的跳转按钮。
  • 显示当前视频在列表中的位置。
  • 支持输入页码快速跳转。

v2.7.7.5.14 (2025-12-04)

• 风控验证通知：触发B站风控需要验证时，会推送通知提醒您。
• 删除体验优化：在视频详情页删除视频后，会自动跳转到相邻视频。

v2.7.7.5.13 (2025-12-04)

• 新增企业微信推送：通知推送渠道新增“企业微信群机器人”选项。

v2.7.7.5.12 (2025-11-20)

• 日志优化：减少不必要的日志输出，关键信息更清晰。
• 音频下载兼容性提升：高品质音频不可用时自动回退，确保视频能正常下载。

v2.7.7.5.11 (2025-11-17)

• 新增PWA支持：可将Web管理界面安装为桌面/手机应用程序。
• 在线播放错误提示优化：对已删除视频的播放提示更友好。

v2.7.7.5.10 (2025-11-08)

• 修复在线播放403错误：修复了部分视频因请求头问题无法在线播放的情况。

v2.7.7.5.8 (2025-11-07)

• 媒体库封面兼容性增强：为合集、番剧、多P视频的文件夹新增多种封面命名，全面兼容 Emby 和 Jellyfin。
• 修复番剧文件夹分离问题：修复了同一系列番剧因标题空格差异被分到不同文件夹的问题。

v2.7.7.5.7 (2025-11-07)

• 修复UP主头像匹配问题：调整UP主头像的存储方式，修复其在Emby等媒体库中无法匹配视频演员信息的问题。

v2.7.7.5.6 (2025-10-09)

• 修复在线播放崩溃：修复了点击在线播放可能导致程序崩溃的bug。

v2.7.7.5.5 (2025-10-09)

• 日志输出优化：减少技术性日志的输出，界面信息更简洁。

v2.7.7.5.4 (2025-10-08)

• 默认配置优化：新安装的用户将获得更佳的开箱即用体验（如默认启用合集季结构、CDN优化等）。

v2.7.7.5.3 (2025-10-08)

• 空目录自动清理：删除视频后，其所在的空文件夹会被自动清理。
• 番剧管理优化：优化番剧系列名称处理和季文件夹的生成逻辑。

v2.7.7.5.2 (2025-09-28)

• 视频源批量操作：支持批量添加和删除视频源。

v2.7.7.5.1 (2025-09-26)

• 防止重复添加：在添加视频源页面，已添加的源会被标记并禁用选择。

v2.7.7.5 (2025-09-25)

• 番剧信息显示优化：在视频源页面更清晰地展示番剧的季度信息。
• 番剧合并功能：添加新番剧时，可选择合并到已有的同系列番剧源中。

更早版本主要更新

• 关键词过滤：支持为视频源设置关键词规则，过滤不需要的视频。
• 服务器端口自定义：可以在设置中修改程序运行的端口。
• 增量下载与断点续传：大幅提升UP主投稿、收藏夹等视频源的扫描效率。
• 风控验证系统：支持通过验证码手动或自动绕过B站风控限制。
• 推送通知系统：集成Server酱，支持任务完成、错误告警等消息推送。
• 媒体库元数据支持：为视频生成NFO文件、下载封面和演员头像，适配Jellyfin/Emby/Plex。
• 多P视频、合集、番剧支持：完善了对各类复杂视频内容的支持与管理。

（更详细的历史版本信息可在项目发布页面查看）