lib/
├── main.dart                      # 应用入口
├── api/                           # 网络层封装
│   ├── bili_client.dart           # 统一HTTP客户端
│   └── bili_exception.dart        # API/网络异常体系
│
├── components/                    # UI组件库
│   ├── auto_appbar.dart           # 自动导航栏
│   ├── common/                    # 通用组件
│   │   ├── background_blur_widget.dart  # 背景模糊组件
│   │   ├── cards/                 # 卡片组件
│   │   │   ├── common_music_list_tile.dart
│   │   │   ├── music_list_item.dart
│   │   │   └── playlist_card.dart
│   │   ├── landscape_cover_art.dart    # 横屏封面
│   │   ├── landscape_seek_bar.dart     # 横屏进度条
│   │   └── landscape_volume_bar.dart   # 横屏音量条
│   ├── desktop_window_controls.dart   # 桌面窗口控制
│   ├── dialogs/                    # 对话框
│   │   └── update_dialog.dart
│   ├── import_progress_dialog.dart # 收藏夹导入进度
│   ├── landscape/                  # 横屏布局组件
│   │   ├── album_section.dart
│   │   ├── apple_cover.dart
│   │   ├── apple_slider.dart
│   │   └── background.dart
│   ├── lyric/                      # 歌词组件
│   │   ├── lyric_line_widget.dart
│   │   ├── lyric_section.dart
│   │   └── lyric_source.dart
│   ├── mini_player_bar.dart        # 迷你播放条
│   ├── pip/                        # 小窗组件
│   │   └── pip_overlay.dart
│   ├── playlist/                   # 播放列表组件
│   │   ├── playlist_item.dart
│   │   └── playlist_sheet.dart
│   └── long_press_menu.dart        # 长按菜单
│
├── core/                          # 核心基础设施
│   ├── app_providers.dart          # Riverpod 全局 Provider 容器
│   └── database.dart               # SQLite 数据库单例
│
├── managers/                      # 核心管理器
│   ├── audio_handler.dart          # 音频Handler
│   ├── cache_manager.dart          # 缓存管理
│   ├── fav_sync_manager.dart       # 收藏夹同步
│   ├── playlist_manager.dart       # 歌单管理
│   ├── recommendation_manager.dart # 推荐管理
│   ├── settings_manager.dart       # 设置管理
│   └── user_manager.dart           # 用户信息管理
│
├── models/                        # 数据模型
│   ├── bili_fav_folder.dart       # B 站收藏夹
│   ├── bili_fav_resource.dart      # 收藏夹资源
│   ├── bili_item.dart              # B站视频项
│   ├── changelog_entry.dart        # 更新日志条目
│   ├── fav_import_record.dart      # 收藏夹导入记录
│   ├── music.dart                  # 音乐模型
│   ├── play_mode.dart              # 播放模式
│   ├── player_state.dart           # 播放状态
│   ├── playlist.dart               # 歌单模型
│   ├── playlist_tag.dart           # 歌单标签
│   ├── search_result.dart          # 搜索结果
│   └── user_info.dart              # 用户信息
│
├── pages/                         # 页面模块
│   ├── changelog_page.dart        # 更新日志
│   ├── cookie_page.dart           # Cookie设置
│   ├── data_management_page.dart  # 数据管理
│   ├── data_migration_page.dart   # 数据迁移
│   ├── detail/                    # 详情页
│   │   ├── landscape_detail_page.dart
│   │   ├── portrait_detail_page.dart
│   │   ├── square_detail_page.dart      # 方屏（手表/折叠外屏）适配
│   │   └── widgets/controls_bar.dart
│   ├── detail_page.dart           # 详情页入口
│   ├── fav_import_page.dart       # 收藏夹导入
│   ├── home_content.dart          # 首页内容
│   ├── home_page.dart             # 首页
│   ├── login_page.dart            # 登录页
│   ├── playlist/                  # 歌单页
│   │   ├── landscape_playlist_page.dart
│   │   ├── portrait_playlist_page.dart
│   │   └── widgets/
│   │       ├── playlist_header.dart
│   │       ├── playlist_hero.dart
│   │       ├── playlist_sidebar.dart
│   │       └── playlist_song_list.dart
│   ├── playlist_page.dart         # 歌单页入口
│   ├── profile_page.dart          # 个人中心
│   ├── qr_login_widget.dart       # 扫码登录组件
│   ├── search/                    # 搜索页
│   │   ├── search_overlay.dart
│   │   ├── search_results_overlay.dart
│   │   └── widgets/
│   │       ├── search_bar_widget.dart
│   │       ├── search_empty_state.dart
│   │       ├── search_result_card.dart
│   │       └── search_type_tabs.dart
│   └── settings_page.dart         # 设置页
│
├── providers/                     # Riverpod 状态管理
│   ├── fav_sync_providers.dart    # 收藏夹同步 Provider
│   ├── navigation_providers.dart  # 导航 Provider
│   ├── playback_providers.dart    # 播放状态 Provider
│   ├── playlist_providers.dart    # 歌单 Provider
│   ├── search_providers.dart      # 搜索 Provider
│   ├── service_providers.dart     # 服务 Provider
│   ├── settings_provider.dart     # 设置 Provider
│   ├── shell_page_providers.dart  # Shell 页面 Provider
│   └── user_providers.dart        # 用户 Provider
│
├── services/                     # 服务层
│   ├── api_service.dart          # B 站 API（基于 BiliClient）
│   ├── dual_audio_service.dart   # 双播放器服务（equal-power 交叉淡入淡出）
│   ├── notification_service.dart # 系统通知
│   ├── pip_service.dart          # 小窗服务
│   ├── player_coordinator.dart   # 播放器协调（CID 缺失自动补齐、playNextFromIndex 等）
│   ├── playlist_service.dart     # 歌单业务服务（含 CID 回填）
│   └── qr_login_service.dart     # 扫码登录轮询
│
├── shells/                        # 布局外壳
│   ├── app_shell.dart             # 应用外壳
│   ├── landscape/                 # 横屏布局
│   │   ├── landscape_bottom_control.dart
│   │   ├── landscape_sidebar.dart
│   │   └── landscape_title_bar.dart
│   ├── landscape_shell.dart       # 横屏外壳
│   ├── portrait_shell.dart        # 竖屏外壳
│   └── shell_page_manager.dart    # 页面管理
│
├── theme/                         # 主题系统
│   ├── app_palette.dart           # 统一颜色 palette
│   ├── app_tokens.dart            # 设计 token
│   ├── lucent_theme.dart          # 默认主题
│   ├── nocturne_theme.dart        # Nocturne 主题
│   ├── theme_registry.dart        # 主题注册表
│   └── verdant_theme.dart         # Verdant 主题
│
└── utils/                         # 工具类
    ├── animations.dart            # 动画工具
    ├── av_bv.dart                 # AV / BV 号互转
    ├── captcha_helper.dart        # 验证码辅助
    ├── color_extractor.dart       # 颜色提取
    ├── dialog_helpers.dart        # 对话框辅助
    ├── lyric_parser.dart          # 歌词解析
    ├── netease_music_api.dart     # 某某云音乐API
    ├── network_config.dart        # 网络配置
    ├── platform_helper.dart       # 平台辅助
    ├── responsive.dart            # 响应式布局（含方屏判断）
    ├── update_checker.dart        # 更新检查
    └── window_listener.dart       # 窗口监听

Copyright (C) 2026 NaivG and contributors.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.