@@ -1,5 +1,89 @@
# Entryway Release Notes
## 手机版 v0.17.0 / TV 版 v0.16.0 / Windows v0.14.0 - 2026-07-20
> 💬 **多弹幕服务与三端发布** — Android 手机和 TV 现在可按优先级配置弹弹Play、LogVar 弹幕 API 或其他弹弹Play兼容服务，匹配、加载与缓存严格绑定到实际数据源；本次 Release 同时提供 Windows x64 安装包。
### 多弹幕 API 与共享运行时
- **三种服务类型**：内置弹弹Play官方服务；LogVar 弹幕 API 使用独立 URL 与 Token；“其他”按弹弹Play兼容协议调用，便于后续继续扩展服务类型。
- **有序故障回退**：多个 API 按用户设置的优先级依次完成匹配与加载，当前服务不可用或未找到内容时再尝试下一项，不并发混用多个来源。
- **数据源隔离**：映射、请求合并、内存状态和 LRU 内容缓存都纳入服务身份；同一 URL 的不同 LogVar Token 视为不同租户，避免跨源串用。
- **地址规范化**：手机、TV 与运行时统一识别默认端口、尾斜杠和查询参数，防止界面允许重复端点但运行时又静默折叠。
- **凭据保护**：Token 不进入日志、对象摘要或缓存文件名；弹幕设置排除在系统备份与设备迁移之外。
### 手机版 v0.17.0
- **完整 API 管理**：可新增、编辑、删除和调整弹幕 API 优先级，并为 LogVar 单独填写与隐藏 Token。
- **窄屏布局修复**：多 API 摘要改为独立行并限制行数，长 URL 或备用服务数量不会再把标题和说明挤成逐字竖排。
- **一致的端点判重**：允许同一 LogVar 根地址使用不同 Token，同时拦截规范化后实际指向同一数据源的重复配置。
- **缓存与加载延续**：继续使用播放器缓存容量作为弹幕 LRU 上限，只有超出容量时才逐出最久未使用的内容。
### TV 版 v0.16.0
- **多 API 功能移植**：通过遥控器管理服务类型、URL、Token、优先级与增删排序，实际播放与手机版共用同一匹配、回退和缓存实现。
- **弹幕菜单重排**：菜单边距适配 720p / 1080p，长标题、状态和 API 摘要会合理分行或省略，按钮等宽排列，不再出现乱码式错位。
- **弹层遮挡修复**：打开播放器菜单及其子对话框时暂时停止 Canvas / SurfaceView 弹幕绘制，并提高菜单表面不透明度，避免弹幕穿透覆盖菜单文字。
- **遥控器焦点修复**：候选匹配、搜索和 API 编辑对话框互斥显示；子弹窗关闭后恢复父列表焦点，返回键可逐层退出。
- **独立弹幕缓存**：新增 100 MB 默认弹幕缓存容量，可在 50–500 MB 范围调整，不再误改 ExoPlayer / mpv 的视频缓冲大小。
### Windows v0.14.0+33
- **Windows x64 安装包**：本次 Release 同步提供 `Entryway_0.14.0+33_Windows_x64_Setup.exe` 。
- **安装器工程**：加入 Windows 安装包构建脚本与 Inno Setup 配置，完善安装、升级与卸载流程。
- **播放策略调整**：补充 Windows 播放内核与硬件解码策略，减少不合适的解码路径。
- **资源与字幕修复**：修正鉴权图片、媒体详情、搜索和收藏等请求的服务器作用域，并改善串流字幕加载与播放器状态同步。
### 安装包与校验
- 手机版：`entryway-debug-0.17.0.apk`
- SHA-256： `e85f6d752df0b5989ecf49d2726d0e15d2c79703ce8c67c3a4ba2e90a94d31c9`
- TV 版：`Entryway-tv-debug-0.16.0.apk`
- SHA-256： `d4a17a314edb2dcd3f94a7bd03fef2b4724986e4d4f0a57a8ed02d1ff57bfa7e`
- Windows x64： `Entryway_0.14.0+33_Windows_x64_Setup.exe`
- SHA-256： `4f502ed4ea054510992bca4c5fd5c85210314cdefd8ec17c794f424551e5b8b6`
### 构建信息
- 手机版：`versionName 0.17.0` ， `versionCode 36`
- TV 版：`versionName 0.16.0` ， `versionCode 35`
- Windows： `version 0.14.0+33`
## 手机版 v0.16.0 / TV 版 v0.15.0 - 2026-07-19
> ⚡ **缓存优先、按需刷新，故障服务器不再拖垮全局** — 双端首页优先恢复按账号隔离的本地快照；进入子媒体库时只在缓存超过 30 分钟后强制获取最新数据，同时保留手动刷新能力。单个服务器不可用时，其他已保存服务器仍可正常进入。
### 手机版首页与媒体库
- **首页完整快照**：精选轮播、继续观看、下一集、我的媒体和各媒体库分区按服务器与用户隔离持久化，启动和切回首页时先显示缓存，再在后台分区更新。
- **局部更新合并**：进入子媒体库成功刷新后，只替换首页缓存中对应媒体库的内容，并异步刷新精选轮播，不再等待整页重新获取。
- **30 分钟子库缓存**：缓存未满 30 分钟时进入媒体库立即显示现有内容且不重复请求；超过时前台刷新，用户手动下拉可随时强制刷新。
- **分页缓存一致性**：已加载分页会写入磁盘缓存，但不会延长首屏数据的 30 分钟新鲜度；刷新或分页失败均保留已有内容。
- **返回位置修复**：从媒体库或详情页返回首页时恢复原有滚动位置，不再强制跳回精选轮播顶部。
### TV 首页与媒体库
- **TV 首页快照**：我的媒体、继续观看、收藏及各库最新内容使用按账号和服务器隔离的持久化快照；分区请求互不阻塞，单个媒体库超时不会清空其缓存行。
- **TV 子库刷新策略**：与手机版一致采用 30 分钟缓存窗口；过期时前台刷新，遥控器可直接触发显式刷新，分页不会伪造新的刷新时间。
- **遥控器位置与焦点**：返回首页保留纵向滚动状态，后台刷新不再强制抢回首项焦点；空库或首次请求失败时默认聚焦刷新按钮。
- **跨服缓存隔离**：缓存身份同时包含账号、完整服务器地址和用户 ID，并使用稳定编码或散列生成缓存键，避免不同服务器误用同一份内容。
### 服务器故障恢复
- **冷启动不再联网验凭据**：启动时直接恢复本地会话，DNS、TLS、超时或服务端暂时不可用不会清除账号，也不会把应用锁回服务器录入页。
- **保存账号恢复入口**：兼容旧版本已经清掉当前会话的情况；登录页可直接进入已保存账号列表，切换到其他正常服务器。
- **失败相互隔离**：刷新失败只影响当前服务器与当前分区，缓存和其他已保存服务器继续可用；退出和删除仍保持显式、可预期的行为。
### APK
- 手机版：`entryway-debug-0.16.0.apk`
- TV 版：`Entryway-tv-debug-0.15.0.apk`
### 构建信息
- 手机版：`versionName 0.16.0` ， `versionCode 35`
- TV 版：`versionName 0.15.0` ， `versionCode 34`
## 手机版 v0.15.0 / TV 版 v0.14.0 - 2026-07-19
> 💿 **双端播放内核与 ISO 能力增强** — 手机版和 TV 版接入可解析 DVD / Blu-ray 的自构建 mpv 内核、JNI 主标题读取与本地 Range 代理；同时补齐 TV 弹幕、MPV 字幕、直链播放性能和跨端视觉统一。
余生