Docs · Specs · D-09 P0 · v0.1文档 · 规格 · D-09 P0 · v0.1

USD output specificationUSD 输出规格

This document defines how MDCX publishes and accepts OpenUSD (typically .usdc) reference designs for modular AI data center containers. It is the first normative engineering spec in the Docs MVP — partners, factories, and future Designer exports should align to these rules. 本文定义 MDCX 如何发布与接收模块化 AI 数据中心集装箱的 OpenUSD（通常为 .usdc）参考设计。这是 Docs MVP 中第一份规范性工程规格——合作伙伴、工厂以及未来的设计器导出均应遵循这些规则。

Status: Public draft v0.1 · 2026-08-10 · Identity via solution code (D-11) · Presentation of 3D on the web follows MEDIA / D-12 (poster first; heavy USD is download-only).状态：公开草案 v0.1 · 2026-08-10 · 身份以方案代码为准（D-11） · 网页 3D 呈现遵循 MEDIA / D-12（先海报图；大体积 USD 仅供下载）。

1. Scope1. 适用范围

In scope:范围内：

Container-level reference models for published SKUs (e.g. L1240C45SUR150 / alias L1240C45).已发布 SKU 的集装箱级参考模型（例如 L1240C45SUR150 / 别名 L1240C45）。
Packaging for public download (.usdc.zip, .usdc.xz) under /assets/3D/.置于 /assets/3D/ 下的公开下载封装（.usdc.zip、.usdc.xz）。
Prim naming, units, up-axis, and LOD tiers so digital-twin and BIM consumers can merge assets reliably.Prim 命名、单位、上轴与 LOD 层级，使数字孪生与 BIM 使用方能够可靠地合并资产。

Out of scope for v0.1:v0.1 范围外：

Live Omniverse streams, material shading brand kits, or full facility site models.Omniverse 实时流、材质着色品牌套件，或完整园区场地模型。
Blender source files (AC_3D/, DC45_3D/) — internal only; not deployed to Pages.Blender 源文件（AC_3D/、DC45_3D/）——仅限内部；不部署到 Pages。
Pricing, BOM cost, or TCO numbers (those live in TCO / CLAIMS).价格、BOM 成本或 TCO 数字（这些位于 TCO / CLAIMS）。

2. Identity binding2. 身份绑定

Every published USD package must map to exactly one solution code from the product matrix.每一个已发布的 USD 包必须唯一对应产品矩阵中的一个方案代码。

Alias别名	SKU ID (code)SKU ID（代码）	Public package (examples)公开包（示例）
L1240C45	`L1240C45SUR150`	`L1240C45-1200KW.usdc.zip` (legacy filename OK; prefer SKU in metadata)（沿用旧文件名可接受；建议在元数据中写入 SKU）
I400C45	`I400C45SUT50`	`I400C45.usdc.xz`
—	`L1800C45DR220` (draft)（草稿）	Reference geometry may exist as download; no full product page until Publish可提供参考几何下载；发布前不开放完整产品页
—	`L450C20DR150` (draft)（草稿）	Same as above同上

Rule: Changing IT power, loop topology, UPS flag, size, or density creates a new SKU ID. Do not overwrite the meaning of an existing code. Archive old packages with a dated suffix if needed. 规则：变更 IT 功率、回路拓扑、UPS 标志、尺寸或密度，即产生新的 SKU ID。不得覆盖既有代码的含义。必要时以日期后缀归档旧包。

3. Units & coordinate system3. 单位与坐标系

Property属性	Requirement要求
Linear units长度单位	Meters (USD metersPerUnit = 1.0). Document any exception in package README.米（USD metersPerUnit = 1.0）。任何例外须在包内 README 中说明。
Up axis上轴	Y-up preferred for Omniverse / common DCC; if Z-up, set stage upAxis and document in metadata.为兼容 Omniverse / 常见 DCC，优先 Y 轴向上；若为 Z 轴向上，须设置 stage upAxis 并在元数据中说明。
Origin	Container exterior footprint: origin at floor plane, door-end centerline (or documented alternative). Include a `World` / `Root` xform that is identity at rest.以集装箱外轮廓为准：原点位于地面平面、门端中心线（或另行说明的替代位置）。须包含静止状态为单位矩阵的 `World` / `Root` xform。
Forward	+Z out the long axis toward the far end (document if mirrored for a twin container).+Z 沿长轴指向远端（若为双箱镜像布置须说明）。
Scale	1:1 real world. No “cm” meshes scaled 0.01 without correcting metersPerUnit.1:1 实尺。不得在未修正 metersPerUnit 的情况下使用缩放 0.01 的「厘米」网格。

4. Prim & asset naming4. Prim 与资产命名

Use ASCII identifiers; prefer PascalCase for Xforms and snake_case only for files on disk.使用 ASCII 标识符；Xform 优先 PascalCase，snake_case 仅用于磁盘文件名。

Root prim:根 prim： /MDCX/<SKU_ID> e.g.例如 /MDCX/L1240C45SUR150
Alias custom data:别名自定义数据： mdcx:alias = "L1240C45", mdcx:code = "L1240C45SUR150", mdcx:line = "LiquidCooling"|"ImmersionCooling"
Major systems (suggested children):主要系统（建议的子 prim）： Envelope, Racks or Tanks, Cooling, Power, CableTrays, Clearances
Instanceable racks/tanks:可实例化的机柜/液舱： Rack_01… or或 Tank_01… with stable indices matching Designer layout order when possible.使用稳定索引，尽可能与设计器布局顺序一致。
Do not put marketed kW numbers only in mesh names — numbers belong in CLAIMS / matrix; mesh names are structural.不要把对外 kW 数字只写在网格名称里——数字归属 CLAIMS / 矩阵；网格名称只表达结构。

File names on the public CDN may retain legacy labels (L1240C45-1200KW.usdc) for continuity; the stage metadata must still carry the canonical SKU ID.公开 CDN 上的文件名可沿用旧标签（L1240C45-1200KW.usdc）以保持连续性；但 stage 元数据仍必须携带规范 SKU ID。

5. LOD tiers5. LOD 层级

LOD	Purpose用途	Guidance指引
`LOD0`	Marketing / web poster source市场 / 网页海报图来源	Simplified shell + major equipment silhouettes; safe for Sketchfab-class polycounts.简化外壳 + 主要设备轮廓；面数适配 Sketchfab 级别。
`LOD1`	Design coordination设计协同	Racks/tanks, CDU, busways, clearances; default public download when only one file is published.机柜/液舱、CDU、母线、检修间距；仅发布单一文件时的默认公开下载版本。
`LOD2`	Factory / detailed twin工厂 / 精细孪生	Optional private package; fasteners and non-critical clutter may be included. Not required on mdcx.org.可选的私有包；可包含紧固件等非关键细节。mdcx.org 上非必需。

If a single file is shipped, treat it as LOD1 and state that in the download caption.若仅交付单一文件，按 LOD1 处理，并在下载说明中注明。

6. Packaging & delivery6. 封装与交付

Format: binary USDA crate .usdc preferred for download size; optional .usda sidecar for human review (not required publicly).格式：为控制下载体积优先使用二进制 crate .usdc；可选附带 .usda 供人工审阅（公开发布非必需）。
Compression: publish as .usdc.zip or .usdc.xz. Never force multi-hundred-MB raw CAD on first paint (D-12 / PERFORMANCE).压缩：以 .usdc.zip 或 .usdc.xz 发布。绝不在首屏强制加载数百 MB 的原始 CAD（D-12 / PERFORMANCE）。
Textures: either embed or ship a sibling textures/ folder with relative paths; document if textures are omitted (clay / workbench look).贴图：可内嵌，或以相对路径附带同级 textures/ 目录；若省略贴图（clay / workbench 外观）须说明。
Web 3D: Sketchfab (or similar) is a presentation surface — poster + click-to-load only. It does not replace the USD package as the interchange truth.网页 3D：Sketchfab（或同类）只是呈现层——仅海报图 + 点击加载。它不能替代 USD 包作为数据交换的权威来源。
Version label: include mdcx:usdSpec = "0.1" and an ISO date mdcx:exportedAt in customLayerData when tooling allows.版本标记：在工具支持时，于 customLayerData 中写入 mdcx:usdSpec = "0.1" 与 ISO 日期 mdcx:exportedAt。

7. Export checklist7. 导出检查清单

Before publishing a package next to a product page or Docs link:在产品页或文档链接旁发布包之前：

SKU ID in stage metadata matches PRODUCT-MATRIX / code used in UI.stage 元数据中的 SKU ID 与 PRODUCT-MATRIX / 界面所用代码一致。
metersPerUnit = 1; up-axis documented; origin documented in one sentence.metersPerUnit = 1；已说明上轴；已用一句话说明原点。
Root path /MDCX/<SKU_ID> (or documented deviation).根路径为 /MDCX/<SKU_ID>（或已说明的偏差）。
No accidental customer PII, internal paths, or vendor license keys in layer comments.图层注释中无误留的客户个人信息、内部路径或厂商许可密钥。
File opens in at least one of: usdview, Omniverse, Blender USD, or USD Composer (note which).文件至少能在 usdview、Omniverse、Blender USD 或 USD Composer 之一中打开（注明是哪一个）。
Compressed download under 200 MB preferred; if larger, call out size next to the button.压缩后下载体积建议小于 200 MB；若更大，须在按钮旁标注体积。
Marketing page uses poster-first media; USD is explicit download, not auto-fetched.市场页采用先海报图的媒体策略；USD 为显式下载，不自动拉取。
Draft SKUs are not presented as orderable shipped products.草稿 SKU 不得呈现为可下单的在售产品。

8. Designer / TCO linkage (forward-looking)8. 设计器 / TCO 联动（前瞻）

When Designers export geometry or an asset manifest:当设计器导出几何或资产清单时：

Minimum query identity remains ?code=<SKU_ID> (D-14).最小查询身份仍为 ?code=<SKU_ID>（D-14）。
Export manifest JSON should include at least: code, optional alias, usdSpec version, and package filename.导出清单 JSON 至少应包含：code、可选的 alias、usdSpec 版本，以及包文件名。
TCO does not embed USD; post-TCO CTA opens Designer with the same code (D-15).TCO 不内嵌 USD；TCO 之后的 CTA 携同一 code 打开设计器（D-15）。

9. Current public packages9. 当前公开包

Hosted under /assets/3D/ (see product pages for buttons):托管于 /assets/3D/（下载按钮见各产品页）：

File文件	Maps to对应	Notes备注
`L1240C45-1200KW.usdc.zip`	L1240C45 · `L1240C45SUR150`	Primary liquid reference · UPS configuration液冷主参考模型 · 含 UPS 配置
`L1240C45-2400KW-GEMINI.usdc.zip`	2× L1240C45 twin layout2× L1240C45 双箱布置	Site arrangement example场地布置示例
`DLC45-1800KW.usdc.xz`	`L1800C45DR220` (draft)（草稿）	Geometry reference · Coming soon product几何参考 · 即将推出的产品
`DLC20-450KW.usdc.xz`	`L450C20DR150` (draft)（草稿）	Geometry reference · Coming soon product几何参考 · 即将推出的产品
`I400C45.usdc.xz`	I400C45 · `I400C45SUT50`	Immersion reference浸没液冷参考模型

10. Changelog10. 变更记录

Version版本	Date日期	Notes备注
0.1	2026-08-10	Initial public draft: units, naming, LOD, packaging, checklist (D-09).首个公开草案：单位、命名、LOD、封装、检查清单（D-09）。

Normative companions:规范性配套文件： docs/PRODUCT-MATRIX.md · docs/rules/NAMING.md · docs/rules/MEDIA.md · docs/CLAIMS.md (numbers only — not geometry).（仅数字，不含几何）。 Questions:咨询： [email protected]