46 lines
3.0 KiB
Markdown
46 lines
3.0 KiB
Markdown
# Amesim 风格的连接线子模型演示
|
||
|
||
这是一个独立的交互 demo，用于评估“绘图 → 子模型 → 参数 → 检查”的操作方式。
|
||
|
||
## 打开与操作
|
||
|
||
在项目已有 Vite 开发服务运行时，打开：
|
||
|
||
`http://127.0.0.1:5173/demos/amesim-submodels/index.html`
|
||
|
||
1. 示例预置四条尚未选型的连接。进入“子模型”，点击连线或画布下方的连线按钮。
|
||
2. 弹窗优先展示兼容型号及物理作用；“端口需求与其他型号”默认折叠。
|
||
3. “应用并下一条”依次处理未选型连线，完成后进入参数阶段。管长、内径需要用户填写。
|
||
4. 进入“检查”，查看示例端口匹配和必填参数；问题项可以直接定位处理。
|
||
5. 绘图模式下可删除一条连线，再依次点击两个空闲端口重连。Esc 取消尚未完成的连线。
|
||
|
||
示例中的 P4NODE2 始终以端口 2 为参考，不提供节点子模型切换。
|
||
|
||
## 范围
|
||
|
||
- 仅包含固定的局部端口示例和 DIRECT、PNL00R、PNL0001/2/3 的接口匹配规则。
|
||
- 匹配检查基于温度/压力的供需关系，质量/能量流率采用互补方向；不是正式全网依赖分析。
|
||
- 优先项按接口兼容和模型复杂度排序，不代表对具体工程的物理模型推荐。各型号显示是否包含压降、储气及状态数量。
|
||
- 管路方向由端口关系决定，与画线顺序和实际气流方向无关。
|
||
- 管路配置只是交互数据，不生成正式 XML，不调用编译器、不执行仿真。
|
||
- 参数使用界面显示单位；尚未接入 SI 转换、介质、换热、完整初始条件检查等生产能力。
|
||
- 不复制 Siemens 数值代码。示例接口规则根据本机已有 Amesim 2404 管路源文件的公开接口说明整理。
|
||
- 不修改主应用、正式组件、pnode 方程、求解器或已有工程数据。没有引入 npm 依赖。
|
||
|
||
## 保存与恢复
|
||
|
||
浏览器只使用独立的 localStorage 键：
|
||
|
||
`system-simulation:amesim-submodel-demo:v1`
|
||
|
||
- 点击页面右上角“恢复初始示例”，可以清空本演示的选型与参数，重新体验。
|
||
- 返回原系统：点击“返回主应用”或打开 `http://127.0.0.1:5173/`。
|
||
- 撤回本次 demo：删除 `frontend/public/demos/amesim-submodels/` 这个目录即可。无需回退任何现有源码。
|
||
- 若只清理浏览器数据，可在该页面的开发者控制台执行 `localStorage.removeItem('system-simulation:amesim-submodel-demo:v1')`，然后刷新。
|
||
|
||
注意：这个目录位于 Vite 的 public 下，正常打包会把它作为静态文件带入构建产物。正式发布前，如尚未决定保留，应先移除这个 demo 目录。
|
||
|
||
## 本次验证
|
||
|
||
2026-09-10：JavaScript 语法及三个静态入口 HTTP 检查通过。Edge 浏览器完成兼容型号筛选、连续选型、反向端口匹配、参数校验、刷新恢复、更换型号保留共同参数、删除重连、独立重置和窄屏检查。未发起 `/api/` 请求。诊断截图保存在 Git 忽略的 `test/amesim-submodel-demo/`。
|