GET /api/components/catalog：返回组件库与模型版本、分类、图标键、端口布局和参数契约，供 ReactFlow 启动时自动加载。
POST /api/reactflow/system-xml：导出 System XML v2。
POST /api/reactflow/compile-model：将 ReactFlow 节点、参数和连线编译为仿真网络，并返回组件端口、无方向物理连接、压力-流量方程结构及未连接端口。
POST /api/reactflow/simulate-testmodel：运行现有固定拓扑 TestModel；该接口暂时不是任意拓扑求解器。
POST /api/reactflow/simulate-test-mql：返回固定拓扑 AMESim test_mql 的结构与采样摘要；132 状态数值对比使用独立 comparison 入口。AMESim 子模型已有 19 个第一版公开模型，但该接口本身不是任意拖拽拓扑求解器。
POST /api/system-xml/validate：接收原始 System XML v2，返回 XML、XSD 和模型语义三层诊断。
POST /api/system-xml/parse：校验 XML 并返回规范化的 ReactFlow 工程对象。
POST /api/system-xml/compile-model：校验并解析 XML，然后创建 app.simulation 组件网络。
POST /api/system-xml/simulate：按 XML 中的组件、连接、参数和仿真设置运行当前支持的气动、标量信号及一维机械网络 MVP，并返回组件及端口时间序列。
POST /api/simulation-results/csv：校验结构化结果快照并导出 UTF-8 CSV 文件。

气动端口的后端契约采用 p 势变量相等、m_flow 流变量代数和为零、h_outflow 按 stream 规则混合。所有组件统一规定 m_flow > 0 表示流入组件，物理连接的端点顺序不表示流向。

当前网络层可按端口域处理气动压力-流量残差与 stream 焓、标量信号传播，以及一维机械 x/v 等值和 f 平衡，并使用 SciPy 完成非线性代数闭合和时间积分。XML 通用仿真当前采用半显式 ODE/代数 MVP：气瓶和贮箱作为储能元件，孔板及 XML 管段作为阻性元件，三通作为等压零结点，同时支持已登记的信号和机械基础件。它不是完整 DAE 或事件求解器，也不等价于严格 Modelica.Fluid 实现。

XML 解析依赖 lxml 执行本地 XSD 校验。安装或更新 Python 环境时使用：

.\.venv-win\Scripts\python.exe -m pip install -r requirements.txt

README.md

SystemSimulationApp

后端接口

文档