# 更新日志（VsTV / vstv）

应用展示名 **VsTV**；仓库与构建标识为 **vstv**。Release 与标签自 **1.0.0** 起对外维护；以下仅收录正式版记录。

> **说明**：本文件仍由人编写条目，**不会由机器人自动撰写内容**。推送 **Release 标签**（`v*.*.*`）时，GitHub Actions 会检查 `CHANGELOG.md` 中是否已有对应章节 **`## [x.y.z]`**（`x.y.z` 为标签去掉 `v`/`tv-` 及预发布后缀 `-…` 的核心版本）；**未写入则 Release 构建失败**，避免发版记录遗漏。若需对照历史，见 [GitHub Releases](https://github.com/vesaaa/vstv/releases)。

## [1.2.6] - 2026-04-06

- **文案**：将用户可见的「收藏」统一为「精选」：经典选台左侧分组为「精选频道」；设置入口为「精选设置」；启用精选、只看精选、当前精选、清空全部精选及相关 Toast 已同步。
- **文档**：README 用语与上述命名及「无内置直播源、首装自配」说明保持一致。

## [1.2.5] - 2026-04-06

- **直播源分组**：经典选台左侧分组、横条面板分组标题长按可隐藏整组；设置 → 应用 →「恢复已隐藏分组」可一键恢复。隐藏列表随当前直播源 URL 保存，更换订阅地址后自动清空需重新设置。

## [1.2.4] - 2026-04-05

- **台标**：Coil 按界面尺寸解码并封顶（256px），无透明通道时使用 RGB565，降低低内存设备（如 Android 9、2G 盒子）因大图并发解码导致的 OOM 闪退风险。
- **台标**：系统标记低内存或应用堆较小时，下调 Coil 内存缓存占比。

## [1.2.3] - 2026-04-04

- **直播源**：移除测试用的默认订阅；网页推送的地址会进入历史并在「直播源管理」中与设置页即时同步。感谢网友「假装很会打篮球」的反馈。

## [1.2.2] - 2026-04-03

- **扫码网页**：压缩「通知」区块高度与行间距，减少首屏占用空间。
- **发版**：补齐 `CHANGELOG` 校验链路，确保标签构建可通过版本章节检查。

## [1.2.1] - 2026-04-03

- **工程清理**：移除 Android 模板测试文件（`ExampleUnitTest`、`ExampleInstrumentedTest`）。

## [1.2.0] - 2026-04-03

- **扫码网页**：强化「通知 / 直播源 / 节目单」一级标题样式，提升可读性。
- **扫码网页**：精简直播源与节目单说明区，移除占位较大的“当前表单”展示与多行请求头提示文案。

## [1.1.0] - 2026-04-03

- **安全与更新链路**：引入私有打包 bundle 与构建时覆盖机制，默认更新/内置源/EPG 配置不再直接暴露在公开仓库中；Release CI 解密覆盖后行为与以往一致。
- **设置与扫码网页**：电视端设置页多处体验微调（FPS/网络分组、焦点样式）；扫码网页新增多种常用直播 UA 预设按钮（Mursor/APTV/电信/联通/移动等）与更清晰的输入框样式。

## [1.0.20] - 2026-04-03

- **播放稳定性**：进一步减少长时间播放后的卡顿与重连概率。
- **界面体验**：优化设置页与列表切换的响应速度，减少焦点切换时的延迟。

## [1.0.19] - 2026-04-03

- **设置**：「显示 FPS」移至「播放器」分类；「网络」中移除「显示 FPS」与「显示播放器信息」（播放页不再显示播放器调试信息条）。

## [1.0.18] - 2026-04-03

- **自动更新**：设置中「应用更新」检查到新版本时，不再弹出与更新对话框重复的小提示，仅保留「是否更新」大对话框。
- **设置界面**：左侧功能菜单磁贴获得焦点时由蓝色高亮改为白底，图标与文字使用深色以保证对比度。

## [1.0.17] - 2026-04-03

- **播放**：优化拉流与缓冲策略，减少部分机型上起播与换台时的卡顿感。
- **稳定性**：降低长时间播放后偶发的界面无响应概率。

## [1.0.16] - 2026-04-03

- **自动更新**：改进 Release 检查与下载流程的异常处理，提升弱网下的成功率。
- **安装**：优化安装流程在部分电视系统上的兼容性提示。

## [1.0.15] - 2026-04-03

- **界面**：加快设置与详情面板之间的切换响应，减少焦点移动时的迟滞。
- **交互**：微调列表滚动与按键反馈，操作更跟手。

## [1.0.14] - 2026-04-03

- **网络**：优化直播源与节目单请求的重试与超时表现，失败时更快给出可重试状态。
- **资源**：减少部分场景下的不必要重复请求。

## [1.0.13] - 2026-04-03

- **性能**：降低主界面与播放页切换时的内存尖峰，改善低配设备体验。
- **其它**：若干细节修复与代码整理。

## [1.0.12] - 2026-04-03

- **界面**：播放信息条（`LeanbackPanelIptvInfo`）不再显示台标，仅保留频道列表中的台标。
- **台标**：`MyTVApplication` 配置全局 **Coil** `ImageLoader`（`coil_logo_disk` 磁盘缓存约 50MB、内存约 20%）；`respectCacheHeaders(false)` 减轻 CDN 短 `max-age` 导致的不必要重复下载。
- **台标**：加载中不再使用灰色占位；关闭 crossfade，缓存命中时更快显示。

## [1.0.11] - 2026-04-03

- **节目单**：使用 **WorkManager** 在后台按间隔（默认 12 小时）拉取 EPG 并写入本地缓存；需开启 EPG、配置有效地址且联网；与设置中「未到 X 点不刷新」一致；失败时指数退避重试。应用启动、开机广播及修改 EPG 地址后会重新登记任务。
- **节目单**：后台任务按本地 **IPTV 订阅缓存** 过滤 XML，与前台行为一致；无缓存时解析全量频道（与未带频道列表时一致）。
- **配置**：`SP.init` 可安全重复调用；开机广播内初始化 SP 并调度 EPG 任务。

## [1.0.10] - 2026-04-03

- **界面**：M3U `tvg-logo` 解析为频道台标；选台列表（经典列表、横条小卡）与播放信息条使用 **Coil** 加载并缓存台标。
- **收藏**：收藏条目持久化 `logoUrl`，与当前频道列表匹配时显示台标。
- **依赖**：增加 `coil-compose`。
- **文档**：README 补充 `tvg-logo` 与台标说明。

## [1.0.9] - 2026-03-30

- **文档**：README 增加「特色功能」等说明；直播源示例署名统一为 **Mursor**，并精简相关表述。
- **设置**：收藏页补充「收藏启用」「只看收藏」的操作说明与适用场景文案。

## [1.0.8] - 2026-03-30

- **换台**：上下键换台与界面频道顺序一致（全列表或「只看收藏」下的收藏列表）；修复仅收藏模式下 `iptvGroupList` 为空导致无法换台、以及从收藏点播时偶发与列表索引不一致导致不换台的问题。
- **播放**：换台到与某收藏条目匹配的频道时，自动套用该条目的拉流请求头快照（多源收藏在未开「只看收藏」时亦生效）。

## [1.0.7] - 2026-03-30

- **构建**：修复 `PanelChannelNoSelectScreen` 中 `rememberLeanbackPanelChannelNoSelectState` 的尾随 lambda 被误解析为 `initialChannelNo: String` 导致的 Kotlin 编译失败（显式命名 `onChannelNoConfirm` 与 `State` 类型）。

## [1.0.6] - 2026-03-30

- **收藏**：持久化频道 URL 与拉流请求头快照，删除订阅后仍可播放；旧版仅名称的收藏迁移为完整条目（JSON）。
- **收藏**：设置 → 收藏 增加「只看收藏」，界面与上下换台、数字选台、频道号仅针对收藏列表；现代面板在仅收藏模式下固定展示收藏网格。
- **播放**：支持按选中条目传入 HTTP 头/User-Agent 拉流，多收藏源切换互不串用请求头。
- **其它**：数字选台确认回调使用 `rememberUpdatedState`，避免仅收藏/全列表切换后仍按旧顺序选台。

## [1.0.5] - 2026-03-30

- **CI**：Release 工作流增加 `CHANGELOG.md` 校验步骤，发版前须包含与标签一致的核心版本章节。
- **文档**：更新本文件顶部的维护说明（与上述 CI 联动）。

## [1.0.4] - 2026-03-30

- **自动更新 / 安装**：Android TV / Leanback 设备上**优先**使用系统「打开 APK」流程（`ACTION_VIEW` + `ClipData` 授权 URI，失败再尝试 `INSTALL_PACKAGE`），最后再回退 `PackageInstaller` 会话；缓解海信 Vidda 等机型上会话安装确认后无进度、再次更新无界面的问题。
- **自动更新**：从设置页触发安装时改用 **Activity `Context`** 启动安装器（替代仅用 `Application`）。
- **清单**：`queries` 增加 `INSTALL_PACKAGE` + `content`，改善 Android 11+ 包可见性下解析不到系统安装器的情况。

## [1.0.3] - 2026-03-30

- **快捷面板**：底部 `TvLazyRow` 菜单整体布局约缩小 15%（间距、按钮 `contentPadding`、`widthIn` 等）；**字号与图标尺寸不变**。

## [1.0.2] - 2026-03-30

- **快捷面板**：底部菜单更扁平（去 glow、聚焦缩放锁 1f、小圆角、显式边框）；聚焦时文字/图标使用与浅色底对比的配色，避免看不清。
- **README**：保留对先行项目的致谢，并说明本仓库独立维护、与所列项目无 Git 上游/下游从属。
- **CI**：Release 工作流注释去掉「fork」表述。

## [1.0.1] - 2026-03-30

- **README**：去掉关于早期 `0.0.*` 安装包升级的表述。
- **仓库**：移除 1.0.0 以前的 Git 标签与 GitHub Release 记录（若有残留请在网页上再删一次）；**CHANGELOG** 自本版起仅保留 1.0.x 条目。

## [1.0.0] - 2026-03-30

- **首发正式版**：对外下载与说明以 **1.0.0** 为起点。
- **README**：侧重应用功能与使用说明；双 APK 说明；致谢分行；声明与免责强化。