跳到主要内容

架构决策记录(ADR)

格式与规则见 设计文档 06 §6。编号只增不改;被取代的记录保留并标注。

编号标题状态
0001前后端分离,Go 启动器一键运行已接受
0002Go 模块化单体:chi + Huma,不用 Kratos已接受
0003ent 建模,Atlas 生成迁移,goose 执行已接受
0004Next.js 渲染策略:公开页 SSR,不依赖 ISR,不用 Module Federation已接受
0005插件标准:TypeScript + JS 沙箱(QuickJS-NG/WASM)已接受
0006热加载模型:配置版本号 + 原子替换 + SSE已接受
0007插件存储不开放宿主原始 SQL(已被 0049 部分更新:Tier 2 原生插件支持隔离 SQL 库)已接受
0008项目命名:SkinLoom · 云织已接受
0009发行包由脚本构建,前端依赖扁平化已接受
0010可信代理、路径规范化与快速关闭已接受
0011包管理器 bun(回退 pnpm / npm),Node.js 24已接受
0012账号、会话与首次安装已接受
0013默认端口、部署清单与发布渠道已接受
0014注册与验证码已接受
0015后台任务队列与邮件已接受
0016个人资料、设备管理、注销与后台用户管理已接受
0017材质、文件存储与积分流水已接受
0018角色、UUID 与游戏皮肤接口已接受
0019收藏、材质编辑与删除、签到与用户中心已接受
0020举报、后台概览与后台角色、衣柜管理已接受
0021渲染器、站内通知与 S3 兼容存储已接受
0022Yggdrasil 外置登录(authlib-injector)已接受
0023OAuth 2.0 提供方、个人访问令牌与 Blessing Skin 兼容资源 API已接受
0024兼容 Blessing Skin 的管理类资源 API已接受
0025社交登录(GitHub、Microsoft、OpenID Connect)已接受
0026事务的加锁顺序(防死锁)已接受
0027事务里的判断放在加锁之后,加锁层级扩展到角色与删号已接受
0028领域事件经任务队列投递,审计记录与变更同事务已接受
0029M4 的拆分;设置中心:声明式校验与只写的密钥已接受
0030外观:主题切换、区块目录与自定义 CSS已接受
0031翻译覆盖放在设置里;系统状态页已接受
0032CDN 刷新跟随领域事件;backup / restore 命令已接受
0033系统服务命令、Helm Chart 与部署冒烟测试已接受
0034M4 全量审查的修正:恢复先检查后写入、设置保存串行化、密钥跟随去处已接受
0035M5 的拆分;BS 导入器(核心数据)已接受
0036BS 导入器:站点设置、翻译、OAuth 应用与签名密钥已接受
0037契约测试:黄金文件、authlib-injector 端到端、渲染快照与站点对比已接受
0038压测:k6 场景、百万材质的种子数据与压测发现的修正已接受
0039安全自查:内容安全策略与自定义 JavaScript,以及 ADR 0034 的遗留问题已接受
00401.0 收尾:目录分层(modules / platform)、统一的事务工具、按读者组织的文档已接受
0041终端日志:给人看的格式与 NOTICE 级别已接受
0042前端设计系统与组件库:shadcn/ui(Base UI)、lucide、TanStack Query、OFL 字体已接受
0043本地主题目录与主题清单扩展已接受(P4 实现)
0044交互式安装向导与 Pre-Core 启动模式已接受
0045插件存储预置槽位与 jsrt 沙箱实例池设计已接受
0046插件全量宿主扩展点、单源类型生成与 SDK/CLI 工具链已接受
0047前端插件运行时、20 处插槽挂载与主题 Level ⑤ 组件覆盖已接受
0048.slp 扩展包签名校验、热升级与多副本聚类同步已接受
0049双层插件架构(QuickJS 沙箱 + Native Go 独立子进程、双向 gRPC、流式代理与隔离 SQL 数据库)已接受
0050基于 GitOps 的静态签名插件与主题市场、多源容灾、五维兼容过滤与多架构 .slp 分发已接受