CoCo Music 0.0.8

本次新增酷狗概念版与 Windows 任务栏歌词，并优化播放栏、滚动条和更新检查体验。

酷狗普通版与概念版

• 新增酷狗概念版曲库入口，普通版与概念版分别保存登录状态和歌曲来源。
• 完善推荐、搜索、排行榜、歌单、歌词、音频与 MV 播放功能。
• 概念版支持会员权益查询、手动领取今日权益及可选的每日自动签到。
• 改进设备注册、播放授权、私人歌单读取和账号状态处理，优化试听与实际音质识别。
• 账号认证或资源权限异常时提供更明确的提示，减少异常情况下连续跳歌。

Windows 任务栏

• 新增任务栏歌词，默认开启，可在设置或歌词右键菜单中关闭，已有保存的开关状态继续沿用。
• 支持调整位置、宽度、字号、翻译和颜色，悬停时展开上一首、播放或暂停、下一首和喜欢按钮。
• 自动避让任务栏控件，在全屏、任务栏自动隐藏或空间不足时收起。当前支持主屏幕横向任务栏。
• 任务栏悬停预览显示当前歌曲封面，并提供播放控制。

界面与交互

• 播放栏按钮悬停采用图标缩放、位移和颜色反馈，移除悬停背景色。
• 左侧导航栏隐藏滚动条，其他区域仅在悬停或滚动时显示滚动条。
• 歌词页音频可视化统一使用密集模式，移除密度设置选项。

更新与稳定性

• 更新检查增加短时缓存和并发请求合并，减少重复访问 GitHub。
• 遇到接口限流时显示重试时间，并保存等待状态。
• 改进开发模式下 Electron 重载与子进程退出处理。

macOS 提供 Apple Silicon 与 Intel 安装包，Windows 和 Linux 提供 x64 安装包。全部安装包的校验值见 SHA256SUMS.txt。安装说明。

CoCo Music 0.0.7

本次新增三平台 MV 播放，完善播放器模式与桌面歌词体验。

MV 播放

• 支持网易云音乐、QQ 音乐、酷狗音乐的歌曲关联 MV，并提供独立 MV 页面。
• 播放器沿用应用的共享控件和主题，支持进度调节、清晰度切换、倍速、音量、全屏与画中画。
• 观看 MV 时暂停歌曲，退出后恢复原歌曲进度及播放状态，避免音视频同时出声。
• 支持视频加载失败后重试；酷狗视频支持本地分段转发和进度拖动。
• 没有可播放的官方 MV 或平台限制播放时显示相应提示。

歌词与播放器

• 新增星河漫游视觉模式，提供具有空间纵深的歌词与音符效果。
• 模式选择按钮固定显示“播放模式”，缩略图改为静态预览，并完善星河漫游预览。
• 改进歌词页播放栏自动隐藏及桌面歌词锁定、解锁区域的交互。
• 统一菜单选择状态与播放器控件样式。

macOS 提供 Apple Silicon 与 Intel 安装包，Windows 和 Linux 提供 x64 安装包。全部安装包的校验值见 SHA256SUMS.txt。安装说明。

CoCo Music 0.0.6

本次新增歌词页布局和播放器视觉模式，并改进歌单播放与账号登录状态处理。

歌词页与播放器模式

• 新增标准、居中和纯歌词三种布局，可在歌词页右上角或设置中切换，并保存选择。
• 居中布局在封面下显示当前歌词及翻译或下一句，切换布局和歌词时加入过渡动画。
• 新增细线频谱、柔光波、镜面倒影、经典唱片、跳动旋律、迷幻水波和动感音阶七种视觉模式，选择卡片提供动态预览。
• 经典唱片支持搭配细线频谱或柔光波；环形效果围绕旋转封面显示。
• 支持封面取色、主题色、极光和自定义颜色等配色，以及普通、精细两档频谱密度；开启“减少动效”时停止显示效果动画。
• 桌面端频谱读取实际音频，并跟随设置中的输出设备；普通浏览器使用模拟动画。
• 调整没有逐字时间信息的歌词填充节奏，在切换下一句前保留短暂停顿。

歌单播放

• 从歌单播放歌曲或点击“播放全部”时，先播放已加载的歌曲，再在后台补齐后续分页到播放队列，最多加载 2000 首。
• 搜索筛选后只播放匹配歌曲；选择双击插入歌曲时继续保留插入行为。
• 后台补齐期间若播放队列已改变，不再追加原歌单。

账号与界面

• QQ 音乐增加登录凭据检查和自动续期，播放仅返回试听片段时尝试刷新登录并重新获取音源。
• 增加定时、窗口重新聚焦和试听触发的登录状态检查；确认登录过期后清理账号状态并提示重新登录。
• 网络异常时尽量保留已缓存的登录资料，减少误判退出。
• 统一歌词页与底部播放栏的上一首、下一首按钮样式，取消播放模式按钮常驻底色。
• 调整喜欢按钮角标，已喜欢时显示完整红心并隐藏数量。

macOS 提供 Apple Silicon 与 Intel 安装包，Windows 和 Linux 提供 x64 安装包。全部安装包的校验值见 SHA256SUMS.txt。安装说明。

CoCo Music 0.0.5

本次修复部分本地歌曲歌词不随播放滚动的问题，并统一主题背景与播放控件的显示效果。

本地歌词

• 修复读取内嵌同步歌词时丢失时间戳的问题，使用毫秒时间戳的 SYLT 歌词现在可以随播放进度切换和滚动。
• 同一文件存在多个内嵌歌词版本时，优先使用同步歌词，避免纯文本版本覆盖同步信息或重复拼接歌词。
• 保留内嵌 LRC 和纯文本歌词支持；没有时间信息的歌词仍按纯文本显示。

界面与交互

• 主题色现在同时应用于窗口背景、背景渐变、内容面板、播放栏及弹出菜单，不再只有按钮和高亮变色而整体背景仍偏紫。
• 浅色和深色模式分别生成柔和的背景配色，并调整文字色以保持可读性。
• 修复歌曲列表悬停时播放按钮与正在播放的动态指示同时显示、互相挤占位置的问题。
• macOS 菜单栏短歌词默认靠右显示，长歌词继续随播放进度滚动。
• 去掉大小喜欢按钮悬停时的矩形底色。
• 喜欢量保持原位置和透明背景，取消数字下方对红心的挖空效果，保留完整心形。

其他

• 更新构建环境使用的 Node.js 安全补丁版本。
• 新增内嵌同步歌词解析、主题背景配色和文字对比度回归测试。

macOS 提供 Apple Silicon 与 Intel 安装包，Windows 和 Linux 提供 x64 安装包。全部安装包的校验值见 SHA256SUMS.txt。安装说明。

CoCo Music 0.0.4

本次修复更新提示方式，以及设置页手动滚动后分类导航失效的问题。

更新提示

• 发现新版本时自动弹窗，显示更新说明，并提供「立即下载」和「跳过此版本」选项。
• 移除自动下载更新开关，不再后台自动下载安装包，也不再退出时自动安装；下载和安装均由用户点击确认。
• 清理旧版本遗留的自动下载偏好，避免旧配置继续触发自动下载。
• 跳过的版本在重启后仍保持跳过；关闭提示后，同一版本在本次运行中不会反复弹窗。
• 修复先手动检查、后自动检查时，新版本弹窗可能被遗漏的问题。

设置页导航

• 修复手动滚动后，点击左侧分类无法正确跳转的问题。
• 分类跳转前停止滚轮惯性动画，按实际滚动容器计算目标位置，避免两种滚动相互干扰。
• 修复浏览器对滚动位置取整后，惯性动画可能无法结束的问题。
• 统一导航高亮的计时方式，改善滚动与分类切换时的状态同步。

验证

• 新增旧版配置迁移、自动更新提示、跳过版本、退出不安装，以及滚轮取整和分类定位等回归测试。
• 75 项功能测试与 5 项发布规则测试通过，并完成类型检查、Lint 和生产构建检查。
• 已实测自动弹窗且不产生下载文件，以及手动滚动后多次切换设置分类。

升级说明

这项更新逻辑修复需要安装 0.0.4 后才会生效。仍在使用 0.0.2 或 0.0.3 的用户，如果不希望旧客户端自动下载，请先在「设置 → 更新」关闭「自动下载更新」，再检查并安装本版本。

macOS 提供 Apple Silicon 与 Intel 安装包，Windows 和 Linux 提供 x64 安装包。全部安装包的校验值见 SHA256SUMS.txt。安装说明。

CoCo Music 0.0.3

本次更新新增独立的歌手浏览页，补全歌手详情，并让歌曲下载支持音质选择与账号权限核验。

歌手浏览

• 在左侧「音乐馆 → 歌手」新增独立入口，首页「热门歌手」区域也可进入完整歌手目录。
• 支持按地区、歌手类型和首字母筛选；QQ 音乐额外提供流派筛选，各平台显示其实际支持的分类。
• 使用歌手头像卡片展示目录，支持滚动加载与手动加载更多，点击卡片即可进入歌手详情。
• 适配网易云音乐、QQ 音乐和酷狗音乐的目录接口，处理 QQ 固定分页大小与酷狗分组重复数据。
• 补充加载骨架、无结果提示和失败重试，切换平台时重置对应筛选条件。

歌手详情

• 新增「歌手简介」板块，展示平台提供的简介与分节介绍。
• 完善专辑列表的空状态、加载结束提示及数量显示。
• 支持将热门歌曲加入播放队列，播放和加入队列时提供加载状态与错误反馈。
• 调整头部简介、封面背景与小窗口布局，使资料和内容列表更清晰。

下载音质与权限

• 点击下载后先选择音质，单曲下载与批量下载共用确认弹窗。
• 单曲下载会查询当前账号实际可获取的音质，无权限或平台未提供的音质会显示原因。
• 网易云音乐使用独立的下载权限接口，避免将播放权限当作下载权限。
• 下载时再次核验实际音质；只有明确允许后，才会降级音质或保存试听片段。新用户默认不保存试听片段。
• 默认仅下载音频，可选择同时下载歌词；确认后的音质、歌词与试听偏好会保存供下次使用。
• 每个任务保留入队时的选择，后续修改全局设置不会改变已加入任务的下载选项。
• 已下载歌曲可重新选择其他音质下载，下载管理中显示实际下载音质。
• 调整歌曲列表操作按钮的悬停效果，避免点击时按钮位置移动。

界面预览与验证

• README 补充半透明窗口实拍、歌手目录、歌手专辑与简介，以及下载音质选择截图。
• 增加接口参数、平台筛选、分页去重、下载权限、试听授权、音质降级和任务选项保存等测试。
• 68 项功能测试与 5 项发布规则测试通过，并完成类型检查、Lint 和生产构建检查。

升级

已安装 0.0.2 的用户可在「设置 → 更新」中检查新版本，点击「立即下载」，完成后按提示重启更新或打开安装包。

首次安装可从本页选择对应系统的安装包。macOS 提供 Apple Silicon 与 Intel 版本，Windows 和 Linux 提供 x64 版本；全部安装包的校验值见 SHA256SUMS.txt。安装说明。

CoCo Music 0.0.2

本次更新带来应用内更新、更加可靠的偏好保存，以及歌曲下载、图标和文档的多项改进。

应用内更新

• 自动检查新版本，也可在「设置 → 更新」中手动检查，直接阅读更新说明。
• 点击「立即下载」即可在应用内下载安装包，查看进度与速度，支持取消和失败重试，无需跳转到 Release 页面。
• 安装包下载后会校验 SHA-256，校验通过后才允许安装。
• macOS 支持退出后替换应用，Windows 支持运行安装器完成更新；Linux AppImage 支持替换，deb 包交给系统安装器处理。无法直接替换的安装方式会提供「打开安装包」。
• 默认由用户点击下载，也可开启自动下载、退出时安装，并选择正式版或预览版渠道。
• 支持跳过某个版本、查看历史更新日志，以及跨版本升级时阅读中间版本的更新内容。

设置与播放体验

• 用户偏好保存到系统标准应用数据目录，修复重启或本机服务端口变化后设置丢失的问题。
• 持续保存音量、播放模式、播放队列与进度，以及搜索历史、最近播放和侧边栏偏好。
• 修复启动时默认音量和播放模式覆盖已保存设置的问题。
• 列表加载下一页失败后保留已有内容，支持重试；切换页面时取消旧请求，减少重复加载。

歌曲下载与本地曲库

• 默认仅下载歌曲，可选择同时下载歌词，也可从歌曲菜单或已完成的下载中单独导出歌词。
• 下载歌曲时写入歌曲名、歌手、专辑与封面元数据；元数据写入失败时保留已下载的音频并提示。
• 修复扫描、下载和打开本地文件同时发生时，曲库索引可能丢失更新的问题。
• 下载到本地的歌曲保留来源平台与试听标记，改善歌词、收藏和评论的匹配；删除下载时同步清理曲库索引。
• 增加数据文件的原子保存与备份恢复，降低意外退出造成数据损坏的风险。

外观与项目文档

• 统一采用紫藤渐变背景与白色图案，更新应用、托盘、网页和文档中的品牌图标。
• 调整 macOS Dock 图标尺寸，并补充系统原生图标资源。
• 重新整理 README，补充项目徽章，以及歌词播放页、桌面歌词、macOS 菜单栏歌词和歌单详情截图。
• 将安装、开发、数据存储与发布说明整理为独立文档。

升级说明

• 从 0.0.1 升级，请先从本页下载对应系统的 0.0.2 安装包完成安装；应用内更新功能从本版本开始提供。
• macOS 提供 Apple Silicon 和 Intel 安装包，Windows 与 Linux 提供 x64 安装包。SHA256SUMS.txt 包含所有安装包的校验值。
• macOS 尚未经过 Apple Developer ID 签名与公证，Windows 尚无发行者签名，首次运行可能出现系统提示。请参阅安装说明。

CoCo Music 0.0.1

CoCo Music 首个公开版本。一个采用淡紫色界面的第三方桌面音乐播放器，支持 macOS、Windows 和 Linux。

音乐与播放

• 接入网易云音乐、QQ 音乐和酷狗音乐，可在设置中切换曲库。
• 提供歌曲、歌单、专辑和歌手搜索，以及推荐、排行榜和收藏管理。
• 支持播放队列、循环与随机播放、音质选择、同步歌词和逐字歌词；可用音质取决于平台与账号权益。
• 支持本地音乐、下载管理、歌词导出、最近播放及系统音频文件“打开方式”。

桌面体验

• 使用白色双 C 唱片图标与淡紫色圆角底板，支持主题配色和窗口外观设置。
• 提供桌面歌词、迷你模式、全局快捷键，以及托盘、菜单栏和任务栏播放控制。
• 修复 Windows 托盘面板高度计算和定位问题，避免播放控件被裁切；补全上一首、下一首按钮的显示。
• 调整本机服务端口的复用方式，改善应用重启后设置、曲库选择及播放状态无法延续的问题。

下载与安装

系统	选择的安装包
macOS，Apple Silicon（M 系列）	CoCo-Music-0.0.1-mac-arm64.dmg
macOS，Intel	CoCo-Music-0.0.1-mac-x64.dmg
Windows，x64	CoCo-Music-0.0.1-win-x64-Setup.exe
Linux，x64	.AppImage 或 .deb

macOS 同时提供 ZIP。SHA256SUMS.txt 包含所有安装包的校验值。

已知限制

• 当前为早期版本，各系统与音乐平台的兼容性仍需持续验证。
• macOS 尚未经过 Apple Developer ID 签名与公证，Windows 尚无发行者签名，首次运行可能出现系统提示。安装说明见 README。
• 本项目为独立第三方客户端，歌曲播放、试听范围、音质与账号功能受对应平台、地区和账号权益限制。

采用 GPL-3.0-only 许可，Copyright © 2026 markcxx。