第 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。
- 产出:
- 01 架构拆解
- 02 功能清单与兼容契约(64 项功能,第一阶段验收基线)
- 03 缺陷与性能问题清单(74 条,带代码位置)
- 04 重构方案 v1
决策(方案 v1,待评审)
- 重写不移植;外部协议兼容。
- Go 模块化单体;前端 React SPA 嵌入二进制;插件走 WASM。
问题与风险
- BS 数据库零约束、零事务,导入时会遇到重名角色、大小写重复邮箱、悬空引用等脏数据 → 导入器必须先出报告。
- 玩家 UUID 必须原样迁移,否则服务器侧数据错位。
关键发现(摘录)
- 20 个迁移里没有一个业务索引/唯一约束;全项目没有事务。
- 皮肤库列表随数据量线性变慢(上游 #614:LittleSkin 1.3–1.8 s)。
- 积分读-改-写,可并发刷分;重置密码链接 1 小时内可重复使用;Yggdrasil 令牌只存缓存。
- 仓库自带 Dockerfile 构建出的镜像缺 imagick,启动即报错。
下期计划
- 评审方案 v1,确定前端框架、部署形态、插件标准、项目名、文档体系。