理解应用与 Runtime 的边界
FastAPI 拥有业务对象，ComfyUI 负责推理。Runtime 教程的直接调用用于环境验证；产品客户端通过 FastAPI 工作。
一条明确的调用路径
Section titled “一条明确的调用路径”WebP2 正式客户端
FastAPIApplication Backend
RuntimeComfyUI / YuE2
产品 Web 只连接 FastAPI。Runtime Adapter 把原生执行事件转换为应用 Job 状态。客户端不依赖 ComfyUI node id 或 prompt id。
| 对象 | 含义 |
|---|---|
| Project | 围绕歌曲、改编或音乐实验组织创作。 |
| Asset | 可独立引用的实际文件。 |
| Score | 可检查、可编辑的音乐表示。 |
| Job | 一次可跟踪状态的转谱或生成请求。 |
| Candidate | 可试听和检查，但尚未保存的候选结果。 |
| Version | 创作者明确保存的一次有意义的创作变化。 |
保存结果的责任
Section titled “保存结果的责任”Runtime 输出先经过校验与导入，再成为应用拥有的 Asset。Candidate 只有在创作者明确保存后才成为 Version。
FastAPI 和 ComfyUI 使用独立的 uv 项目、环境与锁文件。普通 API 与文档构建不需要加载 GPU 模型。
要得到第一个实际结果，从环境准备进入；已有 Runtime 时查看转谱指南。
源码版本:
1ce3268正文来源: docs/learn/architecture.md