app/src/main/java/com/lin0721/linmusic/
├── MelodiaApplication.kt        # 应用程序入口：Koin 依赖注入初始化与 Coil 预热
├── MainActivity.kt              # 单 Activity 架构：系统窗口适应与悬浮窗权限引导
├── MelodiaApp.kt                # 顶层组合：导航骨架编排与播放器图层联动
├── MelodiaNavHost.kt            # 核心路由分发与平滑转场动画配置
├── MelodiaOverlays.kt           # 全屏播放器底栏、底部弹窗与全局反馈浮层
├── MelodiaNavigationState.kt    # 自定义导航回退栈管理与参数上下文恢复
├── MelodiaPlayerSheetState.kt   # 全屏播放器展开/收起手势状态机
├── MelodiaSidebarState.kt       # 侧边栏抽屉滑动状态机
│
├── core/                        # 跨域共享基础能力
│   ├── api/                     # 账号鉴权与公共接口定义
│   ├── auth/                    # 登录状态、凭据持久化与用户信息同步
│   ├── comment/                 # 评论通用数据流与 UI 组件
│   ├── contentfilter/           # 内容屏蔽与黑名单过滤
│   ├── log/                     # 日志输出与异常捕获
│   ├── model/                   # 全局领域数据模型与实体映射
│   ├── network/                 # 原生加密引擎、OkHttp 拦截器与统一网络适配
│   ├── player/                  # 播放器核心引擎（ExoPlayer、队列调度、进度广播）
│   ├── playlistmutation/        # 歌单创建/编辑、歌曲增删与排序操作
│   ├── preferences/             # DataStore 与轻量级配置持久化
│   ├── songlike/                # 歌曲红心收藏状态管理
│   ├── ui/                      # Material 3 主题、通用交互组件与动画规范
│   ├── update/                  # 应用内更新检测、下载管理器与安装器组件
│   ├── userartist/              # 用户关注歌手列表管理
│   └── userplaylist/            # 用户歌单状态与列表维护
│
├── di/                          # Koin 依赖注入模块（Network, Local, Repository, Player, Update, ViewModel）
│
└── feature/                     # 业务功能域（各自包含 data / domain / ui）
    ├── account/                 # 账号登录与授权管理
    ├── artist/                  # 歌手主页、热门单曲与全部专辑
    ├── cloud/                   # 用户云盘资产管理
    ├── create/                  # 歌单新建与快捷操作
    ├── home/                    # 首页聚合流（推荐单曲/歌单、雷达）
    ├── library/                 # 个人音乐库（分类筛选与检索）
    ├── listendata/              # 年度/周听歌数据与足迹统计
    ├── message/                 # 私信与系统通知中心
    ├── music/                   # 音乐发现 Tab（风格流派与个性化推荐）
    ├── newworks/                # 新歌首发与数字专辑
    ├── player/                  # 全屏播放、动态歌词与歌曲详情交互
    ├── playlist/                # 歌单/专辑详情与音轨列表
    ├── podcast/                 # 电台播客节目
    ├── profile/                 # 用户个人主页与听歌排行
    ├── recent/                  # 最近播放历史记录
    ├── search/                  # 多模式实时搜索与热搜榜
    └── settings/                # 主题、音质、网络与缓存配置