v0.2.2

小版本：均衡器、命令面板、音量归一化三块功能，外加性能与测试稳定性修正。

播放器功能

• 均衡器自定义：设置页 / 满屏播放器里调出十段滑杆（31 Hz ~ 16 kHz，
  ±12 dB），另存为最多 8 套命名预设；六套内置预设仍在（#752）。
• ⌘K 命令面板：一个键（⌘K / Ctrl+K）打开可搜索命令列表，收藏当前歌曲、
  切播放模式、显隐主窗、开队列抽屉等命令都进得来；新命令同步进快捷键设置
  两列（#752）。
• 音量归一化增强：本地 FLAC / MP3 / M4A 文件直接读内嵌 ReplayGain 标签，
  不必再实时量；实时量出的响度按曲目缓存，同一首二次播放直接用。新增
  「增益提升」开关——打开后把过轻的歌也抬到目标响度（带真峰值 -1 dBTP
  限制），关着维持「只压不抬」（#752）。

性能与测试

• 播放队列 500 项时重建从 ~12.5 万次比较降到 O(n)；封面 Tint 每帧不再取
  整份快照；顺序写缓存的区间合并走 O(1) 快路径（#752）。
• 音频/锁慢测试并行化与素材缩短，CI 上「等文件头空转」判据换成 CPU 占比，
  慢机器不再误报（#752）。

v0.2.1

PudMusic v0.2.1

布丁音乐（PudMusic）桌面音乐播放器版本发布。

• 发布日期：2026-11-03
• 发布提交：1122ed5
• 变更范围：v0.2.0..v0.2.1

版本说明

小版本：收藏夹管理、播放续播、歌词可靠性三块，外加两处界面修正。

收藏夹

• 侧栏收藏夹右键「隐藏」之后，能从设置 → 菜单设置 → 收藏夹放回来（#747）；
  在 B 站删掉的收藏夹，设置里那笔隐藏的 id 也能清掉。
• UP 主删除或设为私密的收藏夹条目留一行置灰的「已失效」，不再凭空消失；
  B 站恢复可见后刷新一次能回来（#748）。

播放与歌词

• 断点续播：关掉应用再开，正在放的那一首从上次停的地方（回退 3 秒）
  接着放（#748）。
• 歌词缓存按「曲名 + 歌手」校验，同名翻唱、换源之后不再串词（#748）。

界面修正

• 「我的关注」卡片之间的缝和卡片同色，不再是一道道深沟（#749）。
• 修复 internal/e2e 编译挂导致的 CI 一路红（#749）。

本次变更

• 代码变更提交：10 个
• 功能（feat）：1 个
• 修复（fix）：0 个
• 文档（docs）：1 个
• 测试（test）：0 个
• CI/构建（ci/build）：0 个

查看完整变更记录

下载

请按系统和架构选择下方资产；Release 页面中的资产标签会标明对应平台。自动更新清单由构建流程生成并随 Release 上传。

系统	架构	安装包	更新归档	自动更新清单
macOS	Apple Silicon（arm64）	pudmusic-0.2.1-arm64.dmg	pudmusic-0.2.1-darwin-arm64.tar.gz	update-darwin-arm64.json
macOS	Intel（amd64）	pudmusic-0.2.1-amd64.dmg	pudmusic-0.2.1-darwin-amd64.tar.gz	update-darwin-amd64.json
Windows	x64（amd64）	pudmusic-setup-0.2.1-amd64.exe	pudmusic-0.2.1-windows-amd64.tar.gz	update-windows-amd64.json
Windows	ARM64	pudmusic-setup-0.2.1-arm64.exe	pudmusic-0.2.1-windows-arm64.tar.gz	update-windows-arm64.json

安装包未进行 Apple 公证或 Windows 代码签名。

校验

下载后请通过文件大小、GitHub Assets 和项目发布信息核对来源。

v0.2.0

PudMusic v0.2.0

布丁音乐（PudMusic）桌面音乐播放器版本发布。

• 发布日期：2026-11-03
• 发布提交：ab76fea
• 变更范围：v0.1.0..v0.2.0

版本说明

界面、播放、下载与无障碍各一块的整体推进，外加一轮 MyGo 升级（v0.6.2 → v0.7.4）。

首页与浏览

• 首页改为发现总览（#600），三个榜单页（热榜 / 原创榜 / 最近播放）接进来
  （#583）；「流行」档顶部新歌速递网格（#401）。
• 顶栏搜索框换成胶囊形 + 左对齐联想面板（#731）；空着的时候占位词轮换网易云
  热搜词（#640）；联想面板进场 200ms 过渡（#491）。
• 切 Tab 改成横向滑动，指示器和内容同起同落（#399、#443、#738）。
• 首页横幅自动轮播，按封面原比例显示（#603、#606）；要图档位修正，超宽窗口下
  横幅清晰度和内存占比都对（#676、#677）。
• 首屏加载态统一：稍后再看 / 历史 / 关注 / 动态四档都换成骨架屏
  （#580、#596、#598）。

列表、网格与复制

• 行标题那一列换成容器级 Selectable：单击选中、双击播放、右键歌单菜单、
  ⌘C 拖选复制整行（歌名 + UP 名 + 时长）都在（#728，#703 的 A 项）。配套的
  ⌘C 兜底（没拖选时复制选中行歌名）也留着（#698）。
• 评论正文改用框架 RichText：能拖选复制了（#708）；「只看提到歌名」档把
  命中的歌名高亮（#697）；昵称和歌单标题也能拖选复制（#698）。
• 列表行那条「看到哪儿」进度条换成框架 ui.Progress：读屏软件能读出
  「进度百分之几」了（#725，#703 的 C 项）。
• 播放条赞 / 收藏 / 评论三枚键各带一个数字读数，收成网易云式角标
  （#709、#736、#739）。
• 列表选中行的实心主色底去掉了，只留「正在播放」的高亮（#205）。

播放器

• 迷你播放器整体重做：320×100 置顶小窗（#192、#201），点封面展开歌词
  卷帘（#590、#614、#732），卷帘收尾不再跳 12px、拖窗缘弹簧不打架（#741）。
• 满屏播放器：封面落影与主色光晕（#579）、悬停反馈在暗底上看得见（#461）、
  封面静态 4:3 不转（#523）、分集抽屉（#343）、章节吸点（#594）、弹幕叠层
  （#610）、播放 B 站视频（#531）、频谱默认开（#525）、背景清晰度三档可选
  （#679）。
• 播放条：三键居中重排（#224、#231）、阴影对齐上游（#227）、评论键带数字
  （#695）、进度条悬停才上色（#225）、按压缩放 0.96（#447）、左下三枚读数
  角标（#736、#739）、睡眠定时（#519）、隐藏播放键提示（#512）。
• 空格键在哪都能切播放/暂停（#524）。
• 音量归一化（EBU R128，可选，#521、#522）；轨道淡入淡出（0-15s，#528）；
  10 段均衡器（预设，#529）。

队列与播放

• 队列能重排（item 级），随机改洗牌袋（#380、#466、#427）；按过暂停不再
  卡住（#372）。
• 队列与播放位置落盘：重启后停在原位且暂停（#356）；倍速也跨重启（#518）。
• 点一首歌照上游：已在队列就定位，不在才追加（#617）。
• 长按封面 2.5 秒一键三连，松开早了不算点击（#694）；连播遇到失效稿自动跳
  下一首（#551）；播放条长按 B 站式抖动 + 封面环转（#638）。
• 失效的条目在收藏夹里标出来、取流前就跳过（#635）。
• 多 P 视频：cid 回写、分集身份、合集系列接口（#696）；分集抽屉（#343）。

评论

• 评论区独立页 /comments（#618）；改右侧抽屉（#710）；面板盖住底下的播放条
  （#734）；「评论」档翻页 mode=1（#607）。
• 楼中楼点开有反应了（#685）；正文可展开（#710）；B 站评论接口 + 缓存 +
  退避三层都接上（#586、#597、#605）。

下载与缓存

• 在线音频字节落盘缓存：来回切歌不再走网络（#704）；键跟着入口变导致
  永不命中的两处修正（#727）；跨启动断点续传、换档收养、引用计数保护
  （#730）；滚动过期（#707）；多轮对抗性审查的修正（#729）。
• 下载记录页一格画崩了不再整页错误（#411）；下载默认目录改到音乐目录下的
  应用子目录（#383）；下载队列旧版迁移修正（#711）。
• 封面按显示尺寸要图：内存省 20 倍，解码 37ms 也省了（#622）；歌单页头图
  取色改下小图（#626）；封面内存上限可配 + 8.3MB 瞬时分配去掉（#507）。
• MP3 换 tphakala/go-mp3（MPEG-2.5 与 LAME 头，#272）；Ogg/Vorbis 接上
  （#266）；go-m4a 升 v0.8.0（#278）；mfadec 接进 Windows 解码器接口（#271）；
  extaf 短读 bug（#328）。

系统集成

• macOS 菜单栏七栏 + 状态栏图标改成播放器形状（#719）；关于 / 设置菜单项
  （#544）。
• 系统通知（可选、低频，#587）。
• 系统媒体会话全平台（macOS / Windows）。
• 开机自启、单实例锁、托盘、文件关联（#565）、音频文件拖到图标上能开
  （#565）。
• 签名身份稳定，钥匙串只问一次（#505）；删掉钥匙串迁移代码（#517）。
• 代理设置真的接到全部出网请求上（#560）。
• 迷你播放器跟随指针所在显示器（#619）；不抢焦点（#192）。

无障碍

• 状态变化用 Context.Announce 播报（#348）；焦点指示补齐：搜索框、网格、
  侧栏折叠态（#462）。
• 「失败」和「没有」分开说（#464）；「暂停」和「停止」分得开（#342）；
  「正在放」那行有听觉差异（#343）。
• 列表行进度条带 RoleProgressIndicator 和 Label（#725）。
• 能点的看起来能点、不可逆动作看得出来（#465）。
• 同一时刻只出一枚悬停提示（#425）。

搜索、UP 空间与我的

• UP 空间整页布局对齐 Biu（#499），头图区跟着列表一起滚走（#513）；动态
  条目通栏 + 悬停棕带（#424）；列表里点作者名能进他的空间（#384）。
• 我的关注页左栏分组收成页头右上角的下拉（#737），分组列表按当前风格重做
  （#396）；卡片瘦卡 + 加列（#740）；行间距 16（#494）；看得清是方块小卡片
  （#423）。
• 听歌统计页：本机一份的时长、最爱听的歌、连续天数（#723、#722）；顶栏入口
  键的悬停反馈修复（#733）。
• 搜索失败给重试（#636）；收藏夹封面「首条失效」兜底（#699、#700）；收藏夹
  侧栏分组看得见了（#381、#422、#501、#516）。

工程与性能

• MyGo 一路升：v0.6.2 → v0.6.3 → v0.6.4 → v0.7.1 → v0.7.3 → v0.7.4
  （#196、#340、#533、#612、#684、#742）。Native UI E2E 接进（#684）。
• 整体性能：启动（#496、#653）、播放时不再每秒重建 20 遍（#612）、弹幕
  独立刷新（#683）、媒体内存边界（#683）、软内存上限 + 闲时归还（#532）、
  每帧分配一大批（#329、#333、#412、#441、#446、#466、#489、#654、#683）。
• 十二档帧预算按实测重写基线（#724）。
• 跑测试不再向扬声器放测试音（#553）；Windows CI 跑产品包（#277）；Windows
  AAC spike 别每个分支都跑（#459）；发布资产命名与校验统一（#662）。
• macOS 与 Windows 安装包；自动更新（查版本 / 更新日志 / 增量包 / ed25519）。

其他

• 设置页：主题预设 + 界面重设计（#357）、代理接到全部请求（#560）、两种分段
  控件归一（#274、#324）、主题预设分档（#534）、设置开关弹动反馈（#545）。
• 歌词：自动获取（#402）、滚到中间 200ms（#487）、搜索与缓存（#269）、旋钮
  上游 ⌀32 圆形图标（#389）。
• 错误一层「详情」：Friendly 那张表里的话不再被压成省略号（#350）；断流
  重连加退避（#336）；「可重试」的判据收一处（#354）。
• 本地音乐删除改系统废纸篓（#563）；HTML 实体解掉（#554）；侧栏收藏夹登录后
  自动拉（#381）。
• 文档：AGENTS.md 视觉审查规矩（#497）、间距 scale 表（#267）、令牌治理
  （#276）、文件大小规矩（#429）、没发版别写兼容逻辑（#430）。

---

本次变更

• 代码变更提交：198 个
• 功能（feat）：0 个
• 修复（fix）：6 个
• 文档（docs）：0 个
• 测试（test）：1 个
• CI/构建（ci/build）：0 个

查看完整变更记录

下载

请按系统和架构选择下方资产；Release 页面中的资产标签会标明对应平台。自动更新清单由构建流程生成并随 Release 上传。

系统	架构	安装包	更新归档	自动更新清单
macOS	Apple Silicon（arm64）	pudmusic-0.2.0-arm64.dmg	pudmusic-0.2.0-darwin-arm64.tar.gz	update-darwin-arm64.json
macOS	Intel（amd64）	pudmusic-0.2.0-amd64.dmg	pudmusic-0.2.0-darwin-amd64.tar.gz	update-darwin-amd64.json
Windows	x64（amd64）	pudmusic-setup-0.2.0-amd64.exe	pudmusic-0.2.0-windows-amd64.tar.gz	update-windows-amd64.json
Windows	ARM64	pudmusic-setup-0.2.0-arm64.exe	pudmusic-0.2.0-windows-arm64.tar.gz	update-windows-arm64.json

安装包未进行 Apple 公证或 Windows 代码签名。

校验

下载后请通过文件大小、GitHub Assets 和项目发布信息核对来源。

布丁音乐 v0.1.0

PudMusic v0.1.0

布丁音乐（PudMusic）桌面音乐播放器版本发布。

• 发布日期：2026-10-28
• 发布提交：ba42e2ea

版本说明

第一个版本。PudMusic（布丁音乐）是 Biu 的重写：界面由 MyGo 绘制原生 UI（即时模式，没有 webview），
音频在 Go 中解码，并通过 GitHub Actions 构建 macOS 与 Windows 安装包。

登录与账号

• 扫码登录，凭据放进系统钥匙串（macOS Keychain / Windows DPAPI）。只有扫码
  一种：密码登录和短信登录都要在 DOM 里跑第三方验证码 JS，原生 UI 做不出来，
  而为验证码开 webview 口子会推翻「整个应用不用 webview」的决定。
• 侧栏显示真实头像，未登录时显示未登录形态，「刷新数据」会真的重新拉一次收藏夹。
• 可以一键把 Biu 的设置导入过来。

首页、搜索与浏览

• 首页三个 Tab：音乐 / 鬼畜 / 流行，各接 B 站的一摊推荐；「流行」那一屏顶部还有
  一块「新歌速递」的横向网格（能左右翻页）。
• 搜索结果页 + 搜索联想词。
• UP 空间与动态流。
• 我的关注页：登录之后你关注的 UP 主会出现在这里。
• 列表与网格都有 hover 反馈和表头；列表是虚拟滚动的（音乐卡片按需创建）。

收藏夹与我的音乐库

• 收藏夹管理，支持合集与系列；封面会缓存下来。
• 清理失效内容与删除收藏夹。
• B 站音乐库条目（type=12）在收藏夹里点得开。
• 点赞与一键三连：长按封面 2.5 秒触发，播放条上有收藏星标。
• 收藏夹、下载、播放记录都会上报给 B 站——不是只存在本机。

播放

• B 站在线取流播放，音质可选：自动 / 无损 / 320K / 128K / 64K。
• 本地解码播放：FLAC、MP3、WAV、AIFF、AAC、M4A。其中 AAC 与 M4A 在 Windows 上
  解不了（还有 ALAC / M4S，README「已知边界」一节逐条写着；Windows 版目前能播的是
  无损 FLAC、MP3、WAV、AIFF）。
• 保调倍速：改速度不改音高。
• 播放模式四档：顺序 / 循环 / 随机 / 单曲。
• 满屏播放器，带频谱（radix-2 FFT，挂在变速层之前取源帧）。
• 迷你播放器：320×100 的置顶小窗，和主窗口共用同一份播放状态。
• 播放列表抽屉、分集抽屉（多 P 的投稿原来只能播第一集，现在播放条上点开
  分集列表就能切集）。
• 播放条上有封面缓存、UP 名跳转、下载按钮、播放态高亮。
• 歌词显示，以及歌词的搜索与缓存（搜索和预览两个弹窗）。

下载与本地

• 音频下载支持断点续传，视频下载音视频交织处理。
• 下载记录页，可按状态筛选；下载时把封面存下来。
• 本地音乐扫描与页面。

系统集成

• macOS 与 Windows 的系统媒体会话（锁屏、控制中心、Windows 任务栏缩略图）。
• 托盘、单实例锁、开机自启。
• 快捷键：应用内分发 + 全局注册，设置页里能录、能存、冲突看得出来。
• 主题每帧生效，启动时读设置并落盘；设置页完整。
• 网络封面缓存。

其他

• 自动更新：查版本、看更新日志、下增量包或全量包、验 ed25519 签名、
  原地换掉整个应用。界面是本项目自己画的。
• 二维码编码器从零实现 ISO/IEC 18004。
• macOS 磁盘镜像与 Windows NSIS 安装包。都不做代码签名、macOS 不做公证。

本次变更

• 代码变更提交：383 个
• 功能（feat）：4 个
• 修复（fix）：0 个
• 文档（docs）：0 个
• 测试（test）：0 个
• CI/构建（ci/build）：0 个

下载

请按系统和架构选择下方资产；Release 页面中的资产标签会标明对应平台。自动更新清单由构建流程生成并随 Release 上传。

系统	架构	安装包	便携归档	自动更新清单
macOS	Apple Silicon（arm64）	0.1.0.arm64.dmg	app-0.1.0-darwin-arm64.tar.gz	update-darwin-arm64.json
macOS	Intel（amd64）	0.1.0.amd64.dmg	app-0.1.0-darwin-amd64.tar.gz	update-darwin-amd64.json
Windows	x64（amd64）	Setup.0.1.0.amd64.exe	app-0.1.0-windows-amd64.tar.gz	update-windows-amd64.json
Windows	ARM64	Setup.0.1.0.arm64.exe	app-0.1.0-windows-arm64.tar.gz	update-windows-arm64.json

安装包未进行 Apple 公证或 Windows 代码签名。

校验

下载后请通过文件大小、GitHub Assets 和项目发布信息核对来源。