常见问题¶

这一章收录现场最常遇到的故障和它们的排查顺序。每条都按同一个格式写:现象是你在软件里看到的东西(尽量照抄了软件的原话),先查是按可能性从高到低排的检查清单,解决是具体怎么做。

报修之前先做三件事

把弹窗或运行信息区的报错原文截图,不要只说"报错了"。
记下出问题的时间点(几点几分),日志按时间排,有时间点我们能直接定位。
运行端右下角点"导出诊断包",把导出的 zip 一起发过来(里面有日志、崩溃与挂死记录、节拍库、系统设置和当前工程,不含图片)。

相机与取像¶

相机连不上,列表里没有相机¶

现象

新建或设置相机工位时,相机列表一片空白;或者弹出一个警告框,末尾用红字写着"当前仅可使用离线模式"。

先查

相机电源灯亮不亮、网线/USB 线是否插紧。
网口相机的 IP 和电脑网卡是不是同一个网段(相机厂家的工具里能看到相机 IP)。
相机厂家的自带软件(如 MVS)是不是开着——同一台相机只能被一个程序占用,厂家软件开着,本软件就枚举不到。
相机驱动/SDK 有没有装。弹出"当前仅可使用离线模式"基本就是这一条:相机驱动没装,或装的位数不对。
电脑上是否装了多张网卡,相机接在了没配 IP 的那张上。

解决

关掉相机厂家的软件,回到本软件重新打开相机工位设置窗口。
网段不符:把电脑网卡改成和相机同网段(例如相机 192.168.1.10,网卡设 192.168.1.100,掩码 255.255.255.0),或用厂家工具把相机 IP 改到网卡所在网段。
驱动没装:装上相机厂家的驱动包后重启电脑,再开软件。
相机能在厂家软件里出图、却在本软件里看不到,把这个情况连同相机型号一起告诉我们。

新建相机工位窗口

取不到图,提示"读取图片超时"¶

现象

运行时停住,弹出或在信息区打印 相机工位名读取图片超时;或者相机工位设置窗口里点取图,提示"相机取图失败："。

先查

触发方式设错是最常见的:工程按软触发做的,相机却被设成了外部触发,于是相机一直在等一个永远不来的硬件信号。打开相机设置窗口的触发页,看选的是"连续模式"、"软触发模式"还是"外部触发模式"。
用外部触发的,查触发线接没接、传感器/PLC 有没有真的发信号、触发边沿(上升沿/下降沿)选得对不对。
曝光时间是不是设得过长(例如设成几百毫秒),一张图本身就要那么久。
相机工位上设的"设置相机读图超时(s)"是不是太短。
相机中途掉线:信息区里前面有没有 相机设备是否在线: False 这类记录。

解决

没接触发线的场合,把相机设成"软触发模式",由软件发软触发。
接了触发线的场合,保持"外部触发模式",先用厂家软件确认能被硬件触发出图,再回本软件。
曝光过长就调小曝光、把光源调亮补回来。
读图超时时间按实际节拍放宽(一般留到单件节拍的两倍)。

照片上有黑色横条¶

现象

图上出现一条或几条明显的黑色横带,位置不固定,有时几张才出现一次。

先查

光源是不是被灯控器设成了闪烁(频闪/脉冲)模式。软件本身不驱动相机的频闪输出,光源按常亮使用;出现黑条基本都是光源在闪、而闪的节奏和相机曝光对不上。
环境里有没有其他频闪光源照进视野(日光灯、其他工位的爆闪灯)。
曝光时间是不是比光源的一个闪烁周期还短。

解决

把灯控器改成常亮输出,这是最直接的办法。
必须用频闪的,让灯的亮起时间完整覆盖相机曝光时间(灯先亮、后曝光、灯后灭)。
加遮光罩挡掉环境杂光。
适当加长曝光时间,让它跨过整个闪烁周期。

偶发花屏、半张图、全黑图¶

现象

大部分时候正常,偶尔来一张错位的细横线图、半张图或全黑图;跟着就出现莫名其妙的 NG、条码读不出、SN 为空、计数对不上。

先查

这是网口(GigE)相机丢包的典型表现。按下面顺序查网卡设置:

网卡的巨帧(Jumbo Frame / 巨型帧)有没有开到最大(一般 9014 字节)。
网卡的接收缓冲区(Receive Buffers)是不是还停在默认的小值,应调到最大。
是不是多台相机共用一个网口或一个交换机口——带宽被分掉了。
网线质量与长度(超五类以上、尽量短、别和动力线捆在一起)。
电脑 CPU 是不是被别的程序占满(相机收图线程抢不到 CPU 也会丢包)。

解决

在"设备管理器 → 网络适配器 → 该网卡 → 属性 → 高级"里,把巨帧调到最大、接收缓冲区调到最大,然后重启电脑。
每台相机接独立网口;做不到就换千兆以上的交换机并确认上行带宽够。
软件已经带了一层兜底:检测到丢包的坏帧会自动重新拍一次(最多两次)。这只是补救,根子还在网卡设置上,不要靠它长期跑。

拍早了、拍晚了、前后两张颠倒¶

现象

拍到的画面比产品实际位置早一点或晚一点;多相机时偶尔出现两张图对调、拍到上一件产品。

先查

这一组相机的拍照行有没有勾上"主动触发"。
触发信号到软件之后,中间是不是还夹了别的耗时指令。
通讯触发里的"触发延时"设了多少。

解决

打开调试端的"编辑运行顺序"窗口。
找到拍照那一行(形如 (相机工位名->检测方案名)),勾上它的"主动触发"。
同一组要同时曝光的相机放在同一个阶段里(不在的右键"移到阶段"),每一行都勾上。勾过之后,通讯触发信号一到,整组相机立刻同时曝光,后面的步骤只是来取已经拍好的图,不会再被前面的耗时步骤拖偏。
还需要微调时间的,用通讯触发参数里的"触发延时"来对。

运行顺序编辑窗口:拍照行的"主动触发"勾选列与右键菜单

换了相机或线以后检测框对不上模板¶

现象

图能拍到,但画面上的检测框整体偏离了标签,原本对准字符的框压到了空白处,结果大面积 NG。

先查

这个检测方案的标签外框里,"是否进行矫正"有没有勾上。矫正关着的时候,检测框是按模板图上的绝对位置贴的,相机一动就全偏。
相机的安装位置、镜头焦距、工作距离是不是和拍模板图时一致。
视野方向有没有变(相机装反、镜像翻转)。
同一个工程里,有的相机工位开了定位、有的没开。

解决

相机位置只是轻微变动:打开标签外框的设置,勾上"是否进行矫正",必要时再勾"透视矫正",然后点"训练"。
相机位置、镜头或工作距离有实质变化:重拍模板图最省事——重新取图、设为主模板图,再逐个检测项确认框的位置,最后"训练工程"。
整体只偏了固定的一段距离:用调试端的"ROI移动"一次性把所有框平移过去,不用一个个拖。

触发与通讯¶

一直停在"等待通讯触发"¶

现象

运行界面的信息区反复打印 等待通讯触发(trigger#1),再没有下文,产品过来了也不拍。

先查

串口是不是被别的程序占着(厂家调试软件、串口助手、另一个本软件实例)。
COM 口号有没有变。USB 转串口的线换个插口,Windows 就可能重新分配 COM 号。
RS485 的 A、B 两根线是不是接反了。
"从站ID"、"波特率"、"校验位"、"数据位"、"停止位"和对方设备是否一致。
"地址"和"寄存器类型"选得对不对。读线圈选 READ_COILS,读离散量选 READ_DISCRETE_INPUTS,读保持寄存器选 READ_HOLDING_REGISTERS,读输入寄存器选 READ_INPUT_REGISTERS——选错类型读的是完全不同的一片地址。
"触发条件值"和 PLC 实际写进去的值是否相等。

解决

关掉所有会占串口的软件,只留本软件。
在"设备管理器 → 端口(COM 和 LPT)"里确认当前 COM 号,回到"设备设置"页改成实际的那个。
A、B 接反不会烧,直接对调再试一次。
从站、地址、类型、值这四项逐项和 PLC 工程师对一遍。软件在调试日志里会记 等待触发收到: 值 (地址N),拿这一行去和 PLC 侧核对最快。

提示 Modbus RTU failed to open serial port¶

现象

开始运行或做通讯测试时报:

Modbus RTU failed to open serial port COM3

先查

这个 COM 口是不是不存在了(线拔了、驱动掉了)。
是不是被别的程序占用。
是不是和软件里其他功能选了同一个口。软件会拦下这种冲突,提示"通讯设备串口与其他设备冲突"、"光源控制器串口与其他设备冲突"、"串口与其他设备冲突"、"三色灯和传送带设备串口与其他设备冲突"。

解决

打开"设备设置",给通讯设备、光源控制器、串口收发数据、三色灯/传送带各自分配不同的 COM 口。
口不存在就重插 USB 转串口线,确认设备管理器里能看到,再回来改端口号。
改完点"确认"。如果提示"保存设备设置失败，设置未生效。请检查串口/网络参数后重试，或联系售后人员",说明参数还有问题,先别关窗口,逐项复查。

PLC 收不到结果¶

现象

检测跑完了,界面上有结果,PLC 那边的地址一直没变化。

先查

通讯输出指令里的"地址"是不是 PLC 实际在读的那个地址。
"类型"选的是 WRITE_COIL 还是 WRITE_HOLDING_REGISTER,和 PLC 侧一致吗。软件写线圈用的是"写多个线圈"(功能码 15),写寄存器用的是"写多个寄存器"(功能码 16);少数老 PLC 只认单点写的 05/06,遇到这种要让 PLC 侧改成接收 15/16。
"是否为最终输出"该勾的有没有勾。只有勾了这一项的输出指令才会等所有检测方案跑完再发总结果;没勾的会在流程中途就发出去。
输出值引用的变量名对不对。引用变量必须以 & 开头,例如 &相机工位1-检测方案1。名字写错时软件会报 variable ... not found in result dict,后面跟着当前可用的变量名列表。
相机工位或检测方案改过名字吗?改名后旧的 &变量 引用就失效了。

解决

对照报错里列出的可用变量名,把输出值改成正确的 &变量名。
改过相机工位/检测方案名字的,回到"编辑运行顺序"窗口,把受影响的输出里引用的 &变量名 重设一遍(拍照行本身会自动跟着改名,不用动)。
地址、类型、值三项和 PLC 工程师当面对一遍,别靠猜。

机械手不动作¶

现象

检测结果是 OK,但机械手没有接到信号,不抓取/不放行。

先查

打开导出的日志,找通讯输出那一行,它记录了完整的写入流水:

通讯输出值: 1 (slave=1 地址=200 类型=WRITE_HOLDING_REGISTER 引用=&相机工位1-检测方案1)

拿这四项去对:

值:软件实际写出去的数。OK/NG 各写什么值,在输出指令里由"写入值"和输出后处理决定。
从站:和机械手/PLC 的站号一致吗。
地址:和对方读的地址一致吗。
类型:线圈还是寄存器,和对方一致吗。

解决

四项里只要有一项对不上,改软件侧或改对方侧都行,对齐即可。
日志里根本没有这一行,说明这条输出指令没被执行到——回"编辑运行顺序"检查它在不在指令表里、在不在正确的位置。
日志里有这一行、对方仍读不到,问题在物理链路(接线、站号冲突、终端电阻),按串口那一节排查。

MES 告警条亮红¶

现象

运行界面结果标签上方出现一条醒目的红色横幅,内容形如:

MES 未上传 3 件!  <原因>
检测继续运行 — 记录已本地留痕待补传

或者结果区显示"MES上传失败"、"MES状态异常"、"品质未审核, 停止检测过站"。

先查

网络通不通:能不能 ping 通 MES 服务器。
MES 参数(地址、账号、密码、规程 ID)有没有改动过。软件启动时如果连不上,会提示"初始化web客户端发生错误, 请检查mes地址...点击确认后进入离线模式"或"登录mes系统发生错误, 请检查mes信息..."。
这一件是不是重复过站——同一个 SN 已经上传过了。
是不是 MES 侧判了品质未审核,把过站卡住了。

解决

检测不会因为 MES 上传失败而停,红条只是提醒:这些件的数据已经在本地留痕,等 MES 恢复后要人工补传。把鼠标停在红条上能看到留痕文件的路径。
MES 恢复连接后红条自动消失,信息区会打印本轮累计多少件未上传。
红条写着"本地留痕写入失败, 请立即人工记录"时,说明连本地留痕都没写成(多半是磁盘满或没权限),必须马上人工记下这些件,同时处理磁盘问题。
现场压根不接 MES 的,在运行端"设置 → 打开系统设置 → 通用设置"里把"启用 MES 上传"的勾去掉:不再留痕、不再计数、不再弹红条。只想藏掉红条但保留留痕的,用调试端工程设置里的"MES 未上传告警条"开关。
品质未审核导致停线的,由有权限的人在 MES 侧完成审核后再继续。

运行界面的 MES 未上传红色告警条

检测结果¶

全部 NG,或误报很多¶

现象

一开机就连续 NG,或者良率突然从九成掉到五成,不良信息汇总里几乎每项都报。

先查

定位有没有过。定位(标签外框的矫正)失败时后面所有检测框都是错位的,一错全错。先看结果图上标签外框有没有框住标签。
模板图和现场取像是不是不一致了:换过料、换过版、光源老化变暗、镜头脏了、相机被碰过。
光照变了:白班夜班的环境光差异、灯罩积灰、灯控器亮度被人改过。
阈值定得过严:缺陷面积阈值/二值化阈值调得太小,正常的印刷波动都被算成缺陷。
是不是刚改过参数没点"训练工程"。

解决

先用调试端打开一张真实的 NG 图(工具栏上的"打开调试图"),做"整体运行",看是哪一步先挂。
定位挂了:调标签外框的"模板特征点数"、"最小匹配个数"、"金字塔层数",或者重拍主模板图后重新训练。
光照变了:把光源亮度调回原值;确实回不去就重拍模板图。
阈值过严:把缺陷二值化阈值、缺陷面积阈值往上调一点,边调边用调试图回放确认真缺陷还抓得住。
改完任何影响模板的参数,一定要点"训练工程"再保存。

扫码漏读¶

现象

码明明是好的,码检测却报未检出;换个角度/位置就又能读。

先查

检测框画得太紧,标签一漂移就把码切掉一点边——这是漏读最常见的原因。
码在图里太小(二维码边长只有几十个像素)。
码本身印得浅、反光、有划伤。
镜头脏或没对好焦。

解决

把检测框画大,直接盖住整张标签。码检测只要框里有码就能扫,框大一点没有坏处,反倒能吃下标签的位置漂移。
在码检测的设置里勾上"解码失败自动扩大搜索区重试(×1.5/×2/×3)"。开了之后,第一次没扫出来时软件会以检测框中心为基准逐级放大搜索区重扫。
码太小的,提高相机分辨率或缩短工作距离,让码在图里至少有一百多个像素宽。
印刷质量差的,加强光照对比、换角度补光。

双码或多码标签判 NG¶

现象

标签上有两个码(比如上下叠放的两个一维码),检测框一盖住两个就报 NG,结果串里写着 多码NG: 码A | 码B。

先查

框里是不是真的有两个不同的码。同一个码被重复检出不会判 NG,软件会先去重。
你要的是哪一个码,它的开头/格式有没有固定规律。

解决

能用框区分开的,把检测框缩到只盖住目标码。
两个码挨得太近分不开的,在码检测设置的"多码处理"里:
1. "扫到多个不同的码:"选"按正则筛选"。
2. "正则:"里填只能匹配目标码的表达式,例如目标码都以 2636 开头就填 ^2636。
规则是:多码时只保留匹配的码,恰好剩一个才通过;只有一个码时也必须匹配,否则判 NG。判 NG 时结果串会把扫到的码都列出来,方便你回头改正则。

有无检测误报¶

现象

有无检测把有的判成没有,或者把没有判成有,"分数:"里 OK 和 NG 两个分数很接近、来回跳。

先查

误报基本不是模型的问题,按这个顺序查:

位置偏移:检测框和实际物体差了十几二十个像素,喂给判断的就是一块错位的图。先看结果图上框的位置准不准,不准就回去查定位。
取像变了:亮度、角度、焦距和注册那批图不一致。
注册图不干净:OK 组里混进了 NG 图,或 NG 组里混进了 OK 图;注册时框的位置和现在不一样。
框的大小和类型视野不一致(老工程常见):状态行会提示"当前框与类别视野不符"。

解决

先修定位和取像,让现在的图和注册图长得一样。
打开有无检测的设置窗口,逐张翻"OK组图片"和"NG组图片",把混进去的、画面明显不对的删掉(选中后点"删除当前注册图")。
用现在的真实画面重新注册:结果不对的那一张,直接点"注册当前图片为OK"或"注册当前图片为NG"。每个类别最少注册 5 张 OK 图,单类上限 100 张。
状态行提示"当前框与类别视野不符"的,点"按类别视野重设框"(或"本类别所有框按视野重设")再跑;提示"N 张尺寸与视野不符"的,删掉那几张用改好的框重新注册。5.0 起没有"分数阈值"可调,OK 要比 NG 像得够多才判 OK。
提示"未注册OK图"或"注册OK图数量至少5张"的,就是注册图不够,补齐再跑。

有无检测设置窗口

字符识别错字¶

现象

字符识别把 0 读成 O、1 读成 I,或者干脆读出乱码、少字。

先查

字在图里够不够大。字高太小,再好的算法也认不准。
对比度够不够:浅色字印在浅色底上、反光、背景有花纹。
字是不是没摆正(竖排、倒着、斜着)。
底色和字色的关系设对了吗:"白底黑字"勾没勾(不勾 = 黑底白字)。
用的模型对不对:纯英文数字勾上"英文模型",有中文的不勾(= 中英文模型)。

解决

字太小:提高相机分辨率或缩短工作距离;应急可以把"X方向缩放"和"Y方向缩放"调大,把字拉大再识别。
字不正:在"旋转角度"里选 90 / 180 / 270,把字转成水平方向再识别。软件只认水平方向的文字。
对比度不足:改光源角度(侧光打凸印、同轴光打反光面),或勾"最小字符高度"、调"最小限定框高度"过滤掉噪点。
固定的几个字老是认错:用"混淆字符"页把"易混字符"映射到"正确字符";要统一替换某些符号的用"替换字符"页。
识别结果本身对、只是比对不过的,检查"比对方式"选的是"结果字符串等于参考字符串"、"参考字符串在结果字符串中"还是"结果字符串在参考字符串中",以及"置信度阈值"是不是定高了。

检测变慢,跟不上节拍¶

现象

单件耗时从几秒涨到十几二十秒;或者只有开工的头几件特别慢,后面就正常了。

先查

只有开始运行后的头一两件慢:这是有无检测的 AI 模型第一次加载。软件已经改成在"开始运行"之前就把模型预置好,信息区会打印 有无AI预置完成(N 项)。如果注册图刚改过,这一次预置会把新注册图重新生效一遍,耗时正常。
一直都慢:看信息区的 各算子耗时(本件) 和 总运行耗时(不含通讯、拍照),哪个检测项吃时间就查哪个。
调试端还开着:登录后进过调试端,它就一直留在后台,实时预览会持续抢 CPU 和相机带宽。
存图拖慢:磁盘慢、存图路径在网络盘、存的是 png 大图。
多相机串行拍照:一台拍完才轮到下一台。

解决

生产时登出,登出会把调试端关掉,只留运行页。
存图:在系统设置的"存图设置"里勾"只存NG图片",或把"存图格式"的 PASS 图改成 jpg,并把"存图路径:"指到本机的固态硬盘,不要指网络盘。
多相机:在"编辑运行顺序"里把同组相机的拍照行都设成"主动触发",让它们同时曝光。
改过有无检测注册图之后头一件慢属正常,跑起来就恢复。
还是不够快的,把信息区里 各算子耗时(本件) 那一行发给我们,我们按耗时最高的那个算子给优化方案。

软件与工程¶

软件闪退了,要把什么发给我们¶

现象

软件窗口直接消失,没有报错框。

先查

记下闪退的时间点和闪退前做的最后一个操作(比如"删相机工位""改旋转角""点了训练")。
闪退是不是能重现——同样的操作再做一遍还闪不闪。

解决

按下面收集材料,一起打包发给我们:

重新打开软件,运行端右下角点"导出诊断包",选一个路径导出 zip。诊断包里已经带上了软件安装目录下 log 文件夹里的全部文件(单个超过 128 MB 的日志只带最后 32 MB)——除了运行日志,还有闪退时自动落下的崩溃现场文件:
- system.log——运行日志
- faulthandler.txt——崩溃时的调用栈
- crash_<数字>_<时间>.dmp——崩溃转储,定位闪退全靠它
- minidump_status_<数字>.txt、startup_trace.txt——启动与转储状态
另外还带了节拍库、系统设置和当前打开的工程(不含图片)。 2. 软件起不来、导不出诊断包时,改为手动到软件安装目录下的 log 文件夹,把里面的全部文件拷走。 3. 不要手工打包用户目录下的 .labeldetect 文件夹(里面有明文密码)。系统设置已经以遮盖版带在诊断包里了;软件起不来、导不出诊断包时,只把 .labeldetect 里的 sys_config.yaml 拷出来,用记事本把含 password 的那几行的值删掉再发。 4. 附上前面记下的时间点和操作步骤。

别急着重装

重装或清理会把崩溃文件冲掉,拿不到现场就只能靠猜。先把上面的材料拷出来再做别的。

打开工程失败¶

现象

打开工程时弹出"打开工程发生错误"、"工程文件已损坏，请确认所选工程是否正确！"、"工程内容为空，请确认所选工程是否正确！",或者"所选文件夹不是有效工程(缺 manifest.yaml)，请选择后缀为 .lproj 的工程文件夹。当前所选: ..."。

先查

选的是不是 .lproj 文件夹本身。工程是一个目录,不是单个文件,要在"打开工程(选择 .lproj 目录)"里选中那个带 .lproj 后缀的文件夹。
这个工程是不是老版本的 .pro 文件。老格式的工程本软件不能直接打开。
工程目录是不是被拷贝时拷漏了(只拷了一部分文件)。
是不是提示"此工程已经被打开"——那说明软件里已经开着同一个工程。

解决

.lproj 工程:重新选择那个文件夹;拷贝工程时务必整个文件夹一起拷,不要只挑几个文件。
老的 .pro 工程:联系我们做转换,不要自己改后缀名,改了也打不开。
工程确实损坏的:找最近一次的备份;没有备份就把损坏的工程目录整个打包发给我们,我们看还能不能救回来。
提示"最近工程文件已损坏"的,用"打开工程"重新选一次,并用"清除最近工程"清掉坏记录。

提示授权过期或与本机不匹配¶

现象

启动时弹出错误框,内容是下面之一:

软件尚未注册许可证, 请先获取许可证
许可证签名校验失败(非法或损坏的许可证)
许可证与本机不匹配
授权已过期(到期日 2026-01-01)
系统时间异常(检测到时间回拨), 启动失败

先查

这台机器是新换的、重装过系统、换过主板或硬盘吗?换了硬件,机器指纹就会变,原来的授权文件对不上。
电脑的系统时间是不是被人往回调了。软件有防回拨保护,时间被调早会直接拒绝启动。
授权文件是不是放错了地方或者改过名。

解决

打开软件,在运行端菜单点"更新授权"。窗口里显示的就是本机的机器指纹。
点"导出UUID"存成 txt,把这个文件发给我们。
我们按这个指纹签一份新的授权文件(.lic)发回来。
回到同一个窗口点"导入授权码",选中收到的 .lic 文件,再点确认。看到"授权码校验成功!"就好了。

几个细节

授权文件的文件名里带着机器指纹,导入时软件会核对,不要改文件名。
授权文件放在用户目录的 .labeldetect 文件夹下,不要手工删。
提示"本机硬件唯一标识为占位符,授权可能与同型机冲突,建议刷 BIOS/换机"时,授权仍可用,但请告诉我们,这类机器有和同型号机撞车的风险。
时间回拨导致启动失败的,把系统时间改回正确的当前时间再开。

界面卡顿¶

现象

点什么都要等一下才有反应,画面一顿一顿,严重时窗口变白。

先查

调试端是不是还开着(进过调试页又没登出)。调试端的实时预览很吃 CPU,生产时不该常开。
存图磁盘是不是快满了。信息区会打印 存图空间不足<预警值>G，请及时清理。
杀毒软件是不是在扫存图目录。每存一张图就被扫一遍,会把磁盘和 CPU 拖死。
这台电脑是不是同时跑着别的软件(相机厂家工具、远程桌面、浏览器)。

解决

生产时停在「运行」页;调试完不再用调试端就登出,登出会把调试端关掉。
清理存图目录或换一个空间充足的盘,见下一条。
在杀毒软件里把存图目录和软件安装目录加进排除列表。
关掉不相关的程序。

存图空间满了¶

现象

信息区出现黄色或红色提示:

存图空间不足<预警值>G，请及时清理
存图空间不足0.5G，已停止存图，请及时清理

或者保存工程时报"存图空间耗尽, 请清理图片后保存工程"。

剩余空间不足 0.5 G 时软件会停止存图并报错停机

黄色那条提醒里的数字来自系统设置里的"磁盘空间预警:"(出厂是 5 G),看到它就该动手,别等到红色的那条。

先查

存图盘还剩多少空间。
"存图路径:"指到哪个盘。
"是否循环存图"开着没有,"保存周期(天):"设的是多少天。

解决

按见效快慢排:

立刻腾空间:停机后到存图目录里删掉旧日期的图。目录按 存图路径 / 工程名_SN_时间戳 / PASS 或 NG / 相机工位名_检测方案名 / 这样分层,按日期整块删最快。
换盘:系统设置 →"存图设置"→"存图路径:"改到空间大的盘。
少存点:勾上"只存NG图片";把"PASS图格式:"改成 jpg(比 png 小很多)。
让它自己清:打开"是否循环存图",把"保存周期(天):"设成现场要求的留存天数,过期的图会被自动清掉。
提前预警:把"磁盘空间预警:"调大一点(比如 20 G),早点收到提醒。

忘记密码¶

现象

登录框里输密码,提示"账号或密码错误, 请重新输入"。

先查

选的角色对不对。登录框的下拉框里有"管理员"和"超级管理员"两种角色,它们的密码是分开的。
这台机器的密码有没有被人改过。如果从没改过,用出厂默认密码(装机时我们会告知,手册里不公开)。

解决

先用出厂默认密码试一次。
密码改过又想不起来的,联系我们;请一并说明是哪个角色的密码,以及这台机器的机器指纹(见上面"提示授权过期"一条里的取法)。
拿回权限之后,在运行端菜单点"打开账号设置",在"账号管理窗口"里把"管理员:"和"超级管理员:"的密码重设一遍,并记录到设备台账上。

别用默认密码跑产线

默认密码人人都知道。装机验收时就该改掉,并把新密码交给设备管理员保管。

点了"运行"起不来¶

现象

按"运行"没进入检测状态,反而弹窗。常见的几条:

当前工程为空, 请先新建/打开工程
当前工程未被确认
1.请打开调参界面勾选模板确认按钮
2.请切换到离线模式继续运行
<检测方案名>:未设置模板图
<检测方案名>:未添加标签外框
启用了PLC通信串口但未初始化串口设备!
已启用光源控制器但未设置串口!

先查

按弹窗内容对号入座:哪一项没配齐,它就写哪一项。

解决

"当前工程为空":先"打开工程"或"新建工程"。
"当前工程未被确认":到调试端勾上"工程确认",或按提示切到离线模式。
"未设置模板图" / "未添加标签外框":到调试端给这个检测方案补上主模板图和标签外框;这个方案现在用不上的,右键把它"禁用检测方案"。
串口类提示:到"设备设置"里把对应的串口配好,或者把用不到的设备(光源控制器、串口收发数据、三色灯/传送带)的启用勾去掉。