---
name: system-simulation
description: 根据描述在 SystemSimulationApp 中搭建系统、配置参数，生成和校验工程 JSON v2，并通过网页导入或界面操作验收；也支持检查已有 JSON v1/v2、System XML v3，运行和监视仿真、导出曲线与 CSV。
---

# 系统仿真建模与文件助手

把用户描述转成可编辑、可校验的工程。组件、参数、版本和物理合同取自当前仓库/服务；用随附脚本执行确定性生成和校验。自然语言解释由智能体完成，脚本接收明确的建模清单，不自行推测系统。

## 选择路径

- **描述生成工程、修改拓扑或参数**：读 [建模与验收](references/modeling.md) 和 [文件合同](references/file-contracts.md)。默认生成 JSON v2，再导入网页检查、导出 XML、进行短时仿真和导出回读核对。用户只要求文件时交付文件及实际完成的校验，不擅自扩成完整时长仿真。
- **明确要求在界面模拟操作搭建**：另读 [网页操作](references/browser-workflow.md)，通过可用浏览器工具完成添加、连接、参数设置和导出；先读工具操作说明。不要将写文件或调用 API 描述成界面操作。
- **检查已有文件、运行和导出结果**：读 [文件合同](references/file-contracts.md) 和 [运行工作流](references/workflows.md)。
- **仅修复编码、BOM、换行**：读 [文本规范化](references/repair-policy.md)。其限制只适用于 repair-format，不限制用户已授权的建模/参数修改。

## 核心约束

1. 新工程写 projectSchemaVersion: 2；兼容读取 v1，XML 执行格式为 v3。禁止只改 v1 版本号来迁移。v2 数值和表达式均按所选单位解释，由平台转为 SI。
2. 从当前目录选型号，明确实例 ID、真实端口、参数值/单位、介质和边界条件。对影响物理意义的歧义或缺失输入提问；布局可自行决定。使用目录默认值时披露，不能声称为用户给定值。
3. 用户要求创建、配置或修改工程即授权相应工作，无须为每个组件、参数或可逆步骤重复确认。保留已有源文件，默认另存；修改只限所请求范围。不得为了“跑通”擅改物理系统、放宽求解条件或删除失败组件。
4. 新节点使用目录当前版本。已有工程版本不同/缺失时，现行适配层会警告并按当前模型处理，XML/数值内核仍精确检查版本。报告警告，不擅自声称物理语义等价。
5. 区分编辑器结构、活动端口连通、XML 语义、网络编译、浏览器实际导入、数值运行及工程回读。某一层通过不能代替后续层；网络编译不代表 C 编译或积分通过。
6. 参数是固定输入；结果曲线使用真实结果变量 key。尊重用户已给定的曲线与展示方式，只有必要歧义才追问。
7. 依据诊断纠正生成/操作错误后重跑受影响检查。遇到关键输入不足、缺失模型或不可用工具时说明具体缺口，交付已完成结果；不要无限改参数重试或伪造验收通过。

## 执行入口

在仓库根目录运行。Windows 优先 .venv-win\Scripts\python.exe -X utf8，否则 py -3.12 -X utf8；Linux 优先 .venv/bin/python，否则 python3.12。

```powershell
.\.venv-win\Scripts\python.exe -X utf8 skills/system-simulation/scripts/project_builder.py --help
.\.venv-win\Scripts\python.exe -X utf8 skills/system-simulation/scripts/simulation_skill.py --help
```

project_builder.py 复用本仓库 Python 依赖、注册表、参数适配及编译器，无需启动服务。simulation_skill.py 调用 loopback 后端，默认 http://127.0.0.1:8000。开发网页通常为 http://127.0.0.1:5173，以实际状态为准。按需参考仓库 README.md 与 docs/standard/platform-dependencies.md；后台启动使用隐藏窗口，不重启用户正在使用的服务来掩盖版本不一致。

交付工程文件链接、采用的默认值/待确认输入、各层检查结果和未完成原因。运行过仿真时附实际终点、曲线及完整 CSV；部分结果明确标注。浏览器或原生工具链不可用时，不能把静态校验称为完整验收。