资产命名规则(教学项目)
这是为 CC-01 编写的独立例子。规则用于演示如何把需求变成可验证的工具,并非 Unreal Engine、Unity 或行业统一标准。工具只检查CSV中写出的名称,不扫描资产、不读取模型或纹理内容、不判断文件是否真实存在。
输入必须是UTF-8 CSV,表头按顺序为 asset_type,name,至少有一条资产记录。
| 类型 | 前缀 | 扩展名 | 合规样例 |
|---|---|---|---|
| StaticMesh | SM_ | .fbx | SM_Rock_01.fbx |
| Texture | T_ | .png/.exr | T_Rock_BaseColor.png |
只支持这两类。前缀和扩展名区分大小写。前缀后的名称主体由英文字母/数字组成,可用单个下划线分隔非空片段;主体不能留空。名称必须是单个文件名,不含 / 或 \。同一份清单不能出现重复名称。输入两侧空格不会自动删除。
| 退出码 | 含义 |
|---|---|
| 0 | 清单全部合规 |
| 1 | 清单可以读取,但发现资产命名问题 |
| 2 | 输入无法读取、表头/行格式错误,或清单为空 |
遇到命名问题,要报告CSV物理行号、名称和原因;输出总条数、合规数、问题数。多种原因可以出现在同一条资产记录上,问题数按资产记录计数。遇到输入错误,写入终端错误输出,不生成不完整的资产报告。