# AGENTS.md — AI 工具工作说明 (Claude Code / Codex / Cursor 等通用)

本仓库: Motor-CAD 轴向磁通电机 (AFM) 轴向磁拉力仿真项目。
接到任何任务前, **先读 [docs/KNOWLEDGE_BASE.md](docs/KNOWLEDGE_BASE.md)**
—— 它包含环境事实、唯一可行的数据口 (3D lumped 力图, Fr=轴向力)、.mot
参数语义陷阱 (Magnet_Length 才是磁钢厚度、RMSCurrent 才是电流入口、磁钢
默认 100°C)、新模型 SOP 与全部已踩的坑。不读它会重复 5 轮探测的弯路。

## 快速执行: 对新 .mot 模型跑轴向磁拉力

```bash
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) 三判据 (作用反作用/转矩交叉/解析量级) 全过才采信 → 记录+提交
```

## 硬性纪律 (违者返工)

1. 每次运行仿真前 git commit。
2. 结果与报告带**时间戳 + 简要说明**并 git 提交; 报告文件名带版本号
   (V1/V2...), 出新版**保留旧版不覆盖**。
3. Motor-CAD **前台**运行, 跑完保持打开供人工检查。
4. 生成物 (output_motorcad/, *.log) 不入库, 关键数值转录进入库文档。
5. 对话/决策带时间戳记入 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 | 对标的解析法报告 |
