🐛 故障排除

问：仿真失败，如何调试？

1. 查看日志文件：

# 查看最新运行的日志
tail -f results/<timestamp>/simulation_*.log

2. 常见错误及解决方法：

错误信息	可能原因	解决方法
Model not found	模型路径错误	检查 package_path 是否正确
Failed to compile	Modelica 语法错误	在 OMEdit 中打开模型检查错误
Variable not found	variableFilter 中的变量不存在	检查变量名拼写，使用正确的路径
Out of memory	并发进程过多或模型太大	减少 max_workers 或增加系统内存
Permission denied	文件权限问题	检查工作目录的读写权限

3. 启用详细日志：

{
    "logging": {
        "level": "DEBUG"
    }
}

问：GUI 无法启动或显示不正常？

Windows/Linux 本地： * 确保安装了 Tkinter：pip install tk * 检查显示环境变量：echo $DISPLAY

Docker 容器： * Windows 11：确保 WSL2 的 WSLg 功能已启用 * Linux：运行 xhost +local: 允许容器访问 X11 * 使用包含 GUI 支持的镜像：tricys_openmodelica_gui

问：参数扫描结果不完整？

可能的原因：

1. 某些仿真失败：
2. 查看日志文件中的错误信息

3. 检查参数值是否合理（如避免除零、负值等）

4. 输出变量过滤器太严格：

5. 检查 variableFilter 是否匹配了所需变量

6. 并发问题：

7. 尝试禁用并发："concurrent": false
8. 查看是否有进程崩溃

问：如何报告 Bug？

请在 GitHub Issues 中创建新 Issue，并提供：

1. 环境信息：
2. 操作系统和版本
3. Python 版本
4. OpenModelica 版本

5. TRICYS 版本

6. 重现步骤：

7. 完整的配置文件
8. 运行的命令

9. 使用的模型（如果可能）

10. 错误信息：

11. 完整的错误堆栈

12. 相关的日志片段

13. 预期行为：

14. 您期望发生什么
15. 实际发生了什么

---