配套资料

资产命名规则(教学项目)

这是为 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物理行号、名称和原因;输出总条数、合规数、问题数。多种原因可以出现在同一条资产记录上,问题数按资产记录计数。遇到输入错误,写入终端错误输出,不生成不完整的资产报告。