# 第三方评审响应与 Phase 3 更新计划

> **文档版本**: V1.0
> **日期**: 2026-08-27
> **评审对象**: 《PCB轴向磁通电机自动化仿真系统设计方案介绍》V1.1
> **评审文档**: `第三方评审/PCB轴向磁通电机Motor-CAD仿真策略评审与实施建议.md`

---

## 一、评审结论与总体响应

### 1.1 评审核心结论

第三方专家评审结论为**"有条件通过"**：系统架构和阶段规划方向正确，但仿真策略需从"固定批量DoE+代理模型全局优化"升级为**"多保真度模型路径 + 可行性优先搜索 + 批量自适应闭环"**。

### 1.2 我们的总体响应

| 评审意见 | 响应 | 落地阶段 |
|---|---|---|
| 增加L0解析与规则预筛选 | 采纳，作为所有仿真路径的入口 | P3-M2 |
| 扫描策略拆分为搜索策略+保真度策略 | 采纳，JSON Schema V2扩展 | P3-M1 |
| 可行性优先模式（约束贝叶斯/主动学习） | 采纳，作为默认模式 | P3-M2 |
| Motor-CAD/Maxwell/JMAG分层职责+偏差校准 | 采纳，建立L0-L4保真度分级 | P3-M1/P3-M4 |
| 六类收敛判据 | 采纳，结果数据模型扩展 | P3-M1 |
| 结果数据模型扩展（保真度/模型版本/约束裕量/置信等级） | 采纳，Schema V2 | P3-M1 |
| 三种运行模式（固定/批量自适应/本地闭环） | 采纳，执行引擎升级 | P3-M5 |
| 并行与缓存机制 | 采纳，参数哈希缓存键 | P3-M5 |
| PCB等效模型字典 | 采纳，经验库绑定模型版本 | P3-M4 |

---

## 二、P0 必须修改项（已纳入 P3-M1）

### 2.1 JSON Schema V2 扩展字段

在现有 `simulation_plan.json` 基础上增加以下顶层字段：

```json
{
  "schema_version": "2.0",
  "strategy_mode": "fast_feasible",
  "fidelity_strategy": {
    "levels": ["L0_analytic", "L1_motorcad_emag", "L2_motorcad_lab_therm", "L3_maxwell_3d"],
    "upgrade_rule": "top_candidates_only",
    "max_candidates_for_l3": 3
  },
  "search_strategy": {
    "method": "constrained_bayesian",
    "initial_samples": 16,
    "batch_size": 4,
    "max_solver_calls": 80,
    "local_trust_region": true
  },
  "calibration_policy": {
    "cross_tool_metrics": ["torque_nm", "efficiency_pct", "axial_force_n"],
    "tolerance": {"torque_pct": 5, "efficiency_point": 1.0}
  },
  "acceptance_criteria": {
    "hard_constraints": ["torque_nm >= 10", "temperature_c <= 120"],
    "surrogate_max_uncertainty": 0.05,
    "robustness_required": true
  }
}
```

### 2.2 结果数据模型扩展

每条结果增加：

| 字段 | 说明 |
|---|---|
| `fidelity_level` | L0/L1/L2/L3/L4 |
| `model_template_version` | Motor-CAD模板、PCB等效模型版本 |
| `solver_settings_hash` | 网格、周期数、求解配置摘要 |
| `constraint_margins` | 各硬约束的绝对裕量和百分比裕量 |
| `surrogate_prediction` | 代理模型预测值、不确定度、实际偏差 |
| `cross_validation` | Motor-CAD与Maxwell/JMAG同工况偏差 |
| `confidence_grade` | A/B/C/D置信等级 |

### 2.3 六类收敛判据

| 收敛类型 | 判据 | 输出状态 |
|---|---|---|
| 求解器收敛 | 求解完成、结果完整、无致命错误 | SOLVER_PASS/FAIL |
| 硬约束收敛 | 转矩/温度/电压/电流/尺寸/轴向力均满足 | FEASIBLE/INFEASIBLE |
| 优化收敛 | 连续若干轮最优改进<阈值，或信任域半径<下限 | CONVERGED/STALLED |
| 代理模型可信 | 交叉验证误差和候选点不确定度<阈值 | MODEL_TRUSTED/UNCERTAIN |
| 跨工具一致 | Motor-CAD与Maxwell/JMAG同工况偏差在接受范围 | HF_PASS/FAIL |
| 鲁棒性收敛 | 制造和材料扰动下仍满足硬约束 | ROBUST/FRAGILE |

---

## 三、多保真度分级（L0-L4）

| 层级 | 模型/工具 | 主要任务 | 可定案 |
|---|---|---|---|
| L0 | 解析公式+规则引擎 | 几何/电气/热/制造可行性预筛选 | 否 |
| L1 | Motor-CAD快速电磁模型 | 主要参数收敛、关键工况筛选、初步性能验证 | 否 |
| L2 | Motor-CAD Lab/Therm/Mech | 候选方案多物理场复核、效率图和温升初评 | 仅作工程候选 |
| L3 | Maxwell 3D / JMAG | PCB绕组、3D磁路、端部效应、局部损耗、轴向力校验 | **是，需通过验收阈值** |
| L4 | 扰动/公差/样机数据 | 制造鲁棒性和模型持续校准 | 用于最终放行 |

**核心原则**：Motor-CAD决定"大方向是否对"，Maxwell/JMAG决定"工程结果是否真"。任何只经过Motor-CAD而未经过高保真复核的方案，不应标记为最终可行设计。

---

## 四、三种运行模式

| 模式 | 工作方式 | 适用阶段 |
|---|---|---|
| 固定计划模式 | 一次性接收全部仿真点并顺序执行 | Phase 1最小闭环（当前已实现） |
| 批量自适应模式 | 每轮接收4-8个点，执行后回传，方案系统计算下一轮 | P3算法增强 |
| 本地闭环模式 | 执行程序内部运行确定性优化器（约束贝叶斯/信任域），根据结果动态选点 | 无人值守或网络受限场景 |

> 本地闭环模式不违背"执行程序无需联网/AI"原则——约束贝叶斯、信任域和NSGA-II属于确定性数值优化算法，可打包在本地EXE中运行，不需要LLM。

---

## 五、Phase 3 更新后的里程碑计划

### P3-M1：基础设施层（AI服务 + Schema V2 + 保真度框架）

**目标**：搭建Kimi AI服务层，完成JSON Schema V2扩展，建立保真度等级和结果数据模型基础。

| 任务 | 说明 |
|---|---|
| Kimi AI客户端封装 | `src/ai_client.py` — OpenAI兼容SDK，支持重试/超时/流式，端点`api.kimi.com/coding/v1`，模型`k3` |
| API Key安全管理 | `.env`文件（已gitignore），环境变量`KIMI_API_KEY`，启动校验 |
| Prompt模板管理 | `prompts/`目录，Jinja2模板，按功能模块组织 |
| 调用日志与计费 | `ai_call_logs`表，记录token/耗时/模型/状态 |
| JSON Schema V2 | 扩展strategy_mode/fidelity_strategy/search_strategy/calibration_policy/acceptance_criteria |
| 保真度等级枚举 | L0-L4等级定义，结果模型增加fidelity_level/confidence_grade字段 |
| 六类收敛状态枚举 | SOLVER_PASS/FEASIBLE/CONVERGED/MODEL_TRUSTED/HF_PASS/ROBUST |
| AI健康检查接口 | `GET /api/ai/health` — 测试Key有效性，返回模型列表 |

**验收**：AI客户端可正常调用k3模型；Schema V2可序列化/反序列化；数据库迁移完成。

---

### P3-M2：L0预筛选引擎 + 可行性优先搜索框架

**目标**：实现解析预筛选和约束贝叶斯/主动学习的算法框架。

| 任务 | 说明 |
|---|---|
| L0解析预筛选规则 | 几何约束（内外径/气隙/轴向长度）、电气约束（电流密度/电压/磁负荷）、热约束（温升/冷却）、制造约束（PCB线宽线距/铜厚/公差） |
| 可行域裁剪 | 根据边界条件和L0规则，裁剪参数搜索空间，输出可行/不可行区域 |
| 约束贝叶斯优化框架 | 基于scikit-optimize或自定义GP，建模硬约束满足概率，采集函数平衡利用与探索 |
| 主动学习选点策略 | 每轮推荐4-8个仿真点，优先选择可行概率高且信息增益大的组合 |
| 局部信任域收敛 | 发现稳定可行区后，在当前最优点附近做小范围精细搜索 |
| 初始种子生成 | 优先使用相似案例和专家模板，再用少量LHS补足空间覆盖 |
| 搜索状态管理 | 记录每轮选点、预测值、不确定度、约束概率，支持断点续跑 |

**验收**：对一个SSSR案例，L0预筛选能排除明显不可行区域；贝叶斯框架能输出下一批推荐点。

---

### P3-M3：AI方案生成器（自然语言 → 智能方案）

**目标**：用户用自然语言描述需求，AI结合L0预筛选和搜索策略，自动生成完整仿真方案。

| 任务 | 说明 |
|---|---|
| 需求解析Prompt | 自然语言需求 → 结构化参数（拓扑/尺寸/电流/转速/目标/约束） |
| AI参数推荐 | 结合经验库历史数据，推荐扫描范围、步长、初始值，给出推荐理由 |
| 方案生成接口 | `POST /api/ai/generate-plan` — 输入项目ID+自然语言，输出完整plan_data（Schema V2） |
| 前端AI生成入口 | 项目详情页"AI生成方案"按钮，弹窗输入需求，展示结果，支持人工编辑 |
| 方案校验流水线 | AI生成 → L0预筛选 → 规则引擎校验 → 点数预估 → 保存 |
| 多轮优化 | 支持"再优化一下"——用户给反馈，AI迭代调整参数 |
| 方案可解释性 | 每个推荐参数输出来源（经验库/规则/AI推理）和置信度 |

**验收**：输入自然语言需求，能生成通过L0校验的合法方案，点数预估合理。

---

### P3-M4：AI结果分析师 + 多保真度校准 + 置信等级

**目标**：仿真完成后，AI自动分析结果，生成解读报告；建立多保真度偏差校准机制。

| 任务 | 说明 |
|---|---|
| 结果摘要生成 | `POST /api/ai/analyze-results` — AI分析所有扫描点，生成文字摘要（最优值/趋势/异常） |
| 参数敏感性解读 | 结合敏感性分析数据，AI用自然语言解释参数影响 |
| 优化建议生成 | AI基于结果和经验库，给出下一步优化方向 |
| 报告导出 | Markdown/HTML格式分析报告，含图表+文字解读，支持下载 |
| 前端报告页面 | 方案详情页"AI分析报告"Tab，流式输出展示 |
| 多保真度校准表 | 记录Motor-CAD与Maxwell/JMAG同工况偏差，支持加法/乘法修正系数 |
| 置信等级评定 | 根据验证深度自动评定A/B/C/D等级，C级以下不可对外承诺 |
| PCB等效模型字典 | 记录铜厚/线宽/线距/层数/过孔/FR4热属性等等效假设，经验库绑定模型版本 |
| 校准系数反哺 | 高保真偏差修正系数反哺到代理模型和目标函数，避免搜索方向被带偏 |

**验收**：对已有结果的方案调用分析接口，能生成引用具体数据的合理解读；校准表可记录跨工具偏差。

---

### P3-M5：经验库AI增强 + 批量自适应闭环 + 端到端验收

**目标**：AI增强经验库检索与推理；实现批量自适应闭环；完成P3全流程验收。

| 任务 | 说明 |
|---|---|
| 语义检索 | `POST /api/ai/semantic-search` — 自然语言查询→理解意图→检索经验库 |
| 案例对比分析 | 选择多个案例，AI自动对比参数差异、指标优劣，给出适配建议 |
| 经验自动沉淀 | 仿真完成后AI自动提取结论，生成经验草稿，人工确认后入库 |
| 智能问答(RAG) | `POST /api/ai/qa` — 基于经验库内容的问答，引用具体案例作答 |
| 经验标签自动生成 | AI自动推荐标签（高效率/低脉动/大气隙等），减少人工标注 |
| 批量自适应通信协议 | 批次ID、增量结果上传、方案版本追踪、下一轮选点请求 |
| 执行引擎批量模式 | 系统二支持接收批次点、执行后回传、等待下一轮指令 |
| 参数哈希缓存机制 | 缓存键=参数哈希+模型版本+工况ID+求解器版本+保真度等级，中断不重复计算 |
| 并行任务池预留 | Motor-CAD多实例并行框架（独立工作目录+模型副本） |
| 端到端测试 | 自然语言生成方案→L0筛选→保存→(模拟)上传结果→AI分析→经验沉淀 |
| AI成本监控 | token消耗统计，Prompt优化，单次调用上限 |
| 文档更新 | README V1.1，AI功能使用说明，Schema V2文档，评审响应文档 |
| 验收测试 | `test_ai.py` — AI客户端/方案生成/结果分析/语义检索的单元+集成测试 |

**验收**：所有AI功能可用，批量自适应闭环跑通，文档完善，测试通过。

---

## 六、Kimi API 技术规格（已验证）

| 项目 | 值 |
|---|---|
| 端点 | `https://api.kimi.com/coding/v1` |
| 模型 | `k3`（Kimi K3，1M上下文，支持推理） |
| 备选模型 | `k3-256k` / `kimi-for-coding` / `kimi-for-coding-highspeed` |
| API Key | `sk-kimi-xxx`（Kimi Code Plan，订阅制，消耗Code Plan配额） |
| 兼容格式 | OpenAI Chat Completions API |
| 特殊能力 | 支持思考模式（reasoning_content）、视觉输入、视频输入 |
| 验证状态 | 2026-08-27 验证通过，正常返回 |

---

## 七、风险与应对（更新版）

| 风险 | 等级 | 控制措施 |
|---|---|---|
| PCB近似模型系统性偏差 | 高 | 建立校准系数；关键指标必须高保真复核；偏差反哺代理模型 |
| 轴向磁通3D效应 | 高 | Motor-CAD只用于筛选；最终候选必须3D FEA |
| AI生成方案不合法 | 中高 | L0预筛选+规则引擎强制校验，不合法拒绝保存 |
| API调用成本 | 中 | 默认k3模型，设置token上限，Prompt精简，结果缓存 |
| API不稳定 | 中 | 超时重试3次（指数退避），失败优雅降级 |
| 经验库冷启动污染 | 中高 | 所有经验绑定模型版本+保真度+置信等级，专家审核后入库 |
| 自适应算法不可解释 | 中 | 每个推荐点输出来源/预测值/不确定度/约束概率 |
| 并行许可和文件冲突 | 中 | 独立工作目录、模型副本、许可检测、任务队列 |

---

## 八、待确认问题（需与专家/用户确认）

1. PCB电机结构：无铁芯PCB定子 / PCB绕组+铁芯 / 混合结构？
2. Maxwell和JMAG哪个作为第一优先级高保真工具？
3. 默认业务目标：快速可行 / 完整Pareto / 量产鲁棒设计？
4. 有几套Motor-CAD/Maxwell/JMAG许可？是否允许多实例并行？
5. 气隙/PCB线宽线距/铜厚/磁钢Br/装配偏心的制造公差？
6. 最终验收阈值由哪个专家团队签发？是否有样机数据可用于初始校准？

> 以上问题不阻塞P3-M1~P3-M3开发，可在P3-M4（高保真校准）前确认。