ChiffonMai

ChiffonMai 是一款面向舞萌 DX 玩家的移动端工具应用。它把曲库查询、成绩管理、Rating 分析、歌曲推荐、谱面工具、猜歌游戏和日常辅助功能集中在一起，方便你在游玩前查歌、游玩后看成绩，也方便整理自己的曲库和目标。

项目由社区共同维护。欢迎反馈问题、提出建议，也欢迎喜欢这个项目的朋友支持开发。

当前版本与导航

当前源码版本为 2.9.0+52。底部导航按用途分为 首页、曲库、成绩、出勤、休闲、我的；首页提供功能搜索和可排序的收藏入口。其余五页进一步按业务分组，成绩页直接显示全部分组。

• 账号与授权：支持水鱼、落雪和 AWMC NET 账号资料管理，提供注册引导、个人 key 获取说明与来源隔离的成绩数据。
• 同步与刷新：支持单平台、多端与自动同步；成绩同步成功后自动执行所选数据刷新，刷新失败单独提示。自动同步需配置各数据源凭据与机台身份。
• 单人猜歌：统一设置页管理共用规则和各模式偏好；统计区为两行四列，包含剩余次数、正确、错误、正确率、平均用时、当前连胜、最高连胜与重置，数值与趋势变化带过渡。
• 随机抽歌：结果卡片内显示轮播；开始按钮切换为“停！”，手动停止后显示本轮实际抽取结果。上级、超上级均抽取 4 首。
• 外观与导航：经典悬浮、液态玻璃、伸缩胶囊三种导航样式，支持主题、背景、页面动画与沉浸式状态栏偏好。
• 缓存管理：分别统计音源、PV、maidata 的文件数量与存储占用；基础量 maidata 计入统计，可从缓存对话框重新拉取，进度显示在功能按钮上。
• 备份：v3 JSON 包含用户偏好、账号资料、收藏、笔记、猜歌统计、成绩／Rating 历史、自定义背景与本地谱面包归档；兼容旧备份。登录凭据、个人 key、自动同步身份及可重新下载的媒体／网络缓存不导出。备份文件上限 50 MB，用户文件原始总量上限 35 MB。
• 诊断日志：从“我的 → 运行诊断 → 打印日志”导出近期日志、窗口状态及有限的上次会话记录。会对常见凭据脱敏；Android 原生渲染问题仍可能需要完整 ADB 日志。

完整功能目录与操作说明见 Wiki。此仓库仅追踪 Flutter 客户端与相关文档；生产服务代码、凭据、数据及运维资料不纳入仓库。

功能一览

曲库、歌曲和谱面

• 乐曲查询：按歌名、别名、艺术家、谱师、版本、类型、难度和标签筛选歌曲。
• 搜索历史：保留最近使用过的搜索内容，方便重复查找。
• 歌曲详情：查看曲绘、艺术家、歌曲类型（ST、DX、UTAGE）、各难度谱面、定数、谱面信息、定数历史和可游玩地区。
• 谱面代码：查看、复制和导出谱面代码，支持导出谱面文件或谱面包。
• 自定义谱面播放：导入本地谱面进行播放和预览。
• 曲绘识别：使用图片或相机识别歌曲曲绘。
• 结算画面识别：从机台结算画面中识别歌曲和成绩。
• 随机乐曲：按筛选条件随机抽取歌曲，可用数字步进器选择抽取数量；抽取时卡片轮播，手动点击“停！”揭晓结果。
• 收藏夹：创建和管理收藏夹，整理想练习或想游玩的谱面。
• 下次想玩：把歌曲加入待游玩队列，集中查看下一次想挑战的曲目。
• 收藏夹备份与恢复：导入或导出收藏夹数据，便于换设备或重装应用后恢复。
• 版本对照：按版本查看曲目，了解日服和国服的收录差异。
• 国服更新对照：查看日服已经上线、国服尚未上线的曲目。
• 收藏品查询：查询头像、姓名框等收藏品。

成绩、Rating 和排行榜

• 成绩查询：浏览完整游玩记录，按歌曲、难度、等级、版本、成绩和其他条件筛选。
• 牌子进度：查看各版本目标牌子和当前完成进度。
• 进度图片导出：将牌子进度、个性化成绩和 Best50 系列整理为图片，方便保存或分享。
• 个性化成绩查询：按等级、谱师和其他条件集中查看成绩。
• 单曲 Rating 计算：根据歌曲定数和达成率计算单曲 Rating。
• 达成率计算：根据 TAP、HOLD、SLIDE、TOUCH、BREAK 等判定详情计算达成率。
• 达成率反推：根据目标达成率反推出需要达到的判定情况。
• Best50：查看当前 Best35 和 Best15，并了解各歌曲对总 Rating 的贡献。
• 拟合 Best50：估算潜在 Rating 上限，辅助制定练习目标。
• 个性化 Best50：按标签筛选和查看个人 Best50。
• 个性化拟合 Best50：按标签分析拟合 Rating 上限。
• 理想 Best50：根据理想成绩估算 Best50，宴会场等不计入 Rating 的歌曲不会被算入有效 Rating。
• Rating 历史：查看 Rating 随时间的变化。
• Rating 排行榜：查看玩家 Rating 排名，并切换不同排行类型。
• 拟合总 Rating 排行榜：比较拟合总 Rating 与官方 Best50 的差值。
• 平均达成率排行榜：按全量成绩的平均达成率查看排行。
• 平均 DX 分数达成率排行榜：按全量成绩的平均 DX 得分达成率查看排行。
• 特殊排行榜：浏览各种有趣的玩家数据排行，可切换正向和反向排行。
• 好友对比：对比自己与好友的成绩差异和 Rating 情况。
• 定数分布：查看自己的成绩或曲库中的谱面定数分布。
• 段位表：查看段位挑战内容，并记录每个段位的未挑战、不合格、合格或赤合格状态以及总达成率。

歌曲推荐和日常辅助

• 基于标签推荐：根据已游玩谱面的标签推荐可能感兴趣的曲目。
• 基于目标 Rating 推荐：寻找适合当前目标和 Rating 区间的谱面。
• 基于定数区间推荐：按定数范围挑选歌曲。
• 每日推荐：每天获取一组推荐歌曲，决定今天练什么。
• 吃分推荐：由AWMC提供支持，由缓存记录给出专属吃分歌单
• 出勤转盘：使用等分转盘决定本次出勤或不出勤；区域按出勤、不出勤交替排列，可调整区域数量并记住设置。
• 随身听：后台播放歌曲，支持通知栏控制、播放队列、前后曲预览和滑动切歌。
• 歌曲下载：将随身听中的歌曲保存为歌名命名的 MP3，并写入公开访问目录，方便在文件管理器中找到。
• KaleidXScope：查看青门、白门、黄门、红门和紫门等时间段，了解当前日期进度、对应难度和血量信息。
• 全国音游地图：查看国内音游机厅信息。
• 全球音游街机地图：查看 NearCade 的全球机厅数据，支持搜索、筛选、地图缩放，以及机厅点的聚合和展开。

猜歌游戏

• 无提示猜歌：凭记忆直接挑战曲库。
• 部分曲绘猜歌：从一小块曲绘猜歌曲。
• 模糊曲绘猜歌：根据模糊处理后的曲绘猜歌曲。
• 歌曲片段猜歌：根据截取的音源片段猜歌曲。
• 倒放音频与变速变调猜歌：根据处理后的音源片段猜歌曲。
• 曲绘快闪与曲绘拼图：根据短暂显示或逐步揭示的曲绘猜歌。
• 谱面片段猜歌：观看无声谱面片段，按难度随机池挑战。
• 别名猜歌：使用歌曲别名挑战熟悉度。
• 舞萌开字母：根据歌曲首字母猜歌。
• 多人猜歌游戏：和朋友一起进行猜歌对战。

数据同步、系统和开发支持

• 刷新数据：重新拉取并初始化曲库、歌曲、谱面和其他本地缓存。
• 缓存管理：查看、清理音源、PV 与 maidata，并重新拉取基础量 maidata。
• 同步成绩到水鱼：通过机台二维码或导入流程同步成绩到水鱼查分器。
• 同步成绩到落雪：将本地成绩同步到落雪咖啡屋。
• 同步成绩到 AWMC NET：通过二维码等方式同步成绩到 AWMC NET。
• 同步成绩到多端：一次同步到多个支持的查分服务。
• 水鱼账号登录与登出：管理水鱼 ImportToken 和登录状态。
• 服务器状态：查看舞萌相关服务的当前状态，数据来源于 isMaiDown by Chongxi。
• 数据备份：导入或导出本地用户资料、偏好与用户文件，不包含登录凭据和可重新获取的缓存。
• 加载语录管理：选择本地语录或云端语录，管理加载页面显示的内容，也可以新增本地语录并上传到云端。
• 打印日志：将调试日志导出到项目约定的公开可访问目录，便于反馈问题。
• 检查更新：检查是否有新版本可用。
• 系统设置：调整主题色、浅色或深色模式、背景图、交互选项与同步/网关选项。
• 支持开发者：查看支持方式，并下载赞赏码图片。
• 友情链接：浏览相关项目和社区链接。
• 问卷调查：参与问卷，帮助改进 ChiffonMai。
• 关于 APP：查看版本信息、项目介绍、开发者信息和完整致谢名单。
• 访问官方网站：前往 chiffonmai.cloud 查看项目主页。
• AWMC 工具：机台数据相关入口按当前版本配置提供，使用时遵循页面提示。

下载和安装

目前主要提供 Android 版本。

1. 前往下载页面获取最新 APK。
2. 根据系统提示允许安装来自浏览器或文件管理器的应用。
3. 安装完成后打开 ChiffonMai。

如果系统提示应用来源不明，请确认 APK 来自项目提供的下载页面，再决定是否继续安装。

iOS 版本目前尚未正式发布；仓库提供客户端构建工作流，见 iOS 构建说明。

数据来源

为了提供曲库、成绩、谱面和机厅相关功能，应用会使用多个公开或获得授权的数据服务，包括但不限于：

• 水鱼查分器
• DXRating.net
• 落雪咖啡屋
• AWMC NET.
• Union
• Yuri-YuzuChaN/maimaiDX
• NearCade
• isMaiDown by Chongxi
• status.awmc.cc

不同功能使用的数据来源不同，数据更新时间也可能不同。排行榜和社区数据仅供参考，请以游戏内实际情况和各服务的最新信息为准。

账号和隐私

• 不登录也可以使用曲库查询、歌曲详情、计算器、推荐、随机抽歌、谱面播放、地图和多数本地工具。
• 需要登录的同步和成绩查询功能，只会在你主动使用时请求对应服务。
• 登录信息和令牌使用系统安全存储能力保存。
• 应用不会把账号密码写入公开的项目源码。
• 使用第三方服务时，请同时遵守对应服务的使用规则和隐私政策。

特别致谢

感谢所有提供设计建议、测试数据、曲库与谱面数据、同步服务、开发支持和捐献支持的朋友。下面名单与应用内“关于”页面保持同步，排名不分先后。

创作与支持

• Xn1xUfguF1GiNg：为本项目提供的背景图和戚风小狐狸（真的非常可爱）。个人页面
• Takanashi Rikkkkkkka：为本项目的个性化谱面推荐功能提供宝贵设计思路。
• 三由yyyh：为本项目的页面设计提供了宝贵意见。
• MYD：提供了用于测试开发的个人游玩数据。
• 乐观的熊猫：提议开发 ChiffonMai，为本项目诞生提供最初契机。bilibili
• 迪拉熊重度依赖：为本项目在前端细节与交互体验上提供了诸多宝贵建议。GitHub
• Michaelwucoc：为本项目的开发提供了技术支持和经济支持，为项目的推进提供了极大的帮助。GitHub
• ChiffonMai交流群的全体群友：为本项目开发提供了诸多宝贵建议和反馈。

数据与服务

• 水鱼查分器：提供曲目数据库和玩家游玩记录数据库。官网
• DXRating.net：提供谱面标签数据库和别名数据库。官网
• Yuri-YuzuChaN：提供别名数据库。项目地址
• 落雪咖啡屋：提供收藏品数据库、歌曲音源支持、曲目数据库和玩家游玩记录数据库。官网
• Neskol：提供谱面转换支持。项目地址
• status.awmc.cc：提供舞萌服务器状态信息。服务地址
• mai.chongxi.us：提供舞萌服务器状态信息。服务地址
• AWMC NET.：提供水鱼查分器同步支持、落雪查分器同步支持和对本项目开发的经济支持。官网
• Bakapiano：提供水鱼查分器和落雪查分器成绩同步支持。项目地址
• k4641321：提供落雪查分器成绩同步支持。项目地址
• Union：提供曲目数据库。官网
• NearCade：提供全球机厅相关数据。官网
• SilentBlue.RemyWiki：提供高清版本图片。官网

设计思路借鉴

• EasyMai：设计思路借鉴。
• 舞萌猜猜呗之潘一把：设计思路借鉴。在线体验
• MaiScan Rev：设计思路借鉴。
• 中二查歌：设计思路借鉴。

捐献致谢

• Pokcet：感谢对本项目的捐献支持。
• ListaQwQ：感谢对本项目的捐献支持。
• 迪拉熊重度依赖：感谢对本项目的捐献支持。
• 白嫖万岁：感谢对本项目的捐献支持。
• 鱼好呆：感谢对本项目的捐献支持。

开源和参与

项目仓库：

• GitHub
• Gitee

欢迎通过 Issue 反馈问题或提出建议。提交代码前，请尽量说明复现步骤、设备信息和相关页面。

也可以通过邮箱 [email protected] 联系开发者。

免责声明

ChiffonMai 是社区制作的第三方工具，与 SEGA 没有隶属或官方合作关系。

本项目仅供学习和娱乐使用。歌曲、谱面、成绩、排行榜和机厅信息来自相关数据服务，可能存在延迟、缺失或误差，请以游戏内实际情况和各服务的最新信息为准。

许可证

本项目使用 MIT License 开源。