完善建模交互、组件图标与系统协议

docs/README.md

@@ -2,6 +2,13 @@
 
 本目录是 SystemSimulationApp 协议和开发规范的统一入口。
 
+跨 HTTP、组件目录、模型合同和 System XML 的版本边界统一见
+[后端接口版本与定义规范 v1](backend-interface-version-spec-v1.md)。
+
+## 更新记录
+
+- [更新日志 2026-08-15](更新日志-2026-08-15.md)
+
 ## 模型开发
 
 1. [组件模型建模规范 v1](component-model-authoring-spec-v1.md)
@@ -20,13 +27,12 @@
 
 ## System XML
 
-- [System XML v2 协议](system-xml-v2.md)
-- [System XML v2 XSD](../schemas/system-simulation-v2.xsd)
-- [System XML v1 协议（旧版）](system-xml-v1.md)
-- [System XML v1 XSD（旧版）](../schemas/system-simulation-v1.xsd)
+- [System XML v3 协议（当前规范）](system-xml-v3.md)
+- [System XML v3 XSD（当前 Schema）](../schemas/system-simulation-v3.xsd)
 
-新增模型时，模型类和组件库清单是后端事实来源；System XML 保存组件实例、参数和
-连接。XML 解析器不能自行创造模型端口或参数。
+新增模型时，模型类和组件库清单是后端事实来源；System XML v3 只保存求解所需的
+组件实例、模型版本、参数、连接和仿真设置。端口契约由注册模型恢复，画布位置、图标
+方向等编辑信息只属于工程 JSON。XML 解析器不能自行创造模型端口或参数。
 
 ## 当前代码入口
 
@@ -41,6 +47,8 @@
 | AMESim 第一版公开临时库清单 | [`app/simulation/components/amesim/library.py`](../app/simulation/components/amesim/library.py) |
 | `test_mql` 固定算例入口 | [`app/simulation/examples/test_mql/system.py`](../app/simulation/examples/test_mql/system.py) |
 | 元件完整示例 | [`app/simulation/components/example.md`](../app/simulation/components/example.md) |
+| System XML v3 解析与语义校验 | [`app/system_xml.py`](../app/system_xml.py) |
+| System XML v3 XSD | [`schemas/system-simulation-v3.xsd`](../schemas/system-simulation-v3.xsd) |
 
 ## AI 使用原则