跳到主要内容

双轨插件平台、官方签名市场与首批官方扩展收官

· 阅读需 3 分钟

云织 SkinLoom 插件与主题平台(P2-1 ~ P2-6)已全部完成基建验收、独立市场上线及首批官方扩展落地,apiVersion: 1 与 native.protocolVersion: 1 正式冻结。

本期完成​

  • 双轨插件运行时(ADR 0045–0049):
    • Tier 1(runtime: "js"):进程内 QuickJS/WASM 确定性沙箱池、指令燃料/内存硬限、25 组 ctx.* 宿主 API、47 个 Hook(21 Guard / 7 Filter / 19 Event)、20 个前端插槽、5 个声明式表单扩展点与 Level ⑤ 主题组件覆盖。
    • Tier 2(runtime: "native"):基于 hashicorp/go-plugin 双向 gRPC 子进程、sdk/go、sdk/go/plugindb 三方言隔离 SQL 数据库(plg_<id>_ 规范前缀)、sdk/go/plugintest 进程内测试套件、本地 HTTP/SSE/WebSocket 流式反代与 Storage/Search/Render 底层驱动扩展。
  • 官方静态签名插件市场(ADR 0050):
    • 独立维护 Entropy-Increase-Team/skinloom-registry:纯源码 Commit SHA 登记、差量 PR 安全门禁、真实源码检出与 plugin.json 一致性核验、受保护环境 5 平台交叉编译 + 官方 Ed25519 私钥签名与 blocked.yaml 恶意包全网自动热禁用。
    • 宿主侧完成 RegistryClient、五维环境兼容匹配、拓扑依赖级联安装、多架构集群按需回源、后台「插件市场」与外观页「浏览主题市场」UI 及 skinloom plugin search / market-install / upgrade CLI。
  • 独立官方插件库与首批 5 个官方扩展(skinloom-plugins):
    • Tier 1 JS 沙箱插件:invitation-codes、mojang-verification、texture-description;
    • Level ⑤ 示范主题:theme-atelier(完整覆盖 L1–L5 与 site.footer / texture.card 组件覆盖);
    • Tier 2 Native Go 插件:bs-importer(遵循方案 A,按需安装、迁完可卸载,直连 BS 数据库或对接升级后的 blessing-skin-export-bridge 补迁第三方 BS 插件扩展表)。
  • 文档站定稿:补齐 TS 插件快速入门、Go 原生插件进阶指南、主题 L1–L5 指南与 API v1.0 参考手册。

关键架构决策​

  • ADR 0045 · ADR 0046 · ADR 0047 · ADR 0048 · ADR 0049 · ADR 0050。
  • 三仓职责解耦:skinloom(核心服务 + 前端 + SDK/CLI)、skinloom-plugins(官方插件与主题源码)、skinloom-registry(GitOps 静态签名索引与受控分发)。
  • Blessing Skin 迁移两层分离(方案 A):核心账号/角色/材质/密钥/设置保留在主程序 Pre-Core 安装向导与离线 CLI(进入正常模式后零运行时开销);BS 第三方插件扩展表迁移通过可卸载 Tier 2 插件 bs-importer + 跨插件服务闭环完成。

下期计划​

  • 推送 skinloom-plugins 独立仓库并在 skinloom-registry 配置正式离线 Ed25519 签名密钥与 production-signing 环境;
  • 通过 PR 将首批 5 个官方扩展上架至官方市场,完成云端 Runner 5 平台编译与线上实测闭环;
  • 准备 SkinLoom v1.1.0 正式发布。

第 33 期 · 前端重构 P1:组件库

· 阅读需 4 分钟

上一期打好了设计系统的地基,这一期把组件库补齐:

  • shadcn/ui 的 44 个基础组件装进 @skinloom/ui,按设计系统调了尺寸、圆角和颜色;
  • 皮肤站自己的十几个组件,包括首页那个"皮肤在走路"的展示区;
  • 后台多了一个组件总览页,主题作者改完颜色可以在这里一眼核对。

页面本身还是老样子,下一期开始换外壳(顶栏、侧栏、手机菜单)。

第 34 期 · 前端重构 P2:外壳

· 阅读需 3 分钟

这一期换的是"框":顶栏、页脚、用户中心和后台的侧栏、登录页的外框。页面内容还是旧的,下一期 P3 逐页重做。

  • 手机上顶栏不再溢出:375px 宽度下,页面宽度从 434px 变回 375px;
  • 用户中心第一次有了导航,后台从一排文字链接换成了分组侧栏;
  • 访客、登录用户、管理员看到的顶栏各不相同,各自只放用得到的东西。

第 35 期 · 前端重构 P3:重做全部页面

· 阅读需 4 分钟

前三期把配色字体、组件库和顶栏侧栏立了起来,这一期把里面的页面全部重做一遍:

  • 首页换上了"皮肤在走路"的展示区,其它区块去掉了模板化的卡片堆叠;
  • 皮肤库、材质详情、上传页、用户中心和管理后台全部换用新组件;
  • 全站 14 处浏览器自带的确认框、14 处原生下拉框全部清零,中英文文案按设计规则重写了一遍。

第 32 期 · 前端重构开工:设计系统的地基

· 阅读需 4 分钟

1.0 的前端功能齐全,但看起来像拼起来的:组件库只有 5 个组件,14 个地方弹浏览器自带的确认框,中文用的是各平台的系统字体,手机上顶栏会溢出。这期开始重做前端,先打地基:

  • 一套设计规则(web/design.md)和一份重构方案(设计文档 07),配了 Pencil 画的高保真原型;
  • 新的配色与字体,换进两个内置主题;
  • TanStack Query、菜单图标表和一个拦住"写死颜色"的检查。

页面本身这期还没动,下一期是组件库。

第 31 期 · 1.0 收尾:整理代码与文档

· 阅读需 5 分钟

1.0 之前的一次大扫除,这期没有新功能:

  • 后端目录分了层,一眼能看出哪些是业务、哪些是基础设施;
  • 九份各写各的事务辅助函数合成一份,顺手修掉一个会让 SQLite 站点卡死的问题;
  • 文档按玩家、站长、开发者重新组织,README 从 276 行减到不到 80 行。

接下来是前端优化,然后是 1.x 与 2.0。