v0.3.0

Echo 0.3.0 — 局域网资料库同步

本版本相较于 0.2.0，二期「局域网资料库同步」正式落地：桌面端可作为局域网主机，其他设备加入后双向同步整个音乐库。同时修复了 Windows 上的音效滤镜问题，并完成设置界面改版。

新增功能

• 局域网资料库同步（默认关闭）：一台设备设为主机，其他设备输入主机局域网 IP 与主机直接显示的六位验证码即可加入。验证码十分钟有效、单次使用、由主机自动刷新，主机自动完成授权，无需逐台审批。
• 完整资料库同步：音频、同名歌词、用户封面与覆盖层、歌曲、收藏、歌单与成员顺序、入库时刻、播放统计和删除墓碑都会同步；SQLite、本机绝对路径、凭据与本机偏好不进入同步载荷。
• 首次同步克隆、后续增量：首次加入时克隆主机资料库，之后按内容哈希增量传输，支持分页、断网重试与断点续传，重复同步不会产生重复对象。
• 冲突裁决：同一对象的并发修改按主机确认序列裁决，检测到基线不一致时保留冲突副本；删除在 10 秒撤销窗口内只形成本机意图，终结后才发布墓碑。
• 离线可用：从设备离线期间的修改进入本机队列，主机恢复可达后统一确认并向其他从设备传播。
• 同步设置界面：主机/从设备角色、连接地址、验证码、设备列表与撤销、同步进度与冲突面板；设置页同步完成主题导航、窄屏导航、快捷键说明与本机音乐库路径展示的改版。
• 可信访问：配对时一次性交换主机 TLS 身份材料并固定证书，后续连接校验该证书；设备凭据保存在本机安全存储，界面与日志不暴露验证码、bearer 凭据或私钥。

修复

• 修复 macOS DMG 安装版无法发现/连接局域网主机的问题：发布包对最终 .app bundle 签名，签名标识与 Bundle ID 一致，并保留本地网络用途说明与 Bonjour 服务声明。
• 修复 Windows 上均衡器滤镜定位错误，音效在 Windows 上不再失效。
• 修复同步中的歌曲身份冲突自愈失败、内嵌媒体修改未同步到两端、删除墓碑未传播、推送游标错位等问题。
• 修复同步后曲库封面、播放路径、歌曲统计不刷新的问题。
• 修复空闲同步反复唤醒与媒体传输挤占控制通道的问题（改用有界长轮询并为资源流量单独设预算）。
• 修复 Windows 系统托盘图标和提示文字显示问题。

安装

平台	产物
macOS	Echo_0.3.0_aarch64.dmg
Windows	Echo_0.3.0_x64-setup.exe
Linux	Echo_0.3.0_amd64.deb · Echo_0.3.0_amd64.AppImage

各平台产物均附 SHA256SUMS-* 校验文件与第三方许可证说明（NOTICE-libmpv-<platform>.md）。

已知事项

• 产物当前未签名 / 未公证。macOS 首次打开需在「隐私与安全性」中放行；Windows 可能显示 SmartScreen 提示。
• 局域网同步默认关闭：未启用时不发现设备、不监听端口、不发送网络请求。macOS 端需授予「本地网络」权限后才能发现或连接主机。
• 完整双机故障矩阵（断网重试、并发冲突、删除撤销与恢复、旧备份回退）与 Linux 实机验证仍在进行；已完成的 macOS + Windows 双机冒烟步骤见 docs/acceptance/lan-sync-two-pc-test.md。
• 移动端（Android / iOS）、远程存储连接器与批量操作仍未立项。

查看与 0.2.0 的完整变更

v0.2.0

Echo 0.2.0

本版本相较于 0.1.4，新增桌面音效与均衡器，并改进 Windows 兼容性和音效状态反馈。

新增功能

• 音效预设： 提供 9 种内置均衡器预设和空间感增强效果，可在播放器中切换。
• 自定义均衡器： 支持编辑 10 段均衡器、调整前置增益，并将自定义曲线保存为个人预设，之后可重命名或删除。
• 本机保存： 音效选择、自定义曲线和编辑状态保存在当前设备，重启后可恢复。
• 削波保护： 根据均衡器曲线限制实际前置增益，降低音频削波风险。

修复

• 修复 Windows 上音效滤波器定位不正确，导致均衡器效果无法可靠应用的问题。
• 修复 Windows 系统托盘图标和提示文字显示问题。
• 修正音效尚在应用时的状态反馈；只有播放器确认生效后才标记为“已生效”。
• 改进切歌、重置和快速切换音效时的状态处理，避免过期回执覆盖最新选择。

体验优化

• 音效面板提供预设选择、曲线编辑和自定义预设管理入口。
• 低采样率等不支持的音频环境会标明不可编辑的频段，同时保留用户设置，环境恢复后重新应用。
• README 增加 MusicTag 相关工具介绍，方便查找本地音乐标签、封面和歌词编辑工具。

查看与 0.1.4 的完整变更

v0.1.4

Echo v0.1.4

本版本包含 v0.1.3 → v0.1.4 之间的 60 个非合并提交，重点更新歌单操作、跨平台打包和 macOS 窗口体验。

✨ 新功能

• 歌单搜索与跨视图操作 — 支持在歌单内搜索、定位当前播放歌曲，并从各歌曲视图进入导入流程；歌单搜索支持继续加载后续结果。
• 添加歌曲时预选已有歌单关系 — 已经包含所选歌曲的歌单会预先勾选，避免重复操作。
• 歌手 / 专辑排序 — 可按指定排序方式浏览歌手和专辑目录。
• macOS 状态栏控制整合 — 将状态栏操作收拢到统一的控件布局。
• 完善 Windows / Linux 播放依赖与平台构建 — 建立 vendored libmpv 构建和校验流程，为三平台安装包提供对应运行库及来源说明。

🐛 修复

• 分页歌曲总数不准确 — 修复歌曲列表经过分页后总数与实际结果不一致的问题。
• 浮层无法再次点击关闭 — 播放队列和歌曲菜单的触发控件现在可再次点击关闭浮层。
• 新建歌单输入焦点不稳定 — 修复创建歌单对话框中的焦点问题。
• Linux 安装包依赖与兼容性 — 修复 Ubuntu 下 vendored libmpv 依赖打包，并将 Linux 构建固定在 Ubuntu 22.04 环境以满足 GLIBC 兼容要求。
• macOS DMG 打包失败 — 转换磁盘映像前先释放源镜像，避免 hdiutil 因资源仍占用而报错。
• macOS 全屏关闭后的窗口残留 — 修复退出全屏和关闭后台窗口的时序问题，避免主窗口继续显示或重绘异常。

🔗 完整变更

v0.1.3...v0.1.4

v0.1.3

Echo v0.1.3

本版本包含 v0.1.2 → v0.1.3 之间的 3 个提交：1 项新功能、1 项修复。

✨ 新功能

• SQ/HQ 音质徽标视觉打磨 — 音质徽标缩小至更紧凑的尺寸，并按主题色做淡化处理（各主题按一致的比例柔化），在歌曲列表中的存在感更克制。

🐛 修复

• 歌手 / 专辑目录切换残留旧视图 — 修复歌手 ↔ 专辑目录切换时详情视图可能残留上一视图卡片、或网格停在空状态的问题：目录查询与详情查询各自持有独立的世代计数器，切换视图时同步清空旧的目录条目。
• 歌手 / 专辑详情页能力与全部歌曲对齐 — 打开的歌手 / 专辑歌曲列表复用统一的歌曲表组件，获得与全部歌曲一致的列宽、窗口化渲染、批量选择、行内「⋯」菜单与「添加到歌单」能力；侧栏歌单成员变更同步刷新。

🔗 完整变更

v0.1.2...v0.1.3

v0.1.2

Echo v0.1.2

本版本包含 v0.1.1 → v0.1.2 之间的 12 个提交：5 项新功能、5 项修复。

✨ 新功能

• 艺术家 / 专辑库视图 — 新增艺术家、专辑两个库浏览视图，可从库导航进入，按艺术家 / 专辑整理并浏览歌曲库。
• 歌曲 SQ/HQ 音质徽标 — 歌曲列表为无损 / 高品质（SQ / HQ）音源显示音质徽标，文件本身不带音质标签时不显示标记。
• 增强 WAV / M4A 元数据解析 — 读取 WAV 的 RIFF INFO 区块与传统 QuickTime atom（如 ©nam / ©ART / trkn 等）元数据，补齐 m4a/wav 的标签与封面信息。
• 支持 Monkey's Audio（.ape）格式 — 导入、扫描、元数据解析与 macOS 默认打开均已支持 APE 格式。
• 手动重新扫描音乐库 — 设置页新增「重新扫描」操作，可手动触发全库重扫，更新新文件、删除与元数据变化。

🐛 修复

• 导入对话框过滤与媒体栈对齐 — 文件选择过滤与支持的音频格式保持一致，并保证 m4a/wav 元数据一定会被解析。
• 歌单成员菜单支持「添加到歌单」 — 从歌单成员的歌曲菜单中选择「添加到歌单」可将歌曲加入其他歌单。
• 撤销窗口内已删歌曲的成员计数 — 处于删除撤销窗口内的歌曲不再计入歌单成员数。
• 删除歌曲后刷新歌单计数 — 删除歌曲后立即刷新歌单成员数量与库导航计数，避免显示过期数值。
• DMG 打包稳定性（构建侧）— 容忍 macos 上偶发的 hdiutil detach 失败，提升 DMG 打包成功率。

🔗 完整变更

v0.1.1...v0.1.2

v0.1.1

🎵 Echo 0.1.1 — 批量管理、回收站与发布流水线加固

Echo 0.1.1 聚焦把日常曲库管理真正用顺手：批量选中与批量操作、删除的文件真正进回收站（而非直接抹掉）、以及被删除歌曲可重新导入不再卡在重复判断上。同时打通了三平台发布流水线与全量治理校验，为后续迭代建立稳定的发布基线。

✨ 本期亮点

• 批量曲库操作：按住多选 / 全选，跨分页保持选中；可批量加入歌单、收藏、下一首播放、入队、移出歌单、删除。单项成功 / 跳过 / 失败逐条反馈，与单首操作保持完全一致的队列、计数与状态刷新语义。
• 删除进系统回收站：从资料库删除歌曲会送入系统回收站 / 垃圾桶，并保留原始文件名，误删可恢复，不再一删即尽。
• 删除后可重新导入：PendingDelete 或外部丢失的旧记录不再占用新导入的重复判断与目标路径——删除同一份文件后可再次导入为新记录，旧的删除恢复语义保持不变。
• 临时导入闭环：文件管理器双击打开 / 拖入的临时歌曲，导入流程完整到达播放，通知可正确消失。
• 发布基线加固：三平台 Release 流水线（macOS / Windows / Linux）全量场景与治理校验（openspec validate --archived 全绿）落地，为后续版本提供可复现的发布路径。
• DMG 视觉升级：安装镜像改为浅色纸感背景，图标 / 窗口布局自适应驱动，视觉对齐桌面主题。

📦 安装

平台	产物
macOS	Echo_0.1.1_aarch64.dmg
Windows	Echo_0.1.1_x64-setup.exe
Linux	Echo_0.1.1_amd64.deb · Echo_0.1.1_amd64.AppImage

各平台产物均附 SHA256SUMS-* 校验文件与第三方许可证说明（NOTICE.md）。

🔧 本次修复

• 从资料库删除的文件现在送入系统回收站（保留原名），而不是永久删除。
• 修复删除（含回收站找回失败）后无法重新导入相同内容的问题。
• 修复临时歌曲导入在播放链路中不完整、通知残留的问题。
• 修复三平台 CI 治理门（governance / scenario / 符号校验）全量恢复通过。
• 修复发布产物在 Windows / Linux 平台上因 artifact 重名而丢失 .deb / .AppImage 的问题。

⚠️ 已知事项

• 产物当前未签名 / 未公证。macOS 首次打开需在「隐私与安全性」中放行；Windows 可能显示 SmartScreen 提示。
• 一期为离线、无账号版：不提供同步入口。资料库同步（S3 兼容）与移动端在后续版本立项。
• 工程开发遵循自定义源可用许可（基于 BSL-1.1 的「个人学习研究可用、不可商用 / 再分发」），详见仓库 LICENSE。

🔗 更多信息

• 项目首页与快速开始：README
• 产品定位：PRODUCT.md
• 路线图：ROADMAP.md

v0.1.0

🎵 Echo 0.1.0 — 本地优先的音乐播放器，来了

Echo 是一个本地优先的桌面音乐播放器：扫描并管理你自己的音乐资料库，不依赖账号、不依赖流媒体。播放、管理、搜索都在本机完成——音乐文件始终属于你。

✨ 本期亮点

• 完整曲库管理：选择并扫描资料库根目录，解析标签、封面与歌词；持续监听目录变化，支持手动重新扫描。
• 安全导入：选中文件复制入资料库 media/，按 歌手/歌手 - 歌曲名 自动组织；内容相同不重复导入，重名不同内容自动追加编号，绝不覆盖已有文件。
• 沉浸式黑胶播放器：动态旋转唱片 + 唱臂，跟随播放进度的歌词（支持内嵌 / 同名 .lrc / 用户覆盖层）。
• 播放体验：稳定播放队列、进度、音量与快捷键；收藏、歌单、排序与搜索。
• 系统集成：macOS 菜单栏状态行 + 控制中心「正在播放」，Windows / Linux 系统托盘；支持设为基础音频的默认打开应用，文件管理器双击即可临时播放。
• 覆盖层优先：封面、歌词与元数据覆盖层不改写原始文件。
• 三套主题：珊瑚玫红（默认）/ 深钴蓝 / 松石绿，记住你的选择。

📦 安装

平台	产物
macOS	Echo_0.1.0_aarch64.dmg
Windows	Echo_0.1.0_x64-setup.exe
Linux	Echo_0.1.0_amd64.deb · Echo_0.1.0_amd64.AppImage

各平台产物均附 SHA256SUMS-* 校验文件与第三方许可证说明（NOTICE.md）。

⚠️ 已知事项

• 产物当前未签名 / 未公证。macOS 首次打开需在「隐私与安全性」中放行；Windows 可能显示 SmartScreen 提示。
• 一期为离线、无账号版：不提供同步入口。资料库同步（S3 兼容）、批量操作与移动端在后续版本立项。
• macOS 为当前平台验证基线，Windows / Linux 的原生端到端与故障恢复矩阵持续扩展中。

🔗 更多信息

• 项目首页与快速开始：README
• 产品定位：PRODUCT.md
• 路线图：ROADMAP.md