Repository navigation
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 和项目发布信息核对来源。