Skip to content

Runtime Kit 契约 ​

Runtime Kit 是页面源码、工作空间组件源码和 previewSchema 可以引用的公共能力集合。

manifest ​

公开能力以 runtime/src/runtime-kit/manifest/runtime-kit.manifest.json 为单一事实源。Backend 通过该清单校验页面源码、组件源码和 previewSchema 的导入边界。

命名规则 ​

  • 清单项名称必须使用 <ExportName>.v<整数版本>。
  • 公开 import path 必须带 .vN。
  • 不兼容演进时新增 v2/v3 文件,不修改仍被依赖的旧版本文件。

禁止暴露 ​

Runtime shell 内部组件、component-preview 宿主页、PDF 导出、侧栏、缩略图、Toast、ErrorBoundary 等壳层能力不应通过 Runtime Kit 暴露给页面源码、组件源码或 AI 能力目录。

测试要求 ​

Runtime Kit manifest 或公开 import path 变化时,应补充 Runtime manifest 测试和根仓 Backend 契约测试。