ChiffonMai

核心功能

一个 App，覆盖舞萌玩家的所有需求

5 大主分类，50+ 功能，覆盖查询、统计、推荐、社交全场景

🎶

曲库与数据

查歌、查分、查收藏、查百科 — 围绕舞萌数据的全能查询工具。

乐曲查询（中/日/英 + 别名）
成绩查询 + 单曲判定详情
牌子进度（白极/将/神）
收藏品查询（称号/名牌/背景/面板）
舞萌百科（术语/机制/社区黑话）
谱面 maidata 源码查看 + 内嵌播放

🏆

Best50 与排行榜

多角度审视你的成绩 — 从当前最佳到潜在上限，从个人到全网。

Best50 / Best35+15 / 拟合 / 个性化
一键导出精美长图分享
14 种排行榜（绝赞/物量/定数差值/BPM …）
总 Rating / 水鱼 / 落雪三榜
参与/退出可选，隐私保护

🎮

猜歌游戏

6 种单人模式 + 多人实时对战，WebSocket 全双工通信。

无提示 / 部分曲绘 / 模糊曲绘
歌曲片段 / 别名 / 开字母
创建房间 · 邀请好友 · 实时计分板
难度自定 / 限时可选

🧮

实用工具

从打歌到游玩规划，一站式覆盖你的日常需求。

Rating / 达成率 / 反推 / 版本对照
标签推荐 / 目标 Rating / 定数区间推荐
随机选曲 / 每日推荐
曲绘识别（拍照识曲）
结算画面识别（OCR 抓成绩）
定数分布 / 好友对比 / 收藏夹管理
KALEIDXSCOPE 五色门进度
全国 + 全球音游街机地图

⚙️

系统与社交

数据管理、主题定制、社区互动，让 App 真正属于你。

多数据源（水鱼 + 落雪）
同步 / 备份 / 刷新 / 高级刷新
评论 + 谱面评分（含敏感词过滤）
浅色 / 深色 / 自定义主题
服务器状态监控
收藏夹 / 留言 / 友情链接

🎵

谱面播放

在手机上直接播放舞萌谱面 — 不只是看，是体验。

解析本地 maidata.txt
可视化渲染（谱面预览）
支持自定义谱面播放
关联推荐选曲

数据来源

多源数据，全部为你聚合

支持 Diving-Fish 与落雪咖啡屋双数据源，并整合多家第三方服务

🐟 Diving-Fish 水鱼

曲库、玩家记录、Best50。QQ 号即可查询，数据全面。

❄️ 落雪咖啡屋

曲库、收藏品、音源、玩家记录。OAuth 2.0 授权，实时性更高。

📊 DXRating.net

谱面标签、别名、全量 dxdata。智能推荐的燃料。

🌐 Union

全量歌曲元数据（cn/jp 地区、releaseDate）。

🔌 maimai-score-hub

QR 码成绩同步中间层（WebSocket）。

🟢 AWMC Status

舞萌服务器运行状态监控，避免白跑。

架构

清晰分层，干净高效

本地处理敏感计算，云端承担社交与排行

📱 本地层 · Flutter / Dart ├─ 本地存储（SharedPreferences） │ ├─ QQ / 授权码 / ImportToken │ ├─ 排行榜设置 / 收藏夹 / 配置偏好 │ └─ 歌曲 / maidata / diff 缓存 ├─ 本地计算引擎 │ ├─ Rating 计算 / 达成率核算 / 反推 │ ├─ Best50 拟合 / 个性化 / 猜歌逻辑 │ └─ 谱面 maidata 解析 + 播放 └─ UI 渲染层 🌐 第三方数据源 · 直连 ├─ Diving-Fish 水鱼 → 曲库 / 记录 / Best50 ├─ 落雪咖啡屋 (LXNS) → 曲库 / 收藏品 / 记录 ├─ DXRating.net → 标签 / 别名 / dxdata ├─ Union (godserver.cn) → 全量歌曲元数据 ├─ AWMC status → 服务器状态 └─ maimai-score-hub → QR 码同步（WebSocket） 🖥️ 自家后端 · Node.js · chiffonmai.cloud ├─ RESTful API（Express） │ ├─ /api/prober/* — OAuth 代理换票 │ ├─ /api/rankings/* — 总/水鱼/落雪 Rating 榜 │ ├─ /api/song-rankings/* — 单曲达成率 / DX 分榜 │ ├─ /api/comments/* — 歌曲评论 │ ├─ /api/ratings/* — 谱面评分 │ ├─ /api/kaleidxscope/* — 万花镜门进度 │ └─ /api/knowledge — 舞萌百科词条 ├─ 存储层 │ ├─ MySQL — 持久化数据 │ └─ Redis — 缓存 + ZSet 排行 + 播放量 └─ WebSocket 服务器 — 多人猜歌实时对战

致谢

特别致谢

感谢每一位为 ChiffonMai 做出贡献的朋友（排名不分先后）

Xn1xUfguF1GiNg — 背景图与戚风小狐狸

Takanashi Rikkkkkkka — 个性化谱面推荐设计思路

三由yyyh — 页面设计宝贵意见

MYD — 测试开发数据

乐观的熊猫 — 提议开发，最初契机

Diving-Fish 水鱼 — 曲库与玩家记录

DXRating.net — 谱面标签与别名

Yuri-YuzuChaN — 别名数据库

落雪咖啡屋 — 收藏品/音源/曲库/记录

Neskol — 谱面转换支持

status.awmc.cc — 服务器状态查询

Bakapiano — 成绩同步支持

Union — 曲目数据库

k4641321 — 落雪查分器成绩同步

AWMC NET. — 同步支持与项目资助

FAQ

常见问题

安全吗？我的数据会上传吗？▾

所有数据在手机本地处理。登录水鱼 / 落雪仅用于同步官方数据，不收集敏感信息：
· 个人数据（QQ、授权码）仅存本地 SharedPreferences
· 排行榜可随时关闭参与，关闭后不再公开
· 不含任何第三方统计 SDK（友盟、GA 等）
· 源代码完全开源，可自行审查

QR 码同步怎么用？▾

机台「信息」页 → 「QR 码发行」→ 微信扫码 → 复制以 SGWCMAID 开头的字符串 → App 内「同步成绩」→ 粘贴 → 「同步」。App 自动通过 maimai-score-hub 完成 Bot 加好友、抓取、推送、刷新本地 Best50 全流程，进度条实时显示当前阶段。

必须登录水鱼吗？密码安全吗？▾

首次 QR 同步需要登录一次水鱼账号，App 自动缓存 ImportToken，后续无需重复输入。密码仅用于获取 ImportToken，不存明文、不上传第三方。查 Best50、排行榜、猜歌游戏等基础功能无需登录。

相比官方 NET，ChiffonMai 有什么？▾

· Best50 长图导出（一键生成精美分享图）
· 6 种猜歌游戏 + 多人实时 WebSocket 对战
· 牌子进度可视化 + 一键导出
· Rating 计算器 + 达成率反推
· 14 种多维排行榜（绝赞/物量/定数差值/BPM 等）
· 收藏品攻略 + 谱面内嵌播放
· KALEIDXSCOPE 五色门进度
· 舞萌百科 + 双数据源（水鱼 + 落雪）

猜歌支持多人对战吗？▾

支持。6 种猜歌模式均支持 WebSocket 实时对战：
· 创建房间 → 选择模式 → 分享房间号
· 加入房间 → 输入房间号 → 等待开始
· 实时同步答题、计分板、最终排名
建议使用稳定 Wi-Fi 或 5G 网络。

支持水鱼 + 落雪双数据源吗？▾

支持。随时在「刷新数据」对话框切换：
· 水鱼：QQ 号查询，数据全面
· 落雪：OAuth 2.0 授权，实时性更高，附收藏品
App 自动记忆上次使用的数据源。

「拟合 Best50」和「个性化 Best50」是什么？▾

拟合 Best50：假设你所有谱面都达到最高 Rating 时的理论上限，帮你评估冲分空间。
个性化 Best50：趣味化的最佳 50，包括：
· 锁血 50（达成率最低）
· AP 50（达成率最高）
· FS 50（Full Sync+ 最多）
持续增加中。所有模式均支持长图导出。

iOS 什么时候出？▾

正在尽力协调 iOS 端上架（App Store 审核流程较为复杂）。Android 用户可先通过蓝奏云下载。有进展会第一时间通过 GitHub Releases 通知。

开源吗？▾

完全开源！MIT License，托管在 GitHub 与 Gitee。欢迎 PR、Issue、文档完善、翻译、社区推广等任何贡献。

一个 App，覆盖舞萌玩家的所有需求

曲库与数据

Best50 与排行榜

猜歌游戏

实用工具

系统与社交

谱面播放

📡 一键同步水鱼 / 落雪

多源数据，全部为你聚合

清晰分层，干净高效

现代化跨平台技术构建

完全免费，即刻体验

Android

iOS

❤️ 助力持续开发

📱 微信赞赏

⚡ 爱发电

特别致谢

常见问题