外观
软件功能常见问题
约 2400 字大约 8 分钟
2026-01-26
1. 软件启动/关闭/重启/运行
1.1 白屏
问题:打开软件显示白屏
影响版本:所有版本
解决方案:需要接入显示器,才能正常显示。
1.2 黑屏
问题:点击运行后,电脑黑屏断电重启
影响版本:所有版本
解决方案:可能是电源功率不足,需要查看电源功率,建议大于250W。
1.3 异常断电导致软件无法启动
问题:异常断电后无法启动软件,一直报错“请重启软件”
影响版本:所有版本
解决方案:
查看 用户目录下 .dexforce/project/project_recent.ini 文件
打开 第一个路径的文件夹 下 dexforce_proj.json 查看是否为文件损坏
如果是文件损坏,则将此文件夹改名,PickWiz会重新打开下一个项目 即可正常打开PickWiz(如果需要使用当前项目文件,则可使用备份覆盖)
使用影子模式,注意查看 latest_info.json 文件是否损坏



1.4 显存异常
问题:软件运行时一直报错显存错误

影响版本:
可能原因:
加载了两个模型后,剩余显存不足以支撑推理

解决方案:
1.5 首次运行报错glia_error
问题:首次运行报错glia_error,无法下载所需的通用模型
影响版本:
可能原因:
解决方案:根据报错内容在该文档中下载对应模型以及放置在对应的路径下


1.6 开机自启动PickWiz
问题:在pickwiz里关了自启动后重启,仍然会启动一份pickwiz
影响版本:所有版本
可能原因:用户在任务计划程序中添加了开机启动PickWiz的自定义任务,和PickWiz自带的开机自启动冲突。

解决方案:删除自定义的开机启动程序后, PickWiz 可正常开机自启动。
若需设置 PickWiz 开机自启,可在主界面点击菜单>开机时自动启动PickWiz>开启

2. 交互
2.1 显示异常
问题:用户界面因为分辨率问题,导致一些控件点不到
影响版本:
可能原因:
解决方案:目前软件暂不兼容不同的分辨率(1920×),使用鼠标中键或者拉动调整选择框大小。
3. 用户信息注入
3.1 工件点云信息替换失败
问题:替换点云文件时,软件报错,而且要导入的模板会被自动清除

影响版本:
可能原因:导入的点云文件不能放在项目目录下的product/product_1/resource目录下,需要从其他目录导入

解决方案:将导入的点云文件从项目目录下的product/product_1/resource移至其他位置。
3.2 末端工具模型解析失败
问题:导入夹具模型时报配置文件解析失败
可能原因:目前软件暂不支持项目路径中带中文
解决方案:目前软件暂不支持项目路径中带中文,请使用全英文路径
3.3 2D 识别分割不全
问题:2D 识别分割不全
可能原因:ROI 没有框全目标区域
解决方案:ROI 没有框全,应将工件全部框住。

4. 历史数据
4.1 历史数据抓取策略/视觉参数未生效
问题:运行历史数据后,抓取策略/视觉参数未生效
可能原因:使用了历史数据的运行配置,所以当前作业的抓取策略/视觉参数不生效。
解决方案:修改为使用当前作业配置后正常。

4.2 正常历史数据异常报错
问题:测试运行之前正常输出结果的历史数据后,提示满检功能异常报错。


可能原因: 这类情况大多数是因为使用了不同的作业/ROI3d时出现,由于当前历史数据的点云与当前使用roi不一致,可能造成实例点云的上方加入很多噪点,从而抛满检异常。
解决方案:需要确定作业一致或调整roi。
4.3 generate_pcds_by_bboxes的scale参数是否生效
问题:generate_pcds_by_bboxes的scale参数设置前后没有生效对比
影响版本:
可能原因:函数generate_pcds_by_bbox在实例过滤节点,用于点云的生成,调整这个函数的效果需要在历史数据的点云文件中去看效果,不会在前端界面可视化出来。
解决方案:具体方式如下

4.4 历史数据批量运行后无法使用相机数据
问题:历史数据批量运行后,无法使用相机数据
影响版本:
可能原因:当输入数据处于”相机数据“时,执行”批量运行历史数据“,会导致输入模式错乱
解决方案:正确操作步骤如下:
5. 机器人
5.1 加载机械臂模型失败报警
问题:1.4.1升级到1.4.5后复制的作业中看不到之前的机械臂配置。

影响版本:
可能原因:
解决方案:
5.2 通讯对接
问题:通讯协议对接时,机器人与通讯助手通讯数据传输正常,通讯助手与PickWiz数据传输正常,机器人发送的拍照指令PickWiz软件接收不到
影响版本:所有版本
可能原因:该问题是通讯中经常会遇到的问题,Windows系统未关闭防火墙导致的。
解决方案:FAE到现场配置即可。

6. 加密狗
6.1 加密狗检测错误(27)
问题:加密狗检测错误(27)

可能原因:使用了windows自带的远程桌面连接
解决方案:不能使用windows自带的远程桌面连接(有泄密风险),必须使用显示器/todesk/向日葵:

6.2 加密狗检测错误(31)
问题:加密狗检测错误(31)

可能原因:表示未授权
解决方案:联系公司管理员进行授权
7. 节拍
【双目拍照耗时记录】
A:双目相机取图时间(仅拍照、模型推理,以及整体时间)日志记录在路径:C:\Users\dex\.dexforce\log\pickwiz,找到时间最近的INFO日志,用记事本打开

【耗时长:实例多引起】实例数量非常多时,点云生成耗时长
GliaRcnn的mask_on参数设置为false,表示不传输mask;
1.4.2 以下版本,点云生成选择使用处理函数:generate_pcds_by_masks
1.4.3+,点云生成选择使用处理函数:generate_pcds_by_bboxes
【日志含义】后端日志中各个耗时的含义
节点计算总耗时:从进入第一个节点到退出最后一个节点的总用时,包括各节点算法运行、处理函数运行的总时间
检测管线总耗时:从触发调用PickLight的检测接口开始到结束的总用时,其中包括:配置比较、节点更新、算法注册以及上述的节点计算总耗时
本次检测流程总耗时:从收到相机数据开始到计算得到抓取点的总用时,其中包括:作业配置解析、资源注册、节点生成以及上述的检测管线总耗时,这个时间表示后端部分一次计算的真正用时,第一次运行时注册时间会比较久,之后的每次计算,如果配置不变的情况下,会有额外的内存回收时间,目前大概在0.1-0.2s,因此看起来会比检测管线总耗时总是稍多一点。

【开启多工作流缓存】工作流缓存的含义
不开启:后端单实例模式,每次切换作业都会触发后端实例的重新加载,包括资源注册/节点生成等,
开启后:后端多实例模式,在硬件资源允许的情况下,最大化缓存多个实例,每次切换作业只有第一次运行时,会执行实例加载,而后会缓存起来,之后的每次运行,不再需要注册操作
当存在多个作业,且这些作业频繁进行切换时,开启多工作流缓存功能可以避免频繁的实例创建/注册操作,提升节拍
