v0.5.0

新增

• 播不了就换个播放器：编码内置播放器解不了时（DTS / TrueHD 这类音轨），失败面板多一颗「系统播放器打开」，从系统列表里选一个继续看；网络不通、服务端 404 这类换了也一样播不了的失败不给这颗钮，免得白点一次。
  • 走的不是「把地址丢给别的 App」：外部播放器加不了 Authorization 头，而把 8 天有效的登录凭证拼进 URL 等于送进对方日志。实际做法是在 App 内起一个只绑 127.0.0.1 的一次性中转（路径带随机串、只服务当前这一集），请求头由中转补上、Range 原样转发，所以在外面照样能拖进度。
  • 播放期间挂一个低优先级前台服务保住进程 —— 切到别的 App 后本 App 变成 cached，会被系统冻结、中转一停就卡缓冲；退出播放页（或切集）即停，通知随之消失。通知栏会看到一条「正在向外部播放器推流」。
• 服务端插件 MediaStreamPro 补上 HEAD：之前 /stream 只注册了 GET，外部播放器/下载器探路会吃 405。现在 HEAD /stream 只回响应头（Content-Type、Content-Length、Accept-Ranges: bytes），不打开文件读数据、也不回文件体；鉴权、路径白名单、扩展名白名单与 GET 完全一致。需要插件 v1.0.2。
• 选集改由插件扫媒体库补全：之前选集只能从宿主的整理记录里拼，而那份数据只保留最近三天 —— 早入库的集根本看不到。现在播放页打开后会问插件 GET /season?path=…（插件 v1.1.0）：它扫这个文件所在的目录，按「剧名主干 + 季号」把同一季的文件认出来，文件在、集就在，跟下载历史、种子 hash 都没关系。仍然先进页面用本地那份播起来，服务端清单到了且更全才替换（不会为了等接口卡住起播）；插件没升级（接口 404）就静默保留本地结果，行为与之前一致。
• 下载记录可以直接播了：已整理到媒体库的卡片，标题行右端多一颗 ▶（与「重新整理」同款 28dp 圆形图标按钮，卡片排版未动）。点开是全屏播放页：横屏、可拖进度、退后台自动暂停、播完自动接下一集。
• 整季包带选集：同一次下载（同一个 download_hash）整理出来的多条记录会聚成选集，按集号升序，点哪一条就从哪一集起播；只列真的入库成功的集，整理失败的那几集不会混进去（点一个错一个）。电影/单集不显示选集入口。
• 解码失败给人话：服务端 404/403、连不上、编码解不了（DTS/TrueHD 音轨这类）三种最常见的失败各有对应文案，而不是一句「播放失败」。
• 红果短剧榜：首页榜单新增第五个来源「红果」，一次拉取后在App内分榜展示。
  • 顶部分榜切换行为四个自有图标：热播（火）/ 真人剧（双人对战）/ 漫剧（「漫」字块）/ AI 剧（芯片），选中态沿用首页三行统一的「浅紫底格子 + 主色描边」，图标保持原色。
  • 哪些榜出现由服务端决定：插件配置里勾选了哪几个榜，App 就显示哪几个；一个都没勾（或插件没开红果数据源）时这个页签不出现，不会留空榜给你点。
  • 卡片信息行给的是挑剧真正要看的：集数 · 标签 / 评分 / 点赞热度，新剧额外挂一枚橙色「新剧」徽标。
• 点开红果卡片直接页内试看：不再一上来就把你甩到外部浏览器 —— App 里播放试看片段，播完给「前往红果看全集」，装了红果 App 就直接唤起它（Google Play 版优先，没有再试国内版；都没装才退到网页）；没接入外部播放器和中间跳转页，少一层加载。
  • 试看片段每集约 11MB，移动网络下会先弹一次确认（「用移动数据播放？」），不想耗流量就取消，改用红果 App 看。
• 设置页「首页功能 → 榜单」新增「红果短剧榜」开关（默认关）：与其它榜单共用同一组来源排序。
• 设置页「关于」卡多了枚 Star 徽章：项目仓库链接后面跟着 ★ Star N，一眼能看到仓库有多少人点星（1000+ 显示 1.2k）。取不到就静默不显示，不会留个占位也报错。
• 搜索失败也有出路了：资源列表页与媒体搜索结果页原来失败时只有一行灰字，内容还是后端原文（timeout、500 之类），既看不懂也没有下一步。现在两处共用一个失败态：图标 + 一句主文案 + 一句「该怎么办」+「重新搜索」按钮。连不上服务器时提示检查网络，搜不到时提示换关键词/换季，后端原文降级成第二行小灰字（最多两行），不再当主文案。点按钮就地重跑同一次搜索，不退出页面；已经搜到过结果时列表照常留着，只有空列表才显示整屏失败态。
• 设置页新增「下载功能 › 在线播放」开关（默认开）：关掉后下载记录里不再出现 ▶，也不再探测插件（少一次请求）；服务端插件与已入库的文件不受影响。偏好保存在本机，退出登录不重置。

下载记录播放需要服务端安装插件「媒体流播放」（MediaStreamPro）v1.0.0 及以上 —— 插件装好即用，没有开关也不用配置，放行的目录自动跟随宿主「设置 → 目录」里的媒体库路径。没装插件时下载记录里不会出现 ▶（探不到就不给一个必然失败的入口）。

红果榜单与试看需要服务端「全球影视榜单」（GlobalRankPro）v1.2.0 及以上，并在插件配置里勾选要抓的分榜。

修复

• 「正在下载」的卡片不显示是第几集：整季包订阅逐集下载时，宿主 /download/ 顶层的 season_episode 只到季（S01），真正逐集的集号在 media.season + media.episode（S01 / E06）里，于是所有卡片都只写「第1季」。现在季集按 media 优先取，其次退回顶层 season_episode，再退回下载中那个文件名里的 S01E06，最后才交给标题解析兜底 —— 卡片变成「第1季 第6集」。
• 「等待整理」的卡片上也有播放按钮：之前判断「能不能播」放在点击那一刻，而按钮的显示只看了「插件装没装」，于是还没整理完（没有完整媒体文件）的卡片照样挂一颗 ▶ —— 点下去什么都不会发生，比没有按钮更让人困惑。现在显示条件与播放条件用同一份判断：只有已整理成功且目标文件存在的记录才给 ▶。
• 播放页不是真全屏：上一版只是把播放页盖在 App 的顶栏和底导航之上，系统状态栏与导航栏仍然占着，画面实际少了一条；画面又按「完整显示」缩放，16:9 内容在 20:9 的屏幕上左右各留一条黑边，看起来就像没全屏。现在进播放页会隐藏系统栏（边缘上滑可临时呼出），画面默认铺满；控制条右侧新增全屏钮，可在「铺满 / 完整显示」之间切换（看老片 4:3 或边缘有字幕时用）。
• 控制条起播即消失：原来一开始播放就把控制条收起来，全屏钮就算有也看不到。改为起播后停留 3.5 秒再自动隐藏，点画面随时叫回来。
• 旋转屏幕不再重建页面：configChanges 补上 screenLayout|smallestScreenSize（带挖孔或三键导航的机器旋转时这两项也会变，漏了会导致播放页连同播放状态一起丢）。
• 选集只看得到当前这一集：之前把「同一季」等同于「同一个种子」（同 download_hash）—— 这只对整季包成立；逐集下载时每集是独立种子、hash 各不相同，聚合出来永远只有一条，于是选集入口根本不出现。现在两级口径：先按同一个种子聚合（整季包最精确，不会串剧），只有一条时退回同一部剧的同一季（剧名主干 + 季号，抹掉 S02E12 / 第12集 这类标记再比）。仍然只收「整理成功且有目标文件」的记录，失败的集不会混进来点一个错一个。

优化

• 播放页中央那颗播放钮重做：原来是「半透明黑圆 + 尖角白三角」，压在暗画面上等于没有边界。现在换成主色渐变章（#737CF0 → #454EC4 斜向 135°），外圈一层同色系柔光，按下缩到 0.94 再弹回（与底部导航同一套弹性曲线）；直径 60 → 64dp。柔光用 drawBehind 画径向渐变而不是 Modifier.shadow —— 彩色阴影只有 API 28+ 认，低版本会掉成黑边，看着更脏。红果试看页原来是同一个钮，一起换（抽成公共组件 PlayBadge，两处不再各写一份）。
• 「下载记录」改名「下载完成」，不再掺整理状态：这几天一直在修「App 里一堆等待整理、服务器上却看不到待整理」——根因是宿主的下载记录与整理记录 download_hash 经常不是同一个（整季包逐集下载、种子重下都会换 hash），任何「这条下载到底入库没」的推断都会造假。干脆不推断了：这个页签只对「下载完成」负责，卡片就三行 —— 标题（剧名 + 季集）、站点 + 下载时间、原始文件名（种子名 torrent_name），一条整理状态都不出现；整理结果全部归「整理记录」页签，两个列表各说一件事。列表口径同时收敛成最近三天（原来是「最近 30 条 ∪ 三天内整理失败的」，后者已经不需要了）。
• 整理记录卡片改看原始文件名：原来右侧跟的是目标文件名（媒体库按自己的规则重命名后的 某剧.2026.S01E13.1080p.mkv），对「我当初下的是哪个文件」没有信息量；现在换成 src 的原始文件名，也就是种子里的那个文件。
• 播放入口挪到「整理记录」页签：下载记录列表里混着「等待开始下载 / 正在下载 / 等待整理 / 整理失败」，同样是这串卡片，有的能播有的不能，得逐条看标签才知道 —— 播放键挂在那里本身就是误导。现在下载记录不再出现 ▶，播放入口统一放在整理记录页签：那张列表的内容就是整理回执，能播与否和「已整理到媒体库」这个标签是同一份判定。整季包的选集聚合、失败条目不参与聚合等行为都不变。
• 整理记录里的播放钮重做：原来是一颗 28dp 裸图标，和失败卡上的「重新整理」同尺寸、同主色、同图标大小 —— 两张卡并排看，分不出哪个是这张卡的主操作，反而更像又一个功能键。现在换成 30dp 主色实底圆 + 15dp 白三角，靠「实底 vs 无底」把主次拉开：实底 = 点这里看片，裸图标 = 重新整理这类功能键。柔光比播放页那颗收得更淡（18%，半径 0.62×直径），否则压在白色卡片上会糊出一圈紫边；按下缩到 0.9（CardPlayButton，与 PlayBadge 同文件、同弹性曲线）。
• 资源卡底部标签重排：顺序固定为 站点 → 含最新 → 整季/多集 → 体积 → 做种，站点名固定最左 —— 同站资源在列表里纵向对齐成一列，按站找资源不用逐张看。规矩是：能排成一行就一行（没有「推荐下载」时，订阅/下载跟标签在同一行、靠右）；只有标签实在放不下、或出现「推荐下载」时才分两行 —— 第一行标签吃到右边缘，排不下的顺延到第二行（有推荐时接在「推荐下载」后面，没有推荐时从第二行最左排起），订阅/下载在第二行右端。
• 体积标签去掉单位里的 B：3GB → 3G、807MB → 807M，标签窄一点就少折一次行（下载记录里的「体积 3GB」保持原样）。
• 「★推」改成「👍 推荐下载」：绿实底 + 大拇指图标 + 文字，比原来两个字的「★推」好认，也是整张卡唯一的实底标签。
• 红果海报改走插件匿名转发：原来跟 TMDB / 豆瓣共用宿主图片代理（要登录态、过期就要重登重试），现在红果图单独走插件的匿名转发接口，不需要登录态，失败也不会触发一次多余的重登。

说明

• 下载记录播放是原码流直出、不转码：H.264 / HEVC + AAC 没问题，DTS / TrueHD 音轨会没有声音，属于手机解码能力限制。
• 播放凭据走 Authorization 请求头，不把 token 拼进 URL（URL 会落进 nginx access.log、Referer 与投屏外链，而这串 JWT 是 8 天有效的全权凭证）。
• 红果的剧集信息、海报、试看片源均来自公开接口；完整剧集请在红果 App 内观看，App 不提供全集来源。

---

其余版本见 CHANGELOG.md。

v0.4.5

优化

• 三行图标选中态统一：榜单页签、猫眼平台行、Netflix 地区行原本是三套选中语言（单色实底反白 / 多色浅紫底 / 贴图标描边），现统一为一套「浅紫底格子 + 主色描边装在格子上，图标一律保持原色」——旗帜、品牌 logo、单色图形都不再被改色或压住，三行圆角同步统一为 11dp。
• 三行卡片右边缘齐平：原来「更新 …」时间戳挂在榜单页签行尾，把该行白卡挤窄近 90dp。现把更新时间挪到下方列头行右端，三行卡片全部铺满等宽。
• 名次角标改 20×20 方块：原来是随文字伸缩的 17×26 竖条，一屏十张卡形状不一；现在固定 20×20，数字居中，全部卡片形状一致。
• 时间戳口语化：榜单「更新」与下载页「整理于」共用的精简时间戳，今天的显示「今天 10:00」、昨天显示「昨天 10:00」，更早的保持「10-18 10:00」。
• 版式体系统一：卡片圆角统一 12dp（首页榜单卡 10→12、设置卡 14→12）；卡片间距统一 8dp（首页双列横向 12→8、设置两张折叠卡间 12→8）；页签胶囊圆角统一 11dp（PillTab 14→11）；下载/订阅页页签行上边距 7→16dp，与首页节奏对齐；搜索框内按钮圆角 12→8dp，与容器内弧平行。
• 猫眼列头改名：「剧集热度 / 综艺热度」→「全网剧集热度 / 全网综艺热度」，单榜标题提示同步更新。

新增

• 下载页「系统正在整理」进度卡：服务端自己发起的那批整理（下载完自动整理、后台重新整理）还没干完时，下载板块页签上方常驻一张卡，显示「正在整理 N 个文件 · 还剩 M」与进度条，底部还标出正在处理哪一部、哪个文件（如「心动的信号 第9季 · 正在处理 S01E12.mkv」）。点卡片跳「整理记录」看逐条回执，队列清空后整卡自动收起。
• 「待人工复核」用上警示橙：入口按钮与弹窗徽标改用新增的警示橙（#B26A16）。项目里的颜色分工由此补全：红 = 已经做错了，橙 = 没出错但停在半路等你拍板，青 = 流程还在自动跑。橙色那颗与旁边靛蓝的「重新整理」正好对照 —— 一个是「这件事得你决定」，一个是「交给机器再跑一遍」。

优化

• 整理进度不再在其它板块打扰：顶栏下方那条全局整理细条撤掉，搜索 / 订阅 / 设置三个板块都不再显示；进度统一收敛到下载板块，想看就进下载页（那里还多一行正在处理的文件名）。
• 下载记录按入库结果排序：还没整理完的（整理失败 / 正在下载 / 等待整理）整体排到前面，已入库的沉到后面；组内仍按下载时间由近到远，不会把刚下完的片子顶到上周的失败条目后面。
• 设置页「榜单」卡微调：Netflix 图标按官方 N 的宽高比（0.551）收窄，排序胶囊左右留白恢复对称；三行各自重复的「依赖插件」徽标收成卡头标题旁的一颗。
• 榜单底部提示不再写「更多」：原本那枚「⌄ 更多」只是提示这列还能往下滑，并不可点，字面却像个「查看更多」的入口；而且每列就 10 条、滑到底也不会再加载，名字比它做的事许诺得多。现改为「⌄ 还有 N 条」，说清屏幕下面还剩几条，数字随滑动递减、到底自动消失。

---

其余版本见 CHANGELOG.md。

v0.4.4

新增

• Netflix 榜单：首页榜单新增第四个来源「Netflix」，一次拉取服务端全部 16 个榜后在本地按地区筛选，切换地区不再重复请求。内容按剧集 / 电影双列展示，全球榜额外显示观看时长，地区榜显示上周排名变化。
  • 顶部地区切换行为一排 8 枚图标：全球（英语）、全球（非英语）、美国、日本、韩国、中国香港、中国台湾、新加坡，选中态为主色描边（旗帜本身是彩色实底，不能上面再盖色块）。
  • 「设置 → 首页功能 → 榜单」新增「Netflix 榜单」开关，默认关闭；开关与豆瓣 / 猫眼共用同一组来源排序。

  提示：需要服务端安装「全球影视榜单」（GlobalRankPro）v1.0.0 及以上并在插件配置里开启 Netflix 数据源。

优化

• 奈飞标识按官方几何重画：此前榜单页签里的 N 是被压扁的 24×24 方形，笔画也只有官方的一半粗，辨识度很差。现已按 Netflix 官方矢量（原图 551×1000，宽高比 0.551）重绘：竖条加粗到字高的 20%，斜带为左上→右下方向且左边缘恢复成官方的外凸曲线；左竖、右竖、斜带三条笔画各自独立填充，重合处不会被反向绕向挖空。
• 三处图标行统一为同一尺寸：榜单页签、猫眼平台行（全网 / 腾讯 / 爱奇艺 / 芒果 / 优酷）、Netflix 地区行现在受同一个尺寸常量控制（26dp）。「一样大」按视觉外框计而不是 Modifier.size() 的数值：豆瓣方块、电影磁贴、奈飞 N、平台行四个彩色 logo、地区行 8 枚旗帜都是铺满整格的图形，统一缩到 0.9 后才与自带圆形留白的猫眼图形齐平。实测三处图块均为 23.3dp。
• 首页字号整体调大一档：榜单卡片标题 12→13sp、副信息行 10→11sp、季度角标 9→10sp、列头 12→13sp、加载与空态提示 12→13sp、榜单大标题 13→14sp，行高同步跟进；在半宽卡片约 94dp 的可用宽度下不会截断。
• 时长单位压缩：Netflix 观看时长由「万小时 / 亿小时」改为「万时 / 亿时」，省出的宽度让前面的年份与后面的时长都能完整显示。

---

其余版本见 CHANGELOG.md。

v0.4.3

修复

• 首页榜单取不到数据：服务端「猫眼榜单」插件已并入「全球影视榜单」（GlobalRankPro，猫眼 + Netflix 合并后的统一插件），旧接口 /plugin/MaoyanPro/rank 随之下线（返回 404），App 的猫眼电视榜单与电影票房榜因此一直空着。现已改用新接口 /plugin/GlobalRankPro/rank 并带上 source=maoyan，返回结构与旧版一致，界面显示不变。

提示：服务端需安装并启用「全球影视榜单」插件且至少刷新过一次，榜单才有数据。

---

其余版本见 CHANGELOG.md。

v0.4.2

新增

• 首页搜索框改版：换成与首页卡片同族的搜索卡（52dp 高、14dp 圆角、白底），聚焦时 1.5dp 主色描边。右侧「直接搜种子」入口并进卡片内部（40dp 圆角按钮，有输入时浅靛蓝底 + 主色图标），不再是一颗飘在框外的白方块，输入区宽出 60 多 dp。点卡片任意位置（含放大镜）都会聚焦输入框；结果态左侧为返回箭头，点一下回首页清状态。

修复

• 「最新集优先」排序不准：此前该策略只按「是否覆盖到最新已播集」分两组，组内纯比做种数（做种 96 的 E33 会压过 E34），而且剧集已播完或总集数查不到时会完全退化成「做种速度优先」——和设置里写的目的完全不符。现改为按覆盖到的最大集号降序排：E34 → E33 → E32 …，同集号才比做种速度；整季包算作覆盖全集、排在最前；已完结的剧用本批资源的最大集号兜底，不再失效。卡片上的「含最新」绿标同步改用同一基准，标注与排序始终一致。

优化

• 榜单文案统一：设置页「榜单」卡与首页单榜标题里的「豆瓣榜单」「猫眼榜单」改为「豆瓣电视榜单」「猫眼电视榜单」，与榜单实际内容（国内 / 国外剧集周榜、猫眼电视剧 / 综艺热度榜）对齐。

---

其余版本见 CHANGELOG.md。

v0.4.1

新增

• 全局整理进度条：有文件在整理时，顶栏下方出现「⟳ 正在整理 N 个文件 ⋯ 还剩 M」＋底部细进度条，首页 / 搜索 / 下载 / 订阅四个板块都能看到，切走再切回、甚至退到后台回来也还在（显示的是宿主真实队列，不是本地记账）。点一下跳到「下载」看明细；队列里没有未完成任务时自动收起。有任务时 4 秒刷新一次，空队列 30 秒一次（发现「下载完自动整理」），提交整理后立即出现。
• 海报缓存：海报改为内存 + 磁盘双缓存（专目录 160MB，容量上限内自动淘汰），下载 / 搜索 / 订阅三处共用 —— 同一张海报在任何一处加载过，其他页面直接命中本地、不再重复走服务器代理。代理取图与直连取图的 URL 结构完全不同（代理还带 ?url=），现归一化成同一个缓存键，一张图全局只存一份。

修复

• 切网后榜单报错、网络恢复也不自愈：此前切网后榜单常停在「加载失败」，得切到另一个榜再切回来才恢复。原因有二：一是重载时机取的「链路刚连上」，那一刻 DHCP / DNS 还没就绪，重载必然失败且不会再试；二是同一 Wi-Fi 断开再连回时系统会复用同一个网络对象，导致「恢复」被判成「没变化」而漏掉。现改为**只认「网络已验证可出网」**才触发重载，并把切网瞬间接连到来的多个回调合并成一次（不会连刷两三轮闪「加载中」）；失败的页面再按 2s → 4s → 8s → 16s → 30s 退避自动重试。网络一恢复，榜单 / 搜索 / 订阅 / 资源列表 / 下载页都会自己回来，不用切页签。
• 部分海报一直刷不出来：取图改为「服务器代理 → 重登刷新 cookie 再试 → 豆瓣直连（补 Referer 绕防盗链）」三轮降级；三轮都失败时隔 3 秒整轮重来（最多 2 轮），救「进页面时网络正好在切换」的那几张，不必再退出页面重进。
• 订阅日历海报 418：日历里的海报此前绕过代理直连豆瓣，被防盗链挡成 418 空白，现统一走同一套取图与缓存逻辑。

说明

• 首页榜单的海报 / 上映日期依赖 MaoyanPro 插件 v1.2.7+。本版发布时插件同步升级：重写榜单识别调度（按缺图次数排序、限额自适应、带时间预算），并把「无海报 / 无中文名 / 无日期」三类兜底补图前置，修复「有身份但没图」的条目被当成有效缓存不再补图的问题。

---

其余版本见 CHANGELOG.md。

v0.4.0

新增

• 搜索偏好：「设置 → 首页功能 → 搜索」新增四项偏好——直接搜种子入口、搜索结果补主演 / 首播日、结果推荐策略（智能推荐 / 最新集优先 / 整季包优先 / 做种速度优先 / 小体积优先）、画质偏好（4K / 1080P / 不限），改完回搜索页即生效。
• 电影票房榜：首页榜单新增「电影」页签（场记板彩色 logo），左栏国内年度票房、右栏全球年度票房（票房 + 上映日期）。依赖 MaoyanPro 插件，默认关闭，可在「榜单」卡开启（全球榜完整上映日期需插件 v1.2.4+）。
• 榜单排序：「榜单」卡新增「榜单排序」栏，长按拖动豆瓣 / 猫眼 / 电影 logo 调整首页页签顺序，松手即保存；已关闭的榜变淡显示、仍可拖动。

修复

• 搜索状态跨板块保留：搜索后切到下载 / 订阅 / 设置再切回，搜索词、结果与榜单页签原样保留（此前切走即清空）。
• 结果推荐策略生效：「最新集优先」此前与「智能推荐」排序完全相同，现改为在含最新已播集的资源中优先挑做种最快的。
• 中文命名的资源识别：标题写「第一季」「第十二集」这类中文数字时，此前无法识别整季包 / 集号，导致「整季包优先」形同虚设、选集过滤漏条；现已全面支持中文数字季号 / 集号。

优化

• 榜单页签换成品牌彩色 logo（豆瓣绿 / 猫眼红 / 场记板）。
• 设置页「榜单」「搜索」卡默认收起，整体更紧凑；榜单排序栏排版压缩。

---

其余版本见 CHANGELOG.md。

v0.3.1

修复

• 切换网络后无法连接服务器：此前切换 Wi-Fi / 移动数据后 App 会连不上，必须关闭 App 重开、或到「设置」里点一次「重新连接」才能恢复。原因是切网后已失效的连接仍留在连接池里被继续复用，而各页面只在进入时加载一次、失败后没有重试入口，网络恢复后不会自动重试。
• 本版加入网络变化监听：检测到默认网络切换时，自动清空连接池并触发当前页面重新加载。切网后无需任何手动操作，网络一恢复页面即自动刷新（首页榜单 / 搜索 / 订阅 / 资源列表 / 下载页均已覆盖）。
• 补齐网络状态监听所需的 ACCESS_NETWORK_STATE 权限。
• 顺带修掉一个隐藏问题：订阅页加载失败后再重新加载成功时，旧的错误提示不会消失。

---

其余版本见 CHANGELOG.md。

v0.3

许可变更

• 本项目自本版起由 MIT 改为 GNU Affero General Public License v3.0（AGPL-3.0） 发布，完整条款见 LICENSE。
• 核心要求：任何分发本程序、或分发基于本程序修改后的版本（包括以网络服务形式对外提供），都必须把完整源代码一并公开，并以 AGPL-3.0 授权。
• v0.2 及以前的版本仍为 MIT。MIT 授权不可撤销，已经获取的历史版本副本可继续按 MIT 条款使用；本次变更只对 v0.3 起的版本生效。

说明

• 本版未改动任何功能代码，与 v0.2 功能完全一致，仅调整开源许可与文档。

---

其余版本见 CHANGELOG.md。

v0.2

升级前请注意

• 登录方式有调整：本版移除了「API 令牌」登录，统一为「服务器地址 + 账号密码」。此前用令牌登录的用户，升级后需要用账号密码重新登录一次。
• 猫眼榜单依赖服务端插件：需要在服务端安装并刷新「猫眼榜单」插件（MoviePilot-Plugins）。没装插件时首页只显示豆瓣榜单。

新增

首页榜单

• 首页新增豆瓣剧集周榜（国内榜 / 国外榜）和猫眼热度榜（剧集 / 综艺），点条目可直接发起搜索
• 两个榜单都开启后，首页顶部出现「猫眼榜 / 豆瓣榜」页签切换；只开一个时直接显示带标题的榜单
• 榜单显示数据更新时间，每条带该季首播日
• 两列榜单可各自上下滑动，底部有「更多」浮动提示

订阅页

• 页签扩展为五个：电影 / 电视剧 / 音乐 / 工作流 / 日历
• 「日历」：未来一周的播出计划，按「今天 / 明天 / 后天 / 周X」分组，同一天的横向排列、可左右滑动
• 「工作流」：查看服务端工作流，支持一键执行、启用 / 停用
• 「音乐」：单独展示音乐订阅

下载页

• 页签扩展为三个：正在下载 / 下载记录 / 整理记录
• 「整理记录」：最近三天的整理回执按时间由近到远排列，顶部有「共 N 条 · 失败 M」汇总
• 重新整理：整理失败的条目可单条重试（可选「原有路径」或「自动匹配路径」），也可批量重试（按日期多选，默认勾选最近一天）
• 待人工复核：服务端卡在「创建目标目录」等人确认的任务集中在这里，可分组勾选后重新整理
• 整理失败会显示失败原因、失败次数，以及服务端给出的恢复建议

登录

• 支持二步验证（动态验证码）：账号开启二次验证后，登录页会自动出现验证码输入框

设置

• 「首页功能」卡片：可分别开关豆瓣榜单 / 猫眼榜单，改完回首页即生效
• 「关于」卡片：显示作者与项目仓库地址；猫眼榜单旁有「依赖插件」入口，可直达插件仓库

改进

• 首页榜单条目优化：名次由左侧单独一列改为海报左上角角标，把腾出的宽度让给剧名；剧名放宽到两行，「此处通往繁星」「心动的信号」这类长名不再被截断
• 季号改为角标：标题里的季号统一写成 S1 / S2 并移到海报右下角（「现在就出发 第4季」显示为「现在就出发」+ 右下角 S4），标题行整行留给剧名
• 榜单滑到底时，底部「更多」浮层不再压住最后一条的日期
• 正在下载卡片重排：首行「剧名 + 季集」，副行「站点标签 + 画质规格」（分辨率 / 杜比视界 / 杜比全景声 / HDR / 来源）
• 搜索结果改版：由海报网格改为一屏一条的横向卡片，显示简介、类型与首播日、前三位主演
• 顶部导航：四个入口改为图标按钮，与底部导航统一视觉并加了按压反馈
• 自动刷新节流：有下载 / 整理 / 待复核任务时 5 秒刷新一次，空闲时 30 秒；App 退到后台停止刷新
• 刷新不再被中断：切换页签或离开下载页，已在提交的整理任务会继续跑完
• 下载页智能落地：有任务时停在「正在下载」，没有任务时直接进「下载记录」
• 订阅列表按订阅时间由新到旧排序
• 删除订阅 / 下载任务统一走确认弹窗，删除过程中显示加载状态
• 连接设置折叠时也能看到状态圆点、服务器地址和登录账号

修复

• 顶栏「已连接 / 未连接」误判与反复跳变：只有真正断网才判离线，服务端返回 401 / 500 不再被当成断网
• 豆瓣海报因防盗链（418）不显示
• 猫眼榜单海报字段不匹配导致图片为空
• 连续搜索时旧结果覆盖新结果
• 长英文种子名把中文剧名挤断（已补断行点）
• 单次请求超时从 300 秒收紧到 60 秒，避免一个卡死的请求拖住整轮刷新

内部整理

• 颜色规范收敛到 ui/Colors.kt，原先散落在各页面的几十处色值统一走 token
• 抽出公共组件：确认弹窗、状态小标签、胶囊页签、验证码输入框、时间格式化
• 登录过期自动重登增加并发去重，避免同时失效时连续触发登录

---

其余版本见 CHANGELOG.md。