feat: 搭建设计生成工作台骨架

This commit is contained in:
que01 committed 2026-10-15 15:54:21 +08:00
1 parent bf4bbf81c7
commit 083a323c1f
20 files changed
+587 -1

No files matched your search

+43
View File
@@ -0,0 +1,43 @@
# 0028. Design Lab 边界与设计中间层
## Context
Stitch 不再可用,但产品仍需要把客户需求转化为可预览的小程序设计稿,并保留足够结构化的信息供后续 AI 或确定性工具转换。直接把图片转成 HTML 的保真度不足;直接生成自由 React 代码会破坏现有模板系统和管理端边界。
## Decision
- Design Lab 在当前 monorepo 内实现,暂不新开仓库。
- `packages/design-spec` 是唯一设计源头,定义 `DesignSpec`、校验器和 HTML renderer。
- `apps/design-lab` 是独立内部工具,只负责编辑 DesignSpec、展示校验结果和渲染预览。
- DesignSpec 只允许使用受控 section 类型与设计 token,不允许描述数据库访问或小程序实现细节。
- 渲染出的 HTML 是设计稿和机器可读中间层,必须携带 `data-template-section`、`data-field`、`data-action` 标注。
- Design Lab 第一阶段不直接修改生产模板包,也不直接连接 API 数据库。
## Alternatives
1. 新建独立仓库:共享 schema 与工程门槛成本更高,等出现独立产品化边界后再拆。
2. 放入 Admin:会让后台管理职责和设计生产工具耦合,增加后台 bundle 与权限复杂度。
3. 直接生成 React / Taro:容易形成第二套 UI 架构,也无法稳定保证字段契约。
4. 图片直接转 HTML:缺少语义结构,保真度和可回溯性不足。
## Consequences
### Positive
- 设计可以版本化、校验和回滚。
- HTML 对 AI 转换友好,同时保留人可预览的视觉结果。
- 设计工具与线上管理系统、模板包保持隔离。
- 后续可以扩展截图、视觉回归和 manifest 生成,而不改变源头模型。
### Negative
- 第一版只能覆盖受限 section 和设计 token,无法表达任意视觉稿。
- 需要 DesignSpec schema 与模板 manifest 的映射文档持续维护。
- 多一个内部应用,需要纳入全局检查流程。
## Migration Plan
1. 先提供 DesignSpec schema、校验器、HTML renderer 和基础工作台。
2. 加入 Playwright 截图与视觉检查,形成可归档的设计稿。
3. 补充 DesignSpec 到 template manifest / Taro 模板的半自动转换流程。
4. 用至少两个真实行业需求验证完整链路后,再考虑持久化和多人协作。