chore: checkpoint before scada visual polish

2026-06-25 08:45:26 +08:00
parent 01b5e7b5ef
commit 0ddf23a160
17 changed files with 1691 additions and 2514 deletions
--- a/work/working1/01-功能内容.md
+++ b/work/working1/01-功能内容.md
@@ -0,0 +1,63 @@
+# 01-功能内容
+
+更新时间：2026-06-24  
+来源文档：`产线通讯信号可视化看板设计说明.md`
+
+## 1. 看板目标
+
+本看板用于把 `通讯变量列表.xlsx` 中的产线通讯信号转化为 16:9 大屏可视化页面。核心目标不是单纯展示静态页面，而是把线体状态、机器人任务、物料库位、设备状态、报警事件、任务日志和三维模型联动起来，形成一块可持续接入真实数据的数字孪生监控看板。
+
+当前主页面为：`src/views/DaLuJiaTV1.vue`。  
+当前模型入口通过 `window.dt_Config.iframeAddress` 配置，默认设计说明中建议先使用 `https://www.baidu.com` 占位，后续替换为真实三维模型地址。
+
+## 2. 页面区域
+
+| 区域 | 位置 | 功能内容 | 当前实现建议 |
+|---|---|---|---|
+| 顶部标题栏 | 页面顶部 | 系统名称、当前日期时间、可扩展通讯状态/报警数量 | 保留系统标题和时间，顶部 KPI 根据当前视觉要求暂不显示 |
+| 左侧运行态势区 | 左侧 | 线体状态、任务流向、机器人反馈流程 | 合并为 `线体联动监控`，减少重复表达 |
+| 中央三维模型区 | 中心 | iframe 三维模型，后续可加透明 HUD | 当前按用户要求保留纯 iframe，不叠加无用悬浮元素 |
+| 右侧设备监控区 | 右侧 | 加工设备状态、辅助设备状态 | 标题右对齐，与左侧标题形成对称 |
+| 底部物料与事件区 | 底部 | 物料库位矩阵、报警与异常事件、任务日志 | 库位矩阵需完整显示 9/9/6 格 |
+
+## 3. 核心数据范围
+
+| 数据表 | 主要对象 | 用途 |
+|---|---|---|
+| 线体状态 | 长地轨、短地轨、关节机器人 | 判断在线、自动、允许接任务、急停 |
+| 任务数据 | 长地轨、短地轨、关节机器人 | 展示起点、终点、配方、托盘、零件类型、反馈流程 |
+| 物料库数据 | 长地轨、短地轨、关节物料库 | 展示库位是否有件，统计库位占用情况 |
+| 设备数据 | F500、L2000LSY、L2100SY、新日、MAZAK、YKD5132H、打标机、清洗机、测量仪 | 展示程序号、上下料、运行、报警、打标、清洗、测量状态 |
+
+## 4. 功能模块清单
+
+| 模块编号 | 模块名称 | 功能内容 | 数据/信号 | 验收要点 |
+|---|---|---|---|---|
+| M01 | 顶部标题栏 | 展示系统名称和当前时间 | 系统时间 | 标题清晰，时间每秒刷新 |
+| M02 | 全局状态 KPI | 在线单元、自动模式、可接任务、急停、执行中任务、当前报警 | PCS_RUN、AUTO_ACTIVE、ALLOW_TASK、EMG、BUSY、ERROR、ALARM | 当前阶段可选；如恢复，需避免顶部拥挤 |
+| M03 | 线体联动监控 | 单元状态、任务流向、反馈流程合并展示 | PCS_RUN、ALLOW_TASK、AUTO_ACTIVE、EMG、START_POS、END_POS、READY、BUSY、ERROR、COMPLETE | 一行/一卡表达一个单元，避免任务编号重复占位 |
+| M04 | 中央三维模型 iframe | 嵌入三维产线模型 | `window.dt_Config.iframeAddress` | iframe 填满中间区域，不被无用浮层遮挡 |
+| M05 | 模型透明 HUD | 设备标签、任务路径、报警定位 | 设备/任务/报警信号 | 当前按用户要求暂不显示，后续按需恢复 |
+| M06 | 加工设备状态 | F500、L2000LSY、L2100SY、新日、MAZAK、YKD5132H 列表 | D_PROG_NO、A_PROG_NO、UPLOAD/UNLOAD、BUSY、ALARM | 最右状态列不被挤压，报警整行高亮 |
+| M07 | 辅助设备状态 | 打标机、清洗机、桁架、测量仪、复测工位 | NORMAL、START、BUSY、IDLE、ERROR、UPLOAD_READY、UNLOAD_READY | 卡片紧凑显示，标题右对齐 |
+| M08 | 物料库位矩阵 | A/B/C 库区库位状态 | S1_YES 至 S9_YES、S1_YES 至 S6_YES | A/B 库区完整显示 3x3，C 库区完整显示 2x3 |
+| M09 | 报警与异常事件 | 展示严重/警告/提示事件 | EMG、ERROR、ALARM、程序不一致、任务超时 | 事件包含时间、设备、级别、内容 |
+| M10 | 任务日志 | 记录任务创建、启动、执行、完成、异常 | TASK_NO、FLAG、READY、BUSY、COMPLETE、ERROR | 不再强制展示 #1024 等临时编号 |
+| M11 | 交互联动 | 单元、设备、报警、任务之间联动 | 模块状态集合 | 后续实现点击联动/弹窗时补充 |
+
+## 5. 状态色规则
+
+| 状态 | 颜色 | 应用范围 |
+|---|---|---|
+| 正常 / 在线 / 完成 | 绿色 | PCS_RUN、READY、COMPLETE、IDLE、上下料完成 |
+| 运行中 / 忙碌 | 蓝色 | BUSY、自动运行中、当前任务执行 |
+| 等待 / 未触发 | 灰色 | 无任务、默认 0、未触发 |
+| 预警 / 不一致 | 黄色 | 程序号不一致、人工确认、待同步 |
+| 报警 / 急停 / 错误 | 红色 | EMG、ERROR、ALARM |
+
+## 6. 当前内容边界
+
+1. 当前页面先使用模拟数据结构，后续用真实通讯数据替换数组即可。
+2. 中央 iframe 不读取内部 DOM；跨域时只能通过外部信号数据驱动周边面板或 HUD。
+3. 顶部 KPI 和模型 HUD 在原设计中存在，但当前根据界面调整要求暂时移除或不显示。
+4. 线体、任务、反馈三类信息已经合并为一个联动模块，后续不再拆回三个孤立面板，除非业务明确要求。
--- a/work/working1/02-程序开发步骤.md
+++ b/work/working1/02-程序开发步骤.md
@@ -0,0 +1,121 @@
+# 02-程序开发步骤
+
+更新时间：2026-06-24  
+适用项目：`D:\5ITlearning\DT_TV\QingAnVue2TV`
+
+## 1. 开发原则
+
+1. 保持 Vue2 + Vue CLI 技术栈，不引入新框架。
+2. 大屏以 1920x1080 固定画布开发，通过缩放适配窗口。
+3. 优先复用老项目已有视觉资源，例如 `public/png/top1.png`、左右标题条、背景底图、边框条。
+4. 中央三维模型以 iframe 为核心画面，周边面板服务于模型，不抢主视觉。
+5. 每轮改动后必须至少执行一次构建验证；涉及布局时补充截图验收。
+6. 不提交用户未确认的无关删除或配置变更。
+
+## 2. 阶段划分
+
+| 阶段 | 目标 | 主要工作 | 产出 |
+|---|---|---|---|
+| P0 | 备份与清理准备 | git 建仓/远程备份、识别核心页面、确认可删资产 | 可回滚提交点 |
+| P1 | 遗留资源清理 | 删除 DMT/DMT_WEB 和未引用 src 内容，精简依赖 | 干净项目骨架 |
+| P2 | 需求梳理 | 阅读设计说明、拆模块、建立任务矩阵 | `01-06` 管理文档 |
+| P3 | 页面结构搭建 | 用老看板壳子承载新看板内容 | `DaLuJiaTV1.vue` 主布局 |
+| P4 | 模块实现 | 实现线体、设备、库位、报警、日志模块 | 可运行的静态/模拟数据页面 |
+| P5 | 数据接入 | 将模拟数组替换为接口/通讯变量数据 | 数据映射层、刷新逻辑 |
+| P6 | 交互联动 | 单元高亮、设备详情、报警定位、任务追踪 | 可交互看板 |
+| P7 | 视觉与适配 | 1920x1080、1600x900 等视口检查 | 截图和问题清单 |
+| P8 | 验收与交付 | 构建、截图、台账、决策记录补齐 | 可交付版本 |
+
+## 3. 推荐开发顺序
+
+### 3.1 基础检查
+
+```powershell
+git -c safe.directory=D:/5ITlearning/DT_TV/QingAnVue2TV -C D:\5ITlearning\DT_TV\QingAnVue2TV status --short
+npm run build
+```
+
+检查项：
+
+- `src/views/DaLuJiaTV1.vue` 是否为主页面。
+- `src/router/index.js` 是否仍指向 `DaLuJiaTV1`。
+- `public/config.js` 中 `iframeAddress` 是否为期望模型地址。
+- 是否存在用户未处理的工作区变更。
+
+### 3.2 页面骨架
+
+1. 保留顶部标题与时间。
+2. 左侧使用 `线体联动监控`，将线体状态、任务流向、反馈流程合并为单元卡片。
+3. 中央使用 iframe，保持纯净画面。
+4. 右侧放 `加工设备状态` 与 `辅助设备状态`，标题右对齐。
+5. 底部放 `物料库位矩阵`、`报警与异常事件`、`任务日志`。
+
+### 3.3 数据结构
+
+推荐在 `data()` 中按模块建立数组：
+
+| 数据对象 | 用途 |
+|---|---|
+| `lineMonitorRows` | 左侧线体联动监控，一条数据代表一个单元 |
+| `equipmentList` | 加工设备状态列表 |
+| `assistList` | 辅助设备状态卡片 |
+| `storageGroups` | 物料库位矩阵 |
+| `alarmEvents` | 报警与异常事件 |
+| `taskLogs` | 任务日志 |
+
+后续真实数据接入时，建议新增转换函数，不直接把接口结构写进模板。
+
+### 3.4 样式实现
+
+1. 使用固定画布：`width: 1920px; height: 1080px`。
+2. 使用 `setScale()` 按窗口缩放。
+3. 固定面板尺寸，避免动态内容撑乱布局。
+4. 所有列表行使用固定列宽、`minmax(0, 1fr)` 和 `text-overflow`。
+5. 库位格子使用固定 `grid-auto-rows`，确保 3x3 完整显示。
+
+### 3.5 验证流程
+
+每轮完成后执行：
+
+```powershell
+npm run build
+```
+
+如涉及布局，启动或复用本地服务：
+
+```powershell
+npm run serve
+```
+
+浏览器检查：
+
+- `http://127.0.0.1:8084/`
+- 1920x1080 或等比例视口。
+- 重点检查文字重叠、滚动条、格子缺失、右侧状态挤压、iframe 是否被遮挡。
+
+## 4. 代码落点
+
+| 文件 | 用途 |
+|---|---|
+| `src/views/DaLuJiaTV1.vue` | 新项目主看板页面 |
+| `src/views/DaLuJiaTV2.vue` | 老页面/参考页，非当前主改动对象 |
+| `src/router/index.js` | 路由入口 |
+| `public/config.js` | iframe 地址和服务地址配置 |
+| `public/png/` | 老项目视觉素材 |
+| `work/working1/` | 需求、推进、验收和决策文档 |
+
+## 5. 提交建议
+
+每个阶段建议单独提交：
+
+1. `docs: add dashboard working documents`
+2. `feat: implement signal dashboard layout`
+3. `fix: refine dashboard panel layout`
+4. `chore: prune unused legacy dashboard assets`
+
+提交前不要把以下内容误带入，除非用户明确确认：
+
+- 用户手动删除的压缩包或旧文档。
+- 临时截图。
+- 本地日志文件。
+- 未确认的 `public/config.js` 改动。
--- a/work/working1/03-推进台账.md
+++ b/work/working1/03-推进台账.md
@@ -0,0 +1,36 @@
+# 03-推进台账
+
+更新时间：2026-06-24  
+说明：本台账用于记录每轮做了什么、改了哪些文件、验证了什么、下一步是什么。后续每轮继续追加，不覆盖旧记录。
+
+## 推进记录
+
+| 轮次 | 日期 | 目标 | 已完成 | 变更文件/范围 | 验证 | 下一步 | 状态 |
+|---|---|---|---|---|---|---|---|
+| R001 | 2026-06-24 | 清理 DMT/DMT_WEB 遗留内容 | 删除 DMT_WEB、DMT 组件和 three 依赖，保留当前看板必要代码 | `public/DMT_WEB`、`src/components/DMT`、`package.json` 等 | `npm run build` 通过 | 继续清理 src 未用内容 | 已完成 |
+| R002 | 2026-06-24 | 大清理 src 无关内容 | 保留 `DaLuJiaTV1.vue`、`DaLuJiaTV2.vue`、路由、请求工具等核心文件，删除旧页面/旧 store/旧 assets | `src/`、`package.json` | `npm run build` 通过 | 基于 demo 做新看板 | 已完成 |
+| R003 | 2026-06-24 | 远程备份 | 创建/配置 Gitea 远程仓库并推送主分支 | git remote、master | git push 成功 | 新页面融合 | 已完成 |
+| R004 | 2026-06-24 | 融合 demo 和老看板风格 | 用老看板标题、背景、边框素材承载新项目内容 | `src/views/DaLuJiaTV1.vue` | `npm run build` 通过 | 视觉删减与布局调整 | 已完成 |
+| R005 | 2026-06-24 | 删除无用顶部说明和 iframe 浮层 | 删除顶部 KPI/说明、删除 iframe 上 HUD/标签/路径线、修复底部旧“设备运行履历”标题图重叠 | `src/views/DaLuJiaTV1.vue` | `npm run build` 通过 | 左侧模块合并 | 已完成 |
+| R006 | 2026-06-24 | 删除 TV2 按钮并合并左侧模块 | 删除 TV2 按钮；将线体状态、任务、反馈合并为 `线体联动监控` | `src/views/DaLuJiaTV1.vue` | `npm run build` 通过 | 压紧左侧、修正库位/右侧挤压 | 已完成 |
+| R007 | 2026-06-24 | 优化线体联动监控与布局问题 | 删除临时任务号 `#1024/#2048/#3086`；将左侧改为单元卡片；固定库位格尺寸；右侧标题右对齐；调整加工设备列宽 | `src/views/DaLuJiaTV1.vue` | `npm run build` 通过；Playwright/Chrome 截图无 console error | 继续根据截图压缩左/右侧高度并接入真实数据 | 待复核 |
+| R008 | 2026-06-24 | 建立工作文档体系 | 根据设计说明生成 01-06 六份文档 | `work/working1/*.md` | 文件写入后读取确认 | 后续每轮同步维护文档 | 进行中 |
+
+## 当前工作区提醒
+
+截至本记录创建时，工作区存在以下非本轮文档事项，需要提交前确认：
+
+| 项目 | 状态 | 处理建议 |
+|---|---|---|
+| `src/views/DaLuJiaTV1.vue` | 已修改 | 属于当前看板迭代，可单独提交 |
+| `public/config.js` | 曾出现修改 | 提交前确认是否为用户期望模型地址 |
+| `work/` | 未跟踪 | 本轮新增管理文档，可提交 |
+| `public/产线通讯信号可视化看板设计说明.md` 删除记录 | 需确认 | 不要误提交，除非确认迁移到 `work/working1` 后删除旧文件 |
+| `dist.7z`、`docs/*` 删除记录 | 历史工作区状态 | 未经确认不处理 |
+
+## 追加规则
+
+1. 每轮新增一行 `Rxxx`，不要修改历史事实。
+2. `验证` 必须写具体命令或截图路径。
+3. `下一步` 只写一个最直接动作，避免泛泛而谈。
+4. 文件变更范围必须写到文件或目录级别。
--- a/work/working1/04-任务矩阵.md
+++ b/work/working1/04-任务矩阵.md
@@ -0,0 +1,49 @@
+# 04-任务矩阵
+
+更新时间：2026-06-24  
+说明：本矩阵用于记录所有任务编号、状态、验收标准，防止重复做。
+
+## 状态定义
+
+| 状态 | 含义 |
+|---|---|
+| TODO | 尚未开始 |
+| DOING | 正在处理 |
+| REVIEW | 已实现，等待用户或截图复核 |
+| DONE | 已完成并通过验收 |
+| HOLD | 暂停，等待外部输入或用户确认 |
+
+## 任务列表
+
+| 任务编号 | 模块 | 任务内容 | 状态 | 验收标准 | 关联文件 |
+|---|---|---|---|---|---|
+| T-001 | 项目清理 | 删除 DMT_WEB 和无用 DMT 相关内容 | DONE | 构建通过，当前页面不引用 DMT_WEB | `public/`、`src/`、`package.json` |
+| T-002 | 项目清理 | 清理 `src` 下与当前项目无关内容 | DONE | 仅保留当前两张大屏及必要入口/工具 | `src/` |
+| T-003 | 版本备份 | 创建远程仓库并推送 | DONE | 远程 master 可回滚 | git remote |
+| T-004 | 页面主框架 | 用老看板视觉壳子承载新看板 | DONE | 标题、背景、边框与老风格一致 | `DaLuJiaTV1.vue`、`public/png/` |
+| T-005 | 顶部标题栏 | 展示系统标题和时间 | DONE | 标题居中，时间正常刷新 | `DaLuJiaTV1.vue` |
+| T-006 | 顶部 KPI | 在线单元、自动模式、报警等 KPI | HOLD | 用户已要求删除顶部说明/KPI；后续如恢复需重新确认 | `DaLuJiaTV1.vue` |
+| T-007 | 左侧联动 | 将线体状态、任务监控、反馈流程合并 | REVIEW | 一个模块表达三个单元，减少重复内容 | `DaLuJiaTV1.vue` |
+| T-008 | 任务编号 | 删除临时任务号 `#1024/#2048/#3086` | REVIEW | 页面不再出现这些临时编号 | `DaLuJiaTV1.vue` |
+| T-009 | 中央 iframe | 保留纯 iframe 模型区 | REVIEW | iframe 填满主区域，无无用浮层 | `DaLuJiaTV1.vue`、`public/config.js` |
+| T-010 | 模型 HUD | 设备标签、路径、报警浮层 | HOLD | 用户当前要求删除 iframe 上悬浮元素；后续按真实需求恢复 | `DaLuJiaTV1.vue` |
+| T-011 | 加工设备状态 | 展示 6 台加工设备状态 | REVIEW | 最右状态列不被挤压，报警行高亮 | `DaLuJiaTV1.vue` |
+| T-012 | 辅助设备状态 | 展示打标、清洗、桁架、测量、复测状态 | REVIEW | 标题右对齐，卡片内容不溢出 | `DaLuJiaTV1.vue` |
+| T-013 | 右侧标题对称 | 加工/辅助设备标题靠右 | REVIEW | 与左侧标题视觉对称 | `DaLuJiaTV1.vue` |
+| T-014 | 物料库位矩阵 | A/B 为 3x3，C 为 2x3 | REVIEW | A/B 最底部 3 格完整显示，C 6 格完整显示 | `DaLuJiaTV1.vue` |
+| T-015 | 报警事件 | 展示时间、设备、级别、事件内容 | REVIEW | 严重/警告颜色区分，文本不遮挡 | `DaLuJiaTV1.vue` |
+| T-016 | 任务日志 | 展示任务关键节点 | REVIEW | 不依赖临时任务编号也能表达任务流转 | `DaLuJiaTV1.vue` |
+| T-017 | 数据映射 | 建立 Excel 通讯变量到页面数据的转换层 | TODO | 不在模板里硬编码接口字段；有转换函数和空值处理 | 待定 |
+| T-018 | 真实数据接入 | 接入接口、WebSocket 或轮询数据 | TODO | 1 秒或指定周期刷新，异常可恢复 | 待定 |
+| T-019 | 单元联动 | 点击单元后联动模型、设备和事件 | TODO | 点击长地轨/短地轨/关节后相关区域高亮/筛选 | `DaLuJiaTV1.vue` |
+| T-020 | 设备详情 | 点击设备显示详情弹窗 | TODO | 展示设备名、所属单元、信号值、地址、最近状态 | 待定 |
+| T-021 | 报警定位 | 报警事件定位到模型和设备 | TODO | 点击事件后模型/设备高亮 | 待定 |
+| T-022 | 适配验收 | 1920x1080 和 1600x900 截图检查 | DOING | 无明显遮挡、溢出、缺格、重叠 | 截图、浏览器记录 |
+| T-023 | 工作文档 | 创建 01-06 六份文档 | DOING | 文件存在、内容可读、可继续追加维护 | `work/working1/*.md` |
+
+## 防重复规则
+
+1. 做新需求前先查本矩阵，已有任务只更新状态，不新建重复任务。
+2. 用户要求删除的功能进入 `HOLD`，不从代码里反复恢复。
+3. 每个 `REVIEW` 任务必须补验收截图或用户确认后才能改为 `DONE`。
+4. 涉及真实数据接入时，先新增数据映射任务，再写 UI。
--- a/work/working1/05-验收证据.md
+++ b/work/working1/05-验收证据.md
@@ -0,0 +1,91 @@
+# 05-验收证据
+
+更新时间：2026-06-24  
+说明：本文件记录命令、页面、job_id、report_id、PDF、截图等验收证据。没有的证据明确写“暂无”，避免以后误以为已经做过。
+
+## 1. 构建验证
+
+| 时间 | 命令 | 结果 | 备注 |
+|---|---|---|---|
+| 2026-06-24 | `npm run build` | 通过 | Vue CLI 构建成功，存在资源体积 warning |
+| 2026-06-24 14:33:31 | `npm run build` | 通过 | 输出 `DONE Build complete. The dist directory is ready to be deployed.` |
+
+已知 warning：
+
+- `chunk-vendors` 体积较大。
+- `png/背景底图.png` 等图片资源超过 webpack 推荐体积。
+- Browserslist 数据过期。
+
+这些 warning 不阻断当前功能验收，但后续性能优化可单独建任务。
+
+## 2. 本地页面验证
+
+| 项目 | 内容 |
+|---|---|
+| 本地服务 | `npm run serve` |
+| 访问地址 | `http://127.0.0.1:8084/` |
+| 页面 | `DaLuJiaTV1.vue` |
+| 验证点 | 页面可打开、无 console error、中文渲染正常、模块布局可见 |
+
+## 3. 截图证据
+
+| 时间 | 工具 | 路径 | 验证内容 |
+|---|---|---|---|
+| 2026-06-24 | Playwright + 系统 Chrome | `C:\Users\86156\AppData\Local\Temp\qingan-dashboard-check.png` | 页面截图，无 console error；检查左侧联动、右侧设备状态、底部库位矩阵 |
+
+注意：临时目录截图可能会被系统清理。正式验收截图建议复制到：
+
+```text
+D:\5ITlearning\DT_TV\QingAnVue2TV\work\working1\evidence\
+```
+
+## 4. Git 证据
+
+近期提交记录示例：
+
+| commit | 说明 |
+|---|---|
+| `a69d0ca` | fix: add transparent=true param to iframe URL for transparent 3D model background |
+| `833e256` | refactor: fullscreen iframe layout - 3D model as background with overlay panels |
+| `e12a7b0` | fix: make central iframe transparent with semi-transparent panel background |
+| `56a0c6b` | chore: snapshot before iframe transparency fix |
+| `26cb102` | chore: update config, vue component, and add new html page |
+
+提交前应再次执行：
+
+```powershell
+git -c safe.directory=D:/5ITlearning/DT_TV/QingAnVue2TV -C D:\5ITlearning\DT_TV\QingAnVue2TV status --short
+```
+
+## 5. 当前工作区证据
+
+截至本文档创建时，已观察到的工作区状态包括：
+
+| 状态 | 文件/目录 | 说明 |
+|---|---|---|
+| M | `src/views/DaLuJiaTV1.vue` | 当前看板主页面迭代中 |
+| M | `public/config.js` | iframe 地址等配置可能被调整，提交前需确认 |
+| ?? | `work/` | 工作文档目录，本文档属于该目录 |
+| D | `public/产线通讯信号可视化看板设计说明.md` | 旧位置文档删除记录，提交前需确认是否保留删除 |
+
+## 6. job_id / report_id / PDF
+
+| 类型 | 当前状态 | 说明 |
+|---|---|---|
+| job_id | 暂无 | 当前未接入外部任务平台 |
+| report_id | 暂无 | 当前未生成自动化测试报告编号 |
+| PDF | 暂无 | 当前仅生成 Markdown 工作文档 |
+| 自动化测试报告 | 暂无 | 后续可引入 Playwright 截图报告 |
+
+## 7. 验收清单
+
+| 验收项 | 标准 | 当前状态 |
+|---|---|---|
+| 构建 | `npm run build` 成功 | 通过 |
+| 页面访问 | `http://127.0.0.1:8084/` 可打开 | 通过 |
+| 中文显示 | 页面中文不乱码 | 通过 |
+| 左侧联动监控 | 无临时任务号，表达紧凑 | 待用户复核 |
+| 物料库位矩阵 | 9/9/6 格完整显示 | 待用户复核 |
+| 加工设备状态 | 最右状态列不挤出 | 待用户复核 |
+| 右侧标题 | 加工/辅助设备标题靠右 | 待用户复核 |
+| iframe | 中央模型区不被无用浮层遮挡 | 待用户复核 |
--- a/work/working1/06-决策记录.md
+++ b/work/working1/06-决策记录.md
@@ -0,0 +1,96 @@
+# 06-决策记录
+
+更新时间：2026-06-24  
+说明：记录关键决策和原因，后续变更时不反复争论同一个问题。新增决策请继续追加 ADR 编号。
+
+## ADR-001：采用老看板视觉壳子承载新项目内容
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | 使用旧 `DaLuJiaTV1.vue` 的标题、背景、边框、左右标题条等视觉风格，承载新“产线通讯信号可视化监控看板”内容 |
+| 原因 | 用户明确要求结合老项目样式；老项目素材已经适配大屏风格，能降低重新设计成本 |
+| 影响 | 新页面仍保持蓝色工业大屏风格；后续模块样式应继续沿用这一套视觉语言 |
+
+## ADR-002：中央区域以 iframe 三维模型为主画面
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | 中央区域保留 iframe，地址来自 `window.dt_Config.iframeAddress` |
+| 原因 | 设计说明明确要求三维模型为核心视觉；iframe 便于替换真实模型地址 |
+| 影响 | 前端不直接读取 iframe 内部对象；跨域情况下所有联动通过外部信号数据驱动 |
+
+## ADR-003：当前阶段删除 iframe 上无用悬浮元素
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | 暂时删除 iframe 上方 HUD、设备标签、路径线、说明框等悬浮元素 |
+| 原因 | 用户明确反馈“那些元素没有用”；当前阶段先保证主模型区干净 |
+| 影响 | 设计说明中的模型 HUD 进入 HOLD；后续需要真实设备位置/交互需求后再恢复 |
+
+## ADR-004：顶部 KPI 当前不显示
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | 删除顶部 `Industrial signal board`、在线单元、通讯状态、任务节拍等 KPI/说明卡片 |
+| 原因 | 用户明确要求删除这些内容，且顶部区域占用视觉空间 |
+| 影响 | 顶部只保留标题和时间；如未来恢复 KPI，需重新设计为不拥挤的紧凑样式 |
+
+## ADR-005：线体状态、任务、反馈合并为“线体联动监控”
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | 不再拆成 `线体状态总览`、`机器人任务监控`、`机器人反馈流程` 三个独立面板，而是按单元合并展示 |
+| 原因 | 三个模块本质上是同一单元的状态、任务和反馈三个角度，拆开会重复表达并占空间 |
+| 影响 | 左侧每个单元一卡，按“单元状态 -> 任务流向 -> 反馈流程”组织 |
+
+## ADR-006：删除临时任务号显示
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | 页面不再展示 `#1024`、`#2048`、`#3086` 等临时任务号 |
+| 原因 | 用户认为这些文字没用；当前模拟数据阶段任务号容易形成误导 |
+| 影响 | 任务日志和任务卡片改用流向、配方、托盘、零件、反馈状态表达任务 |
+
+## ADR-007：右侧标题靠右，与左侧形成对称
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | `加工设备状态`、`辅助设备状态` 标题右对齐 |
+| 原因 | 用户明确要求右侧标题应靠右，与左侧 `线体联动监控` 对称 |
+| 影响 | 后续右侧新增模块标题也应默认右对齐 |
+
+## ADR-008：物料库位格子使用固定高度，不使用自适应正方形
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | 库位格使用固定行高，确保 A/B 3x3 和 C 2x3 完整显示 |
+| 原因 | 自适应正方形在底部区域高度有限时会隐藏最下面一行 |
+| 影响 | 库位格更扁平，但信息完整性优先于正方形比例 |
+
+## ADR-009：加工设备状态行使用固定列宽和状态列右对齐
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | 加工设备行采用固定列：设备名、目标、实际、状态标签组、综合状态 |
+| 原因 | 用户反馈最右侧元素被挤到一边；固定列可避免状态列错位或溢出 |
+| 影响 | 标签数量较多时在中间标签区换行，最右综合状态保持对齐 |
+
+## ADR-010：工作文档进入 `work/working1`
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | 将功能内容、开发步骤、推进台账、任务矩阵、验收证据、决策记录保存到 `work/working1` |
+| 原因 | 用户要求建立连续推进文档；该目录与设计说明同级，便于管理 |
+| 影响 | 后续每轮开发应同步更新 `03-推进台账.md`、`04-任务矩阵.md`、`05-验收证据.md`、`06-决策记录.md` |
+
+## 后续新增决策模板
+
+```markdown
+## ADR-011：决策标题
+
+| 项目 | 内容 |
+|---|---|
+| 决策 | 这里写最终选择 |
+| 原因 | 这里写为什么这样做 |
+| 影响 | 这里写后续开发需要遵守什么 |
+```
--- a/work/working1/07-功能确认.md
+++ b/work/working1/07-功能确认.md
@@ -0,0 +1,139 @@
+线体状态
+单元	序号	类型	英文名称	中文名称	地址	初始值	值类型	读写属性	备注
+长地轨	1	软件状态	PCS_RUN	PCS运行	DB47.DBX169.2	0	Boolean	RW	
+    2	线体状态	ALLOW_TASK	允许接收任务	DB47.DBX168.0	0	Boolean	RW	发任务前提
+    4	线体状态	AUTO_ACTIVE	自动模式	DB47.DBX168.1	0	Boolean	RW	发任务前提
+    5	线体状态	EMG	急停激活	DB47.DBX168.2	0	Boolean	RW	
+短地轨	1	软件状态	PCS_RUN	PCS运行	DB28.DBX10.0	0	Boolean	RW	
+    2	线体状态	ALLOW_TASK	允许接收任务	DB28.DBX0.4	0	Boolean	RW	发任务前提
+    4	线体状态	AUTO_ACTIVE	自动模式	DB28.DBX0.1	0	Boolean	RW	发任务前提
+    5	线体状态	EMG	急停激活	DB28.DBX0.2	0	Boolean	RW	
+关节	1	软件状态	PCS_RUN	PCS运行	DB47.DBX204.0	0	Boolean	RW	
+    2	线体状态	ALLOW_TASK	允许接收任务	DB47.DBX200.3	0	Boolean	RW	发任务前提
+    4	线体状态	AUTO_ACTIVE	自动模式	DB47.DBX200.1	0	Boolean	RW	发任务前提
+    5	线体状态	EMG	急停激活	DB47.DBX200.2	0	Boolean	RW	
+
+
+任务数据
+单元	序号	类型	英文名称	中文名称	地址	初始值	值类型	读写属性	备注
+长地轨	1	机器人任务	TASK_NO	任务编号	DB47.DBW0	0	Short	RW	
+    2	机器人任务	START_POS	起始位置	DB47.DBW2	0	Short	RW	给出机器人位置的伺服信号
+    3	机器人任务	END_POS	结束位置	DB47.DBW6	0	Short	RW	
+    4	机器人任务	RECIPE_CODE	配方号	DB47.STRING18.128	NULL	String	RW	
+    5	机器人任务	PALLET_TYPE	托盘类型	DB47.DBW14	0	Short	RW	
+    27	机器人任务	FLAG	启动	DB47.DBX148.0	0	Boolean	RW	
+    28	机器人反馈	READY	准备好	DB47.DBX150.0	0	Boolean	RW	
+    29	机器人反馈	BUSY	忙碌	DB47.DBX150.1	0	Boolean	RW	
+    30	机器人反馈	ERROR	错误	DB47.DBX150.2	0	Boolean	RW	
+    31	机器人反馈	COMPLETE	完成	DB47.DBX150.3	0	Boolean	RW	
+短地轨	1	机器人任务	TASK_NO	任务编号	DB47.DBW0	0	Short	RW	
+    2	机器人任务	START_POS	起始位置	DB47.DBW2	0	Short	RW	
+    3	机器人任务	END_POS	结束位置	DB47.DBW6	0	Short	RW	
+    4	机器人任务	RECIPE_CODE	配方号	DB47.STRING24.128	NULL	String	RW	
+    5	机器人任务	PALLET_TYPE	托盘类型	DB47.DBW18	0	Short	RW	
+    6	机器人任务	PART_KIND	零件类型	DB47.DBW20	0	Short	RW	1长轴 2短轴
+    23	机器人任务	FLAG	启动	DB47.DBX154.0	0	Boolean	RW	
+    24	机器人反馈	READY	准备好	DB47.DBX156.0	0	Boolean	RW	
+    25	机器人反馈	BUSY	忙碌	DB47.DBX156.1	0	Boolean	RW	
+    26	机器人反馈	ERROR	错误	DB47.DBX156.2	0	Boolean	RW	
+    27	机器人反馈	COMPLETE	完成	DB47.DBX156.3	0	Boolean	RW	
+关节	1	机器人任务	TASK_NO	任务编号	DB47.DBW0	0	Short	RW	
+    2	机器人任务	START_POS	起始位置	DB47.DBW2	0	Short	RW	
+    3	机器人任务	END_POS	结束位置	DB47.DBW4	0	Short	RW	
+    4	机器人任务	RECIPE_CODE	配方号	DB47.STRING6.128	NULL	String	RW	
+    5	机器人任务	PALLET_TYPE	托盘类型	DB47.DBW136	0	Short	RW	
+    6	机器人任务	PART_KIND	零件类型	DB47.DBW138	0	Short	RW	1长轴 2短轴
+    19	机器人任务	FLAG	启动	DB47.DBX180.0	0	Boolean	RW	
+    20	机器人反馈	READY	准备好	DB47.DBX184.0	0	Boolean	RW	
+    21	机器人反馈	BUSY	忙碌	DB47.DBX184.1	0	Boolean	RW	
+    22	机器人反馈	ERROR	错误	DB47.DBX184.2	0	Boolean	RW	
+    23	机器人反馈	COMPLETE	完成	DB47.DBX184.3	0	Boolean	RW	
+
+
+物料库数据
+单元	序号	类型	英文名称	中文名称	地址	初始值	值类型	读写属性	备注
+长地轨	1	物料库	S1_YES	库位1有件	DB50.DBX101.0	0	Boolean	RW	库位1-9分别对应哪个位置
+    2	物料库	S2_YES	库位2有件	DB50.DBX102.0	0	Boolean	RW	
+    3	物料库	S3_YES	库位3有件	DB50.DBX103.0	0	Boolean	RW	
+    4	物料库	S4_YES	库位4有件	DB50.DBX104.0	0	Boolean	RW	
+    5	物料库	S5_YES	库位5有件	DB50.DBX105.0	0	Boolean	RW	
+    6	物料库	S6_YES	库位6有件	DB50.DBX106.0	0	Boolean	RW	
+    7	物料库	S7_YES	库位7有件	DB50.DBX107.0	0	Boolean	RW	
+    8	物料库	S8_YES	库位8有件	DB50.DBX108.0	0	Boolean	RW	
+    9	物料库	S9_YES	库位9有件	DB50.DBX109.0	0	Boolean	RW	
+短地轨	1	物料库	S1_YES	库位1有件	DB50.DBX101.0	0	Boolean	RW	
+    2	物料库	S2_YES	库位2有件	DB50.DBX102.0	0	Boolean	RW	
+    3	物料库	S3_YES	库位3有件	DB50.DBX103.0	0	Boolean	RW	
+    4	物料库	S4_YES	库位4有件	DB50.DBX104.0	0	Boolean	RW	
+    5	物料库	S5_YES	库位5有件	DB50.DBX105.0	0	Boolean	RW	
+    6	物料库	S6_YES	库位6有件	DB50.DBX106.0	0	Boolean	RW	
+    7	物料库	S7_YES	库位7有件	DB50.DBX107.0	0	Boolean	RW	
+    8	物料库	S8_YES	库位8有件	DB50.DBX108.0	0	Boolean	RW	
+    9	物料库	S9_YES	库位9有件	DB50.DBX109.0	0	Boolean	RW	
+关节	1	物料库	S1_YES	库位1有件	DB17.DBX0.0	0	Boolean	RW	
+    2	物料库	S2_YES	库位2有件	DB17.DBX0.3	0	Boolean	RW	
+    3	物料库	S3_YES	库位3有件	DB17.DBX0.6	0	Boolean	RW	
+    4	物料库	S4_YES	库位4有件	DB17.DBX1.1	0	Boolean	RW	
+    5	物料库	S5_YES	库位5有件	DB17.DBX1.4	0	Boolean	RW	
+    6	物料库	S6_YES	库位6有件	DB17.DBX1.7	0	Boolean	RW	
+
+
+
+设备数据
+单元	序号	类型	英文名称	中文名称	地址	初始值	值类型	读写属性	备注
+长地轨									
+    2	F500	A_PROG_NO	实际程序号	DB57.DBW10	0	Short	RW	
+    11	F500	UPLOAD_COMPLETE	上料完成	DB57.DBX13.4	0	Boolean	RW	
+    12	F500	UNLOAD_COMPLETE	下料完成	DB57.DBX13.5	0	Boolean	RW	
+    13	F500	BUSY	自动运行中	DB57.DBX12.4	0	Boolean	RW	
+    18	F500	ALARM	报警	DB57.DBX13.1	0	Boolean	RW	
+                                    
+    21	L2000LSY	A_PROG_NO	实际程序号	DB57.DBW30	0	Short	RW	
+    30	L2000LSY	UPLOAD_COMPLETE	上料完成	DB57.DBX33.4	0	Boolean	RW	
+    31	L2000LSY	UNLOAD_COMPLETE	下料完成	DB57.DBX33.5	0	Boolean	RW	
+    32	L2000LSY	BUSY	自动运行中	DB57.DBX32.4	0	Boolean	RW	
+    37	L2000LSY	ALARM	报警	DB57.DBX33.1	0	Boolean	RW	
+                                    
+    40	L2100SY	A_PROG_NO	实际程序号	DB57.DBW50	0	Short	RW	
+    49	L2100SY	UPLOAD_COMPLETE	上料完成	DB57.DBX53.4	0	Boolean	RW	
+    50	L2100SY	UNLOAD_COMPLETE	下料完成	DB57.DBX53.5	0	Boolean	RW	
+    51	L2100SY	BUSY	自动运行中	DB57.DBX52.4	0	Boolean	RW	
+    56	L2100SY	ALARM	报警	DB57.DBX53.1	0	Boolean	RW	
+    1	打标机	NORMAL	开机中		0	Boolean	RW	打标动作是什么样的
+    2	打标机	START	开始打标	DB84.DBX0.3	0	Boolean	RW	打标机上有无零件信号
+    3	打标机	BUSY	打标中		0	Boolean	RW	
+    4	打标机	IDLE	待机中	DB84.DBX0.0	0	Boolean	RW	
+短地轨									
+    2	新日	A_PROG_NO	实际程序号	DB57.DBW10	0	Short	RW	
+    8	新日	UPLOAD_READY	上料就绪	DB57.DBX12.1	0	Boolean	RW	上料请求
+    9	新日	UNLOAD_READY	下料就绪	DB57.DBX12.2	0	Boolean	RW	下料请求
+    10	新日	BUSY	自动运行中	DB57.DBX12.4	0	Boolean	RW	
+    15	新日	ALARM	报警	DB57.DBX13.1	0	Boolean	RW	
+                                    
+    18	MAZAK	A_PROG_NO	实际程序号	不需要	0	Short	RW	
+    24	MAZAK	UPLOAD_READY	上料就绪	DB57.DBX34.1	0	Boolean	RW	
+    25	MAZAK	UNLOAD_READY	下料就绪	DB57.DBX34.2	0	Boolean	RW	
+    26	MAZAK	BUSY	自动运行中	DB57.DBX34.4	0	Boolean	RW	
+    31	MAZAK	ALARM	报警	DB57.DBX35.1	0	Boolean	RW	
+    1	打标机	NORMAL	开机中	DB14.DBX4.0	0	Boolean	RW	
+    2	打标机	START	开始打标	DB14.DBX4.1	0	Boolean	RW	1秒脉冲
+    3	打标机	BUSY	打标中	DB14.DBX4.2	0	Boolean	RW	打标完成后一直为1
+    4	打标机	IDLE	待机中	DB14.DBX4.3	0	Boolean	RW	开机后一直处于待机中
+关节									
+    2	YKD5132H	A_PROG_NO	实际程序号		0	Short	RW	
+    7	YKD5132H	UPLOAD_READY	上料就绪	DB57.DBX12.1	0	Boolean	RW	
+    8	YKD5132H	UNLOAD_READY	下料就绪	DB57.DBX12.2	0	Boolean	RW	
+    9	YKD5132H	BUSY	自动运行中	DB57.DBX12.4	0	Boolean	RW	
+    14	YKD5132H	ALARM	报警	DB57.DBX13.1	0	Boolean	RW	
+    1	打标机	NORMAL	开机中	DB19.DBX0.0	0	Boolean	RW	
+    2	打标机	START	开始打标	DB19.DBX0.1	0	Boolean	RW	
+    3	打标机	BUSY	打标中	DB19.DBX0.2	0	Boolean	RW	
+    4	打标机	IDLE	待机中	DB19.DBX0.3	0	Boolean	RW	
+    4	清洗机	BUSY	运行中	DB25.DBX2.3	0	Boolean	RW	
+    5	清洗机	ERROR	错误	DB25.DBX2.4	0	Boolean	RW	
+    6	清洗机	UPLOAD_READY	上料就绪	DB25.DBX2.5	0	Boolean	RW	
+    7	清洗机	UNLOAD_READY	下料就绪	DB25.DBX2.6	0	Boolean	RW	
+    4	测量仪	BUSY	运行中	DB19.DBX2.3	0	Boolean	RW	
+    5	测量仪	ERROR	错误	DB19.DBX2.4	0	Boolean	RW	
+    6	测量仪	UPLOAD_READY	上料就绪	DB19.DBX6.3	0	Boolean	RW	
+    7	测量仪	UNLOAD_READY	下料就绪	DB19.DBX6.4	0	Boolean	RW	
--- a/work/working1/08-PLC数据与看板内容匹配分析.md
+++ b/work/working1/08-PLC数据与看板内容匹配分析.md
@@ -0,0 +1,274 @@
+# PLC数据与看板内容匹配分析
+
+分析对象：
+
+- 客户PLC点位文档：`07-功能确认.md`
+- 当前看板页面：`src/views/DaLuJiaTV1.vue`
+- 当前看板模块：线体任务联动状态、加工设备状态、辅助设备状态、物料库位矩阵、报警与异常事件、设备运行履历、顶部视角按钮
+
+## 1. 总体结论
+
+客户目前提供的PLC点位，能够支撑看板中大部分“实时状态类”内容，包括线体是否在线、是否允许接任务、自动模式、急停、机器人任务号、起止位置、配方号、托盘类型、零件类型、机器人握手反馈、库位有无料、设备忙碌/报警/上下料就绪等。
+
+但当前看板中有几类内容不能直接由现有PLC点位一次性满足，需要数据库、采集服务或客户补充字段：
+
+1. **产量**：现有点位没有直接的设备产量计数器。加工设备状态里的“产量”需要通过任务完成、下料完成、COMPLETE上升沿等事件计算并落库。
+2. **报警事件文本**：现有点位只有 `ALARM`、`ERROR`、`EMG` 等布尔信号，没有报警代码、报警文本、报警发生时间。报警与异常事件模块需要采集服务根据点位变化生成事件。
+3. **24小时设备运行履历**：PLC能提供当前状态，但24小时履历必须由采集服务按分钟或按状态变化记录到数据库，再由页面读取。
+4. **关机状态**：目前多数加工设备只有 `BUSY`、`ALARM`、上下料信号，没有明确的“开机/在线/心跳”信号。若要区分“关机”和“待机”，需要客户补充设备在线/开机/心跳点位，或由通讯中断推断。
+5. **程序一致性**：PLC提供实际程序号 `A_PROG_NO`，但页面若要判断“目标程序与实际程序不一致”，还需要目标程序号或配方号到程序号的映射关系。
+
+## 2. 模块匹配矩阵
+
+| 看板模块 | 当前显示内容 | 07文档可用数据 | 满足度 | 说明 |
+| --- | --- | --- | --- | --- |
+| 线体任务联动状态 | 长地轨、短地轨、关节机器人状态；当前任务；起止工位；接任务条件；当前阶段 | `PCS_RUN`、`ALLOW_TASK`、`AUTO_ACTIVE`、`EMG`、`TASK_NO`、`START_POS`、`END_POS`、`RECIPE_CODE`、`PALLET_TYPE`、`PART_KIND`、`FLAG`、`READY`、`BUSY`、`ERROR`、`COMPLETE` | 高 | 能支撑当前模块。需要补充工位编号字典、托盘类型字典、零件类型字典。长地轨任务中未看到 `PART_KIND`，若需要显示长轴/短轴，需要确认来源。 |
+| 加工设备状态 | 设备名称、产量、运行条件、状态 | F500、L2000LSY、L2100SY、新日、MAZAK、YKD5132H 的 `A_PROG_NO`、上下料完成/就绪、`BUSY`、`ALARM` | 中 | 状态和运行条件可支撑；产量没有直接点位，需要计算；程序一致性需要目标程序来源。 |
+| 辅助设备状态 | 长地轨打标机、短地轨打标机、关节打标机、清洗机、测量仪状态 | 打标机 `NORMAL`、`START`、`BUSY`、`IDLE`；清洗机 `BUSY`、`ERROR`、上下料就绪；测量仪 `BUSY`、`ERROR`、上下料就绪 | 中高 | 可支撑状态显示。长地轨打标机文档中 `NORMAL`、`BUSY` 地址为空，需要客户确认。 |
+| 物料库位矩阵 | 长地轨库区9个库位、短地轨库区9个库位、关节库区6个库位有料/无料 | `S1_YES` 至 `S9_YES`，关节 `S1_YES` 至 `S6_YES` | 高 | 可直接支撑。需要确认长地轨和短地轨是否真的共用 `DB50.DBX101.0` 至 `DB50.DBX109.0`，还是不同PLC/不同上下文。还需要库位编号到现场位置的映射。 |
+| 报警与异常事件 | 时间、设备、级别、事件内容 | 设备 `ALARM`，辅助设备 `ERROR`，机器人 `ERROR`，线体 `EMG` | 中低 | 可判断是否报警，但缺报警代码、报警文本、报警等级、开始/结束时间。建议采集服务在信号上升沿生成报警事件。 |
+| 设备运行履历 | 24小时设备状态甘特图：关机、运行、待机、报警 | `BUSY`、`ALARM`、`ERROR`、`NORMAL`、`IDLE`、`PCS_RUN` 等当前状态信号 | 中 | 当前状态可判断；24小时履历必须落库。关机状态需要明确开机/在线/心跳点位，否则只能按通讯状态或 `NORMAL=0` 推断。 |
+| 顶部视角按钮 | 长地轨视角、短地轨视角、关节视角 | 无PLC点位要求 | 不依赖PLC | 属于前端/DMT相机视角控制，不需要PLC数据。 |
+
+## 3. 当前看板字段逐项判断
+
+### 3.1 线体任务联动状态
+
+可满足：
+
+- PCS在线：`PCS_RUN`
+- 自动模式：`AUTO_ACTIVE`
+- 允许接任务：`ALLOW_TASK`
+- 急停/安全异常：`EMG`
+- 当前任务编号：`TASK_NO`
+- 任务流向：`START_POS`、`END_POS`
+- 配方号：`RECIPE_CODE`
+- 托盘类型：`PALLET_TYPE`
+- 零件类型：`PART_KIND`，短地轨和关节已有，长地轨需要确认
+- 当前阶段：可由 `FLAG`、`READY`、`BUSY`、`ERROR`、`COMPLETE` 推导
+
+建议规则：
+
+- `ERROR=1` 或 `EMG=1`：异常中断
+- `BUSY=1`：执行中
+- `READY=1` 且 `BUSY=0`：准备就绪
+- `ALLOW_TASK=1` 且 `AUTO_ACTIVE=1` 且 `PCS_RUN=1` 且 `EMG=0`：可接任务
+- `COMPLETE=1`：任务完成，可显示完成保持或等待下一任务
+
+需要补充确认：
+
+- `START_POS`、`END_POS` 对应的工位名称字典
+- `PALLET_TYPE` 对应的托盘名称字典
+- `PART_KIND` 的字典是否全线统一
+- 长地轨是否需要 `PART_KIND`，如果需要，从哪里取
+
+### 3.2 加工设备状态
+
+可满足：
+
+- F500：实际程序号、上料完成、下料完成、运行中、报警
+- L2000LSY：实际程序号、上料完成、下料完成、运行中、报警
+- L2100SY：实际程序号、上料完成、下料完成、运行中、报警
+- 新日：实际程序号、上料就绪、下料就绪、运行中、报警
+- MAZAK：上料就绪、下料就绪、运行中、报警；实际程序号标注为不需要
+- YKD5132H：实际程序号、上料就绪、下料就绪、运行中、报警
+
+不能直接满足：
+
+- 产量：未看到直接产量计数器
+- 目标程序号：未看到目标程序号点位
+- 程序一致性：只有实际程序号，不足以独立判断
+
+建议处理：
+
+- 页面保留“产量”可以，但数据来源应由采集服务计算：
+  - 方案A：设备 `UNLOAD_COMPLETE` 或 `UNLOAD_READY` 上升沿计数
+  - 方案B：机器人任务 `COMPLETE` 上升沿按目标设备归属计数
+  - 方案C：客户补充每台设备的产量计数器，页面直接读取
+- 程序一致性建议由 `RECIPE_CODE` 或生产任务中的目标程序号，与设备 `A_PROG_NO` 比对。
+- 若客户暂时不能提供产量，建议把“产量”暂时改为“程序号”，或在接口层返回计算产量。
+
+### 3.3 辅助设备状态
+
+可满足：
+
+- 短地轨打标机：`NORMAL`、`START`、`BUSY`、`IDLE`
+- 关节打标机：`NORMAL`、`START`、`BUSY`、`IDLE`
+- 清洗机：`BUSY`、`ERROR`、`UPLOAD_READY`、`UNLOAD_READY`
+- 测量仪：`BUSY`、`ERROR`、`UPLOAD_READY`、`UNLOAD_READY`
+
+部分缺口：
+
+- 长地轨打标机 `NORMAL`、`BUSY` 地址为空，需要客户补齐或确认是否不采集。
+- 打标机 `START` 可能是短脉冲，不能直接作为状态长期显示，需要采集服务捕获边沿或只用于事件记录。
+
+建议状态规则：
+
+- 打标机：`BUSY=1` 显示运行中；`IDLE=1` 显示待机；`NORMAL=0` 显示关机或离线；如后续有错误点位，优先显示报警。
+- 清洗机/测量仪：`ERROR=1` 显示报警；`BUSY=1` 显示运行中；`UPLOAD_READY` 或 `UNLOAD_READY` 显示等待上下料；否则显示待机。
+
+### 3.4 物料库位矩阵
+
+可满足：
+
+- 长地轨库区：9个库位 `S1_YES` 至 `S9_YES`
+- 短地轨库区：9个库位 `S1_YES` 至 `S9_YES`
+- 关节库区：6个库位 `S1_YES` 至 `S6_YES`
+
+需要确认：
+
+- 长地轨和短地轨库区在文档中使用相同地址 `DB50.DBX101.0` 至 `DB50.DBX109.0`。需要确认是否为同一个PLC地址空间下的重复，还是Excel转换时上下文丢失。
+- 每个 `S1` 至 `S9` 对应现场哪个实际库位、工位、料框位置。
+
+建议：
+
+- 页面可以继续显示库位矩阵。
+- 可以增加库位统计：占用数、空位数、占用率。
+- 若客户能提供物料类型或托盘号，可进一步显示“有料但类型未知/长轴/短轴”等状态。
+
+### 3.5 报警与异常事件
+
+现有点位可作为报警源：
+
+- 线体：`EMG`
+- 机器人：`ERROR`
+- 加工设备：`ALARM`
+- 清洗机/测量仪：`ERROR`
+- 打标机：目前未看到明确错误点位
+
+当前缺口：
+
+- 没有报警代码
+- 没有报警文本
+- 没有报警等级
+- 没有报警开始时间、恢复时间
+
+建议实现：
+
+- 采集服务保存报警事件表，而不是页面直接读当前布尔值。
+- 每个报警布尔点从 `0 -> 1` 时生成一条事件，记录：时间、设备、点位、事件名称、等级、是否恢复。
+- 从 `1 -> 0` 时记录恢复时间。
+
+建议报警等级：
+
+- 严重：急停 `EMG`、机器人 `ERROR`、设备 `ALARM`、清洗机/测量仪 `ERROR`
+- 警告：程序不一致、上下料等待超时、允许接任务条件不满足
+- 提示：任务完成、等待上游/下游放行
+
+### 3.6 设备运行履历
+
+可用当前PLC信号生成实时状态：
+
+- 报警：`ALARM=1` 或 `ERROR=1`
+- 运行：`BUSY=1`
+- 待机：`IDLE=1`、`READY=1`、或无报警且无运行
+- 关机：需要 `NORMAL=0`、`PCS_RUN=0`、通讯断开、或客户补充开机/在线信号
+
+当前缺口：
+
+- 现有PLC只提供当前状态，不提供历史。
+- 页面要显示24小时履历，必须由后端或采集服务按分钟存储状态。
+
+建议数据库表：
+
+| 字段 | 说明 |
+| --- | --- |
+| device_code | 设备编码 |
+| device_name | 设备名称 |
+| state | off/run/standby/alarm |
+| start_time | 状态开始时间 |
+| end_time | 状态结束时间 |
+| source_tags | 参与判断的PLC点位 |
+
+建议状态优先级：
+
+`报警 > 运行 > 待机 > 关机/离线`
+
+## 4. 建议新增或优化的看板内容
+
+基于客户目前PLC点位，建议优先考虑以下内容：
+
+1. **线体接任务条件指示**
+   - 展示 `PCS_RUN`、`ALLOW_TASK`、`AUTO_ACTIVE`、`EMG` 四个条件。
+   - 适合放在线体任务联动状态中，能快速判断为什么不能发任务。
+
+2. **机器人握手信号诊断**
+   - 展示 `FLAG`、`READY`、`BUSY`、`ERROR`、`COMPLETE`。
+   - 当前页面已经精简过，如果现场调试需要，可以做成点击详情或悬浮面板，不一定常驻主屏。
+
+3. **程序号核对**
+   - 设备侧 `A_PROG_NO` 已有。
+   - 如果能拿到目标程序号，可新增“程序一致/不一致”提示。
+   - 如果拿不到目标程序号，页面不建议直接写“程序不一致”，避免误导。
+
+4. **库位占用统计**
+   - 当前库位矩阵已具备点位基础。
+   - 可增加每个库区的占用数、空位数、占用率。
+
+5. **报警事件列表**
+   - 当前布尔点足够做基础报警事件。
+   - 需要采集服务生成事件文本，例如：“MAZAK 报警信号触发”“关节机器人 ERROR=1”“长地轨急停激活”。
+
+6. **设备运行履历**
+   - 当前页面已有模块。
+   - 必须配套状态落库，否则只能显示当前状态，不能显示24小时历史。
+
+7. **生产/产量统计**
+   - 现有PLC文档不直接提供产量。
+   - 建议客户补充产量计数器，或确认用哪个完成信号作为计数依据。
+   - 没有确认前，看板上“产量”应标注为接口计算值，而不是PLC直采值。
+
+## 5. 需要客户补充确认的问题清单
+
+1. 是否有每台加工设备的**产量计数器**？如果没有，是否允许用 `UNLOAD_COMPLETE`、`UNLOAD_READY` 或机器人 `COMPLETE` 上升沿计算产量？
+2. 是否有每台设备的**开机/在线/心跳**信号？用于区分“关机”和“待机”。
+3. 是否有**报警代码、报警文本、报警等级**？如果没有，是否接受由点位名称生成简化报警事件？
+4. 是否有**目标程序号**或 `RECIPE_CODE -> A_PROG_NO` 的映射表？用于判断程序一致性。
+5. 长地轨打标机的 `NORMAL`、`BUSY` 地址为空，是否需要补充？
+6. 长地轨任务是否有 `PART_KIND`？如果没有，长轴/短轴从哪里判断？
+7. 长地轨和短地轨物料库位是否共用 `DB50.DBX101.0` 至 `DB50.DBX109.0`？如果不是，需要提供真实地址。
+8. `START_POS`、`END_POS` 的工位编号字典是什么？
+9. `PALLET_TYPE` 的托盘类型字典是什么？
+10. PLC点位虽然标注 `RW`，看板是否只读？建议看板侧默认只读，不向PLC写入。
+11. 数据采集周期要求是多少？状态看板建议1秒级刷新，运行履历可按状态变化或1分钟粒度落库。
+
+## 6. 对当前看板的落地建议
+
+### 建议保留
+
+- 线体任务联动状态
+- 加工设备状态
+- 辅助设备状态
+- 物料库位矩阵
+- 报警与异常事件
+- 设备运行履历
+- 顶部视角按钮
+
+### 建议调整数据口径
+
+- 加工设备状态中的“产量”应明确为“接口计算产量”，当前PLC文档不能直接支撑。
+- 报警与异常事件应由采集服务生成事件，不应只读当前报警位。
+- 设备运行履历应由数据库提供24小时历史，不应只依赖页面前端模拟。
+
+### 建议新增后端/数据库能力
+
+1. PLC当前快照表：保存每个点位当前值。
+2. 状态变化事件表：保存报警、任务阶段、设备运行状态变化。
+3. 设备分钟状态表或状态区间表：支撑24小时运行履历。
+4. 产量统计表：按设备、班次、日期统计产量。
+5. 字典表：工位、托盘类型、零件类型、设备编码、点位含义、报警等级。
+
+## 7. 数据满足度结论
+
+当前PLC点位对看板的支撑度可以概括为：
+
+- **实时状态显示：基本满足**
+- **任务联动显示：基本满足**
+- **库位矩阵显示：满足**
+- **设备运行/报警当前状态：基本满足**
+- **产量显示：不直接满足，需要计算或补点**
+- **报警事件列表：部分满足，需要事件化**
+- **24小时运行履历：部分满足，需要历史落库**
+- **程序一致性：部分满足，需要目标程序或映射表**
+
+因此，当前数据可以支撑看板进入联调，但在正式交付前，需要重点确认“产量、报警事件、运行履历、关机状态、程序一致性”这五类数据口径。
--- a/work/working1/产线通讯信号可视化看板设计说明.md
+++ b/work/working1/产线通讯信号可视化看板设计说明.md
@@ -0,0 +1,623 @@
+# 产线通讯信号可视化看板设计说明
+
+## 1. 设计目标
+
+本看板用于把 `通讯变量列表.xlsx` 中的产线通讯信号转化为一块可视化大屏的信息架构。设计重点不是绘制具体页面，而是定义大屏应包含的模块、指标、数据来源、状态规则和内容呈现方式，便于后续直接交给前端开发或低代码平台实现。
+
+大屏核心视觉为中间三维模型区，通过 `iframe` 嵌入三维产线模型。当前占位 URL 使用：
+
+```text
+https://www.baidu.com
+```
+
+后续替换为实际三维模型地址即可。
+
+## 2. 数据范围
+
+Excel 中包含 4 类数据表：
+
+| 数据表 | 主要对象 | 用途 |
+|---|---|---|
+| 线体状态 | 长地轨、短地轨、关节 | 判断各单元是否在线、是否自动、是否允许接收任务、是否急停 |
+| 任务数据 | 长地轨、短地轨、关节机器人 | 展示任务编号、起点、终点、配方、托盘、零件类型、执行反馈 |
+| 物料库数据 | 长地轨、短地轨、关节物料库 | 展示各库位是否有件，统计库位占用率 |
+| 设备数据 | F500、L2000LSY、L2100SY、新日、MAZAK、YKD5132H、打标机、清洗机、测量仪 | 展示设备运行、报警、上下料、程序号、打标、清洗和测量状态 |
+
+## 3. 整体布局建议
+
+### 3.1 页面结构
+
+建议采用 16:9 大屏布局，适配 1920x1080、2560x1440 等分辨率。
+
+页面由以下区域组成：
+
+| 区域 | 位置 | 内容 |
+|---|---|---|
+| 顶部标题栏 | 页面顶部 | 系统名称、当前时间、通讯状态、在线单元数量、报警数量 |
+| 左侧运行态势区 | 左侧纵向 | 线体状态、任务流转、机器人反馈 |
+| 中央三维模型区 | 页面中心 | iframe 三维模型、透明浮层状态标签、任务路径提示 |
+| 右侧设备监控区 | 右侧纵向 | 加工设备、打标机、清洗机、测量仪状态 |
+| 底部物料与事件区 | 页面底部 | 物料库位矩阵、报警事件、任务日志、节拍指标 |
+
+### 3.2 中央 iframe 三维模型区
+
+中央区域为视觉焦点，应放置三维产线模型 iframe。
+
+实现要求：
+
+1. iframe 铺满中央模型容器，默认 URL 为 `https://www.baidu.com`。
+2. iframe 上方叠加图表和状态标签时，图表容器应使用半透明背景，不能完全遮挡三维模型。
+3. 图表、设备标签、任务路线应作为 HUD 浮层覆盖在 iframe 上方。
+4. 对只展示信息、不需要点击的浮层，可设置 `pointer-events: none`，避免阻挡三维模型交互。
+5. 对需要点击的设备标签、报警弹窗、任务详情按钮，应单独设置 `pointer-events: auto`。
+6. 中央区域不要再画静态产线平面图，三维模型是主画面，其他模块只做透明叠加或周边信息面板。
+
+建议层级：
+
+| 层级 | 内容 | 说明 |
+|---|---|---|
+| 底层 | iframe 三维模型 | 实际三维产线场景 |
+| 中层 | 设备状态点位、任务路径、库位占用提示 | 半透明 HUD |
+| 上层 | 选中设备详情、报警弹窗、任务卡片 | 可交互信息层 |
+
+## 4. 顶部标题栏模块
+
+### 4.1 系统标题
+
+标题建议：
+
+```text
+产线通讯信号可视化监控看板
+```
+
+副标题可展示：
+
+```text
+长地轨 / 短地轨 / 关节机器人 / 加工设备 / 物料库联动监控
+```
+
+### 4.2 全局状态 KPI
+
+顶部建议展示 6 个核心指标：
+
+| 指标 | 数据来源 | 计算规则 |
+|---|---|---|
+| 在线单元 | PCS_RUN | 长地轨、短地轨、关节中 PCS_RUN=1 的数量 |
+| 自动模式 | AUTO_ACTIVE | AUTO_ACTIVE=1 的单元数量 |
+| 可接收任务 | ALLOW_TASK | ALLOW_TASK=1 的单元数量 |
+| 急停数量 | EMG | EMG=1 的单元数量 |
+| 执行中任务 | BUSY | 机器人反馈 BUSY=1 的任务数 |
+| 当前报警 | ERROR / ALARM | 机器人 ERROR=1 或设备 ALARM=1 的数量 |
+
+### 4.3 状态色规则
+
+| 状态 | 颜色建议 | 说明 |
+|---|---|---|
+| 正常 / 在线 / 完成 | 绿色 | PCS_RUN、READY、COMPLETE、IDLE |
+| 运行中 / 忙碌 | 蓝色 | BUSY、自动运行中、打标中 |
+| 等待 / 未触发 | 灰色 | 默认 0 或无任务 |
+| 预警 / 不一致 | 黄色 | 目标程序号与实际程序号不一致 |
+| 报警 / 急停 / 错误 | 红色 | EMG、ERROR、ALARM |
+
+## 5. 左侧运行态势区
+
+### 5.1 线体状态总览模块
+
+展示对象：
+
+- 长地轨
+- 短地轨
+- 关节
+
+每个单元展示 4 个状态灯：
+
+| 中文名称 | 英文名称 | 地址示例 | 展示方式 |
+|---|---|---|---|
+| PCS运行 | PCS_RUN | 长地轨 DB47.DBX169.2；短地轨 DB28.DBX10.0；关节 DB47.DBX204.0 | 在线 / 离线状态灯 |
+| 允许接收任务 | ALLOW_TASK | 长地轨 DB47.DBX168.0；短地轨 DB28.DBX0.4；关节 DB47.DBX200.3 | 任务准入标识 |
+| 自动模式 | AUTO_ACTIVE | 长地轨 DB47.DBX168.1；短地轨 DB28.DBX0.1；关节 DB47.DBX200.1 | 自动 / 手动标识 |
+| 急停激活 | EMG | 长地轨 DB47.DBX168.2；短地轨 DB28.DBX0.2；关节 DB47.DBX200.2 | 红色急停告警 |
+
+模块内容建议：
+
+- 三行单元卡片，每行一个单元。
+- 左侧为单元名称，中间为四个状态灯，右侧为综合状态。
+- 综合状态优先级：急停 > 离线 > 不允许任务 > 手动模式 > 正常。
+- 当 `ALLOW_TASK=1` 且 `AUTO_ACTIVE=1` 且 `EMG=0` 时，显示“可派发任务”。
+
+### 5.2 机器人任务监控模块
+
+展示对象：
+
+- 长地轨机器人任务
+- 短地轨机器人任务
+- 关节机器人任务
+
+展示字段：
+
+| 字段 | 英文名称 | 类型 | 展示建议 |
+|---|---|---|---|
+| 任务编号 | TASK_NO | Short | 当前任务主编号 |
+| 起始位置 | START_POS | Short | 显示为起点编号，可在三维模型中高亮 |
+| 结束位置 | END_POS | Short | 显示为终点编号，可在三维模型中高亮 |
+| 配方号 | RECIPE_CODE | String | 显示当前加工/搬运配方 |
+| 托盘类型 | PALLET_TYPE | Short | 转换为托盘类型标签 |
+| 零件类型 | PART_KIND | Short | 1=长轴，2=短轴；长地轨无该字段可显示“-” |
+| 启动 | FLAG | Boolean | 显示任务启动信号是否已下发 |
+
+模块内容建议：
+
+- 使用三张任务卡片分别展示长地轨、短地轨、关节。
+- 卡片顶部显示任务编号和执行状态。
+- 中部显示“起点 -> 终点”的流向。
+- 底部显示配方、托盘类型、零件类型。
+- 当 START_POS 或 END_POS 有效时，在中央三维模型浮层中同步显示任务路径提示。
+
+### 5.3 机器人反馈状态模块
+
+机器人反馈字段：
+
+| 字段 | 中文名称 | 展示规则 |
+|---|---|---|
+| READY | 准备好 | 绿色“就绪” |
+| BUSY | 忙碌 | 蓝色“执行中” |
+| ERROR | 错误 | 红色“异常” |
+| COMPLETE | 完成 | 绿色“已完成” |
+
+综合状态判定：
+
+| 条件 | 状态文案 |
+|---|---|
+| ERROR=1 | 异常 |
+| BUSY=1 | 执行中 |
+| READY=1 且 BUSY=0 | 就绪 |
+| COMPLETE=1 | 已完成 |
+| 全部为 0 | 待机 / 未连接 |
+
+建议用横向流程条展示：
+
+```text
+任务下发 FLAG -> READY -> BUSY -> COMPLETE
+```
+
+如果 `ERROR=1`，流程条中断并高亮错误节点。
+
+## 6. 中央三维模型透明叠加区
+
+### 6.1 iframe 模型容器
+
+容器描述：
+
+- 中央主区域占页面宽度约 48%-56%。
+- 高度从顶部标题栏下方延伸到底部信息区上方。
+- 内嵌 iframe 占满容器。
+- iframe 初始地址使用 `https://www.baidu.com`。
+
+前端实现建议：
+
+```html
+<div class="model-stage">
+  <iframe src="https://www.baidu.com" class="model-frame"></iframe>
+  <div class="hud-layer">
+    <!-- 透明图表、设备标签、任务路径 -->
+  </div>
+</div>
+```
+
+透明叠加样式建议：
+
+```css
+.model-stage {
+  position: relative;
+  overflow: hidden;
+}
+
+.model-frame {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  border: 0;
+}
+
+.hud-layer {
+  position: absolute;
+  inset: 0;
+  pointer-events: none;
+}
+
+.hud-panel {
+  background: rgba(8, 18, 32, 0.42);
+  border: 1px solid rgba(120, 210, 255, 0.35);
+  backdrop-filter: blur(4px);
+}
+
+.hud-panel.interactive {
+  pointer-events: auto;
+}
+```
+
+### 6.2 三维模型浮动标签
+
+建议在三维模型上按设备位置叠加状态标签：
+
+| 标签对象 | 显示内容 |
+|---|---|
+| 长地轨 | PCS运行、自动模式、允许任务、当前任务编号 |
+| 短地轨 | PCS运行、自动模式、允许任务、当前任务编号 |
+| 关节 | PCS运行、自动模式、允许任务、当前任务编号 |
+| F500 | 程序号、自动运行中、上料完成、下料完成、报警 |
+| L2000LSY | 程序号、自动运行中、上料完成、下料完成、报警 |
+| L2100SY | 程序号、自动运行中、上料完成、下料完成、报警 |
+| 新日 | 程序号、上料就绪、下料就绪、自动运行中、报警 |
+| MAZAK | 上料就绪、下料就绪、自动运行中、报警 |
+| YKD5132H | 上料就绪、下料就绪、自动运行中、报警 |
+| 打标机 | 开机中、开始打标、打标中、待机中 |
+| 清洗机 | 运行中、错误、上料就绪、下料就绪 |
+| 测量仪 | 运行中、错误、上料就绪、下料就绪 |
+
+标签设计：
+
+- 默认显示小型状态点和设备名称。
+- 鼠标悬停或点击后展开信号详情。
+- 报警设备标签闪烁红边，但不遮挡 iframe 主体。
+- 任务相关设备可显示动态连线或箭头方向。
+
+### 6.3 任务路径叠加
+
+当任务数据中的 `START_POS`、`END_POS` 有值时，在三维模型上展示搬运路径：
+
+```text
+起始位置 START_POS -> 结束位置 END_POS
+```
+
+建议内容：
+
+- 路径线使用半透明蓝色。
+- 当前任务执行中时，路径上显示流动光点。
+- 任务完成时路径短暂变绿后淡出。
+- 任务错误时路径变红，并在错误位置显示机器人名称。
+
+## 7. 右侧设备监控区
+
+### 7.1 加工设备状态模块
+
+设备分组：
+
+| 单元 | 设备 |
+|---|---|
+| 长地轨 | F500、L2000LSY、L2100SY |
+| 短地轨 | 新日、MAZAK |
+| 关节 | YKD5132H |
+
+展示字段：
+
+| 字段 | 中文名称 | 展示建议 |
+|---|---|---|
+| D_PROG_NO | 目标程序号 | 显示为“目标程序” |
+| A_PROG_NO | 实际程序号 | 显示为“实际程序” |
+| UPLOAD_COMPLETE | 上料完成 | 长地轨设备使用 |
+| UNLOAD_COMPLETE | 下料完成 | 长地轨设备使用 |
+| UPLOAD_READY | 上料就绪 | 短地轨、关节设备使用 |
+| UNLOAD_READY | 下料就绪 | 短地轨、关节设备使用 |
+| BUSY | 自动运行中 | 蓝色运行状态 |
+| ALARM | 报警 | 红色报警状态 |
+
+模块内容建议：
+
+- 设备以紧凑列表展示，每台设备一行。
+- 每行包含设备名称、程序号、上下料状态、运行状态、报警状态。
+- `D_PROG_NO` 与 `A_PROG_NO` 不一致时显示黄色“程序待同步”。
+- `ALARM=1` 时整行红色高亮，并推送到底部事件列表。
+
+### 7.2 打标机状态模块
+
+覆盖对象：
+
+- 长地轨打标机
+- 短地轨打标机
+- 关节打标机
+
+字段：
+
+| 字段 | 中文名称 | 说明 |
+|---|---|---|
+| NORMAL | 开机中 | 设备开机状态 |
+| START | 开始打标 | 可作为动作触发信号 |
+| BUSY | 打标中 | 正在执行打标 |
+| IDLE | 待机中 | 可接收打标任务 |
+
+展示建议：
+
+- 使用小型工序卡片展示三台打标机。
+- 状态优先级：打标中 > 开始打标 > 待机中 > 开机中 > 离线。
+- 短地轨备注中提到 `START` 为 1 秒脉冲，前端需要做状态保持或事件记录，避免脉冲太短看不到。
+- 短地轨 `BUSY` 备注为打标完成后一直为 1，建议页面文案不要简单写“打标中”，可结合 `IDLE` 或事件时间显示为“打标完成/保持信号”。
+
+### 7.3 清洗机与测量仪模块
+
+关节单元包含清洗机和测量仪。
+
+字段：
+
+| 设备 | 字段 | 中文名称 |
+|---|---|---|
+| 清洗机 | BUSY | 运行中 |
+| 清洗机 | ERROR | 错误 |
+| 清洗机 | UPLOAD_READY | 上料就绪 |
+| 清洗机 | UNLOAD_READY | 下料就绪 |
+| 测量仪 | BUSY | 运行中 |
+| 测量仪 | ERROR | 错误 |
+| 测量仪 | UPLOAD_READY | 上料就绪 |
+| 测量仪 | UNLOAD_READY | 下料就绪 |
+
+展示建议：
+
+- 用两个并列状态卡片展示。
+- 卡片顶部显示设备名称和综合状态。
+- 中部显示“上料就绪 / 运行中 / 下料就绪”的流程。
+- 如果 `ERROR=1`，流程变红，并在事件区生成异常记录。
+
+## 8. 底部物料与事件区
+
+### 8.1 物料库位矩阵模块
+
+物料库信号：
+
+- 长地轨：S1_YES 至 S9_YES，共 9 个库位。
+- 短地轨：S1_YES 至 S9_YES，共 9 个库位。
+- 关节：S1_YES 至 S6_YES，共 6 个库位。
+
+展示建议：
+
+| 单元 | 库位数量 | 展示方式 |
+|---|---:|---|
+| 长地轨 | 9 | 3x3 库位矩阵 |
+| 短地轨 | 9 | 3x3 库位矩阵 |
+| 关节 | 6 | 2x3 库位矩阵 |
+
+库位状态：
+
+| 信号值 | 状态 | 显示 |
+|---|---|---|
+| 1 | 有件 | 绿色/蓝色实心块 |
+| 0 | 空位 | 暗色空框 |
+
+统计指标：
+
+- 总库位数：24。
+- 有件数量：所有 `S*_YES=1` 的数量。
+- 空库位数量：总库位数 - 有件数量。
+- 库位占用率：有件数量 / 总库位数。
+
+交互建议：
+
+- 点击库位显示所属单元、库位编号、信号地址、当前状态。
+- 库位状态变化时可短暂闪烁，提示物料流转。
+- 中央三维模型上可同步高亮对应库位。
+
+### 8.2 报警与异常事件模块
+
+事件来源：
+
+| 事件类型 | 触发信号 |
+|---|---|
+| 急停事件 | EMG=1 |
+| 机器人错误 | ERROR=1 |
+| 加工设备报警 | ALARM=1 |
+| 清洗机/测量仪错误 | ERROR=1 |
+| 程序不一致 | D_PROG_NO != A_PROG_NO |
+| 任务异常 | FLAG=1 后长时间未 READY、BUSY 或 COMPLETE |
+
+事件列表字段：
+
+- 时间
+- 单元
+- 设备
+- 事件级别
+- 事件内容
+- 信号名称
+- 信号地址
+- 当前值
+
+事件级别：
+
+| 级别 | 条件 |
+|---|---|
+| 严重 | EMG=1、ALARM=1、ERROR=1 |
+| 警告 | 程序号不一致、任务超时 |
+| 提示 | 状态切换、任务完成、库位变化 |
+
+### 8.3 任务日志模块
+
+基于任务数据记录关键节点：
+
+| 节点 | 触发条件 |
+|---|---|
+| 任务创建 | TASK_NO 变化 |
+| 任务启动 | FLAG=1 |
+| 机器人就绪 | READY=1 |
+| 任务执行中 | BUSY=1 |
+| 任务完成 | COMPLETE=1 |
+| 任务异常 | ERROR=1 |
+
+日志内容建议：
+
+```text
+10:21:08 长地轨 任务#1024 起点 1 -> 终点 6 配方 RCP-01 已启动
+10:21:11 长地轨 机器人进入 BUSY
+10:22:03 长地轨 任务#1024 COMPLETE
+```
+
+## 9. 数据映射明细
+
+### 9.1 线体状态映射
+
+| 单元 | PCS运行 | 允许接收任务 | 自动模式 | 急停激活 |
+|---|---|---|---|---|
+| 长地轨 | PCS_RUN / DB47.DBX169.2 | ALLOW_TASK / DB47.DBX168.0 | AUTO_ACTIVE / DB47.DBX168.1 | EMG / DB47.DBX168.2 |
+| 短地轨 | PCS_RUN / DB28.DBX10.0 | ALLOW_TASK / DB28.DBX0.4 | AUTO_ACTIVE / DB28.DBX0.1 | EMG / DB28.DBX0.2 |
+| 关节 | PCS_RUN / DB47.DBX204.0 | ALLOW_TASK / DB47.DBX200.3 | AUTO_ACTIVE / DB47.DBX200.1 | EMG / DB47.DBX200.2 |
+
+### 9.2 任务数据映射
+
+| 单元 | 任务字段 | 反馈字段 |
+|---|---|---|
+| 长地轨 | TASK_NO、START_POS、END_POS、RECIPE_CODE、PALLET_TYPE、FLAG | READY、BUSY、ERROR、COMPLETE |
+| 短地轨 | TASK_NO、START_POS、END_POS、RECIPE_CODE、PALLET_TYPE、PART_KIND、FLAG | READY、BUSY、ERROR、COMPLETE |
+| 关节 | TASK_NO、START_POS、END_POS、RECIPE_CODE、PALLET_TYPE、PART_KIND、FLAG | READY、BUSY、ERROR、COMPLETE |
+
+### 9.3 物料库映射
+
+| 单元 | 库位信号 | 地址范围 |
+|---|---|---|
+| 长地轨 | S1_YES 至 S9_YES | DB50.DBX101.0 至 DB50.DBX109.0 |
+| 短地轨 | S1_YES 至 S9_YES | DB50.DBX101.0 至 DB50.DBX109.0 |
+| 关节 | S1_YES 至 S6_YES | DB17.DBX0.0、DB17.DBX0.3、DB17.DBX0.6、DB17.DBX1.1、DB17.DBX1.4、DB17.DBX1.7 |
+
+### 9.4 设备数据映射
+
+| 单元 | 设备 | 核心信号 |
+|---|---|---|
+| 长地轨 | F500 | D_PROG_NO、A_PROG_NO、UPLOAD_COMPLETE、UNLOAD_COMPLETE、BUSY、ALARM |
+| 长地轨 | L2000LSY | D_PROG_NO、A_PROG_NO、UPLOAD_COMPLETE、UNLOAD_COMPLETE、BUSY、ALARM |
+| 长地轨 | L2100SY | D_PROG_NO、A_PROG_NO、UPLOAD_COMPLETE、UNLOAD_COMPLETE、BUSY、ALARM |
+| 长地轨 | 打标机 | NORMAL、START、BUSY、IDLE |
+| 短地轨 | 新日 | D_PROG_NO、A_PROG_NO、UPLOAD_READY、UNLOAD_READY、BUSY、ALARM |
+| 短地轨 | MAZAK | D_PROG_NO、A_PROG_NO、UPLOAD_READY、UNLOAD_READY、BUSY、ALARM |
+| 短地轨 | 打标机 | NORMAL、START、BUSY、IDLE |
+| 关节 | YKD5132H | D_PROG_NO、A_PROG_NO、UPLOAD_READY、UNLOAD_READY、BUSY、ALARM |
+| 关节 | 打标机 | NORMAL、START、BUSY、IDLE |
+| 关节 | 清洗机 | BUSY、ERROR、UPLOAD_READY、UNLOAD_READY |
+| 关节 | 测量仪 | BUSY、ERROR、UPLOAD_READY、UNLOAD_READY |
+
+## 10. 页面模块清单
+
+| 模块编号 | 模块名称 | 位置 | 主要内容 |
+|---|---|---|---|
+| M01 | 顶部总览 KPI | 顶部 | 在线单元、自动模式、允许任务、急停、执行中任务、报警数量 |
+| M02 | 线体状态总览 | 左上 | 长地轨、短地轨、关节状态灯 |
+| M03 | 机器人任务卡片 | 左中 | 任务编号、起点、终点、配方、托盘、零件类型 |
+| M04 | 机器人反馈流程 | 左下 | FLAG、READY、BUSY、COMPLETE、ERROR |
+| M05 | 三维模型 iframe | 中央 | iframe 嵌入三维产线，当前使用百度 URL |
+| M06 | 模型透明 HUD | 中央叠加 | 设备标签、任务路径、报警点位、库位提示 |
+| M07 | 加工设备状态 | 右上 | F500、L2000LSY、L2100SY、新日、MAZAK、YKD5132H |
+| M08 | 辅助设备状态 | 右中 | 打标机、清洗机、测量仪 |
+| M09 | 物料库位矩阵 | 底部左 | 长地轨 9 格、短地轨 9 格、关节 6 格 |
+| M10 | 报警事件列表 | 底部中 | 急停、错误、报警、程序不一致 |
+| M11 | 任务日志 | 底部右 | 任务创建、启动、执行、完成、异常 |
+
+## 11. 关键交互设计
+
+### 11.1 单元联动
+
+点击长地轨、短地轨或关节任意模块时：
+
+- 左侧任务卡片高亮对应单元。
+- 中央三维模型高亮对应区域。
+- 右侧设备列表筛选对应单元设备。
+- 底部事件列表优先显示该单元事件。
+
+### 11.2 设备详情弹窗
+
+点击设备标签或设备列表行时，弹出设备详情：
+
+- 设备名称
+- 所属单元
+- 综合状态
+- 全部信号当前值
+- 信号地址
+- 最近状态变化时间
+- 最近报警时间
+
+### 11.3 报警定位
+
+当出现 `EMG=1`、`ERROR=1` 或 `ALARM=1`：
+
+- 顶部报警数增加。
+- 对应模块红色高亮。
+- 中央三维模型设备标签出现红色告警标识。
+- 底部报警事件列表新增记录。
+- 点击事件可定位到中央模型上的对应设备。
+
+### 11.4 任务追踪
+
+当 `TASK_NO` 变化：
+
+- 创建新的任务日志。
+- 左侧任务卡片更新。
+- 中央模型显示起点和终点。
+- `FLAG=1` 后显示“已启动”。
+- `BUSY=1` 后显示“执行中”。
+- `COMPLETE=1` 后显示“已完成”。
+- `ERROR=1` 后显示“异常中断”。
+
+## 12. 内容文案建议
+
+### 12.1 状态文案
+
+| 原始信号 | 页面文案 |
+|---|---|
+| PCS_RUN=1 | PCS运行 |
+| PCS_RUN=0 | PCS未运行 |
+| ALLOW_TASK=1 | 允许接收任务 |
+| ALLOW_TASK=0 | 禁止接收任务 |
+| AUTO_ACTIVE=1 | 自动模式 |
+| AUTO_ACTIVE=0 | 非自动模式 |
+| EMG=1 | 急停激活 |
+| READY=1 | 机器人就绪 |
+| BUSY=1 | 执行中 |
+| ERROR=1 | 发生错误 |
+| COMPLETE=1 | 任务完成 |
+| ALARM=1 | 设备报警 |
+
+### 12.2 空数据文案
+
+| 场景 | 文案 |
+|---|---|
+| 无任务 | 暂无任务 |
+| 无报警 | 暂无报警 |
+| 无物料 | 空库位 |
+| 信号未接入 | 信号未接入 |
+| 地址为空 | 地址待确认 |
+
+## 13. 前端实现注意事项
+
+1. iframe 需要独立层级，图表和状态层作为透明 HUD 覆盖。
+2. 周边面板可以使用半透明深色背景，但中央三维模型区域应尽量保持通透。
+3. 报警、急停、错误类信号必须优先展示，不能被任务状态覆盖。
+4. `START` 等脉冲信号建议在前端或服务端记录边沿事件，否则大屏刷新周期可能捕捉不到。
+5. `D_PROG_NO` 和 `A_PROG_NO` 可做程序一致性校验。
+6. Excel 中部分地址为空或写有“不需要”，页面应显示为“地址待确认”或“不接入”，不要误判为异常。
+7. 长地轨和短地轨物料库地址目前相同，开发前需要确认是否确实共用地址或只是模板复制。
+8. 所有 Boolean 信号建议统一转换为 0/1、false/true 两种可识别格式，避免前端状态判断不一致。
+9. 看板建议保留数据刷新时间，例如“最后刷新：HH:mm:ss”。
+10. 三维模型 iframe 如果跨域，前端不能直接读取 iframe 内部对象，只能通过外部信号数据驱动浮层。
+
+## 14. 推荐数据刷新策略
+
+| 数据类型 | 刷新周期 | 说明 |
+|---|---:|---|
+| 线体状态 | 1 秒 | 用于快速发现急停、离线、自动模式变化 |
+| 任务状态 | 1 秒 | 用于展示任务流转 |
+| 设备状态 | 1-2 秒 | 用于加工设备状态展示 |
+| 物料库位 | 1-3 秒 | 用于库位变化展示 |
+| 报警事件 | 实时 / 1 秒 | 建议后端生成事件流 |
+| 历史统计 | 30-60 秒 | 用于节拍、占用率、趋势统计 |
+
+## 15. 后续可扩展内容
+
+后续如果有更多数据源，可以继续增加：
+
+- 产量统计：当前班次完成数、日完成数、合格数、不良数。
+- 节拍分析：单任务平均耗时、最长等待环节、设备利用率。
+- OEE 指标：可用率、性能、质量、综合效率。
+- 能耗监控：设备用电、气压、液压、温度等。
+- 维护提醒：报警频次、设备运行时长、保养倒计时。
+- 任务回放：按时间轴回放任务路径和信号变化。
+
+## 16. 交付结论
+
+本设计将 Excel 中的通讯变量拆解为“线体状态、机器人任务、物料库位、设备状态、报警事件、任务日志”六类核心信息，并以中央 iframe 三维模型为主画面，通过透明 HUD 叠加图表和状态标签。
+
+后续开发时，只需要把 `https://www.baidu.com` 替换为真实三维模型地址，并将各模块绑定到 Excel 中定义的信号地址，即可形成完整的产线通讯信号可视化看板。