1. 问题：AI 填表的信任矛盾

传统 AI 表单有两个极端：

全自动写库：效率最高，但用户不知道 AI 有没有编造数据
AI 给建议 + 全人工填写：可信度最高，但效率等于零

EAMX 的解法：给每字段一个置信度 + 一个来源标签，让用户按颜色有选择地核对。

2. 三分组架构

`` 铭牌照片 / 合同 PDF │ Stage 1: nameplate-extractor → RawField[] (含 confidence) Stage 2: field-classifier → ClassifiedFields │ ┌─────┼─────┐ │ │ │ A类 B类 C类 │ │ │ ▼ ▼ ▼ DynamicForm UI Card ``

| 分组 | 来源 | 置信度 | 前端颜色 | 用户操作 | |---|---|---|---|---| | A 类 | 铭牌/合同 OCR 提取 | 0.85-0.95 | 🟢 绿色 | 闭眼过 | | B 类 | 历史数据推断 + 系统默认 | 0.55-0.80 | 🟡 黄色 | 看一眼 | | C 类 | 未映射的技术参数 | 铭牌置信度 | 📋 灰色 | 存在 JSONB |

3. A 类：文档直接提取（绿区）

```typescript // equipment.agent.ts — prepare_equipment_form const conf = (val: unknown, high = 0.92, low = 0.0) => val != null && val !== "" ? high : low;

const classAFields = [ { key: "name", label: "设备名称", confidence: conf(p.name, 0.95), source: p.name ? "铭牌" : "未识别", required: true }, { key: "model", label: "型号/规格", confidence: conf(p.model, 0.92), source: p.model ? "铭牌" : "未识别", required: false }, { key: "serialNumber", label: "出厂序列号", confidence: conf(p.serialNumber, 0.92), source: p.serialNumber ? "铭牌" : "未识别", required: false }, { key: "ratedPower", label: "额定功率", confidence: conf(p.ratedPower, 0.88), source: p.ratedPower ? "铭牌" : "未识别" }, { key: "weight", label: "重量", confidence: conf(p.weight, 0.85), source: p.weight ? "铭牌/手册" : "未识别" }, { key: "purchaseValue",label: "原值（元）", confidence: conf(p.purchaseValue, 0.88), source: p.purchaseValue ? "合同/发票" : "未识别" }, // ... 共 14 个 A 类字段 ]; ```

置信度赋值规则：有值 → 给一个基于"该字段在铭牌上通常有多清晰"的经验置信度。无值 → 0，前端渲染为红色"待填写"。

4. B 类：AI 推断（黄区）

B 类字段需要"台账管理"但不直接从铭牌/合同中提取——分类、部门、位置等。EAMX 从同型号历史设备推断：

``typescript // 查询同型号已有设备（最近 5 条） const similar = await db .select({ category, department, location, grade }) .from(equipmentsTable) .where(and(eq(tenantId), ilike(model, %${modelVal}%`))) .orderBy(desc(createdAt)).limit(5);

// 取出现最频繁的值 bSuggestion = { category: freq(similar.map(s => s.category)), department: freq(similar.map(s => s.department)), location: freq(similar.map(s => s.location)), grade: freq(similar.map(s => s.equipmentGrade)), }; ```

在表单上呈现为黄色 + 来源标签：

``typescript { key: "category", label: "设备分类", value: bSuggestion.category, confidence: 0.72, source: "AI建议 · 同租户历史设备", warning: 基于同类型设备历史归类建议：${bSuggestion.category}, }, { key: "department", label: "使用部门", value: bSuggestion.department, confidence: 0.65, source: "AI建议 · 同租户历史设备", }, ``

B 类字段的黄色着色和 warning 提示确保用户不会盲目接受 AI 的推断。

5. C 类：技术参数 JSONB

铭牌上大量不属于台账列的参数（额定电压、工作压力、防护等级等），全部进入 technicalSpecsJson：

```typescript // field-classifier.ts — 未命中 FIELD_MAP 的字段 if (!mappedKey) { if (!(field.label in technicalSpecs)) technicalSpecs[field.label] = val; }

// flattenToFormParams — 序列化为 JSON 字符串 params.technicalSpecsJson = JSON.stringify(technicalSpecs); ```

前端以可编辑技术参数区域展示，每条带 [铭牌] 来源标签。

6. UI Card 协议

``typescript return { type: "UI_CARD", cardType: "dynamic_form", formTitle: "设备台账确认", taskId: "create_equipment", // 前端提交时回传 description: "请核对AI提取的设备信息...", fieldGroups: [ { id: "classA", title: "A类 — 基本信息（从文档提取）", description: "AI直接从铭牌/合同/发票中识别的字段，绿色表示高置信度" }, { id: "classB", title: "B类 — 管理属性（AI建议，请核对）", description: "台账管理所需但文档未记录的字段" }, ], fields: [...classAFields, ...classBFields], technicalParams, // C 类 }; ``

前端按 fieldGroups 分组渲染，根据 confidence 自动着色，根据 source 显示标签，根据 required 标记必填。

7. 核心文件

| 文件 | 职责 | |---|---| | agents/equipment.agent.ts L226-438 | prepare_equipment_form —— A/B/C 三组构造 | | agents/field-classifier.ts | Stage 2 纯代码分类、flattenToFormParams | | agents/nameplate-extractor.ts | Stage 1 视觉提取（提供 A 类字段的原始 confidence） |

下一篇：插件化架构设计——PluginRegistry 74 行核心代码如何支撑 11 个独立模块。