docs: add project discipline (README update mandatory), test records doc, and P4 completion in README

1. AGENTS.md - Added 'Project Discipline' section:
   - Every phase/milestone completion MUST update README.md
   - Every test MUST be recorded in docs/TEST_RECORDS.md (work traceability)
   - Git commit message format convention
   - Build artifacts exclusion rules

2. docs/TEST_RECORDS.md - Created test record document:
   - TEST-001: Motor-CAD connection & variable probing (2026-08-28)
     - Partially successful: 11/14 variables, found 2 bugs
     - Bug 1: GUI popups on get_variable for non-existent names
     - Bug 2: export_results API missing solution_type param
   - TEST-002: Full flow verification after fixes (2026-08-28)
     - All successful: connection/calc/export/parse
     - Popup suppression verified, export API fixed
     - Actual results: efficiency 86.06%, total loss 41.945W
   - 8 pending test items listed

3. README.md - Updated to V1.3:
   - Document version: V1.2 -> V1.3 (Phase 4 complete)
   - Current status updated to include Phase 4
   - Added Phase 4 milestone table (5 milestones + 2 patches)
   - Added Phase 4 core capabilities summary (10 AI pages, dual-system loop,
     batch scheduler, real-time monitor, advanced visualization, 16 robustness
     measures, auto report, deployment, Motor-CAD verification)

AGENTS.md

@@ -103,3 +103,30 @@ if not os.environ.get("MOTORCAD_ACTIVEX"):
 - 不要把生成物提交到 Git
 - 不要在 .py 文件中写中文字符（用 Unicode 转义或放 Markdown）
 - 不要用 `open_new_instance=False` 连接已有实例
+
+## 项目纪律（违者返工）
+
+### 1. 每次阶段/里程碑完成必须更新 README.md
+- 每个 Phase（P1/P2/P3/P4...）或每个 Milestone（M1/M2/M3...）完成后，**必须**立即更新 `README.md`，记录：
+  - 完成的功能点
+  - 新增的文件/模块
+  - 关键技术决策
+  - 已知问题和后续计划
+- 不允许"代码提交了但 README 没更新"的情况
+- README 更新应与代码提交在同一个 commit 中，或紧随其后
+
+### 2. 每次测试必须工作留痕
+- 每次实际运行 Motor-CAD 仿真、API 测试、集成测试后，**必须**记录到 `docs/TEST_RECORDS.md`
+- 记录内容包括：测试日期、测试环境、测试目的、测试步骤、测试结果（成功/失败）、关键数据、发现的问题、修复措施
+- 测试输出文件（CSV/JSON/log）保留在 `output/` 目录中，不入库但在记录中注明路径
+- 失败的测试也要记录，包括失败原因和后续修复
+
+### 3. Git 提交信息规范
+- Commit message 格式：`type(scope): description`
+  - type: feat/fix/docs/refactor/test/chore/enhance
+  - scope: 模块名（如 robust_motorcad, frontend, backend, p4-m3）
+- 重大变更在 commit message 中详细说明，不允许只写 "update" 或 "fix bug"
+
+### 4. 生成物不入库
+- `output/`、`runs/`、`build/`、`dist/`、`*.log`、`*.spec`、`__pycache__/` 不入库
+- 关键数值转录进入库的文档（TEST_RECORDS.md / RESULTS.md / 报告）

README.md

@@ -4,10 +4,10 @@
 
 | 项目 | 内容 |
 |---|---|
-| 文档版本 | V1.2（Phase 3 验收完成） |
+| 文档版本 | V1.3（Phase 4 验收完成） |
 | 作者 | Car.Lin |
 | 启动日期 | 2026-08-27 |
-| 当前状态 | Phase 1/2/3 全部完成，AI驱动自适应仿真闭环就绪 |
+| 当前状态 | Phase 1/2/3/4 全部完成，Web端AI集成+双系统闭环+批量调度+部署就绪 |
 | 设计方案 | [PCB轴向磁通电机自动化仿真系统设计方案介绍.md](PCB轴向磁通电机自动化仿真系统设计方案介绍.md) |
 | 远程仓库 | https://gogsgit.ez4l.com/carlin/pcb-afm-simulation-system |
 
@@ -71,6 +71,37 @@
 - **自适应闭环**：自然语言→AI方案→L0筛选→主动搜索→仿真→AI分析→经验提取→下一批
 - **32个P3 API端点**：覆盖AI/搜索/方案生成/结果分析/自适应闭环全流程
 
+### Phase 4（Web端AI集成 + 双系统闭环 + 批量调度 + 部署）— 全部完成
+
+> 将P3的AI能力前端化，打通Web端与本地仿真执行的双系统闭环，实现批量调度、实时监控、高级可视化和部署打包。
+
+| 里程碑 | 内容 | 状态 | Commit |
+|---|---|---|---|
+| P4-M1 | 前端AI功能集成（6个AI页面 + API封装 + 通用组件） | ✅ 完成 | `0da99ed` |
+| P4-M2 | 双系统任务下发与回传（后端任务管理 + 本地执行器 + 前端任务页） | ✅ 完成 | `25ae70f` |
+| P4-M3 | 批量调度 + 实时监控 + 增强版MotorCAD核心（16项鲁棒性措施） | ✅ 完成 | `315383c` |
+| P4-M4 | 高级可视化（4种ECharts图表） + 自动报告生成（Word/JSON） | ✅ 完成 | `fb5a72e` |
+| P4-M5 | 部署打包（Docker + docker-compose + nginx + Windows部署脚本） + 验收测试 | ✅ 完成 | `35b3f2a` |
+| P4-补丁1 | 修复export_results API兼容性（pymotorcad 0.8.8需要solution_type参数） | ✅ 完成 | `f3b492a` |
+| P4-补丁2 | 扩展指标别名（12→20个指标） + 测试脚本弹窗抑制 | ✅ 完成 | `6a8bc80` |
+
+**Phase 4 核心能力**：
+- **前端AI页面（10个新增页面）**：AI方案生成/L0预筛选/自适应优化/AI结果分析/多保真度校准/经验库增强/任务管理/实时监控/高级可视化
+- **双系统闭环**：Web创建任务 → 本地执行器轮询 → 领取任务 → 执行仿真 → 上报进度 → 回传结果 → Web存储展示
+- **批量调度器**：优先级队列(1-10) + 最大并行(默认2) + 任务依赖 + 断点续跑 + 实时统计
+- **实时监控仪表盘**：6项统计卡片 + 运行中/排队/历史任务面板 + 5秒自动刷新
+- **高级可视化**：Pareto前沿散点图 + 收敛轨迹折线图 + 多方案雷达图 + 参数敏感性热力图
+- **增强版MotorCAD核心（16项鲁棒性措施）**：
+  - 连接安全：open_new_instance=True + set_visible(True) + BlackBox无头模式
+  - 错误处理：MotorCADError优先捕获 + 单点超时重试 + 实例崩溃自动重连
+  - 批量安全：MessageDisplayState=2弹窗抑制 + try/finally恢复 + 参数写入回读校验 + 每点基线重载
+  - 数据完整：分号CSV解析 + 中英文字段别名 + 逐点双写(CSV+JSON) + flush+fsync
+  - 五层自检：连接/权限/许可/模型/脚本层启动前自检
+  - 变量名版本映射：可配置映射表，不硬编码
+- **自动报告生成**：Word报告（封面/参数/结果/AI分析/建议） + JSON fallback
+- **部署方案**：Dockerfile + docker-compose + nginx反向代理 + Windows一键部署脚本
+- **Motor-CAD实测验证**（MARS-12S10P，5000rpm）：连接→计算→导出→解析全流程成功，效率86.06%，总损耗41.945W，磁场计算138.1s/点
+
 ---
 
 ## 快速开始

docs/TEST_RECORDS.md

@@ -0,0 +1,124 @@
+# 测试记录与结果总结
+
+> 本文档记录 PCB 轴向磁通电机自动化仿真系统的所有测试记录，包括 Motor-CAD 仿真测试、API 测试、集成测试等。
+> 每次测试必须记录在此文档中（工作留痕）。
+> 最后更新：2026-08-28
+
+---
+
+## 测试记录索引
+
+| 编号 | 日期 | 测试类型 | 结果 | 关键发现 |
+|---|---|---|---|---|
+| TEST-001 | 2026-08-28 | Motor-CAD 连接与变量探测 | ⚠️ 部分成功 | 发现 export_results API 兼容性问题、弹窗问题 |
+| TEST-002 | 2026-08-28 | Motor-CAD 全流程验证（修复后） | ✅ 全部成功 | 验证连接/计算/导出/解析全流程，弹窗问题解决 |
+
+---
+
+## TEST-001：Motor-CAD 连接与变量探测测试
+
+**日期**：2026-08-28 04:49 - 05:08
+**测试环境**：Windows 10，Python 3.x，pymotorcad 0.8.8，Motor-CAD v261
+**测试目的**：验证 RobustMotorCADSolver 的连接、变量探测、参数写入、磁场计算、结果导出功能
+**测试脚本**：`scripts/test_robust_solver.py`
+**输出目录**：`output/test_connect_20260828_044951/`
+
+### 测试步骤与结果
+
+| 步骤 | 内容 | 结果 | 详情 |
+|---|---|---|---|
+| 1 | Motor-CAD 连接 | ✅ 成功 | `open_new_instance=True` + `set_visible(True)`，健康检查通过 |
+| 2 | 五层自检 | ✅ 完成 | 连接/许可/模型/脚本层 PASS，权限层 FAIL（非管理员，预期） |
+| 3 | 变量探测 | ⚠️ 11/14 | 3 个变量名不存在（`Stator_Number_Of_Slots`、`Rotor_Number_Of_Poles`、`Peak_Phase_Current`），**触发 GUI 弹窗需人工点确定** |
+| 4 | 参数写入+回读 | ✅ 成功 | TorquePointsPerCycle 30→60，回读 60.0，恢复 30 |
+| 5 | 磁场计算 | ✅ 成功 | 耗时 174.4 秒 |
+| 6 | 结果导出 | ❌ 失败 | `export_results() missing 1 required positional argument: 'file_path'` |
+| 7 | 断开连接 | ✅ 成功 | |
+
+### 探测到的模型参数（MARS-12S10P_SSSR_D76-C150_V5.0-0819.mot）
+
+| 参数 | 值 | 单位 |
+|---|---|---|
+| Motor_Type | 0 | - |
+| Airgap | 1 | mm |
+| Magnet_Arc_[ED] | 121 | EDeg |
+| MagnetCentralArc_HalbachRing | 120 | EDeg |
+| Slot_Opening | 8.5 | mm |
+| Slot_Width | 8.5 | mm |
+| Copper_Width | 3.64 | mm |
+| TorquePointsPerCycle | 30 | points/cycle |
+| AirgapMeshPoints_mesh | 600 | points |
+| AirgapMeshPoints_layers | 600 | points |
+| Shaft_Speed | 5000 | rpm |
+
+### 发现的问题
+
+1. **弹窗问题**：`get_variable` 对不存在的变量名会抛出异常 **并弹出 GUI 错误对话框**，阻塞无人值守批处理
+   - 修复：连接后立即设置 `MessageDisplayState=2` 禁用弹窗
+2. **导出 API 兼容性**：pymotorcad 0.8.8 的 `export_results` 签名是 `(solution_type, file_path)`，之前只传了 `file_path`
+   - 修复：改为 `export_results("EMagnetic", file_path)`
+
+### 修复提交
+
+- `f3b492a` — 修复 export_results API 兼容性
+
+---
+
+## TEST-002：Motor-CAD 全流程验证（修复后）
+
+**日期**：2026-08-28 05:08 - 05:15
+**测试环境**：Windows 10，Python 3.x，pymotorcad 0.8.8，Motor-CAD v261
+**测试目的**：验证 TEST-001 发现的两个问题修复后，全流程是否正常
+**测试脚本**：`scripts/test_robust_solver.py`（已添加弹窗抑制）
+**输出目录**：`output/test_connect_20260828_050834/`
+
+### 测试步骤与结果
+
+| 步骤 | 内容 | 结果 | 详情 |
+|---|---|---|---|
+| 1 | Motor-CAD 连接 | ✅ 成功 | `open_new_instance=True` + `set_visible(True)` |
+| 2 | 弹窗抑制 | ✅ 成功 | `MessageDisplayState=2`，变量探测阶段**无弹窗** |
+| 3 | 五层自检 | ✅ 完成 | 连接/许可/模型/脚本层 PASS，权限层 FAIL（非管理员，预期） |
+| 4 | 变量探测 | ✅ 11/14 | 3 个变量名不存在但**无弹窗**（已被抑制） |
+| 5 | 参数写入+回读 | ✅ 成功 | TorquePointsPerCycle 30→60，回读 60.0，恢复 30 |
+| 6 | 磁场计算 | ✅ 成功 | 耗时 **138.1 秒**（比 TEST-001 的 174.4 秒快） |
+| 7 | 结果导出 | ✅ 成功 | 10788 字节，`export_results("EMagnetic", path)` |
+| 8 | 结果解析 | ✅ 成功 | 解析到 7 个指标 |
+| 9 | 断开连接 | ✅ 成功 | 弹窗状态恢复，基线重载 |
+
+### 实际仿真结果
+
+| 指标 | 值 | 单位 |
+|---|---|---|
+| 系统效率 efficiency_pct | **86.06** | % |
+| 总损耗 total_losses_w | 41.945 | W |
+| 输入功率 input_power_w | 300.9 | W |
+| 磁钢损耗 magnet_loss_w | 0.5641 | W |
+| 定子铁耗 iron_loss_w | 3.002 | W |
+| 线间反电动势有效值 back_emf_v | 7.898 | V |
+| 轴转速 shaft_speed_rpm | 5000 | rpm |
+
+### 注意事项
+
+- 本次未解析到 `tavg_nm`（平均转矩）和 `ripple_pct`（转矩脉动），原因是字段名匹配不完整
+- 已在 `6a8bc80` 提交中扩展 `METRIC_DEFINITIONS` 从 12 个指标到 20 个，添加了中文字段名变体
+- 下次测试应能解析到更多指标
+
+### 修复提交
+
+- `6a8bc80` — 扩展指标别名 + 测试脚本弹窗抑制
+
+### 测试结论
+
+**RobustMotorCADSolver 已验证可正常连接 Motor-CAD、执行磁场计算、导出并解析结果，弹窗问题已解决，可支持无人值守批量仿真。**
+
+---
+
+## 待办测试项
+
+- [ ] TEST-003：多参数扫描测试（3 个磁钢弧角值），验证 `run_single_point()` 完整流程和逐点落盘
+- [ ] TEST-004：扩展指标解析验证（确认 tavg_nm、ripple_pct 等能正确解析）
+- [ ] TEST-005：批量调度器测试（BatchScheduler 多任务排队）
+- [ ] TEST-006：Web 端 API 集成测试（任务创建/下发/进度/结果回传）
+- [ ] TEST-007：断点续跑测试（中断后恢复）
+- [ ] TEST-008：长时间稳定性测试（50+ 仿真点）