添加

1. 浏览器完整 Cookie 登录：网易云公共账号粘贴完整 Cookie（含 MUSIC_U）一键登录，登录弹窗双标签页【扫码登录】/【Cookie 登录】 Cookie 登录教程内嵌：登录弹窗内直接显示 3 步精简教程，不再依赖外部文档 Cookie 登录引导提示：登录弹窗黄色提示"扫码登录不太稳定，Cookie 登录更加稳定"
2. 失败歌曲黑名单：代取失败（VIP/无版权）歌曲自动跳过，随机音乐室不再连点失败歌误触发清号
3. 多档位播放尝试：standard→higher→exhigh→lossless 逐档尝试，VIP 用户高码率更易成功
4. 播放列表 HUD：显示未来 N 首歌曲（默认 8，可调 2-16），置于歌词下方，替代原"下一首"显示
5. 播放列表显示开关：可开关 HUD 播放列表（默认开启）
6. 播放列表数据格式切换：歌名+歌手 / 仅歌名 / 仅歌手 三态循环
7. 音乐室就绪门控：服务端进入准备期等全员下载就绪（5 秒超时兜底）后统一开播——所有客户端从 0 秒起播、进度天然统一
8. T-5s 提前预下载：歌曲结束前 5 秒限速预下载下一首，切歌无缝衔接
9. 单飞预下载管理器：同时最多 1 个下载任务 + 1 个待启动（HIGH 抢占中止 LOW），防连续跳歌堆积后台死线程
10. 随机音乐室一次补 2 首：下一首提前入队，客户端可提前预下载
11. 渲染顺序诊断（MBDBG）：运行时记录缓冲提交/落屏顺序日志，定位弹窗透字机制
12. neoforge mixin 支持：neoforge 1.20.1/1.21.1 接入 mixin 体系（mods.toml + refmap）
13. 面板 HUD 样式（试验）：一体化半透明深色面板（124/125 添加，126 已删除）

修复

1. 修复公共账号网易云账户频繁掉线：校验风控误判不再清号；代取失败语义三分类（无版权/VIP 权限≠登录失效）；酷狗跳过周期校验；跨平台兜底失败不计数
2. 修复公共账号被他人误登出：登出仅限登录者本人（含 OP 拒绝），ownerUuid 持久化世界存档（重启后仍识别登录者）
3. 修复 VIP 歌曲无法播放：cookies 同步竞态（登录包与 cookies 包背靠背连发被节流丢弃）——独立节流表 + 首次同步不节流
4. 修复 Cookie 登录体验：教程不显示（改内嵌）、按钮文字残留"扫码登录"、弹窗点击/渲染坐标错位、登录按钮点不到
5. 修复音乐室中途加入听不到当前歌：迟到播放保护（已切歌放弃旧播放）+ 周期对齐 seek 冷却 30 秒 + 收敛阈值
6. 修复首次播放卡顿：预缓存取消限速，全速下载
7. 修复播放从 5 秒左右开始：playStartTime 改为首次真正写入音频设备时重置（消除解码/设备打开延迟）
8. 修复"有概率从中间放"：非加入窗口异常大 seek 拦截（>30% 从头播放）+ 同步失败清理 seek 残留标记
9. 修复新歌从 5-7 秒开始：延迟 seek 补偿客户端下载耗时（v130 撤销，恢复多客户端精确同步）
10. 修复随机室歌曲从 3-5 秒开始：pausedSongId 校验——仅暂停歌曲与当前一致才回拨进度，换歌/删歌清零残留
11. 修复中途加入无法播放：加入宽限期（10s→30s）；防假切歌双重播放；迟到守卫追加 isPlaying 校验；songUrl/addedBy 全字段复制（VIP 歌取不到 URL）
12. 修复播放后同步卡顿：起播即对齐（本地时钟=服务端 playStartTime，内容按进度字节定位）+ 15 秒启动稳定期
13. 修复播放列表不足 N 首循环重复显示：仅显示实际剩余曲目
14. 修复歌词与播放列表重叠：drawLyrics 改为返回实际行数，按实际行数布局
15. 修复镜像模式 HUD 拖拽反向：命中判定/占位预览与镜像渲染方向统一

优化

1. 优化代取成功率：多档位尝试 standard→higher→exhigh→lossless
2. 优化黑名单机制：仅无版权/VIP 权限失败入列，登录错误不入；上限 5000；曲库 24h 刷新清空
3. 优化失败判定提速：无版权歌（st=-200）提前返回，不再浪费高档位请求
4. 优化掉线定位：清除公共账号时打印调用堆栈（前 6 帧）+ 细分掉线原因文案
5. 优化版本显示：设置页版本号硬编码改动态读取 mod 元数据（UI 与实际 jar 永远一致）
6. 优化播放列表体验：移至歌词下方、数量 2-16 可调、数据格式三态切换
7. 优化后续歌曲衔接：T-5s 提前预下载下一首（限速 2.5MB/s，URL 缺失先取后重试）
8. 优化下载线程管理：单飞预下载管理器（HIGH 抢占 LOW、单槽位、中止清理、防二次下载）
9. 优化随机音乐室节奏：服务端一次补 2 首入队，下一首提前可知
10. 优化版本管理：六工程版本号统一（gradle.properties 与全部元数据同步）
11. 优化六工程同步机制：v123 起全部修改批量同步六工程（不同反编译风格手工适配）

删除

1. 移除 30 分钟定时登录态校验（普通账户 + 公共账号）——"无故掉线"直接来源，仅保留网易云 3 天自动续期
2. 移除 lastFetchFailType 共享失败类型字段（netty 线程与 tick 线程并发竞态）
3. 移除 HUD 简洁/卡片/紧凑/CD 四种样式（仅保留默认样式）
4. 移除 HUD"下一首"显示（改为播放列表 HUD）
5. 移除面板 HUD 样式（renderStylePanel，HUD 仅保留默认，其余样式待后续版本添加）

优化

1. 随机音乐室秒播 服务端启动时后台预加载随机音乐室曲库，进入随机音乐室立即开始播放，不再需要等待约 1 分钟的榜单拉取。
2. 点歌优化
3. 登录体验优化，登录公共账号后，音乐室界面立即显示账号昵称与 VIP 状态，重新连接服务器后自动恢复登录状态

修复

1. 修复登录后界面可能崩溃: 扫码/手机登录成功瞬间可能导致游戏崩溃（界面渲染冲突）
2. 修复所有音乐室点歌静默失败 点歌后聊天栏显示"已点歌"但实际没反应的问题已修复。
3. 修复公共账号频繁掉线 优化网易云公共账号登录态校验逻辑，显著降低挂机播放中"掉账户"概率。
4. 修复酷狗收藏/歌单无法点歌 修复酷狗"我的收藏"歌曲 id 解析缺失导致点歌全部失败的问题

修复（2.0.0-045之前所有版本均有此问题，本次根治）

1. 修复公共账号在播放几首歌后无缘无故掉线的问题 2.0.0-045之前版本的效验均没有附带csrf_token，感谢各位服务器的测试反馈 网易云"查账号"接口（account/get）对服务器请求风控严格，误判"请重新登录"（返回 301）——现已在请求中附带 csrf_token 凭证，降低被误判概率 即使仍被误判，会改用 /api/login/status 接口二次确认，确认仍处于登录态则不掉线 必须连续 2 次校验失败才会清除公共账号，单次网络波动/风控不再误杀 登录成功时重置校验计时器，避免"刚登录就被查岗误杀" 校验失败时在服务端日志打印原因（code），便于后续定位
2. 修复公共账号登录态校验与播放歌曲 cookie 不一致导致误判的隐患（统一为同一凭证来源）

添加

1. 版本检测提示：进服自动比对客户端与服务端 MusicBridge 版本，不一致时彩色提示并附 mc百科下载链接（可点击）
2. 随机音乐室：常驻音乐厅，服务端自动顺序播放网易云四大榜单（飙升/热歌/原创/新歌，每日刷新），玩家可跳过但不可点歌
3. 下一首预缓存：点歌后立即限速预下载到本地缓存，切歌无缝衔接、减少跳过开头几秒
4. 服务端字段安全校验：房间名/歌曲字段长度上限 + § 格式码过滤 + 歌曲 URL 仅允许 http/https
5. 公共账号登录与更新操作频率限制（同玩家 5 秒节流）
6. 本地音乐底部栏增强：显示"来源：本地音乐"、进度/暂停/恢复/停止完整操作

修复

1. 修复公共账户频繁掉登录的问题（服务端 15 分钟周期校验、连续 3 次失败才失效、客户端 3 秒二次确认、打开音乐界面强制刷新登录态）
2. 修复设置关闭"无音乐播放时自动播放原版歌曲"后进游戏仍播放原版音乐的问题（覆盖全部启动路径）
3. 修复音乐室点歌列表中榜单与歌单只显示前 20 首的问题
4. 修复酷狗账号登录后"我的歌单"点进去全部显示无歌曲的问题（歌单 ID 参数修复）
5. 修复未安装 Node.js 时打开酷狗歌单崩溃的问题（getAccountInfo 空值保护）
6. 修复公共账号 VIP 状态显示与实际不一致的问题（服务端独立校验，不被客户端错误值覆盖）
7. 修复切歌瞬间客户端跳过歌曲开头几秒的问题（预缓存下一首）
8. 修复进入/退出音乐室后本地音乐误自动播放、底部栏残留显示音乐室歌曲的问题
9. 修复音乐室模式下底部栏停止/上一首/下一首按钮仍可操作的问题
10. 修复按键设置中修改的按键失灵的问题（快捷键注册/清除按键/重置默认全链路修复）
11. 修复歌词颜色修改后重进游戏恢复默认白色的问题（配置持久化）
12. 修复 HUD 位置调整界面部分样式无法拖动的问题（坐标基准/镜像模式/卡片高度）
13. 修复 1.20.1 选项界面"音乐配置"按钮与"完成"按钮重叠的问题
14. 修复恶意网络数据导致客户端/服务端崩溃或 OOM 的问题（字符串长度/可读校验、数量钳制、超限返回空包）
15. 修复广播包超限导致服务端崩溃的问题（捕获 EncoderException）
16. 修复任意玩家可覆盖公共账号登录状态的问题（登录者 UUID 绑定 + 登录者变更全员广播）
17. 修复服务端重启后公共账号 owner 丢失导致校验绕过的问题（owner 未知时强制仅管理员可操作）
18. 修复酷狗歌曲在网易云公共账号下无法播放的问题（平台错配校验）
19. 修复客户端播放本地音乐会顶掉音乐室歌曲的问题（播放来源统一分发）

优化

1. 优化网易云登录态自动续期（每 3 天 refresh token，续期失败不再立即登出）
2. 优化 HUD 歌词显示（多种样式、镜像模式、预览区域拖拽）
3. 优化服务端网络包解析防护（readString 长度/可读校验全链路覆盖）
4. 优化日志输出（清除 token/cookie 等敏感信息打印）
5. 优化本地音乐与联网音乐播放逻辑（统一 EntrySource 播放核心，按来源分发接续）
6. 优化服务器酷狗 VIP 校验（纯 Java 直连酷狗服务器验证，不依赖 Node.js 代理）

删除

1. 移除本地音乐、联网音乐两个独立快捷键（整合为"音乐配置"）
2. 移除本地音乐列表中的"启用"按钮（本地音乐默认启用）