# 初始化

节点类型 `start`

## 功能说明

读取初始化参数并声明自定义变量。放在流程的第一步。

## 客户端配置界面

![客户端的初始化参数面板](/assets/start-en.7f48eae7a9dbcfe5258cb5ef5dfa68d1f735d164365a42959befc39f083bc2f6.0538f3a9.webp)

截图来自 MoreLogin 桌面客户端 V2.73.101 的英文界面。

## 输入字段

字段路径相对于整个节点。

| 字段 | 类型或取值 | Schema 必填 | 执行默认值 | 说明与边界 |
|  --- | --- | --- | --- | --- |
| `id` | `string` | 是 | — | `minLength = 1`, `maxLength = 128` |
| `meta` | `object` | 否 | — | Optional opaque display JSON. Unknown nested keys are preserved; no runtime semantics. Omission on replacement removes it; untouched nodes retain it. |
| `type` | `"start"` | 是 | — | — |
| `data` | `object` | 否 | — | — |
| `data.title` | `string` | 否 | — | — |
| `data.description` | `string` | 否 | — | — |
| `data.inputs` | `object` | 否 | — | — |
| `data.outputs` | `object` | 否 | — | — |
| `data.customVariables` | array<`object`> | 否 | — | — |
| `data.inputsValues` | `object` | 否 | — | — |
| `data.taskSettings` | `object` | 否 | — | 模板任务设置。仅正式运行（编辑器整流程运行、Local API 启动运行、计划任务）生效；单步/分组调试和被调用的子模板中的设置不生效。省略时全部取默认值。 |
| `data.taskSettings.completionTabs` | `"keep"` / `"closeOthers"` / `"clear"` | 否 | — | 任务完成后对主环境标签页的处理：keep=保留；closeOthers=仅保留当前标签页；clear=清除标签页（直接关闭浏览器）。默认 keep。 |
| `data.taskSettings.completionBrowser` | `"keep"` / `"close"` | 否 | — | 任务完成后主环境浏览器：keep=保持开启；close=关闭。用户手动停止时不处理。默认 keep。 |
| `data.taskSettings.headless` | `boolean` | 否 | — | 以无头方式启动本次运行打开的浏览器（需浏览器内核 130 及以上）；任务结束时一律关闭。运行前已打开的环境不生效。默认 false。 |
| `data.taskSettings.disableAutofill` | `boolean` | 否 | — | 本次运行打开的浏览器不注入环境账号密码，不自动填充。默认 false。 |
| `data.taskSettings.allowSavePasswords` | `boolean` | 否 | — | false 时，本次运行打开的浏览器中的账号变化不保存到环境。默认 false。 |
| `data.taskSettings.clearCacheOnClose` | `boolean` | 否 | — | 本次运行打开的浏览器关闭后（无论由谁关闭）清除该环境的全部本地缓存，不清云端缓存。默认 false。 |
| `data.taskSettings.timeoutSeconds` | `integer` | 否 | — | 任务超时（秒），0 表示不限制。从延迟结束、启动浏览器时开始计时；超时后关闭主环境浏览器，运行失败 RPA_TASK_TIMEOUT。默认 0。 `minimum = 0` |
| `data.taskSettings.delayMinutes` | `integer` | 否 | — | 延迟执行（分钟），0 表示不延迟。延迟期间运行保持排队且不占用环境，见运行的 startAfter。默认 0。 `minimum = 0` |
| `data.taskSettings.launchArguments` | `string` | 否 | — | 浏览器启动参数，每行一个，同名参数优先于环境自身参数。黑名单参数及调试端口、扩展加载、用户数据目录、无头开关等参数不生效。默认空。 |
| `blocks` | `array` | 否 | — | `maxItems = 0` |


## 条件与边界

- 根首位且唯一；声明 customVariables；不提供业务输出。
- 结构节点字段路径相对完整节点，defaults 对 end 指 data.inputsValues；其他详见 workflow.md。
- 校验错误码 `RPA_STRUCTURE_INVALID`


## 输出字段

没有独立业务输出。

## JSON 示例

`start` 节点放在根级 `nodes` 数组的第一位。

```json
{
  "id": "start",
  "type": "start",
  "data": {
    "title": "初始化尝试次数",
    "customVariables": [
      {
        "id": "attempts",
        "name": "Attempts",
        "type": "number",
        "initialValue": 0
      }
    ]
  }
}
```

[返回节点目录](/zh/browser-rpa/nodes)