Skip to content

LZSync v1.1.0

Choose a tag to compare

@github-actions github-actions released this 07 Nov 13:14
· 14 commits to main since this release
12c7edf

新增旧版 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 净化、同内容
    重复目录去重等)。