# 命令行启动

COM Agent 可以从命令行以预配置方式启动并立即开始采集。这对于自动化非常方便——可从另一个程序、桌面快捷方式或启动脚本以固定配置启动它。

应用程序窗口仍会照常打开；参数只是为您填入设置，随后采集自动开始。

```
RhopointComAgent.exe --mode live --port COM3 --output "C:\Data" --file-extension csv+txt
```

## 选项

选项名称与窗口中的设置相对应。您省略的任何选项都会保留其已保存的值。

| 选项 | 值 / 示例 | 含义 |
| --- | --- | --- |
| `--mode` | `live` 或 `demo` | 采集模式。`demo` 无需 COM 端口。 |
| `--port` | `COM3` | 串行端口（实时采集时必需）。 |
| `--baud` | `19200` | 波特率。 |
| `--part-marker` | `^` | 界定一个完整测量数据组的标记。 |
| `--part-count` | `4` | 构成一个完整数据组的分段数量。 |
| `--output` | `"C:\Data"` | TXT/CSV 文件的输出文件夹。 |
| `--file-extension` | `txt`、`csv`、`csv+txt`、`keyboard` | 输出格式；用 `+` 组合多种。 |
| `--csv-delimiter` | `comma`、`semicolon`、`tab` | CSV 列分隔符。 |
| `--csv-decimal` | `dot`、`comma` | CSV 数字的小数点分隔符。 |
| `--csv-time-format` | `utc`、`local` | CSV *Timestamp* 列的格式。 |
| `--csv-encoding` | `utf8`、`utf8-bom` | CSV 文件编码（带或不带字节顺序标记）。 |
| `--keyboard-value` | `mean`、`min`、`max`、`stddev`、`measurements`、`raw` | 要键入的值；用 `+` 组合多种。 |
| `--keyboard-separator` | `tab`、`enter`、`none` | 在键入的值之间按下的键。 |
| `--keyboard-suffix` | `tab`、`enter`、`none` | 在最后一个值之后按下的键。 |
| `--keyboard-decimal` | `.` 或 `,` | 键入值的小数点分隔符。 |
| `--keyboard-delay` | `40` | 每次按键后的停顿（毫秒）。 |
| `--start` | *（无值）* | 在未提供其他参数时，以已保存的设置开始。 |

只要提供了任何参数（或单独使用 `--start`），采集就会自动开始。

## 示例

从 COM3 采集到 CSV 和 TXT 文件：

```
RhopointComAgent.exe --port COM3 --output "C:\QA\Thickness" --file-extension csv+txt
```

将平均值和最小值以 Tab 分隔的方式键入获得焦点的应用程序：

```
RhopointComAgent.exe --port COM3 --file-extension keyboard --keyboard-value mean+min --keyboard-separator tab
```

以演示模式启动（无需仪器）：

```
RhopointComAgent.exe --mode demo --output "C:\Data" --file-extension txt
```

> [!info] 窗口照常打开，因此您仍可观察实时活动并随时停止采集。请为包含空格的路径加上引号。

> [!warning] 实时采集仍需要有效的[许可证](rhopoint-com-agent-licensing.md)。如果启动配置不完整或无效（例如，输出文件夹不存在），COM Agent 会显示与手动启动时相同的消息。

[下一步：保持 COM Agent 为最新版本](rhopoint-com-agent-updating-com-agent.md)