规范仿真模型库并完善前端交互

归档仿真模型并补充组件目录、建模规范与校验。

完善控制台、默认节点、视图适配及前端自动化测试。

README.md

@@ -1,15 +1,16 @@
 # SystemSimulationApp
 
-ReactFlow 系统建模与 PythonModels 仿真应用。
+ReactFlow 系统建模与 `app.simulation` 仿真后端。
 
 ## 后端接口
 
+- `GET /api/components/catalog`：返回组件库与模型版本、分类、图标键、端口布局和参数契约，供 ReactFlow 启动时自动加载。
 - `POST /api/reactflow/system-xml`：导出 System XML v2。
-- `POST /api/reactflow/compile-model`：将 ReactFlow 节点、参数和连线编译为 PythonModels 网络，并返回组件端口、无方向物理连接、压力-流量方程结构及未连接端口。
+- `POST /api/reactflow/compile-model`：将 ReactFlow 节点、参数和连线编译为仿真网络，并返回组件端口、无方向物理连接、压力-流量方程结构及未连接端口。
 - `POST /api/reactflow/simulate-testmodel`：运行现有固定拓扑 TestModel；该接口暂时不是任意拓扑求解器。
 - `POST /api/system-xml/validate`：接收原始 System XML v2，返回 XML、XSD 和模型语义三层诊断。
 - `POST /api/system-xml/parse`：校验 XML 并返回规范化的 ReactFlow 工程对象。
-- `POST /api/system-xml/compile-model`：校验并解析 XML，然后创建 PythonModels 组件网络。
+- `POST /api/system-xml/compile-model`：校验并解析 XML，然后创建 `app.simulation` 组件网络。
 - `POST /api/system-xml/simulate`：按 XML 中的组件、物理连接、参数和仿真设置运行通用气动网络 MVP，并返回组件及端口时间序列。
 - `POST /api/simulation-results/csv`：校验结构化结果快照并导出 UTF-8 CSV 文件。
 
@@ -25,6 +26,10 @@ XML 解析依赖 `lxml` 执行本地 XSD 校验。安装或更新 Python 环境
 
 ## 文档
 
+- [开发文档索引](docs/README.md)
+- [组件模型建模规范 v1](docs/component-model-authoring-spec-v1.md)
+- [组件库分类、发现与读取规范 v1](docs/component-library-spec-v1.md)
+- [组件目录 JSON Schema v1](schemas/component-catalog-v1.schema.json)
 - [System XML v2 协议](docs/system-xml-v2.md)
 - [System XML v2 XSD](schemas/system-simulation-v2.xsd)
 - [System XML v1 协议（旧版）](docs/system-xml-v1.md)