feat: add iframe camera postMessage for view switching (长地轨/短地轨/关节)

src/router/index.js

@@ -1,13 +1,13 @@
 import Vue from 'vue'
 import Router from 'vue-router'
-import DaLuJiaTV1 from '@/views/DaLuJiaTV1.vue'
+import qingAn from '@/views/qingAn.vue'
 
 Vue.use(Router)
 export const constantRouterMap = [
   {
     path: '/',
-    name: 'DaLuJiaTV1',
+    name: 'qingAn',
-    component: DaLuJiaTV1,
+    component: qingAn,
     meta: {
       keepAlive: true
     }

src/views/qingAn.vue

@@ -38,7 +38,7 @@
     <div class="rightLine"></div>
 
     <div class="main-content">
-      <iframe v-if="iframeAddress" allowtransparency="true" class="model-bg-frame" :src="iframeAddress" title="三维模型"></iframe>
+      <iframe id="dmtIframe" v-if="iframeAddress" allowtransparency="true" class="model-bg-frame" :src="iframeAddress" title="三维模型"></iframe>
       <div v-else class="model-placeholder">等待配置三维模型地址</div>
 
       <div class="left-box">
@@ -248,7 +248,7 @@ import * as echarts from 'echarts'
 import scroll from 'vue-seamless-scroll'
 
 export default {
-  name: 'DaLuJiaTV1',
+  name: 'QingAn',
   components: { scroll },
   data() {
     return {
@@ -270,6 +270,23 @@ export default {
         { label: '短地轨视角', value: 'shortRail' },
         { label: '关节视角', value: 'joint' }
       ],
+      cameraViews: {
+        longRail: {
+          target: { x: -5.725619423653396, y: 1.559219531820475, z: -5.23360272959924 },
+          position: { x: -15.805974184853365, y: 1.6199255013441012, z: 10.689003987116454 },
+          zoom0: 1
+        },
+        shortRail: {
+          target: { x: -5.814177085428968, y: 16.255194514605996, z: -5.3456965650308055 },
+          position: { x: -15.390514108568938, y: 16.312865185653482, z: 9.780779815848938 },
+          zoom0: 1
+        },
+        joint: {
+          target: { x: 2.7622940494890424, y: 15.83905572715569, z: 0.08552052688719107 },
+          position: { x: -3.2731867066688367, y: 15.875402633541817, z: 9.618973337149745 },
+          zoom0: 1
+        }
+      },
       lineMonitorRows: [
         {
           name: '长地轨',
@@ -518,6 +535,18 @@ export default {
     },
     changeView(value) {
       this.activeView = value
+      const camera = this.cameraViews[value]
+      if (!camera) return
+      const iframe = document.getElementById('dmtIframe')
+      if (!iframe || !iframe.contentWindow) return
+      iframe.contentWindow.postMessage({
+        type: 'set_camera',
+        data: {
+          target: camera.target,
+          position: camera.position,
+          zoom0: camera.zoom0
+        }
+      }, '*')
     },
     initAlarmPieChart() {
       if (!this.$refs.alarmPieChart) {

work/working1/11-PLC数据与看板差距分析.md

@@ -1,257 +0,0 @@
-# PLC 数据与看板差距分析
-
-更新日期：2026-06-25
-
-数据来源：`07-功能确认.md`（客户提供的 PLC 点位清单）
-对照对象：`09-看板功能说明.md`、`10-技术协议.md`、`DaLuJiaTV1.vue`
-
----
-
-## 一、客户已提供、但看板未使用的数据
-
-### 1. 预调台数据（3 个单元，共 51 个 PLC 点位）—— 完全未用
-
-客户提供了长地轨、短地轨、关节三个单元的预调台信号，包含请求/反馈/相机/气压等完整握手流程，看板完全没有展示。
-
-| 信号类型 | 包含内容 | 建议用途 |
-|---|---|---|
-| 预调台请求 | 请求原位、请求终位、托盘编号 | 可独立增加"预调台状态"模块，或并入物料库位区域 |
-| 预调台反馈 | 原位到位、终位到位、有托盘、允许放/取 | 同上，展示预调台就绪状态 |
-| 相机检测 | PHOTO_OK / PHOTO_NG | 可在报警事件中增加相机 NG 事件 |
-| 气压检测 | AIR_PRESSURE 正常/异常 | 可在辅助设备中增加气压状态指示 |
-
-> **建议**：优先级 P2，可在底部物料区域旁增加预调台状态矩阵。
-
----
-
-### 2. AGV 数据（3 个单元，共 69 个 PLC 点位）—— 完全未用
-
-客户提供了完整的上料/取料 AGV 进出流程信号（请求进入→允许进入→接驳到位→接驳完成→请求离开→允许离开→离开到位→离开完成），每单元 23 个点位，看板完全没有展示。
-
-| 信号类型 | 包含内容 | 建议用途 |
-|---|---|---|
-| 上料 AGV 流程 | 请求进入/允许/到位/完成/离开 | 可新增"AGV 状态"模块，展示 AGV 位置和流程阶段 |
-| 取料 AGV 流程 | 请求进入/允许/到位/完成/离开 | 同上 |
-| 接驳站状态 | 有托盘/无托盘/错误 | 类似库位矩阵，展示接驳站占用状态 |
-
-> **建议**：优先级 P2，AGV 物流是产线重要环节，建议至少展示接驳站状态和 AGV 当前所处阶段。
-
----
-
-### 3. 分拣台数据（3 个单元，共 21 个 PLC 点位）—— 完全未用
-
-长地轨 3 个分拣台 + 短地轨 2 个 + 关节 2 个，每个有"有托盘/无托盘/错误"三个信号。
-
-> **建议**：优先级 P2，可融入物料库位矩阵，作为额外库区展示。
-
----
-
-### 4. 机床详细数据 —— 大部分未用
-
-客户为每台加工设备提供了远多于看板当前使用的信号：
-
-| 信号 | 客户是否提供 | 看板是否使用 | 差距 |
-|---|---|---|---|
-| D_PROG_NO（目标程序号） | ✅ 全部提供 | ❌ 未使用 | **可用于程序一致性校验**，黄色预警 |
-| A_PROG_NO（实际程序号） | ✅ 全部提供 | △ 仅短地轨/关节设备用 | 长地轨设备（F500/L2000LSY/L2100SY）的 A_PROG_NO 客户提供了但看板未展示 |
-| PROG_SELECT / PROG_CYC_START | ✅ 提供 | ❌ 未使用 | 脉冲信号，适合事件记录 |
-| AUTO_ONLINE（自动联线） | ✅ 提供 | ❌ 未使用 | 可用于判断设备是否在联线模式 |
-| FIRST（首件）/ LAST（排空） | ✅ 提供 | ❌ 未使用 | 生产管理重要节点 |
-| COMPLETE（加工完成） | ✅ 提供 | ❌ 未使用 | **可用于产量计数** |
-| DOOR_OPEN / DOOR_CLOSE | ✅ 提供 | ❌ 未使用 | 门状态，安全相关 |
-| EMG（设备级急停） | ✅ 提供 | ❌ 未使用 | 可在报警事件中区分线体急停和设备急停 |
-| NORMAL（通讯正常） | ✅ 提供 | ❌ 未使用 | 判断设备是否在线/通讯是否正常 |
-| UPLOAD_READY / UNLOAD_READY（长地轨设备） | ✅ 提供 | ❌ 未使用 | 长地轨设备客户提供了这两个信号，看板只用了 COMPLETE |
-
-> **建议**：
-> - **P0**：D_PROG_NO 与 A_PROG_NO 做程序一致性校验，黄色预警
-> - **P1**：COMPLETE 信号用于产量计数
-> - **P1**：NORMAL 用于区分"关机"和"待机"（设备运行履历需要）
-> - **P2**：DOOR_OPEN/CLOSE、AUTO_ONLINE、FIRST/LAST
-
----
-
-### 5. 夹头数据 —— 完全未用
-
-客户提供了长地轨三台设备（F500/L2000LSY/L2100SY）和短地轨 MAZAK 的夹头编号（实时）、目标夹头和更换完成信号。
-
-> **建议**：优先级 P2，可在加工设备详情中展示当前夹头编号，更换完成时记录事件。
-
----
-
-### 6. 夹头库数据（长地轨 64 位 + 短地轨 32 位）—— 完全未用
-
-与物料库位类似，客户提供了夹头库每个位置的"有件/无件/错误"信号。
-
-> **建议**：优先级 P2，可与物料库位并列展示。
-
----
-
-### 7. 清洗机/测量仪 —— 客户多发、看板少用
-
-| 信号 | 客户提供 | 看板使用 |
-|---|---|---|
-| NORMAL（通讯正常） | ✅ | ❌ |
-| AUTO（联机状态） | ✅ | ❌ |
-| READY（准备好） | ✅ | ❌ |
-| BUSY | ✅ | ✅ |
-| ERROR | ✅ | ✅ |
-| UPLOAD_READY / UNLOAD_READY | ✅ | ✅ |
-
-> **建议**：P1，NORMAL 和 READY 可增加展示，让清洗/测量状态更完整。
-
----
-
-## 二、看板已有、但客户未提供数据 —— 需向客户索要
-
-### 1. 磨床 S33 —— 协议设备清单第 2 项，完全无 PLC 点位
-
-技术协议明确列了 studer S33 磨床，但客户 PLC 文档中没有任何该设备的点位。看板上也没有展示。
-
-| 需确认 | 说明 |
-|---|---|
-| S33 是否有 PLC 点位 | 如果没有，是走什么协议？是否需要另配采集？ |
-| S33 需采集哪些信号 | 至少需要 BUSY、ALARM、NORMAL，以及产量相关信号 |
-| S33 归属哪个单元 | 需确认是长地轨/短地轨/关节，还是独立单元 |
-
-> **严重程度**：🔴 P0 — 协议设备缺失
-
----
-
-### 2. 产量计数器 —— 没有任何设备的产量点位
-
-看板上"加工设备状态"模块有"产量"列，但客户 PLC 点位中**没有任何设备的直接产量计数器**。
-
-| 可能方案 | 说明 |
-|---|---|
-| A | 客户补充每台设备的产量计数器点位 |
-| B | 后端根据 UNLOAD_COMPLETE / COMPLETE 上升沿累计计算 |
-| C | 后端根据机器人任务 COMPLETE 按目标设备归属计数 |
-
-> **严重程度**：🔴 P0 — 技术协议 §3.5③ 明确要求展示产量
-
----
-
-### 3. 轴运动参数 —— 完全没有
-
-技术协议 §3.5③ 明确要求展示"轴运动参数"，但客户 PLC 文档中**没有任何设备的轴位置、轴速度、主轴转速等点位**。
-
-| 需确认 | 说明 |
-|---|---|
-| 各设备是否可提供轴参数 | X/Y/Z 轴位置、主轴转速、进给速度等 |
-| 数据量是否可控 | 轴参数通常高频变化，需评估采集频率和带宽 |
-
-> **严重程度**：🔴 P0 — 技术协议明确要求
-
----
-
-### 4. 生产节拍 —— 无直接点位
-
-协议要求展示"生产节拍"，需要从任务时间差计算，客户未提供节拍相关点位。
-
-| 可能方案 | 说明 |
-|---|---|
-| A | 后端根据 COMPLETE 信号时间戳计算各工位节拍 |
-| B | 客户补充节拍计数器点位 |
-
-> **严重程度**：🔴 P0 — 技术协议明确要求，可通过后端计算解决
-
----
-
-### 5. 设备运行负荷 —— 无直接点位
-
-协议要求展示"设备运行负荷"，通常指 BUSY 时间占比，可通过 BUSY 信号计算。
-
-> **严重程度**：🟡 P1 — 可通过 BUSY 时间占比计算，不一定需要新点位
-
----
-
-### 6. 工序完成进度 —— 无直接点位
-
-协议要求展示"工序完成进度"，需要知道当前加工到哪个工序/总共几个工序。
-
-| 需确认 | 说明 |
-|---|---|
-| 是否有工序定义 | 每个零件需要经过哪些工序 |
-| 如何判断当前工序 | 通过当前所在设备判断？还是通过程序号判断？ |
-
-> **严重程度**：🟡 P1 — 需要客户补充工序定义
-
----
-
-### 7. 桁架 —— 看板展示了但客户无任何 PLC 点位
-
-看板"辅助设备状态"中有"桁架"一项，但客户 PLC 文档中完全没有任何桁架相关点位。
-
-| 需确认 | 说明 |
-|---|---|
-| 桁架是否存在 | 是否确实有此设备 |
-| 桁架是否需要监控 | 如需，需提供 PLC 点位 |
-| 或是否应从看板移除 | 如果不存在，需从看板删除 |
-
-> **严重程度**：🔴 P0 — 看板展示了不存在的设备，可能是理解偏差
-
----
-
-### 8. 复测工位 —— 看板展示了但客户无任何 PLC 点位
-
-与桁架类似，客户 PLC 文档中没有"复测工位"的独立点位。可能和测量仪是同一个设备（业纳 CS608 Pro），需确认。
-
-> **严重程度**：🔴 P0 — 需确认是否与测量仪重复
-
----
-
-### 9. 长地轨打标机地址缺失
-
-客户 PLC 文档中，长地轨打标机的 NORMAL 和 BUSY 地址为空，看板无法获取这两个信号。
-
-| 需确认 | 说明 |
-|---|---|
-| 长地轨打标机 NORMAL 地址 | 文档标注为空 |
-| 长地轨打标机 BUSY 地址 | 文档标注为空 |
-
-> **严重程度**：🟡 P1 — 只有 2 个信号缺失，影响长地轨打标机状态
-
----
-
-### 10. 其他需确认的地址缺口
-
-| 设备 | 缺失信号 | 说明 |
-|---|---|---|
-| YKD5132H | D_PROG_NO、A_PROG_NO、PROG_SELECT、PROG_SELECT_READY、COMPLETE | 地址全部为空，无法做程序校验和产量计数 |
-| 长地轨机器人 | PART_KIND（零件类型） | 短地轨和关节有，长地轨没有，需确认缺还是不需要 |
-| 长地轨 / 短地轨 | 物料库位地址相同（均为 DB50.DBX101.0–109.0） | 需确认是否共用地址还是 Excel 复制错误 |
-| MAZAK | D_PROG_NO、A_PROG_NO 标注为"不需要" | 确认是否确实不需要程序号监控 |
-
----
-
-## 三、总结
-
-### 客户给了但我没做的（>200 个 PLC 点位闲置）
-
-| 数据类别 | 信号数量 | 建议优先级 |
-|---|---|---|
-| 机床详细数据（D_PROG_NO / COMPLETE / NORMAL / DOOR / EMG 等） | ~100 个 | 🔴 P0：程序校验、产量计数、通讯状态 |
-| AGV 物流数据 | 69 个 | 🟡 P2：AGV 状态模块 |
-| 预调台数据 | 51 个 | 🟡 P2：预调台状态 |
-| 夹头库数据 | ~100 个 | 🟡 P2：夹头库矩阵 |
-| 夹头数据 | ~20 个 | 🟡 P2：设备详情 |
-| 分拣台数据 | 21 个 | 🟡 P2：融入物料区 |
-| 清洗机/测量仪 补充信号 | 6 个 | 🟡 P1 |
-
-### 我做了但客户没给、需要索要的
-
-| 缺失项 | 协议关联 | 严重程度 |
-|---|---|---|
-| 磨床 S33 全部点位 | §1.3 设备清单 | 🔴 P0 |
-| 产量计数器 | §3.5③ | 🔴 P0 |
-| 轴运动参数 | §3.5③ | 🔴 P0 |
-| 桁架 PLC 点位 | — | 🔴 P0 |
-| 复测工位 PLC 点位 | — | 🔴 P0 |
-| 生产节拍（可通过计算） | §3.5③ | 🔴 P0 |
-| 设备运行负荷（可通过计算） | §3.5③ | 🟡 P1 |
-| 工序完成进度 | §3.5③ | 🟡 P1 |
-| 长地轨打标机 NORMAL/BUSY | — | 🟡 P1 |
-| YKD5132H 程序号等地址 | — | 🟡 P1 |
-| 长地轨 PART_KIND | — | 🟡 P1 |
-| 物料库地址重复确认 | — | 🟡 P2 |

work/working1/11-技术协议看板PLC差异与补充清单.md

@@ -0,0 +1,234 @@
+# 技术协议、看板与 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 点位没有提供”导致页面功能无法落地。