跳到主要内容

第 0 期 · 立项与 Blessing Skin 拆解

· 阅读需 2 分钟

本期完成​

  • 建立工作区 bs-community/,克隆 blessing-skin-server、blessing-skin-plugin-docs、skinview3d;额外克隆 blessing-skin-plugins(Yggdrasil、USM、Legacy、存储、CDN 等站点刚需都在插件里)。
  • 通读 BS 后端全部 120 个 PHP 文件、路由、20 个迁移、插件系统与 Yggdrasil 插件,对照上游 open issues。
  • 产出:

决策(方案 v1,待评审)​

  • 重写不移植;外部协议兼容。
  • Go 模块化单体;前端 React SPA 嵌入二进制;插件走 WASM。

问题与风险​

  • BS 数据库零约束、零事务,导入时会遇到重名角色、大小写重复邮箱、悬空引用等脏数据 → 导入器必须先出报告。
  • 玩家 UUID 必须原样迁移,否则服务器侧数据错位。

关键发现(摘录)​

  • 20 个迁移里没有一个业务索引/唯一约束;全项目没有事务。
  • 皮肤库列表随数据量线性变慢(上游 #614:LittleSkin 1.3–1.8 s)。
  • 积分读-改-写,可并发刷分;重置密码链接 1 小时内可重复使用;Yggdrasil 令牌只存缓存。
  • 仓库自带 Dockerfile 构建出的镜像缺 imagick,启动即报错。

下期计划​

  • 评审方案 v1,确定前端框架、部署形态、插件标准、项目名、文档体系。