# Changelog ## Unreleased - 主题设置新增应用图标切换：提供经典紫、午夜蓝、落日橙、薄荷青、霓虹影院、极光玻璃、落日跃动与黑白工作室 8 套图标，支持 Android 与 iOS 原生桌面图标即时替换并持久化选择。 - 重新设计午夜蓝、落日橙与薄荷青应用图标，沿用经典图标标识与白底结构生成同源色彩变体，并修正图标透明边导致的底色异常。 - 美化主题设置应用图标区域，优化响应式图标卡片、统一方形原比例预览、收紧网格留白，并补齐选中描边与切换中反馈。 - 修复主题设置应用图标网格的 GetX 响应式监听范围错误，避免进入页面时触发 improper use of a GetX 异常。 - 个人页新增免返回登录页的账号切换能力：切换时同步更新服务器地址、Token、Cookie、用户配置及相关会话缓存，避免账号与服务端状态不一致。 - 账号切换列表 Sheet 视觉优化：新增清晰的标题区、账号卡片、服务器信息、当前账号标识、动态头像首字母与主题适配，并补充加载及错误反馈。 - 账号切换相关提示统一使用通用 Toast 组件，提升全局交互反馈的一致性。 - 修复订阅季度弹层中嵌套 `Row` 使用 `Expanded` 导致的无界宽度布局异常，避免 `RenderBox was not laid out` 连锁错误。 - 简化 `CachedImage` 加载状态：移除重复的 shimmer 动画与复杂进度装饰，统一为轻量进度指示器和错误占位状态。 - 探索页下方推荐内容重构为混合列表：交替使用宽幅沉浸卡、左图信息卡与右图信息卡，增加浏览节奏并减少视觉疲劳。 - 探索页 Banner 视觉优化：缩短高度、收敛光影、强化底部渐变与文字层级，突出主视觉内容。 - 探索页筛选来源区域弱化：降低控件高度、透明度与间距，移除多余描边，并使用选中勾号保持状态辨识度。 - 探索页列表卡片与加载/空状态容器移除冗余描边，改用背景层次与柔和阴影区分内容。 ## 2026-07-09 - 新增字幕手动上传（SubtitleManualUpload）原生适配：支持本地资源搜索、目标选择、在线字幕搜索/预览/写入、匹配历史与自动入库队列等完整流程。 - 字幕上传首页运行概览与资源列表 Item 视觉精简，剧集展示季/集信息，电影仅展示视频数量；列表底部分页统一为 `LoadMoreFooter`（Cupertino 风格 loading）。 - 多功能页新增插件侧边栏入口（`/api/v1/plugin/sidebar_nav`），实用工具区收敛，插件中心入口并入「插件入口」标题行。 - 多功能页下载器区域改为直接展示下载器列表：点击条目进入对应下载器页面，点击标题进入下载器列表；合并 Downloaders 配置补齐连接地址，修复跳转详情时「URL 不能为空」。 - 指定仓库安装页支持一键填充官方插件仓库地址，优化无插件清单时的错误提示；暗色模式下统一 sheet 背景与 header 颜色。 - 系统消息页布局与输入交互优化：宽屏自适应内边距、命令选择与消息卡片样式收敛。 - 文件手动整理传输类型文案统一：`hardlink` 归一为 `link`。 - 远程推送与 iOS Widget 导航增强：通知可按路由直达对应页面，并抑制短时间内重复导航。 - Dashboard / 多功能页引入 `DashboardScaffold`，统一背景与布局管理；多处页面背景与主题表现进一步收敛。 - 版本号更新至 `1.2.0+31`。 ## 2026-06-29 - 新增通用 Lottie 加载组件 `AppLoading` / `AppLoadingIndicator`，媒体搜索页搜索过程改用 `loading.json` 动画，替换原自定义粒子 loading。 - 搜索首页推荐内容加载态改用统一 `AppLoading` 动画，提升加载反馈的可见性与一致性。 - 新增玻璃胶囊搜索条 `GlassSearchFloatingBar`，统一订阅页、已安装插件页、插件市场页的底部筛选/搜索/排序浮条样式，修复深浅色主题下底色与文字颜色不一致问题。 - AI 助手全局悬浮入口改版：接入 Lottie 小宠物动画、极光光环与玻璃容器，长按菜单改为标准 `CupertinoContextMenuAction`，修复菜单弹出布局异常。 - 探索页 Discover 卡片与区块标题字重、字距收敛，整体视觉更轻。 - Agent 对话气泡布局优化：按用户/助手与屏宽自适应最大宽度与内边距。 - 插件详情改为可拖拽高度的 Bottom Sheet 展示，插件市场列表点击统一走 `showPluginInfoSheet`。 - 下载器详情页改为底部 Tab Shell：种子列表、qBittorrent RSS、客户端信息分 Tab 展示；多选批量操作时自动隐藏 TabBar。 - 种子列表新增实时搜索与多选模式，筛选/排序与列表项交互重构；新建下载改为可拖拽 Bottom Sheet，资料页与 RSS 列表布局同步优化。 - 升级 `altman_downloader_control` 依赖，适配 `DownloaderShellPage` 路由入口。 ## 2026-06-25 - 新增 Android APK 热更新能力：应用设置页“当前版本”支持检查远程发布版本、下载 APK、查看下载进度并调起系统安装器。 - Android 更新检查改为仅识别 `release-v版本-日期` 格式的 Release，避免误将 HarmonyOS/OHOS 发布识别为安卓版本。 - 修复 Android Release tag 中日期被误识别为构建号的问题，版本比较仅使用实际版本号。 - GitHub Release 请求支持携带系统基础设置中的 Github Token，降低匿名请求触发 API 限流的概率，并补充限流场景提示。 - APK 下载支持应用内后台继续下载，进度面板可收起后再次从版本入口打开。 - APK 下载新增取消能力，取消或失败时会清理未完成安装包，避免残留损坏文件。 - iOS 设备检查更新时仅展示 Release 更新日志，并提供前往 GitHub Release 页面入口，不触发 APK 下载。 - App 启动时自动清理本地更新缓存中的历史 APK 文件，减少无效安装包占用空间。 - Android 原生侧补齐 APK 安装权限、FileProvider 与安装通道，兼容未知来源安装授权流程。 ## 2026-06-22 - 登录页历史账号管理增强：账号选择弹层完成 Material 适配，支持删除已保存账号、二次确认及选中状态安全清理，并重新优化账号卡片的信息层级与操作入口。 - 搜索首页输入框清除按钮提升对比度与点击范围，改善暗色背景下按钮不易辨识的问题。 - “更多”页面统一为深海军蓝背景与蓝紫环境光风格，优化 AppBar 与内容区衔接，并修复订阅区、实用工具区异常留白。 - “更多”页面订阅信息重构为更紧凑的电影与剧集入口，减少重复数据展示并扩大海报可视区域。 - 下载器配置列表 Item 重新设计，精简累计统计信息，突出客户端身份、连接状态、实时上下行速度与可用空间。 - 推荐页“正在热映”改为紧凑竖版海报卡片，标题融合至海报底部，完整展示海报并保留评分与长按操作能力。 - 媒体整理记录 Item 重构，强化海报、状态、整理方式、来源与目标路径、文件信息的视觉层级。 - 媒体整理记录新增详情弹层，支持完整查看整理摘要、路径、文件列表、关联媒体标识、下载 Hash 与错误信息，长文本可选择复制。 - 探索、更多、搜索与 Dashboard 页面补齐亮暗主题适配，统一页面背景、卡片、边框、文字层级及状态栏文字颜色。 - 应用设置页统一跳转项与开关项样式，收敛图标、间距、标题、副标题和尾部控件，并支持点击整行切换开关。 - 系统消息页面与消息 Item 重新设计，优化筛选入口、消息卡片层级、类型强调、海报消息、用户气泡及底部输入区域。 - 下载器 Sheet 移除强制暗色主题，完善亮暗模式下的背景、面板、输入框与选择项表现，并缩小保存目录 Item 宽度。 ## 2026-04-29 - 媒体搜索结果页加载态优化：首轮搜索中仅展示单一的星际跃迁粒子 loading，避免头部、摘要与空状态同时闪现。 - 媒体搜索 0 结果空状态重设计：新增暗色沉浸式搜索图形、关键词提示与重新搜索入口，并区分无结果与错误状态。 - Dashboard 首页重构为更贴近设计稿的 Stitch 风格布局，页面直接编排各模块内容，统一首页信息层级与视觉节奏。 - 废除旧的 section 与 header 包裹结构，Dashboard 组件改为基于共享卡片样式直接渲染，减少重复容器嵌套。 - Dashboard 主题联动增强：补齐亮色模式表现，主体强调色跟随当前主题主色动态变化，并让任务等核心文本颜色随系统主题切换。 - Dashboard 文案统一调整为简体中文，页面标题更新为 Dashboard。 - CPU 与内存负载卡片展示对齐：统一数值区高度，并补齐趋势波动曲线与无数据时的占位走势。 - 修复媒体服务器未启用或列表为空时下拉刷新触发的异常，优化最近媒体与继续观看的数据刷新逻辑。 ## 2026-04-23 - 搜索站点选择弹层交互优化：顶部标题操作区固定，season 区与下方站点列表改为联动滚动，避免上下区域分离滑动带来的割裂感。 - 搜索站点选择弹层高度调整为屏幕的 80%，并修复 season 数量较少时选项未铺满可用宽度的问题。 ## 2026-04-17 - README 增加 Web 功能预览链接（Vercel 部署）。 ## 2026-04-16 - 媒体详情页季列表优化：season >= 5 时固定 3 页展示，按从上到下排列；季列表整体高度随条目数自适应，确保卡片完整显示。 - 宽屏适配：屏幕宽度 > 600 时，季列表 PageView 的 viewportFraction 调整为 0.7（其余保持 0.9）。 - 季详情页沉浸式改版：顶部大图 SliverAppBar、订阅/搜索双按钮（搜索按钮使用 secondary 配色）、剧集列表卡片化；每集新增入库状态展示并遵循“搜索页入库状态”开关（关闭时以禁用态呈现）。 ## 2026-04-13 - 主导航底部栏改为 `flutter_floating_bottom_bar`，随滚动显隐；`IndexedStack` 各 Tab 仅当前页绑定滚动控制器，避免多列表共用一个 `ScrollController`导致切换异常。 - 搜索首页：未输入时采用与历史搜索页类似的沉浸式顶栏 + 内嵌搜索条，并展示「为你推荐」分页与「浏览」分类网格；输入后仍为原有分类建议列表样式。 - 搜索首页移除独立「最近搜索」区块；本地搜索历史改为聚焦时在输入框下方以建议列表展示，点击即发起搜索。 - 新增 `SearchKeywordHintsService`：在推荐、探索接口成功拉取媒体列表后，将标题等字段去重合并为本地关键字提示（SharedPreferences 持久化，与 Realm 搜索历史合并展示），便于快速选词。 ## 2026-04-08 - iOS 订阅日历 Widget 补全实现与展示逻辑，增强稳定性与可用性。 - 登录与自动登录链路新增站点数据预热，减少 Widget/站点相关模块首次进入时的等待与失败概率。 - 文档补充 HarmonyOS（OHOS）分支与自签说明。 ## 2026-04-03 - 媒体整理页新增列表/按标题聚合两种显示方式，支持右上角快速切换并记住聚合视图折叠状态。 - 媒体整理页聚合视图支持分组多选、反选与批量删除，选择态下同步收敛顶部筛选、条目操作入口与底部操作栏交互。 - 媒体整理页界面细节优化：分组卡片、选择入口、右上角视图切换按钮与卡片选中态样式统一收敛。 - 媒体整理页删除完成后会自动重置筛选条件到全部，并在进入远端加载前强制刷新一次图片 Cookie。 - 媒体搜索列表页在请求搜索结果前新增图片 Cookie 强制刷新，降低海报加载失败概率。 - 下载器直连下载增强：兼容普通直链与带 enclosure 请求描述的下载链路，支持按 method、header、params 解析后再获取种子文件。 - 修复部分站点直连下载第一跳参数位置不匹配的问题，接口返回“参数错误”时会自动改用 query 参数重试。 - 下载器直连下载补充关键链路日志，便于排查 enclosure 解析、第一跳取链与第二跳下载失败原因。 - Dashboard 编辑页保存逻辑改为纯本地配置管理，移除远端 Dashboard 配置与排序同步链路。 - Dashboard 编辑页内部组件收敛为 Material 交互，统一选择项卡片点击反馈与状态表现。 - Dashboard 编辑页右上角保存态 loading 调整为更轻量的 `CupertinoActivityIndicator`。 - Dashboard 数据刷新链路优化：移除重复定时刷新，避免同批数据被高频重复拉取。 - 修复 Dashboard 页面错误重复创建控制器与 Realm 服务实例的问题，减少状态分叉与额外开销。 - 调整 Dashboard 刷新范围，仅按当前展示组件加载对应数据，减少不必要请求。 ## 2026-04-02 - 新增 App 推送能力接入，补充极光推送基础链路与宿主代理转发。 - App Push 自定义插件支持读取表单中的推送 token 并应用为 JPush alias。 - 推送配置页补充一键应用入口，支持在插件页内直接完成 alias 绑定。 - iOS 推送工程配置补充 APNs entitlement 与桥接适配，修复原生接入链路问题。 ## 2026-04-01 - 下载管理页种子列表重构为更紧凑的信息卡布局，收敛标题、进度、统计项与底部元信息的展示密度。 - 下载管理页种子统计区改为自然换行布局，移除固定宽度裁切并提升统计文案字号与可读性。 - 下载管理页种子进度显示优化：0 进度任务保留最小可见进度条，文案仍显示为 0。 - 下载管理页宽屏布局适配：屏幕宽度大于 600 时，种子列表改为双列网格展示。 - 修复 qBittorrent 增量同步时热度、可用性等字段偶发丢失导致列表信息时有时无的问题。 - 调整种子列表底部做种/下载人数展示口径，改为使用总做种/总下载数而非当前连接 peers 数。 - 下载器配置列表样式重构：卡片信息层级与运行指标区重新设计，增强与站点管理页的视觉区分。 - 下载器指标区新增合并分栏展示（总下载、总上传、上/下比），并统一“上/下比”计算口径为累计上传/累计下载。 - 下载器配置列表新增隐私模式开关，支持对 URL 地址信息进行模糊遮挡显示。 - 隐私模式开关调整为 `title + switch` 交互样式，并支持本地持久化恢复。 - 媒体整理页加载链路优化：进入页面优先展示本地缓存，再请求远程最新数据，减少首屏等待体感。 - 媒体整理页新增历史缓存读写能力（按关键词维度缓存），远程请求失败时保留已展示数据避免列表闪空。 - 媒体整理页下拉刷新改为并行刷新存储与历史数据，缩短刷新耗时。 - 媒体整理页信息栏加载态调整为左侧 `CupertinoActivityIndicator`，移除右上角独立 loading 图标。 - 媒体整理记录项操作模式文案本地化：`move/copy/hard link/soft link` 显示为中文。 ## 2026-03-31 - iOS 影视推荐 Widget 请求解析增强，兼容多种返回结构（`data/results/items/list/subjects/rows`），修复部分场景下空白显示问题。 - iOS 影视推荐 Widget 点击行为调整为条目级跳转，点击不同卡片可直达对应媒体详情页，不再固定进入同一详情。 - iOS Widget 深链路由补充 `media-detail` 解析，支持从 Widget 冷启动进入 App 后直接打开媒体详情页。 - 登录与自动登录流程补充 Widget 主动刷新时机，降低推荐 Widget 停留“请先登录”状态的概率。 - 新增 Widget 关键链路日志（会话读取、请求状态、解码结果、路由解析），便于排查推荐数据加载异常。 - iOS Widget 代码按功能拆分：新增独立 `WidgetAppIntents.swift`，集中管理 App Intent 与 Timeline Provider。 - 应用设置页新增“更新日志”入口，支持直接查看应用 Changelog。 - Changelog 页面改为 Markdown 渲染，保留标题与列表等格式化展示。 - Changelog 默认仅展开最新版本更新，历史版本改为折叠展开样式以提升可读性。 - 新增“下载器直连下载”开关（默认关闭），下载弹层支持一键直连下载器提交本地种子文件。 - 直连下载开关增加启用提醒：由于站点特殊性不能保证适配所有站点，如有特殊需求请提交 PR。 - 下载弹层底部操作区重构：新增直连下载按钮、主下载按钮与单按钮铺满布局，并优化键盘遮挡与状态残留问题。 - 直连下载页支持查看本地种子文件路径列表，便于排查本地文件来源与提交路径。 - qBittorrent 日志页改造为底部 Floating Bar 交互，整合搜索、筛选、排序入口并补充底部防遮挡留白。 - qBittorrent 日志筛选弹层改为开关即时生效，移除取消/应用二次确认流程。 ## 2026-03-30 - 新增 iOS 订阅日历 Widget Extension，支持展示今天及之后的订阅更新。 - 登录态同步到 iOS 共享存储，供 Widget 拉取订阅日历与鉴权图片请求复用。 - 订阅日历 Widget 重构为扁平化卡片样式，按 small、medium、large 尺寸展示不同密度内容。 - small 尺寸调整为“今日订阅概览”，medium 与 large 尺寸优化条目间距、日期信息与图片展示。 - 支持从 iOS 订阅日历 Widget 冷启动进入 App 时直接跳转到应用内订阅日历页面。 - 增加 iOS 专属服务的平台保护，避免非 iOS 平台触发共享会话与 Widget 导航异常。 - 重构媒体整理页布局：引入底部浮动搜索/筛选/排序栏，统一列表筛选入口与交互层级。 - 修复媒体整理页成功/失败筛选逻辑错误，改为基于整理状态进行准确过滤。 - 新增媒体整理结果按时间、标题、大小排序能力，并保留关键词搜索状态。 - 恢复根据标题快速选择整理记录的快捷入口，便于按剧集或条目快速定位。 - 重构站点资源页布局：引入底部浮动搜索/筛选/排序栏，统一资源浏览与筛选入口。 - 站点资源接口返回项映射为统一搜索结果模型，并复用搜索结果卡片与下载弹层交互。 - 新增站点编辑页与编辑控制器，支持加载单站点详情并提交更新站点配置。 - 站点编辑页认证方式改为单个 `Cupertino` 分段切换，在 `Cookie` 与 `ApiKey/Token` 两组字段间互斥切换展示。 ## 2026-03-27 - 新增日志页面，并在设置页增加入口，便于查看系统消息与调试信息。 - 调整 API 客户端日志配置，增强问题排查时的可观测性。 - 修复系统环境配置解析异常，提升设置页与系统消息页的数据解码兼容性。 - 修复部分 TOTP 编辑场景下的细节问题。 ## 2026-03-26 - 修复动态表单 `InfoCardRow` 重复声明导致的构建错误（`group` 构造改为独立类型）。 - 站点列表页视觉重构：引入底部浮动筛选/搜索/排序栏，优化卡片样式与信息层级。 - 站点列表支持筛选（全部/正常/失败/缓慢）与排序（优先级/上传量/下载量），并增加隐私模式本地持久化。 - 站点项新增连通性状态呼吸灯，状态基于 `/api/v1/site/statistic` 返回值计算。 - 站点列表加载链路增强容错：主列表成功后即展示，后续用户数据与图标请求失败不阻断页面渲染。 - 修复站点缓存主键冲突（`SiteUserDataCache` 去重并使用更新写入）。 - 过滤掉 `id = -1` 的无效站点。 - 修复站点管理页的响应式构建异常，避免统计状态联动时出现 `Obx` 错误。 ## 2026-03-22 - 修复 bug - 下载管理能力升级：支持 qBittorrent（qB）与 Transmission（TR）种子管理。 - 统一种子列表展示与基础操作（暂停、恢复、删除、重命名、分类/标签、限速）。 - 下载器页面结构调整，增强不同下载器类型下的兼容性。 ## 2026-03-23 - 新增下载任务页面 `torrent_download_screen`，补全 qBittorrent/Transmission 提交逻辑与错误提示。 - 下载管理页支持筛选与排序条件本地持久化恢复，减少页面状态回退。 - 优化种子列表项视觉层级与间距，降低信息拥挤感。 - 调整下载管理入口路由逻辑，支持按设置切换到下载器配置页。 - 修复媒体详情页骨架加载与 `soft_edge_blur` 组合导致的断言问题。 - 移除种子管理本地 Realm 缓存逻辑，回归在线数据流。 - fix: douban media detail subscribe state error - 新增独立 `altman_totp` package，支持 TOTP 新增、编辑、删除、选择回填登录 OTP。 - TOTP 本地存储改为 `sqflite`，支持多条记录与 UUID 主键。 - 新增 TOTP 扫码录入与手动密钥录入，支持解析 `otpauth://` 并自动回填用户名。 - 登录页 OTP 选择改为 modal 方式拉起 TOTP 选择页。 - TOTP 管理页与编辑页增加验证码倒计时与逆向进度显示。 - TOTP 管理页支持单项导出，提供二维码与字符串（含 `name`、`key`）复制。 - 增加 iOS/Android 相机权限配置以支持二维码扫描。 - tv 类型订阅完成后支持二次编辑