메뉴
Pure-music Windows 本地音乐播放器项目专属 skill。Flutter/Dart 前端 + Rust 后端（lofty 读标签、flutter_rust_bridge FFI）。 歌词引擎同时支持 TTML、LRC、增强 LRC。当你需要修改项目代码、理解架构、添加功能或修复 bug 时务必使用此 skill。 包含核心架构图、播放页性能预算、关键模式、命名约定和反模式清单。所有与 pure-music 项目相关的开发任务都应参考此 skill。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | puremusic-dev |
| description | Pure-music Windows 本地音乐播放器项目专属 skill。Flutter/Dart 前端 + Rust 后端（lofty 读标签、flutter_rust_bridge FFI）。 歌词引擎同时支持 TTML、LRC、增强 LRC。当你需要修改项目代码、理解架构、添加功能或修复 bug 时务必使用此 skill。 包含核心架构图、播放页性能预算、关键模式、命名约定和反模式清单。所有与 pure-music 项目相关的开发任务都应参考此 skill。 |
lib/
main.dart -- 入口：初始化 Rust、设置、窗口
entry.dart -- MaterialApp.router + GoRouter + ThemeData
core/
settings.dart -- AppSettings 单例，手动 JSON 序列化
theme.dart -- ThemeProvider (ChangeNotifier)，种子色管理
preference.dart -- AppPreference 单例，播放相关偏好
lyric_controller.dart -- LyricViewController
lyric_render_config.dart -- LyricRenderConfig (immutable)
enums.dart -- ThemeOption, NowPlayingBackgroundMode 等
component/ -- 通用可复用组件
library/ -- 音频库、播放列表
lyric/ -- 歌词引擎 (LRC / TTML / 增强 LRC)
native/ -- Rust FFI 绑定 (flutter_rust_bridge 生成)
page/
now_playing_page/
page.dart -- part，_NowPlayingPage 主入口
large_page.dart -- part，大尺寸布局
small_page.dart -- part，小尺寸布局
immersive_page.dart -- part，沉浸模式
component/ -- 歌词 UI 集中在此
settings_page/ -- 设置页
uni_detail_page.dart -- 歌曲详情页
play_service/ -- 播放/歌词/桌面歌词服务
services/ -- 其他服务
rust/
src/
api/ -- flutter_rust_bridge API 函数
extract_color.rs -- k-means 颜色提取
tag.rs -- lofty 读/写标签
page/now_playing_page/component/play_service/core/lyric_render_config.dartcore/settings.dartcore/theme.dartrust/src/api/reference/player-performance.mdSymbols.xxx（material_symbols_icons），不动态解析字符串LyricRenderConfigAppSettings.instance.xxx — 单例 mutable fields，手动 JSONAppPreference.instance.xxx — 单例ThemeProvider ChangeNotifier，Provider 下发LyricRenderConfig（@immutable + copyWith），通过 LyricViewController.renderConfig + context.watch封面色（Rust k-means）> 系统色。_lastAlbumSeedColor 在切模式时优先保留。
只改前景色，不改背景色：
final useMonet = AppSettings.instance.useMaterialYouForControls;
final scheme = Theme.of(context).colorScheme;
color: useMonet ? scheme.primary : scheme.onSurface,
@immutable + copyWithColor.withValues(alpha:)，不用 withOpacitypackage:flutter/physics.dart），固定时长只用于 opacity/blurdidUpdateWidget 中响应变化build 中触发动画或副作用SizedBox.shrink()）mountedpositionStream 订阅、短周期 Timer.periodic 或独立常驻 Ticker；先复用现有离散同步信号、共享帧时钟和本地 StopwatchsetState 重建整页；动态内容优先通过 CustomPainter 的 repaint 更新dispose 时必须停止或解绑完整检查表见 reference/player-performance.md。
flutter build windows --debugprovider 6.x — 状态管理go_router 17.x — 路由flutter_rust_bridge 2.12 — Rust FFImaterial_symbols_icons — Symbols 图标flutter/physics.dart — 弹簧物理动画sqlite3 — 存储PaletteGenerator（用 Rust k-means）withOpacity/withAlphaapplyThemeOption 里重读系统色forward()/reverse()（用 SpringSimulation.animateWith()）initState/build 调用 readFromJson()