ESim 电工制图AI 电路生成规范V2.0

📋

CORE CONTRACT总览 · AI 必须遵守的核心契约

01 / 14

本规范确立 “AI 先生成控件布局 + 端子直连导线，用户执行【导线一键优化】后由 ESim 电工制图完成正交避障路由” 的协同模式。

✅强制性要求

• 两步走策略：第1步做控件布局（位置+尺寸），第2步做端子直连（只关心谁连谁，不关心导线拐点轨迹）
• 直连线策略：AI 只需生成起点到终点的直线导线，禁止计算任何中间拐点；正交化路由由用户在软件中执行【导线一键优化】完成
• 端子直连策略：禁止使用导线交点和虚拟端子，所有导线必须直接连接真实端子
• 每个元件和导线拥有唯一非空 GUID（禁止 Guid.Empty、禁止重复）
• TypeName 使用完整命名空间（如 Controls.SVG.PushButtonNO 或 Controls.Bulb）
• ComponentTitle 必须与控件默认标题逐字一致；ControlName、ControlLabel 必须非空
• 导线必须通过 StartTerminal / EndTerminal 精确引用真实端子（元件 GUID + 端子名）
• 导线 Start / End 坐标必须按所连端子的真实绝对位置计算（含旋转计算）；即使加载时软件会按有效端子引用自动校正，也不得故意写错
• SVG 控件（Controls.SVG.*）IsSVG=true，端子属性 IsConnected、Direction、ContactType、GroupId、GroupType 全部按控件清单明确赋值（默认 RotationAngle=0；若用户明确要求旋转，Direction 按旋转章节写“旋转后的最终方向”）
• SVG 控件默认禁止旋转：RotationAngle 必须为 0；除非用户明确要求横向放置等特殊场景，AI 不得自行旋转任何 SVG 控件
• 图片控件（Controls.*）IsSVG=false，端子节点只写 Name 与 IsConnected，其余拓扑属性省略（系统自动采用默认值）
• 端子名精确匹配：TerminalName 必须与控件清单中的端子 Name 逐字符完全一致（包括大小写、下标、字母 O 与数字 0 的区别）
• 源码为唯一真值：本规范中的端子表是当前版本源码实际 Terminal.Label 的摘录，不是“命名建议”。若文档与源码/控件清单冲突，以源码为准；停止生成并报告冲突，不得为了“统一命名/看起来更合理”自行改名或猜测
• 文件编码：.esimdrawing 必须使用 UTF-8 保存；否则中文 ControlName、U₁ 等字符会乱码
• 交付说明：生成结果中的导线是直线；必须提示用户在软件中点击【导线一键优化】

🚫禁止行为

• ✕尝试计算 L/Z/U 形拐点（AI 计算拐点极易导致穿模或与优化器冲突）
• ✕使用 ConnectionPoints 或 StartWireTerminal / EndWireTerminal（虚拟端子由软件自动管理）
• ✕GUID 重复或使用 Guid.Empty
• ✕使用短类型名（如仅 "PilotLight"，必须 "Controls.SVG.PilotLight"）
• ✕导线 Start/End 坐标与端子绝对位置不匹配（加载时软件会用有效端子引用校正端点，但这会掩盖接线错误；不要依赖该纠正）
• ✕把 AC 额定器件串入 DC 回路，或把 DC 额定器件串入 AC 回路（电源转换边界除外，见“电气类型与电压等级”）
• ✕自行发明端子名、缩写端子名（如把 U₁ 写成 U1、把 OV 写成 0V）
• ✕把同一物理器件的线圈与触点编成不同 ControlLabel（会导致仿真不联动）
• ✕引用 SafetyRelay 的 CH11/CH12/CH21/CH22 内部端子
• ✕依赖 MD200Y 输出侧的第二个 COM 做精确引用

🧠AI 生成逻辑路径

1. 确定图纸规格与标题，核对画布可用区域（见“图纸布局”）
2. 布局元件（电源左/上 → 开关保护中 → 负载右/下），预留端子间距（通道 ≥100px）
3. 从本规范控件清单复制完整 ComponentData 定义，更新 GUID、坐标和 ControlLabel
4. 计算每个端子的绝对位置（默认保持 RotationAngle=0；如用户明确要求旋转，按旋转章节计算并标注风险）
5. 为每对需连接的端子生成直线导线：Start=端子A绝对位置，End=端子B绝对位置，Points 留空
6. 为导线建立精确的 StartTerminal / EndTerminal 引用
7. 校验全局设置，按 UTF-8 输出 XML
8. 交付时说明：打开文件后需点击【导线一键优化】

🧠

METHODOLOGYAI 生成方法论：布局优先，接线从简

02 / 14

核心理念

AI 生成电路应分为两个独立阶段，切勿混为一谈：

为什么不需要关心导线轨迹？

导线从端子A到端子B的具体走线路径（拐几个弯、从哪里绕行）由 ESim电工制图的 【导线一键优化】功能 完成。用户点击该功能后，软件会根据控件位置与轮廓计算正交路径并避让元件。

AI 只需做到：

1. 正确布局控件，预留足够间距（行列通道 ≥100px）
2. 正确生成直线导线，精确定义起点和终点的端子引用
3. Points 属性留空——一键优化后会生成正交拐点

🔀并联与分支的正确姿势：共享端子

多个负载需要从同一点分出多根导线时，让多根导线直接引用同一个端子即可：

• 断路器输出端 R1 需要给 2 个负载供电 → 生成 2 根导线，起点都引用 R1
• 电源零线 N 需要回接 2 个负载 → 生成 2 根导线，终点都引用 N

⚠️端子名称精确匹配的重要性

电路加载时，系统通过端子名将导线引用与控件端子一一对应：

导线 XML 中的 <TerminalName>  必须与  控件清单中的端子 Name  完全一致

如果端子名称不匹配，该导线的连接关系将无法建立；执行【导线一键优化】后，这根导线会被拓扑重构丢弃。 这是最常见、后果也最隐蔽的生成错误。

📐

COORDINATE SYSTEM坐标系与单位

03 / 14

坐标原点 (0, 0)：位于画布左上角（图纸左上角）。

单位：画布像素。图纸按 4 px = 1 mm 绘制（见“图纸布局”）；DrawingLayout 里的毫米/规格值不等于元件坐标范围。

X 轴：向右递增。

Y 轴：向下递增。

端子 Position：相对于元件左上角（WorldLocation）的偏移量，必须逐字照抄控件清单。

端子绝对位置 = WorldLocation + 旋转后Position

🧱

ROOT DATA MODEL根数据模型 (CircuitData)

04 / 14

XML 根元素为 <CircuitData>，其内部节点顺序建议如下：

<?xml version="1.0"?>
<CircuitData xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Version>2.0</Version>
  <CreatedDate>2024-01-01T00:00:00</CreatedDate>
  <ModifiedDate>2024-01-01T00:00:00</ModifiedDate>
  <Components> ... </Components>
  <Wires> ... </Wires>
  <WireSettings> ... </WireSettings>
  <DrawableElements />
  <DrawingLayout> ... </DrawingLayout>
</CircuitData>

🧩元件的可选扩展节点

元件节点（ComponentData）还支持以下可选子节点。AI 生成时一律不写这些节点，系统会自动采用控件默认值：

🔌

COMPONENT DATA元件定义 (ComponentData)

05 / 14

每个元件对应一个 <ComponentData> 节点。AI 必须从本规范控件清单获取完整的 TypeName、Size 以及端子集合定义。

📌核心属性一览

⚠️IsSVG 精确语义与严格绑定

IsSVG 决定控件外观模式：true 渲染为标准电气符号（原理图），false 为实物图片（安装图）。

• Controls.SVG.* 类型 必须 设置 IsSVG=true，并提供完整的端子拓扑定义。
• Controls.*（无 SVG 子命名空间）类型 必须 设置 IsSVG=false，端子使用系统默认值。
• 🚫 严禁混用：如 Controls.SVG.PilotLight + IsSVG=false 或 Controls.Bulb + IsSVG=true 会导致显示/布线异常。SVG 控件与图片控件不是同一个类，不能靠改 IsSVG 互换。

🔄旋转与端子位置计算（⚠️ 关键难点）

SVG 控件支持 RotationAngle = 0/90/180/270（顺时针）。AI 生成默认禁止旋转，必须使用 RotationAngle=0。 旋转后端子的绝对位置按以下方法计算；导线的 Start/End 应按旋转后的绝对位置计算（端子引用有效时，软件加载时也会按该位置校正端点）。

第一步：计算端子相对控件中心的偏移

centerX = Size.Width / 2
centerY = Size.Height / 2
dx = Position.X − centerX
dy = Position.Y − centerY

第二步：按旋转角度得到旋转后偏移

第三步：得到端子绝对位置

absoluteX = WorldLocation.X + centerX + rotatedX
absoluteY = WorldLocation.Y + centerY + rotatedY

🔢 旋转后端子的出线方向（Direction）⚠️ 源码存在朝向冲突

控件顺时针旋转后，端子的物理朝向随之改变。但当前源码对 XML Direction 的预期并不一致：

• 端子短线绘制 DrawTerminalsAbsolute() 会把 t.Direction 再执行一次 RotateDirection(t.Direction, RotationAngle)；
• 一键优化 WireRouter.CalculateEscapePoint() 直接使用 terminal.Direction，不会再旋转。

因此同一份 XML 的 Direction 无法同时满足两者：

AI 强制规则：默认禁止旋转，RotationAngle 必须为 0。 若确因横向放置需求（如横置 PLC/变频器）必须旋转，采用优化器优先约定：

1. XML 写“旋转后的最终出线方向”，保证一键优化正确；
2. 端子短线可能显示异常，必须在交付说明中标注，并请用户在软件中人工复核；
3. 不要把“人工复核”理解为可以自动同时修正两者——这是当前源码的已知缺陷。

从原始方向计算最终方向的映射如下：

🔘

TERMINAL DATA端子定义 (TerminalData)

06 / 14

端子位置 Position 为相对于元件左上角的坐标（直接照抄控件清单）。端子的绝对位置计算公式：

绝对位置 = WorldLocation + 旋转后Position

例如：元件位于 (200, 120) 未旋转，端子相对位置 (92, 5)，则绝对位置 = (292, 125)

<TerminalData>
  <Name>L</Name>
  <Position><X>92</X><Y>5</Y></Position>
  <Size>15</Size>
  <Color>Orange</Color>
  <IsConnected>true</IsConnected>
  <Direction>3</Direction>
  <ContactType>1</ContactType>
  <GroupId>Power</GroupId>
  <GroupType>5</GroupType>
</TerminalData>

📌TerminalData 各字段的作用与写法

📐Direction 出线方向枚举（⚠️ 决定优化器出线点位置）

Direction 表示该端子的出线朝向。用户点击【导线一键优化】后，软件会从端子绝对位置出发、沿 Direction 指向的一侧拉出线段，再进行正交布线。

• Controls.SVG.Motor 的 PE 在控件右侧，但 Direction=Left；
• Controls.SVG.SingleMotor 的 PE 在右下方，但 Direction=Left；
• Controls.SVG.SinglePhaseTransformer 的 U₁/U₂ 靠上/下，但 Direction=Right；V₁/V₂ 的 Direction=Left；
• 单端子排 A/B/C 型的朝向由型号决定，不能按位置判断。

⚡ContactType 触点类型枚举

📋GroupType 端子组类型枚举

GroupId 分组语义：同一电气联动的触点共用同一个 GroupId——

• 接触器主触点：L1/R1 共用 SW_L，L2/R2 共用 SW_M，L3/R3 共用 SW_R
• 多极断路器：每极一组，如 L1/R1 共用 SW_L1、L2/R2 共用 SW_L2；1P 断路器使用 SW
• SPDT 转换触点：COM/NC/NO 三个端子共用同一 GroupId（如 Relay）
• 线圈、电源、传感器端子：各自独立分组（如 KM_Coil、Power）

🚨端子名特殊字符：只准逐字复制，禁止“规范化”

控件源码里可能同时存在两类文本：

• 实际端子 Label：决定导线引用能否匹配，XML 必须用这一列；
• 界面/默认显示文本：只用于显示或弹窗默认值，不能拿来写 XML。

例如 Controls.SVG.Easy320Y：源码/界面中可能出现 0V 的显示文本，但实际端子 Label 是 OV（字母 O）。实测 XML 写 0V 时端子引用解析为 NULL，写 OV 才能解析成功。以实际 Label 为准，不能把 OV 改成 0V。

下表是“源码实际 Label 摘录”，不是命名建议；不得根据本表去改写其他端子名：

🎨颜色序列化规则

端子 Color 字段支持两种格式（不影响连接，可统一使用 Black 或按线色习惯填写）：

• HTML 颜色名：如 Red、Blue、Black、Orange
• #RRGGBB 格式：如 #E63946、#2563EB

🔗

WIRE DATA导线定义 (WireData)

07 / 14

🌟核心策略：直线连接 + 优化器接管

AI 只需生成包含精确起止坐标的直线导线，ESim电工制图的【导线一键优化】功能会自动将其转化为完美的正交避障路径。

<WireData>
  <Id>唯一GUID</Id>
  <Start><X>292</X><Y>125</Y></Start>  <!-- 按起始端子绝对位置计算 -->
  <End><X>468</X><Y>120</Y></End>      <!-- 按终止端子绝对位置计算 -->
  <Points />                            <!-- ✅ 留空！AI 不计算拐点 -->
  <Color>Black</Color>
  <Width>2</Width>
  <NetType>0</NetType>
  <ConnectionPoints />                  <!-- ✅ 留空！AI 不生成交点 -->
  <StartTerminal>
    <ComponentGuid>电源GUID</ComponentGuid>
    <TerminalName>L</TerminalName>
  </StartTerminal>
  <EndTerminal>
    <ComponentGuid>断路器GUID</ComponentGuid>
    <TerminalName>L1</TerminalName>
  </EndTerminal>
</WireData>

🚫禁止使用的旧策略

📌WireData 核心属性

🔴连接关系的两大命门

1. 端子引用决定电气拓扑：优化器重构布线时，完全依据 StartTerminal/EndTerminal 的元件 GUID + 端子名寻找两端。端子名写错或 GUID 不存在 → 引用落空 → 端子引用为 null → 优化后该导线被丢弃。
2. 坐标应按端子真实位置计算，但不是拓扑命门：只要 StartTerminal/EndTerminal 都能解析，Main.LoadCircuit() 会调用 UpdateAllWireEndpoints()，用控件端子的真实位置覆盖 wire.Start / wire.End。因此，坐标偏 1px 不会在打开后造成“悬空”；真正会导致打开后异常的是端子引用无效、元件 GUID 重复或控件缺失。坐标仍必须算准：不要让软件替你掩盖生成错误，也不要在引用失效时指望坐标能建立电气连接。

📊NetType 网络类型枚举

🛠️

ROUTING布线策略与优化器协同

08 / 14

🤖一键优化的行为（黑盒视角）

用户点击【导线一键优化】后，软件会：

1. 按 StartTerminal/EndTerminal 的端子引用重建连接；端子引用无效的导线会被丢弃；
2. 从每个端子出发，沿 Direction 指向拉出一段出线，再做正交避障；
3. 用新的正交路径替换旧路径，并保留线号、颜色、NetType；
4. 优化不会在打开文件时自动执行，必须由用户点击菜单/按钮。

📏出线段长度（布局预留参考）

出线段的长度由端子的 ContactType 决定。AI 布局时，应在端子出线方向预留不小于该长度的净空：

💡AI 布局预留建议

为了让优化器顺利布线，AI 布局时应预留足够的空间：

• 四周净空：控件四周至少预留 80px 无障碍区域（覆盖最大出线段长度）
• 行列通道：元件行列之间预留 ≥100px 的走线通道
• 对接方向：让源端子的出线方向指向目标端子（如电源 L 朝右 → 断路器放右侧）
• 网格对齐：只要求元件 WorldLocation 对齐 5px 网格；端子端点用真实坐标
• 大件特殊处理：PLC、变频器、伺服驱动器等宽型/高型控件上下方各预留 ≥100px；此类元件较多时建议直接选用 A3 横向图纸
• A4 放不下 SV630P：Controls.SV630P 尺寸 200×860，高于 A4 横向内框 820px；含该控件时直接用 A3 或更大图纸

📄

DRAWING LAYOUT图纸布局 (DrawingLayoutData)

09 / 14

📏画布尺寸：4 px = 1 mm（⚠️ 最容易误解）

PaperSize 的“A4/A3”是图纸物理规格；画布里的元件坐标不是毫米，而是 4 倍像素。例如 A4 横向图纸物理尺寸是 297×210 mm，但画布世界尺寸是 1188×840 px，内框可布图约 1153×820 px。

📏标准纸张物理规格（参考）

• 元件 ≤8~10 个、且无大件 → A4 横向；
• 含 PLC、变频器、伺服驱动器，或 10~25 个元件 → A3 横向；
• 含 Controls.SV630P（200×860）或 Controls.ServoSlideTable（961×613）→ A3 横向起步，必要时 A2；
• 更大规模 → A2 及以上。

💾

FILE FORMAT文件格式与兼容

10 / 14

🔧TypeName 必须使用完整命名空间

XML 中所有 TypeName 必须写出完整命名空间（如 Controls.SVG.PushButtonNO、Controls.Bulb）。加载器会对短名尝试补 Controls. 前缀，因此个别图片控件短名（如 Bulb）可能碰巧加载成功；但 SVG 短名（如 PilotLight）通常会失败。不要依赖该回退，必须使用完整命名空间。

🔧端子匹配规则

加载时，导线端子引用按端子名与元件的端子集合进行匹配：

• TerminalName 与控件清单中的端子 Name 完全一致 → 连接建立
• 不一致 → 连接无法建立，【导线一键优化】后该导线消失
• 同一控件内存在同名端子时，按名称只能命中第一个；例如 MD200Y 的两个 COM。遇到同名端子，必须按“端子名特殊字符警示”中的限制处理。

SVG 控件端子节点中的 Direction、ContactType、GroupType、GroupId 写明时将作为该端子的属性生效（值为 -1 或空则保留控件默认值）。AI 必须按控件清单明确赋值。

🔄可空属性与默认值

IsSVG、IsLabelDrawn 为可空布尔：

• XML 中明确写出时：按写值生效
• XML 中缺少该节点时：保留控件默认值

AI 生成时务必明确写出 IsSVG（true 或 false），不得省略！

• IsLabelDrawn：SVG 控件默认 false；图片控件可省略（保留默认）。统一写 false 也不会影响接线。
• ShowComponentName：不是可空属性。XML 省略一律写成 false，控件构造函数的默认值不会保留；MD200Y 等需要显示名称时必须显式写 true。
• ComponentTitle：不是可空属性。省略会被写成空标题，传感器/热保护仿真可能无法识别；必须按默认值写。
• ControlName：省略会变空，图片控件可能不显示名称；必须写。
• ControlLabel：省略会保留控件默认标签（可能是通用名），多部件联动会失效；必须显式写。
• ElectricalType：省略默认 AC；DC 控件会变错；必须写。

🔧文件编码与保存

• 编码：UTF-8（可带 BOM，推荐无 BOM）。
• 扩展名：.esimdrawing。
• 中文 ControlName、ControlLabel、U₁ 等字符必须原样保存；用 ANSI/GBK 保存会乱码，导致端子名匹配失败。
• 文件写入后建议用 XML 解析器复核一遍（标签闭合、特殊字符转义）。

🔄常见易混淆 TypeName 映射表（⚠️ 端子集合不同，不能直接互换）

🔧WireSettings 关键节点（必须完整写）

⭐

BEST PRACTICESAI 生成最佳实践流程

11 / 14

1. 初始化图纸：设定 DrawingLayout；按画布世界尺寸选纸张（A4 横向 1188×840，A3 横向 1680×1188），不要按 297×210 布局。
2. 布局规划：遵循“左电源、右负载、中开关保护”原则。行列通道 ≥100px，让端子出线方向指向连接目标。
3. 复制元件模板：从本规范控件清单获取完整 ComponentData（含全部端子定义），更新 ComponentGuid、Location、ControlName、ControlLabel；ComponentTitle 保持默认。
4. 计算端子绝对位置：对每个端子计算 绝对位置 = WorldLocation + 旋转后Position（默认不旋转，RotationAngle=0）。
5. 生成直线导线：为每对需连接的端子创建 WireData，Start=端子A绝对位置，End=端子B绝对位置，Points 留空。
6. 建立端子引用：为每根导线填写精确的 StartTerminal/EndTerminal（TerminalName 必须与控件清单中端子 Name 逐字符一致）。
7. 全局设置检查：建议写 EnableOrthogonalConstraint=true（加载时会被覆盖）、IsSVG 与 TypeName 匹配、所有 GUID 唯一且非空、WireSettings 完整。
8. 文件输出：UTF-8 保存为 .esimdrawing，执行自检清单。
9. 交付说明：告知用户打开后点击【导线一键优化】。

🏷️元件命名规范（⚠️ 同一器件必须共用编号）

• ControlLabel 使用标准电气文字符号 + 序号：断路器 QF1/QF2、接触器 KM1/KM2、中间继电器 KA1、时间继电器 KT1、热继电器 FR1、按钮 SB1/SB2、急停 SB0（或 EStop）、指示灯 HL1/HL2、电机 M1、传感器 SQ1/SQ2、PLC X、变频器 VVF1。
• 同一物理器件的各部分必须共用同一个 ControlLabel：
• 接触器：KMCoil 线圈 + ContactorY 主触点 + NOcontact/NCcontact 辅助触点，全部写 KM1；
• 中间继电器：KACoil 线圈 + NOcontact/NCcontact/NCNOrelayY 触点，全部写 KA1；
• 时间继电器：KTCoil 线圈 + TimeNO/TimeNC 触点，全部写 KT1；
• 热继电器：ThermalProtectorY 主回路 + FRncY/FRnoY 辅助触点，全部写 FR1。
• 不同物理器件必须使用不同 ControlLabel，不要让两个独立器件共用一个编号。
• ControlName 可用“中文名+部位”区分同一器件的不同部分，例如“接触器KM1线圈”“接触器KM1主触点”；但 ControlLabel 必须相同。
• ControlLabel、ControlName 均不得为空。

⚡电气类型与电压等级（⚠️ 不能只看控件 ElectricalType）

• 同一张图可以同时有 AC 主回路和 DC 控制回路；禁止的是把 AC 额定器件串入 DC 回路，或把 DC 额定器件串入 AC 回路（电源转换边界除外）。
• 判断一根导线属于 AC 还是 DC，要看两端端子的功能和所在回路，不要只看控件 ElectricalType。
• 电源转换边界：
• Controls.SVG.DCPowerSupply：L/N/PE 接 AC 输入，+V1/-V1 为 DC 输出；控件 ElectricalType=DC 描述的是输出侧。
• Controls.DCPower / Controls.DCPowerA：ElectricalType=AC（交流输入），输出 +V1/-V1 为 DC；不要因为名字带 DC 就把输入 L/N 接到 DC 电源。
• Controls.SVG.SinglePhaseTransformer：两侧均为 AC。
• Controls.ACContactorADC：DC 线圈交流接触器，ElectricalType=DC；主触点回路按实际负载电压，不要把主回路误标为 DC。
• SVG 三线传感器（SensorNCN/SensorNCP/SensorNON/SensorNOP）：端子名是 BR / BL / BK。接线语义以仿真引擎为准：BR=DC+、BL=DC−、BK=输出信号——仿真上电判定按 BR↔BL 直流路径，PNP 传感器动作导通 BR↔BK、NPN 传感器动作导通 BL↔BK。⚠️ 控件元数据 ContactType（BL=NO/NC、BK=DCPowernegative）与实际仿真行为相反，属源码历史遗留，该字段只影响优化器出线段长度（BK 固定约 75px；BL 在 SensorNCN/SensorNCP 为 NC→约 45px，在 SensorNON/SensorNOP 为 NO→约 30px），不能作为接线依据。端子名恰与厂商线色习惯一致（棕=DC+、蓝=DC−、黑=输出），但实物接线仍以传感器手册为准。
• 图片版 DC 传感器（ProximitySwitchNPNDC/PNPDC、OptoElectronicSwitchNPNDC/PNPDC、SafetyLightCurtainDC、MagneticSafetySwitchP）：+24V=DC+，0V=DC−，OUT=输出。
• NPN/PNP 与 PLC 输入类型要匹配：NPN 输出通常接漏型输入，PNP 输出通常接源型输入；具体以 PLC 手册为准。
• 接触器线圈 380V 场景（线圈接两根相线）将元件 IsVoltage380V 设为 true；220V 线圈（线圈接相线+零线）保持 false。
• 典型 DC 器件：Controls.SVG.DCPowerSupply、SensorNCN/NCP/NON/NOP、PhotoelectricSensor、LED*DC、BuzzerDC、SolenoidValve、SafetyLightCurtainDC、CylinderMagneticSwitch、ProximitySwitchNPNDC/PNPDC、OptoElectronicSwitchNPNDC/PNPDC、MagneticSafetySwitchP、SSRDC、Relay8PinDC/Relay14PinDC、TimeRelayDC、SafetyRelayDC、TriColourLightDC、Easy320、ACContactorADC（DC 线圈）。

🔍生成后自检清单

数据完整性

• ✓所有 ComponentGuid 唯一且非 Guid.Empty
• ✓所有 WireData.Id 唯一且非 Guid.Empty
• ✓所有 TypeName 是 Controls. 开头的完整命名空间
• ✓所有 ComponentTitle 与控件默认值逐字一致（尤其 SensorNCN→NPNNC、SensorNCP→PNPNC、SensorNON→NPNNO、SensorNOP→PNPNO）
• ✓所有 ControlName、ControlLabel 非空
• ✓同一物理器件的线圈/主触点/辅助触点共用 ControlLabel；不同器件不共用
• ✓所有 ElectricalType 与控件清单一致

端子与导线

• ✓所有导线的 StartTerminal.ComponentGuid / EndTerminal.ComponentGuid 在 Components 中存在
• ✓所有导线的 TerminalName 与目标元件的端子 Name 逐字符一致（特别注意 U₁/OV/0V/24V/+24V/dcOV/P+/P-）
• ✓所有导线的 Start 坐标 = StartTerminal 所指端子的绝对位置
• ✓所有导线的 End 坐标 = EndTerminal 所指端子的绝对位置
• ✓所有导线的 Points 为空（直线连接策略）
• ✓所有导线的 ConnectionPoints 为空（禁止交点策略）
• ✓并联/分支通过多根导线共享同一端子实现，未使用交点
• ✓IsSVG=true：端子 Direction/ContactType/GroupId/GroupType 按清单明确赋值
• ✓IsSVG=false：端子节点只写 Name + IsConnected，未写 Direction/ContactType
• ✓未接线端子 IsConnected=false（不要全部写 true）
• ✓未引用 SafetyRelay 的 CH11/CH12/CH21/CH22
• ✓未引用 MD200Y 输出侧的第二个 COM
• ✓未把 SVG 版端子名套到图片版控件

布局与文件

• ✓RotationAngle=0（AI 默认强制；若用户明确要求旋转，须按旋转章节写最终 Direction 并在交付说明中标注端子短线风险）
• ✓所有元件在所选纸张的世界尺寸内（A4 横向 1188×840；A3 横向 1680×1188）
• ✓含 SV630P（200×860）时未使用 A4 横向
• ✓WireSettings 完整（WireColor/WireWidth 非空）
• ✓DrawingLayout 节点完整
• ✓文件为 UTF-8 编码
• ✓交付说明已写明“打开后需点击【导线一键优化】”

🧯常见故障排查（按现象定位）

📑

COMPONENT LIBRARY完整控件类型清单

12 / 14

本节列出系统中所有可用的电气元件，数据已按当前版本控件库逐项核对。TypeName 必须使用完整命名空间。控件分为两类：

• SVG 控件（Controls.SVG.*，共 61 个）：电气原理图符号，支持旋转但 AI 默认不得旋转，端子拓扑完整定义。
• 图片控件（Controls.*，共 108 个）：实物外观，端子拓扑由系统默认管理。

一、SVG 电气符号控件（Controls.SVG.*）61 控件

1.1电源类6 个控件

1.2开关保护类11 个控件

1.3按钮与开关类9 个控件

1.4指示灯与负载类4 个控件

1.5接触器与继电器类10 个控件