MD3Music iOS v6.0.6+50

本版亮点

• iOS 开放文件系统：开启文件共享（File Sharing）与原地打开——「文件」App 中出现 MD3Music 目录，可随时查看/管理此前「导入」功能拷入应用目录的音乐（本版起导入已由文件夹授权取代，旧导入文件仍会被正常扫描播放）
• iOS 本地音乐改为文件夹授权：移除「导入」，改用系统「文件」App 授权文件夹——授权后书签持久化（冷启动自动恢复访问）、原位扫描原位播放不占双份空间；界面与 Android 同一套（曲目/专辑/艺术家/文件夹/收藏，扫描菜单、排除文件夹一致），未扫描时空状态按钮为「授权文件夹」，加号菜单「扫描音乐」与 Android 一致为纯重扫
• iOS 均衡器体验修复：调节滑杆不再有「咔哒」噪声（系数改为逐样本平滑逼近，不复位滤波器状态）；修复调节后效果时有时无、需要反复调的问题（回归稳定的 activeBands 架构）
• iOS 画中画悬浮歌词修复：背景不再闪烁、歌词不再有残影、边缘不再有黑色羽化/黑边（高斯模糊改为外扩渲染裁中心区，杜绝边缘污染与半透明带）

其它

• README 构建说明澄清：Rust 服务器为后期引入组件，Android 产物已入库、iOS 产物（libkugou_server.a）未入库，本地构建 iOS 前必须先执行 build_ios.sh 交叉编译
• 签名与小组件兼容说明澄清：使用免费 Apple ID 签名（7 天）；App Group 兼容目前仅支持 iloader，AltStore 等其他工具签名后主应用可用但小组件不刷新

未签名 IPA：下载后自行签名安装（推荐 iloader，免费 Apple ID 签名即可）。

• MD3Music-unsigned.ipa：标准版（无 3D 封面，推荐）
• MD3Music-3D-unsigned.ipa：含 3D 封面支持版（内置 Depth Anything V2 深度模型与 MI-GAN 修补模型，设置中开启 3D 封面即可；生成失败时自动回退平面封面，包体约 +40MB）

小组件提示：请使用 iloader 签名。AltStore/SideStore、爱思助手等其它工具签名后，主应用一切正常，仅桌面小组件无法收到播放状态。

仅供学习交流，请勿用于商业用途！详见免责声明。如条件允许请支持原作者项目：zzyoxml/md3Music。

MD3Music iOS v6.0.5+49

本版亮点

• iOS 长按保存图片修复：新增原生相册写入插件（PHPhotoLibrary，仅需「添加到相册」权限），保存至「MD3Music」相册并自动建簿；此前长按保存必然失败（channel 未注册）
• iOS 切歌无声 / 上一首残留修复：切歌起播改走 AVPlayer play()（自动激活音频会话，直接设 rate 不会激活——中断结束后会话处于停用态就表现为「播放中、频谱动但无声」）；新源装载时无条件暂停旧音频，Dart 侧状态漂移也不再留下上一首的残留声
• iOS 自定义背景返回主界面消失修复：iOS 路由过渡对齐 Android 的「页面自带背景」策略（Cupertino 动效 + 内嵌背景层），返回主界面后背景随页面自身渲染，不再依赖全局单层背景（A11 + Impeller 偶发渲染失效）
• iOS 音频导入彻底修复：文件选择器去掉 .audio 伞类型，只放行白名单格式（mp3/flac/m4a/aac/ogg/opus/wav/aiff/ape/wma/aif），.mid 等冷门容器在选择器里直接置灰不可选；拷贝源头另有白名单兜底。此前「什么文件都能选进来、选了又不显示」的问题根治
• iOS 长按快捷方式补图标：9 张模板图标（收藏/识曲/搜索/发现/本地音乐/私人FM/封面流/排行榜/编辑精选），与 Android drawable 同名对齐，此前仅显示文字
• 显示大小确认更可靠：调整后未点「保留」就滑掉后台，不再把未确认的档位带进下次启动（改为内存预览，确认后才落盘）
• 更新提示不露构建号：toast 与设置页最新版本号显示 v6.0.5 而非 v6.0.5+49

上游 6.0.2→6.0.5 移植

• 音频效果挂载加固：单个音效绑定失败不再中断初始化（此前部分设备上会导致已缓冲完毕却无声、15 秒超时后播放命令永远发不出）
• 媒体会话元数据延迟落位：切歌竞态时暂存到 onMediaItemTransition 再应用，标题/歌词/自定义按钮不再被丢弃；会话不再在构造时抢占（由 play 收敛）；会话元数据补齐 artUri 封面映射
• vivo 媒体会话内存泄漏修复：release() 从活跃列表移除，死会话不再被 25 秒定时器持续写入
• 诊断日志插件：采集线程整体兜底 + MethodChannel 回调切回主线程（修复 debug/profile 下崩溃）
• VIP 状态：同业务线多条会员取到期最晚的一条（签到领的短期会员不再掩盖购买的长期会员）
• AM 写真背景：竖屏仅封面页显示（跟手淡出，歌词页不再有写真）；透明度与轮播间隔设置即时生效
• 底栏形态切换零跳变：交棒窗口与让位同帧置位、常驻条端点用实测高度、进度中心线锚条盒中心
• 本地音乐音质标签：码率单位修正（bps）、无损格式不再凭码率推断、旧缓存不可信标签自动撤销

其它

• 更新检查模块测试补齐（29 项全过）与三个失效测试清理；flutter analyze 零新增问题

未签名 IPA：下载后自行签名安装（侧载工具均可）。

• MD3Music-unsigned.ipa：标准版（无 3D 封面，推荐）
• MD3Music-3D-unsigned.ipa：含 3D 封面支持版（内置 Depth Anything V2 深度模型与 MI-GAN 修补模型，设置中开启 3D 封面即可；生成失败时自动回退平面封面，包体约 +40MB）

签名提示：请使用 iloader 签名；用 AltStore 签名后，小组件不能解析歌曲信息。

仅供学习交流，请勿用于商业用途！详见免责声明。如条件允许请支持原作者项目：zzyoxml/md3Music。

MD3Music iOS v6.0.1+48

本版亮点

• 3D 封面（深度推理完整接入）：与 Android 对齐的完整推理管线——Depth Anything V2 深度推理 + 联合双边滤波平滑 + push-pull 金字塔修补 + MI-GAN 神经修补 + 三层视差切割。标准包不链接推理库零体积，3D 包约 +40MB。期间逐一修复 ONNX Runtime 直调的十余处崩溃根因（API 签名、模型/输入缓冲生命周期、CGDataProvider 语义、GCD 栈调度），真机验证通过
• 私人 FM 中号小组件：1:1 对齐 Android 4x2 电台卡——大封面 + 收藏/播放 + 底排预告封面x3 + 档位切换，未登录显示登录引导卡
• 蓝牙歌词：锁屏/控制中心的歌曲信息可被当前歌词行替换，车载/带屏蓝牙设备经 AVRCP 实时显示（设置内开关）；修复冷启动后开关恢复失效
• AutoMix 智能混音：补齐 iOS 原生解码（AVAssetReader）并放行双播放器交叉淡化，对拍接歌、按首拍自适应切换时长、变速接歌全部生效
• 识曲系统声音：听歌识曲 PiP 支持识别手机内正在播放的声音（ReplayKit 广播扩展捕获 PCM，自动优先于麦克风），右上角「系统声音」徽标可视化

上游 6.0.1 移植

• AM 写真背景重构：紧凑机型写真铺满整页、宽屏仅占左栏 0.4 并在外缘羽化
• 播放列表首尾新增悬浮播放栏占位
• 修复上游 platform_capabilities 将 iOS 误判为桌面端，导致均衡器/音效、听歌识曲、音乐频谱、桌面快捷方式等入口消失的回归
• 震动反馈对齐 Android：交互触感 + 滑条 m3e + 音乐节奏震动（CHHapticEngine）

小组件

• 小号封面取色对齐 Android（Palette 取色做遮罩与播放键底色）；iOS 17+ 三键真实可点，iOS 16 整卡点击=播放/暂停兜底
• 修复中号/小号内容贴边裁切（安全区）

桌面歌词 PiP

• 背景改为封面高斯模糊 + 黑色遮罩，不透明度设置生效
• 版式（字号/行式/条高）与配色跟随设置页，卡拉OK 改文字蒙版式
• 修复快速连点开关方向相反、按钮高亮滞后一拍

本地音乐与导入

• 本地歌曲改导入模式 + 内置更多菜单删除 + 隐藏文件夹 Tab（iOS）
• 音频导入改走原生 DocumentPicker（修复 iOS 不弹选择器），失败原因可见化

其它

• 更新检查简化：去掉 12 小时节流，跟随「新版本提醒」开关每次启动检查，发现新版本才提示一次；设置页「更新最新版本」入口显示 GitHub 最新版本号

未签名 IPA：下载后自行签名安装（侧载工具均可）。

• MD3Music-unsigned.ipa：标准版（无 3D 封面，推荐）
• MD3Music-3D-unsigned.ipa：含 3D 封面支持版（内置 Depth Anything V2 深度模型与 MI-GAN 修补模型，设置中开启 3D 封面即可；生成失败时自动回退平面封面，包体约 +40MB）

签名提示：请使用 iloader 签名；用 AltStore 签名后，小组件不能解析歌曲信息。

仅供学习交流，请勿用于商业用途！详见免责声明。如条件允许请支持原作者项目：zzyoxml/md3Music。

MD3Music iOS v5.8.1+47

未签名 IPA：下载后自行签名安装（侧载工具均可）。

• MD3Music-unsigned.ipa：标准版（无 3D 封面，推荐）
• MD3Music-3D-unsigned.ipa：含 3D 封面支持版（设置中显示 3D 封面选项；当前 iOS 端深度推理未接入，生成失败时自动回退平面封面）

本项目为上游安卓版 zzyoxml/md3Music 的 iOS 移植。

MD3Music iOS v5.8.0+46

⚠️这个版本有一些BUG，不推荐下载此版本，请从Releases页面下载最新版本。

未签名 IPA：下载后自行签名安装（侧载工具均可）。

本版亮点

• 优化了歌词悬浮窗
• 新增听歌识曲悬浮窗
• 图标适配 iOS 26 Liquid Glass

签名提示

请使用 iloader 签名：用 AltStore 签名后，小组件不能解析歌曲信息。

本项目为上游安卓版 zzyoxml/md3Music 的 iOS 移植。

MD3Music- iOS v5.7.0

v5.7.0

修复问题

我感觉很多问题都已经修复了，以下是修复的内容，还加了一些好玩的功能（不知道还会不会有别的问题qwq）

• 原生均衡器：MTAudioProcessingTap 实现 5 段 EQ（60/230/910/3600/14000 Hz、±15 dB），对齐 Android 听感，输出限幅防爆音
• 真实音乐频谱：EQ 前采样 PCM + 1024 点 FFT + 40 频段，与 Android 同协议；不支持设备保留模拟降级（实则iOS6+的都支持）
• 桌面小组件：WidgetKit 小号/中号组件，封面 + 播放状态 + 秒级进度自推进；iOS 17+ AppIntent 按钮、iOS 15/16 URL Scheme 回跳
• 锁屏 / 控制中心：Now Playing 信息 + 远程控制完整同步
• 画中画悬浮歌词：VideoCall 式 PiP 单行细条歌词
• 音频焦点：AVAudioSession 中断通知，被其他 App 抢占时应用内同步暂停
• 长按快捷菜单：quick_actions 动态注册，跟随设置页「桌面快捷方式」配置

iOS 需使用nab138/iloader侧载工具安装：小组件 App Group 已内置运行时自动解析，需 iOS 15 及以上。本人实测AltStore安装，组件似乎无法解析歌曲信息。（画中画歌词、小组件交互等部分功能依赖更高版本）。

仅供学习交流，请勿用于商业用途！详见免责声明。如条件允许请支持原作者项目：zzyoxml/md3Music。

大部分内容都是AI写的，我也就随便写了点（）

MD3Music- iOS v5.6.5

v5.6.5

已修复问题

• 在iOS播放控件中，显示不了歌曲信息
• MV全屏播放器无法退出

已知问题

• 无法使用均衡器
• 偶尔会出现无网络的情况，重启应用可解决

MD3Music- iOS v5.6.0

移植内容

• lib/ ：42 个文件，含新页面（full_player_route、player_tab_layout、position_rewind_gate）和歌词渲染大改
• Android ：USB 音频大更新（新增UsbDither.kt 抖动处理及测试、UsbAudioDevice.kt +280 行）、按上游删除了MiuixDiscoverActivity
• 瘦身 ：删除 SimHei 字体（-9.7MB）
• 测试 / workflows / README / CHANGELOG 同步更新

保住的 iOS 修复

• kugou_server.dart 的DynamicLibrary.process() iOS 分支
• Cargo.toml 的staticlib + 全局log
• ios/ 目录完全未动（图标、pbxproj、export_symbols.txt、build_ios.sh、Rust 链接配置）

已修复问题

• 替换应用内字体/背景图片

已知问题

• 无法使用均衡器
• MV全屏播放器无法退出

MD3Music- iOS

iOS版本移植（测试中）

已修复问题：

• 联网

已知问题：

• 无法调取系统文件/图片
• 无法使用均衡器