allblueuk run-matlab — MATLAB 求解调用包装
触发场景
- "跑 model/03_solve//main.m"
- "MATLAB 实现的非 Dynare 模型"（如 Reiter 法、自写线性 RE 求解、扰动包 dynare 之外的实现）
- "MATLAB 报错看不懂"
输入契约
| 字段 | 类型 | 说明 |
|---|---|---|
m_file |
path | model/03_solve/<model>/main.m |
nodisplay |
bool | 默认 true（CLI 模式） |
extra_paths |
list[path]? | 额外 addpath 目录 |
步骤清单
- 调用
matlab -nodisplay -nosplash -r "try; run('<m_file>'); catch ME; disp(ME.message); exit(1); end; exit;" 2>&1 | tee logs/<model>_matlab_<ts>.log。 - 解析输出：警告、错误、关键变量。
- 后处理产物保存到
output/checkpoints/<model>_*.json（用jsonencode）。 - 失败时摘录
ME.identifier与ME.message。 - 调用
numerics-reviewer子 agent。
输出契约
| 文件 | 必产 | 说明 |
|---|---|---|
logs/<model>_matlab_<ts>.log |
✅ | |
output/checkpoints/<model>_*.json |
✅ |
不允许的操作
- 在
.m文件中硬编码盘符路径（用fullfile(fileparts(mfilename('fullpath')), ...)） - 把求解结果用
.mat提交版本控制（.gitignore已忽略） - 把 MATLAB 警告当成成功（必须扫描
Warning:）
失败回退
| 症状 | 处理 |
|---|---|
License Manager Error |
检查 matlab 在 PATH 中且 license 有效 |
Undefined function |
检查 addpath；可能缺工具箱 |
| 数值不稳定 | 检查矩阵条件数、尝试 SVD 替代直接求逆 |