AGENTS.md 2.1 KB
AGENTS.md — AI 工具工作说明 (Claude Code / Codex / Cursor 等通用)
本仓库: Motor-CAD 轴向磁通电机 (AFM) 轴向磁拉力仿真项目。 接到任何任务前, 先读 docs/KNOWLEDGE_BASE.md —— 它包含环境事实、唯一可行的数据口 (3D lumped 力图, Fr=轴向力)、.mot 参数语义陷阱 (Magnet_Length 才是磁钢厚度、RMSCurrent 才是电流入口、磁钢 默认 100°C)、新模型 SOP 与全部已踩的坑。不读它会重复 5 轮探测的弯路。
快速执行: 对新 .mot 模型跑轴向磁拉力
pip install ansys-motorcad-core # 前置: Windows + Motor-CAD 2026R1
# 1) 新模型入库并提交 (纪律: 运行前必须 git commit)
# 2) 改 axial_force_final.py 顶部 MOT_SRC 与 SEC_RADII_MM (见 KB §5)
python -X utf8 axial_force_final.py # 前台弹 Motor-CAD, ~2分钟, --quit 自动关
# 3) 三判据 (作用反作用/转矩交叉/解析量级) 全过才采信 → 记录+提交
硬性纪律 (违者返工)
- 每次运行仿真前 git commit。
- 结果与报告带时间戳 + 简要说明并 git 提交; 报告文件名带版本号 (V1/V2...), 出新版保留旧版不覆盖。
- Motor-CAD 前台运行, 跑完保持打开供人工检查。
- 生成物 (output_motorcad/, *.log) 不入库, 关键数值转录进入库文档。
- 对话/决策带时间戳记入 docs/CONVERSATION_LOG.md; 原始 .mot 只读。
文件地图
| 文件 | 作用 |
|---|---|
| docs/KNOWLEDGE_BASE.md | 核心知识库 (方法/坑/SOP/成果, 先读) |
| axial_force_final.py | 正式计算脚本 (唯一需要运行的) |
| axial_compare.py | 气隙扫描 + 磁负刚度 |
| axial_probe*.py, axial_force_run.py | 探测历史存档, 勿运行 |
| REPRODUCE.md | 人类复现指南; docs/GUI_GUIDE.md 手动 GUI 操作 |
| RESULTS.md / docs/COMPARISON_V3.md | 已有结果 / 与解析报告 V3.0 的对照 |
| docs/report_axialforce_V*.html/.pdf | 版本化报告 (V2 最新) |
| docs/CONVERSATION_LOG.md | 全过程时间戳记录 |
| MARS-12S10P_*.mot | 原始模型 (只读) |
| 轴向磁通电机…V3.0-20260826.pdf | 对标的解析法报告 |