FAQ

FAQ（中文）

中文 | English

先看这里：

• 安装指南（中文）
• 功能总览（中文）

如何安装项目？

详细步骤请看 安装指南（中文）。
源码构建时建议将 Ez2Lazer、osu-framework、osu-resources 三个仓库放在同级目录。

配置文件在哪？是否与osu官方配置独立？数据库中那些文件是Ez2Lazer独有的？

Ez2Lazer与官方使用相同的文件夹，配置文件独立，目前使用两份ini文件储存自己独特的设置信息。

• Ez2game.ini储存游戏设置中，Ez端独有设置；
• EzSkinSettings.ini储存皮肤编辑器中，Ez端独有设置；

能否使用官方Lazer的数据？是否可以共享/同步数据？

首先直接说结论：可以直接使用官方数据库文件夹。

为了阐明关系，在这里简单解释数据库文件夹中的文件作用：

• client.realm是官方客户端（Release）使用的数据库，就是正常使用的版本
• client_XX.realm是开发版客户端使用的数据库（XX为官方开发端版本号），默认所有本地构建的客户端Debug构建都是使用这个文件
• .realm.lock 数据锁，保护realm文件，防止同时被多个进程同时操作。

这两份.realm文件相互独立，数据不互通。通常client_XX.realm文件是复制->重命名client.realm得到的。

必须强调：osu数据库是使用.realm文件作为索引载体（相当于数据目录），这里面存放着数据索引，实际文件/链接是存放在data文件夹中的。如果没有.realm文件，客户端就不清楚数据是什么，因此如果你担心数据丢失，请务必备份client.realm文件。

在设置中，使用 更改osu!文件夹位置 按钮，选择对应文件夹（提示已有数据，是否重启，就表明识别正确），重启后即可生效。 此时Ez2Lazer会复制一份 client.realm 文件，改为 client_XX.realm。

• Ez2Lazer的Release/Debug端统一使用client_XX.realm作为数据归口。
• 如果你再想把官方数据复制到Ez2Lazer中，只能删除_XX.realm，然后重新生成，这也将丢失之前对_XX.realm中的一切改动（如成绩、记录、谱面等）。

mania-analysis_vX.sqlite / ez-analysis 是什么？ 为什么我启动Ez2Lazer后看到一个谱面分析进度条？

Ez2Lazer 配有独立的谱面分析指标。落点已拆分（详见 Ez Client Realm 架构）：

• Realm（client.realm）：基线 xxySR（🌙）、基线 PP、视频/故事板 Tag 三态、Mania Skills / ChartDan 等。
• analysis SQLite（ez-analysis_*.sqlite）：KPS 均值/峰值、按拍 KPS 折线、Mania 列/米/面统计；mod 变体 xxy/PP 走分支库。
• Local Profile SQLite（ez-local-profile.sqlite）：Skills 的单局轴证据与 dan clear 证据（与 Realm 技能摘要配合）。玩家面说明见 Mania 技能系统。

因此，为了提高使用体验和速度，请找时间耐心等待进度加载完成。 这套机制类似于官方的星级难度算法换版/PP算法换版时的后台计算。

• 启动程序时，加载数据库文件，如果是初次加载，则运行后台分析，建立/回填数据，通知进度条。
• 如果已有数据库，则直接加载。
• 在选歌界面，无 mod 时优先读 Realm / 已有缓存（内存操作，无硬盘 IO）。
• 画面可见难度会自动重新分析，并与数据库比较，写入或更新。