文档 · 规格 · D-09 P0 · v0.1
USD 输出规格
本文定义 MDCX 如何发布与接收模块化 AI 数据中心集装箱的 OpenUSD（通常为 .usdc）参考设计。这是 Docs MVP 中第一份规范性工程规格——合作伙伴、工厂以及未来的设计器导出均应遵循这些规则。
1. 适用范围
范围内：
- 已发布 SKU 的集装箱级参考模型（例如
L1240C45SUR150/ 别名 L1240C45）。 - 置于
/assets/3D/下的公开下载封装（.usdc.zip、.usdc.xz）。 - Prim 命名、单位、上轴与 LOD 层级，使数字孪生与 BIM 使用方能够可靠地合并资产。
v0.1 范围外：
- Omniverse 实时流、材质着色品牌套件，或完整园区场地模型。
- Blender 源文件（
AC_3D/、DC45_3D/）——仅限内部；不部署到 Pages。 - 价格、BOM 成本或 TCO 数字（这些位于 TCO / CLAIMS）。
2. 身份绑定
每一个已发布的 USD 包必须唯一对应产品矩阵中的一个方案代码。
| 别名 | SKU ID（代码） | 公开包（示例） |
|---|---|---|
| L1240C45 | L1240C45SUR150 |
L1240C45-1200KW.usdc.zip （沿用旧文件名可接受；建议在元数据中写入 SKU） |
| I400C45 | I400C45SUT50 |
I400C45.usdc.xz |
| — | L1800C45DR220 （草稿） |
可提供参考几何下载；发布前不开放完整产品页 |
| — | L450C20DR150 （草稿） |
同上 |
规则：变更 IT 功率、回路拓扑、UPS 标志、尺寸或密度，即产生新的 SKU ID。不得覆盖既有代码的含义。必要时以日期后缀归档旧包。
3. 单位与坐标系
| 属性 | 要求 |
|---|---|
| 长度单位 | 米（USD metersPerUnit = 1.0）。任何例外须在包内 README 中说明。 |
| 上轴 | 为兼容 Omniverse / 常见 DCC，优先 Y 轴向上；若为 Z 轴向上，须设置 stage upAxis 并在元数据中说明。 |
| Origin | 以集装箱外轮廓为准：原点位于地面平面、门端中心线（或另行说明的替代位置）。须包含静止状态为单位矩阵的 World / Root xform。 |
| Forward | +Z 沿长轴指向远端（若为双箱镜像布置须说明）。 |
| Scale | 1:1 实尺。不得在未修正 metersPerUnit 的情况下使用缩放 0.01 的「厘米」网格。 |
4. Prim 与资产命名
使用 ASCII 标识符；Xform 优先 PascalCase，snake_case 仅用于磁盘文件名。
- 根 prim：
/MDCX/<SKU_ID>例如/MDCX/L1240C45SUR150 - 别名自定义数据：
mdcx:alias = "L1240C45",mdcx:code = "L1240C45SUR150",mdcx:line = "LiquidCooling"|"ImmersionCooling" - 主要系统（建议的子 prim）：
Envelope,RacksorTanks,Cooling,Power,CableTrays,Clearances - 可实例化的机柜/液舱：
Rack_01… 或Tank_01… 使用稳定索引，尽可能与设计器布局顺序一致。 - 不要把对外 kW 数字只写在网格名称里——数字归属 CLAIMS / 矩阵；网格名称只表达结构。
公开 CDN 上的文件名可沿用旧标签（L1240C45-1200KW.usdc）以保持连续性；但 stage 元数据仍必须携带规范 SKU ID。
5. LOD 层级
| LOD | 用途 | 指引 |
|---|---|---|
LOD0 |
市场 / 网页海报图来源 | 简化外壳 + 主要设备轮廓；面数适配 Sketchfab 级别。 |
LOD1 |
设计协同 | 机柜/液舱、CDU、母线、检修间距；仅发布单一文件时的默认公开下载版本。 |
LOD2 |
工厂 / 精细孪生 | 可选的私有包；可包含紧固件等非关键细节。mdcx.org 上非必需。 |
若仅交付单一文件，按 LOD1 处理，并在下载说明中注明。
6. 封装与交付
- 格式：为控制下载体积优先使用二进制 crate
.usdc；可选附带.usda供人工审阅（公开发布非必需）。 - 压缩：以
.usdc.zip或.usdc.xz发布。绝不在首屏强制加载数百 MB 的原始 CAD（D-12 / PERFORMANCE）。 - 贴图：可内嵌，或以相对路径附带同级
textures/目录；若省略贴图（clay / workbench 外观）须说明。 - 网页 3D：Sketchfab（或同类）只是呈现层——仅海报图 + 点击加载。它不能替代 USD 包作为数据交换的权威来源。
- 版本标记：在工具支持时，于 customLayerData 中写入
mdcx:usdSpec = "0.1"与 ISO 日期mdcx:exportedAt。
7. 导出检查清单
在产品页或文档链接旁发布包之前：
- stage 元数据中的 SKU ID 与 PRODUCT-MATRIX / 界面所用代码一致。
- metersPerUnit = 1；已说明上轴；已用一句话说明原点。
- 根路径为
/MDCX/<SKU_ID>（或已说明的偏差）。 - 图层注释中无误留的客户个人信息、内部路径或厂商许可密钥。
- 文件至少能在 usdview、Omniverse、Blender USD 或 USD Composer 之一中打开（注明是哪一个）。
- 压缩后下载体积建议小于 200 MB；若更大，须在按钮旁标注体积。
- 市场页采用先海报图的媒体策略；USD 为显式下载，不自动拉取。
- 草稿 SKU 不得呈现为可下单的在售产品。
8. 设计器 / TCO 联动（前瞻）
当设计器导出几何或资产清单时：
- 最小查询身份仍为
?code=<SKU_ID>（D-14）。 - 导出清单 JSON 至少应包含：
code、可选的alias、usdSpec版本，以及包文件名。 - TCO 不内嵌 USD；TCO 之后的 CTA 携同一
code打开设计器（D-15）。
9. 当前公开包
托管于 /assets/3D/（下载按钮见各产品页）：
| 文件 | 对应 | 备注 |
|---|---|---|
L1240C45-1200KW.usdc.zip | L1240C45 · L1240C45SUR150 | 液冷主参考模型 · 含 UPS 配置 |
L1240C45-2400KW-GEMINI.usdc.zip | 2× L1240C45 双箱布置 | 场地布置示例 |
DLC45-1800KW.usdc.xz | L1800C45DR220 （草稿） | 几何参考 · 即将推出的产品 |
DLC20-450KW.usdc.xz | L450C20DR150 （草稿） | 几何参考 · 即将推出的产品 |
I400C45.usdc.xz | I400C45 · I400C45SUT50 | 浸没液冷参考模型 |
10. 变更记录
| 版本 | 日期 | 备注 |
|---|---|---|
| 0.1 | 2026-08-10 | 首个公开草案：单位、命名、LOD、封装、检查清单（D-09）。 |
规范性配套文件：
docs/PRODUCT-MATRIX.md ·
docs/rules/NAMING.md ·
docs/rules/MEDIA.md ·
docs/CLAIMS.md （仅数字，不含几何）。
咨询： [email protected]