Repository navigation
LZSync v1.1.0
新增旧版 osu!(stable)端接入:与四个 lazer fork 并列的第五端,
hub-and-spoke 模型下的双向同步(谱面集 / 收藏夹 / 皮肤;成绩、键位、
设置因两端模型不同构不适用)。
stable 端(新端)
- 端形态:无 realm 库——谱面为
Songs/解包目录 +osu!.db二进制
索引、收藏为collection.db、皮肤为Skins/目录。注册按目录特征
(含osu!.db)自动识别,安装目录任意(如~/Games/osu!)。 - 收集:以 Songs/ 目录扫描为真相源(投放后未开过游戏的目录立即
可见,闭环不依赖游戏跑过一遍);osu!.db供难度 MD5/星数等补充
元数据,缺失或损坏只计数不阻断。internal/legacydb解析器经真机
20260924 样本逐字节验证(208/208 难度 MD5 与 .osu 文件一致、解析
终点与文件尾重合,覆盖三个历史版本形态分叉)。 - 投放(链接式):谱面集构造
Songs/<setID> <artist> - <title>/
目录、逐文件链接到内容寻址仓(与收集回链同形态,磁盘只存一份字节);
收藏collection.db整文件原子重写(写前备份 → 临时 → 回读自检 →
rename);永不写osu!.db,新目录由游戏启动自动导入。游戏内删
谱面删除的只是链接,天然落入 tombstone/恢复模型。 - 跨端同键锚点(经真机对拍验证):难度 Hash = .osu SHA-256、难度
MD5、集哈希 = 集 .osu 按文件名序拼接的 SHA-256——同一谱面两端同键,
三方判定直接可比;集身份键online:<BeatmapSetID>两端对齐。 - 皮肤:收集按目录规范化哈希(stable 变体自有其键);跨端配对走
Name 弱键,双侧防重复防线(同名不同内容键视为同皮肤变体,跳过不
覆盖,确需导入改名重投)。 - 现场复核:同内容(难度 Hash 集合一致——含 lazer 集哈希导入缓存
stale 的兜底)/ 版本分歧(替换走确认不自动写)/ 仓缺字节(绝不落
半套目录)三路跳过。
架构
ForkProfile.Storage端存储载体类型(realm / legacy 文件系统):
collect/deploy 按其分派投影器与写入后端,判定引擎、hub、板块开关
零改动——「新增端 = 新增一份 Profile,不改内核」承诺在写入载体层
兑现。- 守卫消歧:wine 进程名
osu!.exe与 lazer 的osu!精确匹配天然
区分;Windows 上两端镜像同名属平台固有项(按可执行路径消歧留待
后续)。 - 格式知识自包含固化于
docs/research/stable-legacy.md(ppy/osu 官方
wiki 格式表 + 本机实测注记:lazer 集哈希 stale、NaN 净化、同内容
重复目录去重等)。