项目说明 & 更新记录 — PCM系统场景演示

PCM 相变储热系统 3D 可视化演示平台

本项目面向 PCM（Phase Change Material，相变材料）热管理领域，构建了 6 大典型应用场景的交互式 3D 演示系统。涵盖数据中心风冷/液冷散热、PCM 热缓冲罐（串入式）、LNG 冷能梯级利用、商业冷库削峰填谷、储能电池热管理等方向，支持实时物理仿真、24h 运行演示、物理参数可调与契约驱动配置。

物理层

TypeScript 物理内核 → Vite IIFE 构建 → dist/sN-fmd-core.js

表现层

Three.js WebGL + Vanilla JS 场景壳层 + shared/ 公共库

运行时

scene.js 全局状态 → app.js 动画循环 → FMD Core sync/step → 3D 渲染 + UI 刷新

公共模块

utils.js pipes.js ir.js presets.js ui.js devices.js portRegistry.js demo24h.js

场景	名称	简述
S1	风冷边缘机房	Edge IDC 风冷 + PCM 辅助移峰
S2	液冷数据中心	液冷系统 + PCM 蓄热 + 余热回收
S3	PCM 热缓冲罐（串入式）	串入式储热，无需控制，兼容电锅炉
S4	LNG 冷能梯级利用	LNG 气化冷能三级 PCM 梯级回收
S5	商业冷库削峰填谷	冷库 PCM 谷电蓄冷 + 峰电释冷
S6	储能电池热管理	电池箱液冷 + PCM 复合冷却

Three.js r152 TypeScript 5.6 Vite 5.4 WebGL 2.0 IIFE 构建 PCM 相变仿真热力学引擎契约驱动 OrbitControls 24h 演示状态机磨砂玻璃 UI

更新记录

20260312

[cx][优化]HUD 热点路径收口：接入共享 hud.js 惰性 DOM 缓存与按需写入
[cx][优化]浮动标签投影优化：减少每帧 DOM 查询与样式写入

20260311

[cc][重构]S1 物理模型统一，迁移至共享核心架构
[cc][新增]新增回归测试 s1/src/core/engine.test.ts（12 用例）
[cc][优化]能源模型重构，统一使用 shared/core 模块

20260307

[cc][新增]顶部标题栏替换浮动HUD，固定磨砂玻璃双行布局（标题+模式+成本摘要）
[cc][新增]一键隐藏UI（展示模式）+ Esc 恢复 + 全屏切换
[cc][重构]shared/ui.js 通用UI层，S1-S6 合计减少 1200+ 行重复代码
[cc][重构]shared/devices.js 通用设备组件库，S2-S6 设备迁移
[cc][优化]侧边栏默认收起

20260306

[cx][模板]新增 s1/src/main.ts、s1/src/core/engine.ts 与 s1/src/core/legacyBridge.ts，建立 S1FMDCore 标准入口。
[cx][迁移]房间 / 机柜 / PCM / 基础风冷 / 24h forecast 主循环迁入 TS 内核，src/ 成为物理真源。
[cx][收敛]s1/index.html 统一改为加载 dist/s1-fmd-core.js，s1/js/app.js 只保留运行时壳层与渲染表现。

20260304

[cc][优化]动画循环 Color/Vector3 per-frame 分配消除，降低 GC 压力
[cc][修正]IR 调用顺序统一为 irSetScene→irSaveMats/irRestoreMats
[cc][修正]IR 按钮图标统一为 🌡（温度计）
[cc][优化]cache-busting ?v=20260304a 全场景统一

20260303

[cx][重构]S1 固定为 3×2 机柜演示，移除机房尺寸调节并保留每柜热功率可调
[cx][修正]S1 场景定位调整为通信宏基站机房，统一标题与描述文案
[cx][新增]补充基础风冷（CRAC）可视化机组，突出"基础风冷常驻 + PCM辅助移峰"逻辑
[cx][新增]引入双节点热模型（机柜/机房）+ 墙体换热 + 昼夜室外温曲线 + 同温控24h成本基线对比
[cc][优化]移除环境灯光控件，固化美观默认配光
[cc][优化]modeName/timeline/costHud 统一为「蓄能/释能/待机」通用 PCM 术语

20260302

[cx][重构]演示升级为场景化 24h 剧本，按时段自动切换"充冷/待机/释冷"
[cx][优化]节能信息拆分为"实时节省 + 24h累计节省"双口径
[cx][优化]透明档位统一为 100/50/25，默认 50% 半透明

20260228

[优化]流线粒子改用 getPointAt 均匀弧长采样
[优化]透明度从3档细化为4档(100/75/50/25%)

20260226

[新增]压缩机浮动标签

20260224

[新增]银白天蓝主题全面改色（暗色→浅色）
[优化]红外热成像温度模型修正
[优化]IR模式冷风粒子可见性增强

20260223

[新增]侧边栏面板 · 红外热成像 · MPR切片
[新增]物理参数面板 · 预设方案管理 · 演示加速

20260218 · 初版

[场景]完整机房场景 · 蛇形铜管 · PCM瓶阵列

查看 S1 完整日志页

20260312

[cx][重构]topology 收口：S2 接入共享 portRegistry 兼容层，删除本地重复实现
[cx][重构]S2 forecast 收口：改为调用共享 runForecast()，保留特有语义
[cx][重构]S2 Inspector 迁移：改用 S2FMDCore topology API 读取设备端口
[cx][优化]HUD/标签投影缓存优化：惰性 DOM 缓存，相机签名缓存避免重复投影

20260311

[cc][重构]S2 引擎核心统一，完善标准 API（getState/patch/sync/step）
[cc][新增]新增回归测试 s2/src/core/engine.test.ts（11 用例）
[cc][新增]TopologyModel 管路拓扑系统（shared/core/topologyModel.ts）

20260307

[cc][新增]顶部标题栏替换浮动HUD，固定磨砂玻璃双行布局
[cc][新增]一键隐藏UI（展示模式）+ Esc 恢复 + 全屏切换
[cc][重构]shared/ui.js 通用UI层
[cc][重构]shared/devices.js 通用设备组件库
[cc][优化]侧边栏默认收起

20260306

[cx][标准]s2/src/core/engine.ts 的 createEngine() 补齐 getState / patch / sync / step 标准接口。
[cx][模板]新增 s2/src/core/legacyBridge.ts，并由 s2/src/main.ts 统一暴露 seed / stepInput / stepOutput bridge API。
[cx][瘦身]s2/js/app.js 与 s2/js/sidebar.js 移除重复默认值和本地求解辅助，js/ 仅保留场景壳层。

20260305

[cx][重构]S2 三回路主干统一下沉到架空地板夹层
[cx][重构]S2 内核从"双回路耦合"切到"严格三回路"：A主冷却、B独立蓄冷、C释冷
[cx][重构]S2 设备重排为"三岛分区"：左A主冷却、右B蓄冷、中部机柜负荷区
[cx][重构]S2 接入"混合模式自动布管器"
[cx][重构]S2 engine.ts 升级为 TRNSYS 风格时步组件网
[cx][重构]S2 运行时内核切换为 dist/s2-fmd-core.js，src/core/engine.ts 成为唯一可编辑真源
[cx][新增]S2 新增 s2-fmd-core.js 三层内核（Flow/Module/Device）
[cx][新增]引入现代工具链：package.json、vite.config.js、tsconfig.json、src/main.ts

20260304

[cc][修正]IR 按钮图标统一为 🌡（温度计）
[cc][优化]移动端响应式 CSS 适配
[cx][重构]S2 全主回路改为正交贝塞尔单管体弯头
[cx][重构]S2 物理模型升级为"双换热器"口径
[cx][重构]S2 主回路语义重构为"CDU近端三通阀二选一"
[cx][重构]S2 PCM 拆分为"CDU负荷换热盘管 + 压缩机独立制冷盘管"

20260303

[cc][优化]移除环境灯光控件，固化美观默认配光
[cc][优化]modeName/timeline/costHud 统一为「蓄能/释能/待机」通用 PCM 术语

20260302

[cx][重构]演示升级为场景化 24h 剧本，液冷蓄冷流程按峰谷时段自动演进
[cx][优化]节能信息拆分为"实时节省 + 24h累计节省"双口径
[cx][优化]移除U型盘管流线粒子，降低无效渲染开销
[cx][优化]透明档位统一为 100/50/25，默认 50% 半透明

20260228

[修复]管路圆弧弯头 CatmullRomCurve3 · T型接头球
[优化]管卡支架 · 流线粒子 getPointAt 均匀采样

20260226

[修复]压缩机叶片旋转轴修正

20260225

[优化]红外模式材质复用 · 蓄冷进度修正 · 成本联动

20260224 · 初版

[场景]液冷 + PCM蓄热 + 余热回收

查看 S2 完整日志页

20260323 · PCM 热缓冲罐产品重构

[产品]S3 重构为 PCM 热缓冲罐（串入式）产品，直接连接在现有电锅炉出水管道上，无需控制、无需阀门，纯被动工作。
[成本]中国本土供应链成本优化：BOM 约¥1150，零售价¥1500（含安装），4-5 年回收成本。
[规格]可用储热 15-20kWh，相变温度 58°C，适用 80-120㎡住宅，串入管道即可安装。

20260322

[重构]S3 经济模型重构为三层 BOM 结构：unit BOM、delivery BOM、customer quote。
[测试]新增定价链路断言，锁定内部定价输入到客户侧投资总额的关系。

20260321

[新增]顶部标题栏替换浮动 HUD，固定磨砂玻璃双行布局。
[新增]一键隐藏 UI（展示模式）+ Esc 恢复 + 全屏切换。
[重构]shared/ui.js 通用 UI 层，S3 迁移。
[重构]shared/devices.js 通用设备组件库，S3 迁移。

20260311

[重构]S3 引擎核心统一，迁移至标准架构。
[新增]新增回归测试 s3/src/core/engine.test.ts（12 用例）。

20260307

[优化]侧边栏默认收起，UI 简洁化。

20260228

[新增]红外热成像模式，设备连接接头球。

20260224 · 初版

[场景]居民清洁供暖 + 太阳能耦合。

查看 S3 完整日志页

20260312

[cx][优化]HUD 热点路径收口：顶栏、侧栏、进度条接入共享缓存助手
[cx][优化]浮动标签内容更新改为缓存句柄 + 去重写入

20260311

[cc][重构]S4 引擎核心统一，配置模型优化
[cc][新增]新增回归测试 s4/src/core/engine.test.ts（12 用例）

20260307

[cx][修复]补建 s4/dist/s4-fmd-core.js 运行时包，恢复三级气化换热量显示
[cc][新增]顶部标题栏替换浮动HUD（8数据字段：LNG/PCM1-3/气化/深冷/冷库/DC进）
[cc][新增]一键隐藏UI（展示模式）+ Esc 恢复 + 全屏切换
[cc][重构]shared/ui.js 通用UI层，时间轴段宽溢出修正
[cc][重构]shared/devices.js 通用设备组件库
[cc][修正]legacyBridge 补充 qHX1/qHX2/qHX3 字段
[cc][优化]侧边栏默认收起

20260306

[cx][模板]新增 s4/src/main.ts、s4/src/core/engine.ts 与 s4/src/core/legacyBridge.ts，建立 S4FMDCore 标准入口。
[cx][迁移]LNG 气化、三级 PCM、深冷库 / 冷库 / 数据中心负荷主循环迁入 TS 内核。
[cx][收敛]s4/index.html 统一改为加载 dist/s4-fmd-core.js，s4/js/app.js 仅保留桥接调用与可视刷新。

20260304

[cc][优化]移动端响应式 CSS 适配
[cx][优化]S4 LNG罐/三级气化器/三级PCM罐端口改为"单向短节+法兰"

20260303

[cc][优化]移除环境灯光控件，固化美观默认配光
[cc][优化]modeName/timeline/costHud 统一为「蓄能/释能/待机」通用 PCM 术语

20260302

[cx][修复]待机工况改为"海水主气化 + PCM小比例回收"，修复空调级气化器待机功率异常飙升
[cx][新增]深冷段新增"药品深冷库"终端，补齐 PCM-1 冷量去向
[cx][重构]S4 场景语义升级为"工业园能源站"
[cx][重构]S4 温度演化改为节点能量平衡模型
[cx][重构]演示升级为 24h 剧本，LNG 蓄冷与供冷阶段按时段自动切换
[cx][优化]透明档位统一为 100/50/25，默认 50% 半透明

20260228

[新增]设备连接接头球16处 · 透明度控制修正
[优化]输入校验 · LNG液位动画 scale.y 优化

20260226

[修复]管路穿模修复 · 气化器浮动标签

20260224 · 初版

[场景]LNG 点供站冷能回收

查看 S4 完整日志页

20260312

[cx][优化]IR 热点路径收口：mesh 缓存替代逐帧 traverse，静态结构复用世界坐标
[cx][优化]IR 热纹理扰动改为稳定相位，移除逐帧 Math.random()

20260311

[cc][重构]S5 引擎核心统一，简化物理模型
[cc][新增]新增回归测试 s5/src/core/engine.test.ts（12 用例）

20260307

[cc][新增]顶部标题栏替换浮动HUD（5数据字段：库温/PCM/蒸发/压缩机/SOC）
[cc][新增]一键隐藏UI（展示模式）+ Esc 恢复 + 全屏切换
[cc][重构]shared/ui.js 通用UI层
[cc][重构]shared/devices.js 通用设备组件库
[cc][优化]侧边栏默认收起

20260306

[cx][模板]新增 s5/src/main.ts、s5/src/core/engine.ts 与 s5/src/core/legacyBridge.ts，建立 S5FMDCore 标准入口。
[cx][迁移]冷库热侵入、压缩机、PCM 与库温主循环迁入 TS 内核，src/ 负责物理求解。
[cx][收敛]s5/index.html 统一改为加载 dist/s5-fmd-core.js，s5/js/app.js 仅保留场景调度与渲染表现。

20260304

[cc][优化]动画循环 skyColor per-frame 分配消除
[cc][优化]移动端响应式 CSS 适配
[cx][优化]S5 蒸发器/冷凝机组端口改为"单向短节+法兰"收口

20260303

[cc][优化]移除环境灯光控件，固化美观默认配光
[cc][优化]modeName/timeline/costHud 统一为「蓄能/释能/待机」通用 PCM 术语
[cc][优化]移除峰谷状态按钮（bValley），峰谷信息由 costHud 和时间轴色带表达

20260302

[cx][重构]"演示"升级为 24h 剧本，峰谷电价、门体开合与工况切换统一联动
[cx][优化]节省率升级为"实时节省 + 24h累计节省"双口径
[cx][修复]IR模式下PCM蓄冷板改为不透明渲染，消除蓄冷阶段闪烁
[cx][优化]装卸门改为左右分割推拉门，开门动画更贴近冷库场景
[cx][优化]透明档位统一为 100/50/25，S5默认 50% 半透明

20260301

[优化]冷凝机组迁至右墙外侧 · 管路重新布线
[修复]LED渲染崩溃 · IR类型守卫

20260228

[新增]红外热成像 · 接头球10处 · 圆弧弯头管路

20260227 · 初版

[场景]PU保温冷库 · 蒸发器 · PCM蓄冷板24块
[物理]热侵入 · COP制冷 · 峰谷电价对比

查看 S5 完整日志页

20260312

[cx][优化]IR 热点路径收口：mesh 缓存替代逐帧 traverse，静态结构复用世界坐标
[cx][优化]IR 热纹理扰动改为稳定相位，移除逐帧 Math.random()
[cx][优化]标签隐藏路径：修复重复 DOM 查询

20260311

[cc][重构]S6 引擎核心统一，优化应急冷却模式
[cc][新增]新增回归测试 s6/src/core/engine.test.ts（12 用例）

20260307

[cc][新增]顶部标题栏替换浮动HUD（7数据字段：电池均温/PCM/供液/回液/冷机/发热/SOC）
[cc][新增]一键隐藏UI（展示模式）+ Esc 恢复 + 全屏切换
[cc][重构]shared/ui.js 通用UI层
[cc][重构]shared/devices.js 通用设备组件库
[cc][修正]legacyBridge 补充 liquidCoolKW 字段
[cc][优化]侧边栏默认收起

20260306

[cx][模板]新增 s6/src/main.ts、s6/src/core/engine.ts 与 s6/src/core/legacyBridge.ts，建立 S6FMDCore 标准入口。
[cx][迁移]电池发热、液冷换热与 PCM 蓄冷主循环迁入 TS 内核，src/ 成为物理真源。
[cx][收敛]s6/index.html 统一改为加载 dist/s6-fmd-core.js，s6/js/app.js 只保留热管理表现与交互。

20260304

[cc][优化]动画循环 skyColor per-frame 分配消除
[cc][优化]移动端响应式 CSS 适配
[cx][优化]S6 冷却塔与 PCM 模块端口改为"单向短节+法兰"

20260303

[cc][优化]移除环境灯光控件，固化美观默认配光
[cc][优化]移除峰谷状态按钮（bValley），峰谷信息由 costHud 和时间轴色带表达

20260302

[cx][重构]"演示"升级为 24h 剧本，正常/待机/应急冷却按日内阶段自动切换
[cx][优化]节省率升级为"实时节省 + 24h累计节省"双口径
[修复]管路重写 · PCM旁通轴对齐 · 能耗基准修正
[优化]电池簇/模组参数与建模同步，按预设重载后几何一致
[优化]分集水器/支路/粒子随电池簇数自适应布局
[优化]IR电池热像改平滑扰动，去除随机闪烁
[cx][优化]透明档位统一为 100/50/25，默认 50% 半透明

20260301 · 初版

[场景]20尺集装箱 · 4组电池柜 · 液冷板 · PCM罐 · 冷却塔
[物理]I²R发热 · 液冷换热 · PCM相变 · 冷机COP
[预设]4套方案(50kWh~2MWh) · 三模式

查看 S6 完整日志页

PCM 系统场景演示