瑞阳新一代布线系统 使用手册
版本：V2.0（更新至 2.0.0.44） 北京瑞阳伟业科技有限公司 2026 年 11 月
1. 系统概述
瑞阳新一代布线系统由三个软件组成，覆盖"分布式（小盒子）布线"与"DWS 单机布线"两种作业模式：
| 软件名称 | 安装位置 | 主要职责 |
|---|---|---|
| 布线指挥中心 | 上位机（1 台） | 任务派发、屏幕组合与缝隙管理、设备实时监控、全组体检、语音广播、AI 助手 |
| 布线播放终端 | 每台小盒子电脑 | 组合大屏投屏显示布线图、导线高亮闪烁、扫码确认、语音播报、对讲呼叫 |
| 数字化布线工作站 | DWS 工位电脑 | 任务库管理、四大库（连接器/工装/构件/工艺）、用户权限、单机布线执行、报告生成 |
与旧系统相比的主要变化：
- 小盒子上不再安装 AutoCAD，播放终端单程序完成全部现场功能；
- 图纸打开速度从旧系统的 15～30 秒缩短到 1 秒以内；
- 任务文件经网络自动校验分发，不再需要配置 Windows 共享目录；
- 全部操作留有结构化日志，支持一键全组体检与 AI 故障分析；
- 新增语音播报、语音命令、现场对讲、AI 助手功能。
旧系统的数据（任务目录、接线表、用户账号、勾选记录、屏幕组合配置等）全部兼容，无需迁移。
2. 环境要求与安装
2.1 运行环境
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11 |
| 运行库 1 | .NET 10 Desktop Runtime（x86 版，三个软件都需要） |
| 运行库 2 | ASP.NET Core Runtime 10（x86 版，仅指挥中心需要） |
| 图形运行时 | ODA DrawingsX 23.3 运行时（播放终端、工作站需要；指挥中心不需要） |
| 网络 | 指挥中心与各播放终端处于同一局域网；指挥中心开放 18250 端口 |
| 数据目录 | D:\BXB（沿用旧系统目录；系统首次运行自动补齐缺失子目录） |
2.2 安装包
系统提供统一安装程序（推荐）：
瑞阳新一代布线系统-Setup-V2.0.0.exe
一个安装包覆盖全部三个软件与全部依赖：安装时勾选本机需要的组件（指挥中心 / 播放终端 / 工作站），安装程序自动检测并安装缺失的运行库（.NET 桌面运行时、ASP.NET Core、ODA 图形运行时），并可自动完成防火墙放行、开机自启、示例任务生成。
批量部署可静默安装（按机器角色选类型）：
瑞阳新一代布线系统-Setup-V2.0.0.exe /VERYSILENT /NORESTART /TYPE=master （上位机）
瑞阳新一代布线系统-Setup-V2.0.0.exe /VERYSILENT /NORESTART /TYPE=player （小盒子）
瑞阳新一代布线系统-Setup-V2.0.0.exe /VERYSILENT /NORESTART /TYPE=dws （DWS 工位）
如需单独手工安装依赖，交付包 redist 目录内附独立运行库安装包（windowsdesktop-runtime / aspnetcore-runtime，均 x86 版），ODA 图形运行时为 ODA-DrawingsX-23.3-Runtime-Setup.exe。
2.3 安装步骤
每台机器都执行： 双击统一安装包 → 选择安装位置 → 勾选本机角色对应的组件 → 下一步直至完成。组件与机器的对应关系：
| 机器 | 勾选组件 | 附加任务（默认已勾） |
|---|---|---|
| 上位机 | 布线指挥中心（可加选"标准示例任务"） | 放行 18250 端口 |
| 每台小盒子 | 布线播放终端 | 开机自启（守护进程） |
| DWS 工位 | 数字化布线工作站（可加选"标准示例任务"） | — |
安装完成后的首次配置：
- 上位机：启动"布线指挥中心"，确认状态栏"服务运行中 · 端口 18250"；
- 小盒子：启动"布线播放终端"，首次运行输入指挥中心 IP；之后每次开机由守护进程自动拉起；
- DWS 工位：启动"数字化布线工作站"，默认账号 admin，密码 admin（若本机已有旧系统用户库，直接用旧账号登录）。
组件页会显示依赖检测结果（已装的运行库自动跳过），"准备安装"页会列出本次将自动安装的依赖清单。卸载：控制面板"应用和功能"→ 瑞阳新一代布线系统（防火墙规则、快捷方式一并清理；D:\BXB 业务数据不会删除）。
2.4 配置文件
系统配置保存在 D:\BXB\RSDWS\config.json，常用项：
| 配置项 | 说明 | 默认值 |
|---|---|---|
| MasterHost | 播放终端连接的指挥中心 IP | 首次运行时输入 |
| MasterPort | 服务端口 | 18250 |
| RenderDevice | 渲染方式：auto / directx / opengl / gdi | auto（自动择优） |
| BlinkIntervalMs | 高亮闪烁间隔（毫秒） | 500 |
| TtsEnabled | 语音播报开关 | true |
| VoiceCommandEnabled | 语音命令开关（唤醒词"小瑞"） | false |
| AiEnabled / AiBaseUrl / AiModel | AI 助手开关与服务地址 | 关闭 |
| MesEnabled / MesFtp* | MES 推送开关与 FTP 参数 | 关闭 |
工艺流程开关（预制工装/校验工装/批次号/布线/校验布线）与接点表列映射在工作站 → 系统配置页设置，与旧系统数据互通。
3. 示例任务说明
系统已内置两个标准示例任务（位于 D:\BXB\TASKS），供安装验收与操作培训使用：
| 任务名 | 内容 | 用途 |
|---|---|---|
| EXAMPLE-快速演示 | 8 根导线的接线表 + 真实布线图纸 + 工装表 + 构件表 + 报告模版 | 几分钟跑完全流程，首选 |
| EXAMPLE-完整演示 | 真实客户接线表（178 行）+ 真实布线图纸 | 大数据量与组合屏演示 |
任务目录内附 《演示扫码码值.txt》，列出每根导线的二维码内容与全部功能码：
- 有扫码枪：把码值内容生成二维码打印后扫描；
- 无扫码枪：在执行界面按 F3 打开"模拟扫码"窗口，输入码值回车即等效扫码。
快速演示任务的 8 条导线码：
W0001: 16S01001%W0001%4XP15%A1%4XS5%3
W0002: 16S01001%W0002%4XP15%A2%4XS5%4
W0003: 16S01001%W0003%4XP15%B1%3XT2%1
W0004: 16S01001%W0004%4XP15%B2%3XT2%2
W0005: 16S01001%W0005%2XD8%C1%4XS5%7
W0006: 16S01001%W0006%2XD8%C2%3XT2%5
W0007: 16S01001%W0007%2XD8%D1%5XK1%1
W0008: 16S01001%W0008%2XD8%D2%5XK1%2
常用功能码：
| 码值 | 作用 |
|---|---|
| CON_OK | 确认当前选中导线（打钩变绿） |
| CON_CL | 取消当前选中导线 |
| STEP_OK | 流程进入下一步 |
| STEP_CL | 流程回退上一步 |
| WOZBX | 清除路径高亮 |
| TOOL001 / TOOL002 | 高亮对应工装 |
| CALL | 呼叫指挥台（对讲） |
如需重新生成示例任务，运行工具 Rs.MakeExample.exe 即可（会覆盖重建两个 EXAMPLE 任务）。
4. 实跑指引 A：工作站单机布线（最简路径，建议先做）
本节用 EXAMPLE-快速演示 任务，在一台装好工作站的电脑上完整走一遍布线流程。全程约 10 分钟。
步骤 1：登录
- 运行
数字化布线工作站.exe； - 输入账号 admin / 密码 admin，点"登 录"。
检查点： 进入主界面，左侧显示导航栏（任务库/连接器库/…），右侧显示任务库列表，其中能看到 EXAMPLE-快速演示 和 EXAMPLE-完整演示。
步骤 2：开始布线
- 在任务库中单击选中 EXAMPLE-快速演示；
- 点右上角 "▶ 开始布线"。
检查点：
- 全屏进入执行界面，黑底显示布线图纸（图纸清晰、中文文字正常显示——若中文显示为问号或方块，见第 8 章故障排查）；
- 顶部状态带显示：任务名"EXAMPLE-快速演示"、当前步骤（默认"步骤 1/1：布线"）、"勾选 0/8"；
- 右侧显示接线表面板，共 8 行；
- 若开了语音播报，会听到"任务 EXAMPLE-快速演示 开始布线，共 8 根导线"。
步骤 3：扫导线码 → 高亮
- 按 F3 打开"模拟扫码"窗口；
- 输入第一条导线码
16S01001%W0001%4XP15%A1%4XS5%3后回车。
检查点：
- 接线表中 W0001 行变蓝（选中）；
- 图纸上线条开始红色闪烁高亮；
- 右下角弹出提示。
步骤 4：确认接线
- 在模拟扫码窗口点 "确认勾选 CON_OK" 按钮（或输入 CON_OK 回车）。
检查点：
- W0001 行打钩并变绿；
- 高亮熄灭还原；
- 顶部变为"勾选 1/8"；
- 语音播报"确认，剩余 7 根"；
- 右下角弹出"✔ 第 1 行确认"。
试一次取消： 再扫 W0001 的导线码选中它，然后点"取消勾选 CON_CL"——绿钩消失，"勾选 0/8"。再重新确认回来。
步骤 5：依次完成全部 8 根
对 W0002 ～ W0008 重复步骤 3-4（扫导线码 → CON_OK）。
检查点：
- 第 8 根确认后，系统自动判定步骤完成 → 弹出"任务已全部完成"，语音播报"任务全部完成"；
- 点"是"退出执行界面。
中途退出测试（可选但建议）： 做到第 4 根时按 ESC 退出，再重新"开始布线"进入——前 4 根的绿钩自动恢复（勾选进度实时存库，断电不丢）。
步骤 6：生成报告
- 回到任务库，选中 EXAMPLE-快速演示，点 "生成报告"；
- 选择保存位置。
检查点： 生成的 Excel 报告中，批次/开工时间/完工时间/操作者等单元格已自动回填。
步骤 7：其他功能随手验证
- 工装码：执行界面 F3 输入
TOOL001→ 工装相关图元高亮； - 库管理：左侧导航打开"工装库/构件库"等，试新增、编辑、Excel 导入导出；
- 运行日志：导航"运行日志"可见全部操作留痕；
- 系统配置：管理员可调工艺流程开关与列映射（改动对下次执行生效）。
5. 实跑指引 B：小盒子系统（指挥中心 + 播放终端）
5.1 最小验证：一台电脑同时跑指挥中心和播放终端
用于没有多台机器时快速验证联动链路。
- 启动
布线指挥中心.exe，确认状态栏"服务运行中 · 端口 18250"； - 启动
布线播放终端.exe，首次运行输入指挥中心 IP：127.0.0.1； - 检查点： 指挥中心左侧"设备墙"出现本机卡片，呼吸灯为绿色；右下角弹出"盒子上线"提示；播放终端弹出"已连接指挥中心"。
- 指挥中心点 "屏幕组合"：
- 点"新建"，输入组合名（如
演示组）； - 选中该组，点"加入在线盒子"，把本机加入；
- 关闭窗口。
- 点"新建"，输入组合名（如
- 中间"任务看板"选中 EXAMPLE-快速演示 → 点 "派发选中任务…" → 选择"演示组" → "开始布线"。
检查点：
- 播放终端显示端全屏显示布线图纸；
- 本机为持树屏（组内第 1 台），自动弹出结构树与接线表悬浮窗（接线表 8 行）；
- 指挥中心事件流出现"任务 EXAMPLE-快速演示 就绪"；设备墙卡片显示任务名与"勾选 0/8"。
- 在播放终端按 F3 模拟扫码，按第 4 章步骤 3-5 跑完 8 根导线。
检查点： 指挥中心设备墙的勾选进度实时跟随（0/8 → 8/8）；事件流滚动显示每次高亮/勾选事件。
结束：指挥中心"任务看板"点 "结束任务" → 播放终端回到"等待任务派发"。
顺手验证：
- 全组体检：指挥中心点"全组体检" → 弹出体检报告（ODA 运行时/渲染设备/连接/任务/分辨率/磁盘逐项列出）；
- 语音广播：指挥中心按住 "🎙 按住讲话" 说话 → 播放终端喇叭放出（需两端有声卡/麦克风）；
- 断线自愈：关掉指挥中心再重开 → 播放终端自动重连并恢复现场（设备墙重新变绿，任务与勾选状态原样恢复）。
5.2 多台组合大屏（现场部署）
前提：N 台小盒子均装好播放终端并连上指挥中心（设备墙全绿）。
- 建组：指挥中心"屏幕组合" → 新建组 → 依次加入 N 台盒子。 顺序即屏序：列表从上到下 = 大屏从左到右，用"上移/下移"调整；第 1 台为持树屏（显示接线表侧栏）；
- 缝隙登记（组合屏拼缝补偿，一次性标定）： 在"屏幕组合"窗口右侧"缝隙登记"中，为每台盒子填入它左侧那条拼缝的像素宽度（最左一台为 0）。修改选中值 → 输入数字保存。该登记与组合无关，换组自动生效；
- 派发：任务看板选 EXAMPLE-完整演示（真实大图更适合多屏观看）→ 派发到组；
- 检查点：
- 每台盒子各显示图纸的自己那一段（按 DWS 图框横向均分+缝隙补偿），拼起来为完整图纸，接缝处线条对齐；
- 若某台显示整图：该盒离线未收到任务或图纸无 DWS 图框——跑"全组体检"定位；
- 跨屏同步验证：在持树屏扫一条导线码 → 全组所有屏同一根线同时闪烁；确认勾选 → 全组同步打钩；
- 缝隙微调：投屏状态下改缝隙登记值并保存后重新派发（或等下次派发自动生效），观察接缝对齐变化。
5.3 播放终端的显示端与控制端
播放终端分为两部分：
- 显示端：全屏铺满的图纸画面（大屏的一块），无任何界面元素；
- 控制端：独立的"播放终端控制台"窗口（启动时出现在屏幕右侧，可最小化到系统托盘）， 包含连接状态、任务进度、以及全部操作入口：结构树悬浮窗、接线表悬浮窗、模拟扫码、 全图显示、清除高亮、停用守护（调试）、退出终端。
悬浮窗口（置顶、可拖动，浮在全屏图纸上方）：
- 结构树窗：任务 → 工艺步骤 → 接线表/工装项。单击工装项高亮工装（全组同步）； 双击接线表项打开接线表窗；双击步骤节点跳转步骤（全组同步）；
- 接线表窗：统计带（总数/剩余/线束数量）+ 接线表格。行颜色：红=设备在图纸中不存在（数据错误）、 绿=已确认、亮蓝=当前选中、蓝=关联行（双绞组/多路径/同线束）；
- 连接器信息窗：选中行后自动出现在接线表旁，显示始/终连接器的类型/名称/针数/说明与面板图 （数据来自连接器库，接点表需配置连接器型号列）。
持树屏规则（与旧系统一致）：派发时组内第 1 台为持树屏，自动显示结构树+接线表悬浮窗； 其余屏纯图显示。
显示端快捷键：
| 按键 | 功能 |
|---|---|
| F1 | 显示/隐藏顶部状态带 |
| F2 | 显示/隐藏接线表悬浮窗 |
| F3 | 模拟扫码输入窗 |
| ESC | 退出程序（需确认；主动退出会同时停用守护进程，便于调试替换文件，重启电脑后守护自动恢复） |
6. 日常操作速查
6.1 指挥中心
| 操作 | 位置 |
|---|---|
| 派发任务 | 任务看板选中任务 → 派发选中任务… → 选组 → 开始布线 |
| 结束任务 | 任务看板 → 结束任务 |
| 增删屏幕组合/调屏序/缝隙 | 工具栏"屏幕组合" |
| 查看某台盒子状态 | 设备墙卡片（绿=正常 黄=有告警 红=离线） |
| 一键关机 / 一键开机 | 工具栏（开机为网络唤醒，需盒子主板启用 WOL） |
| 全组体检 | 工具栏"全组体检"（可导出、可 AI 分析） |
| 对讲广播 | 工具栏"🎙 按住讲话" |
| AI 助手 | 工具栏"AI 助手"（需在配置中启用） |
6.2 工作站
| 操作 | 位置 |
|---|---|
| 新建任务 | 任务库 → 新建任务（填任务名，选图纸 DWG 与接点表 Excel，其余可选） |
| 执行布线 | 任务库选中 → ▶ 开始布线 |
| 生成报告 | 任务库选中 → 生成报告 |
| 四大库维护 | 左侧导航（增删改/Excel 导入导出） |
| 用户与权限 | 左侧导航（管理员可见；权限精确到功能项） |
| 工艺流程配置 | 系统配置（预制工装/校验工装/批次号/布线/校验布线开关） |
| 接点表列映射 | 系统配置（导线号/始末端设备针脚所在列、数据起始行） |
6.3 新建自己的任务（标准格式）
任务 = D:\BXB\TASKS\<任务名>.dws 目录，标准结构：
<任务名>.dws\
├── 图纸\ *.dwg （必需；组合屏投屏要求 DWS 图层有矩形图框）
├── 线表\ *.xlsx （必需；接点表）
├── 工装\ *.xlsx （可选）
├── 构件\ *.xlsx （可选）
└── 模版\ *.xlsx （可选；报告模板）
└── Info\ （系统自动写入开工/完工/批次等信息）
接点表默认列序：导线号 | 始端设备 | 始端针脚 | 终端设备 | 终端针脚，第 1 行为表头（列序与起始行可在"系统配置"调整）。推荐直接复制 EXAMPLE-快速演示的接线表改内容。
组合屏图纸要求（与旧系统一致）：图纸 DWS 图层须有唯一的 4 顶点闭合矩形多段线作为投影图框，宽高比 = 单屏比例 × 屏数，内容全部画在框内，仅单排横向拼接。
7. 语音与 AI 功能
7.1 语音播报（默认开启）
步骤切换、扫码结果、任务完成、异常告警自动中文播报。关闭：配置 TtsEnabled=false 或工作站"系统配置"取消勾选。
7.2 语音命令（默认关闭）
配置 VoiceCommandEnabled=true 后，说唤醒词 "小瑞" 再说命令：
"确认 / 取消 / 下一步 / 上一步 / 全图 / 停止高亮 / 呼叫控制台"。识别后系统会语音回读确认。需要电脑有麦克风且系统装有中文语音识别。
7.3 现场对讲
- 盒子呼叫指挥台：扫 CALL 码（或 F3 输入 CALL）开始通话，再扫一次结束；
- 指挥台广播：按住"🎙 按住讲话"。
7.4 AI 助手"小瑞"（可直接操作系统）
配置（傻瓜式三步）：指挥中心点"AI 助手"→ 右上"设置模型…"：
- 点服务商大卡片（DeepSeek / 本地 Ollama / OpenAI / Claude / 自定义），端点自动填好；
- 填 API Key（本地 Ollama 免 Key）；
- 模型列表点选，点"保存并启用"（自动先测试连接）。
AI 能做什么（对话框输入或 🎙 按住说话）：
| 类别 | 示例说法 |
|---|---|
| 任务管理 | "把 3 号任务派发到大屏""结束全部任务" |
| 现场操作下位机 | "打开接线表""高亮 W0003""选第 5 行""第 8 行打上钩""切到布线步骤""批次号设为 PC2024" |
| 上位机设置 | "把高亮线宽设为 20，同步到下位机""闪烁间隔改 300 毫秒""让全组切英文" |
| 查询与维护 | "现在到哪一步了""全组体检""一键关机"（危险操作会弹人工确认框） |
安全边界：删除任务/全组关机/结束全部/下发批次号/关闭校验步骤等敏感操作，AI 必须经操作员点击确认； 校验工装/校验布线两个质量步骤 AI 无法远程进入（必须校验员现场登录）。全部 AI 操作与人工操作同样 写入审计日志并显示在实时事件流。
AI 语音：按住 AI 助手窗内 🎙 说话（松开即识别执行），AI 回话自动语音朗读。 按住 Shift+主界面 🎙 按钮 = 传统对讲广播（全组喊话）。
授权说明：AI 助手与 AI 语音是许可证内的独立功能位，未授权时窗口会引导升级注册码（帮助 → 注册信息/升级授权）。
7.5 图片（PNG）与 PDF 图纸任务
任务图纸除 DWG 外，也可以是 PDF 或图片（PNG/JPG/BMP）：把文件放进任务目录的 图纸\ 文件夹即可
（同目录多格式并存时优先级 DWG > PDF > 图片）。工作站"新建任务"向导可直接选这三类文件。
- 投屏：与 DWG 完全相同——组合屏切片、缝隙补偿、1:1 显示；任务卡以 📐(DWG)/📄(PDF)/🖼(图片) 徽标区分。
- PDF 高亮：扫码/选行时在图上红圈圈亮始端设备、终端设备与导线号文字并连虚线（利用 PDF 文字层； 若 PDF 导出时文字被转曲线则退为屏幕横幅提示——请设计端导出时保留文字）。
- 图片高亮：图片内无坐标数据，图上无法定位——以全屏横幅显示"导线号+始末设备"作为现场反馈。
- 多页 PDF 只显示第 1 页（派发时上位机与盒子都会提示）；接线表、流程、勾选、质量记录等全部功能与 DWG 一致。
- 授权：图片任务投屏与 PDF 任务投屏是两个独立的许可证功能位，未授权时无法派发对应任务 （升级注册码即可开通）。
7.6 中英文界面切换
- 指挥中心：菜单 系统 → 语言 / Language；
- 工作站：导航栏 🌐 语言 / Language；
- 播放终端：控制台 语言 / Language 按钮。
上位机切换后执行"同步配置"（或下次派发任务时自动同步），全组盒子界面语言跟随。已打开的窗口重开后生效。 也可以直接对 AI 说"让全组切英文"。
7.7 MES 第三方集成（需「MES 集成 API」授权）
指挥中心菜单 集成 → MES 集成：
- 点「生成 / 重置」创建 API Key，复制给 MES 厂商；
- 窗内接口目录列出全部 REST 接口（方法/路径/参数/curl 示例/响应示例）；
- 点「导出对接文档」生成 Markdown 文档交付 MES 厂商——含典型工单闭环 （下发 → 轮询进度 → 完工回报）、错误码全表、任务名/批次号规则。
服务地址 http://<上位机IP>:18250/api/v1，认证请求头 X-Api-Key。
MES 只能派发任务库内已有任务并查询进度/完工数据；删除/关机等破坏类操作不开放。
每次 MES 调用（含认证失败）都写入操作记录（系统菜单 → 操作记录，可按 MES 通道过滤统计）。
7.8 人脸识别（需「人脸识别」授权）
对接 ZKTeco（中控智慧）网络人脸/考勤设备，校验员在设备上刷脸即可进入 校验工装/校验布线步骤（密码登录通道始终保留，设备断线不影响正常作业）。
- 设备端：录入校验员人脸，设备工号必须与系统用户名（UserTable）完全一致， 且该用户角色为"检验员"；
- 上位机：装好 zkemkeeper SDK（x86 regsvr32 注册）→ 参数设置 → 显示设置页 底部"人脸识别"区：勾选启用、填设备 IP（默认端口 4370）→ 保存并同步 → 重启指挥中心；
- 现场：盒子弹出校验员登录窗时，窗内出现"也可以到人脸机上刷脸验证"提示， 刷脸成功即等价密码登录（进入校验步骤+记录检验员号+写审计）。
架构说明：上位机单点连接设备（避免多盒抢连接），识别事件经内网广播到正开着 校验窗的盒子；非检验员或系统中不存在的工号会被明确拒绝并提示原因。
8. 故障排查
8.1 常见问题
| 现象 | 原因与处理 |
|---|---|
| 播放终端提示"TeighaX.OdaHostApp 未注册" | 未装 ODA 运行时 → 安装 ODA-DrawingsX-23.3-Runtime-Setup.exe |
| 程序双击无反应 | 未装 .NET 10 Desktop Runtime x86 版（注意不是只装 x64） |
| 设备墙看不到盒子 | ① 指挥中心未启动或端口 18250 被防火墙拦截；② 盒子 MasterHost 配错 → 改 D:\BXB\RSDWS\config.json |
| 派发后某盒显示整图不切片 | 图纸 DWS 图层无有效矩形图框，或该组只有 1 台 → 跑"全组体检"看"DWS图框"项 |
| 组合屏接缝处线条错位 | 缝隙登记值不准 → 重新标定该盒左缝像素 |
| 图纸中文显示异常（问号/方块） | 图纸依赖的字体文件缺失 → 把旧 CAD 机器的字体（*.shx，常见 gbcbig.shx）拷入图纸同目录或 Windows Fonts 后重开任务 |
| 扫码枪无反应 | 系统自动降级键盘模式：确保扫码枪为"键盘仿真(HID)"模式即可直接用；或按 F3 手动输入验证流程 |
| 调试时播放终端被自动重启，无法替换文件 | 三种方式停用守护：① 显示端 ESC 退出（自动停用）；② 控制台"停用守护(调试)"按钮；③ 命令行 RsBoxGuard.exe /stop。恢复守护：重启电脑或手动运行 RsBoxGuard.exe |
| 扫码后整图乱闪/高亮不对 | 图纸不规范：路由走线须画在 DWS 层、设备名文字须在 Bxb_Text 层（与旧系统制图规则一致）；找不到设备或不连通时系统会明确提示原因 |
| 勾选进度不同步 | 查看该盒是否离线（设备墙红灯）；重连后自动恢复到最新状态，无需人工干预 |
| 语音播报无声 | 电脑无音频设备或系统无中文语音；不影响其他功能 |
| 派发 PDF/图片任务被拒："未包含…功能授权" | 该功能是独立许可证功能位 → 帮助 → 注册信息/升级授权 换含 PIC/PDF 位的新注册码 |
| 盒子拒载 PDF/图片任务："未提供投屏授权凭证" | 上位机版本过旧（不携带授权凭证）→ 升级上位机到 2.0.0.26+ |
| PDF 投屏只出横幅不出图上红圈 | 该 PDF 无文字层（导出时文字被转曲线）→ 设计端重新导出时保留文字；体检/事件流可见"文字层 N 词"，N=0 即此因 |
| PDF/图片投屏上下缺内容 | 图纸纵横比与屏组不符（派发时已提示"上下约 N% 不可见"）→ 按屏组比例（单屏比例×台数）重新出图 |
| 体检报"光栅引擎：pdfium.dll 缺失" | 发布包不完整 → 重装安装包（PDF/图片任务需要 pdfium.dll 随程序分发） |
| MES 调用全部 403 | ① Key 未配置（集成菜单生成）；② 许可证无 MES 功能位 → 升级注册码 |
| MES 派发返回 409 TASK_RUNNING | 目标组有任务在执行——MES 侧不要自动重试，先结束任务或等完工 |
| 刷脸没反应 | ① 上位机事件流看"人脸设备已连接"；② 校验员登录窗开着才响应刷脸；③ 设备工号=系统用户名且角色=检验员 |
| 刷脸提示"不在系统用户表中" | 设备端录入的工号与系统用户名不一致 → 统一为同一工号 |
8.2 一键体检
指挥中心 → "全组体检"：对全部在线盒子逐台检查 ODA 运行时、渲染设备、连接、任务文件、DWS 图框、分辨率、磁盘空间、近期错误日志，结论直接给出处理建议，支持导出与 AI 分析。
8.3 日志位置
| 内容 | 位置 |
|---|---|
| 各程序运行日志（按天滚动，保留 30 天） | D:\BXB\RSDWS\logs\*.log |
| 结构化日志库（供界面检索/AI 分析） | D:\BXB\RSDWS\logs\rslog.db |
| 看门狗日志 | D:\BXB\RSDWS\logs\guard.log |
| 指挥中心实时事件流 | 主界面右侧（可按级别/盒子过滤） |
报障时请提供：现象描述 + 发生时间 + D:\BXB\RSDWS\logs 目录打包。
9. 附录
9.1 扫码码值规范（全集）
| 类别 | 格式 | 说明 |
|---|---|---|
| 导线码 | 产品编号%导线号%始设备%始针%终设备%终针 |
6 段 % 分隔，扫描后高亮并选中对应行 |
| 功能码 | CON_OK / CON_CL / STEP_OK / STEP_CL / WOZBX / CHECK_OK / CHECK_CL / CPPCH_OK / CPPCH_CL / WTOOL_OK / WTOOL_CL / STORE_OK / STORE_CL / DTREE_OK / DTREE_CL / MESSAGE_OK / CALL | 与旧系统完全一致，新增 CALL |
| 工装码 | TOOL 开头（如 TOOL001） | 高亮对应工装 |
| 简式码 | 始端*终端（需在配置中切换 V2 模式） |
兼容旧简式格式 |
9.2 与旧系统的数据兼容
以下数据新旧系统互通，可混用、可回退：任务目录结构、接点表及列映射配置、用户账号库、功能权限文件、勾选记录（含批次/步骤隔离）、屏幕组合配置文件、缝隙登记文件、报告信息文件、MES 推送文件格式。
9.3 端口与目录清单
| 项目 | 值 |
|---|---|
| 指挥中心服务端口 | TCP 18250（防火墙需放行） |
| 任务库 | D:\BXB\TASKS |
| 四大库 | D:\BXB\LIB |
| 用户/配置库 | D:\BXB\TMP\UserTable |
| 新系统配置与日志 | D:\BXB\RSDWS |