模型开发指南

把手里的实体，做成可以拿起、打开、翻阅，再好好收回的模型。

这份手册面向 DiscAtelier 模型作者。你会从一个能运行的教学盒开始，理解场景、贴图与状态图，再把自己的包装制作成可导入的 .ateliermodel 文件。

制作第一个模型 →查阅格式

你将交付什么

01 · 还原实物记录尺寸、材质、包装层级和开合关系。02 · 赋予动作点击拆装，单件查看，沿原路径归位。03 · 验证导入导出完整数据包，在目标应用保存并重开。

模型与应用的分工

模型包描述外观与交互，不携带可执行插件代码，不负责曲目匹配、歌词、播放或收藏资料。它也不会凭模型标题替你填写发行版本。收藏封面、购入记录与模型分别管理。

收藏架先显示封面；进入详情、取出检视后，应用才加载真实模型。拖动旋转、滚轮缩放、点击部件操作。返回时收纳并释放画布。模型作者负责实物拆装动作，应用负责收藏架取出与返回的界面过渡。

选择制作路线

需求	路线
新的单碟盒、多碟盒、纸套、书式包装	优先 V2：通用几何、材质和数据轨道。
已有专用装配结构，资源槽与实物完全吻合	V3：仅限当前应用注册的结构。
只有 OBJ、GLB、FBX 或 Blender 工程	不是可直接导入的成品；需整理场景、资源与交互，再导出 V2。

适用版本

本指南适用于 DiscAtelier 0.2.0。入门包包含模型制作工具、运行库、教学样例和校验脚本，可从零开始制作自己的实体模型。

首次制作可从入门教程开始，也可以使用 AI 制作 Skill 与提示词。已有制作经验时，可直接查阅格式参考和导入检查。