SystemSimulationApp/skills/system-simulation/SKILL.md

name, description

name	description
system-simulation	读取、校验并简要解释 SystemSimulationApp 工程 JSON v1 或 System XML v3，安全规范化文件文本，并在用户选定结果曲线后启动、监视或取消仿真及导出 CSV。适用于检查模型文件、修复编码或换行、运行仿真和获取结果；不用于旧格式迁移、任意语义修复、自动迭代或网页自动预装。

系统仿真

使用本 Skill 随附的确定性脚本检查模型、调用现有后端并保存结果；不要让语言模型自行重写模型或猜测求解数据。

基本边界

• 仅处理 ReactFlow 工程 JSON v1 和 System XML v3。版本缺失、不受支持或模型版本不匹配时，说明问题并停止，不进行迁移猜测。
• 组件参数是仿真前设定的固定输入；结果变量才是可随时间绘制的量。不要把“参数”当成结果曲线。
• 工程 JSON 可在连续数值参数中保存受限算术表达式。检查、编译或生成 XML 时由后端安全求值并换算为 SI；不得把计算结果回写到源 JSON。
• 文件通过格式校验不等于物理系统一定可求解。不要隐瞒编译或运行阶段的诊断。
• 不直接覆盖源文件，不自行修改参数、连接、组件类型、模型版本或求解设置。
• 本版不支持把模型自动注入网页、生成可直接打开的预装页面、任意损坏文件修复、模型迁移或自动调参迭代。明确告知用户这些能力尚未实现，不要用手工网页操作冒充支持。

处理文件、解释格式或选择结果变量时，读取 references/file-contracts.md。请求文件修复时，再读取 references/repair-policy.md。需要运行、监视、取消仿真或交付结果时，读取 references/workflows.md。

工作原则

1. 先用 inspect 确认输入格式、版本、结构和诊断，再基于检查结果简要解释组件、连接与仿真设置。
2. 如果用户要求修复，只能执行文本规范化。先展示预览和源文件 SHA-256，获得针对该预览的明确确认后，才可写入另一个输出路径；随后重新 inspect。
3. 仿真前必须让用户选择直接曲线查看方式，并解析具体结果变量：
   • 分别查看所选变量；
   • 将多个同单位、可比较的变量叠加；
   • 将不同物理量或单位的变量上下排列。
4. 用户用显示名称描述组件或变量时，利用检查结果中的稳定 ID、结果 key、物理量和单位消歧。存在重名、多个候选或“参数/结果变量”含义不清时，先询问，不能替用户猜。
5. 使用 simulate 的事件流持续判断 queued、validating、compiling、integrating 和结束状态。仿真时间暂时不变但内部活动仍增长时，只说明正在处理慢步，不能宣称卡死。
6. 成功运行后交付用户选择的 SVG 曲线和完整 results.csv，并简要说明完成状态、实际仿真终点和重要诊断。失败或取消时交付能够安全生成的部分结果；若运行前即失败而没有 CSV，要明确说明原因。

脚本命令统一从仓库根目录运行：

py -3.12 skills/system-simulation/scripts/simulation_skill.py --help

Windows 优先使用仓库 .venv-win\Scripts\python.exe（若存在），否则使用 py -3.12；Linux 优先使用 .venv/bin/python，否则使用 python3.12。不要调用未经版本确认的 python，本项目要求 Python 3.12。

优先依赖脚本返回的结构化 JSON/JSONL、稳定错误码和退出码做判断，不解析中文提示文本来驱动下一步。