# 小程序使用

小程序用于绑定本人有权管理的设备，远程查看运行状态、检测进度、检测结果和告警，并在
设备允许时发起检测控制、日志上传或软件更新。小程序中的页面名称和按钮位置可能随发布
版本调整，请以当前正式版本显示为准。

```{important}
小程序是远程操作入口，不替代现场安全确认。涉及进水、排水、试剂、清洗、标定、升级
或可能产生液体流动的操作前，必须确认设备现场有人值守，周围无漏液风险。
```

## 使用前准备

开始绑定前确认：

- 手机网络正常，小程序已获得必要的网络和扫码权限。
- 使用已授权的用户账号登录，不与他人共用账号。
- 设备已通电并完成启动，屏幕时间和设备编号正常。
- 设备已接入可用网络，云连接状态正常。
- 设备当前未处于升级、标定、清洗或其他不允许绑定的流程。
- 可以看到设备屏幕上的绑定页面、二维码或绑定码。
- 设备铭牌编号、所在位置和准备绑定的设备一致。

```{warning}
不要扫描来源不明的二维码，不要把绑定码、设备二维码或账号验证码发送到公开群聊、论坛、
工单截图或社交平台。
```

## 登录与账号安全

1. 从单位规定的正式入口打开小程序。
2. 使用本人账号登录，完成手机号或组织身份验证。
3. 首次使用时阅读并确认隐私和设备操作说明。
4. 进入“我的设备”或同类设备列表页面。
5. 核对页面显示的账号、组织或站点是否正确。

公共手机或临时借用手机不应保存长期登录状态。更换手机、人员离岗或账号异常时，应及时
退出登录，并由管理员检查该账号仍可访问的设备。

## 绑定设备

### 在设备端准备绑定

1. 在设备屏幕进入“连接”或“设备绑定”页面。
2. 等待页面显示二维码或绑定码。
3. 确认页面提示设备网络和云连接已就绪。
4. 保持该页面开启，不要在绑定过程中重启设备或切换网络。

若二维码或绑定码未显示，先检查设备网络状态。不要通过反复重启、恢复参数或更换账号来
跳过连接故障。

### 在小程序中完成绑定

1. 在设备列表点击“添加设备”“绑定设备”或扫码入口。
2. 扫描设备屏幕上的二维码；如当前版本支持手工输入，可输入屏幕显示的绑定码。
3. 核对设备编号、设备名称和安装位置。
4. 根据页面要求选择所属站点或填写便于识别的设备名称。
5. 点击“确认绑定”。
6. 等待小程序和设备屏幕均显示绑定成功。
7. 返回设备列表，确认新设备在线且编号正确。

绑定可能需要数秒完成。页面显示“处理中”时不要重复点击，也不要立即生成新的绑定码。

### 绑定完成确认

- 小程序设备列表中只出现一台对应设备，不存在重复条目。
- 设备编号与铭牌、屏幕和现场工单一致。
- 在线状态、设备时间和所在位置合理。
- 设备屏幕不再持续提示等待绑定。
- 可以打开设备详情并看到最近一次状态更新时间。

## 设备列表

设备列表用于快速判断哪些设备需要关注。常见信息包括：

| 页面信息 | 用户应如何理解 |
| --- | --- |
| 在线 | 小程序近期可以收到设备状态；不代表设备一定处于空闲 |
| 离线 | 当前无法确认设备最新状态；可能是断电、断网或连接异常 |
| 检测中 | 设备正在执行检测，不应重复启动冲突操作 |
| 已暂停 | 检测流程仍保留，需确认现场情况后选择恢复或停止 |
| 空闲 | 当前没有运行中的检测流程，仍需检查告警和现场条件 |
| 有告警 | 设备报告需要关注的异常，应进入详情查看故障信息 |
| 更新时间 | 当前页面数据最后一次更新的时间，不等同于手机当前时间 |

设备列表长时间未刷新时，先下拉刷新或重新进入页面。仍无更新则按“设备离线”处理，不要
根据旧状态远程启动操作。

## 设备详情

进入设备详情后，建议按以下顺序查看：

1. 核对设备名称、设备编号和安装位置。
2. 查看在线状态和最近更新时间。
3. 查看当前运行状态：空闲、检测中、暂停、维护、升级或故障。
4. 查看检测总进度及各项目进度。
5. 查看当前告警和最近恢复记录。
6. 查看试剂、存储、网络等用户可见状态。
7. 确认无冲突后再使用控制按钮。

```{note}
“在线”只表示远程连接可用；“空闲”只表示没有当前检测流程。开始检测前仍需确认样品、
试剂、废液、管路和设备现场安全。
```

## 远程启动检测

### 启动前确认

- 现场人员已放置正确样品并确认样品量充足。
- 试剂有效且余量满足本次检测。
- 废液容器未满，进排水管路无折弯、脱落或泄漏。
- 设备处于空闲状态，没有标定、清洗、升级或其他维护任务。
- 小程序显示的数据更新时间正常，设备没有未处理的严重故障。
- 已选择正确的检测项目和适用的稀释设置。

### 启动步骤

1. 进入目标设备详情，核对设备编号。
2. 点击“开始检测”或进入检测设置页面。
3. 选择需要检测的项目。
4. 检查稀释或样品设置，不确定时使用现场作业规程规定的选项。
5. 阅读页面列出的前置条件和风险提示。
6. 点击确认，并等待小程序显示设备已接受本次任务。
7. 继续等待状态切换为“检测中”，再离开当前页面。

提交后如果页面一直显示“处理中”，不要连续点击“开始检测”。先刷新设备状态；无法确认
是否已启动时，应联系现场人员查看设备屏幕和液体动作。

## 查看检测进度

检测运行期间，小程序可能显示总进度、单项进度、当前阶段和预计状态。使用时注意：

- 总进度用于了解整轮检测完成程度，不代表每个项目同步推进。
- 单项显示“完成”后，整轮检测仍可能继续清洗、排水或保存记录。
- 页面暂时没有变化不一定表示设备停止，应结合更新时间和设备在线状态判断。
- 网络中断期间显示的进度可能是旧数据，恢复连接后应重新刷新。
- 收到警告时先查看说明，不要仅关闭提示后继续等待。

只有页面明确显示整轮检测完成，并且结果和完成时间已经更新，才能将本次任务视为完成。

## 暂停、恢复与停止

| 操作 | 适用情况 | 用户操作要求 |
| --- | --- | --- |
| 暂停 | 现场需要短暂检查，且当前阶段允许暂停 | 点击一次后等待状态变为“已暂停” |
| 恢复 | 暂停原因已消除，设备和现场均允许继续 | 先核对设备仍为同一检测任务，再确认恢复 |
| 停止 | 样品错误、漏液风险、试剂异常或任务不再需要 | 确认终止提示，并等待设备完成安全收尾 |

暂停或停止请求提交后，小程序可能先显示“已受理”。这并不表示执行器已经立即停止，应
等待最终状态，并由现场人员确认泵、阀、搅拌和液体流动已经停止。

```{warning}
发生漏液、焦味、冒烟、异常发热或持续异响时，不要只依赖小程序停止。现场人员应立即按
安全规程停止设备并切断电源。
```

## 查看检测结果

检测完成后，结果页面应至少核对：

- 设备编号和安装位置；
- 样品或任务名称；
- 检测开始和完成时间；
- 实际检测项目；
- 各项目结果、单位和有效状态；
- 是否存在超量程、无效或需要复测的标记；
- 本次检测是否伴随告警或中止记录。

结果显示大于或小于量程边界时，应按超量程结果处理，不能把边界数字当作精确测量值。
结果无效、项目缺失或时间不合理时，不应抄录或对外发布，应先查看告警并安排复测。

## 历史记录与数据分享

在“检测记录”“历史结果”或同类页面中，可以按设备和时间查看已同步的记录。使用要求：

- 通过设备编号、检测时间和项目共同确认记录身份。
- 页面没有最新记录时先刷新，并确认设备已完成保存和联网同步。
- 分享或导出前检查是否包含个人信息、站点信息或其他敏感内容。
- 不通过截图替代正式数据留存；需要归档时使用单位规定的导出方式。
- 小程序记录与设备本地记录不一致时，以完成核对后的正式记录为准，并保留异常说明。

设备本地日志和完整数据的下载方法见[日志查看与数据下载](logs-and-data-export.md)。

## 告警与健康状态

小程序可能显示提示、警告、故障和恢复信息。收到告警后：

1. 记录设备编号、告警名称、故障码、出现时间和当前任务。
2. 查看告警详情中的现象和建议操作。
3. 判断是否需要暂停、停止或立即安排现场断电。
4. 联系现场人员检查样品、试剂、废液、管路、电源和设备外观。
5. 故障原因消除后刷新页面，等待状态恢复。
6. 按要求完成一次验证，并记录处理结果。

不要因为小程序重新登录后告警不再置顶，就认为故障已经恢复。完整故障说明和排查方法见
[健康管理故障码](fault-code-reference.md)与[常见问题排查](troubleshooting.md)。

## 日志归档与上传

当售后或维护人员要求上传日志时，可在小程序中打开对应设备和时间范围，选择“上传日志”
“提交诊断资料”或当前版本提供的同类功能。

1. 先确认设备在线、空闲且存储状态正常。
2. 选择与问题发生时间对应的日志范围。
3. 阅读流量、时间和隐私提示。
4. 确认上传后保持设备联网，不要立即关机或重启。
5. 等待页面显示上传完成，并记录任务时间或服务单号。
6. 上传失败时保留失败提示，不要短时间连续重复提交。

日志上传可能经历准备、打包和传输多个阶段。显示“处理中”时不代表失败；只有页面明确
显示完成后，售后人员才能在服务流程中使用该资料。

## 软件更新

小程序显示有新版本时，应先阅读版本说明，并确认现场满足升级条件：

- 设备处于空闲状态；
- 供电和网络稳定；
- 当前没有检测、维护、标定或日志上传；
- 现场有人值守，升级期间不会断电或移动设备；
- 重要数据已保存，当前告警已记录。

确认升级后，应保持页面和设备连接，观察下载、安装和重启阶段。设备重启并重新上线后，
核对设备状态和版本信息。长时间无进展、反复重启或升级失败时，不要反复点击升级，按
[软件更新](software-update.md)中的失败处理流程操作。

## 解绑设备

只有设备转移、账号变更、站点调整或管理员明确要求时才应解绑。

1. 确认设备没有运行中的检测、维护或升级任务。
2. 核对待解绑设备编号，防止选错设备。
3. 在设备设置中选择“解除绑定”。
4. 阅读解绑影响并完成身份确认。
5. 等待小程序显示解绑完成。
6. 查看原账号的设备列表，确认设备已移除。
7. 如需交接，由新用户在设备现场重新完成绑定。

```{warning}
解绑可能使当前账号失去远程查看和控制权限。不要用解绑处理普通离线问题，也不要在无法
确认设备现场状态时远程解绑。
```

## 多人和多设备管理

- 每台设备使用清晰且唯一的名称，建议包含站点和位置。
- 操作前始终核对设备编号，不仅看用户自定义名称。
- 管理员、操作员和只读人员应使用各自账号和权限。
- 不共享登录验证码，不使用同一账号代替人员权限管理。
- 重要远程操作应能追溯到操作人、设备和时间。
- 人员离岗或职责变化后及时调整访问权限。
- 批量查看设备时，优先处理严重告警和长时间离线设备。

## 常见问题排查

| 现象 | 常见原因 | 处理方法 |
| --- | --- | --- |
| 扫码后提示无效 | 二维码已刷新、绑定码过期或扫错设备 | 返回设备绑定页获取当前二维码，重新核对设备编号 |
| 一直显示绑定中 | 设备未连接云端、手机网络异常或绑定确认未完成 | 保持设备绑定页，检查双方网络，稍后刷新；不要连续提交 |
| 提示设备已绑定 | 设备仍属于原账号或原组织 | 联系原管理员核对并按交接流程解绑，不要恢复设备参数 |
| 设备显示离线 | 设备断电、断网、通信异常或状态尚未更新 | 联系现场确认供电和网络，查看设备屏幕连接状态 |
| 状态长时间不刷新 | 手机网络差、页面停留过久或设备连接中断 | 下拉刷新或重新进入详情，核对最后更新时间 |
| 点击开始后没有结果 | 请求仍在处理、设备忙或现场条件检查失败 | 查询当前状态，查看提示；不要重复点击开始 |
| 提示设备忙 | 正在检测、维护、标定、升级或保存数据 | 等待当前流程结束，或由现场人员按规程安全停止 |
| 无法暂停或恢复 | 当前阶段不支持、状态已变化或连接中断 | 刷新状态并查看设备屏幕，不要连续点击 |
| 结果没有更新 | 检测未完成、记录未同步或网络中断 | 核对完成状态和时间，恢复网络后刷新历史记录 |
| 收到告警但现场正常 | 状态刚恢复、页面仍显示历史信息或存在间歇故障 | 查看告警时间和恢复状态，仍需按故障码完成检查 |
| 日志上传失败 | 设备离线、存储忙、空间不足或正在执行其他任务 | 保持设备空闲和联网，检查存储状态后再提交一次 |
| 升级长时间无进展 | 网络不稳、设备忙或升级阶段尚未完成 | 不断电、不重复点击；记录页面阶段并按升级章节处理 |
| 解绑后仍显示设备 | 页面缓存未刷新或解绑确认尚未完成 | 重新进入设备列表；持续存在时联系管理员核对 |

## 隐私与使用规范

- 只绑定和操作本人被授权管理的设备。
- 不公开设备二维码、绑定码、账号验证码和含身份信息的截图。
- 分享检测结果前按单位要求移除不必要的个人和站点信息。
- 不在小程序备注中填写密码、访问凭据或其他敏感信息。
- 手机丢失后立即冻结账号或修改登录方式，并通知管理员检查操作记录。
- 发现未知设备、未知登录或不属于本人的操作记录时，立即停止远程操作并上报。

仍无法解决时，向管理员或售后提供设备编号、发生时间、小程序版本、手机系统版本、页面
完整提示和现场设备状态。不要提供账号验证码、绑定码或其他敏感凭据。