# 管路子模型三栏布局 demo

打开：`http://127.0.0.1:5173/demos/pipe-submodels/index.html`

此版只开放 PNL00R、PNL0001、PNL0002、PNL0003 的管路子模型。左侧为管路子模型库，中间为固定气动网络，右侧为子模型属性及参数表，底部为配置检查信息。采用主应用的三栏、工作模式标签、紧凑工具栏和参数表结构，借鉴 Amesim 的子模型工作模式；不是完整复刻 Amesim 界面。

## 操作

1. 默认进入“子模型”。单击画布中的管路或左侧管路列表进行选择。
2. 左侧默认只展示兼容管路型号。点击预览，在右侧“应用到 L…”或“应用并下一条”。双击型号也可应用。
3. 切换“参数”后编辑数值；子模型阶段参数只读，避免选型时误改物理参数。
4. 切换“检查”，底部显示本例的局部匹配和必填参数检查。点击问题项直接定位。
5. 滚轮或左下角按钮缩放；拖动画布空白区平移查看；“适配视图”恢复视口。

## 位置锁定

- 部件坐标和连接端点为固定定义，选型及参数状态不包含坐标。
- 所有模式均不提供部件拖动、连线改路由、重新连接、删除、旋转或镜像。
- pnode 固定为 P4NODE2，参考端口不变。其他部件只作为管路端点的上下文。
- 允许的平移、缩放只改变观察视口，不改变模型坐标或连接。

## 演示范围

- 四条管路覆盖两侧提供状态、两侧需要状态、一侧提供/另一侧需要状态的局部匹配场景。
- 不包含其他组件子模型选型；理想连接不进入本版管路库。
- 管路接口元数据按上一版已核对的本机 Amesim 管路定义整理，数值代码未复制。
- C/R 图标沿用主应用储气/阻力表示。管路实际端口映射见“端口方向与选型说明”，与画线顺序无关。
- 子模型切换可能改变是否计入储气、储气分布及状态数量，界面明确展示其物理作用。仅按接口筛选，不能替代工程物理选型。
- 仅为固定局部网络的交互 demo。未接入全网方程分析、XML、SI 单位转换或仿真后端，不执行求解。
- 主应用及正式组件、pnode、数值内核不作修改。没有新增 npm 依赖。

## 恢复

- “重置演示”只重置本页的选型与参数。
- 本版独立存储键：`system-simulation:pipe-submodels-layout-demo:v1`。
- 上一版完整保留在 `../amesim-submodels/index.html`，两个演示互不读取对方存档。
- 撤回此版只需移除 `frontend/public/demos/pipe-submodels/`，不需要回退其他源码。
- 位于 Vite public 下的 demo 会随前端打包输出；正式发布前可移除演示目录。

## 本次验证

2026-09-10：JavaScript 语法与静态入口检查通过。Edge 浏览器验证部件拖动、连线拖动与 Delete 均不改变固定坐标/连接；缩放、空白区平移只改变视口。四种管路的兼容筛选、预览与应用分离、连续选型、子模型阶段参数只读、参数校验、更换型号保留共同参数、反向端口映射、刷新恢复及独立重置通过。桌面、窄桌面和移动宽度没有横向溢出，未发起后端 API 请求。检查截图在 `test/pipe-submodels-demo/`。