旧版前端工程文件导入时版本对比查验、审阅与仿真时部分阻挡功能实现；前端参数输入格式统一规范

docs/standard/port-computation-contract.md

@@ -1,5 +1,9 @@
 # 气动端口变量供需合同
 
+文档版本：1.1.1
+修订日期：2026-09-12
+核对代码基线：`22579e5`；本次版本号仅标注文档，不改变模型版本或协议版本。
+
 本合同在 Python 编译阶段和前端建模阶段使用，数值计算仍由 C 执行。它不改变状态、输出键、积分器、雅可比策略或管流算法。
 
 ## 物理连接与计算供需
@@ -75,7 +79,7 @@
 - 画布：供需不匹配的目标口不会作为可连接目标；接触吸附使用同一规则。悬停显示需要/提供的量和不兼容原因。
 - 旧工程：保留供需不匹配的现有连线供检查、修改，不自动交换参考口或删线。原有的无效端口、重复占用等结构损坏处理不变。
 - 检查模型及运行仿真：报告具体部件、端口和缺少的量，错误未处理前不启动求解。
-- JSON/XML/API/直接构造网络：后端独立检查，不能靠删除或伪造前端快照绕过。
+- XML 语义、JSON 执行入口及直接构造网络：后端独立检查，不能靠删除或伪造前端快照绕过。工程 JSON 的保存/加载接口仅做存储结构检查，不执行完整供需检查。
 - 两条 C 生成入口：在生成前再次检查连接及参考来源。
 
 错误码：`CONNECTION_VARIABLE_SUPPLY_MISSING`、`REFERENCE_SUPPLY_CYCLE`、`REFERENCE_SUPPLY_UNCONNECTED`。
@@ -84,6 +88,14 @@
 
 供需数据结构与后端检查位于 `app/simulation/core/port_computation.py`，前端对应实现位于 `frontend/src/portComputation.ts`。新增固定接口应在模型 `PORTS` 中声明，并提供合法连接、供需冲突、流向/连线顺序反转和参考链的测试。
 
-本次没有修改浏览器工程、正式 `test-mql-8.json` 或历史数值基准。旧节点 smoke 测试改为将参考口接到储气状态；另保留明确的错误接线拒绝测试。历史 50 个冻结网络仍能通过新合同并执行原 C 数值对照。
+当前正确性/性能活动输入按[优化基准模型约定](optimization-benchmark-model.md)使用修正八路文件。历史 50 个冻结网络是独立回归基准，不是四路工程，不能替代当前 AME/JSON 的逐项核对。
 
 浏览器测试从实际 Python 组件目录读取供需信息，覆盖目标筛选、悬停原因、错误旧连线保留和仿真前拦截，防止前后端合同不一致。
+
+## 注册与工程导入边界（2026-09-12 修订）
+
+供需规则以当前注册表为准，但工程快照首先必须通过浏览器结构解析。目录返回的信号端口可能带 `positiveFlowDirection: null`，工程解析器不接受该值；生成快照时省略此字段，不用目录对象直接替代工程对象，见[目录协议](component-library-spec-v1.md)。
+
+动态端口须同时实现后端有效端口和前端参数变更/连线处理；当前 LMECHN1 有专用逻辑，供需合同不自动提供通用动态端口能力。注册演练的信号源不涉及气动固定参考口，不能用该演练代替参考链或逆流验收。
+
+当前 XML/后端网络允许信号输出扇出，网页模型检查仍限制每个显示端口恰好一条连接。后端对普通未接活动端口的 XML 警告、原生模型的必接要求及前端错误提示应分别测试，不能以一个入口的允许行为推断其他入口。