Releases: cang-dot/zephyrus-player-android
Releases · cang-dot/zephyrus-player-android
Release list
v1.2.0
Release v1.2.0
Zephyrus Player 更新日志
v1.2.0
✨ 新增
- Spotify 登录集成：支持 Spotify OAuth 2.0 PKCE 登录，可在登录页直接选择 Spotify 登录
- 多平台账号切换：「我的」页长按头像触发账号切换，卡片向下拉长展示其他平台账号，统计栏与标签栏渐隐
- 设置页重构：移除独立 Spotify 设置选项卡；解锁密钥移至基础设置，意见反馈移至关于页面
- 骨架屏优化：「我的」页加载占位改为旋转图标 + 遮罩文字，取代灰色色块
- Spotify 搜索与歌单：登录后可直接搜索 Spotify 曲库并浏览歌单
🎨 优化
- 设置页默认滚动：打开设置页时自动向下滚动，避开卡片直接展示分区内容
- 我的页默认滚动：加载后与占位页位置一致，避免顶栏遮挡
- 账号切换动画：弹性缓动改为 Material 标准 ease，动画更平稳
🐛 修复
- 账号切换无效：修复点击其他账号后仍显示原账号的问题（缺少
setActiveAccount调用） - 账号选择器点击穿透：修复 backdrop 层级过高导致点击账号列表内按钮被拦截的问题
v1.1.3
✨ 新增
- 后台下载：点击「立即更新」后按钮自动变为「后台下载」，可随时切换为后台继续下载，下载完成后再次打开更新弹窗直接显示「立即安装」
- 原生线程下载更新包：APK 改为 Java 原生线程直写缓存，避免大文件经 JS 桥接导致的内存溢出闪退
- 服务器 RELEASE_NOTE 自动同步：服务器网关启动及定时拉取 GitHub Release 更新日志，自动生成
latest.json
🐛 修复
- 唤起系统安装器失败：显式定位 Google / Android / ColorOS / Oplus / OnePlus / 华为 / MIUI 各厂商包安装器并授权 URI，兜底系统选择器，解决「点击用软件包安装程序打开却没有跳转」
- 更新检查服务器优先：优先读取服务器
latest.json，兼容-beta预发布版本号比较
v1.1.2
🐛 修复
- 移动端更新检查指向错误仓库：
update.ts中getLatestReleaseInfo请求的是桌面版仓库zephyrus-player，改为优先请求 Android 仓库zephyrus-player-android - APK 下载链接指向错误仓库：
MobileUpdateModal.vue下载链接从 GitHub 桌面版仓库改为服务器直链https://mucang.xyz/zephyrus/apks/zephyrus-player-latest.apk - 全站 GitHub Releases 链接统一：
SearchBar、FloatingSearchBar、TitleBar、InstallAppModal、appUpdate.ts中所有 releases 链接统一指向zephyrus-player-android仓库
🎨 优化
- 移除冗余代理节点逻辑：移动端更新弹窗不再依赖第三方 GitHub 代理服务，直接使用服务器直链下载
- 版本号统一更新至 v1.1.2
v1.1.1
🐛 修复
- SegmentSlider 未使用变量：移除
v-for中未使用的index变量，消除 ESLint 警告 - local-music/index.vue 多重 BOM：文件开头存在多个 UTF-8 BOM 标记导致潜在解析问题，清理为单个 BOM
🎨 优化
- 版本号统一更新至 v1.1.1：
package.json/build.gradle/ README / 文档站全部同步
v1.1.0
✨ 新增
- 本地音乐完整支持：扫描本地音频文件（FLAC/MP3/OGG/WAV/M4A），自动解析元数据（封面、歌词、专辑信息），Hero Card UI 设计
- 嵌入式歌词提取：原生
MediaMetadataRetriever提取 ID3v2 USLT / FLAC LYRICS 标签，支持内嵌歌词读取 - 异步文件加载：
copyToCacheDirAsync异步复制文件到缓存目录，避免阻塞 JS 线程导致播放卡死 - GlowTabs 光晕滑块：全站统一使用
GlowTabs组件替代旧滑块，视觉一致性提升 - Hero Card 浮动卡片：可收起/展开的浮动 Hero Card 组件，用于本地音乐等页面
- 紧凑模式播放栏：底栏导航紧凑模式下播放栏自动适配，带过渡动画
- APK 自动发布 Agent：服务器每日自动从 GitHub Release 下载最新 APK，保留 30 天滑动窗口，自动更新文档下载链接
- 服务器直链下载：文档下载链接改为
https://mucang.xyz/zephyrus/apks/zephyrus-player-latest.apk
🐛 修复
- 本地音乐播放卡死：
copyToCacheDir同步 JNI 调用阻塞 JS 线程，改用copyToCacheDirAsync异步回调 - 本地音乐无声音/无进度：
setupEQ对LocalAudioPlayer提前 return 导致未连接AudioContext.destination，新增_setupEQLocalMobile方法 - 嵌入歌词不读取：
getAudioMetadata硬编码 lyrics 为 NULL，实现extractEmbeddedLyrics多策略提取 - 设置页版本号显示 v1-alpha：
AboutTab.vue硬编码版本字符串，改为从package.json动态读取config.version - 紧凑底栏对齐问题：直接复制底栏导航的位置/高度参数到紧凑播放栏
- 页面标题冗余：有 Hero Card 的页面自动隐藏顶栏标题 pill
- AudioContext 挂起：移动端后台切回后 AudioContext 可能被暂停，播放前调用
resume()
🎨 优化
- README / AIREADME 全面重写：基于实际项目结构重写，补全所有组件、服务、工具的文档
- 版本号统一：
package.json/build.gradle/AboutTab/ 文档站全部同步至 v1.1.0 - SCAN_VERSION 递增至 4：强制重新扫描以应用新的歌词提取逻辑
- 本地音乐页布局优化：内容区域下移避免被 Hero Card 遮挡
v1.0.5
✨ 新增
- 深度链接（Deep Link）分享：支持
zephyrus://song/{id}协议，点击分享链接直接拉起 App 并展示歌曲卡片 - 中转页（relay）：新增分享中转页面
relay.html，暗色玻璃拟态设计，支持 30 秒试听分享音频，海报式布局展示封面/歌名/歌手 - 分享歌曲卡片（SharedSongCard）：App 内弹出毛玻璃歌曲卡片，展示封面、歌名、歌手信息，点击播放按钮直接播放，支持返回键关闭
- 剪贴板智能识别：App 从后台切回前台时自动检测剪贴板，识别到分享链接格式自动弹出歌曲卡片
- 冷启动重试机制：深度链接冷启动时通过多次延时重试 + URL 队列缓存，确保 JS 层就绪后正确处理链接
- 海报式分享设置：生成海报时可选左下角展示软件名或 Logo、调整透明度
🐛 修复
- 深度链接冷启动不弹卡片：JS 层未就绪时调用
__handleClipboardShare无响应，新增pendingUrl队列 + 多次postDelayed重试 - 歌曲卡片被底栏遮挡：
SharedSongCardz-index 不足且定位偏低，提升至100001并改为居中定位 - 分享卡片封面缺失：
picUrl未正确传入播放器，统一handleDeepLink与handleClipboardShare的歌曲对象构建逻辑 - 深度链接偶发自动播放：移除直接自动播放逻辑，统一通过
SharedSongCard交互后播放 - 构建产物路径不匹配：
vite build输出到dist/renderer而 Capacitor 期望out/renderer，改用electron-vite build
🎨 优化
- 中转页重构：采用暗色玻璃拟态 + 琥珀色点缀设计语言，移除自动播放，与卡片交互流程统一
- 版本号升级至 v1.0.5
v1.0.0-beta
✨ 新增
- 雨夜播放器样式：3D 封面 + Canvas 雨水效果 + 歌词叠加 + 底部反射，竖屏/横屏自适应布局
- 跨平台搜索（移动端）：移动端搜索结果接入跨平台搜索，自动搜索 QQ/咪咕/酷狗/酷我/JOOX，结果去重合并
- 来源标签 + 筛选（移动端）：搜索结果每首歌标注来源（网易云/JOOX/QQ等），支持按来源筛选
- 使用文档网站：VitePress 文档站上线 www.mucang.xyz/zephyrus/docs
- 用户协议：首次启动弹出用户协议窗口，支持 Markdown 渲染
- 欢迎页重写：移除原项目收款码/公众号，改为项目 GitHub 链接 + 软件图标
- 平台账号管理：移动端支持手动输入 Cookie，localStorage fallback
- 设置-关于新增文档入口：点击跳转到使用文档网站
- GitHub Actions 自动构建发布：推送 tag 自动构建 APK 并发布 Release
🐛 修复
- 雨夜样式移动端不显示：
MobilePlayerSettings硬编码数组缺少 rain +MusicFullWrapper缺少 rain 路由 +isFeatureEnabled默认 false - 平台登录报错：
window.api.openPlatformLogin在移动端不存在，添加 fallback 到手动输入 Cookie - 功能开关默认关闭：移除额外功能面板后所有 feature flag 默认 false，改为默认 true
🎨 优化
- README 重写：新增 7 种样式说明、跨平台搜索、文档链接、下载入口
- 版本号升级至 v1.0.0-beta
v0.9.9-update
✨ 新增
- 跨平台搜索：新增多平台音乐搜索能力，支持在搜索时跨网易云/QQ/酷狗/酷我等平台匹配音源
- 歌曲来源筛选：搜索结果页新增来源筛选栏，基于
sourceProbeService即时分类（零请求）+ 懒探测（策略链），动态展示每首歌曲的真实可用音源徽章 - 平台账号管理：用户页新增
PlatformAccounts组件，集中管理各音乐平台的登录状态与 Cookie - GdMusic API 扩展：增强自定义音乐 API 解析能力，支持更多第三方音源接入
- 跨平台搜索服务：主进程新增
multiPlatformSearch模块，渲染层新增crossPlatformSearchAPI
🐛 修复
- 诡谲/陈旧模式全屏失效：
EeriePlayer与NeonPlayer缺少全屏控制逻辑，新增isFullScreen状态与toggleFullScreen方法，监听fullscreenchange事件 - 诡谲/陈旧模式遮挡侧栏与搜索框：Overlay 模式下播放器层级过高，新增
overlay-modeclass，设置z-index: 1+pointer-events: none实现穿透 - 浮动覆盖模式底部进度条不显示：
showFullStyle在 overlay 模式下始终为true触发自动收起，overlay 模式下跳过自动收起逻辑 - 浮动覆盖模式搜索框无法点击：搜索框
z-index被标题栏（3000）遮挡，提升至 3002 - 设置面板缺少新样式选项：播放器样式选项硬编码，改为从
getAllStyles()动态生成，自动包含诡谲/陈旧样式 - 歌单弹窗滚动空白：浮动覆盖模式下歌单详情列表滚动出现空白，
MusicListPage改为 flex 布局 +n-scrollbar设为flex-1 min-h-0 - 构建版本报纸纹理消失：诡谲模式报纸滤镜在
npm run build:win后失效，改用import.meta.glob动态导入确保带哈希文件名正确解析 - LX 音源脚本初始化失败：脚本未调用
lx.send(EVENT_NAMES.inited)导致超时，Worker 新增异步初始化等待机制（10 秒窗口），超时错误附带脚本诊断信息 - SSL 证书验证失败：
npm run build:win时 electron-builder 下载资源失败，配置 npmmirror 镜像源并绕过 SSL 验证
🎨 优化
- UI 统一重构：搜索结果页、歌曲列表项、设置页、用户页、平台账号管理、高潮段落编辑器全面适配设计令牌（
--d-*），消除视觉割裂感 - 高潮段落编辑器：窗口改为圆角形态并加宽，播放头从红色圆点改回竖条，时间轴与段落区域改为居中圆角窗口
- 搜索栏自动收起：浮动覆盖模式下搜索栏支持完全移出屏幕，鼠标移入顶部触发区域唤回，与侧栏/标题栏行为一致
- 语义工具类扩充：
index.css新增.d-btn-primary等核心语义工具类
v0.9.9
新增
- VHS 录像效果：诡谲模式（Eerie）前奏阶段模拟老旧 VHS 录像带的雪花噪点、扫描线、信号干扰与色彩偏移，营造复古诡谲氛围
- 设计令牌系统：建立
--d-前缀的桌面端设计令牌（表面/边框/阴影/圆角/字体/动画/z-index/间距），Tailwind 配置对接，统一全应用视觉规范 - 字体兼容性文档：README 新增字体兼容性章节，记录诡谲模式与狂躁模式经实测配合较好的字体
修复
- 全屏按钮失效：改用 Electron 原生
win.setFullScreen()替代浏览器全屏 API，修复无边框窗口（frame: false）下全屏按钮失效的问题 - 设置面板白底白字：设置面板根元素强制暗色设计令牌，替换所有硬编码
rgba(255,255,255,...)颜色值，修复亮色系统主题下白底白字不可见的问题 - 贴底进度条交互冲突：扩大贴底进度条的命中区域（
.music-time高度 +n-sliderpadding），避免与窗口 resize 手势冲突 - 播放栏隐藏时进度条消失：播放栏自动隐藏时仅渐隐内容元素，进度条保持可见和可交互，并添加渐隐动画
- VHS 效果白色累积：修复过渡阶段切歌时诡谲模式前奏 VHS 效果白色不断累加直至占满屏幕的问题。改为动态获取底色（getter 函数），避免频繁重启动画；每帧用
clearRect+setTransform确保画布完全清除；停止动画时清除画布残留
优化
- UI 统一：圆角/阴影统一为设计令牌工具类（
rounded-d-*/shadow-d-*），页面背景统一为.page-bg/.page-card工具类 - 组件复用：Magazine 模式复用
PlayerControls组件（新增#extra插槽），移除重复控制代码 - TitleBar 合并：合并
TitleBar与OverlayTitleBar，自动收起行为整合到统一组件 - 主色统一：统一主色变量为单一
--accent-color，移除--dynamic-primary和--primary-color的直接使用
v1.1.3-beta
Release v1.1.3-beta
Zephyrus Player 更新日志
v1.1.2
🐛 修复
- 移动端更新检查指向错误仓库：
update.ts中getLatestReleaseInfo请求的是桌面版仓库zephyrus-player，改为优先请求 Android 仓库zephyrus-player-android - APK 下载链接指向错误仓库：
MobileUpdateModal.vue下载链接从 GitHub 桌面版仓库改为服务器直链https://mucang.xyz/zephyrus/apks/zephyrus-player-latest.apk - 全站 GitHub Releases 链接统一：
SearchBar、FloatingSearchBar、TitleBar、InstallAppModal、appUpdate.ts中所有 releases 链接统一指向zephyrus-player-android仓库
🎨 优化
- 移除冗余代理节点逻辑：移动端更新弹窗不再依赖第三方 GitHub 代理服务，直接使用服务器直链下载
- 版本号统一更新至 v1.1.2
v1.1.1
🐛 修复
- SegmentSlider 未使用变量：移除
v-for中未使用的index变量，消除 ESLint 警告 - local-music/index.vue 多重 BOM：文件开头存在多个 UTF-8 BOM 标记导致潜在解析问题，清理为单个 BOM
🎨 优化
- 版本号统一更新至 v1.1.1：
package.json/build.gradle/ README / 文档站全部同步
v1.1.0
✨ 新增
- 本地音乐完整支持：扫描本地音频文件（FLAC/MP3/OGG/WAV/M4A），自动解析元数据（封面、歌词、专辑信息），Hero Card UI 设计
- 嵌入式歌词提取：原生
MediaMetadataRetriever提取 ID3v2 USLT / FLAC LYRICS 标签，支持内嵌歌词读取 - 异步文件加载：
copyToCacheDirAsync异步复制文件到缓存目录，避免阻塞 JS 线程导致播放卡死 - GlowTabs 光晕滑块：全站统一使用
GlowTabs组件替代旧滑块，视觉一致性提升 - Hero Card 浮动卡片：可收起/展开的浮动 Hero Card 组件，用于本地音乐等页面
- 紧凑模式播放栏：底栏导航紧凑模式下播放栏自动适配，带过渡动画
- APK 自动发布 Agent：服务器每日自动从 GitHub Release 下载最新 APK，保留 30 天滑动窗口，自动更新文档下载链接
- 服务器直链下载：文档下载链接改为
https://mucang.xyz/zephyrus/apks/zephyrus-player-latest.apk
🐛 修复
- 本地音乐播放卡死：
copyToCacheDir同步 JNI 调用阻塞 JS 线程，改用copyToCacheDirAsync异步回调 - 本地音乐无声音/无进度：
setupEQ对LocalAudioPlayer提前 return 导致未连接AudioContext.destination，新增_setupEQLocalMobile方法 - 嵌入歌词不读取：
getAudioMetadata硬编码 lyrics 为 NULL，实现extractEmbeddedLyrics多策略提取 - 设置页版本号显示 v1-alpha：
AboutTab.vue硬编码版本字符串，改为从package.json动态读取config.version - 紧凑底栏对齐问题：直接复制底栏导航的位置/高度参数到紧凑播放栏
- 页面标题冗余：有 Hero Card 的页面自动隐藏顶栏标题 pill
- AudioContext 挂起：移动端后台切回后 AudioContext 可能被暂停，播放前调用
resume()
🎨 优化
- README / AIREADME 全面重写：基于实际项目结构重写，补全所有组件、服务、工具的文档
- 版本号统一：
package.json/build.gradle/AboutTab/ 文档站全部同步至 v1.1.0 - SCAN_VERSION 递增至 4：强制重新扫描以应用新的歌词提取逻辑
- 本地音乐页布局优化：内容区域下移避免被 Hero Card 遮挡
v1.0.5
✨ 新增
- 深度链接（Deep Link）分享：支持
zephyrus://song/{id}协议，点击分享链接直接拉起 App 并展示歌曲卡片 - 中转页（relay）：新增分享中转页面
relay.html，暗色玻璃拟态设计，支持 30 秒试听分享音频，海报式布局展示封面/歌名/歌手 - 分享歌曲卡片（SharedSongCard）：App 内弹出毛玻璃歌曲卡片，展示封面、歌名、歌手信息，点击播放按钮直接播放，支持返回键关闭
- 剪贴板智能识别：App 从后台切回前台时自动检测剪贴板，识别到分享链接格式自动弹出歌曲卡片
- 冷启动重试机制：深度链接冷启动时通过多次延时重试 + URL 队列缓存，确保 JS 层就绪后正确处理链接
- 海报式分享设置：生成海报时可选左下角展示软件名或 Logo、调整透明度
🐛 修复
- 深度链接冷启动不弹卡片：JS 层未就绪时调用
__handleClipboardShare无响应，新增pendingUrl队列 + 多次postDelayed重试 - 歌曲卡片被底栏遮挡：
SharedSongCardz-index 不足且定位偏低，提升至100001并改为居中定位 - 分享卡片封面缺失：
picUrl未正确传入播放器，统一handleDeepLink与handleClipboardShare的歌曲对象构建逻辑 - 深度链接偶发自动播放：移除直接自动播放逻辑，统一通过
SharedSongCard交互后播放 - 构建产物路径不匹配：
vite build输出到dist/renderer而 Capacitor 期望out/renderer，改用electron-vite build
🎨 优化
- 中转页重构：采用暗色玻璃拟态 + 琥珀色点缀设计语言，移除自动播放，与卡片交互流程统一
- 版本号升级至 v1.0.5
v1.0.0-beta
✨ 新增
- 雨夜播放器样式：3D 封面 + Canvas 雨水效果 + 歌词叠加 + 底部反射，竖屏/横屏自适应布局
- 跨平台搜索（移动端）：移动端搜索结果接入跨平台搜索，自动搜索 QQ/咪咕/酷狗/酷我/JOOX，结果去重合并
- 来源标签 + 筛选（移动端）：搜索结果每首歌标注来源（网易云/JOOX/QQ等），支持按来源筛选
- 使用文档网站：VitePress 文档站上线 www.mucang.xyz/zephyrus/docs
- 用户协议：首次启动弹出用户协议窗口，支持 Markdown 渲染
- 欢迎页重写：移除原项目收款码/公众号，改为项目 GitHub 链接 + 软件图标
- 平台账号管理：移动端支持手动输入 Cookie，localStorage fallback
- 设置-关于新增文档入口：点击跳转到使用文档网站
- GitHub Actions 自动构建发布：推送 tag 自动构建 APK 并发布 Release
🐛 修复
- 雨夜样式移动端不显示：
MobilePlayerSettings硬编码数组缺少 rain +MusicFullWrapper缺少 rain 路由 +isFeatureEnabled默认 false - 平台登录报错：
window.api.openPlatformLogin在移动端不存在，添加 fallback 到手动输入 Cookie - 功能开关默认关闭：移除额外功能面板后所有 feature flag 默认 false，改为默认 true
🎨 优化
- README 重写：新增 7 种样式说明、跨平台搜索、文档链接、下载入口
- 版本号升级至 v1.0.0-beta
v0.9.9-update
✨ 新增
- 跨平台搜索：新增多平台音乐搜索能力，支持在搜索时跨网易云/QQ/酷狗/酷我等平台匹配音源
- 歌曲来源筛选：搜索结果页新增来源筛选栏，基于
sourceProbeService即时分类（零请求）+ 懒探测（策略链），动态展示每首歌曲的真实可用音源徽章 - 平台账号管理：用户页新增
PlatformAccounts组件，集中管理各音乐平台的登录状态与 Cookie - GdMusic API 扩展：增强自定义音乐 API 解析能力，支持更多第三方音源接入
- 跨平台搜索服务：主进程新增
multiPlatformSearch模块，渲染层新增crossPlatformSearchAPI
🐛 修复
- 诡谲/陈旧模式全屏失效：
EeriePlayer与NeonPlayer缺少全屏控制逻辑，新增isFullScreen状态与toggleFullScreen方法，监听fullscreenchange事件 - 诡谲/陈旧模式遮挡侧栏与搜索框：Overlay 模式下播放器层级过高，新增
overlay-modeclass，设置z-index: 1+pointer-events: none实现穿透 - 浮动覆盖模式底部进度条不显示：
showFullStyle在 overlay 模式下始终为true触发自动收起，overlay 模式下跳过自动收起逻辑 - 浮动覆盖模式搜索框无法点击：搜索框
z-index被标题栏（3000）遮挡，提升至 3002 - 设置面板缺少新样式选项：播放器样式选项硬编码，改为从
getAllStyles()动态生成，自动包含诡谲/陈旧样式 - 歌单弹窗滚动空白：浮动覆盖模式下歌单详情列表滚动出现空白，
MusicListPage改为 flex 布局 +n-scrollbar设为flex-1 min-h-0 - 构建版本报纸纹理消失：诡谲模式报纸滤镜在
npm run build:win后失效，改用import.meta.glob动态导入确保带哈希文件名正确解析 - LX 音源脚本初始化失败：脚本未调用
lx.send(EVENT_NAMES.inited)导致超时，Worker 新增异步初始化等待机制（10 秒窗口），超时错误附带脚本诊断信息 - SSL 证书验证失败：
npm run build:win时 electron-builder 下载资源失败，配置 npmmirror 镜像源并绕过 SSL 验证
🎨 优化
- UI 统一重构：搜索结果页、歌曲列表项、设置页、用户页、平台账号管理、高潮段落编辑器全面适配设计令牌（
--d-*），消除视觉割裂感 - 高潮段落编辑器：窗口改为圆角形态并加宽，播放头从红色圆点改回竖条，时间轴与段落区域改为居中圆角窗口
- 搜索栏自动收起：浮动覆盖模式下搜索栏支持完全移出屏幕，鼠标移入顶部触发区域唤回，与侧栏/标题栏行为一致
- 语义工具类扩充：
index.css新增.d-btn-primary等核心语义工具类
v0.9.9
新增
- VHS 录像效果：诡谲模式（Eerie）前奏阶段模拟老旧 VHS 录像带的雪花噪点、扫描线、信号干扰与色彩偏移，营造复古诡谲氛围
- 设计令牌系统：建立
--d-前缀的桌面端设计令牌（表面/边框/阴影/圆角/字体/动画/z-index/间距），Tailwind 配置对接，统一全应用视觉规范 - 字体兼容性文档：README 新增字体兼容性章节，记录诡谲模式与狂躁模式经实测配合较好的字体
修复
- 全屏按钮失效：改用 Electron 原生
win.setFullScreen()替代浏览器全屏 API，修复无边框窗口（frame: false）下全屏按钮失效的问题 - 设置面板白底白字：设置面板根元素强制暗色设计令牌，替换所有硬编码
rgba(255,255,255,...)颜色值，修复亮色系统主题下白底白字不可见的问题 - 贴底进度条交互冲突：扩大贴底进度条的命中区域（
.music-time高度 +n-sliderpadding），避免与窗口 resize 手势冲突 - 播放栏隐藏时进度条消失：播放栏自动隐藏时仅渐隐内容元素，进度条保持可见和可交互，并添加渐隐动画
- VHS 效果白色累积：修复过渡阶段切歌时诡谲模式前奏 VHS 效果白色不断累加直至占满屏幕的问题。改为动态获取底色（getter 函数），避免频繁重启动画；每帧用
clearRect+setTransform确保画布完全清除；停止动画时清除画布残留
优化
- UI 统一：圆角/阴影统一为设计令牌工具类（
rounded-d-*/shadow-d-*），页面背景统一为.page-bg/.page-card工具类 - 组件复用：Magazine 模式复用
PlayerControls组件（新增#extra插槽），移除重复控制代码 - TitleBar 合并：合并
TitleBar与OverlayTitleBar，自动收起行为整合到统一组件 - 主色统一：统一主色变量为单一
--accent-color，移除--dynamic-primary和--primary-color的直接使用
v1.1.3
Release v1.1.3
Zephyrus Player 更新日志
v1.1.3
✨ 新增
- 后台下载：点击「立即更新」后按钮自动变为「后台下载」，可随时切换为后台继续下载，下载完成后再次打开更新弹窗直接显示「立即安装」
- 原生线程下载更新包：APK 改为 Java 原生线程直写缓存，避免大文件经 JS 桥接导致的内存溢出闪退
- 服务器 RELEASE_NOTE 自动同步：服务器网关启动及定时拉取 GitHub Release 更新日志，自动生成
latest.json
🐛 修复
- 唤起系统安装器失败：显式定位 Google / Android / ColorOS / Oplus / OnePlus / 华为 / MIUI 各厂商包安装器并授权 URI，兜底系统选择器，解决「点击用软件包安装程序打开却没有跳转」
- 更新检查服务器优先：优先读取服务器
latest.json，兼容-beta预发布版本号比较
v1.1.2
🐛 修复
- 移动端更新检查指向错误仓库：
update.ts中getLatestReleaseInfo请求的是桌面版仓库zephyrus-player，改为优先请求 Android 仓库zephyrus-player-android - APK 下载链接指向错误仓库：
MobileUpdateModal.vue下载链接从 GitHub 桌面版仓库改为服务器直链https://mucang.xyz/zephyrus/apks/zephyrus-player-latest.apk - 全站 GitHub Releases 链接统一：
SearchBar、FloatingSearchBar、TitleBar、InstallAppModal、appUpdate.ts中所有 releases 链接统一指向zephyrus-player-android仓库
🎨 优化
- 移除冗余代理节点逻辑：移动端更新弹窗不再依赖第三方 GitHub 代理服务，直接使用服务器直链下载
- 版本号统一更新至 v1.1.2
v1.1.1
🐛 修复
- SegmentSlider 未使用变量：移除
v-for中未使用的index变量，消除 ESLint 警告 - local-music/index.vue 多重 BOM：文件开头存在多个 UTF-8 BOM 标记导致潜在解析问题，清理为单个 BOM
🎨 优化
- 版本号统一更新至 v1.1.1：
package.json/build.gradle/ README / 文档站全部同步
v1.1.0
✨ 新增
- 本地音乐完整支持：扫描本地音频文件（FLAC/MP3/OGG/WAV/M4A），自动解析元数据（封面、歌词、专辑信息），Hero Card UI 设计
- 嵌入式歌词提取：原生
MediaMetadataRetriever提取 ID3v2 USLT / FLAC LYRICS 标签，支持内嵌歌词读取 - 异步文件加载：
copyToCacheDirAsync异步复制文件到缓存目录，避免阻塞 JS 线程导致播放卡死 - GlowTabs 光晕滑块：全站统一使用
GlowTabs组件替代旧滑块，视觉一致性提升 - Hero Card 浮动卡片：可收起/展开的浮动 Hero Card 组件，用于本地音乐等页面
- 紧凑模式播放栏：底栏导航紧凑模式下播放栏自动适配，带过渡动画
- APK 自动发布 Agent：服务器每日自动从 GitHub Release 下载最新 APK，保留 30 天滑动窗口，自动更新文档下载链接
- 服务器直链下载：文档下载链接改为
https://mucang.xyz/zephyrus/apks/zephyrus-player-latest.apk
🐛 修复
- 本地音乐播放卡死：
copyToCacheDir同步 JNI 调用阻塞 JS 线程，改用copyToCacheDirAsync异步回调 - 本地音乐无声音/无进度：
setupEQ对LocalAudioPlayer提前 return 导致未连接AudioContext.destination，新增_setupEQLocalMobile方法 - 嵌入歌词不读取：
getAudioMetadata硬编码 lyrics 为 NULL，实现extractEmbeddedLyrics多策略提取 - 设置页版本号显示 v1-alpha：
AboutTab.vue硬编码版本字符串，改为从package.json动态读取config.version - 紧凑底栏对齐问题：直接复制底栏导航的位置/高度参数到紧凑播放栏
- 页面标题冗余：有 Hero Card 的页面自动隐藏顶栏标题 pill
- AudioContext 挂起：移动端后台切回后 AudioContext 可能被暂停，播放前调用
resume()
🎨 优化
- README / AIREADME 全面重写：基于实际项目结构重写，补全所有组件、服务、工具的文档
- 版本号统一：
package.json/build.gradle/AboutTab/ 文档站全部同步至 v1.1.0 - SCAN_VERSION 递增至 4：强制重新扫描以应用新的歌词提取逻辑
- 本地音乐页布局优化：内容区域下移避免被 Hero Card 遮挡
v1.0.5
✨ 新增
- 深度链接（Deep Link）分享：支持
zephyrus://song/{id}协议，点击分享链接直接拉起 App 并展示歌曲卡片 - 中转页（relay）：新增分享中转页面
relay.html，暗色玻璃拟态设计，支持 30 秒试听分享音频，海报式布局展示封面/歌名/歌手 - 分享歌曲卡片（SharedSongCard）：App 内弹出毛玻璃歌曲卡片，展示封面、歌名、歌手信息，点击播放按钮直接播放，支持返回键关闭
- 剪贴板智能识别：App 从后台切回前台时自动检测剪贴板，识别到分享链接格式自动弹出歌曲卡片
- 冷启动重试机制：深度链接冷启动时通过多次延时重试 + URL 队列缓存，确保 JS 层就绪后正确处理链接
- 海报式分享设置：生成海报时可选左下角展示软件名或 Logo、调整透明度
🐛 修复
- 深度链接冷启动不弹卡片：JS 层未就绪时调用
__handleClipboardShare无响应，新增pendingUrl队列 + 多次postDelayed重试 - 歌曲卡片被底栏遮挡：
SharedSongCardz-index 不足且定位偏低，提升至100001并改为居中定位 - 分享卡片封面缺失：
picUrl未正确传入播放器，统一handleDeepLink与handleClipboardShare的歌曲对象构建逻辑 - 深度链接偶发自动播放：移除直接自动播放逻辑，统一通过
SharedSongCard交互后播放 - 构建产物路径不匹配：
vite build输出到dist/renderer而 Capacitor 期望out/renderer，改用electron-vite build
🎨 优化
- 中转页重构：采用暗色玻璃拟态 + 琥珀色点缀设计语言，移除自动播放，与卡片交互流程统一
- 版本号升级至 v1.0.5
v1.0.0-beta
✨ 新增
- 雨夜播放器样式：3D 封面 + Canvas 雨水效果 + 歌词叠加 + 底部反射，竖屏/横屏自适应布局
- 跨平台搜索（移动端）：移动端搜索结果接入跨平台搜索，自动搜索 QQ/咪咕/酷狗/酷我/JOOX，结果去重合并
- 来源标签 + 筛选（移动端）：搜索结果每首歌标注来源（网易云/JOOX/QQ等），支持按来源筛选
- 使用文档网站：VitePress 文档站上线 www.mucang.xyz/zephyrus/docs
- 用户协议：首次启动弹出用户协议窗口，支持 Markdown 渲染
- 欢迎页重写：移除原项目收款码/公众号，改为项目 GitHub 链接 + 软件图标
- 平台账号管理：移动端支持手动输入 Cookie，localStorage fallback
- 设置-关于新增文档入口：点击跳转到使用文档网站
- GitHub Actions 自动构建发布：推送 tag 自动构建 APK 并发布 Release
🐛 修复
- 雨夜样式移动端不显示：
MobilePlayerSettings硬编码数组缺少 rain +MusicFullWrapper缺少 rain 路由 +isFeatureEnabled默认 false - 平台登录报错：
window.api.openPlatformLogin在移动端不存在，添加 fallback 到手动输入 Cookie - 功能开关默认关闭：移除额外功能面板后所有 feature flag 默认 false，改为默认 true
🎨 优化
- README 重写：新增 7 种样式说明、跨平台搜索、文档链接、下载入口
- 版本号升级至 v1.0.0-beta
v0.9.9-update
✨ 新增
- 跨平台搜索：新增多平台音乐搜索能力，支持在搜索时跨网易云/QQ/酷狗/酷我等平台匹配音源
- 歌曲来源筛选：搜索结果页新增来源筛选栏，基于
sourceProbeService即时分类（零请求）+ 懒探测（策略链），动态展示每首歌曲的真实可用音源徽章 - 平台账号管理：用户页新增
PlatformAccounts组件，集中管理各音乐平台的登录状态与 Cookie - GdMusic API 扩展：增强自定义音乐 API 解析能力，支持更多第三方音源接入
- 跨平台搜索服务：主进程新增
multiPlatformSearch模块，渲染层新增crossPlatformSearchAPI
🐛 修复
- 诡谲/陈旧模式全屏失效：
EeriePlayer与NeonPlayer缺少全屏控制逻辑，新增isFullScreen状态与toggleFullScreen方法，监听fullscreenchange事件 - 诡谲/陈旧模式遮挡侧栏与搜索框：Overlay 模式下播放器层级过高，新增
overlay-modeclass，设置z-index: 1+pointer-events: none实现穿透 - 浮动覆盖模式底部进度条不显示：
showFullStyle在 overlay 模式下始终为true触发自动收起，overlay 模式下跳过自动收起逻辑 - 浮动覆盖模式搜索框无法点击：搜索框
z-index被标题栏（3000）遮挡，提升至 3002 - 设置面板缺少新样式选项：播放器样式选项硬编码，改为从
getAllStyles()动态生成，自动包含诡谲/陈旧样式 - 歌单弹窗滚动空白：浮动覆盖模式下歌单详情列表滚动出现空白，
MusicListPage改为 flex 布局 +n-scrollbar设为flex-1 min-h-0 - 构建版本报纸纹理消失：诡谲模式报纸滤镜在
npm run build:win后失效，改用import.meta.glob动态导入确保带哈希文件名正确解析 - LX 音源脚本初始化失败：脚本未调用
lx.send(EVENT_NAMES.inited)导致超时，Worker 新增异步初始化等待机制（10 秒窗口），超时错误附带脚本诊断信息 - SSL 证书验证失败：
npm run build:win时 electron-builder 下载资源失败，配置 npmmirror 镜像源并绕过 SSL 验证
🎨 优化
- UI 统一重构：搜索结果页、歌曲列表项、设置页、用户页、平台账号管理、高潮段落编辑器全面适配设计令牌（
--d-*），消除视觉割裂感 - 高潮段落编辑器：窗口改为圆角形态并加宽，播放头从红色圆点改回竖条，时间轴与段落区域改为居中圆角窗口
- 搜索栏自动收起：浮动覆盖模式下搜索栏支持完全移出屏幕，鼠标移入顶部触发区域唤回，与侧栏/标题栏行为一致
- 语义工具类扩充：
index.css新增.d-btn-primary等核心语义工具类
v0.9.9
新增
- VHS 录像效果：诡谲模式（Eerie）前奏阶段模拟老旧 VHS 录像带的雪花噪点、扫描线、信号干扰与色彩偏移，营造复古诡谲氛围
- 设计令牌系统：建立
--d-前缀的桌面端设计令牌（表面/边框/阴影/圆角/字体/动画/z-index/间距），Tailwind 配置对接，统一全应用视觉规范 - 字体兼容性文档：README 新增字体兼容性章节，记录诡谲模式与狂躁模式经实测配合较好的字体
修复
- 全屏按钮失效：改用 Electron 原生
win.setFullScreen()替代浏览器全屏 API，修复无边框窗口（frame: false）下全屏按钮失效的问题 - 设置面板白底白字：设置面板根元素强制暗色设计令牌，替换所有硬编码
rgba(255,255,255,...)颜色值，修复亮色系统主题下白底白字不可见的问题 - 贴底进度条交互冲突：扩大贴底进度条的命中区域（
.music-time高度 +n-sliderpadding），避免与窗口 resize 手势冲突 - 播放栏隐藏时进度条消失：播放栏自动隐藏时仅渐隐内容元素，进度条保持可见和可交互，并添加渐隐动画
- VHS 效果白色累积：修复过渡阶段切歌时诡谲模式前奏 VHS 效果白色不断累加直至占满屏幕的问题。改为动态获取底色（getter 函数），避免频繁重启动画；每帧用
clearRect+setTransform确保画布完全清除；停止动画时清除画布残留
优化
- UI 统一：圆角/阴影统一为设计令牌工具类（
rounded-d-*/shadow-d-*），页面背景统一为.page-bg/.page-card工具类 - 组件复用：Magazine 模式复用
PlayerControls组件（新增#extra插槽），移除重复控制代码 - TitleBar 合并：合并
TitleBar与OverlayTitleBar，自动收起行为整合到统一组件 - 主色统一：统一主色变量为单一
--accent-color，移除--dynamic-primary和--primary-color的直接使用
v1.1.2
Release v1.1.2
Zephyrus Player 更新日志
v1.1.2
🐛 修复
- 移动端更新检查指向错误仓库：
update.ts中getLatestReleaseInfo请求的是桌面版仓库zephyrus-player，改为优先请求 Android 仓库zephyrus-player-android - APK 下载链接指向错误仓库：
MobileUpdateModal.vue下载链接从 GitHub 桌面版仓库改为服务器直链https://mucang.xyz/zephyrus/apks/zephyrus-player-latest.apk - 全站 GitHub Releases 链接统一：
SearchBar、FloatingSearchBar、TitleBar、InstallAppModal、appUpdate.ts中所有 releases 链接统一指向zephyrus-player-android仓库
🎨 优化
- 移除冗余代理节点逻辑：移动端更新弹窗不再依赖第三方 GitHub 代理服务，直接使用服务器直链下载
- 版本号统一更新至 v1.1.2
v1.1.1
🐛 修复
- SegmentSlider 未使用变量：移除
v-for中未使用的index变量，消除 ESLint 警告 - local-music/index.vue 多重 BOM：文件开头存在多个 UTF-8 BOM 标记导致潜在解析问题，清理为单个 BOM
🎨 优化
- 版本号统一更新至 v1.1.1：
package.json/build.gradle/ README / 文档站全部同步
v1.1.0
✨ 新增
- 本地音乐完整支持：扫描本地音频文件（FLAC/MP3/OGG/WAV/M4A），自动解析元数据（封面、歌词、专辑信息），Hero Card UI 设计
- 嵌入式歌词提取：原生
MediaMetadataRetriever提取 ID3v2 USLT / FLAC LYRICS 标签，支持内嵌歌词读取 - 异步文件加载：
copyToCacheDirAsync异步复制文件到缓存目录，避免阻塞 JS 线程导致播放卡死 - GlowTabs 光晕滑块：全站统一使用
GlowTabs组件替代旧滑块，视觉一致性提升 - Hero Card 浮动卡片：可收起/展开的浮动 Hero Card 组件，用于本地音乐等页面
- 紧凑模式播放栏：底栏导航紧凑模式下播放栏自动适配，带过渡动画
- APK 自动发布 Agent：服务器每日自动从 GitHub Release 下载最新 APK，保留 30 天滑动窗口，自动更新文档下载链接
- 服务器直链下载：文档下载链接改为
https://mucang.xyz/zephyrus/apks/zephyrus-player-latest.apk
🐛 修复
- 本地音乐播放卡死：
copyToCacheDir同步 JNI 调用阻塞 JS 线程，改用copyToCacheDirAsync异步回调 - 本地音乐无声音/无进度：
setupEQ对LocalAudioPlayer提前 return 导致未连接AudioContext.destination，新增_setupEQLocalMobile方法 - 嵌入歌词不读取：
getAudioMetadata硬编码 lyrics 为 NULL，实现extractEmbeddedLyrics多策略提取 - 设置页版本号显示 v1-alpha：
AboutTab.vue硬编码版本字符串，改为从package.json动态读取config.version - 紧凑底栏对齐问题：直接复制底栏导航的位置/高度参数到紧凑播放栏
- 页面标题冗余：有 Hero Card 的页面自动隐藏顶栏标题 pill
- AudioContext 挂起：移动端后台切回后 AudioContext 可能被暂停，播放前调用
resume()
🎨 优化
- README / AIREADME 全面重写：基于实际项目结构重写，补全所有组件、服务、工具的文档
- 版本号统一：
package.json/build.gradle/AboutTab/ 文档站全部同步至 v1.1.0 - SCAN_VERSION 递增至 4：强制重新扫描以应用新的歌词提取逻辑
- 本地音乐页布局优化：内容区域下移避免被 Hero Card 遮挡
v1.0.5
✨ 新增
- 深度链接（Deep Link）分享：支持
zephyrus://song/{id}协议，点击分享链接直接拉起 App 并展示歌曲卡片 - 中转页（relay）：新增分享中转页面
relay.html，暗色玻璃拟态设计，支持 30 秒试听分享音频，海报式布局展示封面/歌名/歌手 - 分享歌曲卡片（SharedSongCard）：App 内弹出毛玻璃歌曲卡片，展示封面、歌名、歌手信息，点击播放按钮直接播放，支持返回键关闭
- 剪贴板智能识别：App 从后台切回前台时自动检测剪贴板，识别到分享链接格式自动弹出歌曲卡片
- 冷启动重试机制：深度链接冷启动时通过多次延时重试 + URL 队列缓存，确保 JS 层就绪后正确处理链接
- 海报式分享设置：生成海报时可选左下角展示软件名或 Logo、调整透明度
🐛 修复
- 深度链接冷启动不弹卡片：JS 层未就绪时调用
__handleClipboardShare无响应，新增pendingUrl队列 + 多次postDelayed重试 - 歌曲卡片被底栏遮挡：
SharedSongCardz-index 不足且定位偏低，提升至100001并改为居中定位 - 分享卡片封面缺失：
picUrl未正确传入播放器，统一handleDeepLink与handleClipboardShare的歌曲对象构建逻辑 - 深度链接偶发自动播放：移除直接自动播放逻辑，统一通过
SharedSongCard交互后播放 - 构建产物路径不匹配：
vite build输出到dist/renderer而 Capacitor 期望out/renderer，改用electron-vite build
🎨 优化
- 中转页重构：采用暗色玻璃拟态 + 琥珀色点缀设计语言，移除自动播放，与卡片交互流程统一
- 版本号升级至 v1.0.5
v1.0.0-beta
✨ 新增
- 雨夜播放器样式：3D 封面 + Canvas 雨水效果 + 歌词叠加 + 底部反射，竖屏/横屏自适应布局
- 跨平台搜索（移动端）：移动端搜索结果接入跨平台搜索，自动搜索 QQ/咪咕/酷狗/酷我/JOOX，结果去重合并
- 来源标签 + 筛选（移动端）：搜索结果每首歌标注来源（网易云/JOOX/QQ等），支持按来源筛选
- 使用文档网站：VitePress 文档站上线 www.mucang.xyz/zephyrus/docs
- 用户协议：首次启动弹出用户协议窗口，支持 Markdown 渲染
- 欢迎页重写：移除原项目收款码/公众号，改为项目 GitHub 链接 + 软件图标
- 平台账号管理：移动端支持手动输入 Cookie，localStorage fallback
- 设置-关于新增文档入口：点击跳转到使用文档网站
- GitHub Actions 自动构建发布：推送 tag 自动构建 APK 并发布 Release
🐛 修复
- 雨夜样式移动端不显示：
MobilePlayerSettings硬编码数组缺少 rain +MusicFullWrapper缺少 rain 路由 +isFeatureEnabled默认 false - 平台登录报错：
window.api.openPlatformLogin在移动端不存在，添加 fallback 到手动输入 Cookie - 功能开关默认关闭：移除额外功能面板后所有 feature flag 默认 false，改为默认 true
🎨 优化
- README 重写：新增 7 种样式说明、跨平台搜索、文档链接、下载入口
- 版本号升级至 v1.0.0-beta
v0.9.9-update
✨ 新增
- 跨平台搜索：新增多平台音乐搜索能力，支持在搜索时跨网易云/QQ/酷狗/酷我等平台匹配音源
- 歌曲来源筛选：搜索结果页新增来源筛选栏，基于
sourceProbeService即时分类（零请求）+ 懒探测（策略链），动态展示每首歌曲的真实可用音源徽章 - 平台账号管理：用户页新增
PlatformAccounts组件，集中管理各音乐平台的登录状态与 Cookie - GdMusic API 扩展：增强自定义音乐 API 解析能力，支持更多第三方音源接入
- 跨平台搜索服务：主进程新增
multiPlatformSearch模块，渲染层新增crossPlatformSearchAPI
🐛 修复
- 诡谲/陈旧模式全屏失效：
EeriePlayer与NeonPlayer缺少全屏控制逻辑，新增isFullScreen状态与toggleFullScreen方法，监听fullscreenchange事件 - 诡谲/陈旧模式遮挡侧栏与搜索框：Overlay 模式下播放器层级过高，新增
overlay-modeclass，设置z-index: 1+pointer-events: none实现穿透 - 浮动覆盖模式底部进度条不显示：
showFullStyle在 overlay 模式下始终为true触发自动收起，overlay 模式下跳过自动收起逻辑 - 浮动覆盖模式搜索框无法点击：搜索框
z-index被标题栏（3000）遮挡，提升至 3002 - 设置面板缺少新样式选项：播放器样式选项硬编码，改为从
getAllStyles()动态生成，自动包含诡谲/陈旧样式 - 歌单弹窗滚动空白：浮动覆盖模式下歌单详情列表滚动出现空白，
MusicListPage改为 flex 布局 +n-scrollbar设为flex-1 min-h-0 - 构建版本报纸纹理消失：诡谲模式报纸滤镜在
npm run build:win后失效，改用import.meta.glob动态导入确保带哈希文件名正确解析 - LX 音源脚本初始化失败：脚本未调用
lx.send(EVENT_NAMES.inited)导致超时，Worker 新增异步初始化等待机制（10 秒窗口），超时错误附带脚本诊断信息 - SSL 证书验证失败：
npm run build:win时 electron-builder 下载资源失败，配置 npmmirror 镜像源并绕过 SSL 验证
🎨 优化
- UI 统一重构：搜索结果页、歌曲列表项、设置页、用户页、平台账号管理、高潮段落编辑器全面适配设计令牌（
--d-*），消除视觉割裂感 - 高潮段落编辑器：窗口改为圆角形态并加宽，播放头从红色圆点改回竖条，时间轴与段落区域改为居中圆角窗口
- 搜索栏自动收起：浮动覆盖模式下搜索栏支持完全移出屏幕，鼠标移入顶部触发区域唤回，与侧栏/标题栏行为一致
- 语义工具类扩充：
index.css新增.d-btn-primary等核心语义工具类
v0.9.9
新增
- VHS 录像效果：诡谲模式（Eerie）前奏阶段模拟老旧 VHS 录像带的雪花噪点、扫描线、信号干扰与色彩偏移，营造复古诡谲氛围
- 设计令牌系统：建立
--d-前缀的桌面端设计令牌（表面/边框/阴影/圆角/字体/动画/z-index/间距），Tailwind 配置对接，统一全应用视觉规范 - 字体兼容性文档：README 新增字体兼容性章节，记录诡谲模式与狂躁模式经实测配合较好的字体
修复
- 全屏按钮失效：改用 Electron 原生
win.setFullScreen()替代浏览器全屏 API，修复无边框窗口（frame: false）下全屏按钮失效的问题 - 设置面板白底白字：设置面板根元素强制暗色设计令牌，替换所有硬编码
rgba(255,255,255,...)颜色值，修复亮色系统主题下白底白字不可见的问题 - 贴底进度条交互冲突：扩大贴底进度条的命中区域（
.music-time高度 +n-sliderpadding），避免与窗口 resize 手势冲突 - 播放栏隐藏时进度条消失：播放栏自动隐藏时仅渐隐内容元素，进度条保持可见和可交互，并添加渐隐动画
- VHS 效果白色累积：修复过渡阶段切歌时诡谲模式前奏 VHS 效果白色不断累加直至占满屏幕的问题。改为动态获取底色（getter 函数），避免频繁重启动画；每帧用
clearRect+setTransform确保画布完全清除；停止动画时清除画布残留
优化
- UI 统一：圆角/阴影统一为设计令牌工具类（
rounded-d-*/shadow-d-*），页面背景统一为.page-bg/.page-card工具类 - 组件复用：Magazine 模式复用
PlayerControls组件（新增#extra插槽），移除重复控制代码 - TitleBar 合并：合并
TitleBar与OverlayTitleBar，自动收起行为整合到统一组件 - 主色统一：统一主色变量为单一
--accent-color，移除--dynamic-primary和--primary-color的直接使用
v1.1.1
Release v1.1.1
Zephyrus Player 更新日志
v1.1.1
🐛 修复
- SegmentSlider 未使用变量：移除
v-for中未使用的index变量，消除 ESLint 警告 - local-music/index.vue 多重 BOM：文件开头存在多个 UTF-8 BOM 标记导致潜在解析问题，清理为单个 BOM
🎨 优化
- 版本号统一更新至 v1.1.1：
package.json/build.gradle/ README / 文档站全部同步
v1.1.0
✨ 新增
- 本地音乐完整支持：扫描本地音频文件（FLAC/MP3/OGG/WAV/M4A），自动解析元数据（封面、歌词、专辑信息），Hero Card UI 设计
- 嵌入式歌词提取：原生
MediaMetadataRetriever提取 ID3v2 USLT / FLAC LYRICS 标签，支持内嵌歌词读取 - 异步文件加载：
copyToCacheDirAsync异步复制文件到缓存目录，避免阻塞 JS 线程导致播放卡死 - GlowTabs 光晕滑块：全站统一使用
GlowTabs组件替代旧滑块，视觉一致性提升 - Hero Card 浮动卡片：可收起/展开的浮动 Hero Card 组件，用于本地音乐等页面
- 紧凑模式播放栏：底栏导航紧凑模式下播放栏自动适配，带过渡动画
- APK 自动发布 Agent：服务器每日自动从 GitHub Release 下载最新 APK，保留 30 天滑动窗口，自动更新文档下载链接
- 服务器直链下载：文档下载链接改为
https://mucang.xyz/zephyrus/apks/zephyrus-player-latest.apk
🐛 修复
- 本地音乐播放卡死：
copyToCacheDir同步 JNI 调用阻塞 JS 线程，改用copyToCacheDirAsync异步回调 - 本地音乐无声音/无进度：
setupEQ对LocalAudioPlayer提前 return 导致未连接AudioContext.destination，新增_setupEQLocalMobile方法 - 嵌入歌词不读取：
getAudioMetadata硬编码 lyrics 为 NULL，实现extractEmbeddedLyrics多策略提取 - 设置页版本号显示 v1-alpha：
AboutTab.vue硬编码版本字符串，改为从package.json动态读取config.version - 紧凑底栏对齐问题：直接复制底栏导航的位置/高度参数到紧凑播放栏
- 页面标题冗余：有 Hero Card 的页面自动隐藏顶栏标题 pill
- AudioContext 挂起：移动端后台切回后 AudioContext 可能被暂停，播放前调用
resume()
🎨 优化
- README / AIREADME 全面重写：基于实际项目结构重写，补全所有组件、服务、工具的文档
- 版本号统一：
package.json/build.gradle/AboutTab/ 文档站全部同步至 v1.1.0 - SCAN_VERSION 递增至 4：强制重新扫描以应用新的歌词提取逻辑
- 本地音乐页布局优化：内容区域下移避免被 Hero Card 遮挡
v1.0.5
✨ 新增
- 深度链接（Deep Link）分享：支持
zephyrus://song/{id}协议，点击分享链接直接拉起 App 并展示歌曲卡片 - 中转页（relay）：新增分享中转页面
relay.html，暗色玻璃拟态设计，支持 30 秒试听分享音频，海报式布局展示封面/歌名/歌手 - 分享歌曲卡片（SharedSongCard）：App 内弹出毛玻璃歌曲卡片，展示封面、歌名、歌手信息，点击播放按钮直接播放，支持返回键关闭
- 剪贴板智能识别：App 从后台切回前台时自动检测剪贴板，识别到分享链接格式自动弹出歌曲卡片
- 冷启动重试机制：深度链接冷启动时通过多次延时重试 + URL 队列缓存，确保 JS 层就绪后正确处理链接
- 海报式分享设置：生成海报时可选左下角展示软件名或 Logo、调整透明度
🐛 修复
- 深度链接冷启动不弹卡片：JS 层未就绪时调用
__handleClipboardShare无响应，新增pendingUrl队列 + 多次postDelayed重试 - 歌曲卡片被底栏遮挡：
SharedSongCardz-index 不足且定位偏低，提升至100001并改为居中定位 - 分享卡片封面缺失：
picUrl未正确传入播放器，统一handleDeepLink与handleClipboardShare的歌曲对象构建逻辑 - 深度链接偶发自动播放：移除直接自动播放逻辑，统一通过
SharedSongCard交互后播放 - 构建产物路径不匹配：
vite build输出到dist/renderer而 Capacitor 期望out/renderer，改用electron-vite build
🎨 优化
- 中转页重构：采用暗色玻璃拟态 + 琥珀色点缀设计语言，移除自动播放，与卡片交互流程统一
- 版本号升级至 v1.0.5
v1.0.0-beta
✨ 新增
- 雨夜播放器样式：3D 封面 + Canvas 雨水效果 + 歌词叠加 + 底部反射，竖屏/横屏自适应布局
- 跨平台搜索（移动端）：移动端搜索结果接入跨平台搜索，自动搜索 QQ/咪咕/酷狗/酷我/JOOX，结果去重合并
- 来源标签 + 筛选（移动端）：搜索结果每首歌标注来源（网易云/JOOX/QQ等），支持按来源筛选
- 使用文档网站：VitePress 文档站上线 www.mucang.xyz/zephyrus/docs
- 用户协议：首次启动弹出用户协议窗口，支持 Markdown 渲染
- 欢迎页重写：移除原项目收款码/公众号，改为项目 GitHub 链接 + 软件图标
- 平台账号管理：移动端支持手动输入 Cookie，localStorage fallback
- 设置-关于新增文档入口：点击跳转到使用文档网站
- GitHub Actions 自动构建发布：推送 tag 自动构建 APK 并发布 Release
🐛 修复
- 雨夜样式移动端不显示：
MobilePlayerSettings硬编码数组缺少 rain +MusicFullWrapper缺少 rain 路由 +isFeatureEnabled默认 false - 平台登录报错：
window.api.openPlatformLogin在移动端不存在，添加 fallback 到手动输入 Cookie - 功能开关默认关闭：移除额外功能面板后所有 feature flag 默认 false，改为默认 true
🎨 优化
- README 重写：新增 7 种样式说明、跨平台搜索、文档链接、下载入口
- 版本号升级至 v1.0.0-beta
v0.9.9-update
✨ 新增
- 跨平台搜索：新增多平台音乐搜索能力，支持在搜索时跨网易云/QQ/酷狗/酷我等平台匹配音源
- 歌曲来源筛选：搜索结果页新增来源筛选栏，基于
sourceProbeService即时分类（零请求）+ 懒探测（策略链），动态展示每首歌曲的真实可用音源徽章 - 平台账号管理：用户页新增
PlatformAccounts组件，集中管理各音乐平台的登录状态与 Cookie - GdMusic API 扩展：增强自定义音乐 API 解析能力，支持更多第三方音源接入
- 跨平台搜索服务：主进程新增
multiPlatformSearch模块，渲染层新增crossPlatformSearchAPI
🐛 修复
- 诡谲/陈旧模式全屏失效：
EeriePlayer与NeonPlayer缺少全屏控制逻辑，新增isFullScreen状态与toggleFullScreen方法，监听fullscreenchange事件 - 诡谲/陈旧模式遮挡侧栏与搜索框：Overlay 模式下播放器层级过高，新增
overlay-modeclass，设置z-index: 1+pointer-events: none实现穿透 - 浮动覆盖模式底部进度条不显示：
showFullStyle在 overlay 模式下始终为true触发自动收起，overlay 模式下跳过自动收起逻辑 - 浮动覆盖模式搜索框无法点击：搜索框
z-index被标题栏（3000）遮挡，提升至 3002 - 设置面板缺少新样式选项：播放器样式选项硬编码，改为从
getAllStyles()动态生成，自动包含诡谲/陈旧样式 - 歌单弹窗滚动空白：浮动覆盖模式下歌单详情列表滚动出现空白，
MusicListPage改为 flex 布局 +n-scrollbar设为flex-1 min-h-0 - 构建版本报纸纹理消失：诡谲模式报纸滤镜在
npm run build:win后失效，改用import.meta.glob动态导入确保带哈希文件名正确解析 - LX 音源脚本初始化失败：脚本未调用
lx.send(EVENT_NAMES.inited)导致超时，Worker 新增异步初始化等待机制（10 秒窗口），超时错误附带脚本诊断信息 - SSL 证书验证失败：
npm run build:win时 electron-builder 下载资源失败，配置 npmmirror 镜像源并绕过 SSL 验证
🎨 优化
- UI 统一重构：搜索结果页、歌曲列表项、设置页、用户页、平台账号管理、高潮段落编辑器全面适配设计令牌（
--d-*），消除视觉割裂感 - 高潮段落编辑器：窗口改为圆角形态并加宽，播放头从红色圆点改回竖条，时间轴与段落区域改为居中圆角窗口
- 搜索栏自动收起：浮动覆盖模式下搜索栏支持完全移出屏幕，鼠标移入顶部触发区域唤回，与侧栏/标题栏行为一致
- 语义工具类扩充：
index.css新增.d-btn-primary等核心语义工具类
v0.9.9
新增
- VHS 录像效果：诡谲模式（Eerie）前奏阶段模拟老旧 VHS 录像带的雪花噪点、扫描线、信号干扰与色彩偏移，营造复古诡谲氛围
- 设计令牌系统：建立
--d-前缀的桌面端设计令牌（表面/边框/阴影/圆角/字体/动画/z-index/间距），Tailwind 配置对接，统一全应用视觉规范 - 字体兼容性文档：README 新增字体兼容性章节，记录诡谲模式与狂躁模式经实测配合较好的字体
修复
- 全屏按钮失效：改用 Electron 原生
win.setFullScreen()替代浏览器全屏 API，修复无边框窗口（frame: false）下全屏按钮失效的问题 - 设置面板白底白字：设置面板根元素强制暗色设计令牌，替换所有硬编码
rgba(255,255,255,...)颜色值，修复亮色系统主题下白底白字不可见的问题 - 贴底进度条交互冲突：扩大贴底进度条的命中区域（
.music-time高度 +n-sliderpadding），避免与窗口 resize 手势冲突 - 播放栏隐藏时进度条消失：播放栏自动隐藏时仅渐隐内容元素，进度条保持可见和可交互，并添加渐隐动画
- VHS 效果白色累积：修复过渡阶段切歌时诡谲模式前奏 VHS 效果白色不断累加直至占满屏幕的问题。改为动态获取底色（getter 函数），避免频繁重启动画；每帧用
clearRect+setTransform确保画布完全清除；停止动画时清除画布残留
优化
- UI 统一：圆角/阴影统一为设计令牌工具类（
rounded-d-*/shadow-d-*），页面背景统一为.page-bg/.page-card工具类 - 组件复用：Magazine 模式复用
PlayerControls组件（新增#extra插槽），移除重复控制代码 - TitleBar 合并：合并
TitleBar与OverlayTitleBar，自动收起行为整合到统一组件 - 主色统一：统一主色变量为单一
--accent-color，移除--dynamic-primary和--primary-color的直接使用
v1.1.0
Release v1.1.0
Zephyrus Player 更新日志
v1.1.0
✨ 新增
- 本地音乐完整支持：扫描本地音频文件（FLAC/MP3/OGG/WAV/M4A），自动解析元数据（封面、歌词、专辑信息），Hero Card UI 设计
- 嵌入式歌词提取：原生
MediaMetadataRetriever提取 ID3v2 USLT / FLAC LYRICS 标签，支持内嵌歌词读取 - 异步文件加载：
copyToCacheDirAsync异步复制文件到缓存目录，避免阻塞 JS 线程导致播放卡死 - GlowTabs 光晕滑块：全站统一使用
GlowTabs组件替代旧滑块，视觉一致性提升 - Hero Card 浮动卡片：可收起/展开的浮动 Hero Card 组件，用于本地音乐等页面
- 紧凑模式播放栏：底栏导航紧凑模式下播放栏自动适配，带过渡动画
- APK 自动发布 Agent：服务器每日自动从 GitHub Release 下载最新 APK，保留 30 天滑动窗口，自动更新文档下载链接
- 服务器直链下载：文档下载链接改为
https://mucang.xyz/zephyrus/apks/zephyrus-player-latest.apk
🐛 修复
- 本地音乐播放卡死：
copyToCacheDir同步 JNI 调用阻塞 JS 线程，改用copyToCacheDirAsync异步回调 - 本地音乐无声音/无进度：
setupEQ对LocalAudioPlayer提前 return 导致未连接AudioContext.destination，新增_setupEQLocalMobile方法 - 嵌入歌词不读取：
getAudioMetadata硬编码 lyrics 为 NULL，实现extractEmbeddedLyrics多策略提取 - 设置页版本号显示 v1-alpha：
AboutTab.vue硬编码版本字符串，改为从package.json动态读取config.version - 紧凑底栏对齐问题：直接复制底栏导航的位置/高度参数到紧凑播放栏
- 页面标题冗余：有 Hero Card 的页面自动隐藏顶栏标题 pill
- AudioContext 挂起：移动端后台切回后 AudioContext 可能被暂停，播放前调用
resume()
🎨 优化
- README / AIREADME 全面重写：基于实际项目结构重写，补全所有组件、服务、工具的文档
- 版本号统一：
package.json/build.gradle/AboutTab/ 文档站全部同步至 v1.1.0 - SCAN_VERSION 递增至 4：强制重新扫描以应用新的歌词提取逻辑
- 本地音乐页布局优化：内容区域下移避免被 Hero Card 遮挡
v1.0.5
✨ 新增
- 深度链接（Deep Link）分享：支持
zephyrus://song/{id}协议，点击分享链接直接拉起 App 并展示歌曲卡片 - 中转页（relay）：新增分享中转页面
relay.html，暗色玻璃拟态设计，支持 30 秒试听分享音频，海报式布局展示封面/歌名/歌手 - 分享歌曲卡片（SharedSongCard）：App 内弹出毛玻璃歌曲卡片，展示封面、歌名、歌手信息，点击播放按钮直接播放，支持返回键关闭
- 剪贴板智能识别：App 从后台切回前台时自动检测剪贴板，识别到分享链接格式自动弹出歌曲卡片
- 冷启动重试机制：深度链接冷启动时通过多次延时重试 + URL 队列缓存，确保 JS 层就绪后正确处理链接
- 海报式分享设置：生成海报时可选左下角展示软件名或 Logo、调整透明度
🐛 修复
- 深度链接冷启动不弹卡片：JS 层未就绪时调用
__handleClipboardShare无响应，新增pendingUrl队列 + 多次postDelayed重试 - 歌曲卡片被底栏遮挡：
SharedSongCardz-index 不足且定位偏低，提升至100001并改为居中定位 - 分享卡片封面缺失：
picUrl未正确传入播放器，统一handleDeepLink与handleClipboardShare的歌曲对象构建逻辑 - 深度链接偶发自动播放：移除直接自动播放逻辑，统一通过
SharedSongCard交互后播放 - 构建产物路径不匹配：
vite build输出到dist/renderer而 Capacitor 期望out/renderer，改用electron-vite build
🎨 优化
- 中转页重构：采用暗色玻璃拟态 + 琥珀色点缀设计语言，移除自动播放，与卡片交互流程统一
- 版本号升级至 v1.0.5
v1.0.0-beta
✨ 新增
- 雨夜播放器样式：3D 封面 + Canvas 雨水效果 + 歌词叠加 + 底部反射，竖屏/横屏自适应布局
- 跨平台搜索（移动端）：移动端搜索结果接入跨平台搜索，自动搜索 QQ/咪咕/酷狗/酷我/JOOX，结果去重合并
- 来源标签 + 筛选（移动端）：搜索结果每首歌标注来源（网易云/JOOX/QQ等），支持按来源筛选
- 使用文档网站：VitePress 文档站上线 www.mucang.xyz/zephyrus/docs
- 用户协议：首次启动弹出用户协议窗口，支持 Markdown 渲染
- 欢迎页重写：移除原项目收款码/公众号，改为项目 GitHub 链接 + 软件图标
- 平台账号管理：移动端支持手动输入 Cookie，localStorage fallback
- 设置-关于新增文档入口：点击跳转到使用文档网站
- GitHub Actions 自动构建发布：推送 tag 自动构建 APK 并发布 Release
🐛 修复
- 雨夜样式移动端不显示：
MobilePlayerSettings硬编码数组缺少 rain +MusicFullWrapper缺少 rain 路由 +isFeatureEnabled默认 false - 平台登录报错：
window.api.openPlatformLogin在移动端不存在，添加 fallback 到手动输入 Cookie - 功能开关默认关闭：移除额外功能面板后所有 feature flag 默认 false，改为默认 true
🎨 优化
- README 重写：新增 7 种样式说明、跨平台搜索、文档链接、下载入口
- 版本号升级至 v1.0.0-beta
v0.9.9-update
✨ 新增
- 跨平台搜索：新增多平台音乐搜索能力，支持在搜索时跨网易云/QQ/酷狗/酷我等平台匹配音源
- 歌曲来源筛选：搜索结果页新增来源筛选栏，基于
sourceProbeService即时分类（零请求）+ 懒探测（策略链），动态展示每首歌曲的真实可用音源徽章 - 平台账号管理：用户页新增
PlatformAccounts组件，集中管理各音乐平台的登录状态与 Cookie - GdMusic API 扩展：增强自定义音乐 API 解析能力，支持更多第三方音源接入
- 跨平台搜索服务：主进程新增
multiPlatformSearch模块，渲染层新增crossPlatformSearchAPI
🐛 修复
- 诡谲/陈旧模式全屏失效：
EeriePlayer与NeonPlayer缺少全屏控制逻辑，新增isFullScreen状态与toggleFullScreen方法，监听fullscreenchange事件 - 诡谲/陈旧模式遮挡侧栏与搜索框：Overlay 模式下播放器层级过高，新增
overlay-modeclass，设置z-index: 1+pointer-events: none实现穿透 - 浮动覆盖模式底部进度条不显示：
showFullStyle在 overlay 模式下始终为true触发自动收起，overlay 模式下跳过自动收起逻辑 - 浮动覆盖模式搜索框无法点击：搜索框
z-index被标题栏（3000）遮挡，提升至 3002 - 设置面板缺少新样式选项：播放器样式选项硬编码，改为从
getAllStyles()动态生成，自动包含诡谲/陈旧样式 - 歌单弹窗滚动空白：浮动覆盖模式下歌单详情列表滚动出现空白，
MusicListPage改为 flex 布局 +n-scrollbar设为flex-1 min-h-0 - 构建版本报纸纹理消失：诡谲模式报纸滤镜在
npm run build:win后失效，改用import.meta.glob动态导入确保带哈希文件名正确解析 - LX 音源脚本初始化失败：脚本未调用
lx.send(EVENT_NAMES.inited)导致超时，Worker 新增异步初始化等待机制（10 秒窗口），超时错误附带脚本诊断信息 - SSL 证书验证失败：
npm run build:win时 electron-builder 下载资源失败，配置 npmmirror 镜像源并绕过 SSL 验证
🎨 优化
- UI 统一重构：搜索结果页、歌曲列表项、设置页、用户页、平台账号管理、高潮段落编辑器全面适配设计令牌（
--d-*），消除视觉割裂感 - 高潮段落编辑器：窗口改为圆角形态并加宽，播放头从红色圆点改回竖条，时间轴与段落区域改为居中圆角窗口
- 搜索栏自动收起：浮动覆盖模式下搜索栏支持完全移出屏幕，鼠标移入顶部触发区域唤回，与侧栏/标题栏行为一致
- 语义工具类扩充：
index.css新增.d-btn-primary等核心语义工具类
v0.9.9
新增
- VHS 录像效果：诡谲模式（Eerie）前奏阶段模拟老旧 VHS 录像带的雪花噪点、扫描线、信号干扰与色彩偏移，营造复古诡谲氛围
- 设计令牌系统：建立
--d-前缀的桌面端设计令牌（表面/边框/阴影/圆角/字体/动画/z-index/间距），Tailwind 配置对接，统一全应用视觉规范 - 字体兼容性文档：README 新增字体兼容性章节，记录诡谲模式与狂躁模式经实测配合较好的字体
修复
- 全屏按钮失效：改用 Electron 原生
win.setFullScreen()替代浏览器全屏 API，修复无边框窗口（frame: false）下全屏按钮失效的问题 - 设置面板白底白字：设置面板根元素强制暗色设计令牌，替换所有硬编码
rgba(255,255,255,...)颜色值，修复亮色系统主题下白底白字不可见的问题 - 贴底进度条交互冲突：扩大贴底进度条的命中区域（
.music-time高度 +n-sliderpadding），避免与窗口 resize 手势冲突 - 播放栏隐藏时进度条消失：播放栏自动隐藏时仅渐隐内容元素，进度条保持可见和可交互，并添加渐隐动画
- VHS 效果白色累积：修复过渡阶段切歌时诡谲模式前奏 VHS 效果白色不断累加直至占满屏幕的问题。改为动态获取底色（getter 函数），避免频繁重启动画；每帧用
clearRect+setTransform确保画布完全清除；停止动画时清除画布残留
优化
- UI 统一：圆角/阴影统一为设计令牌工具类（
rounded-d-*/shadow-d-*），页面背景统一为.page-bg/.page-card工具类 - 组件复用：Magazine 模式复用
PlayerControls组件（新增#extra插槽），移除重复控制代码 - TitleBar 合并：合并
TitleBar与OverlayTitleBar，自动收起行为整合到统一组件 - 主色统一：统一主色变量为单一
--accent-color，移除--dynamic-primary和--primary-color的直接使用
v1.0.5
Release v1.0.5
Zephyrus Player 更新日志
v1.0.5
✨ 新增
- 深度链接（Deep Link）分享：支持
zephyrus://song/{id}协议，点击分享链接直接拉起 App 并展示歌曲卡片 - 中转页（relay）：新增分享中转页面
relay.html，暗色玻璃拟态设计，支持 30 秒试听分享音频，海报式布局展示封面/歌名/歌手 - 分享歌曲卡片（SharedSongCard）：App 内弹出毛玻璃歌曲卡片，展示封面、歌名、歌手信息，点击播放按钮直接播放，支持返回键关闭
- 剪贴板智能识别：App 从后台切回前台时自动检测剪贴板，识别到分享链接格式自动弹出歌曲卡片
- 冷启动重试机制：深度链接冷启动时通过多次延时重试 + URL 队列缓存，确保 JS 层就绪后正确处理链接
- 海报式分享设置：生成海报时可选左下角展示软件名或 Logo、调整透明度
🐛 修复
- 深度链接冷启动不弹卡片：JS 层未就绪时调用
__handleClipboardShare无响应，新增pendingUrl队列 + 多次postDelayed重试 - 歌曲卡片被底栏遮挡：
SharedSongCardz-index 不足且定位偏低，提升至100001并改为居中定位 - 分享卡片封面缺失：
picUrl未正确传入播放器，统一handleDeepLink与handleClipboardShare的歌曲对象构建逻辑 - 深度链接偶发自动播放：移除直接自动播放逻辑，统一通过
SharedSongCard交互后播放 - 构建产物路径不匹配：
vite build输出到dist/renderer而 Capacitor 期望out/renderer，改用electron-vite build
🎨 优化
- 中转页重构：采用暗色玻璃拟态 + 琥珀色点缀设计语言，移除自动播放，与卡片交互流程统一
- 版本号升级至 v1.0.5
v1.0.0-beta
✨ 新增
- 雨夜播放器样式：3D 封面 + Canvas 雨水效果 + 歌词叠加 + 底部反射，竖屏/横屏自适应布局
- 跨平台搜索（移动端）：移动端搜索结果接入跨平台搜索，自动搜索 QQ/咪咕/酷狗/酷我/JOOX，结果去重合并
- 来源标签 + 筛选（移动端）：搜索结果每首歌标注来源（网易云/JOOX/QQ等），支持按来源筛选
- 使用文档网站：VitePress 文档站上线 www.mucang.xyz/zephyrus/docs
- 用户协议：首次启动弹出用户协议窗口，支持 Markdown 渲染
- 欢迎页重写：移除原项目收款码/公众号，改为项目 GitHub 链接 + 软件图标
- 平台账号管理：移动端支持手动输入 Cookie，localStorage fallback
- 设置-关于新增文档入口：点击跳转到使用文档网站
- GitHub Actions 自动构建发布：推送 tag 自动构建 APK 并发布 Release
🐛 修复
- 雨夜样式移动端不显示：
MobilePlayerSettings硬编码数组缺少 rain +MusicFullWrapper缺少 rain 路由 +isFeatureEnabled默认 false - 平台登录报错：
window.api.openPlatformLogin在移动端不存在，添加 fallback 到手动输入 Cookie - 功能开关默认关闭：移除额外功能面板后所有 feature flag 默认 false，改为默认 true
🎨 优化
- README 重写：新增 7 种样式说明、跨平台搜索、文档链接、下载入口
- 版本号升级至 v1.0.0-beta
v0.9.9-update
✨ 新增
- 跨平台搜索：新增多平台音乐搜索能力，支持在搜索时跨网易云/QQ/酷狗/酷我等平台匹配音源
- 歌曲来源筛选：搜索结果页新增来源筛选栏，基于
sourceProbeService即时分类（零请求）+ 懒探测（策略链），动态展示每首歌曲的真实可用音源徽章 - 平台账号管理：用户页新增
PlatformAccounts组件，集中管理各音乐平台的登录状态与 Cookie - GdMusic API 扩展：增强自定义音乐 API 解析能力，支持更多第三方音源接入
- 跨平台搜索服务：主进程新增
multiPlatformSearch模块，渲染层新增crossPlatformSearchAPI
🐛 修复
- 诡谲/陈旧模式全屏失效：
EeriePlayer与NeonPlayer缺少全屏控制逻辑，新增isFullScreen状态与toggleFullScreen方法，监听fullscreenchange事件 - 诡谲/陈旧模式遮挡侧栏与搜索框：Overlay 模式下播放器层级过高，新增
overlay-modeclass，设置z-index: 1+pointer-events: none实现穿透 - 浮动覆盖模式底部进度条不显示：
showFullStyle在 overlay 模式下始终为true触发自动收起，overlay 模式下跳过自动收起逻辑 - 浮动覆盖模式搜索框无法点击：搜索框
z-index被标题栏（3000）遮挡，提升至 3002 - 设置面板缺少新样式选项：播放器样式选项硬编码，改为从
getAllStyles()动态生成，自动包含诡谲/陈旧样式 - 歌单弹窗滚动空白：浮动覆盖模式下歌单详情列表滚动出现空白，
MusicListPage改为 flex 布局 +n-scrollbar设为flex-1 min-h-0 - 构建版本报纸纹理消失：诡谲模式报纸滤镜在
npm run build:win后失效，改用import.meta.glob动态导入确保带哈希文件名正确解析 - LX 音源脚本初始化失败：脚本未调用
lx.send(EVENT_NAMES.inited)导致超时，Worker 新增异步初始化等待机制（10 秒窗口），超时错误附带脚本诊断信息 - SSL 证书验证失败：
npm run build:win时 electron-builder 下载资源失败，配置 npmmirror 镜像源并绕过 SSL 验证
🎨 优化
- UI 统一重构：搜索结果页、歌曲列表项、设置页、用户页、平台账号管理、高潮段落编辑器全面适配设计令牌（
--d-*），消除视觉割裂感 - 高潮段落编辑器：窗口改为圆角形态并加宽，播放头从红色圆点改回竖条，时间轴与段落区域改为居中圆角窗口
- 搜索栏自动收起：浮动覆盖模式下搜索栏支持完全移出屏幕，鼠标移入顶部触发区域唤回，与侧栏/标题栏行为一致
- 语义工具类扩充：
index.css新增.d-btn-primary等核心语义工具类
v0.9.9
新增
- VHS 录像效果：诡谲模式（Eerie）前奏阶段模拟老旧 VHS 录像带的雪花噪点、扫描线、信号干扰与色彩偏移，营造复古诡谲氛围
- 设计令牌系统：建立
--d-前缀的桌面端设计令牌（表面/边框/阴影/圆角/字体/动画/z-index/间距），Tailwind 配置对接，统一全应用视觉规范 - 字体兼容性文档：README 新增字体兼容性章节，记录诡谲模式与狂躁模式经实测配合较好的字体
修复
- 全屏按钮失效：改用 Electron 原生
win.setFullScreen()替代浏览器全屏 API，修复无边框窗口（frame: false）下全屏按钮失效的问题 - 设置面板白底白字：设置面板根元素强制暗色设计令牌，替换所有硬编码
rgba(255,255,255,...)颜色值，修复亮色系统主题下白底白字不可见的问题 - 贴底进度条交互冲突：扩大贴底进度条的命中区域（
.music-time高度 +n-sliderpadding），避免与窗口 resize 手势冲突 - 播放栏隐藏时进度条消失：播放栏自动隐藏时仅渐隐内容元素，进度条保持可见和可交互，并添加渐隐动画
- VHS 效果白色累积：修复过渡阶段切歌时诡谲模式前奏 VHS 效果白色不断累加直至占满屏幕的问题。改为动态获取底色（getter 函数），避免频繁重启动画；每帧用
clearRect+setTransform确保画布完全清除；停止动画时清除画布残留
优化
- UI 统一：圆角/阴影统一为设计令牌工具类（
rounded-d-*/shadow-d-*），页面背景统一为.page-bg/.page-card工具类 - 组件复用：Magazine 模式复用
PlayerControls组件（新增#extra插槽），移除重复控制代码 - TitleBar 合并：合并
TitleBar与OverlayTitleBar，自动收起行为整合到统一组件 - 主色统一：统一主色变量为单一
--accent-color，移除--dynamic-primary和--primary-color的直接使用
v1.0.0-beta
Release v1.0.0-beta
Zephyrus Player 更新日志
v1.0.0-beta
✨ 新增
- 雨夜播放器样式：3D 封面 + Canvas 雨水效果 + 歌词叠加 + 底部反射，竖屏/横屏自适应布局
- 跨平台搜索（移动端）：移动端搜索结果接入跨平台搜索，自动搜索 QQ/咪咕/酷狗/酷我/JOOX，结果去重合并
- 来源标签 + 筛选（移动端）：搜索结果每首歌标注来源（网易云/JOOX/QQ等），支持按来源筛选
- 使用文档网站：VitePress 文档站上线 www.mucang.xyz/zephyrus/docs
- 用户协议：首次启动弹出用户协议窗口，支持 Markdown 渲染
- 欢迎页重写：移除原项目收款码/公众号，改为项目 GitHub 链接 + 软件图标
- 平台账号管理：移动端支持手动输入 Cookie，localStorage fallback
- 设置-关于新增文档入口：点击跳转到使用文档网站
- GitHub Actions 自动构建发布：推送 tag 自动构建 APK 并发布 Release
🐛 修复
- 雨夜样式移动端不显示：
MobilePlayerSettings硬编码数组缺少 rain +MusicFullWrapper缺少 rain 路由 +isFeatureEnabled默认 false - 平台登录报错：
window.api.openPlatformLogin在移动端不存在，添加 fallback 到手动输入 Cookie - 功能开关默认关闭：移除额外功能面板后所有 feature flag 默认 false，改为默认 true
🎨 优化
- README 重写：新增 7 种样式说明、跨平台搜索、文档链接、下载入口
- 版本号升级至 v1.0.0-beta
v0.9.9-update
✨ 新增
- 跨平台搜索：新增多平台音乐搜索能力，支持在搜索时跨网易云/QQ/酷狗/酷我等平台匹配音源
- 歌曲来源筛选：搜索结果页新增来源筛选栏，基于
sourceProbeService即时分类（零请求）+ 懒探测（策略链），动态展示每首歌曲的真实可用音源徽章 - 平台账号管理：用户页新增
PlatformAccounts组件，集中管理各音乐平台的登录状态与 Cookie - GdMusic API 扩展：增强自定义音乐 API 解析能力，支持更多第三方音源接入
- 跨平台搜索服务：主进程新增
multiPlatformSearch模块，渲染层新增crossPlatformSearchAPI
🐛 修复
- 诡谲/陈旧模式全屏失效：
EeriePlayer与NeonPlayer缺少全屏控制逻辑，新增isFullScreen状态与toggleFullScreen方法，监听fullscreenchange事件 - 诡谲/陈旧模式遮挡侧栏与搜索框：Overlay 模式下播放器层级过高，新增
overlay-modeclass，设置z-index: 1+pointer-events: none实现穿透 - 浮动覆盖模式底部进度条不显示：
showFullStyle在 overlay 模式下始终为true触发自动收起，overlay 模式下跳过自动收起逻辑 - 浮动覆盖模式搜索框无法点击：搜索框
z-index被标题栏（3000）遮挡，提升至 3002 - 设置面板缺少新样式选项：播放器样式选项硬编码，改为从
getAllStyles()动态生成，自动包含诡谲/陈旧样式 - 歌单弹窗滚动空白：浮动覆盖模式下歌单详情列表滚动出现空白，
MusicListPage改为 flex 布局 +n-scrollbar设为flex-1 min-h-0 - 构建版本报纸纹理消失：诡谲模式报纸滤镜在
npm run build:win后失效，改用import.meta.glob动态导入确保带哈希文件名正确解析 - LX 音源脚本初始化失败：脚本未调用
lx.send(EVENT_NAMES.inited)导致超时，Worker 新增异步初始化等待机制（10 秒窗口），超时错误附带脚本诊断信息 - SSL 证书验证失败：
npm run build:win时 electron-builder 下载资源失败，配置 npmmirror 镜像源并绕过 SSL 验证
🎨 优化
- UI 统一重构：搜索结果页、歌曲列表项、设置页、用户页、平台账号管理、高潮段落编辑器全面适配设计令牌（
--d-*），消除视觉割裂感 - 高潮段落编辑器：窗口改为圆角形态并加宽，播放头从红色圆点改回竖条，时间轴与段落区域改为居中圆角窗口
- 搜索栏自动收起：浮动覆盖模式下搜索栏支持完全移出屏幕，鼠标移入顶部触发区域唤回，与侧栏/标题栏行为一致
- 语义工具类扩充：
index.css新增.d-btn-primary等核心语义工具类
v0.9.9
新增
- VHS 录像效果：诡谲模式（Eerie）前奏阶段模拟老旧 VHS 录像带的雪花噪点、扫描线、信号干扰与色彩偏移，营造复古诡谲氛围
- 设计令牌系统：建立
--d-前缀的桌面端设计令牌（表面/边框/阴影/圆角/字体/动画/z-index/间距），Tailwind 配置对接，统一全应用视觉规范 - 字体兼容性文档：README 新增字体兼容性章节，记录诡谲模式与狂躁模式经实测配合较好的字体
修复
- 全屏按钮失效：改用 Electron 原生
win.setFullScreen()替代浏览器全屏 API，修复无边框窗口（frame: false）下全屏按钮失效的问题 - 设置面板白底白字：设置面板根元素强制暗色设计令牌，替换所有硬编码
rgba(255,255,255,...)颜色值，修复亮色系统主题下白底白字不可见的问题 - 贴底进度条交互冲突：扩大贴底进度条的命中区域（
.music-time高度 +n-sliderpadding），避免与窗口 resize 手势冲突 - 播放栏隐藏时进度条消失：播放栏自动隐藏时仅渐隐内容元素，进度条保持可见和可交互，并添加渐隐动画
- VHS 效果白色累积：修复过渡阶段切歌时诡谲模式前奏 VHS 效果白色不断累加直至占满屏幕的问题。改为动态获取底色（getter 函数），避免频繁重启动画；每帧用
clearRect+setTransform确保画布完全清除；停止动画时清除画布残留
优化
- UI 统一：圆角/阴影统一为设计令牌工具类（
rounded-d-*/shadow-d-*），页面背景统一为.page-bg/.page-card工具类 - 组件复用：Magazine 模式复用
PlayerControls组件（新增#extra插槽），移除重复控制代码 - TitleBar 合并：合并
TitleBar与OverlayTitleBar，自动收起行为整合到统一组件 - 主色统一：统一主色变量为单一
--accent-color，移除--dynamic-primary和--primary-color的直接使用