Artifact 开发入口

Artifact 入口适合“先有设计结构，再补行为与交付”的工作流。它的输入可以来自 Figma 同步、Codex 的 Flamo Design 插件、离线 Resource Pack，或直接调用 durable authoring API；这些路径最终都写入同一种 canonical Artifact。

最短闭环

选择项目与当前 Artifact revision
  -> bounded query，只读取本次任务需要的页面或子树
  -> typed authoring plan + dry-run
  -> revision-safe apply + durable receipt
  -> reload / critic / Runtime preview
  -> verify / publish

1. 先读取项目摘要、页面和目标节点，不要把完整 Artifact 当作普通 JSON 拉出后重写。
2. 用 typed operation 创建、移动、修改或删除节点；涉及资源时先注册 asset/font，涉及组件时使用 exact Component Ref 或 Resource Export。
3. 对现有项目始终携带 expectedArtifactRevision，先 dry-run，再以相同逻辑计划提交。
4. 提交后重新查询受影响子树，并核对 receipt、reload revision、结构 critic、字体与像素证据。
5. 在 Studio 中加载和调试，在 Runtime 中验证生命周期、多实例和失败隔离。

Artifact 里保存什么

Artifact 保存可传输的设计与行为事实，例如 scene、tokens、prototype、node-scoped artifacts、exports 和 metadata。DOM 节点、ECS Entity、监听器、GPU 资源和某次运行的临时状态不进入 Artifact。

常见修改不需要编辑底层字段：

• 图形与层级使用 node/hierarchy operation；
• 变量使用 authoring.variables；
• 组件、实例、Variant 与 Export 使用 durable authoring operation；
• 多组件组合进入 canonical Composition IR；
• 运行时临时状态通过 FlamoInstance API 修改，不写回 Artifact。

什么时候转到 TS/JS

Artifact 能表达结构、公开 surface、绑定和持久化脚本引用，但复杂业务逻辑、可复用算法、宿主服务适配以及组件级组合通常更适合在 TS/JS 中开发。转到 TS/JS 不会丢掉 Artifact：作者代码仍应生成或消费 canonical Artifact，最后由同一个 Runtime 执行。

下一步可查看 FlamoArtifact 字段手册或学习 TS/JS 开发入口。