Designer handbook设计器手册
MDCX ships two Designers that share physics and solution identity: Liquid Cooling (cold-plate) and Immersion Cooling (tank). This page is the operator guide — open a published solution code, configure, then hand off to TCO or USD packages. MDCX 提供两款设计器，共享同一套物理模型与方案身份：液冷（冷板）与浸没液冷（液舱）。本页是操作指南——打开已发布的方案代码，完成配置，再交接至 TCO 或 USD 包。
1. Which Designer1. 选择哪款设计器
| Line产品线 | Open入口 | Published codes已发布代码 |
|---|---|---|
| Liquid Cooling液冷 | /design/liquid | L1240C45SUR150 (L1240C45) |
| Immersion Cooling浸没液冷 | /design/immersion | I400C45SUT50 (I400C45) · I400C40ST50 (I400C40) |
Draft codes (L1800C45DR220, L450C20DR150) appear as Coming soon on marketing pages only — Designers do not load draft profiles on the public site (D-19).草稿代码（L1800C45DR220、L450C20DR150）仅在市场页以「即将推出」呈现——公开站点的设计器不加载草稿配置档（D-19）。
2. Deep links2. 深链
Minimum required query field: code (D-14). Alias is optional convenience.最小必需查询字段：code（D-14）。别名为可选便利参数。
/design/liquid?code=L1240C45SUR150/design/immersion?code=I400C40ST50/tco?code=L1240C45SUR150— after TCO, primary CTA returns to Designer with the same code (D-15).TCO 之后，主 CTA 携同一代码返回设计器（D-15）。
code and alias are present, code wins.
Chrome always shows Alias first, SKU ID small underneath (D-13).
当 code 与 alias 同时存在时，以 code 为准。界面始终先显示别名，SKU ID 以小字置于其下（D-13）。
3. Calculation path3. 计算路径
One path only — do not invent parallel calculators:只有一条路径——不得另建并行计算器：
- UI updates store stateUI 更新 store 状态
- Store holds inputs (IT, cooling, site)Store 保存输入（IT、制冷、场地）
- Engine
calcAll(input)produces the snapshotEngine 由calcAll(input)生成快照 - Physics shared package
@mdcx/physicssupplies pure formulasPhysics 共享包@mdcx/physics提供纯函数公式
3D and charts read the engine snapshot only. Catalogs load from monorepo city-data/ and gpu-data/ via adapters.3D 与图表仅读取引擎快照。目录数据通过适配器从 monorepo 的 city-data/ 与 gpu-data/ 加载。
4. Recommended workflow4. 推荐工作流
- Pick a solution on product matrix or marketing overview.在产品矩阵或方案总览页选定方案。
- Run TCO for site economics (city, quantity, utilization).运行 TCO 测算站点经济性（城市、数量、利用率）。
- Open Designer from the TCO next-step CTA (carries
?code=).从 TCO 的下一步 CTA 打开设计器（自动携带?code=）。 - Tune racks / tanks / climate assumptions; review thermal and power tabs.调整机柜 / 液舱 / 气候假设；查看热与电力标签页。
- Download reference USD packages from the product page when needed — see USD output spec.如需参考几何，可在产品页下载 USD 参考包——参见 USD 输出规格。
5. Limits & claims5. 边界与对外表述
- Marketed numbers must match
docs/CLAIMS.md— Designers show engineering targets, not new claims.对外数字必须与docs/CLAIMS.md一致——设计器展示的是工程目标，而非新的对外承诺。 - No public pricing in Designers; commercial quotes go through account managers / TCO scenarios.设计器中不公开价格；商务报价通过客户经理 / TCO 情景提供。
- PWA install for Liquid Designer uses clean path
/design/liquid/(physical mirror on deploy). Legacy/DLC/dist/301s there.液冷设计器的 PWA 安装使用规范路径/design/liquid/（部署时做物理镜像）。旧路径/DLC/dist/以 301 跳转至此。