ZViewer-Client 1.7.0

Android / HarmonyOS 1.7.0 / 170

2026-10-07 正式发布；目标上游 ba033096bc9c3a85a2058918a002b80a5f484ec8。用户已确认 Android / HarmonyOS 真机验收通过。APK/HAP 沿用本次已验收的正式签名构建，源码与 SHA-256 同版本发布；iOS 不在本轮范围内。构建、模拟器证据及验收记录见 适配交付记录。

🚀 新特性 / Features

• 双端内置 B 站代理支持 ep/ss 番剧影视、整季分集、会员及试看信息，并使用每台设备自己的账号解析。/ Native PGC resolution, season episodes and per-device entitlement metadata.
• 支持影片 cliOnly、服务端解析默认值、PGC 分集和画质同步。/ Per-movie local-proxy requirement and updated parsing defaults.
• 首页增加 HTTPS 优先的自动地址选择、完整 URL 和按服务器证书例外。/ HTTPS-first address selection and server-scoped certificate exceptions.
• 一起听增加末尾推荐续播、默认来源页和房间评论；语音显示实际 UDP/TCP 线路。/ Music continuation, default source, room comments and selected voice transport.

🐛 错误修复 / Bug Fixes

• 补齐 PGC 元数据映射、ep/cid 对应与异步旧请求校验；手动不可用画质明确失败。/ Preserve PGC metadata and prevent stale episode or quality results.
• cliOnly 播放及缓冲禁止服务器媒体兜底和跨账号缓存误用。/ Enforce local media routing in playback, recovery and buffering.
• 修复鸿蒙 TLS 初始化及尾包关闭顺序、HLS 私有通道递归包装。/ Fix HarmonyOS TLS response draining and HLS connection routing.

⚠️ 破坏性改动 / Breaking Changes

• cliOnly 影片要求各成员自己的内置代理可用且账号拥有内容权限；房主会员资格不会传给观众。/ Each viewer needs a working local proxy and their own content entitlement.
• 语音继续要求 LiveKit 服务端；iOS 本轮未适配、未构建 IPA。/ LiveKit remains required; iOS is outside this delivery.

⚡ 性能优化 / Performance Improvements

• 服务端解析缓存增加分集/身份维度，本机缓冲缓存按账号会话隔离；过期解析不重挂播放器。/ Scope parsing and media caches to episode and session identity.
• 一起听侧坞保持挂载，减少全屏切换中的监听重建。/ Keep music dock listeners mounted across full-player transitions.

📖 文档与依赖更新 / Documentation & Dependencies

• 同步双端维护架构、方案实施状态和交付记录；版本统一为 1.7.0 / 170。/ Update both maintenance guides and delivery evidence.
• 30 项共享回归和 Go 测试通过，正式 APK/HAP 签名验证通过；会员 MP4 在两端模拟器约 400 秒位置继续出帧，用户确认双端真机验收通过。/ Verified regression tests, signed builds and user-confirmed acceptance on both mobile platforms.

---

完整变更记录：client-v1.6.0...client-v1.7.0

ZViewer-Client 1.6.0

ZViewer 1.6.0 · Android / HarmonyOS 新服务端适配

发布日期：2026-10-04。Android 与 HarmonyOS 版本均为 1.6.0 / 160，适配服务端 9827929（v4.3.7 后 4 个提交）。

iOS 目前尚未适配本次新版本服务端，尤其是 LiveKit 语音协议。本次不发布 iOS 安装包；源码归档中的 iOS 工程仍为既有版本，不包含此次适配。

🚀 新特性 / Features

• Android / HarmonyOS 接入 LiveKit 房间语音，支持成员管理、管理员禁言与踢出，保留原生麦克风权限、音频路由和收起面板后的会话。
• 新增 PGS 位图字幕解码与定位显示，保留文本字幕及设备设置。
• 支持导入 B站 XML/JSON 与 dandanplay JSON 本地弹幕；鸿蒙接入系统文件选择器。文件上限 5 MiB、最多 20000 条。
• 新增网易云 Cookie 登录和主动读取/复制，保留扫码登录。

🐛 错误修复 / Bug Fixes

• 修复离房、切服、被踢、连接失败和过期异步操作的语音资源释放；管理员解禁尊重用户主动闭麦，自动播放受阻时支持点击恢复。
• 修复 MKV 压缩元数据、视频 CueTrack 选择、AAC priming、实际采样率与尾部裁剪，改善字幕和音画定位。
• 房间弹幕上传失败回滚并明确反馈，权限拒绝不再误报成功；上传 JSON 超过服务端 1 MiB 限制时提前提示。
• 网易云业务鉴权错误与会话过期区分，关闭 Cookie 弹窗后清空临时值；移除尚未实现的音乐下载/本地管理 Tab。

⚠️ 破坏性改动 / Breaking Changes

• 语音需要部署 LiveKit 的新服务端；不兼容旧 v4.2.1 语音协议。 房间基础业务仍使用 Socket.IO。域名访问还需服务端正确配置 LiveKit 的反向代理和媒体网络。
• 同账号使用相同 identity，第二台设备加入语音会顶替第一台设备并提示。
• iOS 尚未适配新服务端，本次适配仅覆盖 Android / HarmonyOS。
• HarmonyOS 兼容 API 23（HarmonyOS 6.1）及以上，Android 最低 API 24；沿用既有发布签名与应用标识。

⚡ 性能优化 / Performance Improvements

• 删除旧语音处理器、独立媒体 Socket 和旧多实例检测，统一由 LiveKit 管理媒体连接。
• 去重远端订阅并统一清理音频资源；PGS 按顺序保留解码状态。

📖 文档与依赖更新 / Documentation & Dependencies

• 升级 livekit-client 至 2.22.3，锁定 playsvideo 0.4.7 并提供可重现补丁；保留源码中的 vendor/mediabunny。
• 同步 Android / HarmonyOS 维护文档、适配方案、发布流程与许可证。安装依赖请运行正常的 npm ci，不要跳过 postinstall。
• 18 项共享自动回归、TypeScript/Vite 构建及双端 Release 构建通过，APK/HAP 签名验证通过。双端原生联调已验证媒体传输、语音管理、XML 选择、弹幕广播和测试字幕；已确认通过域名在纯外网可连接语音。

本次附件：ZViewer-Android-1.6.0-release.apk、ZViewer-HarmonyOS-1.6.0-release.hap、ZViewer-client-1.6.0-source.zip、SHA256SUMS.txt。

---

完整变更记录：client-v1.5.0...client-v1.6.0

ZViewer iOS 1.5.1

ZViewer iOS 1.5.1

版本说明：本次 Release 标签和 iOS 源码版本为 1.5.1；未重新触发 Expo/EAS 构建。安装包复用已完成修复并校验的 1.5.0 / build 16 未签名 IPA，安装后显示的内部版本仍为 1.5.0（16）。附件保留真实版本文件名，请勿将其视为重新编译的 1.5.1 安装包。

本次为独立 iOS 发布；包含本轮源码修复、维护文档、原始 build 16 验证证据和源码 ZIP。

🚀 新特性 / Features

• 播放设置整合“播放 / 字幕 / 弹幕”页签；字幕管理、导入及同步设置可从视频齿轮进入，全屏同样可用。
• 音轨、字幕和倍速的当前选中项显示主题色高亮与勾号；轨道状态随本机选择和原生回调刷新。

🐛 错误修复 / Bug Fixes

• 修复一起听每次房主心跳都发送“已同步”回执的问题；每个曲目/连接在媒体准备完成后仅回执一次，切歌和重连允许新回执。
• 修复 B 站分享文本包含标题时的 Invalid URL：规范提取链接，保留分 P/CID，覆盖片单恢复、添加和解析路径。
• 修复缺省轨道隐式选中 0 号及切换时旧轨道叠加的风险；原生字幕与同步文本字幕互斥，减少 ASS 特效旁额外纯文本的重复渲染。
• 换片清空旧字幕地址、延迟和轨道选择，避免设置面板显示上一部影片的状态。

⚠️ 破坏性改动 / Breaking Changes

• 无新增接口破坏性改动。原独立“字幕管理”入口移至“播放设置 → 字幕”。
• IPA 未签名，需要自行签名安装。 本次复用 1.5.0 / build 16 二进制，源码版本提升至 1.5.1；没有新的 Expo/EAS build。
• 原生音轨/字幕高亮和 ASS 最终视觉效果仍需真机复验；桌面 VLC、Web 检查与包校验不能替代 iOS 音视频、语音和后台完整验收。

⚡ 性能优化 / Performance Improvements

• 同步回执按服务器、用户、房间、Socket 连接和曲目隔离、去重，减少重复网络事件及房主提示堆积。
• 相同原生轨道列表不重复触发 JS sourceLoad，减少设置面板无效刷新。

📖 文档与依赖更新 / Documentation & Dependencies

• 补全 iOS 维护架构，记录工程模块、轨道补丁、字幕互斥、同步回执、构建流程和真机复验步骤。
• iOS 源码版本统一为 1.5.1，依赖版本保持现有构建配置；本次未重新构建安装包。
• 复用 build 16 已通过的 74/74 单测、18/18 Web 界面检查、lint、TypeScript 及 iOS/Web 导出证据。指定《败犬女主太多了！》S01E02 MKV 完成两字幕切换/关闭/恢复和 55/120/700/1300 秒本地 seek 辅助检查。
• IPA 已校验为 ARM64 iOS 设备包，支持 iPhone/iPad、最低 iOS 16.4，包含内置 JS、VLC、B 站/语音/系统媒体原生模块及许可证。
• 复用 IPA 的 SHA-256：1220bdd48cf9308eb98d2b71b32e95c365c8d3cfe312bdbb25ab92b0e3e28ac7。其余附件摘要见 SHA256SUMS-ios-1.5.1.txt。

---

完整变更记录：client-v1.5.0…ios-v1.5.1

ZViewer 1.5.0 · Android / HarmonyOS / iOS

ZViewer-client 1.5.0 · Android / HarmonyOS / iOS

发布日期：2026-10-02。标签：client-v1.5.0。正式包名 com.zviewer.mobile，versionName 1.5.0，versionCode 150，目标 ZViewer 服务端 v4.2.1。

🚀 新特性 / Features

• Android/HarmonyOS 一起听和一起看接入原生系统播放控件，同步播放状态、进度、时长和解码后的封面，支持系统播放/暂停、跳转及可用的切歌操作。
• 一起听同步网易云 LRC 与哔哩哔哩 AI 字幕歌词。鸿蒙发布完整歌词与当前行；安卓发布兼容性歌词元数据及通知当前行，具体展示由系统媒体控件决定。
• iOS 1.5.0 / build 15 对齐连接页、全局背景、房间、播放器、音乐发现、私人漫游、弹幕搜索与横竖屏菜单，并提供 iPhone/iPad 未签名 Release IPA。
• 完善自动旋转：默认尊重系统自动旋转设置，手动锁定可解除，离开房间恢复自动策略。一起听展开横屏隐藏房间顶栏，收起或竖屏恢复。

🐛 错误修复 / Bug Fixes

• 修复后台播放一段时间后停止：安卓使用媒体前台服务、播放期间的唤醒锁和 WebView 媒体管线策略；鸿蒙使用音频连续任务，暂停、退出时释放对应资源。
• 修复一起听展开横屏时左侧和底部露出壁纸，网易云背景和哔哩哔哩视频覆盖整个视口，曲绘、歌词和按钮继续避让摄像头安全区。
• 修复网易云评论、楼层回复和个人头像的 HTTP CDN 地址与重复尺寸参数；图片失败显示默认头像。
• 修复歌曲切换时旧歌词残留及歌词面板未打开时系统无歌词，切到无歌词歌曲清空系统歌词。
• 追加 B站 视频弹窗适配窄屏、横竖屏、安全区和深浅主题，内容内部滚动，标题及关闭按钮完整可见。修复删除后重新追加相同视频源跳过加载。
• 移除原生一起听工具栏重复的浏览器全屏按钮；保留纯净视频、收起箭头和退出入口。
• iOS 修复开屏布局退化、房间内容缺失、横竖屏菜单越界、音乐横幅留白、弹幕搜索弹窗和批量导入状态问题；支持横幅手动左右滑动与首尾循环。

⚠️ 破坏性改动 / Breaking Changes

• 视频表面手势调整：一起看中间双击播放/暂停，全屏左侧双击后退15秒、右侧双击前进15秒；单击只显示控件。
• 一起听仅在视频全屏/纯净模式采用上述双击手势。普通音乐界面不触发；全屏单击唤出退出按钮，双击不再退出，仍可用按钮、Esc或原生返回退出。
• 无服务端协议或数据迁移改动；观众播放和跳转继续遵守房主审批。
• iOS IPA 为未签名设备包，需自行签名后安装；完整后台业务 Socket、音视频、语音和系统媒体矩阵仍按 iOS 交付记录的边界验收。

⚡ 性能优化 / Performance Improvements

• 界面和系统会话共享歌词请求，合并并发请求并使用有限缓存，避免重复拉取。
• 元数据按变化更新；播放期间保活，暂停/退出释放后台资源与封面图片，旧播放器不能清除新会话。
• iOS 音乐首页使用满宽横幅、有限缓存和独立滚动区域；歌单批量操作与私人漫游按页处理，避免大列表一次性阻塞界面。
• 双端视频复用同一触屏判定器，抑制合成鼠标事件造成的重复操作。一起听手势操作真实音频，静音视频跟随同步。

📖 文档与依赖更新 / Documentation & Dependencies

• 更新 README、更新记录、双端维护架构、HarmonyOS 构建说明与播放器验收记录。Android/HarmonyOS 升级为 1.5.0 / 150，iOS 对齐为 1.5.0 / build 15；iOS 未签名附件追加到本 Release，不创建独立 iOS 标签。
• 用户确认双端功能测试全部通过，包括后台播放。此前命令行模拟器验收覆盖系统控件、封面、歌词、旋转、横屏安全区、头像、追加视频和真实触屏手势；详见 系统媒体验收、界面与歌词验收及追加视频验收。
• 本次正式构建验证共享前端和双端资源同步、Android/HarmonyOS release 构建、包版本与签名、相对1.3.5证书一致性，以及安装包内共享资源的 SHA-256 一致性。鸿蒙正式包 debug=false，关闭 ArkWeb 调试。
• 发布附件包括既有 ZViewer-Android-1.5.0-release.apk、ZViewer-HarmonyOS-1.5.0-release.hap、ZViewer-client-1.5.0-source.zip、SHA256SUMS.txt，以及追加的 ZViewer-1.5.0-b15-unsigned.ipa、IPA 检查 JSON、iOS 源码 ZIP 和 SHA256SUMS-ios-b15.txt。安卓最低 API24，鸿蒙最低6.1/API23；iOS 最低 iOS 16.4、支持 iPhone/iPad ARM64，源码 ZIP 排除私钥、账号会话、生成资源与测试数据。
• 由于 Expo Build 的额度限制，iOS 端更新与错误修复会出现延迟，不会与 Android/鸿蒙两端同步完成（除非有人有 Mac 帮忙编译）。

---

完整变更记录：client-v1.3.5...client-v1.5.0

ZViewer Android / HarmonyOS 1.3.5

🚀 新特性 / Features

• 播放器下箭头增加浅色圆形底板、深色图标、描边与阴影，触控区扩大为 44px，在黑色视频背景下更清晰。

🐛 错误修复 / Bug Fixes

• Android/HarmonyOS 一起听固定使用折叠导航，移除“展开完整导航”；旧版展开偏好、手机横屏和原生宽屏均保持折叠，四个网易云分区与哔哩哔哩入口保留。
• 修复浅色音乐菜单的低对比度背景。
• 修复纯净视频裁剪、拉伸、模糊及动画定位问题；完整显示画面，退出恢复原偏好，保持同一视频元素，原生返回先退出纯净模式。
• 修复无当前歌曲时音质状态无限重渲染，空队列可正常打开和收起播放器。

⚠️ 破坏性改动 / Breaking Changes

• 无服务端协议或数据迁移改动。移动端移除完整导航切换入口，桌面网页继续保留。

⚡ 性能优化 / Performance Improvements

• 消除空队列重复渲染循环；纯净模式切换复用媒体元素与播放引擎。

📖 文档与依赖更新 / Documentation & Dependencies

• 更新双端维护架构、发布流程、HarmonyOS 构建说明与版本记录，补充 UI 修复原因和回归清单。依赖版本无新增调整。
• 双端 1.3.5 / versionCode 135，沿用各自发布证书；iOS 保持 1.3.2 源码不变，本次不发布 iOS。
• TypeScript/Vite、资源同步、Android/HarmonyOS debug/release 构建通过；APK/HAP 验签通过，12 个共享构建资源的 SHA-256 一致，正式 HAP 关闭 ArkWeb 调试。
• 浏览器、Android 手机模拟器 WebView、鸿蒙 Pura 90 Pro 模拟器 ArkWeb 已验证深浅主题、旧展开偏好、横竖屏/宽视口导航、黑色视频画布下箭头、自动隐藏、关闭播放器与空队列。合成视频验证纯净模式布局和媒体元素连续性，鸿蒙原生旋转通过。本轮未新增真机、真实 CDN/DASH 解码、蓝牙和后台专项验收。
• 附件：签名 APK、签名 HAP、对应标签源码 ZIP、SHA256SUMS.txt。Android 最低 API 24；鸿蒙最低 HarmonyOS 6.1/API 23，HAP 安装须符合设备签名分发规则。
• 完整发布与验证记录 · 双端维护文档

---

完整变更记录：client-v1.3.2...client-v1.3.5

ZViewer-Client v1.3.2

ZViewer Android / HarmonyOS 1.3.2

本次发布提供了与 ZViewer 服务端 v4.2.1 配套的 Android 和 HarmonyOS 客户端。

• 修复了 Bilibili 播放器的加载顺序：客户端现在会等待本地影视元数据和账号信息就绪后再解析媒体流；移动端不再尝试请求桌面主机的 9333 端口本地回环（loopback）CLI。
• 保留了带有签名的 Bilibili DASH 查询参数，并修复了 HarmonyOS 的 CDN 请求头及分段（ranged）流媒体播放问题。
• 在 Android 和 HarmonyOS 上新增了原生全面屏沉浸式安全区适配（edge-to-edge safe-area）以及跟随主题适配的系统状态栏/导航栏。
• 提升了浅色主题下的文字对比度，并移除了播放器设置中多余的浅色毛玻璃层。
• Android 和 HarmonyOS 的版本信息均为 versionName 1.3.2 / versionCode 132。
• APK 与 HAP 包均已完成正式签名（release-signed）。Android 签名证书和 HarmonyOS 证书链均与上一公开发布版本保持一致。
• iOS 源码及打包文件本次未作变动，不包含 iOS 版本发布。

经 Android 与 DevEco 模拟器验证，已确认 Bilibili CDN 播放（1080P 级别 H.264/AAC）、分段请求响应、影视列表延迟竞争问题修复、主题可读性以及安全区适配均正常。本轮测试中 Android 端的自动化暂停/快进手势尚未完全验证。HarmonyOS 手机模拟器上关于 HEVC Main 10 解码限制的问题已记录在文档中。

配套的代码提交哈希与发布资产校验和，请参阅源码归档文件及 SHA256SUMS.txt。

ZViewer-client 1.3.0 · Android / HarmonyOS

更新内容

• Android 与 HarmonyOS 共享业务对齐 ZViewer 服务端 v4.2.1，统一连接页、房间列表、观影与一起听的全局背景和深浅主题。
• 修复浅色播放设置的白色文字与阴影、B 站账号入口的低对比度颜色。
• 移除弹幕分组底色与内部重复玻璃模糊，消除淡白色矩形背景。
• 整理两端维护文档、旧测试和过程文件，修正 CI 构建入口。
• 两端均为 1.3.0 / versionCode 130，包名 com.zviewer.mobile；iOS 本次不改动、不发布。

验证与升级

• TypeScript/Vite、Capacitor sync、HarmonyOS rawfile sync、Android release/debug 与 HarmonyOS release/debug 构建通过；12 个共享资源文件 SHA-256 一致。
• Android Medium_Phone 与 DevEco Pura 90 Pro 手机模拟器通过浅/深色、播放设置、弹幕字体、横竖屏、全屏和系统返回检查；颜色与标签一致，主题切换保持 video 元素。
• APK 经 apksigner 验证，沿用上一版发布签名，可覆盖升级同签名正式版。HAP 经 hap-sign-tool 校验，release profile、代码签名和摘要通过；发布包关闭 ArkWeb 调试。
• Android 最低 API 24、目标 API 36；HarmonyOS 最低 6.1 / API 23、目标 API 26。鸿蒙安装仍须满足设备对签名来源的要求，GitHub 发布不等于应用市场上架。

安装附件

• ZViewer-Android-1.3.0-release.apk：安卓签名安装包。
• ZViewer-HarmonyOS-1.3.0-release.hap：鸿蒙签名安装包。
• ZViewer-client-1.3.0-source.zip：本标签源码快照，不包含依赖、生成资源、私钥和本机配置。
• SHA256SUMS.txt：上述附件校验值。

已知范围

Pura 90 Pro 模拟器仍不能解码两部用户 HEVC Main 10 MKV，H.264 可播放。未新增平板、真机或真人语音听感验收；系统字体、安全区和设备解码能力仍由平台决定。

详细发布记录 · 双端维护流程

源码提交：177ef38。

ZViewer-client 1.2.1 b122 · Android / HarmonyOS

ZViewer-client 1.2.1 build 122 — Android / HarmonyOS

发布标签：client-v1.2.1-b122。

安装包

• Android：ZViewer-Android-1.2.1-release.apk，与原 Android 1.2.1 正式版相同，versionCode 121。
• HarmonyOS：ZViewer-HarmonyOS-1.2.1-b122-release.hap，versionName 1.2.1、versionCode 122，最低兼容 HarmonyOS 6.1.0（API 23），目标 API 26。
• ZViewer-client-1.2.1-b122-source.zip：本标签的完整 Git 源码快照。
• SHA256SUMS.txt：上述附件的 SHA-256 校验值。

修复与验收

• 修复鸿蒙 6.1 设备安装时提示 SDK 版本过低：将 compatibleSdkVersion 从 26 降至 23，保留 API 26 编译和目标版本。
• 连接的 ALN-AL10 真机为 HarmonyOS 6.1.0.135、API 24。用户确认兼容版真机测试通过。
• 构建号由 121 提升至 122，以支持覆盖升级；Android 安装包未重新构建。
• Release HAP 经过签名验证。自行侧载时仍须满足设备对测试签名或分发来源的要求；直接 hdc install Release 签名曾返回来源不受信任（9568322），这是独立于 SDK 版本的限制。
• 旧 client-v1.2.1 Release 保留为历史版本；本标签包含最新兼容源码。

ZViewer-client 1.2.1 · Android / HarmonyOS

ZViewer-client 1.2.1 — Android / HarmonyOS

发布日期：2026-09-29。Release 标签：client-v1.2.1。

安装包

• Android：ZViewer-Android-1.2.1-release.apk，沿用已发布的 Android 1.2.1 正式包，SHA-256 与原 Release 一致。
• HarmonyOS：版本 1.2.1，versionCode 121，包名 com.zviewer.mobile，目标与最低兼容 API 26。
• ZViewer-HarmonyOS-1.2.1-release.app.zip：解压后获得 Release 签名 APP，用于鸿蒙发布流程；GitHub 不允许直接上传 .app 扩展名。
• ZViewer-HarmonyOS-1.2.1-release.hap：Release 签名模块包，用于支持相应签名分发方式的设备安装。GitHub 下载不等于应用市场上架，安装仍受设备与签名分发策略限制。
• SHA256SUMS.txt：附件完整性校验。

鸿蒙更新

• 交付 ArkTS / ArkWeb 原生宿主、手机全面屏与显示控制、生命周期及麦克风接入。
• 支持房间播放、MP4 / MKV、字幕、弹幕与按房间权限切换片源。
• 修复 B 站扫码凭据获取、画质列表与本地媒体代理。
• 修复 1080P 高码率 CDN 参数及 Range 响应头/数据到达顺序问题，避免媒体分片开头丢失。
• 鸿蒙应用版本与 Android 对齐为 1.2.1。

验证与范围

• 先前手机模拟器验收及回归记录见 harmonyos-0.1.0-14.md；本次只调整版本并制作 Release 包，不重复播放验收。
• 本次 Release assembleApp 构建成功，独立 HAP 与 APP 外层签名验证通过，共享层单元测试 6/6 通过。APP 内的 HAP 未独立签名；设备安装请使用单独提供的签名 HAP。
• 平板、实体设备来电和蓝牙专项测试未在本次发布中新增验证。
• Android 二进制保持原 v1.2.1 发布基线；本标签源码还包含后续共享层与鸿蒙实现，不代表重建了 Android 包。
• 私有签名材料与本机签名配置不随源码发布。自行构建时在 DevEco Studio 配置自己的签名。
• 原 Android v1.2.1 标签与 Release 保留；本次双端源码基线使用新标签 client-v1.2.1。

ZViewer Android 1.2.1

更新内容

• Android 内置 B 站登录和 Go 播放代理，无需单独安装 CLI。登录后自动选择有权限且可播放的最高普通画质，排除 HDR/杜比视界；失败时优先回退 720p。
• 手机端弹幕“随屏幕缩放”默认开启。旧配置升级时应用一次新默认值，此后手动关闭会被保存；桌面网页默认值不变。
• 正式 APK 版本 1.2.1（versionCode 121），包名 com.zviewer.mobile，支持 arm64-v8a 和 x86_64，沿用 v1.1.1 官方发布包签名，可直接覆盖安装。

验证

• 前端单元测试 6 项、Playwright 端到端测试 40 项、Go 原生测试和 Android 仪器测试 2 项通过；Android Lint 与正式构建通过。
• 在 16 KB 页面模拟器上验证 1080p/720p WebView 播放、本机代理、扫码登录流程以及从官方 v1.1.1 APK 覆盖安装。真实 B 站账号登录与会员视频由使用者另行验证。

下载 APK 后可使用 SHA256SUMS.txt 校验；源码包为本次发布提交的完整 Git 快照。