QT_wuhan_YT/QT界面详细设计说明书.md

图数一体机遥控端 QT 界面详细设计说明书（Markdown 版）

本文件为 Word 交付版的文本镜像，可直接用 VSCode 打开；线框图为等宽字符示意， 全部内容（布局/坐标/字号/配色/交互逻辑）与 Word 版一致，适合直接粘贴给 DeepSeek 生成 QT 代码。

目录

• 1　文档说明
• 2　总体设计规范
• 3　界面详细设计
• 4　公共组件设计
• 5　数据与通信接口约定
• 6　待确认事项清单
• 附录A　交给 DeepSeek 的提示词模板
• 附录B　界面原型映射说明
  • 1.1　目的与用途
  • 1.2　依据与范围
  • 1.3　术语表
  • 1.4　使用方法（交付 DeepSeek 的流程）
  • 2.1　运行环境与画布
  • 2.2　工业风格配色体系
  • 2.3　字体与字号规范
  • 2.4　通用控件规范
  • 2.5　输入方式与焦点机制
  • 2.6　页面公共框架
  • 2.7　全局状态与互斥规则
  • 2.8　页面导航总图
  • 界面③　开机密码界面（含密码流程子界面）
  • 界面④　自检界面（系统启动及自检）
  • 界面⑤　作业选择界面
  • 界面⑥　机器人底盘界面
  • 界面⑦　机械臂界面
  • 界面⑧　气体检测仪界面
  • 界面⑨　手动消除界面
  • 界面⑩　手动消毒界面
  • 界面⑪　调试维护界面
  • 界面⑫　故障查询界面
  • 4.1　TitleBar（顶条组件）
  • 4.2　StatusStrip（底部状态条）
  • 4.3　LedIndicator（指示灯）
  • 4.4　NumPadDialog（数字键盘弹窗）
  • 4.5　ConfirmDialog（确认弹窗）
  • 4.6　AlarmBanner（告警横幅）
  • 4.7　ParamControl（参数调节控件）
  • 4.8　DataCard（数据卡片）
  • 4.9　FaultTable（故障分页表格）

1　文档说明

1.1　目的与用途

本文档是“铣削机器人（图数一体机）”遥控端触摸屏 QT 界面开发的完整界面规格说明书，覆盖《技术协议（初版）》第③～⑫项共 10 个界面：③开机密码界面（含密码警告、密码管理登录、密码管理、密码重置 4 个子界面）、④自检界面、⑤作业选择界面、⑥机器人底盘界面、⑦机械臂界面、⑧气体检测仪界面、⑨手动消除界面、⑩手动消毒界面、⑪调试维护界面、⑫故障查询界面。

文档面向两类读者：一是代码生成模型（如 DeepSeek），可据此直接编写 QT 界面程序（控件、布局、配色、交互逻辑、数据绑定均有明确规格）；二是项目开发与评审人员，用于界面评审与验收。

文档编写原则：协议原文要求逐条落位（文中以黑体加粗引用）；协议未明确、属于设计补充的内容一律标注【设计建议】，供开发时取舍或与甲方确认。

1.2　依据与范围

依据文件：《铣削机器人（图数一体机）技术协议（初版）_20260728》，产品名称为“玉兔”工业无线遥控器，产品型号 YTZT6K8EART2-aL25。遥控器面板含触摸屏、物理摇杆、机械旋钮（行车/机械臂模式）、参数设置旋钮、多功能光标旋钮（旋转+顶部按键）、紧急停机旋钮及方向/末端按键，协议第①②项为面板结构、⑬接收器线束、⑭整车控制协议、⑮其他配件，不在本说明书界面开发范围内；整车控制协议详见《洗消机器人遥控器通信协议0708》。

界面原型：协议文档内嵌浅色界面示意图（开机密码、自检、作业选择、底盘、机械臂、气体检测仪、手动消除、手动消毒、调试维护、故障查询）。本文档保留原型的布局与字段命名，按用户要求将视觉风格优化为深色工业风格（见第 2 章配色体系）。

1.3　术语表

表1-1　术语表

术语	含义
图数一体机	集图形显示与数据控制于一体的遥控设备（本文指遥控器手持端）
遥控端/手持端	操作人员手持的遥控器，运行 QT 界面程序
车载端	机器人本体控制系统，经 CAN 总线与遥控端通信
D1、D2	洗消系统两个电动球阀（药液/清水通路阀门）
柱塞泵/空压机/叶片泵	洗消系统执行部件：药剂泵、气源泵、发泡泵
行车/机械臂模式	遥控器面板机械旋钮切换的操作模式，决定底盘、机械臂可否操作
光标/焦点	界面中由多功能光标旋钮驱动的可聚焦控件高亮框
急停	紧急停机：物理急停旋钮或界面软急停按钮，触发后底盘、机械臂、洗消系统立即停止

1.4　使用方法（交付 DeepSeek 的流程）

将本文档全文（或第 2～5 章及附录A）粘贴/上传给 DeepSeek，并附上附录A的提示词模板开头，即可让模型按本文档逐界面生成 QT 代码。文档中【设计建议】项允许模型在实现时按工程惯例取舍，但协议原文要求（黑体加粗）不得改动。

2　总体设计规范

2.1　运行环境与画布

表2-1　运行环境约定

项目	约定
GUI 框架	Qt 5.15 LTS / Qt 6.x，Widgets 模块（QWidget + QSS 样式表）；亦可 PySide6/PyQt5 实现
画布分辨率	1920×1080（横屏），全屏无边框窗口；分辨率用全局常量 SCREEN_W=1920、SCREEN_H=1080 定义；若部署在更低分辨率屏，按同一比例整体缩放
输入设备	电容触摸屏；物理摇杆（左/右）；机械旋钮（模式）；参数设置旋钮；多功能光标旋钮（旋转=移动光标/调值，顶部按键=确认）；紧急停机旋钮
通信	与车载端经 CAN 总线通信，UI 层通过通信层回调/信号接收数据（信号名称见第 5 章占位表）
存储	参数（车速、柱塞泵流量、发泡倍数、泡沫比例、空压机流量）与密码、故障历史写入本地存储区，上电自动读取
开发约定	所有页面继承统一基类 BasePage；页面切换用 QStackedWidget；公共组件复用（见第 4 章）

2.2　工业风格配色体系

协议内嵌原型为浅色界面，按工业操控终端惯例优化为深色高对比主题：深蓝灰底、浅色文字、蓝/绿/琥珀/红四色语义固定。所有颜色值以 QSS 十六进制为准。

表2-2　工业风格配色体系

色名	用途	十六进制	使用位置
主背景	窗口画布底色	#161C23	全屏背景
面板背景	卡片/弹窗/顶条/底条	#242E3A	数据卡片、标题条、弹窗
面板亮色	按钮常态、表头	#2D3947	普通按钮、表头、进度条底
分割线	边框、表格线	#3D4A59	卡片边框、表格网格、输入框边框
主文字	标题、正文、数值	#E6EDF3	各级标题与正文
次文字	说明、单位、标签	#9AA7B4	字段标签、单位、次要信息
强调主色	主按钮、选中、焦点	#3D8BFD	主操作按钮、选中态、焦点框、进度条
成功/运行	运行、开启、到位	#36C75A	指示灯绿色态、通信正常、自检正常
警告	提醒、待确认	#F5A623	待机提醒、注意类提示
危险/故障	急停、故障、警示	#E5484D	急停按钮、故障灯、警示文字、自检异常
禁用	不可操作控件	#56636F	禁用按钮底色
禁用文字	不可操作文字	#6B7A88	禁用按钮文字

配色使用原则：①深底浅字高对比，保证车间强光、暗光环境可读；②色彩语义全系统固定——绿色=运行/开启/到位/正常，红色=故障/停止/急停/警示，琥珀=提醒，蓝色=操作与选中，任何页面不得混用；③协议要求“警示字体都为红色”，所有警告、故障文字统一使用危险红并在 500ms 周期闪烁；④按钮禁用一律置灰（背景#56636F、文字#6B7A88）。

2.3　字体与字号规范

表2-3　字体与字号规范

用途	字体（建议）	字号（px）	说明
页面标题（顶条）	微软雅黑/思源黑体CN	28	加粗
卡片标题	微软雅黑/思源黑体CN	20	加粗
正文/按钮文字	微软雅黑/思源黑体CN	18	触屏可读下限
次要说明/单位	微软雅黑/思源黑体CN	16	标签、单位
大数值显示	Arial/等线（DIN）	40～64	加粗，用于浓度、流量、压力等
状态小字	微软雅黑/思源黑体CN	20	指示灯旁文字

注：以上为 1920×1080 屏的推荐值；设备端最终字体以系统可用字体为准，代码中用 QFont 常量统一定义；文档线框图字体为宋体等宽。

2.4　通用控件规范

按钮状态视觉规范：

表2-4　按钮状态规范

状态	背景	文字	边框	适用
普通	#2D3947	#E6EDF3	#3D4A59	普通按钮
悬停	#3D8BFD（20%叠加）	#E6EDF3	#3D8BFD	触摸悬停/光标悬停
按下	#3D8BFD	#FFFFFF	#3D8BFD	按压反馈
选中/激活	#3D8BFD	#FFFFFF	无	模式激活、图标选中
禁用	#56636F	#6B7A88	#56636F	条件不满足时
危险（急停/停止）	#E5484D	#FFFFFF	#E5484D	急停、停止、清除类

控件通用规则：主操作按钮圆角 12px、最小尺寸 140×76px；急停按钮圆角 6px、最小 130×64px，常驻顶条右侧；触控目标最小 88×88px。输入框深底（#161C23）、2px 边框（#3D4A59），聚焦时边框 3px 主色。指示灯为圆形 32×32px，三态：灰（#56636F）=未运行/关闭/正常，绿（#36C75A）=运行/开启/到位，红（#E5484D）=故障/液位低，红色状态按 500ms 周期闪烁（透明度 40%↔100%）。弹窗：遮罩 #00000066，面板 #242E3A，圆角 16px，2px 边框，居中弹出。数据卡片：面板背景、圆角 12px、标题栏高 44px，内容为“标签：值”行（标签次文字、值主文字加粗）。表格：表头面板亮色、行高 54px、选中行主色 15% 叠加、隔行斑马纹 #2A3442。进度条：底 #2D3947、值段主色，文本白色居中覆盖。

2.5　输入方式与焦点机制

①触摸：直接点击控件触发。②多功能光标旋钮：旋转在可聚焦控件之间移动焦点框（2px 主色外框 + 外发光），顶部按键触发确认；旋钮旋转同时用于参数加减（如转速、流量），步进值见各界面。③参数设置旋钮：在参数设置界面直接调节当前高亮参数。④物理摇杆（左/右）：底盘行驶、机械臂运动，界面同步显示摇杆方向状态。⑤机械旋钮：切换“行车模式/机械臂模式”，界面显示当前模式徽标。⑥软急停按钮：触摸点击。

【设计建议】QT 实现时统一封装 InputManager：将多功能光标旋钮旋转映射为方向键（上/下/左/右）、顶部按键映射为回车键，触摸点击与按键共用同一套槽函数，保证“触摸可用、旋钮光标可用”双通道一致。

2.6　页面公共框架

所有工作页（⑤～⑪）共用以下框架（密码页、自检页、故障查询页按各自布局）：（1）顶条（高 98px，y=0）：左侧“通信状态：●正常”（绿色圆点）或“通信异常”（红色闪烁）；中央页面标题（40px 加粗）；右侧时间（HH:MM，22px）与软急停按钮（130×64，红底白字“急停”）。（2）底部状态条（高 94px，y=986）：底盘电量、底盘电压、清水液位、泡沫液位四个迷你指示（图标+数值，异常红闪）；当前模式徽标（行车模式/机械臂模式）；右下角统一“返回”按钮（144×76）。（3）告警横幅：位于标题下方（y=108），红色文字 500ms 闪烁，用于“机械臂未回位，请谨慎操作”“通信异常”“警告：该模式下无保护功能，操作请谨慎！”等警示。（4）闪烁规则统一：QTimer 500ms 定时器切换控件可见性或透明度（40%↔100%）。

2.7　全局状态与互斥规则

表2-5　全局状态与互斥规则

状态	规则
通信状态	全局状态位；异常时顶条“通信异常”红色闪烁，所有页面上报数据置灰并保留最后有效值
急停	全局状态位；触发后底盘、机械臂、洗消系统立即停止，界面弹出红色急停横幅，需人工复位后才可恢复操作
行车/机械臂模式	面板机械旋钮切换；底盘页仅行车模式下可执行行驶操作；机械臂页仅机械臂模式下可执行关节操作
手动消除/消毒模式	进入⑨⑩页面后，底盘与机械臂所有手动操作无效，界面相关按钮禁用；洗消过程中机械手末端自动俯仰摆动
返回规则	⑨⑩在运行中“返回”无效（需先停止）；其余页面随时可返回作业选择界面

2.8　页面导航总图

┌──────────────────────────────────────────────┐
│　　　　　　　　　　　　　　③开机密码界面　（密码“６７８９”）　　　　　　　　　　　　　　│
│　　　　　　　　　　　　　　│　密码正确　　　　│　忘记／修改密码　　　　　　　　　　　　　│
│　　　　　　　　　　　　　　　　　　▼　　　　　　　　　▼　　　　　　　　　　　　　　　　　│
│　　　　　　　　　　④系统自检界面　　③密码管理登录→密码管理→密码重置　　　　　　　　　　│
│　　　　　　　　　　　　　　　　　　│　自检完成／忽略故障　　　　　　　　　　　　　　　　　│
│　　　　　　　　　　　　　　　　　　　　　　　▼　　　　　　　　　　　　　　　　　　　　　　│
│　　　　　　　　　　　⑤作业选择界面　（中央显示电量／电压／液位等）　　　　　　　　　　　　│
│　　　　　　　　┌────┬────┬────┬────┬────┬────┐　　　　　　　│
│　　　　　　　　　　　　　▼　　　▼　　　▼　　　▼　　　▼　　　▼　　　　　　　　　　　　│
│　　　　　　⑥底盘　⑦机械臂　⑧气体检测仪　⑨手动消除　⑩手动消毒　⑪调试维护　　　　　　　│
│　　　　　⑫故障查询：从④自检页“故障查询”按钮进入，也可在⑤增设入口【设计建议】　　　　　│
│　　　　　　　　　　　工作页“返回”→⑤作业选择；⑨⑩仅在停止后允许返回　　　　　　　　　　│
│　　　　　　　　　　　　　　全局：任意页面触发急停→全系统立即停止　　　　　　　　　　　　　│
└──────────────────────────────────────────────┘

页面跳转实现约定：QStackedWidget 管理全部页面索引，统一 PageRouter 提供 go(page)、back() 接口；返回目标固定为作业选择界面（⑤），密码流程子页面返回逻辑见 3.1。

3　界面详细设计

以下 10 个界面均基于协议原文要求与协议内嵌原型图设计。每个界面按统一模板展开：功能概述（含协议原文引用）、界面布局线框、分区说明、控件清单、运行状态机、交互逻辑、数据与信号绑定。控件坐标以画布 1920×1080 左上角为原点，格式为（x, y, w, h）。

界面③　开机密码界面（含密码流程子界面）

3.1.1　功能概述

协议要求：开机进入开机密码界面，手动点击密码输入框，弹窗数字键盘，输入正确密码后，点击确认按钮，进入自检界面；若输入密码有误，点击确认按钮后，跳转至错误密码警告界面，重新输入密码。忘记密码／需要修改密码，可以进行密码重置。开机密码为“6789”。（原型确认密码为 4 位数字，重置流程 4 步：密码管理界面→重置密码界面→输入新密码→确认弹窗“修改成功”2 秒后消失→退出返回开机密码界面。）

【设计建议】本界面由 5 个子界面组成：开机密码主界面、密码警告界面、密码管理登录界面、密码管理界面、密码重置界面；全部为全屏居中布局，不显示顶条/底条；顶部品牌区显示产品名与型号（厂家 LOGO 以文字占位）。

3.1.2　界面布局（线框示意）

┌──────────────────────────────────────────────┐
│　　　　　　　【“玉兔”工业无线遥控器　ＹＴＺＴ６Ｋ８ＥＡＲＴ２－ａＬ２５】　　　　　　　　│
│　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　│
│　　　　　　　　　　　　　　　　　　　请输入开机密码　　　　　　　　　　　　　　　　　　　　│
│　　　　　　　┌──────────────────────────────┐　　　　　　　│
│　　　　　　　│●　●　●　●　　　　　　　　　　　　　　　　　　　　　　　│　　　　　　　│
│　　　　　　　└──────────────────────────────┘　　　　　　　│
│　　　　　　　　　　　　密码输入有误，请重新输入（红色，默认隐藏）　　　　　　　　　　　　　│
│　　　　　　　　　　┌────────┐　　　　　　┌────────┐　　　　　　　　　　│
│　　　　　　　　　　│确认　　　　　　│　　　　　　│取消　　　　　　│　　　　　　　　　　│
│　　　　　　　　　　└────────┘　　　　　　└────────┘　　　　　　　　　　│
│　　　　　　　　　　　　忘记密码／修改密码（链接，点击进入密码管理）　　　　　　　　　　　　│
│　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　│
│　　　　　　　　　（点击密码输入框弹出数字键盘：１－９、０、退格、清除）　　　　　　　　　　│
└──────────────────────────────────────────────┘

线框为开机密码主界面。密码警告／密码管理登录／密码管理／密码重置 4 个子界面共用同一版式：顶部标题 + 中部输入框（或选项区）+ 底部操作按钮行，仅标题与按钮不同。

3.1.3　分区与子界面说明

表3-1　密码流程子界面说明

子界面	标题	中部内容	操作按钮	跳转关系
开机密码（主）	请输入开机密码	4 位密码输入框（●掩码）＋错误提示（初始隐藏）	确认／取消＋忘记密码链接	正确→④自检；错误→密码警告；忘记→密码管理登录
密码警告	密码输入有误，请重新输入	红色警示大字（26px 加粗）	重新输入	→返回开机密码主界面，清空输入
密码管理登录	密码管理登录界面	管理员密码输入框（4 位●掩码）	确认／取消	正确→密码管理界面；错误→红字提示
密码管理	密码管理界面	功能选项列表：重置密码功能（√ 勾选）	确认／退出	确认→密码重置界面；退出→开机密码主界面
密码重置	重置密码界面	新密码输入框（4 位）＋“请输入4位有效密码”提示	确认／取消／退出	确认→弹窗“修改成功”2s 自动消失；退出→开机密码主界面

3.1.4　控件清单

表3-2　开机密码界面控件清单

ID	控件	文本/取值	位置（x,y,w,h）	初始状态	交互与样式要点
P1	QLineEdit	密码 ●●●●（掩码）	（440,340,400,88）	空	只读回显；点击弹出数字键盘；限 4 位；圆角 8px、聚焦边框主色 2px
P2	QPushButton	确认	（440,560,180,72）	可用	主色按钮；校验密码；防连点（校验中禁用 1s）
P3	QPushButton	取消	（660,560,180,72）	可用	清空输入框
P4	QLabel	密码输入有误，请重新输入	（240,470,800,40）	隐藏	红色 18px 加粗，居中
P5	QPushButton	忘记密码／修改密码	（440,700,400,44）	可用	链接样式（无边框、主色文字）→密码管理登录
P6	NumPadDialog	数字键盘	弹窗 960×486	—	见 4.4；数字键 130×98、36px；退格/清除
Q1	子页-密码警告	重新输入	全屏	—	红色大字居中＋1 个主色按钮
Q2	子页-密码管理登录	管理员密码 ●●●●	全屏	—	输入框＋确认/取消
Q3	子页-密码管理	重置密码功能　□√	全屏	勾选√	选项行＋确认/退出
Q4	子页-密码重置	新密码 ●●●●	全屏	—	输入框＋确认/取消/退出；成功弹窗 2s

3.1.5　运行状态机

表3-3　开机密码界面状态机

状态	可用操作	禁用/限制	提示与显示
待输入	点击输入框、确认、取消、忘记密码	—	输入框聚焦
键盘弹出	数字键、退格、清除、键盘确认	背景操作	输入框同步显示 ●
校验中	—	确认按钮	防连点 1s
校验通过	—	—	跳转④自检界面
校验失败	跳转密码警告	—	输入清空
密码警告页	重新输入	—	红色警示
锁定（连续 5 次错误）	无	全部输入	倒计时 30s 后自动解锁【设计建议】

3.1.6　交互逻辑

表3-4　开机密码界面交互逻辑

步骤	用户操作	系统行为与结果
1	点击密码输入框	弹出数字键盘（模态，遮罩 #00000066）
2	依次点击数字键	输入框显示 ●，最多 4 位；超过 4 位忽略
3	点击退格／清除	删除末位／全部清空
4	点击确认（键盘或页面）	与存储区密码（初始“6789”）比对：正确→跳转④自检界面；错误→跳转密码警告界面并清空输入
5	密码警告页点击“重新输入”	返回开机密码主界面，输入框自动聚焦
6	点击“忘记密码／修改密码”	跳转密码管理登录界面
7	密码管理登录输入管理员密码＋确认	正确→密码管理界面；错误→红字提示（3s）
8	密码管理界面勾选“重置密码功能”＋确认	跳转重置密码界面
9	重置密码输入 4 位新密码＋确认	校验（4 位数字）通过→弹窗“修改成功”，2s 后自动消失；新密码写入存储区
10	重置密码界面点击“退出”	返回开机密码主界面
11	任意子界面点击取消	清空当前输入框，停留当前页
12	连续 5 次输入错误【设计建议】	锁定 30s：输入框与按钮禁用，倒计时提示

3.1.7　数据与信号绑定

表3-5　开机密码界面数据绑定

字段	显示位置	数据来源（占位）	刷新/显示规则
开机密码	校验逻辑	stored_param('pwd')，初始 6789	上电读取；重置成功后写回
管理员密码	密码管理登录校验	stored_param('admin_pwd')	初始与开机密码一致【待确认】
错误计数/锁定时间	锁定提示	内存变量	5 次触发；30s 倒计时刷新

界面④　自检界面（系统启动及自检）

3.2.1 功能概述

协议要求：自检过程主要检测各分系统通信、各个传感器信号数据是否正常及电动球阀 D1～D2 是否能正常开启和关闭。电动球阀在执行开启或关闭动作后，若收到总线上关于 D1～D2 故障信号，则发出“电动球阀 D1 开启故障”或“电动球阀 D1 关闭故障”等故障提示。自检完成后进入“作业选择界面”。

原型布局：左上角自检状态大字（自检完成／无法完成自检　请检查设备），中央自检项日志列表（含进度条），左侧“故障查询／忽略故障”按钮，右侧“操作说明／启动自检／作业选择”按钮。

3.2.2 界面布局（线框示意）

┌──────────────────────────────────────────────┐
│通信●正常　│【自检界面】　　　　　　时间　　急停　　　　　　│　　　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│故障查询　　│○通信系统　　　　正常　　　　　　　　　　　　　│操作说明　　　　　　　　　　│
│忽略故障　　│○底盘通信　　　　正常　　　　　　　　　　　　　│启动自检　　　　　　　　　　│
│　　　　　　│○机械臂通信　　　正常　　　　　　　　　　　　　│作业选择　　　　　　　　　　│
│　　　　　　│○洗消通信　　　　正常　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　│○传感器信号　　　正常　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　│○清水液位　　　　正常　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　│○球阀Ｄ１开启　　正常　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　│○球阀Ｄ１关闭　　正常　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　│○球阀Ｄ２开启　　正常　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　│○球阀Ｄ２关闭　　正常　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　│进度：０％（０／１０）　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
└──────────────────────────────────────────────┘

说明：线框为结构示意（画布 1920×1080），控件精确坐标以 3.2.3 分区说明与 3.2.4 控件清单为准。

3.2.3 分区说明

区域	位置（x,y,w,h）	内容	说明
状态区	（0,0,1920,108）	自检状态大字	正常绿字；异常红字 26px 加粗
自检项列表	（360,162,1200,648）	10 个自检项，两列	每项：名称＋状态灯＋结果文字；检测中黄闪、正常绿、异常红
进度条	（360,836,1200,54）	自检进度 0～100%	主色填充，白色百分比文字覆盖
左按钮列	（36,756,270,216）	故障查询／忽略故障	忽略故障仅异常时可用
右按钮列	（1614,756,270,270）	操作说明／启动自检／作业选择	作业选择仅完成或忽略后可用

3.2.4 控件清单

ID	控件	文本/取值	位置（x,y,w,h）	初始状态	交互与样式要点
S1	QLabel	自检状态文字	（72,32,600,64）	自检中（琥珀）	正常绿／异常红闪
S2	自检项列表（10 组）	项名＋LedIndicator＋结果	（360,162,1200,648）	—	组高 62px；动作后回读结果
S3	QProgressBar	0～100%	（360,836,1200,54）	0%	主色填充，圆角 4px
S4	QPushButton	故障查询	（36,756,270,98）	可用	→⑫故障查询界面
S5	QPushButton	忽略故障	（36,874,270,98）	异常时可用	→⑤作业选择界面
S6	QPushButton	操作说明	（1614,756,270,98）	可用	弹窗显示自检项说明【预留】
S7	QPushButton	启动自检	（1614,874,270,98）	可用	复位所有项并重新自检
S8	QPushButton	作业选择	（1614,982,270,98）	完成/忽略后可用	→⑤作业选择界面

3.2.5 运行状态机

状态	可用操作	禁用/限制	提示与显示
待自检	启动自检	其余按钮	进度 0%
自检中	无	除启动自检外全部禁用	各项目黄闪，进度递增
全部正常	作业选择	忽略故障隐藏	绿字自检完成
存在异常	故障查询／忽略故障／启动自检／作业选择	—	红字无法完成自检

3.2.6 交互逻辑

步骤	用户操作	系统行为与结果
1	点击任一自检按钮	进入对应界面或重新自检
2	检测每项时	状态灯黄闪（检测中）→绿（正常）或红（异常），结果文字同步
3	电动球阀 D1/D2 动作后收到故障信号	发出“电动球阀D1开启故障”／“电动球阀D1关闭故障”等故障提示，红色闪烁
4	全部自检正常	状态区绿字“自检完成”；2s 后自动进入作业选择界面【设计建议】
5	存在自检异常	状态区红字“无法完成自检　请检查设备”，异常项红闪
6	点击故障查询	进入⑫故障查询界面
7	点击忽略故障	进入⑤作业选择界面，异常项在对应卡片红闪
8	点击启动自检	清空结果、进度归零，重新自检

3.2.7 数据与信号绑定

字段	显示位置	数据来源（占位）	刷新/显示规则
各分系统通信状态	自检项列表	on_comm_state 等	正常绿／异常红
传感器信号	自检项列表	on_tank_level / on_wash_state	正常／异常
球阀 D1/D2 动作结果	自检项列表	on_ball_valve_state	动作后回读
球阀故障	故障提示横幅	fault 信号	“电动球阀D1开启故障”等红闪

界面⑤　作业选择界面

3.3.1 功能概述

协议要求：此页面可选择“机器人底盘”、“机械臂”、“气体检测仪”、“手动消除”、“手动消毒”、“调试维护”进入各自作业界面，通过触摸控制或者物理旋钮结合界面中图标光标操作。中间区域显示底盘电量、电压以及液位等基本数据，如有故障会闪烁显示。

原型布局：左侧菜单 4 项（机器人底盘／机械臂／气体检测仪／调试维护），中央 4 张数据卡片（底盘、机械臂、洗消、气体检测仪），右侧“手动消除／手动消毒／返回”按钮。

3.3.2 界面布局（线框示意）

┌──────────────────────────────────────────────┐
│通信●正常　│【作业选择】　　　　　时间　　急停　　　　　　　│　　　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│机器人底盘　│┌────底盘────┐┌───机械臂────┐│手动消除　　　　　　　　　　│
│　　　　　　││电量：８５％　　　　││末端ＸＹＺ　　　　　││　　　　　　　　　　　　　　│
│机械臂　　　││电压：３６０Ｖ　　　││姿态ＲＸ．．　　　　││手动消毒　　　　　　　　　　│
│　　　　　　││故障：无　　　　　　││　　　　　　　　　　││　　　　　　　　　　　　　　│
│气体检测仪　│└──────────┘└──────────┘│返回　　　　　　　　　　　　│
│　　　　　　│┌────洗消────┐┌───检测仪────┐│　　　　　　　　　　　　　　│
│调试维护　　││Ａ液位：１００Ｌ　　││点火Ｓ类２级　　　　││　　　　　　　　　　　　　　│
│　　　　　　││泡沫液位：３０Ｌ　　││浓度３００ｐｐｂ　　││　　　　　　　　　　　　　　│
│　　　　　　││　　　　　　　　　　││　　　　　　　　　　││　　　　　　　　　　　　　　│
│　　　　　　│└──────────┘└──────────┘│　　　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│底盘电量：８５％　　　│底盘电压：３６０Ｖ　清水液位：１００Ｌ　泡沫液位：３０Ｌ　行车模式　│
└──────────────────────────────────────────────┘

说明：线框为结构示意（画布 1920×1080），控件精确坐标以 3.3.3 分区说明与 3.3.4 控件清单为准。

3.3.3 分区说明

区域	位置（x,y,w,h）	内容	说明
顶条	（0,0,1920,98）	通信状态／标题／时间／软急停	见 2.6
左侧菜单	（36,162,224,810）	4 个作业入口	机器人底盘／机械臂／气体检测仪／调试维护
中央卡片区	（300,162,1170,810）	4 张数据卡片	底盘、机械臂、洗消、气体检测仪；故障字段红闪
右侧按钮列	（1530,162,354,810）	手动消除／手动消毒	主色大按钮纵向排列
底部状态条	（0,986,1920,94）	电量／电压／液位／模式／返回	见 2.6；返回在此页隐藏或禁用（主菜单）

3.3.4 控件清单

ID	控件	文本/取值	位置（x,y,w,h）	初始状态	交互与样式要点
E1	菜单按钮 ×4	机器人底盘／机械臂／气体检测仪／调试维护	（36,162,224,98），间距 18	可用	图标＋文字；可被光标焦点选中
E2	DataCard ×4	底盘／机械臂／洗消／气体检测仪数据	（300,162,570,378）等	只读	500ms 刷新；故障字段红闪
E3	QPushButton	手动消除	（1530,162,354,98）	可用	主色大按钮
E4	QPushButton	手动消毒	（1530,276,354,98）	可用	主色大按钮
E5	QPushButton	返回	（1710,994,144,76）	隐藏/禁用	主菜单无上级页面
E6	QLabel 徽标	行车模式／机械臂模式	底部状态条	只读	当前模式显示

3.3.5 运行状态机

状态	可用操作	禁用/限制	提示与显示
常态	6 个入口、返回（隐藏）	—	中央数据实时刷新
故障存在	6 个入口、返回	—	对应卡片故障字段红闪

3.3.6 交互逻辑

步骤	用户操作	系统行为与结果
1	点击 6 个作业入口之一	跳转对应作业界面（⑥⑦⑧⑨⑩⑪）
2	多功能光标旋钮旋转	焦点在菜单/按钮间移动（2px 主色外框）
3	光标旋钮顶部按键	触发当前焦点控件（等同点击）
4	中央卡片数据刷新	500ms 定时器刷新；故障字段红闪
5	模式为手动消除/消毒时进入对应页	正常进入；进入后底盘/机械臂操作自动禁用

3.3.7 数据与信号绑定

字段	显示位置	数据来源（占位）	刷新/显示规则
底盘电量/电压/故障	底盘卡片	on_chassis_state	500ms；故障多条轮换红闪
机械臂末端位置/姿态	机械臂卡片	on_arm_state	500ms
洗消液位（清水/泡沫）	洗消卡片	on_tank_level	500ms
气体检测仪状态	气体检测仪卡片	on_gas_state	500ms

界面⑥　机器人底盘界面

3.4.1 功能概述

协议要求：只有在“行车/机械臂模式”切换为行车模式（当在手动消除或消毒模式时，行车/机械臂操作均无效），或进入此页面后，才可执行底盘前进、后退、左转向、右转向操作，可调整车速参数，并自动保存车速参数，下次上电开机会读取车速参数。通过屏幕左侧物理摇杆来控制，或者触摸控制底盘的行驶。

协议要求：机械臂展开或未回位状态下，控制底盘行驶会闪烁提示“机械臂未回位，请谨慎操作”。紧急状态可按下遥控屏上急停按钮，按下后切断机器人底盘动力，底盘、机械臂、洗消系统立即停止。通信状态不正常，会闪烁显示“通信异常”。警示字体都为红色。

原型布局：左列“前进／后退／左转向／右转向”4 按钮；中央洗消、机械臂、气体检测仪 3 卡片；右侧底盘状态卡＋车速设置＋返回。

3.4.2 界面布局（线框示意）

┌──────────────────────────────────────────────┐
│通信●正常　│【机器人底盘】　告警：清水液位低！　时间　急停　│　　　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│前进　　　　│┌───洗消────┐　┌───机械臂───┐　│电量ＳＯＣ：８５％　　　　　│
│后退　　　　││Ａ液位：１００Ｌ　│　│末端ＸＹＺ　　　　│　│电压Ｕ：３６０Ｖ　　　　　　│
│左转向　　　││泡沫液位：３０Ｌ　│　│姿态ＲＸ．．　　　│　│车速Ｖ：３．４５　　　　　　│
│右转向　　　││　　　　　　　　　│　│　　　　　　　　　│　│手刹：有效　　　　　　　　　│
│摇杆指示　　│└─────────┘　└─────────┘　│故障：总电压低　　　　　　　│
│　　　　　　│┌───检测仪───┐　　　　　　　　　　　　　│（故障循环）　　　　　　　　│
│　　　　　　││点火Ｓ类２级　　　│　　　　　　　　　　　　　│车速设置：４．５　　　　　　│
│　　　　　　││浓度３００ｐｐｂ　│　　　　　　　　　　　　　│－　　　＋　　　　　　　　　│
│　　　　　　││　　　　　　　　　│　　　　　　　　　　　　　│自动保存　　　　　　　　　　│
│　　　　　　│└─────────┘　　　　　　　　　　　　　│返回　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│底盘电量：８５％　　　│底盘电压：３６０Ｖ　清水液位：１００Ｌ　泡沫液位：３０Ｌ　行车模式　│
└──────────────────────────────────────────────┘

说明：线框为结构示意（画布 1920×1080），控件精确坐标以 3.4.3 分区说明与 3.4.4 控件清单为准。

3.4.3 分区说明

区域	位置（x,y,w,h）	内容	说明
顶条	（0,0,1920,98）	通信状态／标题／告警区／时间／软急停	告警区红字（液位低、通信异常等）
告警横幅	（0,114,1920,54）	机械臂未回位提示／通信异常	红字 500ms 闪烁，默认隐藏
左控制列	（36,188,180,756）	前进/后退/左转向/右转向	大按钮 180×162；含左摇杆状态指示
中央卡片区	（300,188,840,756）	洗消/机械臂/气体检测仪 3 卡片	与⑤一致，只读
右参数区	（1230,188,654,756）	底盘状态卡＋车速设置	故障循环显示；车速自动保存
底部状态条	（0,986,1920,94）	电量／电压／液位／模式徽标／返回	模式徽标显示行车/机械臂

3.4.4 控件清单

ID	控件	文本/取值	位置（x,y,w,h）	初始状态	交互与样式要点
C1	QPushButton	前进	（36,188,180,162）	行车模式可用	按住连续行驶、松开停止；按下主色反馈
C2	QPushButton	后退	（36,368,180,162）	行车模式可用	同上
C3	QPushButton	左转向	（36,546,180,162）	行车模式可用	同上
C4	QPushButton	右转向	（36,724,180,162）	行车模式可用	同上
C5	摇杆指示	左摇杆方向	（36,918,180,54）	只读	显示物理摇杆方位（图形）
C6	DataCard 底盘	电量/电压/车速/手刹/故障	（1230,188,654,404）	只读	故障多条 2s 轮换红闪
C7	ParamControl 车速	km/h，当前存储值	（1230,620,654,270）	当前值	加减步进 0.5；改动 1s 防抖自动保存
C8	QLabel 模式徽标	行车模式／机械臂模式	底部状态条	行车模式	非行车模式时 C1~C4 禁用并提示
C9	QPushButton	返回	（1710,994,144,76）	可用	→⑤作业选择

3.4.5 运行状态机

状态	可用操作	禁用/限制	提示与显示
行车模式	方向按钮／车速设置／返回	机械臂相关操作	徽标绿色“行车模式”
机械臂模式	车速设置／返回	方向按钮	徽标灰色；提示切换模式
手动消除/消毒模式	返回	方向按钮＋车速设置	提示“洗消模式下底盘不可操作”
机械臂未回位行驶中	方向按钮等	—	横幅红闪提示
通信异常	返回	其余操作	顶条红闪“通信异常”
急停触发	复位流程	全部操作	红色急停横幅

3.4.6 交互逻辑

步骤	用户操作	系统行为与结果
1	触摸按住“前进”（或左摇杆前推）	下发底盘行驶指令（方向＋车速设置值），松开停止
2	依次使用方向按钮/摇杆	前进、后退、左转向、右转向对应移动
3	非行车模式时操作方向按钮	按钮禁用；提示“请切换至行车模式”
4	机械臂未回位时行驶	告警横幅红闪“机械臂未回位，请谨慎操作”
5	调整车速（＋/－或输入）	数值更新；1s 防抖后自动保存至存储区，提示“已保存”
6	上电开机进入本页	自动读取存储区车速参数并显示
7	点击软急停或物理急停	切断底盘动力，底盘/机械臂/洗消立即停止；红色急停横幅，需人工复位
8	通信状态异常	顶条“通信异常”红闪；数据置灰保留最后有效值
9	底盘故障多条	故障区循环显示（2s/条）
10	点击返回	→⑤作业选择界面

3.4.7 数据与信号绑定

字段	显示位置	数据来源（占位）	刷新/显示规则
电量/电压/车速/手刹	底盘状态卡	on_chassis_state	500ms
底盘故障列表	底盘状态卡	faults[]	2s/条轮换，红闪
车速存储值	车速设置	stored_param('speed')	上电读取；修改自动保存
机械臂回位状态	告警横幅触发	on_arm_state.return_state	未回位时红闪横幅
清水液位	底条/告警	on_tank_level	液位低红闪

界面⑦　机械臂界面

3.5.1 功能概述

协议要求：只有在“行车/机械臂模式”切换为机械臂模式（当在手动消除或消毒模式时，行车/机械臂操作均无效），或进入此页面后，才可执行机械臂的操作。机械臂的所有手动动作，通过屏幕左、右侧摇杆来控制，或者触摸控制。

协议要求：选择“系统回位/暂停”，图标点亮，开始执行机械臂系统自动回位，回位完成显示“机械臂系统完成回位”，图标自动熄灭；若无法回位到原点则显示“机械臂系统回位异常”，并有故障提示；若在回位过程中点击“系统回位/暂停”，暂停回位，图标熄灭。机械臂相关状态以及主要基本参数等会显示在中间区域，如有故障会闪烁显示。紧急状态可按下遥控屏上急停按钮。通信状态不正常，会闪烁显示“通信异常”。在手动消除或手动消毒洗消作业过程中机械臂末端作自动俯仰摆动。

原型布局：左列“左平移／右平移／上升／下降／前平移／后平移＋系统回位/暂停”；中央 3 卡片；右侧机械臂参数卡（末端位置/姿态/速度、Joint1~6 关节角）＋末端按钮列（末端仰/俯/正偏航/负偏航/左横滚/右横滚）＋返回。

3.5.2 界面布局（线框示意）

┌──────────────────────────────────────────────┐
│通信●正常　│【机械臂】　　　　　　　　　时间　　急停　　　　│　　　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│左平移　　　│┌───底盘────┐　┌───机械臂───┐　│末端仰　　　　　　　　　　　│
│右平移　　　││电量：８５％　　　│　│末端ＸＹＺ　　　　│　│末端俯　　　　　　　　　　　│
│上升　　　　││电压：３６０Ｖ　　│　│姿态ＲＸ．．　　　│　│末端正偏航　　　　　　　　　│
│下降　　　　││故障：无　　　　　│　│　　　　　　　　　│　│末端负偏航　　　　　　　　　│
│前平移　　　│└─────────┘　└─────────┘　│末端左横滚　　　　　　　　　│
│后平移　　　│Ｊ１：３０度　Ｊ２：２０度　Ｊ３：０度　　　　　│末端右横滚　　　　　　　　　│
│　　　　　　│Ｊ４：９０度　Ｊ５：４５度　Ｊ６：０度　　　　　│　　　　　　　　　　　　　　│
│　　　　　　│末端位置ＸＹＺ　姿态ＲＸ．．　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　│┌───检测仪───┐　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　││点火Ｓ类２级　　　│　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　││浓度３００ｐｐｂ　│　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　││　　　　　　　　　│　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│　　　　　　│└─────────┘　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│系统回位　　│　　　　　　　　　　　　　　　　　　　　　　　　│　　　　　　　　　　　　　　│
│／暂停　　　│　　　　　　　　　　　　　　　　　　　　　　　　│返回　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│底盘电量：８５％　　　│底盘电压：３６０Ｖ　清水液位：１００Ｌ　泡沫液位：３０Ｌ　机械臂模式│
└──────────────────────────────────────────────┘

说明：线框为结构示意（画布 1920×1080），控件精确坐标以 3.5.3 分区说明与 3.5.4 控件清单为准。

3.5.3 分区说明

区域	位置（x,y,w,h）	内容	说明
顶条	（0,0,1920,98）	通信状态／标题／时间／软急停	见 2.6
左控制列	（36,188,180,756）	6 个运动按钮＋系统回位/暂停	前/后/左/右平移、上升/下降
中央卡片区	（300,188,840,756）	底盘/洗消/气体检测仪 3 卡片	与⑤一致，只读
右参数区	（1230,188,654,404）	机械臂参数卡	末端位置/姿态/速度＋Joint1~6
右按钮列	（1230,620,654,324）	末端 6 个姿态按钮	仰/俯/正偏航/负偏航/左横滚/右横滚
底部状态条	（0,986,1920,94）	电量／电压／液位／模式／返回	模式徽标显示

3.5.4 控件清单

ID	控件	文本/取值	位置（x,y,w,h）	初始状态	交互与样式要点
A1	QPushButton ×6	左平移/右平移/上升/下降/前平移/后平移	（36,188,180,98），间距 18	机械臂模式可用	按住连续运动、松开停止
A2	QPushButton	系统回位／暂停	（36,870,180,98）	可用	双态：图标点亮=回位中；熄灭=待机/暂停
A3	DataCard 机械臂	末端位置/姿态/速度＋Joint1~6	（1230,188,654,404）	只读	500ms 刷新；故障红闪
A4	QPushButton ×6	末端仰/俯/正偏航/负偏航/左横滚/右横滚	（1230,620,306,86）等	机械臂模式可用	按住连续运动、松开停止
A5	QLabel 徽标	行车模式／机械臂模式	底部状态条	机械臂模式	非机械臂模式时 A1/A4 禁用
A6	QPushButton	返回	（1710,994,144,76）	可用	→⑤作业选择

3.5.5 运行状态机

状态	可用操作	禁用/限制	提示与显示
机械臂模式	运动按钮／末端按钮／回位	—	徽标绿色“机械臂模式”
行车模式	系统回位／返回	运动按钮、末端按钮	提示“请切换至机械臂模式”
回位中	暂停（再次点击）	运动按钮／末端按钮	回位按钮图标点亮
回位完成	全部	—	绿字提示 3s
回位异常	全部	—	红字＋故障弹窗
洗消作业中	返回／急停	运动按钮／末端按钮	提示“洗消作业中，末端自动摆动”

3.5.6 交互逻辑

步骤	用户操作	系统行为与结果
1	触摸按住左列运动按钮（或左摇杆）	机械臂对应方向连续运动，松开停止
2	触摸末端按钮（或右摇杆）	末端姿态连续调节
3	点击“系统回位/暂停”	图标点亮，开始执行系统自动回位
4	回位完成	显示“机械臂系统完成回位”，图标自动熄灭
5	无法回位到原点	显示“机械臂系统回位异常”（红字）＋故障提示弹窗
6	回位过程中再次点击“系统回位/暂停”	暂停回位，图标熄灭
7	手动消除/消毒洗消作业中	机械臂末端自动俯仰摆动；A1/A4 禁用并提示
8	通信异常／急停	按全局规则（顶条红闪／急停横幅）

3.5.7 数据与信号绑定

字段	显示位置	数据来源（占位）	刷新/显示规则
关节角 1~6	机械臂参数卡	on_arm_state.js[]	500ms
末端位置/姿态/速度	机械臂参数卡	on_arm_state	500ms
回位状态	回位按钮＋横幅	return_state	待机/回位中/完成/异常
洗消作业标志	提示与禁用	cmd_wash 状态	作业中禁用手动

界面⑧　气体检测仪界面

3.6.1 功能概述

协议要求：此页面启动气体检测仪工作，检测仪当前状态、检测结果以及底盘电量电压和液位基本参数等会显示在中间区域，如有故障会闪烁显示。通过触摸控制，或者物理旋钮结合界面中图标光标来控制。

原型布局：中央 4 张卡片（底盘、洗消、机械臂、气体检测仪），气体检测仪卡含主机状态、有毒物种类、有毒物等级、有毒物浓度（ppb）；右侧“启动／停机／返回”按钮。

3.6.2 界面布局（线框示意）

┌──────────────────────────────────────────────┐
│通信●正常　│【气体检测仪】　　　　　　时间　　急停　　　　　│　　　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│　　　　　　│┌───底盘────┐　┌───洗消────┐　│启动　　　　　　　　　　　　│
│　　　　　　││电量：８５％　　　│　│Ａ液位：１００Ｌ　│　│停机　　　　　　　　　　　　│
│　　　　　　││电压：３６０Ｖ　　│　│泡沫液位：３０Ｌ　│　│返回　　　　　　　　　　　　│
│　　　　　　││故障：无　　　　　│　│　　　　　　　　　│　│　　　　　　　　　　　　　　│
│　　　　　　│└─────────┘　└─────────┘　│　　　　　　　　　　　　　　│
│　　　　　　│┌───检测仪───┐　┌───机械臂───┐　│　　　　　　　　　　　　　　│
│　　　　　　││点火Ｓ类２级　　　│　│末端ＸＹＺ　　　　│　│　　　　　　　　　　　　　　│
│　　　　　　││浓度３００ｐｐｂ　│　│姿态ＲＸ．．　　　│　│　　　　　　　　　　　　　　│
│　　　　　　││　　　　　　　　　│　│　　　　　　　　　│　│　　　　　　　　　　　　　　│
│　　　　　　│└─────────┘　└─────────┘　│　　　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│底盘电量：８５％　　　│底盘电压：３６０Ｖ　清水液位：１００Ｌ　泡沫液位：３０Ｌ　检测模式　│
└──────────────────────────────────────────────┘

说明：线框为结构示意（画布 1920×1080），控件精确坐标以 3.6.3 分区说明与 3.6.4 控件清单为准。

3.6.3 分区说明

区域	位置（x,y,w,h）	内容	说明
顶条	（0,0,1920,98）	通信状态／标题／时间／软急停	见 2.6
中央卡片区	（300,162,1170,810）	底盘/洗消/机械臂/气体检测仪 4 卡	气体检测仪卡加主色描边突出
浓度大字	气体检测仪卡内	有毒物浓度（ppb）	56px 加粗大数字
右侧按钮列	（1530,162,354,810）	启动／停机／返回	启动主色、停机普通、返回底部
底部状态条	（0,986,1920,94）	电量／电压／液位／模式／返回	见 2.6

3.6.4 控件清单

ID	控件	文本/取值	位置（x,y,w,h）	初始状态	交互与样式要点
G1	DataCard ×4	底盘/洗消/机械臂/气体检测仪	（300,162,570,378）等	只读	500ms 刷新；故障红闪
G2	QLabel 浓度	有毒物浓度	气体检测仪卡内	—	56px 加粗；超阈值红闪
G3	QPushButton	启动	（1530,162,354,98）	待机可用	主色；检测中禁用
G4	QPushButton	停机	（1530,276,354,98）	检测中可用	普通色；待机禁用
G5	QPushButton	返回	（1710,994,144,76）	可用	→⑤作业选择；检测中返回弹提示

3.6.5 运行状态机

状态	可用操作	禁用/限制	提示与显示
待机	启动／返回	停机	状态“待机”
检测中	停机／返回	启动	状态“检测中”绿点
故障/超阈值	停机／返回	启动	字段红闪

3.6.6 交互逻辑

步骤	用户操作	系统行为与结果
1	点击“启动”	下发启动指令；状态“检测中”；启动禁用、停机可用
2	检测中	主机状态、有毒物种类、等级、浓度实时刷新（500ms）
3	点击“停机”	下发停机指令；状态“待机”；停机禁用、启动可用
4	检测中点击“返回”	弹窗提示“检测仍在进行，是否退出？”；确认退出、取消留在本页【设计建议】
5	浓度超阈值/故障	对应字段红闪，顶条告警
6	通信异常／急停	按全局规则

3.6.7 数据与信号绑定

字段	显示位置	数据来源（占位）	刷新/显示规则
主机状态	气体检测仪卡	on_gas_state.hostState	待机/检测中/故障
有毒物种类/等级	气体检测仪卡	on_gas_state	500ms
有毒物浓度	浓度大字	on_gas_state.conc	500ms；超阈值红闪
底盘电量/电压/液位	底盘卡/底条	on_chassis_state/on_tank_level	500ms

界面⑨　手动消除界面

3.7.1 功能概述

协议要求：进入此页面后，机器人底盘和机械臂的所有手动操作均无效，在洗消过程中机械手自动摆动。紧急状态可按下遥控屏上急停按钮。通过触摸控制，或者物理旋钮结合界面中图标光标来控制。此页面点击“启动”手动消除后，只有主动点击“停止”后，点击“返回”才能退出此页面返回到作业选择页面，否则“返回”操作无效。

协议要求：通过光标选择旋钮和参数设置旋钮，可以手动调整柱塞泵流量参数（出厂值为 20），调整完参数可选择保存，每次上电开机会自动读取存储区参数值；当点击“恢复出厂值”时，出厂值会覆盖存储区参数值。运行时流量、压力等实时显现在中间画面中。柱塞泵、空压机、叶片泵是否上电，电动球阀 D1/D2 是否开启，通过相应指示灯表示，指示灯绿色表示运行或开启，灰色表示未运行或关闭；液位是否正常，有无系统故障，指示灯红色闪烁表示液位低或系统有故障，灰色表示正常；通信状态不正常，会闪烁显示“通信异常”。空压机故障代码、柱塞泵故障代码轮流循环显示。

原型布局：左侧底盘/机械臂/气体检测仪 3 卡片；中央洗消参数卡（洗消模式、液位、A/B 药剂流量、气体流量、管路/空压机压力、发泡倍数、故障代码）；右侧启动/停止、柱塞泵流量设置（保存）、返回；底部指示灯条（启停、柱塞泵、空压机、叶片泵、液位低、D1、D2、系统故障）＋恢复出厂值。

3.7.2 界面布局（线框示意）

┌──────────────────────────────────────────────┐
│通信●正常　　　　　　　│【手动消除】　　　　　　　　　　　　│时间　　急停　　　　　　　　│
├──────────────────────────────────────────────┤
│┌────底盘────┐│┌────洗消（手动消除）────┐│启动　　　　　　　　　　　　│
││电量：８５％　　　　│││洗消模式：手动消除　　　　　　　││停止　　　　　　　　　　　　│
││电压：３６０Ｖ　　　│││Ａ组分液位：１００Ｌ　　　　　　││柱塞泵流量　　　　　　　　　│
││故障：无　　　　　　│││泡沫箱液位：３０Ｌ　　　　　　　││２０Ｌ／ｍｉｎ　　　　　　　│
│└──────────┘││Ａ药剂流量：２０Ｌ／ｍｉｎ　　　││－　　　＋　　　　　　　　　│
│┌───机械臂────┐││Ｂ药剂流量：０．５Ｌ／ｍｉｎ　　││保存　　　　　　　　　　　　│
││末端ＸＹＺ　　　　　│││气体流量：１００Ｌ／ｍｉｎ　　　││返回　　　　　　　　　　　　│
││姿态ＲＸ．．　　　　│││管路压力：０．３ＭＰａ　　　　　││　　　　　　　　　　　　　　│
││　　　　　　　　　　│││空压机压力：０．３５ＭＰａ　　　││　　　　　　　　　　　　　　│
│└──────────┘││发泡倍数：８　　　　　　　　　　││　　　　　　　　　　　　　　│
│┌───检测仪────┐││空压机故障代码：　　　　　　　　││　　　　　　　　　　　　　　│
││点火Ｓ类２级　　　　│││柱塞泵故障代码：　　　　　　　　││　　　　　　　　　　　　　　│
││浓度３００ｐｐｂ　　│││　　　　　　　　　　　　　　　　││　　　　　　　　　　　　　　│
││　　　　　　　　　　│││　　　　　　　　　　　　　　　　││　　　　　　　　　　　　　　│
│└──────────┘│└────────────────┘│　　　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│恢复出厂值　　　　　　│启停●柱塞泵●空压机●叶片泵●液位低●Ｄ１●Ｄ２●系统故障●　　　　│
└──────────────────────────────────────────────┘

说明：线框为结构示意（画布 1920×1080），控件精确坐标以 3.7.3 分区说明与 3.7.4 控件清单为准。

3.7.3 分区说明

区域	位置（x,y,w,h）	内容	说明
顶条	（0,0,1920,98）	通信状态／标题／时间／软急停	见 2.6
左状态卡	（36,162,224,810）	底盘/机械臂/气体检测仪 3 卡片	只读，与⑤一致
中央洗消卡	（300,162,1170,810）	洗消模式/液位/流量/压力/发泡倍数/故障代码	实时刷新；故障代码轮流显示
右操作列	（1530,162,354,810）	启动/停止、柱塞泵流量设置、返回	运行中返回无效
底部指示灯条	（0,986,1920,94）	8 个指示灯＋恢复出厂值	绿=运行/开启；灰=未运行/关闭；红闪=液位低/系统故障

3.7.4 控件清单

ID	控件	文本/取值	位置（x,y,w,h）	初始状态	交互与样式要点
W1	QPushButton	启动	（1530,162,354,98）	待机可用	主色；下发 cmd_wash_start
W2	QPushButton	停止	（1530,276,354,98）	运行中可用	危险色；下发 cmd_wash_stop
W3	ParamControl	柱塞泵流量 L/min	（1530,404,354,296）	存储值	加减步进 0.5；保存按钮；出厂值 20
W4	QPushButton	恢复出厂值	（36,1004,270,64）	可用	确认弹窗后覆盖存储区
W5	LedIndicator ×8	启停/柱塞泵/空压机/叶片泵/液位低/D1/D2/系统故障	底部条	灰	语义见分区说明
W6	QLabel 故障代码	空压机/柱塞泵故障代码	中央洗消卡	空	多条 2s 轮流循环显示
W7	QPushButton	返回	（1710,994,144,76）	待机可用	运行中点击提示“请先停止”；停止后可用

3.7.5 运行状态机

状态	可用操作	禁用/限制	提示与显示
待机（未运行）	启动、参数设置、保存、恢复出厂值、返回	停止	启动可用；返回可用
运行中	停止、参数设置、保存	启动、返回	返回无效并提示；机械手自动摆动
停止后	启动、返回、参数设置	停止	返回恢复可用

3.7.6 交互逻辑

步骤	用户操作	系统行为与结果
1	点击“启动”	进入运行状态：启动禁用、停止可用、返回无效；机械手自动摆动；实时数据刷新
2	运行中点击“返回”	无效，提示“请先停止”
3	点击“停止”	停止洗消：停止禁用、启动可用、返回恢复可用
4	调整柱塞泵流量（旋钮/＋－）	数值更新；点击“保存”→写入存储区，提示“已保存”
5	点击“恢复出厂值”	确认弹窗→出厂值 20 覆盖存储区参数并显示
6	上电开机	自动读取存储区柱塞泵流量参数
7	故障代码多条	空压机/柱塞泵故障代码轮流循环显示（2s/条）
8	指示灯刷新	绿=运行/开启，灰=未运行/关闭，红闪=液位低/系统故障，灰=正常
9	通信异常	顶条红闪“通信异常”
10	急停	按全局规则，全系统停止

3.7.7 数据与信号绑定

字段	显示位置	数据来源（占位）	刷新/显示规则
洗消模式/液位/流量/压力/发泡倍数	中央洗消卡	on_wash_state/on_tank_level	500ms
泵上电/球阀状态	底部指示灯	on_pump_state/on_ball_valve_state	绿/灰/红闪
故障代码	中央洗消卡	faults[]	2s 轮流循环显示
柱塞泵流量存储值	W3	stored_param('pump_flow')	出厂 20；上电读取；保存写回

界面⑩　手动消毒界面

3.8.1 功能概述

协议要求：进入此页面后，机器人底盘和机械臂的所有手动操作均无效，在洗消过程中机械手自动摆动。紧急状态可按下遥控屏上急停按钮。通过触摸控制，或者物理旋钮结合界面中图标光标来控制。此页面点击“启动”后，只有主动点击“停止”后，点击“返回”才能退出此页面返回到作业选择页面，否则“返回”操作无效。

协议要求：通过光标选择旋钮和参数设置旋钮，可以手动调整发泡倍数参数（出厂值 6）、泡沫比例参数（出厂值 3%）及空压机流量参数（出厂值 100），调整完参数可选择保存，每次上电开机会自动读取存储区参数值；当点击“恢复出厂值”时，出厂值会覆盖存储区参数值。运行时流量、压力、发泡倍数等实时显现在中间画面中。指示灯语义、故障代码轮流显示与界面⑨一致。

原型布局：与⑨一致，右侧参数区为发泡倍数（6 倍）、泡沫比例（3%）、空压机流量（100L/min）三个参数卡，各带保存；中央洗消卡含发泡倍数显示。

3.8.2 界面布局（线框示意）

┌──────────────────────────────────────────────┐
│通信●正常　　　　　　　│【手动消毒】　　　　　　　　　　　　│时间　　急停　　　　　　　　│
├──────────────────────────────────────────────┤
│┌────底盘────┐│┌────洗消（手动消毒）────┐│启动　　　　　　　　　　　　│
││电量：８５％　　　　│││洗消模式：手动消毒　　　　　　　││停止　　　　　　　　　　　　│
││电压：３６０Ｖ　　　│││Ａ组分液位：１００Ｌ　　　　　　││发泡倍数　　　　　　　　　　│
││故障：无　　　　　　│││泡沫箱液位：３０Ｌ　　　　　　　││６倍　　　　　　　　　　　　│
│└──────────┘││Ａ药剂流量：２０Ｌ／ｍｉｎ　　　││－　　　＋　　　　　　　　　│
│┌───机械臂────┐││Ｂ药剂流量：０．５Ｌ／ｍｉｎ　　││保存　　　　　　　　　　　　│
││末端ＸＹＺ　　　　　│││气体流量：１００Ｌ／ｍｉｎ　　　││泡沫比例　　　　　　　　　　│
││姿态ＲＸ．．　　　　│││管路压力：０．３ＭＰａ　　　　　││３％　　　　　　　　　　　　│
││　　　　　　　　　　│││空压机压力：０．３５ＭＰａ　　　││－　　　＋　　　　　　　　　│
│└──────────┘││发泡倍数：６　　　　　　　　　　││保存　　　　　　　　　　　　│
│┌───检测仪────┐││空压机故障代码：　　　　　　　　││空压机流量　　　　　　　　　│
││点火Ｓ类２级　　　　│││柱塞泵故障代码：　　　　　　　　││１００Ｌ／ｍｉｎ　　　　　　│
││浓度３００ｐｐｂ　　│││　　　　　　　　　　　　　　　　││－　　　＋　　　　　　　　　│
││　　　　　　　　　　│││　　　　　　　　　　　　　　　　││保存　　　　　　　　　　　　│
│└──────────┘│└────────────────┘│返回　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│恢复出厂值　　　　　　│启停●柱塞泵●空压机●叶片泵●液位低●Ｄ１●Ｄ２●系统故障●　　　　│
└──────────────────────────────────────────────┘

说明：线框为结构示意（画布 1920×1080），控件精确坐标以 3.8.3 分区说明与 3.8.4 控件清单为准。

3.8.3 分区说明

区域	位置（x,y,w,h）	内容	说明
顶条	（0,0,1920,98）	通信状态／标题／时间／软急停	见 2.6
左状态卡	（36,162,224,810）	底盘/机械臂/气体检测仪 3 卡片	只读
中央洗消卡	（300,162,1170,810）	洗消模式/液位/流量/压力/发泡倍数/故障代码	实时刷新
右操作列	（1530,162,354,810）	启动/停止＋3 个参数卡＋返回	运行中返回无效
底部指示灯条	（0,986,1920,94）	8 个指示灯＋恢复出厂值	同⑨

3.8.4 控件清单

ID	控件	文本/取值	位置（x,y,w,h）	初始状态	交互与样式要点
S1	QPushButton	启动	（1530,162,354,98）	待机可用	主色
S2	QPushButton	停止	（1530,276,354,98）	运行中可用	危险色
S3	ParamControl	发泡倍数（倍）	（1530,404,354,178）	存储值	出厂 6；加减步进 0.5；保存
S4	ParamControl	泡沫比例（%）	（1530,600,354,178）	存储值	出厂 3；加减步进 0.5；保存
S5	ParamControl	空压机流量（L/min）	（1530,794,354,178）	存储值	出厂 100；加减步进 1；保存
S6	QPushButton	恢复出厂值	（36,1004,270,64）	可用	确认后三个参数全部恢复出厂值
S7	LedIndicator ×8	启停/柱塞泵/空压机/叶片泵/液位低/D1/D2/系统故障	底部条	灰	同⑨
S8	QPushButton	返回	（1710,994,144,76）	待机可用	运行中提示“请先停止”

3.8.5 运行状态机

状态	可用操作	禁用/限制	提示与显示
待机（未运行）	启动、参数设置、保存、恢复出厂值、返回	停止	启动可用；返回可用
运行中	停止、参数设置、保存	启动、返回	返回无效并提示
停止后	启动、返回、参数设置	停止	返回恢复可用

3.8.6 交互逻辑

步骤	用户操作	系统行为与结果
1	点击“启动”	进入运行状态：启动禁用、停止可用、返回无效；机械手自动摆动
2	运行中点击“返回”	无效，提示“请先停止”
3	点击“停止”	停止洗消：返回恢复可用
4	分别调整发泡倍数/泡沫比例/空压机流量	数值更新；各自“保存”→写入存储区
5	点击“恢复出厂值”	确认弹窗→发泡倍数 6、泡沫比例 3%、空压机流量 100 覆盖存储区
6	上电开机	自动读取三个参数存储值
7	故障代码/指示灯/通信异常/急停	同⑨规则

3.8.7 数据与信号绑定

字段	显示位置	数据来源（占位）	刷新/显示规则
洗消实时数据	中央洗消卡	on_wash_state/on_tank_level	500ms
泵/球阀/液位/故障指示	底部指示灯	on_pump_state/on_ball_valve_state	绿/灰/红闪
发泡倍数存储值	S3	stored_param('foam_ratio')	出厂 6
泡沫比例存储值	S4	stored_param('foam_percent')	出厂 3
空压机流量存储值	S5	stored_param('air_flow')	出厂 100

界面⑪　调试维护界面

3.9.1 功能概述

协议要求：在调试维护页面，可查看当前各个部件的信号和状态，可以单独控制电动球阀 D1/D2、柱塞泵、空压机、叶片泵等的动作和运行，调整转速参数，显示当前流量和压力。通过触摸控制，或者物理按键旋钮结合界面中图标光标来控制。紧急状态可按下遥控屏上急停按钮。操作时闪烁提示红色文字：“警告：该模式下无保护功能，操作请谨慎！”。

协议要求（球阀图标逻辑）：D1 上侧图标用于表示控制电动球阀 D1 开启或关闭，初始为灰色，选中后显示绿色，表示控制 D1 开启；下左图标用于表示 D1 开启是否到位，初始为灰色，显示绿色表示 D1 开启到位；下右图标用于表示 D1 关闭是否到位，初始为红色，表示 D1 处在关闭到位状态；当控制 D1 开启时关闭到位图标正常情况应由红色变为灰色，若收到总线上关于 D1 开启故障信息，则发出“D1开启故障”闪烁提示。开启与关闭图标取消选中后由绿色变为灰色，此时控制 D1 关闭，开启到位图标正常情况应由绿色变为灰色，若收到总线上关于 D1 关闭故障信息，则发出“D1关闭故障”闪烁提示。D2 图标含义与 D1 一致。

协议要求：空压机/柱塞泵/叶片泵右侧图标选中后显示绿色，表示控制相应接触器上电。空压机/柱塞泵/叶片泵转速手动设置调整，作为调试临时值，不保存。液位、流量、压力值在调试时实时显示在界面中。

原型布局：左侧 D1/D2 区；中央底盘/机械臂/气体检测仪卡片＋洗消参数卡；右侧空压机/柱塞泵/叶片泵转速与启停；底部警告横幅＋指示灯＋返回。

3.9.2 界面布局（线框示意）

┌──────────────────────────────────────────────┐
│通信●正常　　　│【洗消调试】　　　　　时间　　急停　　　　　　　│　　　　　　　　　　　　│
│　　　　　　　　│警告：该模式下无保护功能，操作请谨慎！（红闪）　│　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│Ｄ１上：开／关　│┌───────洗消（手动消毒）───────┐│空压机３００ｒｐｍ　　　│
│Ｄ１下左：到位　││洗消模式：手动消毒　　　　　　　　　　　　　││－　　　＋　　　　　　　│
│Ｄ１下右：到位　││Ａ组分液位：１００Ｌ　　　　　　　　　　　　││启动　　停止　　　　　　│
│Ｄ２上：开／关　││Ａ药剂流量：２０Ｌ／ｍｉｎ　　　　　　　　　││　　　　　　　　　　　　│
│Ｄ２下左：到位　││管路压力：０．３ＭＰａ　　　　　　　　　　　││柱塞泵２００ｒｐｍ　　　│
│Ｄ２下右：到位　││发泡倍数：８　　　　　　　　　　　　　　　　││－　　　＋　　　　　　　│
│　　　　　　　　││空压机故障代码：　　　　　　　　　　　　　　││启动　　停止　　　　　　│
│　　　　　　　　││柱塞泵故障代码：　　　　　　　　　　　　　　││　　　　　　　　　　　　│
│　　　　　　　　││　　　　　　　　　　　　　　　　　　　　　　││叶片泵２００ｒｐｍ　　　│
│　　　　　　　　│└──────────────────────┘│返回　　　　　　　　　　│
├──────────────────────────────────────────────┤
│柱塞泵●　　　　　　　│空压机●　叶片泵●　液位低●　（绿＝上电，红闪＝液位低）　　　　　　│
└──────────────────────────────────────────────┘

说明：线框为结构示意（画布 1920×1080），控件精确坐标以 3.9.3 分区说明与 3.9.4 控件清单为准。

3.9.3 分区说明

区域	位置（x,y,w,h）	内容	说明
顶条	（0,0,1920,98）	通信状态／标题／时间／软急停	见 2.6
警告横幅	（0,114,1920,54）	红色警告文字	500ms 闪烁常显
左球阀控制区	（36,188,224,756）	D1/D2 各 3 个图标	上=控制开/关、下左=开启到位、下右=关闭到位
中央卡片区	（300,188,840,756）	底盘/机械臂/气体检测仪 mini 卡＋洗消参数卡	液位/流量/压力实时显示
右泵控制区	（1230,188,654,756）	空压机/柱塞泵/叶片泵转速＋启停	转速为临时值不保存；上电图标选中=接触器上电
底部指示条	（0,986,1920,94）	柱塞泵/空压机/叶片泵/液位低指示灯＋返回	见 2.6

3.9.4 控件清单

ID	控件	文本/取值	位置（x,y,w,h）	初始状态	交互与样式要点
T1	图标按钮 ×2	D1/D2 上侧（控制开/关）	左球阀区	灰	选中绿=控制开启；再点取消=控制关闭
T2	图标 ×2	D1/D2 下左（开启到位）	左球阀区	灰	开启到位变绿
T3	图标 ×2	D1/D2 下右（关闭到位）	左球阀区	红	关闭到位初始红；开启过程中红→灰
T4	图标按钮 ×3	空压机/柱塞泵/叶片泵上电	右泵控制区	灰	选中绿=接触器上电
T5	ParamControl ×3	转速（rpm）	右泵控制区	默认值	步进 10；临时值不保存
T6	QLabel 警告	警告：该模式下无保护功能，操作请谨慎！	警告横幅	常显	红字 500ms 闪烁
T7	QPushButton	返回	（1710,994,144,76）	可用	→⑤作业选择

3.9.5 运行状态机

状态	可用操作	禁用/限制	提示与显示
调试中（正常）	全部控制按钮	—	警告横幅红闪
D1/D2 开启故障	全部	故障球阀操作	“D1开启故障”红闪提示
D1/D2 关闭故障	全部	故障球阀操作	“D1关闭故障”红闪提示
急停触发	复位	全部	急停横幅

3.9.6 交互逻辑

步骤	用户操作	系统行为与结果
1	点击 D1 上侧图标（选中）	图标变绿→发送 D1 开启指令；开启到位图标应由灰变绿、关闭到位图标应由红变灰；若收到 D1 开启故障信息→“D1开启故障”红色闪烁提示
2	再次点击 D1 上侧图标（取消选中）	图标变灰→发送 D1 关闭指令；开启到位图标应由绿变灰、关闭到位图标变红；若收到 D1 关闭故障信息→“D1关闭故障”红色闪烁提示
3	D2 图标操作	与 D1 完全一致
4	点击泵上电图标	选中绿=相应接触器上电；取消=断电
5	调整泵转速（＋/－）	作为调试临时值实时下发，不保存；重启恢复默认
6	液位/流量/压力显示	调试期间实时刷新
7	任意操作时	警告横幅红色闪烁常显
8	急停	按全局规则

3.9.7 数据与信号绑定

字段	显示位置	数据来源（占位）	刷新/显示规则
球阀状态与到位	左球阀区	on_ball_valve_state	开/关控制、到位反馈、故障红闪
泵上电状态	右泵控制区	on_pump_state	选中绿=上电
转速临时值	右泵控制区	set_speed_rpm	不保存
液位/流量/压力	中央卡片	on_wash_state/on_tank_level	实时刷新

界面⑫　故障查询界面

3.10.1 功能概述

协议要求：在故障查询页面，可查看历史故障汇总，也可单独查询各个分系统故障。

原型布局：顶部标题“历史故障”（筛选后变为“XX历史故障”）；表格列：序号、故障时间、故障名称，每页 6 条；右上角“上一页／下一页”；右侧分类按钮：机器人底盘故障、机械臂故障、洗消系统故障、气体检测仪故障；右下角“返回”。

3.10.2 界面布局（线框示意）

┌──────────────────────────────────────────────┐
│历史故障（共１８条）│上一页　　下一页　　　　　　　　　　　　　　　　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│　序号　　故障时间　　　　　故障名称　　　　　　　　　　　　　　　│机器人底盘故障　　　　　│
│　１　　２０２６－０５－１６　１０：０８　底盘电量低　　　　　　　│机械臂故障　　　　　　　│
│　２　　２０２６－０５－１６　０９：５８　底盘电机温度高　　　　　│洗消系统故障　　　　　　│
│　３　　２０２６－０５－１５　０９：０８　机械臂通信故障　　　　　│气体检测仪故障　　　　　│
│　４　　２０２６－０５－１４　０９：５８　机械臂自检故障　　　　　│　　　　　　　　　　　　│
│　５　　２０２６－０５－１３　０９：０８　清水液位低　　　　　　　│　　　　　　　　　　　　│
│　６　　２０２６－０５－１３　０８：１８　药剂液位低　　　　　　　│　　　　　　　　　　　　│
├──────────────────────────────────────────────┤
│页码：１／３　　　　│返回　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　│
└──────────────────────────────────────────────┘

说明：线框为结构示意（画布 1920×1080），控件精确坐标以 3.10.3 分区说明与 3.10.4 控件清单为准。

3.10.3 分区说明

区域	位置（x,y,w,h）	内容	说明
顶条	（0,0,1920,98）	标题（历史故障/XX历史故障）＋汇总数	顶部左侧显示总条数【设计建议】
分页按钮	右上角	上一页／下一页	边界禁用
表格区	（36,162,1350,810）	序号/故障时间/故障名称	每页 6 行，行高 80px
分类按钮列	（1440,162,444,540）	4 个分系统分类按钮	单选筛选；再点取消=全部【设计建议】
底部	（36,986,1848,94）	页码＋返回	返回→来源页面

3.10.4 控件清单

ID	控件	文本/取值	位置（x,y,w,h）	初始状态	交互与样式要点
F1	QLabel 标题/汇总	历史故障（共 N 条）	（36,28,600,54）	全部	筛选后标题变“XX历史故障”
F2	QPushButton	上一页	（1560,28,164,64）	首页禁用	翻页
F3	QPushButton	下一页	（1740,28,164,64）	末页禁用	翻页
F4	QTableWidget	序号/故障时间/故障名称	（36,162,1350,810）	6 行	行高 80px；斑马纹；点击行弹详情
F5	QPushButton ×4	机器人底盘故障/机械臂故障/洗消系统故障/气体检测仪故障	（1440,162,444,98），间距 18	全部选中态	选中主色描边
F6	QLabel 页码	１／３	（36,1004,300,54）	—	当前页/总页数
F7	QPushButton	返回	（1710,994,144,76）	可用	→来源页面（④或⑤）

3.10.5 交互逻辑

步骤	用户操作	系统行为与结果
1	默认进入	显示全部历史故障（汇总计数）；标题“历史故障”
2	点击分类按钮“气体检测仪故障”	表格筛选为气体检测仪故障记录；标题变“气体检测仪历史故障”；再点取消筛选【设计建议】
3	点击上一页/下一页	按 6 条/页翻页；首页上一页禁用、末页下一页禁用
4	点击某条记录	弹窗显示详情（故障时间、分系统、故障代码、故障描述）【设计建议】
5	空数据	表格区居中灰字“暂无故障记录”
6	点击返回	返回来源页面（从④自检进入→回自检；从⑤作业选择进入→回⑤）【设计建议】

3.10.6 数据与信号绑定

字段	显示位置	数据来源（占位）	刷新/显示规则
全部/分系统筛选	表格	本地故障库 + 分类过滤	单选筛选
分页	页码/按钮	每页 6 条	首页/末页边界禁用
故障记录写入	表格数据源	通信层故障信号写入本地存储	含时间、系统、代码、描述
故障汇总计数	顶条	按系统统计	进入页面时刷新

4　公共组件设计

4.1　TitleBar（顶条组件）

表4-1　TitleBar

项	设计
组成	通信状态标签、页面标题、时间、软急停按钮（可选显示）
尺寸	全宽 1920×98，位于 y=0
接口	setTitle(text)、setCommState(ok)、setEstopVisible(bool)、signal: estopClicked
样式	背景 #242E3A，下边框 1px #3D4A59；标题 28px 黑体居中；通信异常时红字闪烁

4.2　StatusStrip（底部状态条）

表4-2　StatusStrip

项	设计
组成	底盘电量、底盘电压、清水液位、泡沫液位迷你指示 + 模式徽标 + 返回按钮
尺寸	全宽 1920×94，位于 y=986
接口	setBattery(soc)、setVoltage(v)、setLevel(a, f)、setMode(mode)、signal: backClicked
样式	背景 #242E3A，上边框 1px #3D4A59；数值异常红闪

4.3　LedIndicator（指示灯）

表4-3　LedIndicator

项	设计
组成	圆形指示点 32×32 + 右侧文字标签 22px
状态	灰（#56636F）/绿（#36C75A）/红（#E5484D）/红闪（500ms）
接口	setState(State)、setText(text)；State 枚举 OFF/GREEN/RED/RED_BLINK
实现	QWidget 自绘 paintEvent 绘制圆形渐变 + 外发光；闪烁用 QTimer

4.4　NumPadDialog（数字键盘弹窗）

表4-4　NumPadDialog

项	设计
组成	半透明遮罩 + 键盘面板：顶部输入回显、4 列×3 行数字键（1-9、0）、退格、清除
尺寸	键盘面板 960×486，居中弹出
接口	setMaxLen(n)；signal: confirm(str)；cancel()
样式	面板 #242E3A、按键 130×98 圆角 12px、数字键主文字 36px

4.5　ConfirmDialog（确认弹窗）

表4-5　ConfirmDialog

项	设计
组成	标题 + 正文 + “确认/取消”按钮
尺寸	560×260 居中
接口	static show(par, title, text)；signal: accepted/rejected
样式	遮罩 #00000066；确认按钮主色、取消按钮普通

4.6　AlarmBanner（告警横幅）

表4-6　AlarmBanner

项	设计
组成	整行红色文字，支持 500ms 闪烁
接口	showAlarm(text)、clear()
样式	文字 #E5484D、26px 加粗、居中；闪烁=可见性交替

4.7　ParamControl（参数调节控件）

表4-7　ParamControl

项	设计
组成	参数名 + 大数值显示（56px）+ 减/加按钮 + 保存按钮（可选）+ 恢复出厂值按钮（可选）
接口	setValue(v)、setStep(s)、setRange(min,max)；signal: valueChanged、saveClicked、factoryResetClicked
样式	数值主文字加粗 56px；加减按钮 96×96 圆角 12px

4.8　DataCard（数据卡片）

表4-8　DataCard

项	设计
组成	标题栏（32px）+ 若干“标签：值”行
接口	setTitle(t)；setField(i, value)；setAlarm(field, bool)
样式	面板背景、圆角 12px、2px 边框；标签次文字 22px、值主文字 26px 加粗；故障字段红闪

4.9　FaultTable（故障分页表格）

表4-9　FaultTable

项	设计
组成	表头（序号/故障时间/故障名称）+ 数据行 + 上一页/下一页 + 页码指示
尺寸	每页 6 行，行高 54px
接口	setData(list)、setPage(p)、signal: pageChanged、rowClicked(index)
样式	表头 #2D3947、斑马纹 #2A3442、选中行主色 15% 叠加

5　数据与通信接口约定

遥控端与车载端经 CAN 总线通信，具体报文 ID、帧格式与解析规则以《洗消机器人遥控器通信协议0708》为准。本文档给出 UI 层需要绑定的信号占位清单，开发时由通信层实现同名回调（C++ 用信号槽 / PySide6 用 Signal）。

表5-1　UI 层信号占位清单（待与通信协议0708核对）

占位信号	方向	数据类型/单位	用途（绑定界面）	备注
on_comm_state(ok)	车载端→UI	bool	顶条通信状态、全页“通信异常”闪烁	心跳/握手判定
on_chassis_state(soc, volt, speed, handbrake, faults)	车载端→UI	int% / V / km/h / bool / list	⑤⑥⑧⑨⑩底盘电量电压车速、手刹、底盘故障循环显示	faults 多条 2s 轮换
on_arm_state(js[], pos, pose, vel, return_state)	车载端→UI	角度°/ mm / 姿态 / 状态枚举	⑦机械臂状态、关节角、回位状态	return_state: 待机/回位中/完成/异常
on_wash_state(flowA, flowB, gasFlow, press, airPress, foam)	车载端→UI	L/min / MPa	⑨⑩⑪洗消实时流量压力发泡倍数
on_tank_level(aLevel, foamLevel)	车载端→UI	L	⑤⑥⑧⑨⑩⑪液位显示与液位低告警
on_gas_state(hostState, gasType, gasLevel, conc)	车载端→UI	状态/类型/等级/ppb	⑧气体检测仪状态与浓度
on_ball_valve_state(d1Open, d1Close, d2Open, d2Close, fault)	车载端→UI	bool ×4 / 故障码	④自检、⑨⑩⑪球阀状态与故障	开启到位/关闭到位
on_pump_state(pump, air, leaf, faults)	车载端→UI	bool ×3 / 故障码[]	⑨⑩⑪泵上电指示、故障代码轮流显示
on_estop(triggered)	车载端→UI	bool	全页急停横幅
set_ball_valve(d, open)	UI→车载端	D1/D2 + bool	⑪调试维护、⑨⑩启停
set_pump_power(pump, on)	UI→车载端	枚举 + bool	⑨⑩⑪泵上电控制
set_speed_rpm(pump, rpm)	UI→车载端	int	⑪转速临时设定	不保存
cmd_wash_start()/stop()	UI→车载端	—	⑨⑩启动/停止
cmd_arm_return()/pause()	UI→车载端	—	⑦系统回位/暂停
cmd_chassis_move(dir, speed)	UI→车载端	方向 + km/h	⑥行驶控制
cmd_estop()	UI→车载端	—	软急停	与物理急停同指令【设计建议】
stored_param(key)→value / save_param(key, value)	UI↔存储区	int/float	车速、柱塞泵流量、发泡倍数、泡沫比例、空压机流量、密码	上电读取，保存防抖

6　待确认事项清单

表6-1　待确认事项清单

序号	事项	协议现状	建议方案
1	密码管理登录的管理员密码	协议未说明	初始与管理密码一致为“6789”，可后续修改
2	密码连续错误锁定策略	未说明	连续错 5 次锁定 30 秒并提示
3	自检异常后“忽略故障”是否允许进入作业	原型有“忽略故障”按钮，协议未说明	允许进入，异常项持续闪烁提示
4	⑫故障查询的进入入口	原型仅自检页有“故障查询”按钮	自检页 + 作业选择页各设一个入口
5	故障历史是否支持手动清除	未说明	预留“清空历史”按钮，默认隐藏
6	⑧气体检测仪检测中可否返回	未说明	允许返回，检测状态后台保持，返回前弹提示
7	软急停与物理急停的关系	协议要求急停切断底盘动力	软急停发送同一急停指令，需人工复位
8	洗消参数存储区定义	未说明	QSettings 本地存储，键名见 5 章
9	屏幕分辨率最终值	未说明	按 1920×1080 设计，代码以 SCREEN_W/SCREEN_H 常量适配
10	⑨⑩“停止”是否复位洗消系统	未说明	停止=停泵断阀，不自动复位，需人工复位

附录A　交给 DeepSeek 的提示词模板

将以下提示词与本文档第 2～5 章内容一并提供给 DeepSeek（可直接复制，按需修改括号内选项）：

——提示词开始——

你是资深 Qt 嵌入式界面工程师。请严格按照《图数一体机遥控端 QT 界面详细设计说明书》实现遥控端全部 10 个界面（③开机密码及密码流程、④自检、⑤作业选择、⑥机器人底盘、⑦机械臂、⑧气体检测仪、⑨手动消除、⑩手动消毒、⑪调试维护、⑫故障查询）。要求：1）技术栈：（PySide6 + QSS / Qt 5.15 Widgets + QSS，二选一，全工程一个 main.py 或 main.cpp 可运行演示）；2）画布 1920×1080 全屏，严格执行文档第 2 章配色（深色工业风 #161C23/#242E3A/#3D8BFD/#36C75A/#F5A623/#E5484D）、字体字号、按钮/指示灯/弹窗/表格/进度条样式；3）页面结构：统一 BasePage + QStackedWidget + PageRouter 跳转，页面导航、返回、急停、通信异常闪烁按 2.6/2.7/2.8 实现；4）交互逻辑：逐界面实现文档 3.x 章“交互逻辑”表中的每一步（含启动/停止/返回互锁、参数保存与恢复出厂值、系统回位/暂停、球阀四图标状态机、分页故障表、数字键盘弹窗、500ms 闪烁等）；5）通信层：按第 5 章占位函数实现一个 MockCommunication 类，定时模拟数据（电量、电压、液位、流量、压力、关节角、气体浓度、故障码等），用 Qt 信号把数据推给界面，便于离线演示；6）参数与密码、故障历史用 QSettings 持久化；7）界面中的【设计建议】项可自行取舍并在代码注释中说明；协议原文要求不得改动；8）输出：完整可运行工程，每个界面一个类，公共组件独立文件，关键逻辑加中文注释，最后给出运行说明。

——提示词结束——

说明：若需要 DeepSeek 只实现部分界面，可把提示词中的“全部 10 个界面”改为指定编号，并只附对应章节。

附录B　界面原型映射说明

表B-1　原型映射说明

协议原型图	对应界面	原型要点（保留）	本文档的深色主题化处理
开机密码/密码警告/密码管理/密码重置（4 张）	3.1 ③	4 位密码输入、确认/取消、重置流程 4 步	保留流程与文案；改为深色面板 + 主色按钮
系统自检异常/正常（2 张）	3.2 ④	自检项列表、进度条、左右按钮组	保留列表项与按钮；异常项红闪、正常项绿
作业选择（1 张）	3.3 ⑤	左菜单 + 中央 4 卡片 + 右侧手动消除/消毒/返回	保留分区与字段；深色卡片化
机器人底盘（1 张）	3.4 ⑥	左 4 方向按钮 + 中央 3 卡片 + 右侧底盘卡/车速设置	保留；增加模式徽标与机械臂未回位横幅
机械臂（1 张）	3.5 ⑦	左 6 平移按钮 + 右 6 末端按钮 + 系统回位/暂停 + 关节角	保留；回位状态图标化
气体检测仪（1 张）	3.6 ⑧	中央 4 卡片 + 右侧启动/停机/返回 + 浓度	保留；浓度大数字显示
手动消除/手动消毒（2 张）	3.7/3.8 ⑨⑩	洗消参数卡 + 启动/停止/返回 + 底部指示灯条	保留；指示灯三态+红闪规范化
洗消调试（1 张）	3.9 ⑪	D1/D2 区 + 泵转速/启停 + 警告横幅 + 指示灯	保留；球阀四图标状态机按协议文本细化
历史故障/气体检测仪历史故障（2 张）	3.10 ⑫	表格（序号/时间/名称）+ 分页 + 分类按钮	保留；深色表格 + 汇总卡