{ "name": "ZhMusic 更新源", "identifier": "com.github.zz8392570-ops.Zhmusic-releases.sidestore", "subtitle": "ZhMusic 自动构建", "description": "按需构建的 ZhMusic 安装包与 SideStore 更新源。", "iconURL": "https://zhmusic-download.pages.dev/icon.png", "website": "https://zhmusic-download.pages.dev", "apps": [ { "name": "ZhMusic", "bundleIdentifier": "com.music.player.gyc", "developerName": "zz8392570-ops", "localizedDescription": "支持自定义音源、歌词和本地音乐的播放器。", "iconURL": "https://zhmusic-download.pages.dev/icon.png", "versions": [ { "version": "2.0.1003", "buildVersion": "1003.1", "date": "2026-10-29T13:41:43.604553+00:00", "downloadURL": "https://zhmusic-download.pages.dev/releases/build-20261029132337-37da6cbd3cbc/ZhMusic-unsigned.ipa", "size": 20467526, "minOSVersion": "16.4", "localizedDescription": "# ZhMusic 2.0.0 功能介绍与更新记录\n\n更新日期：2026-10-29\n\n## 完整功能介绍\n\n- 榜单发现｜在“榜单”切换 QQ、网易云、酷狗、酷我、咪咕，浏览不同榜单、查看排名并播放；点击榜单卡片心形收藏，收藏的榜单自动排在对应平台前面。\n- 在线歌单｜在“歌单”按平台、分类浏览推荐歌单，进入歌单查看歌曲、播放或保存；内容及可播放性取决于第三方平台和音源。\n- 跨平台搜索｜在“搜索”查找歌曲，选择全部或单个平台；各平台结果陆续展示，同一录音可合并显示多个来源，并可按无损、已缓存、多音源筛选。歌手与在线歌单搜索目前由 QQ 提供。\n- 个人曲库搜索｜搜索时优先展示“我的音乐”；可搜索收藏、个人歌单、本地音乐、歌手、专辑和标签，查看歌曲所属的集合，“查看全部”打开完整个人搜索结果。\n- 正在播放｜点击底部迷你播放器展开播放页，控制播放、暂停、上一首、下一首、进度及系统音量；可查看封面、音质和平台，收藏歌曲、搜索同名歌曲或打开歌曲菜单。\n- 播放队列与稍后播放｜在播放列表管理当前队列和待播歌曲，支持添加、移除、清空、随机及顺序等播放模式；可拖动手柄或上下移动调整顺序，待播列表可保存为歌单。\n- 后台与系统控制｜支持后台播放、锁屏、控制中心和耳机播放控制；启动时可恢复上次歌曲、队列和进度，是否恢复可在设置中选择。\n- 定时关闭｜在播放页歌曲菜单选择定时关闭，支持预设分钟数、自定义时长及播完本曲后停止，也可取消已有计时。\n- 歌词与歌词工具｜在播放页查看逐行滚动歌词、原文或双语，调整字体、拖动定位和歌词时间；可按歌曲版本保存偏移及管理个人歌词，歌词页可保持屏幕常亮。翻译依音源提供。\n- 音效与响度｜在“设置 → 播放 → 音效”调整五段均衡器、音量平衡及人声、低音等预设；“个人听歌工具 → 全库响度整理”可分析本地音频并管理补偿。处理能力受系统、格式和播放方式影响。\n- 歌曲收藏与平台版本｜在歌曲旁点击心形收藏；相近的跨平台同一录音可关联到一行并保留各平台记录，支持选择平台、设置默认版本、移除错误版本或拆分收藏。\n- 重复收藏整理｜在“喜欢的歌曲 → 管理”预览疑似重复收藏，确认后合并，保留不同平台记录；可以排除不应合并的歌曲，或撤销上次整理。\n- 个人歌单管理｜在“我的”创建歌单、选择封面，支持重命名、文件夹、置顶、排序、批量添加、移除、移动歌曲及整理重复项；可通过分享链接或文件导入、导出歌单。\n- 在线歌单刷新与修复｜设置中的在线歌单刷新支持手动及每日／每周自动检查；曲库修复可扫描失效记录并预览匹配结果，确认后处理，保留本地整理。\n- 回收站与歌单历史｜在设置的高级功能中查看回收站及歌单历史快照，恢复最近删除或修改的歌曲、歌单记录。回收站保留最近 30 天、最多 100 次操作，不恢复已删除的音频文件。\n- 本地与离线音乐｜在“我的 → 本地音乐／本地与离线”导入手机上的音频文件，筛选导入、离线保存和自动缓存内容，按最近、歌名或歌手排序，并管理本地文件。\n- 下载、续传与重新下载｜歌曲菜单或歌单中选择 128K、320K、FLAC 保存离线；下载任务支持排队、暂停、继续、取消、重试和重启恢复，显示进度、速度及剩余时间。播放页“重新下载”可绕过缓存重新获取文件。\n- 下载与缓存管理｜在“设置 → 管理下载与缓存”查看空间、进行中和失败任务；已完成及已取消记录默认折叠。下方搜索和筛选只作用于本地文件，支持多选删除；改变条件会清空勾选。\n- 自动缓存与下载偏好｜可设置播放时自动缓存、仅 Wi-Fi 下载／缓存、256 MB 至 8 GB 的自动缓存上限，以及是否保留不同平台的下载版本；自动清理优先处理较早缓存，保留主动离线保存等受保护文件。\n- 下载文件命名｜在“设置 → 下载歌曲命名”设置歌名、歌手、专辑、音质、平台和编号组合；新文件按规则命名，重名自动区分，已有文件不自动重命名。\n- 纯离线播放与播放预缓冲｜纯离线模式只使用本地音频和已保存歌词，暂停下载并阻止在线封面补查；搜索和备份仍遵循各自联网规则。个人工具中的播放预缓冲仅在 Wi-Fi 下尝试预读，不等于离线保存。\n- 歌曲资料与标签｜歌曲菜单的“歌曲资料与离线详情”可查看本地文件状态、音质、大小和路径，编辑显示用歌名、歌手、专辑；标签工具支持逐首或批量打标、重命名标签及组合筛选。\n- 动态歌单与智能歌单｜将标签、歌手、专辑等筛选条件保存为动态歌单；按听歌记录查看每日混合、最近常听、最多播放、未听或久未听等集合，内容随本地记录变化。\n- 歌手与专辑库｜在“我的”或个人听歌工具中按歌手和专辑浏览个人曲库，搜索、排序并进入对应歌曲集合；可在歌曲菜单打开个人歌手或专辑页面。\n- 听歌场景与首页整理｜在“个人听歌工具 → 听歌场景”配置通勤、睡前等场景的歌单、播放顺序、离线要求和定时；“我的 → 编辑首页”可隐藏、排列模块、管理快捷场景和收起长列表。\n- 出门准备｜在个人听歌工具中选择歌曲集合、目标和音质，检查音频、歌词、封面的离线准备情况，补齐缺项并复查；可维护集合的离线保存，实际下载需要可用音源和合适网络。\n- 听歌记录、报告与智能随机｜查看最近播放、本地听歌统计以及最近 7 天与前 7 天的报告；支持统计开关和后台统计偏好。智能随机会降低近期歌曲靠前出现的机会；报告不会凭空补齐旧版历史。\n- 不喜欢规则｜在歌曲菜单中屏蔽歌曲或歌手，设置中可管理和移除规则；自动选曲会跳过匹配内容，手动点歌仍可播放。\n- 桌面组件与快捷指令｜长按桌面添加 ZhMusic 小组件，可继续收听或打开快捷歌单；个人听歌工具中选择组件集合，也支持 Siri／快捷指令打开集合或场景，首次使用请先打开应用一次。\n- 自定义音源管理｜从本地文件、URL 或系统分享导入脚本，支持多文件批量导入、切换、更新与可用性检测。可用性测试和播放失败后的自动换源不保证每首歌都可用；优先使用自己信任的音源。\n- 兼容 LX 的歌单同步｜在“设置 → 同步管理”连接兼容 LX 的同步服务，选择同步方式，管理配对，支持自动同步与仅 Wi-Fi 同步；同步范围为个人歌单资料，不传输音频文件。\n- 备份与恢复｜导出 JSON 或通过 HTTPS WebDAV 保存最新备份及每日快照。包含歌曲收藏、歌单、最近播放、个人设置、榜单收藏、音源脚本与当前音源；恢复前预览，支持合并、覆盖和撤销上次导入。\n- 备份范围与历史｜恢复榜单收藏和音源时需勾选恢复个人设置；旧备份缺少的新字段不会清空本机已有数据。备份不包含音频和封面图片、同步配对密钥及 WebDAV 密码；音源脚本可能含密钥，备份文件应妥善保管。历史快照可保留 30 天、90 天或永久。\n- 外观、语言与启动偏好｜设置中选择深色、浅色或跟随系统，切换中文／英文、启动页面、默认榜单、播放音质、精确跳转和恢复播放等偏好。\n- 诊断、更新与安装｜设置中查看播放故障记录、当前播放诊断和应用日志，可搜索、复制或分享；也可查看版本更新记录和下载 IPA。通过发布仓库的 SideStore 源更新，IPA 仍需自行签名安装。\n- 使用边界｜歌曲、封面和歌词依第三方平台与音源可用性；下载完成表示传输完成，不保证系统支持该音频的解码。遇到损坏缓存可尝试重新下载、其他音质或其他来源；备份与更新均不自动修复已有音频。\n\n## 新增功能\n\n- WebDAV 备份区域新增自动备份开关；关闭会取消自动请求和待重试任务、收起顶部失败提醒，保留手动备份和恢复，开关状态保存在本机。\n- 新增完整功能介绍，按用途说明主要入口、下载与缓存差异、备份范围和使用边界。\n- 新增按平台收藏榜单并自动置顶，收藏可随个人设置备份恢复。\n- 备份支持完整音源脚本及当前音源；恢复确认后重新加载，失败时给出提示，并兼容旧备份。\n- 播放页新增“重新下载”及音质选择：重新获取音源，跳过缓存，传输成功后替换对应文件，失败保留旧文件。\n- 歌单和收藏修改后合并触发自动同步，断网后等待网络恢复\n- 新增歌单回收站，可恢复最近 30 天移除的歌单和歌曲记录\n- 新增在线歌单每日或每周自动刷新，保留本地排序、添加与移除记录\n- 新增最近 7 天与前 7 天的听歌报告，展示时长、播放次数、常听歌曲与歌手\n- 手动下载支持仅 Wi-Fi、下载速度、文件大小、预计剩余时间、全部暂停和失败任务批量重试\n- 下载前选择标准 128K、高品质 320K 或无损 FLAC；单曲与整歌单下载均可选音质，可用性取决于音源\n- 下载任务支持排队、暂停、继续、取消、重试及重启后恢复；支持续传的音源可接着下载\n- WebDAV 自动备份按手机本地日期每天成功一次，当天内容变化不重复上传；失败可重试，手动备份不受每日次数限制\n- WebDAV 历史备份可选择保留 30 天、90 天或永久；保存配置后，仅清理超过期限的应用每日备份\n- 缓存管理增加歌曲与歌手搜索、自动缓存和手动下载筛选、全选及批量删除\n\n## 体验优化\n\n- 离线封面下载边接收边限制大小，中途取消不保存不完整图片；空间统计减少重复读取。\n- 优化大收藏列表的缓存状态查询：复用收藏索引，收藏变更时及时更新，减少重复读取和解析。\n- WebDAV 备份及历史列表改为边接收边检查大小，超出上限时停止读取，保留取消和超时支持。\n- 云端打包增加独立临时仓库清理检查；失败日志尝试保存到私有源码仓库的草稿发布记录，保存失败时提示。\n- 应用图标更换为黑底红色 Z 节拍标识，同步桌面图标、设置页、启动页、SideStore 图标和项目说明。\n- 重新设计“喜欢的歌曲”页面：小尺寸渐变爱心封面搭配横向标题，离线数量、补齐和筛选分层展示，精简播放操作区，让首屏显示更多歌曲。\n- 统一通用操作菜单、日志详情、分享导入与多个管理页面的按钮、圆角、输入框和留白；优化窄屏操作排列，移除与导航栏重复的标题。\n- 下载任务与本地文件分区展示，完成历史可折叠；搜索筛选与结果紧邻，批量删除时防止误删隐藏项。\n- 统一设置、个人工具、音源、备份、同步及歌单导入页面的按钮、卡片和布局。\n- 歌曲列表可复用同一录音其他来源的封面；缺图的网易云歌曲按原始 ID 补查，查询限制并发并遵守离线模式。\n- 榜单、歌单、搜索和我的页面统一布局，设置入口集中在我的页面\n- 歌曲详情和缓存管理采用按需渲染列表，改善大量歌曲时的滚动表现\n- 跨平台搜索先展示已返回的结果，再去重补充；缓存状态查询共享并限制并发\n- 音源解析显示进度阶段，支持取消等待、切换音源和音质回退；单首回退不改变首选音质\n- 新下载与自动缓存均按命名规则保存，重名文件自动区分，不同音质可分别保留\n- 自动缓存按容量清理较早内容，保留主动离线保存和正在播放等受保护文件\n- 优化歌词多行高度、拖动定位、封面配色和播放状态同步\n- 备份页面展示最近成功时间和失败原因；远程下载与历史列表支持取消和超时提示\n\n## 问题修复\n\n- 本地音频不再沿用在线音源的 HTTP／ICY 请求设置；本地文件按原生就绪状态启动，避免已有可播放状态却被 20 秒超时误停；故障记录保留 iOS 错误域、错误码与底层错误链。\n- 修复原生播放器拒绝缓存后仍反复选中同一文件的问题；保留原文件并按大小及修改时间记录状态，允许联网时尝试其他缓存或重新获取音源，重新下载成功后解除标记。\n- WebDAV 自动备份失败后按 1 至 15 分钟逐步延长重试间隔，避免切歌更新记录或频繁返回前台时连续请求；手动重试不受限制。\n- 修复设置中检查更新仍访问旧私有仓库的问题；现在读取公开更新源，并按已安装构建号判断是否有新版本。\n- 远程歌曲的离线文件确实缺失时，在线播放会按原始歌曲身份尝试音源；纯离线与本地导入歌曲保留原有处理。\n- 修复网络恢复后 WebDAV 自动备份可能不再重试，以及在线歌单切后台返回时刷新请求被遗漏的问题。\n- 补齐锁屏封面对酷狗 320K、FLAC 音质标识和专辑信息的处理。\n- 修复批量下载后较早的失败任务被历史记录上限挤掉的问题；失败任务可继续重试或单独取消。\n- 补齐 QQ、酷狗、咪咕的歌曲封面详情查询；收藏列表中的缺图和失效旧图片路径会按歌曲原始平台身份重试，支持下拉重新补查，离线模式不发起网络请求。\n- 修正音源超时误报取消的路径，区分取消事件与故障；故障列表兼容已有取消记录。\n- 拒绝把下载接口返回的网页、JSON 错误内容和空文件作为成功音频保存。\n- 修复内置默认封面被误认为已保存图片而阻止补查的问题。\n- 修复版本更新记录弹窗显示英文路由名，统一弹窗标题与返回按钮显示\n- 修复部分页面顶部留白过大、文字被截断、榜单封面不显示以及本地离线列表出现空隙的问题\n- 修复连续切歌时旧请求覆盖当前歌曲，以及播放失败后无法正确换源恢复的问题\n- 修复下载音质混用、同名文件覆盖和任务中断后状态恢复异常的问题\n- 下载地址或续传数据失效时重新下载，避免将不完整文件当作已完成歌曲\n- 串行处理手动与自动备份，并在排队完成后检查当天成功记录，避免并发触发重复自动上传\n- 完善 WebDAV 目录、权限、备份文件缺失等提示，批量删除失败后保留失败项供重试\n" } ], "appPermissions": { "entitlements": [ { "name": "com.apple.security.application-groups" } ], "privacy": [ { "name": "NSCameraUsageDescription", "usageDescription": "Allow CyMusic to access your camera" }, { "name": "NSMicrophoneUsageDescription", "usageDescription": "Allow CyMusic to access your microphone" }, { "name": "NSPhotoLibraryUsageDescription", "usageDescription": "Allow CyMusic to access your photos" } ] } } ], "news": [] }