Sakura · 樱

产品气质

不是单纯的音符播放器，而是一套围绕「听见节奏、看见节奏、创造节奏」展开的本地音乐游戏体验：玩家可以挑战内置谱面，也可以用编辑器把自己的音乐变成可游玩的内容。

核心体验

• 双通道输入：键盘 4K 轨道 + 鼠标空间点击，两种操作在同一谱面中交替、叠加、呼应
• 完整游玩循环：选曲、游玩、暂停、结算、统计、设置、校准、教程
• 内置编辑器：时间线、预览、命令式操作、撤销/重做
• 樱花主题舞台：粒子、发光、拖尾、屏幕震动、Shader 与音频可视化
• 本地数据：SQLite 保存成绩、设置与成就

架构决策

分层结构：core/（窗口、渲染、输入、资源）→ game/（谱面、判定、计分、成就）→ scene/（场景流程）→ editor/（编辑器）。规则计算下沉到 game 层，UI 不承担判定逻辑；所有布局使用归一化坐标适配窗口尺寸。

谱面目录驱动内容：info.json + 难度 JSON + 音频/封面/背景分离管理，新增字段同步更新格式规范与测试。

测试与质量

测试目标覆盖判定、计分、PP 计算、成就、输入帧缓存与谱面加载等逻辑；ci-linux preset 在非 Windows 环境构建跨平台逻辑与测试。

成果

• v0.5.5-alpha：核心游玩链路、谱面加载、编辑器、本地数据与主要视觉系统已成形
• 基于 SDL3 GPU API，面向 Vulkan / D3D12 后端
• 判定 / 计分 / 成就 / 输入缓存均有测试覆盖