# 输出格式

COM Agent 可将每次完成的测量写入文件。请选择一个**输出文件夹**并勾选一种或多种**输出格式**。这些格式可以自由组合。

![](../_images/com-agent-output-formats-zh-Hans.png)

## 输出文件夹

单击*输出文件夹*旁边的**浏览…**，选择文件的写入位置。每次测量都会创建一个具有唯一时间戳名称的新文件，因此不会覆盖任何内容：

```
2025-10-11T11-03-56Z-00007-3f9c1a2b-….csv
```

该名称包含 UTC 时间戳、一个递增计数器和一个唯一标识符。

## 格式

| 格式 | 产生的内容 |
| --- | --- |
| **文本文件 (.txt)** | 完全按照从仪器接收到的原始数据，不做任何处理。适用于所有仪器。 |
| **CSV 文件 (.csv)** | 带有命名列和公制单位的结构化电子表格文件。需要可识别的数据格式（目前为 FT3 *“打印所有样本”* 厚度格式）。 |
| **键盘模拟** | 将数值键入另一个应用程序，而不是写入文件——参见 [键盘模拟](rhopoint-com-agent-keyboard-emulation.md)。 |

> [!info] 您可以同时启用多种格式。例如，勾选**文本**和 **CSV**，在保留原始存档的同时保存结构化文件；或勾选 **CSV** 和**键盘**，将数据归档*并*将某个值键入您的 QA 系统。

## CSV 导出选项

![](../_images/com-agent-csv-options-zh-Hans.png)

启用 **CSV** 后，会出现一个 **CSV 选项** 面板，其中有四项设置用于控制文件的写入方式。COM Agent 会根据您的语言和地区选择合理的默认值，因此在大多数情况下您可以保持不变。

| 选项 | 可选项 | 效果 |
| --- | --- | --- |
| **分隔符** | 逗号 "," · 分号 ";" · 制表符 "→" | 放置在列之间的字符。 |
| **时间格式** | ISO 8601, UTC · ISO 8601, 本地 | *Timestamp* 列的格式：UTC（例如 `2025-10-11T11:03:56Z`）或带偏移量的本地时间（例如 `2025-10-11T13:03:56+02:00`）。 |
| **小数分隔符** | 句点 "." · 逗号 "," | 用于数值的小数记号。日期和标识符永远不会更改。 |
| **文件编码** | UTF-8 · UTF-8（带 BOM） | 是否在文件开头写入字节顺序标记。BOM 可帮助某些电子表格程序（例如 Excel）检测 UTF-8 并正确显示 µm 表头。 |

> [!tip] **分隔符** 和 **小数分隔符** 默认采用您所在地区的惯例：以分号分隔列表值的地区（欧洲大部分地区）以 **分号 + 逗号小数** 开始，其他地区（例如英语）以 **逗号 + 句点小数** 开始。这样，文件便可在您本地的电子表格程序中双击顺利打开。更改设置后，系统会记住您的选择。

## CSV 结构

对于 FT3 厚度格式，COM Agent 为每个单独样本生成一行，并附带汇总统计数据和仪器元数据。单位以微米（µm）表示。

| 列 | 示例 | 含义 |
| --- | --- | --- |
| Index | 1 | 数据组中的样本编号 |
| Measurement (µm) | 1090.9 | 单个样本读数 |
| Min (µm) | 1088.4 | 数据组的最小值 |
| Max (µm) | 1090.9 | 数据组的最大值 |
| Mean (µm) | 1089.4 | 数据组的平均值 |
| StdDev (µm) | 0.990 | 数据组的标准差 |
| Template | 10 | 仪器数据格式 |
| Device_ID | FTG38041012H | 仪器序列号 / ID |
| Test_Date | 2025-10-07 | 测试日期（ISO 8601） |
| Calibration_Date | 2025-10-11 | 上次校准日期 |
| Test_Time | 11:03:56 | 测试时间 |
| Sample_Count | 5 | 数据组中的样本数量 |
| Timestamp | 2025-10-11T11:03:56Z | COM Agent 接收该数据组的时刻，以所选的*时间格式*表示 |

> [!info] 仪器自身的 *Test_Date* / *Test_Time* 来自设备时钟，没有时区。**Timestamp** 列是您的 PC 接收该数据组的时刻，因此会反映*时间格式*选项（UTC 或本地）。

> [!info] 如果 COM Agent 接收到无法识别为结构化格式的数据，则该次测量会跳过 CSV 文件，并在活动日志中出现提示。无论格式如何，原始 **TXT** 输出（如已启用）始终会被写入。

[下一步：将数值键入另一个应用程序](rhopoint-com-agent-keyboard-emulation.md)