# 技术协议、看板与 PLC 点位差异及补充清单

更新日期：2026-06-25

---

## 1. 分析范围

本清单用于把三类资料放在一起核对，方便后续和客户确认数据边界、功能边界和需要补充的接口资料。

| 来源 | 文件 / 页面 | 用途 |
|---|---|---|
| 技术协议 | `10-技术协议.md` | 判断合同或技术范围中承诺了哪些数字孪生、三维仿真、数据展示和接口能力 |
| PLC 点位 | `07-功能确认.md` | 判断客户当前提供的 PLC 点位是否能支撑协议和看板数据 |
| 当前看板 | `src/views/DaLuJiaTV1.vue` | 判断已经做在页面上的模块、字段和交互 |
| 已有分析 | `08-PLC数据与看板内容匹配分析.md`、`09-看板功能说明.md` | 作为前期功能拆解和数据口径参考 |

总体结论：

1. 当前看板已经覆盖了协议中“可视化监控看板”的主体框架，包括三维区域、线体任务联动、加工设备状态、辅助设备状态、库位矩阵、报警事件、报警频次、设备运行履历、孪生 / 仿真模式按钮、视角按钮。
2. 当前 PLC 点位可以支撑大部分“实时状态类”展示，例如线体状态、任务编号、起止位置、配方号、托盘类型、机器人握手信号、设备运行 / 报警 / 上下料就绪、库位有无料。
3. 技术协议里更深的“1:1 动作孪生、轴运动参数、设备负荷、三维漫游 / 聚焦、布局拖拽保存、仿真调试、工艺验证”等内容，当前看板没有完整实现，当前 PLC 点位也没有完全覆盖，需要客户补充 CNC、KUKA、三维模型和接口资料。
4. 看板中有一些统计类、事件类和历史类内容，PLC 点位只能提供当前瞬时状态，不能直接提供最终结果，必须由采集服务 / 后端数据库计算和落库。

---

## 2. 技术协议中有、当前看板未完整实现的功能

| 协议功能 | 当前看板状态 | 现有 PLC 点位是否支撑 | 需要向客户确认 / 索要 |
|---|---|---|---|
| 1:1 实景还原、完整数字孪生系统 | 目前页面预留中心 iframe 三维区域，但看板侧只负责嵌入与周边数据面板；没有看到完整三维模型导入、模型校验、设备动作驱动逻辑 | PLC 点位只解决部分状态信号，不解决三维模型本身 | 全部设备、线体、工装、夹头库、库位、机器人、清洗机、测量仪、打标机的最终三维模型；现场坐标 / 布局图；模型命名规则；设备 ID 与 PLC 点位映射 |
| 三维模型确认与导入，支持 STEP / IGS / STL | 当前看板未体现模型导入工具，只读取 `window.dt_Config.iframeAddress` | 与 PLC 无关 | 客户是否只要求交付处理后的模型，还是要求页面具备模型导入功能；需要客户提供源模型文件和最终确认版本 |
| 模型轻量化、简化等级自定义切换 | 当前看板未做模型轻量化等级切换 | 与 PLC 无关 | 是否需要在系统里做“高精度 / 展示 / 调试”模型精度切换；各档模型数量、格式、验收标准 |
| 虚拟场景设备拖拽、移动、旋转、间距调整、布局保存 | 当前看板未做布局编辑功能 | 与 PLC 无关 | 是否属于本次交付必做项；如果要做，需要保存格式、权限、布局方案数量、是否允许现场人员编辑 |
| 机床开关门动作、各轴精确运动、行程 / 速度 / 轨迹一致 | 当前看板加工设备状态只显示产量、联动信号、综合状态；未显示轴运动、门状态、速度轨迹 | PLC 提供了部分机床 `DOOR_OPEN`、`DOOR_CLOSE`、`BUSY`、`ALARM`、`NORMAL`、上下料就绪 / 完成，但没有轴坐标、轴速度、主轴转速、负荷、进给、刀具等连续参数 | 每台 CNC 的轴位置、轴速度、主轴转速、主轴负载、进给倍率、门状态、卡盘 / 夹紧状态、程序运行状态；确认这些从 PLC 取还是从 CNC 系统接口取 |
| KUKA 机器人全轨迹、抓取、搬运、上下料、对接工位动作复刻 | 当前看板显示三个单元的任务编号、起止位置、配方、托盘、握手状态；未显示机器人关节 / TCP 位置和真实轨迹 | PLC 提供 `TASK_NO`、`START_POS`、`END_POS`、`FLAG`、`READY`、`BUSY`、`ERROR`、`COMPLETE`，能支撑任务阶段，不足以支撑真实轨迹 | KUKA 关节角、TCP 位姿、程序名 / 程序段、夹爪开合、抓件有无、到位点、报警码；KUKA 与系统对接方式、刷新周期、权限 |
| 机器人附件：夹爪拆卸、更换、校准动作全流程仿真 | 当前看板未显示夹爪 / 夹头更换流程 | PLC 中有部分“夹头数据”和“夹头库”点位，例如夹头编号、目标夹头、更换完成、夹头位有件 / 错误；但这些更像机床夹头 / 夹头库，不等同于 KUKA 夹爪拆装校准全流程 | 需要客户确认“夹头数据”是否就是协议中的机器人附件数据；如果不是，需要补充机器人夹爪编号、夹爪锁紧 / 解锁、换爪到位、校准完成、夹爪异常等点位 |
| 动作实时同步、单步调试、循环演示 | 当前看板只有孪生 / 仿真模式按钮，未见单步、暂停、循环演示、动作调试控制 | PLC 当前点位多为状态 / 任务 / 反馈，未提供仿真控制命令和离线演示数据 | 是否必须做单步调试和循环演示；若需要，客户需提供动作脚本、仿真流程、控制权限、写入 PLC 的边界，或确认仅在离线仿真系统内部实现 |
| 虚拟场景仿真调试、工艺验证、布局优化 | 当前看板未做仿真排程、节拍推演、工艺验证结果、布局优化工具 | PLC 点位不能直接支撑，属于仿真模型和业务规则 | 工艺路线、节拍参数、设备动作时长、缓存容量、物流规则、AGV / 机器人调度规则、布局约束、仿真验收指标 |
| 三维场景漫游、视角切换、设备聚焦查看 | 当前看板有长地轨 / 短地轨 / 关节视角按钮，但 `changeView` 目前只改前端选中状态，未看到向 iframe 发送视角切换命令 | 与 PLC 无关 | 三维页面是否提供 `postMessage`、URL 参数或 JS API；需要视角 ID、设备 ID、聚焦相机点位、漫游控制方式 |
| 核心数据展示：设备启停状态 | 当前加工 / 辅助设备状态已做综合状态展示 | 基本支撑。机床有 `BUSY`、`ALARM`、`NORMAL`、`EMG`，清洗机 / 测量仪有 `NORMAL`、`AUTO`、`READY`、`BUSY`、`ERROR`，打标机有 `NORMAL`、`START`、`BUSY`、`IDLE`，但长地轨打标机部分地址为空 | 补齐长地轨打标机 `NORMAL`、`BUSY` 地址；确认 `NORMAL=0` 是关机、离线还是通讯异常 |
| 核心数据展示：轴运动参数 | 当前看板未显示 | 当前 PLC 点位没有轴坐标 / 速度 / 轨迹连续数据 | 每台机床和机器人轴参数清单，含点位地址、单位、量程、刷新周期 |
| 核心数据展示：生产节拍 | 当前看板未做独立节拍模块 | PLC 没有直接节拍字段，可通过任务开始 / 完成、加工完成、上下料完成事件计算 | 需要客户确认节拍定义：按设备加工周期、机器人搬运周期、整线节拍还是订单节拍；确认用哪个完成信号计时 |
| 核心数据展示：产量数据 | 当前加工设备状态显示“产量” | PLC 没有直接产量计数器；可用 `COMPLETE`、`UNLOAD_COMPLETE`、机器人 `COMPLETE` 上升沿计算，但需要规则 | 客户提供设备产量计数器，或确认用哪个信号作为计数依据；确认班次、清零、补录、重复计数处理规则 |
| 核心数据展示：设备运行负荷 | 当前看板未显示负荷 | 当前 PLC 点位没有负荷数据 | 主轴负载、轴负载、机器人负载 / 电流、设备负荷百分比等数据接口 |
| 核心数据展示：异常报警信息 | 当前看板有报警事件列表和报警频次柱状图 | PLC 有 `ALARM`、`ERROR`、`EMG` 等布尔量，可以判断有无异常，但没有报警码、报警文本、等级、开始 / 恢复时间 | 报警码、报警文本、报警等级、报警来源、发生时间、恢复时间；若客户无法提供，需确认是否接受由采集服务按点位名称生成简化报警事件 |
| 核心数据展示：工序完成进度 | 当前看板未做工序进度条或工序百分比 | PLC 有部分任务阶段、程序启动、加工完成、上下料就绪 / 完成，但没有完整工序步骤进度 | 工序步骤定义、每步开始 / 完成信号、当前工序号、进度百分比或可计算规则 |
| 异常弹窗预警 | 当前看板有报警模块，但未见实时弹窗机制 | PLC 可触发报警布尔量；弹窗内容仍缺报警码 / 文本 / 等级 | 弹窗规则：哪些报警弹窗、弹窗优先级、是否自动关闭、是否需要确认、是否需要声音 / 大屏闪烁 |
| 与 Siemens、KUKA、CNC 控制系统数据对接 | 当前看板还没有真实接口层，只是前端 mock 数据 | 07 文档主要是 PLC 点位，未体现 KUKA 和各 CNC 的直接接口协议细节 | PLC 访问方式、IP、DB 权限、读写边界；KUKA 接口方式；Fanuc / Mazak / Sinumerik / Studer 等 CNC 接口方式；是否需要采购 / 开通授权 |
| 数据实时性：状态 / 动作 / 参数延迟不大于 200ms | 当前前端没有实测证据 | PLC 点位能否达到取决于采集链路、协议、服务端和三维渲染链路 | 客户确认必须 200ms 的数据范围；提供网络环境、PLC 通讯周期、CNC / KUKA 接口刷新周期；后续需要联调测试记录 |
| 数据采集频率小于 2s | 当前前端说明按 1-2s 刷新，但还未接真实采集服务 | PLC 点位本身具备读取基础，采集频率需由接口链路验证 | 采集周期要求、点位总量、并发读取方式、历史落库粒度 |

---

## 3. 技术协议设备清单与当前看板 / PLC 点位差异

| 协议设备 | 当前看板是否展示 | PLC 点位是否提供 | 差异 / 处理建议 |
|---|---:|---:|---|
| WIA / L2100SY | 已展示 | 已提供 | 看板显示产量、联动信号、状态；协议要求的轴参数、负荷、真实动作轨迹未提供 |
| Studer / S33 磨床 | 未展示 | 未在 07 点位中明确看到 | 协议有该设备，但当前看板和 PLC 点位没有对应项；需要客户确认是否纳入本次看板和采集范围 |
| Mazak / QSM250L / 1000 | 已展示为 MAZAK | 已提供部分 | MAZAK 的目标 / 实际程序号标注为“不需要”，`COMPLETE` 标注“无此信号”；若要产量和程序一致性，需要另定规则 |
| WIA / F500 | 已展示 | 已提供 | 可支撑状态、上下料、门、报警、通讯正常；轴参数和负荷未提供 |
| WIA / L2000LSY | 已展示 | 已提供 | 可支撑状态、上下料、门、报警、通讯正常；轴参数和负荷未提供 |
| YKD5132H-1270 | 已展示 | 部分地址为空 | `D_PROG_NO`、`A_PROG_NO`、`PROG_SELECT`、`PROG_SELECT_READY`、`COMPLETE` 地址为空，需客户补齐或确认不用 |
| 新日 / 2MK8012 | 已展示为“新日” | 已提供部分 | `COMPLETE` 标注“无此信号”，产量需另行计算 |
| 业纳 / CS608 Pro 测量设备 | 已展示为“测量仪” | 已提供 | 可支撑运行、错误、上下料就绪；测量结果、OK / NG、测量值、报告号未提供 |
| KUKA / KR210R2700 机器人系统 | 当前看板按长地轨、短地轨、关节三个任务单元展示 | PLC 提供三组任务 / 握手信号 | 协议写 1 套 KUKA，当前看板按 3 个单元展示；需要客户确认实际机器人数量、单元划分和点位归属 |
| 超声波清洗设备 | 已展示为“清洗机” | 已提供 | 可支撑运行、错误、上下料就绪；清洗工艺参数、槽温、液位、清洗时长未提供 |
| Siemens 1511-1 PN PLC | 未作为设备展示 | PLC 点位来源之一 | 如需显示 PLC 通讯状态，需要提供采集服务状态或 PLC 心跳 / 通讯质量 |
| Siemens 1214C PLC x2 | 未作为设备展示 | PLC 点位来源之一 | 同上，需要确认是否在看板显示 PLC 控制系统在线状态 |
| 三台打标机 | 已展示：长地轨、短地轨、关节打标机 | 短地轨、关节点位较完整；长地轨部分地址为空 | 技术协议设备清单未单独列打标机，但看板和 PLC 点位中有；建议确认是否属于配套设备范围 |

---

## 4. 看板中已有、但 PLC 点位未直接提供或支撑不足的内容

| 看板内容 | 页面位置 | PLC 支撑情况 | 需要补充 / 确认 |
|---|---|---|---|
| 孪生模式 / 仿真模式按钮 | 顶部左侧 | PLC 不提供，也不一定需要 PLC；属于前端与三维系统 / 仿真系统交互 | 需要三维系统提供模式切换接口；确认孪生模式读实时 PLC，仿真模式读离线仿真还是脚本数据 |
| 长地轨 / 短地轨 / 关节视角按钮 | 顶部右侧 | PLC 不提供，也不需要 PLC | 需要三维 iframe 提供视角切换 API、视角 ID、设备聚焦点 |
| 中心三维 iframe | 中央区域 | PLC 只能提供驱动数据，不提供三维场景 | 需要客户或三维侧提供可访问地址、模型资源、数据驱动接口和跨页面通信协议 |
| 加工设备“产量” | 加工设备状态 | PLC 没有直接产量计数器 | 提供每台设备产量计数器，或确认由采集服务按 `COMPLETE` / `UNLOAD_COMPLETE` / 机器人 `COMPLETE` 上升沿计算 |
| 报警事件的时间、设备、事件内容 | 报警与异常事件 | PLC 只有当前报警 / 错误布尔量，不提供事件文本和时间 | 需要后端事件表；或由采集服务在点位 0->1 时生成报警事件，并维护恢复时间 |
| 报警频次 Top5 | 报警与异常事件柱状图 | PLC 不直接提供统计结果 | 需要后端按报警事件表统计，可按当班 / 当日 / 最近 24 小时配置 |
| 设备运行履历 24 小时甘特图 | 设备运行履历 | PLC 只提供当前状态，不提供历史 | 需要采集服务按分钟或状态变化落库，生成 `关机 / 运行 / 待机 / 报警` 状态区间 |
| 设备“关机”状态 | 设备运行履历 | 部分设备有 `NORMAL`，但“关机 / 离线 / 通讯异常”含义未完全明确 | 需要客户确认 `NORMAL=0` 的含义；最好提供设备电源、在线、心跳或通讯质量信号 |
| 程序不一致类报警 | 报警 mock 数据中出现过 | 07 点位中 F500 / L2000LSY / L2100SY / 新日有 `D_PROG_NO` 和 `A_PROG_NO`，MAZAK 标注“不需要”，YKD5132H 程序号地址为空；当前看板未专门展示程序一致性 | 需要客户确认各设备目标程序、实际程序、配方号映射关系和是否需要报警 |
| 清洗机下料等待超时 | 报警 mock 数据中出现过 | PLC 有 `UNLOAD_READY`，但没有等待开始时间和超时阈值 | 需要后端按信号持续时间计算；客户确认阈值和报警规则 |
| 关节机器人自动模式待恢复人工确认 | 报警 mock 数据中出现过 | 有 `AUTO_ACTIVE`、`ALLOW_TASK`、`ERROR` 等状态，但没有“人工确认”专用点位 | 需要确认这是通过自动模式缺失推断，还是有专门确认 / 复位信号 |
| 任务流向文字名称 | 线体任务联动状态 | PLC 提供 `START_POS`、`END_POS` 数字 | 需要工位编号字典，把 01、02、06 等数字映射成现场工位名称 |
| 托盘类型文字 | 线体任务联动状态 | PLC 提供 `PALLET_TYPE` 数字 | 需要托盘类型字典，例如空托盘、长轴托盘、短轴托盘等 |
| 零件类型 | 线体任务联动状态 | 短地轨、关节有 `PART_KIND`；长地轨未看到 `PART_KIND` | 需要确认长地轨是否固定为长轴，或补充 `PART_KIND` 点位 |
| 物料库位占用率 / 有料数量 | 物料库位矩阵 | 可以由 `S*_YES` 计算，但长地轨和短地轨库位地址看起来重复 | 需要确认长地轨和短地轨是否确实共用地址，还是 Excel 转换丢失上下文；需要库位编号与现场位置映射 |
| 测量仪报警事件与结果 | 辅助设备状态 / 报警 | PLC 有 `ERROR`、`BUSY`、上下料就绪，但没有测量结果 | 如果看板要展示质量或测量结论，需要测量值、OK / NG、报告号、工件号 |
| 设备负荷、轴参数、节拍、工序进度 | 技术协议要求，但当前看板暂未做完整模块 | 当前 PLC 点位不足 | 需要额外接口和业务规则，见第 6 节索要清单 |

---

## 5. PLC 点位中已有、但当前看板尚未充分利用的内容

这部分不是“必须马上做”，但它们已经在客户点位里出现，后续如果要让看板更贴近技术协议，可以优先考虑。

| PLC 点位内容 | 当前看板状态 | 可扩展功能建议 |
|---|---|---|
| 预调台请求 / 反馈、托盘编号、相机 OK / NG、气压正常 | 当前看板未展示 | 可增加“预调台 / 上料准备状态”小模块，显示托盘到位、相机结果、气压异常 |
| AGV 接驳请求、允许、到位、完成、接驳站有托盘 / 错误 | 当前看板未展示 | 可在线体任务联动里增加“AGV 接驳阶段”或异常提示，用于判断任务卡在哪个环节 |
| 分拣台有托盘、允许放 / 取、错误 | 当前看板只显示物料库位矩阵，未显示分拣台 | 可扩展为“分拣台 / 缓存位状态”，辅助判断上下游堵塞 |
| 机床 `D_PROG_NO`、`A_PROG_NO`、程序选择、程序启动、自动联线、首件、排空 | 当前看板只显示状态和产量 | 可增加程序一致性、首件 / 排空状态、自动联线状态，但需要确认是否适合大屏常驻 |
| 机床门开 / 门关、急停、通讯正常 | 当前加工设备状态未单独显示 | 可用于更准确地判断关机、待机、报警和运行条件；也可驱动三维机床门动作 |
| 夹头编号、目标夹头、夹头更换完成 | 当前看板未展示 | 可做“夹头 / 工装状态”或用于三维换夹头动作孪生 |
| 夹头库 1-64 位有件 / 错误 | 当前看板未展示 | 可增加夹头库矩阵，和物料库位矩阵类似；也可用于工装缺料 / 错位报警 |
| 清洗机 `NORMAL`、`AUTO`、`READY` | 当前辅助设备状态只展示部分标签 | 可提升清洗机综合状态判定准确性 |
| 测量仪 `NORMAL`、`AUTO`、`READY` | 当前辅助设备状态只展示部分标签 | 可提升测量仪综合状态判定准确性 |

---

## 6. 建议向客户索要的数据与资料清单

### 6.1 三维模型与场景资料

| 需要资料 | 用途 | 优先级 |
|---|---|---|
| 12 项协议设备及实际配套设备的最终三维模型源文件 | 完成 1:1 数字孪生和模型轻量化 | 高 |
| 现场总布局图、设备坐标、机器人基坐标、库位坐标、工位坐标 | 保证三维场景与现场一致 | 高 |
| 设备、工位、库位、机器人、夹头库的统一编码表 | 建立 PLC 点位、三维对象、看板名称之间的映射 | 高 |
| 视角切换和设备聚焦的相机点位清单 | 让长地轨 / 短地轨 / 关节视角按钮真正控制三维画面 | 高 |
| 三维 iframe 通信协议 | 让看板按钮能调用三维模式切换、视角切换、设备聚焦 | 高 |
| 模型轻量化验收标准 | 明确哪些细节必须保留，避免后期反复返工 | 中 |

### 6.2 PLC / CNC / KUKA 接口数据

| 需要补充 | 当前缺口 | 用途 |
|---|---|---|
| 每台设备产量计数器，或确认产量计算信号 | 当前没有直接产量点位 | 支撑加工设备产量、班次统计、日报 |
| 报警码、报警文本、报警等级、报警恢复时间 | 当前只有 `ALARM` / `ERROR` / `EMG` 布尔量 | 支撑报警事件、报警 Top5、弹窗预警、报表 |
| 设备在线 / 开机 / 心跳 / 通讯质量 | 当前部分设备只有 `NORMAL`，含义需确认 | 区分关机、离线、待机、通讯异常 |
| CNC 轴位置、轴速度、主轴转速、主轴负载、进给倍率 | 当前 PLC 没有连续运动参数 | 支撑协议里的轴运动参数和设备负荷 |
| KUKA 关节角、TCP 位姿、程序状态、夹爪状态、抓件有无 | 当前只有任务号和握手信号 | 支撑机器人真实轨迹和抓取搬运动作孪生 |
| 工序步骤、当前工序、工序开始 / 完成信号 | 当前只能看到任务和部分完成信号 | 支撑工序完成进度 |
| 长地轨打标机 `NORMAL`、`BUSY` 地址 | 07 点位中地址为空 | 支撑长地轨打标机状态 |
| YKD5132H 程序号、程序选择就绪、加工完成地址 | 07 点位中部分地址为空 | 支撑 YKD5132H 程序、产量、状态判断 |
| MAZAK 产量 / 完成信号替代规则 | `COMPLETE` 标注无此信号 | 支撑 MAZAK 产量 |
| Studer / S33 点位 | 技术协议有，07 点位和看板未体现 | 确认是否纳入本项目 |
| 清洗机工艺参数：槽温、液位、清洗时间、清洗完成 | 当前只有基础状态 | 若协议要求工艺参数展示，需要补充 |
| 测量仪测量结果：OK / NG、测量值、报告号、工件号 | 当前只有基础状态 | 若后续要展示质量数据，需要补充 |
| `START_POS` / `END_POS` 工位字典 | 当前只有数字 | 让任务流向一眼能看懂 |
| `PALLET_TYPE` 托盘类型字典 | 当前只有数字 | 让托盘类型变成可读文字 |
| `PART_KIND` 零件类型字典，以及长地轨来源 | 长地轨未看到 `PART_KIND` | 支撑长轴 / 短轴判断 |
| 长地轨 / 短地轨物料库地址重复确认 | 两个库区看起来都用 `DB50.DBX101.0` 至 `DB50.DBX109.0` | 防止库位矩阵接错数据 |
| 夹头库短地轨地址补齐 | 07 点位中短地轨夹头库大量地址为空 | 若做夹头库矩阵必须补齐 |

### 6.3 业务规则与验收口径

| 需要确认 | 原因 |
|---|---|
| 看板是否只读 PLC | 07 点位很多标注 `RW`，但大屏建议只读，避免误写现场设备 |
| 产量统计口径 | 不同信号计数会导致产量差异，需要客户确认 |
| 报警等级划分 | 当前 PLC 布尔量不带等级，需要客户给规则或接受系统默认规则 |
| 设备状态优先级 | 建议为 `报警 > 运行 > 待机 > 关机 / 离线`，需客户确认 |
| 设备运行履历落库粒度 | 建议状态变化即落库，另可每分钟补采样 |
| 生产节拍定义 | 协议要求节拍，但需明确按设备、机器人、整线还是任务计算 |
| 仿真模式数据来源 | 需要确认来自离线脚本、仿真软件、数据库历史回放，还是三维系统内部演示 |
| 异常弹窗规则 | 需要明确哪些报警弹窗、是否需要确认、是否自动恢复 |
| 200ms 实时性适用范围 | 三维动作同步、PLC 状态展示、历史统计不应混用同一实时性标准 |

---

## 7. 建议补做功能优先级

### P0：正式联调前必须确认

| 编号 | 事项 | 目的 |
|---|---|---|
| P0-01 | 补齐设备 / 工位 / 库位 / 托盘 / 零件类型字典 | 保证看板文字可读，不只是数字点位 |
| P0-02 | 确认产量计算规则或补充产量点位 | 保证加工设备“产量”不是 mock |
| P0-03 | 建立报警事件生成规则 | 保证报警列表和报警 Top5 可以从实时信号生成 |
| P0-04 | 建立设备状态判定规则 | 保证运行、待机、报警、关机含义统一 |
| P0-05 | 确认三维 iframe 通信方式 | 保证模式按钮和视角按钮真正生效 |
| P0-06 | 补齐长地轨打标机、YKD5132H、库位重复等点位疑问 | 防止关键设备状态接错或缺失 |

### P1：为满足技术协议应补做

| 编号 | 事项 | 目的 |
|---|---|---|
| P1-01 | 三维视角切换、设备聚焦、孪生 / 仿真模式联动 | 对齐协议中的三维漫游和视角切换 |
| P1-02 | 设备运行履历真实落库 | 对齐看板中的 24 小时履历，替换 mock 数据 |
| P1-03 | 异常弹窗预警 | 对齐协议中的异常实时弹窗 |
| P1-04 | 程序一致性 / 自动联线 / 门状态等机床细节展示 | 利用现有机床 PLC 点位，提高现场可用性 |
| P1-05 | 预调台、AGV 接驳、分拣台状态补充展示 | 利用现有点位，增强任务卡点分析能力 |
| P1-06 | 夹头 / 夹头库状态展示 | 对应协议中的附件 / 工装动作和工艺验证能力 |

### P2：需要额外接口后再做

| 编号 | 事项 | 前置条件 |
|---|---|---|
| P2-01 | CNC 轴运动参数、主轴 / 轴负荷展示 | 客户提供 CNC 接口或 PLC 转发点位 |
| P2-02 | KUKA 真实轨迹和 TCP / 关节数据驱动三维 | 客户提供 KUKA 接口 |
| P2-03 | 工序进度、节拍分析、负荷分析 | 客户确认工艺步骤和节拍口径 |
| P2-04 | 布局拖拽、方案保存、仿真验证 | 客户确认是否纳入本次交付及验收方式 |
| P2-05 | 测量结果和质量数据展示 | 客户提供测量仪结果接口 |
| P2-06 | 清洗工艺参数展示 | 客户提供清洗机温度、液位、时长、完成等数据 |

---

## 8. 可直接发给客户的补充问题清单

1. 技术协议中的 Studer / S33 磨床是否纳入本次看板和数据采集？如果纳入，请提供对应 PLC / CNC 点位。
2. 协议写 1 套 KUKA 机器人系统，但 PLC 点位和看板按长地轨、短地轨、关节三个单元展示。请确认实际机器人数量、单元划分和点位归属。
3. 请提供每台加工设备的产量计数器；如果没有，请确认用哪个完成信号作为产量计数依据。
4. 请提供报警码、报警文本、报警等级和报警恢复时间；如果设备侧无法提供，请确认是否接受由系统按布尔点位生成简化报警。
5. 请提供设备开机 / 在线 / 心跳 / 通讯质量点位，或确认 `NORMAL=0` 是否可以作为关机 / 离线判断。
6. 请提供 CNC 轴位置、轴速度、主轴转速、负荷等数据接口；如果无法提供，请确认协议中的“轴运动参数、设备负荷”是否改为不展示。
7. 请提供 KUKA 机器人关节角、TCP 位姿、夹爪状态、抓件有无、程序状态、报警码等接口；如果无法提供，请确认三维机器人动作是否只按任务阶段模拟。
8. 请确认夹头数据是否等同于协议中的“机器人附件 / 夹爪拆装更换校准”数据；若不是，请补充夹爪更换和校准点位。
9. 请补齐长地轨打标机 `NORMAL`、`BUSY` 地址。
10. 请补齐 YKD5132H 目标程序号、实际程序号、程序选择、程序选择就绪、加工完成等空地址，或确认这些字段不采集。
11. 请确认 MAZAK 是否确实没有加工完成信号；如没有，请提供产量 / 完成判定替代规则。
12. 请确认长地轨和短地轨物料库位是否共用 `DB50.DBX101.0` 至 `DB50.DBX109.0` 地址；如果不是，请提供正确地址。
13. 请提供 `START_POS`、`END_POS` 的工位编号字典。
14. 请提供 `PALLET_TYPE` 托盘类型字典。
15. 请确认长地轨是否需要显示零件类型；如果需要，请提供 `PART_KIND` 或其他来源。
16. 请提供三维系统 iframe 的控制接口，包括模式切换、视角切换、设备聚焦、设备状态驱动、报警定位等。
17. 请确认孪生模式和仿真模式的数据来源分别是什么，以及是否允许看板向 PLC 写入控制信号。
18. 请确认 200ms 实时性要求适用于哪些数据：三维动作、PLC 状态、报警、统计、历史履历是否分别验收。
19. 请提供设备运行履历的历史数据要求：保存周期、保存粒度、查询范围、班次划分。
20. 请确认异常弹窗预警规则：哪些报警弹窗、优先级、是否需要人工确认、恢复后是否自动关闭。

---

## 9. 当前结论

当前看板的“监控大屏展示层”已经比较完整，适合进入数据联调准备阶段；但如果严格按技术协议验收，仍然存在明显缺口，主要集中在三维动作孪生、CNC / KUKA 深层接口、轴运动参数、设备负荷、仿真调试、布局编辑、报警事件化、历史落库和产量统计规则。

建议下一步先把 P0 问题和客户确认清楚，尤其是产量、报警、设备在线、三维 iframe 控制接口、设备字典、空地址和重复地址。P0 确认后，当前看板可以较快接入真实数据；P1 / P2 则建议作为技术协议履约范围和二次开发计划单独确认，避免后期因为“PLC 点位没有提供”导致页面功能无法落地。
