PCLauncher 产品使用说明¶
一、产品简介¶
醒空数字化训练系统是一套面向本地训练、团队协同训练、课程资源管理、训练成绩档案、设备管理和系统配置的桌面中控系统。系统采用本地桌面端承载统一操作入口，通过后端训练服务、设备服务、课程服务和应用服务完成课程加载、训练房间编排、设备绑定、成绩查询与系统参数保存。
本文档依据当前项目代码与本地页面核对结果编写，主要覆盖以下模块：
- 离线训练（我的训练）
- 协同训练（团队训练）
- 课程管理
- 训练档案
- 设备管理
- 系统设置
二、登录与主界面¶
1. 登录入口¶
访问系统后，未登录时会进入登录页面；已登录时会自动进入主页面。当前系统路由会检查激活状态与登录状态，未激活时进入产品激活页，未登录时进入登录页。
2. 主界面组成¶
登录后主界面包含顶部状态栏和左侧功能导航。
顶部状态栏显示当前时间、主题切换、语言切换、当前用户信息、系统消息、个人设置和退出登录入口。左侧功能导航按分组展示：
- 训练中心：我的训练、团队训练
- 资产管理：课程管理、课程中心、训练档案、用户管理
- 系统应用：应用中心、设备管理、系统设置、退出登录
菜单是否显示受系统菜单配置控制，因此不同部署环境中看到的菜单可能略有差异。
3. 训练模式选择¶
系统支持“非组队模式”和“组队模式”。开始离线训练或协同训练前，建议先在左侧导航进入“系统设置”，找到“组队训练”配置项并确认当前模式。
| 使用场景 | 设置方式 | 后续配置重点 |
|---|---|---|
| 单人或单设备训练 | 关闭“组队训练” | 选择一台设备、一个角色和课程参数 |
| 多人或多设备训练 | 开启“组队训练” | 为每名参训成员分别选择设备、角色和账号 |
“组队训练”开启后，“我的训练”中的课程设置会进入“组队训练设置”页面；“团队训练”的创建房间和加入房间流程也会使用组队成员选择逻辑。
三、核心功能详解¶
1. 离线训练（我的训练）¶
模块作用¶
"我的训练"用于浏览本地可用课程、查看课程介绍与历史成绩，并启动单人或组队形式的离线训练。系统会读取课程分类与课程列表，展示课程数量、训练次数、最高分、课程预览图、介绍视频、课程说明和能力诊断图表。
离线训练启动时，系统会创建或复用离线训练房间，设置课程和课程参数，绑定设备、账号与角色，并启动对应训练端。若系统设置中开启“组队训练”，离线训练可同时绑定当前 PC 与 MR 等多个设备一起训练。
操作指南¶
- 在左侧导航选择“我的训练”。
- 在左侧“课程类别”中选择分类，也可以使用搜索框按课程名称筛选。
- 点击课程卡片后，在右侧查看课程详情。
- 在“训练概览”中查看课程预览图、介绍视频和课程介绍文档。
- 在“能力诊断”中查看历史最好成绩、最近一次成绩和综合能力趋势；无训练记录时页面会提示暂无记录。
- 点击“进入训练”启动训练。若已有保存的课程启动配置，系统会检查设备状态并直接进入启动流程。
- 首次进入或配置不完整时，点击齿轮或按页面提示进入课程设置。
- 在课程设置中选择训练模式、设备、角色和课程参数。
- 点击“保存”仅保存启动配置；点击“保存并启动”保存配置后立即启动训练。
- 训练过程中可在顶部状态栏或训练页面退出当前训练；退出后系统按配置决定是否清理训练资源。
- 训练结束后可查看训练结果；关闭结果页后返回课程列表，并刷新对应课程成绩。
组队模式操作指南¶
适用于在本机直接启动多人或多设备离线训练的场景。使用前请先在“系统设置”中开启“组队训练”。
- 在左侧导航选择“我的训练”。
- 在课程列表中选择目标课程。
- 点击“进入训练”或课程详情中的设置按钮。
- 系统进入“组队训练设置”页面。
- 点击“+”添加参训成员。
- 为每一行参训成员选择设备、角色和账号。
- 如课程提供课程参数，在同一页面配置课程参数。
- 点击“保存”仅保存本课程组队启动配置。
- 点击“保存并启动”保存配置并启动离线组队训练。
- 训练开始后按课程要求完成训练，结束后查看结果页；需要继续同一课程时可在结果页点击“重新训练”。
组队模式下，系统会校验设备、账号和角色配置：同一设备不能重复选择，同一账号不能重复选择，角色人数不能超过课程配置容量。MR 设备还需要处于在线状态。
关键注意事项¶
- 单人训练设置支持 PC 和 MR 模式。PC 设备按本机或 PC 设备识别；MR 设备需要在线。
- 课程角色来自课程详情配置。若课程未配置角色，相关角色选择项可能为空。
- 未授权课程会显示“未授权”，不能直接开始训练；锁定课程会触发课程激活流程。
- 多人课程在单人模式下可能无法训练，需要启用组队训练或进入团队训练流程。
- 如果已有离线训练房间正在训练，启动新训练前系统会提示先停止当前训练。
2. 协同训练（团队训练）¶
模块作用¶
"团队训练"用于创建和加入局域网协同训练房间。页面分为"我创建的训练"和"附近可加入"两类房间列表。房主可创建房间、选择课程与参训成员、启动或结束训练、修改房间名称、更换课程、解散房间。加入端可发现附近房间，选择角色、设备和账号后加入训练。
协同训练依赖房间服务、局域网发现、房间详情拉取、参与者同步和 MQTT 事件通信。系统会在 HOST 与 JOIN 端之间同步房间状态、课程变更、成员绑定、训练启动和训练结束等事件。
操作指南：创建房间¶
- 在左侧导航选择“团队训练”。
- 在“我创建的训练”区域点击“创建房间”。
- 选择课程。页面会显示课程与参数设置入口。
- 根据当前配置选择单人或组队创建方式：
- 单人方式：选择房间名称、课程、角色和设备。
- 组队方式：添加参训成员，为每个成员选择设备、角色和账号。
- 点击“确认创建”或“保存并创建”。
- 创建成功后，房间显示在“我创建的训练”列表。
- 选中房间后，可查看课程与参数、成员信息和角色占用情况。
- 所有必要成员准备完成后，点击“启动训练”。
- 训练结束时点击“结束训练”；不再使用时可点击“解散”删除房间配置。
操作指南：加入房间¶
- 在“附近可加入”列表中选择发现到的房间。
- 如未自动发现，可点击搜索入口，通过 IP 查找房间并加入列表。
- 查看房间课程、状态、成员和可加入角色。
- 点击“加入”，按页面提示选择设备、角色和账号。
- 系统校验房间状态、角色占用、设备可用性和当前用户信息后加入房间。
- 加入成功后，按钮变为“退出房间”；需要离开时点击退出。
- 若房间已启动训练，可使用页面提供的“观看”入口打开观看流程。
组队模式操作指南：创建房间¶
适用于房主一次性配置多个参训成员，并让成员按房间配置加入训练的场景。使用前请先在“系统设置”中开启“组队训练”。
- 在左侧导航选择“团队训练”。
- 在“我创建的训练”区域点击“创建房间”。
- 选择目标课程。
- 系统进入组队创建页面。
- 填写房间名称。
- 点击“+”添加参训成员。
- 为每名参训成员选择设备、角色和账号。
- 如课程支持课程参数，完成参数配置。
- 点击“保存并创建”。
- 创建成功后，在“我创建的训练”列表中选中该房间。
- 等待其他成员加入，并在成员信息区域确认人员和设备状态。
- 确认无误后点击“启动训练”。
- 训练完成后点击“结束训练”；不再使用该房间时点击“解散”。
组队模式操作指南：加入房间¶
适用于 JOIN 端加入房主创建的组队协同训练房间。
- 在左侧导航选择“团队训练”。
- 在“附近可加入”区域选择目标房间。
- 若未发现房间，点击搜索入口，按现场提供的 HOST IP 和端口查找房间。
- 点击“加入”。
- 系统进入组队加入页面。
- 按页面提示选择可用设备和账号；角色列表会结合房间已有成员和课程角色配置显示可用状态。
- 点击“确认加入”。
- 加入成功后，等待房主启动训练。
- 训练结束或需要离开时，点击“退出房间”。
组队协同训练中，房主端和加入端会同步成员、课程和房间状态。若房主更换课程、关闭房间或解散房间，加入端会按同步事件清理当前加入状态。
关键注意事项¶
- 房间状态不允许加入时，页面会提示“当前房间暂不可加入”或“不能加入房间”。
- 同一个设备或账号不能重复绑定；角色人数不能超过课程配置容量。
- JOIN 端需要能访问 HOST 端广播地址和房间详情接口。
- 如果课程被房主切换，JOIN 端会收到同步事件并清理当前加入状态。
- 房主解散或关闭房间后，加入端会清理本机加入状态并关闭相关应用。
3. 课程管理¶
模块作用¶
“课程管理”用于管理本地课程资源，包括导入课程包、查看课程信息、组织课程分类等操作。
操作指南¶
- 在左侧导航选择“课程管理”。
- 页面加载完成后，可进行课程相关操作。
- 若页面无法加载，点击“重新加载”按钮重试。
操作指南：导入课程¶
- 在左侧导航选择“课程管理”。
- 进入页面后，确认顶部模块处于“课程管理”，并打开“课程列表”页签。
- 在左侧课程目录中选择目标目录，例如“默认课程”。
- 点击页面筛选区下方的“导入”按钮。
- 系统弹出“导入”窗口。
- 点击“请选择课程包”，从本机选择需要导入的课程包文件。
- 未选择课程包前，“确定导入”按钮不可用；如不继续导入，可点击“取消”或右上角关闭按钮。
- 选择课程包后，窗口会显示导入进度。
- 导入解析完成后，窗口下方显示待导入课程列表，可查看课程 ID、名称、状态、是否模板和可用范围。
- 确认待导入课程信息无误后，点击“确定导入”。
- 导入完成后，返回课程列表检查新增课程是否出现；必要时可使用搜索或筛选条件查找。
导入结果列表中的字段含义如下：
| 字段 | 说明 |
|---|---|
| 课程 ID | 课程的唯一编号 |
| 名称 | 课程的名称 |
| 状态 | 课程当前状态，通常为“正常” |
| 是否模板 | 标识该课程是否为模板课程 |
| 可用范围 | 课程的可见或可用范围，如“公开” |
课程中心补充¶
“课程中心”用于浏览云端课程分类和课程系列，支持搜索、分类筛选，以及订阅课程。
关键注意事项¶
- 导入课程前应先选择有效的课程包文件；未选择文件时“确定导入”按钮保持不可用。
- 导入过程中请等待进度完成，不要关闭导入窗口或刷新页面。
- 如果导入后课程列表未立即出现新课程，可刷新课程列表，或通过课程 ID/名称搜索确认。
4. 训练档案¶
模块作用¶
"训练档案"用于按组织、成员、课程和时间范围查询训练成绩记录。页面会读取组织列表、组织成员、所有用户、课程列表和训练成绩日志，并展示平均成绩、本月训练次数、成绩列表和结果详情。
操作指南¶
- 在左侧导航选择“训练档案”。
- 在“组织选择”中选择具体组织或“所有组织”。
- 在“成员列表”中选择成员，也可选择“所有”查看当前组织或所有组织成员的记录。
- 使用成员搜索框按姓名或账号筛选成员。
- 在右侧筛选栏选择开始日期、结束日期和课程。
- 点击“重置”可恢复默认时间范围并清空课程筛选。
- 在成绩列表中查看课程 ID、训练科目、成员、训练时间、训练得分、状态评估等信息。
- 点击“详情”打开训练结果详情页。
- 使用分页控件切换页码，或选择每页 10、20、50 条。
关键注意事项¶
- 默认记录范围为最近数月，具体由页面初始化逻辑计算。
- 系统会过滤部分访客或演示类账号，避免它们进入档案成员列表。
- 若某条成绩记录缺少课程名称，页面会根据课程 ID 再查询课程列表补全名称。
- 训练刚结束但成绩未生成时，可能需要稍后进入训练档案查询。
5. 设备管理¶
模块作用¶
"设备管理"用于管理 PC 与 MR 训练设备，查看设备在线状态、电量、型号、IP、挂载外设和 ADB 连接状态。页面支持搜索设备、按设备类型筛选、添加 MR 设备、添加本机 PC 设备、删除设备，以及在 MR 设备 ADB 已连接时进行外设绑定。
设备信息来自 ADB 接口、设备状态订阅接口和本机 ClientID。MR 设备状态包括在线状态、电量、电池状态、前台应用和 IP 等；PC 设备会显示本机标识、网络状态和运行时间等信息。
操作指南：查看设备¶
- 在左侧导航选择“设备管理”。
- 左侧设备列表展示设备名称、SN、类型和状态。
- 使用搜索框按名称、SN 或 IP 搜索。
- 点击筛选按钮可在全部、PC、MR 之间切换。
- 点击设备列表中的设备，在右侧查看详情。
- PC 设备详情展示 IP、ID、运行时间、设备型号、网络状态。
- MR 设备详情展示型号、电量、ADB 连接状态和挂载外设。
操作指南：添加 MR 设备¶
- 点击“添加设备”。
- 确认头显已开启 USB 调试、通过 USB 数据线连接本机，并连接局域网 WiFi。
- 在弹窗中选择已连接设备。
- 点击刷新按钮可重新检测 ADB 设备。
- 确认设备 ID、设备类型和 IP 后，点击“添加 MR 设备”。
- 添加成功后设备出现在左侧设备列表。
操作指南：添加本机¶
- 点击“添加本机”。
- 系统根据本机 ClientID 生成本机设备 SN 和名称。
- 若当前列表中已存在相同 SN，按钮会禁用并提示“设备列表中已存在同 SN 的设备”。
操作指南：外设绑定¶
- 选择 MR 设备。
- 确认页面显示“ADB 已连接”。
- 点击“绑定外设”进入远程绑定流程。
- 若 ADB 未连接，页面会提示需要先连接 ADB 并在头显上授权调试。
- 绑定保存后，页面显示已同步的外设绑定结果。
关键注意事项¶
- 删除 MR 设备会移除该头显在当前中控中的注册信息。
- 本机设备不会显示删除按钮。
- 添加 MR 设备依赖 ADB 检测；未检测到设备时请检查 USB 调试、数据线和头显授权。
- 页面中的外设列表仅展示已同步的绑定结果。
6. 系统设置¶
模块作用¶
“系统设置”用于配置界面显示、登录入口、训练资源清理、组队训练、应用安装目录、后端数据目录和日志写入等系统参数。
操作指南¶
- 在左侧导航选择“系统设置”。
- 页面主题：在“深色模式”和“浅色模式”之间切换。
- 语言：选择简体中文、English 或繁體中文。
- 免登录模式：开启后允许学员跳过登录直接进入训练中心。
- 全屏：开启或关闭应用窗口全屏显示。
- 退出训练时清理资源：开启后退出训练会清理训练使用的资源；关闭可提升下次训练启动速度。
- 组队训练：开启后“我的训练”可进入多设备组队训练设置。
- 应用安装目录：输入应用默认安装路径后点击“确定”保存。
- 后端数据目录：输入后端数据路径后点击“确定”保存。
- 日志：开启后前端日志写入文件。
关键注意事项¶
- 主题和语言也可通过顶部状态栏快速切换。
- 组队训练配置使用独立接口保存，保存失败时页面会提示。
- 应用安装目录和后端数据目录不能为空；保存失败时请检查路径权限和系统注册表写入权限。
- 全屏切换会立即调用窗口全屏或退出全屏能力。
四、常见问题与排查¶
1. 无法进入主界面¶
可能原因：
- 系统未激活。
- 登录状态失效。
- 保存的账号密码不可用。
排查方法：
- 确认产品激活页是否提示待激活。
- 重新进入登录页登录。
- 若启用了免登录模式，可使用“免登录进入”。
- 检查后端认证服务是否正常。
2. 我的训练没有课程或课程列表加载失败¶
可能原因：
- 课程分类或课程列表服务异常。
- 当前分类下没有课程。
- 课程筛选条件过窄。
排查方法：
- 点击课程列表刷新按钮。
- 切换到“所有课程”。
- 清空搜索框或点击“清除所有筛选”。
- 检查课程服务和后端数据目录配置。
3. 课程显示未授权，无法进入训练¶
可能原因：
- 课程未授权。
- 课程处于锁定状态。
排查方法：
- 查看课程卡片或课程详情中的“未授权”提示。
- 按页面弹出的激活流程输入课程激活码。
- 若授权仍失败，检查产品激活状态和课程授权信息。
4. 启动训练失败或提示未安装训练端¶
可能原因：
- 未安装仿真端或 PC 训练端。
- 保存的设备不存在或离线。
- 课程启动配置不完整。
排查方法：
- 到“应用中心”确认相关训练端应用已安装。
- 到“设备管理”确认设备在线。
- 回到课程设置重新选择设备、角色和课程参数。
- 若是 MR 设备，确认设备在线并能上报状态。
5. 团队训练无法发现附近房间¶
可能原因：
- HOST 与 JOIN 不在同一局域网。
- 房间广播或发现服务异常。
- HOST 房间未开放到可加入状态。
排查方法：
- 确认两端网络互通。
- 使用“通过 IP 查找房间”手动添加。
- 确认 HOST 端房间未关闭、未解散。
- 查看页面是否提示“发现附近房间失败”或“获取房间详细信息失败”。
6. 团队训练无法加入房间¶
可能原因：
- 房间状态暂不允许加入。
- 角色已占用。
- 设备或账号已绑定到其他成员。
- 当前登录用户信息不完整。
排查方法：
- 选择未占用角色。
- 更换可用设备或账号。
- 确认房主未更换课程或关闭房间。
- 退出其他房间后再加入。
7. 训练档案没有记录¶
可能原因：
- 当前组织或成员没有训练成绩。
- 日期范围不包含目标记录。
- 课程筛选排除了记录。
- 训练刚结束但成绩尚未生成。
排查方法：
- 选择“所有组织”和“所有成员”。
- 放宽开始日期和结束日期。
- 将课程筛选切换为“全部课程”。
- 稍后刷新页面再查看。
8. MR 设备无法添加或外设无法绑定¶
可能原因：
- 头显未开启 USB 调试。
- USB 未连接或未授权调试。
- 设备不在支持列表中。
- ADB 未连接。
排查方法：
- 开启头显 USB 调试。
- 使用 USB 数据线连接本机。
- 在头显上允许调试授权。
- 点击“添加设备”弹窗中的刷新按钮。
- 外设绑定前确认设备详情显示“ADB 已连接”。
9. 系统设置保存失败¶
可能原因：
- 配置服务异常。
- 路径为空。
- 目录或注册表写入权限不足。
排查方法：
- 确认路径不为空。
- 使用有效的本机目录路径。
- 重新点击“确定”保存。
- 若仍失败，检查应用运行权限和日志。
10. 课程管理页面空白或提示服务不可用¶
可能原因：
- 本机后端课程服务未运行。
- 无法获取后端服务地址。
- token 失效。
排查方法：
- 点击“重新加载”。
- 确认本机后端服务地址可访问。
- 退出登录后重新登录。
- 检查系统后端数据目录与服务启动状态。