公开PNRP17并接通实时气动机械耦合

app/simulation/components/amesim/storage/chambers.py

@@ -249,10 +249,9 @@ class AmesimPnch012(ThermodynamicVolumeComponent):
     """AMESim PNCH012 variable-volume pneumatic chamber.
 
     AMESim supplies four external volume and volume-rate inputs through the
-    chamber ports. The current public System XML contract has pneumatic ports
-    only, so this first public model exposes those external volume inputs as SI
-    parameters. This represents fixed or prescribed-volume PNCH012 cases and is
-    not yet the full mechanical-coupled submodel.
+    chamber ports. Fixed/prescribed contributions remain available as SI
+    parameters, while connected moving-boundary components can now add live
+    volume and volume-rate values through the pneumatic connector contract.
     """
 
     MODEL_TYPE = "amesim_pnch012"
@@ -433,14 +432,29 @@ class AmesimPnch012(ThermodynamicVolumeComponent):
     ) -> "AmesimPnch012":
         return cls(name=name, medium=medium, **dict(parameters))
 
+    def connected_external_volume(self) -> float:
+        return sum(
+            getattr(getattr(self, port_name, None), "volume", 0.0)
+            for port_name in self.external_volumes
+        )
+
+    def connected_external_volume_rate(self) -> float:
+        return sum(
+            getattr(getattr(self, port_name, None), "volume_flow", 0.0)
+            for port_name in self.external_volume_rates
+        )
+
     def total_volume(self) -> float:
         minimum_volume = self.cvol0 / 100.0
-        return max(self.cvol0 + sum(self.external_volumes.values()), minimum_volume)
+        return max(
+            self.cvol0 + sum(self.external_volumes.values()) + self.connected_external_volume(),
+            minimum_volume,
+        )
 
     def total_volume_rate(self) -> float:
         if self.total_volume() <= self.cvol0 / 100.0:
             return 0.0
-        return sum(self.external_volume_rates.values())
+        return sum(self.external_volume_rates.values()) + self.connected_external_volume_rate()
 
     def get_state_vector(self) -> list[float]:
         return self.state.as_vector()