排障与附录
常见故障排查、技术支持信息、培训检查表与快速检查清单。
最新文档
排障与附录
状态与故障排查
| 现象 | 可能原因 | 建议处理 |
|---|---|---|
| 无法登录 | 账号/密码错误、网络不可用、账号未授权 | 检查输入和网络；联系账号管理员 |
| 当前无设备连接 | 设备未开机、线缆松动、系统未识别 | 检查供电与线缆，重新检测 |
| 未检测到设备 | 接收器异常、端口被占用 | 重新插拔；关闭其他手套软件 |
| 激活失败 | 网络、账号权限或设备状态异常 | 保持连接，检查权限后重新激活 |
| 确认连接不可用 | 未选择设备或选择组合不合法 | 至少选择一台；每侧最多一台 |
| 标定过程无法继续 | 设备断连、动作不稳定、当前手侧错误 | 退出，恢复连接后重新完整标定 |
| 模型不可选择 | 算法包缺失或账号无权限 | 检查算法包页与交付授权 |
| 模型不跟随 | 输入来源错误、连接中断或任务未启动 | 检查卡片输入来源并重新启动 |
| 动作偏差明显 | 标定或佩戴不一致 | 重新佩戴并完成 8 步标定 |
| 画面卡顿 | 模型过多、主机负载高、Debug 过密 | 减少模型；用 Summary 并增大采样间隔 |
| 日志文件过大 | Raw/Full 且采样频率高 | 改用 Summary，结束后关闭记录 |
| 更新停滞 | 网络或服务异常 | 保持软件运行，记录状态并联系支持 |
技术支持信息
- 软件版本、操作系统与发生时间。
- 账号环境（不要发送密码）、设备名称、完整 SN、左右手。
- 所选模型、算法包版本和输入来源。
- 从登录开始的最短复现步骤、预期结果与实际结果。
- 界面截图、对应时段的 Debug 文件，以及是否可稳定复现。
管理与维护建议
标定管理
- 以“设备 SN + 左右手 + 使用者/项目”建立记录，避免多人共用同一标定而不做区分。
- 更换手套、明显改变佩戴位置、软件/算法包要求迁移时重新标定。
- 覆盖或删除前执行双人核对，生产演示前保留可恢复的已验证版本。
版本管理
- 记录上位机、固件和各模型算法包版本，测试与演示环境尽量保持一致。
- 更新前保留发布说明和回退路径；更新后完成设备、标定、模型和日志四项冒烟测试。
- 不要把本说明书截图中的示例版本号直接作为交付版本号。
日志与磁盘
- 为 Debug 设置专用保存目录，确保当前账号有写入权限。
- 定期审查历史文件大小和保留周期；删除前确认工单或问题已关闭。
- Raw 数据仅短期保存，并限制访问与传输范围。
培训检查表
| 能力项 | 完成 |
|---|---|
| 能独立登录并识别账号问题 | ☐ |
| 能根据 SN 和左右手选择设备并处理激活失败 | ☐ |
| 能规范完成左右手 8 步标定 | ☐ |
| 能选择模型、设置输入来源并验证仿真 | ☐ |
| 能配置 Summary Debug 并下载历史文件 | ☐ |
| 理解覆盖标定、删除文件和更新操作的风险 | ☐ |
| 能收集完整的技术支持信息 | ☐ |
附录
快速检查清单
| 启动前 | 运行中 | 结束后 |
|---|---|---|
| 设备供电与连接正常 | 输入来源正确 | 停止仿真 |
| 账号与网络可用 | 模型同步响应 | 导出必要日志 |
| SN/左右手已核对 | 无异常提示或明显卡顿 | 确认无更新任务 |
| 标定有效 | Debug 仅按需开启 | 退出软件后断开设备 |
界面差异处理
软件可能因产品迭代、账号权限、设备型号或项目定制而与本说明书截图存在差异。遇到差异时，优先遵循交付版本的界面提示和发布说明；对于会删除数据、覆盖标定、升级系统或固件的操作，在无法确认时应停止并联系技术支持。
支持信息格式
问题标题：[设备 SN / 左右手 / 模型] 简述现象，例如：[7539…9201 / 左手 / Sharpa HA4] 握拳时模型无响应。
| 字段 | 填写内容 |
|---|---|
| 发生时间 | 年-月-日 时:分:秒，注明时区 |
| 环境 | 上位机版本、操作系统、固件版本、算法包版本 |
| 设备 | 设备名称、完整 SN、左/右手、电量/连接方式 |
| 复现步骤 | 从登录或连接开始的编号步骤 |
| 预期/实际 | 分别描述，不使用“有问题”等模糊表述 |
| 附件 | 截图、视频、对应时段 Debug 文件 |