跳到主要内容

第 1 期 · 方案 v2:Next.js、启动器、插件标准与项目命名

· 阅读需 3 分钟

评审意见(来自项目负责人)​

  1. 前后端可以分离;Windows、macOS 发布时用脚本一键启动前后端或运行环境。
  2. 前端用 Next.js,React 没有问题。
  3. 插件要有自己的一套规则,不必兼容各种开发语言,但必须易于开发和学习、有统一标准,并开放足够的能力(含前端界面和主题)。
  4. 插件/系统配置、插件安装卸载要支持热加载。
  5. 项目需要一个名字,不能以 blessing 开头,鸣谢里保留 Blessing Skin。
  6. 项目开发与插件开发都要有文档,包括开发日志、更新日志等长期维护的文档。

本期完成​

意见落实文档
1改为 Go 后端 + Next.js 前端两个程序;Go 二进制内置启动器 skinloom up,拉起并监管 Node 子进程、对外单端口;发行包附便携 Node 与 start.bat / start.command / start.sh;Docker 拆成 server/web/all-in-one 三个镜像04 §2.1、§9
2Next.js App Router;公开页 SSR,后台 SSR 外壳 + 客户端组件;不依赖 ISR;不用 Module Federation04 §2.2、§2.4
3制定 SkinLoom 插件标准:一份 plugin.json + TypeScript + 一个 SDK + 一个 CLI;后端跑在 QuickJS-NG(WASM) 沙箱,前端运行时挂载到页面/插槽/区块;主题为 kind: "theme";能力总表、权限分级、Hook/插槽目录、存储(KV/文档集合/文件)、工具链、市场05
4全链路热加载:设置、文件配置热键、模块启停、插件安装/升级/卸载、主题切换;只有 DSN/监听地址/数据目录需重启04 §7、05 §9
5推荐 SkinLoom · 云织(npm、GitHub 账号均空闲);备选 Pixwear、Texelia;鸣谢落到 README、NOTICE、程序"关于"页04 §11
6Docusaurus 文档站(版本化 + 博客);CHANGELOG 自动生成 + 人写发布说明;devlog 双周;ADR06

决策​

  • 插件后端引擎选 QuickJS-NG(WASM/wazero,ES2023、内存上限、超时),不选 goja(ES5.1 + 部分 ES6、无内存上限)。引擎藏在 jsrt 接口后,插件只依赖 SDK。
  • 插件存储不开放 SQL:KV + 带索引槽位的文档集合 + 文件,三种数据库行为一致。
  • 插件 UI 不参与 SSR;需要 SEO 的首页用"区块"(内置区块 SSR,插件区块客户端渲染)。

问题与风险​

  • fastschema/qjs 项目较年轻(约 600 star)→ 自有接口隔离,必要时自维护 QuickJS-NG 的 WASM 构建。
  • macOS / Windows 未签名的可执行文件会被系统拦截 → 正式发行需要签名与公证(Apple 开发者账号;Windows 可考虑 SignPath 开源计划)。
  • 第一阶段工期从 17–20 周调整为 19–21 周(新增启动器、Next.js 打包、主题标准化)。

待确认​

D0 项目名、D1 后端框架(不用 Kratos)、D2 ent + Atlas、D4 OAuth2 进 v1、D6 beta 站点、D7 与熵增体系关系、D9 冷键清单。见 04 §12。

下期计划​

  • 确认待定项后建仓(skinloom),写首批 ADR,进入 M0。