# MARS 轴向磁通电机 轴向磁拉力仿真项目

用 Motor-CAD 2026R1 (PyMotorCAD 前台驱动) 对单定子单转子 (SSSR) 轴向磁通
电机计算轴向磁拉力, 并与解析法报告对标。全过程 git 管理、带时间戳记录。

## 核心结果 (模型 MARS-12S10P, 12槽10极, 气隙 1mm, 21A RMS)

| 工况 | 转子净轴向力 (指向定子) |
|---|---|
| 磁钢 100°C 热态, 空载/负载 | 342.9 / 343.2 N (电流影响 +0.1%, 纹波 ~1%) |
| 磁钢 20°C 冷态, 空载 | 416.5 N |
| 气隙 0.6 / 1.5 mm (20°C) | 513.1 / 326.7 N (磁负刚度 ~207 N/mm) |

与解析报告 V3.0 对照: 同温度基准下 FEA/解析 = 0.85~0.86, **对得上**;
轴承结论链 (708AC 不满足 → 推荐 7004AC) 双方互证。

## 快速开始

- **同事复现本结果**: 读 [REPRODUCE.md](REPRODUCE.md) — 一条命令 ~2 分钟。
- **用 AI 工具跑新模型**: 把仓库交给 AI (Claude Code / Codex / Cursor 等),
  它会读 [AGENTS.md](AGENTS.md) → [docs/KNOWLEDGE_BASE.md](docs/KNOWLEDGE_BASE.md)
  (方法、坑、SOP 全在里面), 然后按 SOP 改 `axial_force_final.py` 执行。
- **手动 GUI 操作**: [docs/GUI_GUIDE.md](docs/GUI_GUIDE.md)。

## 文档索引

| 文档 | 内容 |
|---|---|
| [docs/KNOWLEDGE_BASE.md](docs/KNOWLEDGE_BASE.md) | 知识库: 方法/参数语义/探测技术/SOP/纪律 |
| [RESULTS.md](RESULTS.md) | 结果与方法要点 |
| [docs/COMPARISON_V3.md](docs/COMPARISON_V3.md) | 与解析报告 V3.0 的逐项对照 |
| [docs/report_axialforce_V2.html/.pdf](docs/report_axialforce_V2.pdf) | 图文报告 (V2 最新, V1 保留) |
| [docs/CONVERSATION_LOG.md](docs/CONVERSATION_LOG.md) | 全过程带时间戳对话/决策记录 |
| [docs/GUI_GUIDE.md](docs/GUI_GUIDE.md) | Motor-CAD 手动操作 7 步指南 |
| [REPRODUCE.md](REPRODUCE.md) | 复现指南 (环境/运行/判定) |

## 脚本

- `axial_force_final.py` — 正式计算 (唯一需运行); `axial_compare.py` — 气隙扫描
- `axial_probe*.py` / `axial_force_run.py` — 5 轮探测历史存档, 勿运行

## 纪律 (详见 AGENTS.md)

运行前 git commit · 结果/报告带时间戳+说明并提交 · 报告版本化不覆盖 ·
Motor-CAD 前台 · 生成物不入库 · 原始 .mot 只读。