# 日志与检测数据查看、下载

设备会保存运行日志、检测过程记录、状态记录、事件记录和检测归档。不同文件用途不同，现场问题应尽量收集同一检测会话的完整文件组。

## 可以从哪里查看

| 入口 | 可查看内容 | 适用场景 |
| --- | --- | --- |
| 触摸屏日志页面 | 本次开机的用户可见事件和故障 | 现场快速排查 |
| USB/维护终端 | 实时文本、指令响应和运行过程 | 复现问题和观察响应码 |
| 标定工站“日志”页签 | 工站任务、设备响应和操作过程 | 标定与测试问题 |
| 标定工站“最近结果”等页签 | 标定、精度、OCR、参数校验和事件结果 | 质量判定和报告 |
| SD 卡可移动磁盘 | 完整原始记录和归档 | 深入分析、备份和提交支持 |
| 云平台 | 已上传的检测记录或归档 | 远程支持和批量管理 |

## 触摸屏日志页面

<div class="figure-placeholder">
  <strong>触摸屏日志页面示意图待补充</strong>
  <span>后续图片应标出：日志入口、时间、等级、事件内容、筛选和退出按钮。</span>
</div>

1. 从触摸屏首页进入“日志”或事件记录页面。
2. 等待本次开机的历史事件加载完成。
3. 使用页面筛选查看全部、警告、错误或其他可用分类。
4. 记录故障编号、时间、操作阶段和完整提示。
5. 拍照时包含设备编号或同步记录设备编号。

触摸屏日志主要用于现场查看，不等于 SD 卡中的完整运行日志。设备重启后，页面缓存内容可能变化，因此重要问题应及时拍照并导出文件。

## USB 实时日志

1. 按“电脑与标定工站连接”章节连接虚拟串口。
2. 在终端软件中启用会话记录或保存到文件。
3. 从操作前开始记录，覆盖问题发生、故障提示和设备恢复全过程。
4. 保留每次指令的 `202` 和最终 `200/400/409/499/500`。
5. 完成后停止捕获并使用设备编号和时间命名文件。

建议文件名：

```text
设备编号_YYYYMMDD_HHMM_操作名称_现场日志.txt
```

不要只截取最后一行错误；排查通常需要错误前的动作、响应码和同时出现的健康故障。

## 标定工站日志与结果

工站底部反馈区通常包含：

- 最近结果：目标量、实测量、误差、耗时和结果。
- 精度评估结果：测量值、真值、相对误差、一致性和重复性。
- OCR识别：各称重通道抓拍和读数。
- 参数校验：进水、试剂、颜色和总参数检查结果。
- 挂测与事件：时间、流程、事件等级、对象和详情。
- 日志：任务过程、设备响应和人工操作。

### 导出工站日志

1. 等待任务结束或安全暂停。
2. 打开底部“日志”页签。
3. 点击“导出日志”。
4. 选择工单对应目录并确认文件成功生成。
5. 同时导出“最近结果”和需要的精度/参数校验结果。

### 导出报告

- 标定任务使用“导出标定报告(PDF)”。
- 测试任务使用“导出测试报告”。
- 选择正确的时间范围，避免把其他设备或其他班次混入报告。
- 导出后核对设备编号、时间、操作员、标准液和结果完整性。

清空页签前必须先导出。任务运行中不要断开串口或关闭工站来获取文件。

## 通过 USB 可移动磁盘下载设备文件

### 下载前

1. 等待检测、清洗、校准、归档、上传和存储全部结束。
2. 确认设备空闲，工站没有运行任务。
3. 退出工站交互，使可移动磁盘恢复。
4. 等待 Windows 完成识别。

### 复制步骤

1. 在“此电脑”打开设备可移动磁盘。
2. 根据问题发生时间进入相应目录。
3. 将所需文件复制到电脑的新建工单目录。
4. 比较复制前后的文件大小，确认传输完整。
5. 不在设备磁盘上直接打开大型文件或修改文件内容。
6. 复制完成后关闭所有文件窗口。
7. 使用 Windows“弹出”安全移除磁盘，再断开 USB。

## SD 卡主要目录

| 目录 | 内容 | 查看方式 |
| --- | --- | --- |
| `LOGS` | 人工可读的运行文本日志，通常为 `.log` | 复制后用文本编辑器查看 |
| `TLV` | 检测过程的结构化原始记录，通常为 `.tlv` | 使用配套分析工具，不用文本编辑器判断内容 |
| `TELEM` | 检测过程状态记录，通常为 `.telem` | 复制后由支持工具分析 |
| `EVT` | 检测事件记录，通常为 `.evt` | 可用于按时间追踪故障和恢复 |
| `ARCHIVE` | 一次检测的组合归档，可能为 `.tar` 或 `.tar.menc` | 使用配套解包/解密工具 |
| `PARAM/export` | 参数导出和备份文件 | 用于配置核对，修改需授权 |
| `Firmware` | 软件升级相关文件 | 日志下载时不要修改或删除 |

文件名通常包含设备编号和时间戳。排查单次检测时，应选择同一设备编号、相近开始时间的一组 `LOG/TLV/TELEM/EVT` 文件。

## 推荐收集的完整问题包

```text
设备编号_YYYYMMDD_HHMM_问题简述\
  现场说明.txt
  屏幕照片\
  工站日志\
  工站结果或报告\
  LOGS\
  TLV\
  TELEM\
  EVT\
  ARCHIVE\
  参数导出\
```

“现场说明”至少包含设备编号、版本、发生时间、样品与试剂、操作步骤、响应码、健康故障码、已执行处理和当前状态。

## 检测归档下载

检测结束后，设备可能生成一个包含参数、运行日志、过程记录和事件记录的归档文件。

- `.tar`：未加密归档。
- `.tar.menc`：加密归档，需要授权工具和该文件生成时对应的设备凭据。
- 临时或未完成文件不应作为完整归档提交。
- 云端上传启用时，归档可能自动上传，也可能等待操作员确认。

### 从设备下载

在可移动磁盘的 `ARCHIVE` 目录按设备编号和时间选择文件，复制到电脑。确认文件大小不是 0，且复制过程中没有存储错误。

### 从云平台下载

1. 打开该设备的记录或文件页面。
2. 按检测时间和归档标识找到对应上传任务。
3. 确认上传状态完成、文件大小和校验信息有效。
4. 下载到受控工单目录。
5. 下载失败时检查 `1713` 归档失败、`1715` 上传失败和网络状态。

具体云平台按钮名称可能随部署版本变化，应以现场平台权限和发布说明为准。

## 加密归档的处理

```{warning}
设备访问令牌属于敏感信息，不得写入公开工单、聊天截图或普通日志。
```

常规操作员只需下载并提交 `.tar.menc`。需要本地查看时，由授权人员使用项目提供的 Windows PowerShell 工具：

1. 使用归档生成时的设备编号和访问凭据解密为 `.tar`。
2. 使用 Windows `tar.exe` 解包。
3. 使用配套展开工具处理归档内带 `.hs` 后缀的压缩文件。
4. 在解包目录查看 `.log`、`.telem`、`.evt`、参数文件等。

出现认证失败时，常见原因是凭据不匹配、设备后来更换了访问令牌或文件损坏。不要通过公开发送访问令牌来请求协助。

## 如何查看各类文件

### 文本日志

- 使用支持 UTF-8 的文本编辑器。
- 从问题时间向前查看完整操作链，不只搜索“ERROR”。
- 同时搜索设备编号、响应码、健康故障编号和操作名称。
- 注意同一故障可能只首次记录一次，后续应结合恢复事件判断持续时间。

### 事件记录

按时间顺序整理“开始、警告/错误、设备动作、恢复、最终响应”。如果缺少恢复事件，不应假设故障已经清除。

### TLV和状态记录

这类文件包含结构化过程数据，应用配套查看工具解析。不要因为文本编辑器显示乱码就判断文件损坏。

### 参数导出

用于核对设备当时的业务和校准设置。支持人员应使用与固件版本匹配的参数表查看；未经批准不要把旧参数文件重新导入设备。

## 日志下载问题排查

| 现象 | 常见原因 | 处理方法 |
| --- | --- | --- |
| 无可移动磁盘 | 工站交互仍占用、USB枚举或存储异常 | 结束工站任务并断开，等待恢复；检查设备管理器 |
| 磁盘能打开但目录为空 | 记录未启用、会话未完成或选错介质 | 核对检测时间、SD 卡和记录设置 |
| 文件复制失败 | SD 卡错误、USB接触不良或文件仍在写入 | 停止复制，等待设备空闲，检查 `1703/1707` |
| 最新日志缺少结尾 | 检测/记录仍未完成或异常断电 | 等待正常收尾；同时收集事件和诊断记录 |
| 没有归档 | 自动归档未启用、源文件缺失或归档失败 | 检查原始目录和 `1713` |
| 归档无法上传 | 网络断开、文件异常或上传失败 | 检查平台连接和 `1715` |
| 加密归档无法打开 | 直接当普通tar打开、凭据不匹配或文件损坏 | 使用授权解密工具并核对文件生成时凭据 |
| 工站日志被清空 | 未先导出或软件重启 | 收集设备SD日志；后续先导出再清空 |

## 数据安全

- 日志可能包含设备编号、位置、账号状态和业务数据，应按单位数据制度保存。
- 访问令牌、密码和密钥不得进入普通日志包。
- 提交外部支持前应确认是否需要脱敏。
- 原始文件应保留只读副本，分析在复制件上进行。
- 删除或格式化设备数据前必须确认备份完整并获得授权。