# 对话与决策记录

> 所有关键决策、技术选择、问题排查均带时间戳记录于此。
> 格式：`## YYYY-MM-DD HH:MM — 主题`

---

## 2026-08-27 — 项目启动与 Phase 1 范围确认

### 参与者
Car.Lin（项目负责人）

### 背景
基于已完成的两个参考案例（axial_mag_pull 轴向磁拉力仿真、torqrippswap 转矩脉动参数扫描），启动 PCB 轴向磁通电机自动化仿真系统的正式开发。

### 关键决策

1. **项目架构**：采用设计方案 V1.1 的双系统解耦架构
   - 系统一（Web端）：方案生成与优化
   - 系统二（本地EXE）：仿真执行
   - 接口：simulation_plan.json / simulation_results.csv

2. **Phase 1 范围**：最小闭环验证
   - 仿真工具：Motor-CAD 2026R1（电磁仿真）
   - 拓扑：SSSR（单定子单转子）
   - 调试模型：MARS-12S10P_SSSR_D76-C150_V5.0-0819.mot
   - 输出指标：平均转矩、转矩脉动(%)、系统效率、总损耗（轴向力暂不做）
   - 方案编辑：本地GUI内做简单方案编辑器（选参数、设范围步长）
   - 经验库：SQLite + JSON 文件轻量方案
   - 通信：本地文件交换

3. **参考案例复用策略**
   - Motor-CAD 连接/参数写入/回读校验/每点重载/结果解析：复用 torqrippswap 的 solver.py
   - AFM 参数语义/环境陷阱/探测技术：复用 axial_mag_pull 的 KNOWLEDGE_BASE
   - GUI 架构/闪退防护/打包：参考 torqrippswap 的 DESKTOP_APP_WORKFLOW.md
   - 三判据校验：轴向力目标时复用 axial_mag_pull；转矩/效率目标需另建判据

4. **工程规范**
   - 所有 .py / .ps1 源码纯 ASCII
   - 运行前 Git preflight 强制检查
   - 参数写入后必须回读校验
   - 每点重新加载基线模型
   - 结果逐点落盘（每点 flush）
   - 原始 .mot 只读

5. **理论参考**
   - 主要参考：《轴向磁通永磁无刷电机（原书第2版）》Jacek F. Gieras
   - 补充参考：《轴向磁场无刷同步电机理论与设计》邓秋玲
   - 知识文档中标记理论参考路径，理论缺乏时优先查书

6. **DRSS V16.html**
   - 仅参考其交互方式和参数组织形式
   - 不直接复用计算逻辑
   - 不深入分析

### 里程碑规划
- M1：环境验证 + 单工况仿真脚本
- M2：参数扫描引擎（单参数/多参数）
- M3：方案JSON接口 + 本地GUI
- M4：经验库雏形 + 反馈闭环

### 待办
- [x] 搭建项目规范文档
- [x] 编写 solver_core.py
- [x] 编写 run_single.py 并跑通 MARS 模型
- [x] 初始化 Git 仓库
- [x] M2: 参数扫描引擎 + 气隙扫描验证
- [ ] M3: 方案JSON接口 + 本地GUI
- [ ] M4: 经验库雏形 + 反馈闭环

---

## 2026-08-27 13:55 — M1 完成：单工况仿真跑通

### 成果
- `src/solver_core.py`：Motor-CAD连接、参数回读校验、电磁求解、16项指标提取
- `scripts/run_single.py`：单工况验证脚本
- Git仓库初始化，初始commit `75347b6`

### 验证结果（MARS-12S10P SSSR，模型默认工况）
| 指标 | 数值 |
|---|---|
| 平均转矩 | 0.5219 Nm |
| 转矩脉动 | 2.8150 % |
| 系统效率 | 86.06 % |
| 总损耗 | 41.945 W |
| 求解耗时 | 139.2 s |

状态：OK，Phase 1 四项必选指标全部提取成功。

---

## 2026-08-27 14:42 — M2 完成：参数扫描引擎 + 气隙扫描验证

### 成果
- `src/scan_engine.py`：笛卡尔积扫描、每点基线重载、参数回读校验、断点续跑、逐点CSV flush、manifest+log+raw
- `scripts/run_scan.py`：CLI入口，支持config JSON或命令行参数，内置Git preflight
- `scripts/scan_airgap.json`：气隙扫描配置（0.6/1.0/1.5mm）
- commit `a43d971`

### 气隙扫描验证结果（3点全部OK，总耗时约7分钟）

| 气隙(mm) | 平均转矩(Nm) | 转矩脉动(%) | 效率(%) | 总损耗(W) | 铁耗(W) | 磁钢损耗(W) | 反电动势(V) | 空载转速(rpm) |
|---|---|---|---|---|---|---|---|---|
| 0.6 | 0.5663 | 5.451 | 84.93 | 49.92 | 3.93 | 0.93 | 8.79 | 5450 |
| 1.0 | 0.5219 | 2.815 | 86.06 | 41.95 | 3.00 | 0.56 | 7.90 | 6055 |
| 1.5 | 0.4677 | 1.753 | 86.35 | 36.56 | 2.17 | 0.31 | 6.95 | 6878 |

### 物理趋势验证（全部符合预期）
1. **转矩随气隙增大而减小**：磁耦合减弱 ✓
2. **转矩脉动随气隙增大而减小**：磁场更平滑，齿槽效应减弱 ✓
3. **效率随气隙增大略升**：铁耗+磁钢损耗下降幅度超过转矩下降 ✓
4. **铜耗恒定16.76W**：电流不变 ✓
5. **反电动势随气隙增大而减小**：气隙磁密降低 ✓
6. **空载转速随气隙增大而升高**：弱磁效应 ✓

### 关键验证点
- 1.0mm点与M1单工况结果**完全一致**（0.5219/2.815/86.06/41.95），确认每点基线重载正常工作，无参数污染
- 每点求解耗时134-141s，与M1一致
- 输出目录结构完整：scan_results.csv + program_log.log + run_manifest.json + raw/（3个原始导出）
- Git preflight正常工作

---

## 2026-08-27 15:15 — M3 完成：方案JSON接口 + PySide6本地GUI

### 成果
- `src/plan_schema.py`：SimulationPlan / ScanVariable / ScanCase 数据类，JSON序列化/反序列化，验证，笛卡尔积点生成
- `src/gui/main.py`：PySide6 GUI主窗口（方案编辑器 + 执行监控 + 结果表 + 彩色日志）
- `src/gui/__init__.py`：GUI包初始化
- `scripts/run_gui.py`：GUI启动脚本
- PySide6 6.11.2 已安装

### GUI功能
- 模型路径选择（Browse按钮）
- 扫描变量表格编辑器（添加/删除变量，设置name/start/stop/step或显式values）
- 实时估算总点数和耗时
- 方案保存/加载（simulation_plan.json）
- Start/Stop扫描控制
- 进度条实时更新
- 结果表格实时刷新（核心指标优先，附加指标随后）
- 彩色分级日志（INFO/OK/WARN/ERROR）
- 状态栏
- Git preflight检查（不干净时提示确认）

### 工程规范
- 5层闪退防护：全局excepthook、禁止末窗退出、dict安全访问、槽函数try-except、MotorCAD对象keepalive
- QThread子线程运行仿真，不阻塞UI
- 信号槽通信（log/progress/result_row/finished/failed）
- 工业软件风格QSS（浅灰蓝背景、白色卡片、蓝色强调色）
- 全部源码纯ASCII

### 验证
- GUI窗口创建测试通过（标题、变量表、估算标签正常）
- plan_schema保存/加载/点生成/验证测试通过
- 语法检查全部通过
- ASCII检查全部通过

### 待M4
- 经验库雏形（SQLite + JSON）
- 反馈调整方案（基于结果推荐下一轮参数范围）
- GUI集成经验库检索