软件功能常见问题
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 内存异常
问题：软件运行期间，内存占用持续升高
影响版本：所有版本
可能原因：在软件运行中打开了文件管理器，Visual Studio Code 查看特定的文件夹. 由于软件运行期间会往此文件夹写入文件，文件数量增加，导致查看此文件夹时内存占用不断升高。
解决方案：关闭文件管理器，Visual Studio Code以及其他内存占用较高的软件
1.6 首次运行报错glia_error
问题：首次运行报错glia_error，无法下载所需的通用模型
影响版本：所有版本
解决方案：根据报错内容在该文档中下载对应模型以及放置在对应的路径下
1.7 开机自启动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系统未关闭防火墙导致的。
解决方案：到现场配置即可。
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，因此看起来会比检测管线总耗时总是稍多一点。
【开启多工作流缓存】工作流缓存的含义
不开启：后端单实例模式，每次切换作业都会触发后端实例的重新加载，包括资源注册/节点生成等，
开启后：后端多实例模式，在硬件资源允许的情况下，最大化缓存多个实例，每次切换作业只有第一次运行时，会执行实例加载，而后会缓存起来，之后的每次运行，不再需要注册操作
当存在多个作业，且这些作业频繁进行切换时，开启多工作流缓存功能可以避免频繁的实例创建/注册操作，提升节拍