Bangumi Multiplatform 是一款基于 Kotlin Multiplatform (KMP) 与 Compose Multiplatform 构建的 Bangumi.tv (番组计划) 第三方全功能跨平台客户端。
本项目采用现代化的 MVI 架构 与 模块化设计，支持 Android、iOS 以及 Desktop (JVM) 多端运行。
不仅完整覆盖了 BGM.TV 的日常使用与社区功能，更内置了强大的 自动化工作流引擎 Workflow Engine、Live2D 动态看板娘 及多维度的番剧衍生资源聚合。
[!NOTE]
💡 版本演进说明：原基于传统 Android View 视图架构实现的版本（已归档在 view 分支，停止维护）。全平台最新版本已全面升级并转向现代化的
Compose Multiplatform 架构，目前直接在主分支 main
上重构与持续迭代，提供更极致的渲染性能与多端跨平台体验！测试包请查阅 GitHub Actions 构建产物。
🌟 核心特性
- 跨平台体验 (KMP + Compose Multiplatform)：基于 Compose 声明式 UI 开发，多端共享核心业务逻辑，极致流畅。
- 全面覆盖 Bangumi 核心功能：
- 进度管理：追番、看剧、读漫画、玩游戏状态一键更新与进度格子管理。
- 条目与角色：详尽的动画/书籍/三次元/游戏/音乐条目信息、角色图鉴、演职员与关系网。
- 社区交流：热门小组话题、时间线动态、日志、条目吐槽、评论回复与消息通知。
- 探索发现：每日放送日历、排行榜、搜条目/搜角色/搜目录、巡礼地图等。
- 强大的 Workflow 自动化工作流引擎：
- 声明式 DAG 节点编排，支持并行执行、分支合流（Fork/Join）、循环遍历与状态追踪。
- 内置网络请求、HTML/JSON 解析、正则表达式提取、变量上下文及自定义 UI 交互副作用。
- 生动有趣的 Live2D 看板娘：支持 Live2D 交互、模型更换及个性化配置。
- 衍生资源聚合与发现：
- 整合 Mikan 蜜柑计划 磁力资源及字幕组展开。
- 整合 Anime-Pictures 及 Pixiv 高清插画/作品预览。
- 图片/视频媒体预览与内置播放组件。
- 个性化定制与隐私安全：
- 支持 Material Design 3 动态主题配色、暗黑模式及多种视觉外观定制。
- 代码完全开源，无广告、不收集隐私，数据多端无缝同步。
🏗️ 架构设计
项目采用严格的 模块化设计 与 MVI (Model-View-Intent) 架构：
bangumi-multiplatform/
├── composeApp/ # Compose Multiplatform 桌面/通用入口
├── android/ # Android 壳工程与 Application 配置
├── iosApp/ # iOS Xcode 工程入口
├── shared/ # 核心共享组件与基础库
│ ├── core/ # 基础公共类、MVI 架构基类、通用工具与类型定义
│ ├── core-native/ # C++ / Native 扩展（Live2D 渲染引擎等）
│ ├── core-resource/ # 共享图片、图标、多语言 Strings 资源
│ ├── data/ # 网络请求(Ktorfit/Ktor)、数据模型(DTO)、数据库与存储
│ ├── data-workflow/ # Workflow 工作流 DAG 执行引擎
│ ├── ui/ # 共享 UI 组件、导航路由定义
│ ├── ui-platform/ # 平台差异化 UI 兼容组件
│ ├── ui-material3/ # Material Design 3 主题与样式库
│ └── ui-video/ # 视频播放器与全屏控制器组件
└── features/ # 独立业务功能模块（如 home, subject, workflow, settings 等）
- MVI 架构：依托 Orbit MVI 框架，遵循
State -> Event/Intent -> SideEffect 响应式数据流。
- 网络层：基于 Ktor 3 与 Ktorfit 构建类型安全的 API 请求体系。
- 依赖注入：基于 Koin 实现跨平台依赖注入。
部分页面截图预览
🚀 编译与构建
准备工作
- JDK 17 及以上
- Android Studio (最新 Canary/RC 版本推荐，需安装 Kotlin 及 Multiplatform 插件)
- Xcode (仅编译 iOS 版本需要)
Gradle 编译命令
- Android：
./gradlew :android:assembleDebug
- Desktop (JVM)：
./gradlew :composeApp:run
- 构建测试与验证：
./gradlew :shared:data:kspCommonMainKotlinMetadata
🤝 贡献与反馈
欢迎大家提出 Bug 反馈、功能建议或提交 PR！
开发人员：
喜欢这个项目的话，欢迎在 GitHub 上点个 ⭐ Star 支持一下！
📜 开源协议
本项目采用 GPL-3.0 License 开源协议。
评论