SystemSimulationApp/app/simulation/components/example.md

元件开发示例

权威规则见 组件模型建模规范。当前模型采用 Python 声明、C 数值实现。

以气瓶为例：

1. 在 cylinder.py 声明 MODEL_TYPE、MODEL_VERSION、PORTS、PARAMETERS、RESULT_VARIABLES、DISPLAY 和 create()。
2. 构造函数调用 set_parameter_values()、register_declared_port()，保存介质选择和容积。不要在 Python 中计算密度、内能或状态导数。
3. 通过 EQUATIONS 声明端口压力与气瓶状态之间的约束；只保存变量名和关系。 气动端口同时声明 computation，说明温度、压力和质量/能量流率由谁提供；固定参考口还要声明其支路的参考来源，见 端口供需合同。
4. 在 extended.py 分配状态及输出位置，生成 native_medium_init() 初始化调用和气瓶质量/能量导数计算。
5. 公共物性和数值公式由 kernels.c 实现，积分和事件由 native/runtime/ 处理。
6. 加入组件库 library.py 及 C 版本白名单，验证目录/XML 合同、边界输入、逆流、守恒、RK45/BDF 和输出键。

新增模型的参考值应来自独立解析结果、外部可信结果或已有冻结基准；不恢复第二套 Python 数值实现。