Skip to content

previewSchema 契约 ​

previewSchema 用于描述工作空间组件的典型预览输入,让 Runtime 可以渲染组件不同状态,并让 AI 理解组件参数边界。

职责 ​

  • 组件作者提供典型参数组合。
  • Backend 校验 previewSchema 中的可导入能力。
  • Runtime 根据 schema 渲染组件预览。
  • Editor 展示预览结果和错误信息。

约束 ​

previewSchema 不能引用未进入 Runtime Kit manifest 的能力,也不能依赖 Runtime shell 内部实现。需要资源、字体或主题时,应通过平台公开对象引用。

测试 ​

调整 previewSchema 结构、校验规则或 Runtime 渲染方式时,应补充 Backend 契约测试、Runtime 组件预览测试和必要的 Editor 展示测试。