Sonar v1.0.0 正式版

Sonar v1.0.0 正式版发布

经过多轮迭代与双端架构重塑，Sonar 正式发布 v1.0.0 稳定版本！无论是日常在 Mac 顶部的轻巧随手播控，还是在手机上的沉浸聆听，Sonar 都致力于让听歌体验回归原生与纯粹。

---

🌟 核心亮点与新增特性

1. 本地音乐播放与离线曲库（重大更新）

   • 彻底摆脱第三方 API 与网络限制：支持批量导入本地音频文件与文件夹（MP3、FLAC、M4A、WAV 等）。
   • 通过 AVURLAsset 异步解析 ID3 元数据、艺术家、专辑与内嵌高清封面。
   • 自动扫描同目录同名 .lrc 歌词文件，提供精准同步歌词展示与原生音频播放体验。

2. 极具质感的 macOS DMG 拖拽安装交互

   • 专为 Mac 用户定制的精致安装体验：配备 Retina 2x 高清暗色系安装窗口、对齐卡位、动态拖拽引导箭头与系统提示。
   • 打开 DMG 即可一键拖拽 SonarMac.app 到 Applications 文件夹完成安装。

3. Mac 灵动岛 / 刘海随手播控

   • 状态栏选歌面板与顶部刘海播放器深度联动，无缝适配带刘海与不带刘海的 Mac 屏幕。
   • 状态栏面板新增「导入本地音乐」快捷入口，优化空状态指引与操作手感。

4. iOS 全新视觉交互与手感打磨

   • 分段式黑胶启动动画、封面大图沉浸式主页、悬浮播放条与四个功能导航。
   • 圆形玻璃播控按钮与物理触感反馈，播放页随歌曲封面自适应平滑取色。

5. 音源架构收敛

   • 在线音源精简并收敛至网易云（通过 ChKSz），支持母带音质优先与逐级平滑降级；彻底移除本地 JS 脚本运行器依赖。

---

📦 安装与下载说明

文件名	平台 / 架构	说明
SonarMac.dmg	macOS 14.0+ (Universal: Apple Silicon + Intel)	推荐：带专属暗色拖拽交互界面的 macOS 安装包
SonarMac.zip	macOS 14.0+ (Universal: Apple Silicon + Intel)	macOS 绿色便携压缩包

Tip

macOS 安全提示：
本安装包采用本地 Ad-hoc 签名（未走 Apple 昂贵的商业公证通道）。若首次打开时 macOS 提示安全性拦截，可在系统设置「隐私与安全性」中点击允许，或在终端执行一行命令解除隔离标志即可流畅运行：

xattr -cr /Applications/SonarMac.app

---

校验和 (SHA-256)

• SonarMac.dmg: 见 SonarMac.dmg.sha256
• SonarMac.zip: 见 SonarMac.zip.sha256

v1.0.0-preview.3

本次预览版重点为 macOS 提供预编译 DMG / ZIP 安装包，并正式上线无需凭据的本地音频与 LRC 歌词离线播放能力。

🌟 核心更新

• 📦 提供 macOS 开箱即用安装包：为 macOS 14+ 提供 Universal（Apple Silicon + Intel）预编译安装包 SonarMac.dmg 与 SonarMac.zip，无需 Xcode，双击即可直接体验。
• 🎵 离线本地音乐播放：支持导入本地音频文件或整个文件夹（MP3、FLAC、M4A、WAV 等），利用 AVURLAsset 自动提取 ID3 元数据、艺术家、专辑与内嵌封面，无需任何第三方凭据与网络即可离线畅听。
• 📝 同步 LRC 歌词匹配：本地音乐自动匹配同级目录下的同名 .lrc 歌词文件，在状态栏面板及 Mac 屏幕顶部灵动刘海中享受同步滚动与高亮。
• 🖥️ 界面与交互优化：Mac 状态栏面板的设置中增设「导入本地音乐」入口，并在播放列表为空时提供友好的空状态与导入按钮引导。
• 🛠️ 自动化打包脚本：新增 scripts/package-mac.sh，方便开发者自行快速打包 DMG / ZIP 产物。

下载与安装

• Mac 用户：下载 SonarMac.dmg，打开并将 SonarMac 拖入 Applications（应用程序）。
• 解除安全提示：由于采用本地 Ad-hoc 签名且未进行付费 Apple 公证，若 macOS Gatekeeper 提示未验证来源，请在终端执行：

  xattr -cr /Applications/SonarMac.app

• 校验和验证：

  shasum -a 256 -c SonarMac.dmg.sha256

English

This preview release introduces pre-built Universal macOS packages (SonarMac.dmg and SonarMac.zip) and full offline local music playback support (MP3, FLAC, M4A, WAV, etc.) with automatic ID3 metadata extraction, embedded artwork, and synchronized local .lrc lyrics.

Full changes: v1.0.0-preview.2...v1.0.0-preview.3

Sonar v1.0.0-preview.2 — iOS preview & playlist import

本次 iOS 实验预览加入双音源搜索、最高音质优先和 QQ / 网易云公开歌单迁移，并统一导入界面的应用风格。

功能与修复

• 完善 QQ 音乐搜索请求，恢复通过 ChKSz 获取网易云歌曲搜索、歌词、播放及公开歌单数据。
• 两种音源优先请求母带音质；缺少可用结果时按同一歌曲 ID 逐级降档，服务错误保留明确失败提示。
• iOS 主页支持搜索框与遮罩交互，保留当前页面上下文。
• 支持粘贴 QQ 音乐、网易云音乐公开歌单的分享链接或 ID，先预览，再按原顺序合并到个人资料库并去重；读取或保存失败保留已有数据。
• 歌单导入复用现有主题、歌曲行与弹层组件；Mac 面板接入同一导入能力和音源策略。
• 明确音频中断、输出切换、静音提示及应用恢复通知在主队列上的隔离，消除设备 Release 构建警告。
• 更新双语 README、音源配置说明及第三方代码声明，移除当前分发代码中的旧网易客户端适配器并保留历史许可记录。

分发说明

• 提供 iOS 17+、arm64 的未签名 IPA、SHA-256 和安装说明；App、Widget 与 Mac 源码构建版本统一为 1.0 (22)。
• 公开 IPA 不含个人 API 凭据，QQ 播放及网易云相关接口需要使用自己的 ChKSz Key 从源码构建。
• 本次提供 iOS 安装产物；既有 Mac 实验包保留在 v1.0.0-preview.1，最新 Mac 功能可从共享工程构建。
• 预览版本仍受第三方服务可用性影响，尚未完成本轮 iPhone 真机验收。

下载与安装

• 下载 Sonar-1.0-build22-unsigned.ipa、同名 .sha256 和 INSTALL-iOS.md。
• 在下载目录运行 shasum -a 256 -c Sonar-1.0-build22-unsigned.ipa.sha256。
• IPA 未签名，安装前需自行签名 App 与 Widget，并配置匹配的描述文件、Bundle ID 和 App Group。
• 公开包不含个人 API Key；QQ 播放以及网易云相关接口需使用自己的 ChKSz Key 从源码构建，当前没有 App 内 Key 编辑入口。

验证

• 从仅含 174 个已跟踪文件的副本构建设备 Release 归档，0 警告、0 错误，无本地测试或 Agent 框架依赖。
• 最终 IPA 已独立解包核对：App / Widget 1.0 (22)、arm64、iOS 17.0+、无签名材料、凭据配置为空，音源资源与发布提交一致；ZIP 与 SHA-256 校验通过。
• 本次主队列通知隔离修复的 5 项后台音频通知回归通过，0 失败。功能实现阶段的 51 项回归，以及样式调整后的 17 项导入与备份回归均通过。
• 本轮尚未完成真机 iPhone 运行验收；第三方接口仍可能返回 503。

English

This iOS preview adds QQ / NetEase song search, highest-quality-first parsing, an in-place search overlay, and public-playlist migration with preview and deduplication. The unsigned IPA targets iPhone, iOS 17+, arm64, version 1.0 (22). Sign both the app and widget before installation. No personal API credentials are included: QQ playback and NetEase APIs require your own ChKSz key supplied through a source build. See INSTALL-iOS.md and the updated README. The existing Mac preview remains at v1.0.0-preview.1; current Mac features are available from source.

Full changes: v1.0.0-preview.1...v1.0.0-preview.2

Sonar v1.0.0-preview.1 — Mac experimental preview

Sonar's first experimental Mac preview provides a universal Apple Silicon / Intel build for macOS 14+. The app combines a menu bar library and notch player with synchronized lyrics and local playlist backup. The shared project also supports iOS 17+ source builds.

Download and installation

• Download SonarMac.zip and SonarMac.zip.sha256.
• Verify with shasum -a 256 -c SonarMac.zip.sha256, then follow INSTALL.md inside the ZIP.
• The package is ad-hoc signed, without Developer ID signing or Apple notarization. macOS may block the first launch; installation and source-build options are documented.
• The interface is mainly Chinese. Search, playback, and quality depend on third-party services. No author credentials or audio files are included. iPhone builds require your own signing setup; this release does not distribute an IPA.

Changes

• Removed three unused helper snippets with unresolved provenance and replaced size formatting and binary reading with Sonar implementations, retaining historical attribution records.
• Aligned the README's usage explanation with the existing GPL-3.0 license and added an English overview and experimental-build installation guidance.

Validation

• Five local helper regression checks passed.
• Built the shared Sonar scheme for iOS Simulator and SonarMac in Release for arm64 and x86_64 from a checkout containing only tracked public files.
• Verified the bundled source resource matches the repository, credentials are empty, and ZIP integrity and the local ad-hoc signature pass.

---

这是首个 Mac 实验预览包，支持 macOS 14+、Apple Silicon 与 Intel。下载后请核对 SHA-256，并阅读 ZIP 内的 INSTALL.md。包使用 ad-hoc 签名，未经过 Developer ID 签名或 Apple 公证；界面主要为中文，第三方音源可用性会变化。App 与 Widget 版本保持为 1.0 (21)，iOS 仍需自行构建及签名。