Nightly v1.5.4-nightly-2026-10-18-0159

由 GitHub Actions 定时构建的 Nightly 版本：v1.5.4-nightly-2026-10-18-0159

v1.5.3-preview-watch-hotfix1

Hotfix 1：修复三星 Watch4 Classic（One UI 8.0 / Wear OS 6.0）启动闪退

修复

• 移除旧版 Google Play Core，修复 Android 14+ SecurityException 闪退
• 前台播放服务在 Android 14+ 显式声明 mediaPlayback 类型
• 原生库按 16KB 内存页对齐，适配 Wear OS 6（Android 15+）
• 完善 release 混淆 ProGuard 规则，防止插件原生类被剥离

新增

• 日志导出界面（设置 → 导出日志），一键导出完整日志
• 包含设备信息 + Android logcat + Flutter 日志 + 磁盘历史日志
• 提供电脑/手机/USB 三种取回方式指引（甲壳虫ADB助手/LADB/Bugjaeger）

下载

• ngskg-watch-v1.5.3-hotfix1-arm64-armv7.apk（67MB）— 同时支持 arm64-v8a 和 armeabi-v7a 架构，安装后系统自动选择匹配架构运行，无需用户选择

版本信息

• versionCode: 251（高于旧版 21，可正常更新）

NGS-KG+ Watch v1.5.3-preview-watch

NGS-KG+ Watch v1.5.3-preview-watch

Wear OS 手表版全新重设计

播放器（Cassette 风格）

• 圆形渐变淡出封面（FadedAlbumArt）+ 双弧进度/音量指示器
• 进度弧可拖动 seek，拖动中弧线加粗提亮（MD3 动画反馈）
• 表冠直接控制音量；双击播放/暂停；左右滑切歌；上滑进歌词
• 歌名/歌手顶部居中，控制按钮底部居中，角落图标统一偏移
• 方屏适配：圆角封面 + MD3 Slider 进度条
• 专辑封面调色板驱动 UI 配色

歌词

• KRC 优先 + LRC 降级（移植自安卓端，KrcLyricUtil 解析）
• 逐字时间轴精确对齐，翻译开关（右上角图标）
• 焦点行居中滚动，点击歌词行跳转播放进度
• 表冠滚动 + 边缘渐隐效果
• 修复 base64 编码歌词乱码问题（utf8.decode）

四主视图

• 聆听：正在播放速览卡片 + 快捷入口
• 发现：搜索 / 私人 FM / 排单
• 音乐库：歌单 / 收藏 / 本地 / 队列
• 设备与我：账号 / 音质 / 音频输出 / 关于

搜索

• 删除语音搜索，改为键盘输入
• 进入页面自动唤起输入法
• 300ms 防抖自动搜索

音频缓存

• 边播边缓存：流式播放同时后台下载，下次秒开
• LRU 容量管理（上限 300MB）
• 设置页支持清除缓存并显示缓存大小

系统能力

• 切歌立即停止上一首（_player.stop()）
• MediaSession + MediaStyle 通知（锁屏/蓝牙控制）
• Wear Tile（系统磁贴显示播放状态）
• 音频输出设备枚举/切换/蓝牙 A2DP 监听
• Ambient Mode（息屏纯黑 + 时间 + 歌名 + 细进度线）
• 旋转表冠：列表滚动 / 主视图翻页 / 音量控制
• 首次启动引导（两页交互教程）

其他

• 修复 AnimationController 重复 dispose 崩溃
• 修复引导页底部溢出
• 修复快捷面板按钮溢出
• 修复搜索框点击无响应
• ErrorWidget 颜文字替换为图标
• 版本号 v1.5.3-preview-watch

下载

• app-release.apk — arm64-v8a Release（53.2MB）

NGS-KG+ v1.5.2-preview Nightcord Android

v1.5.2-preview（2026-08-05）

修复

• 播放/暂停状态反转：显式同步 isPlaying 状态，解决 UI 与系统媒体控制播放/暂停状态颠倒的问题

---

v1.5.1-preview（2026-07-29，含 hotfix1）

新增

• 本地音乐架构重构：首次启动全量扫描（内嵌封面提取），后续扫描走缓存；过滤 .kgg 加密文件，MD3E 风格无封面回退图标
• 内嵌歌词提取：从 ID3v2 USLT / FLAC VorbisComment 提取本地音乐歌词，修复 LRC 检测与编码
• 外部音频播放：支持通过系统文件选择器 intent 播放外部音频文件 + 自定义删除
• 媒体通知迁移：原生 PlaybackService → audio_service（MediaSession + MediaStyle），通知使用系统原生媒体按钮图标
• API 路由检测：自动探测可用 API 路由并隐藏原始 URL，支持远程配置地址回退
• 更新公告系统：多版本 CDN 公告系统 + 更新检测器修复
• M3 Expressive 改造：发现页快捷入口 2×2 圆角网格、播放器浮动媒体胶囊、个人页 2×3 网格、继续播放卡片折叠动画

变更

• 全局 Material Design 3 交互标准升级：核心屏幕与组件全面合规
• 动态底部内边距注入：MiniPlayer 自动避让 + 安全路由自动隐藏，导航栏不再遮挡
• 个人页精简：间距压缩，点赞数改为与服务器 trackCount 同步
• API URL 隐藏：设置页不再暴露原始 API 地址

修复

• MiniPlayer 底部溢出：ErrorWidget 高度自适应 + FittedBox 弹性约束，消除黑色块渲染异常
• 导航栏遮挡/迷你栏溢出：底部物理间距 spacer + AnimatedPadding 平滑过渡
• 低端设备性能：减少 PlayerScreen 重建、暂停后台 ticker、收紧图片/列表缓存
• 后台播放被杀：androidStopForegroundOnPause=false，暂停时后台服务不再被系统回收
• 上一首残留：切歌时清理旧音频与加载 UI
• Hi-Res 标识开关失效：新装默认关闭、升级用户保留开启
• KRM 作者校验：按名称匹配验证作者，hash 对比防止显示错误歌手
• AppShell 覆盖层崩溃：改用 navKey.currentContext 导航
• 通知图标：替换系统 drawable 引用为矢量图标 + 异步错误日志

---

NGS-KG+ v1.5.2-preview Nightcord Windows

v1.5.2-preview Windows（2026-08-05）

新增

• 歌曲下载系统：全新 DownloadService + 下载管理页,支持正式下载(写 ID3v2/FLAC 元数据与 KRC 歌词)与「先播后缓」播放缓存(2GB LRU 上限),支持仅 WiFi 下载
• Windows 本地音频 HTTP 桥：just_audio_windows 不支持 file:// 源,新增本机 HTTP 服务(Range 断点)播放本地/缓存文件
• 纯 Flutter 桌面歌词：AMLL 风格桌面歌词视图(纯 Dart 实现)与 flutter_lyric 桌面版,移除 AMLL webview 方案
• 系统托盘：托盘图标随播放状态切换(播放/暂停),支持播放控制操作
• 自定义窗口标题栏：应用图标 + 当前歌曲信息 + 窗口控制按钮,支持拖拽移动与双击最大化
• 桌面播放队列面板：队列/顺序/循环控制
• 播放器扩展面板：歌词/音效/定时关闭
• 本地音乐扫描面板：M3 卡片样式,实时显示扫描进度,支持取消
• 云盘歌曲归一化：兼容酷狗 audio_info / album_info / trans_param 嵌套格式,统一字段输出
• adaptive_palette 本地 fork：修复流体背景 12s 循环边界的旋转跳变

变更

• AMLL webview 移除：删除 amll_web/、assets/amll/、amll_webview_manager、krc_parser、ttml_generator 等旧方案代码
• 播放引擎重构：播放请求版本控制(切歌竞态防护)、本地缓存优先(零流量播放)、URL 过期断点续播
• 桌面播放器重构：桌面全屏播放器、底部播放栏、桌面 Shell 大幅重构
• 应用图标更新：新版高清图标,托盘图标独立

基础设施

• 新增依赖：phonic(元数据写入)、audio_metadata_reader、adaptive_palette(本地 fork)
• 新增测试：local_audio_server_test、metadata_reader_test
• Windows 安装包脚本 packaging/installer.iss(Inno Setup,中英双语)

---

NGS-KG+ v1.5.0-preview Nightcord

v1.5.0-preview (Nightcord 2.0.0 预览版)

这是 NGS-KG+ 首个全平台预览版，包含 Windows、Linux、Android 和 Android Watch 四个平台。作为 Nightcord 2.0.0 的预览版本（代号来源于 QQ 群投票，至于为什么选这个，我们也不知道）。从 v1.0.1 以来累计了大量功能开发和重构。

本版本是什么

• 播放引擎从 just_audio 换成了 media_kit，底层能力更强
• 桌面端 UI 全面重写：新的侧边栏导航、DesktopShell、MD3 动效和主题系统
• 新增播放队列管理、歌词增强、歌单收藏与多选操作
• 集成了 Navidrome 服务端支持
• Windows 端做了系统托盘、文件关联、协议处理器、SMTC 等桌面集成
• Linux 端从 Android 分支移植了播放功能，修复了大量桌面适配问题
• Android Watch 端新增搜索、播放器、设置页面

构建产物

Android

架构	文件
arm64-v8a	NGS-KG-arm64-v8a-release.apk
armeabi-v7a	NGS-KG-armeabi-v7a-release.apk
x86_64	NGS-KG-x86_64-release.apk

Windows

架构	文件
x64	ngskg-plus-windows--debug.zip / ngskg-plus-windows-release.zip / ngskg-plus-windows-x64.msix

Linux

格式	文件
.deb	ngskg-plus_1.5.0_amd64.deb
.flatpak	ngskg-plus.flatpak
PKGBUILD	PKGBUILD

Arch Linux 用户：AUR 暂停注册，请使用 Release 中的 PKGBUILD 本地构建：

git clone https://github.com/Tangmjiu/NGS-KG.git --branch linux-desktop
cd NGS-KG
makepkg -si

Android Watch (Wear OS) — Lite

架构	文件
arm64	NGS-KG-watch-release.apk

Watch 版为精简版，功能较少。需配合 Android 手机使用。

已知问题

• 部分功能运行会有异常

NGS-KG+ v1.0.1 （Only Android)

NGS-KG+ 更新日志

新增

#请注意，本次更新包名已更改，请卸载旧版本后重新安装

• Apple Music 风格动态流光播放器背景：HSL 色彩空间 8 色斑流动光效，5s 循环 + 大半径高斯模糊柔光混色
• MD3 设计令牌系统：AppShape（xs/sm/md/lg/xl/full 圆角体系）、AppMotion（标准/强调/减速/舒缓时长与缓动曲线）、AppBreakpoint（compact/medium/expanded 响应式断点）
• 跨平台更新检测器：通过 GitHub Releases API 检查最新版本，识别 Android ABI（arm64-v8a / armeabi-v7a / x86_64）并下载对应 APK
• 音质设置独立子页面：原 WiFi/蜂窝/下载三套独立音质设置移入独立子页面，设置组按「播放」「音频」「更新」「关于」重新组织

变更

• Android 包名迁移：com.kugou.ngskg → com.mjiutang.ngskg
• 版本管理统一：build.gradle 从 pubspec.yaml 读取版本号，单一源消除漂移
• 通知歌词纯文本：移除通知标题中的「♪」前缀
• 后台服务保活：切换为 START_STICKY + 状态持久化，防止进程回收后静音
• MIT 许可证：项目根目录添加 LICENSE

修复

• 流光背景颜色区域重叠 → per-blob 独立锚点 + 明度钳制 [0.12, 0.85]
• 锁屏歌词切换延迟 → 流光周期从 10s 优化为 5s
• 排行榜底部溢出 49px（SafeArea 适配）
• 日志详情行溢出 8.5px（itemExtent 64→72）
• 发现页集合字面量语法错误（内联变量表达式）
• 播放历史 API pagesize 不足导致数据缺失

NGS-KG+ v1.0.0 （Only Android)

NGS-KG+ 更新日志

新增

• 歌词引擎迁移至 flutter_lyric：KRC 解析后直接构造 LyricModel，逐字卡拉 OK 时序 100% 保留，零字符串格式转换
• Android 通知栏歌词：Media3 系统媒体控件现在正确显示当前歌词行（标题 = ♪ 歌词，正文 = 歌名 - 歌手）
• 歌词行切换动画：进入/退出行缩放 + 颜色过渡
• 歌词顶部/底部渐隐：视口边缘半透明渐变
• API 请求静默降级：专辑/歌单列表先试 pagesize=1000，502 不弹窗自动降级重试

修复

• 播放器通知不显示歌词（Kotlin 侧 lyricLine 参数未存储/使用）
• 逐字卡拉 OK 效果不可见（activeStyle.color 与 activeHighlightColor 同为白色）
• 拖拽进度条后进入歌词页焦点丢失
• 发现页私人 FM 列表为空（Song.fromJson 不兼容酷狗数据格式）
• 发现页「播放全部」触发全页刷新
• 专辑/歌单列表因缺少 pagesize 参数返回空结果
• 歌单列表 gid 字段缺失拼错 gcId
• 专辑详情页 songCount 显示为 0

移除

• 乐库电台（/yueku/fm）UI 及代码
• 自建歌词模型/渲染/视图（LyricLine/LyricSpan/LyricLinePainter/AMLyricsView）

已有 UI 但未实现的功能

功能	状态
MV/视频播放	搜索中有 MV 类型选项、歌手页有 MV 选项卡、路由中有 MvPlayerScreen，但所有后端代码已注释暂停适配
私人 FM（猜你喜欢）	发现页有 UI 入口和「播放全部」按钮，但 /personal/fm API 端点可能因服务器节点不支持而失效
网络类型检测	_isWifi 硬编码返回 true，未接入 connectivity_plus，WiFi/蜂窝独立音质设置无法按实际网络生效
收藏检测	暂未实现
MD3合规化	（没做就是没做）