跳转至

账号、日志与工程文件

这一页讲三件平时不用管、但一出事就必须知道的事:密码怎么改、日志在哪怎么导给我们、工程文件长什么样怎么备份。

账号与权限

软件有两个能登录的身份,都在运行端右上角的"登录"按钮里切。登录窗口标题是"管理员登录",里面填"账号类型:"和"密码:"。

身份 能做什么
未登录 只能看。所有设置菜单都是灰的,进不了调试端
管理员 能进调试端改参数、试跑、保存工程。不能新建相机工位,不能改删模板图;"设置"菜单里只有切到调试端时能开"工程设置",其它设置项仍然是灰的
超级管理员 全部功能:新建工程、系统设置、设备设置、账号设置、试运行模式、自动存图、清空统计,以及调试端的全部操作

出厂密码装机时由我们告知(手册里不公开),装机后第一件事就是改掉。

登录窗口里还有"本地校验"和"服务器(MES)校验"两个选项。常规现场用"本地校验",也就是拿本机保存的密码验;只有接了 MES 账号体系的现场才用"服务器(MES)校验"。

改密码

运行端菜单 设置 → 打开账号设置(需要超级管理员),弹出"账号管理窗口",两个输入框分别对应"管理员:""超级管理员:",改完点"确认",提示"账号设置保存成功"。

品质管理员这个角色已经没有了

老版本里还有第三个角色"品质管理员",现在已经彻底退役:登录窗口没有它,账号设置里也不再有那个密码框。开了人工复判的现场,复判窗口的"账号类型:"里只有"超级管理员"一项,填的就是超级管理员密码。升级时老的账号配置文件里残留的品质管理员密码会被自动忽略,不用手工清理。

登出

再点一次那个按钮(此时写着"登出")即可回到未登录状态。登出会顺手把打开着的调试端关掉。

日志:在哪、怎么给我们

软件写三类日志,都在软件安装目录的 log\ 文件夹里:

文件 内容
system.log 系统与操作日志:谁登录了、开了哪个工程、报了什么错
detection_info.log 每一件产品的检测明细
thread_monitor.log 运行线程的内部监控记录,排查卡顿和闪退时我们要看

日志每天午夜换一个新文件,各保留最近 5 份。

日志可能不在安装目录

如果软件装在没有写权限的位置(比如 C:\Program Files),日志会自动改写到 C:\Users\<用户名>\.labeldetect\log。找不到就去那边看。用下面的"导出诊断包"最省事,它自己知道去哪儿拿。

快速看一眼

运行端右下角的"查看日志"按钮,直接在软件里显示系统日志最后 200 行。现场自查先看这个。

导出发给我们

  1. 点运行端右下角的"导出诊断包"。
  2. 在弹出的窗口里点"选择路径",选一个好找的位置(比如桌面)。文件名已经填好了(labeldetect_diag_电脑名_日期_时间.zip),不用改。
  3. 点"确认导出"。等它跑完,提示"导出成功"。

导出的是一个 .zip 诊断包,里面有:

  • 日志目录下的全部文件:上面三类运行日志,以及软件闪退、卡死时自动留下的崩溃与挂死记录(单个超过 128 MB 的日志只带最后 32 MB,包里的文件名多一个 .tail 后缀);
  • 节拍库:每一件产品的各段耗时与判定记录;
  • 系统设置;
  • 当前打开的工程,不含图片(工程里的模板图等图片资产不带)。

把这个 zip 发给我们即可。

报故障时一起发这几样

诊断包、"帮助 → 关于"里的版本号、出问题那一刻的屏幕照片,以及出问题那几件的存图(诊断包里不带存图)。有这四样我们基本能定位问题。

工程文件

工程是一个文件夹

一个工程就是一个后缀为 .lproj 的文件夹,比如 D:\projects\A面标签.lproj。打开工程时选的也是这个文件夹,不是里面的某个文件。选错了软件会提示"所选文件夹不是有效工程(缺 manifest.yaml)"。

文件夹里面是这样的:

里面的东西 是什么
manifest.yaml 工程清单,当前这一版的全部配置
assets\ 模板图等图片文件
history\ 最近几版的旧清单

保存工程时软件是"先写新的、最后一步才切换",所以保存到一半断电也不会把工程写坏:要么还是上一版,要么已经是新版,不会出现半截的工程。

工程里存了什么、没存什么

存在工程里(换机器会一起带走):相机工位与检测方案的结构、绑定的相机序列号、模板图、所有检测项和检测框的参数、运行顺序里的指令、通讯地址与端口、运行模式与人工复判等工程级开关。

不在工程里(跟着这台机器走):

内容 存在哪
存图路径、存图格式、良率自动清零等系统设置 C:\Users\<用户名>\.labeldetect\sys_config.yaml
两个账号的密码 C:\Users\<用户名>\.labeldetect\account_config.yaml
运行端检测图小窗口的摆放布局 C:\Users\<用户名>\.labeldetect\layout\<工程名>.json
授权文件 C:\Users\<用户名>\.labeldetect\<UUID>.lic
有无检测的注册库 C:\Users\<用户名>\.labeldetect\ai_support
异常检测的注册库 C:\Users\<用户名>\.labeldetect\anomaly
光源控制器、通讯设备、报警灯等设备设置 同 sys_config.yaml

备份与搬到别的机器

备份:把整个 .lproj 文件夹拷走就是一份完整备份。改大动作之前,用运行端菜单"另存为..."存一份带日期的副本更省事——它只导出一份拷贝,不会切换你当前正在用的工程。

搬到另一台机器,按顺序做这四件事:

  1. 把 .lproj 文件夹整个拷过去,在新机器上用"打开工程"打开。
  2. 重新绑相机:新机器上的相机序列号和原来不一样。在调试端每个相机工位上右键"设置相机工位",重新勾选相机。
  3. 重新配系统设置和设备设置:存图路径、串口号、通讯地址这些都是跟机器走的,要在新机器上重新设一遍。
  4. 如果工程里用了有无检测或异常检测,注册库要单独搬:在原机器打开那个工具窗口,点"导出"把类型存成 zip;在新机器上打开同一个工具窗口点"导入"选那个 zip,导入后提示"导入成功, 请重新打开设置界面"。

注册库不跟着工程走

这是最容易漏的一步。只拷 .lproj 过去,有无检测和异常检测会因为找不到注册图而失效。

检测图存在哪

存图的开关和路径在运行端"设置 → 打开系统设置 → 存图设置"里,是跟着机器走的设置,不在工程里。选好"存图路径结构:"之后,下面的"预览:"会把目录格式直接写给你看。

两种常用结构:

按 SN+时间戳 分目录

存图根路径\工程名_SN_时间戳\PASS 或 NG\相机工位名_检测方案名\工程名_SN_时间戳.jpg

读不到 SN 时,目录名里就没有 SN 那一段。

按 物料号/供应商/批次 分目录

存图根路径\物料编码\供应商\批次\PASS 或 NG\相机工位名_检测方案名\时间戳.jpg

物料编码、供应商、批次三项在同一页填,三项都不能留空,否则运行时会报"物料编号/供应商/批次不能为空"。

两种结构有三个共同点:

  • PASS 图按你在"PASS图格式:"里选的格式存(jpg 或 png)。
  • NG 会存两张:一张原图(png),一张文件名以 _DEFECT.jpg 结尾的缺陷图,上面画着判 NG 的框。
  • 勾了"只存NG图片"就不存 PASS 图。现场强烈建议勾上,PASS 图很快能把硬盘塞满。

定期清理

在同一页勾上"是否循环存图"并设好"保存周期(天)",过期的图会自动删。再把"磁盘空间预警:"设成一个有余量的值,快满时日志区会提前告警。

常见问题

忘了超级管理员密码 联系我们处理。

点"导出诊断包"没反应 先用"查看日志"确认日志本身有内容。如果导出路径选在了没有写权限的位置,会提示"当前选择路径没有读写权限, 请重新选择路径",换一个位置再试。

换了电脑后打开工程,相机全是断开的 正常。相机是按序列号绑定的,换机器后要按上面"搬到别的机器"的第 2 步重新绑。

存图目录里只有 NG 没有 PASS "只存NG图片"勾上了。

相关页面