# Teable 自动化 UI、交互与运行流程说明

> 页面范围：`https://teable.inkreach.cc/base/bseVtXyL4aojvUDwFhn/automation/*`  
> 梳理日期：2026-07-29  
> 梳理方式：管理员账号黑盒交互验证。创建了临时自动化用于检查编辑流程，未执行任何会改写业务数据或调用外部系统的动作，测试自动化最终已移到回收站。

## 1. 功能定位

自动化用于把触发事件、条件判断和执行动作组成可运行的工作流。其基本生命周期为：

```text
创建自动化
    ↓
选择并配置触发器
    ↓
测试触发器，生成后续步骤可引用的样本数据
    ↓
添加一个或多个动作、逻辑节点
    ↓
逐步配置并测试节点
    ↓
启用自动化
    ↓
事件触发或定时运行
    ↓
在运行历史中查看状态、耗时、输入、输出和错误
```

页面没有显式的“保存工作流”按钮。节点新增、表格选择等修改会即时持久化，重新打开页面后仍然存在，因此整体采用自动保存模型。

## 2. 自动化入口与创建

### 2.1 创建菜单

数据库左侧导航中有一个横向的 `创建` 按钮。点击后打开菜单：

- 新表格
- 新自动化
- 新应用
- 新文件夹
- CSV 文件
- Microsoft Excel

自动化入口为 `新自动化`，与表格、应用和文件夹创建处于同一级。

### 2.2 创建行为

点击 `新自动化` 后：

1. 系统立即创建一条名为 `新自动化` 的草稿。
2. 新自动化作为一级节点插入左侧数据库树并自动选中。
3. URL 跳转到 `/base/{baseId}/automation/{workflowId}`。
4. 主工作区切换到工作流编辑器。
5. 初始启用开关禁用。
6. 初始 `运行测试` 按钮禁用。
7. 画布中展示触发器选择面板。

创建过程没有二次确认，也没有独立命名步骤。即使还没有配置触发器，自动化实体已经存在。

## 3. 页面整体布局

自动化页面沿用数据库应用外壳，桌面端由四个主要区域组成：

```text
┌──────────────────┬─────────────────────────────────────┬───────────────┐
│ 数据库左侧导航   │ 自动化主工作区                      │ AI 助手       │
│                  │                                     │ 可展开/折叠   │
│ 创建入口         │ 标题栏、状态开关、帮助、更多        │               │
│ 表格/文件夹树    │ 编辑工作流 / 运行历史               │               │
│ 自动化节点       │ 画布或历史列表                      │               │
│                  │ 节点属性面板或运行详情              │               │
│ 当前用户、通知   │                                     │               │
└──────────────────┴─────────────────────────────────────┴───────────────┘
```

- 左侧导航固定宽度，自动化与表格、文件夹共享同一棵资源树。
- 中间是自动化核心工作区。
- 右侧 AI 助手可折叠为窄图标栏，也会在“通过 AI 对话配置”时展开。
- AI 助手展开后会压缩自动化工作区宽度，工作流画布和属性面板随之重新排布。

## 4. 自动化标题栏

标题栏从左到右包含：

- 启用/停用开关。
- 自动化图标。
- 自动化名称。
- `添加描述`。
- `帮助`。
- 更多菜单。

### 4.1 启用状态

- 空白自动化的开关禁用。
- 已选择触发器但动作未完成时，开关仍禁用。
- 完整的现有工作流会显示可操作开关，并在画布中提供 `立即启用` 入口。
- 本次已有自动化 `定时同步订单` 处于停用状态，但历史记录仍完整保留。

为避免影响生产任务，本次未点击启用开关。合理推断：只有所有节点配置有效后才能启用，启用后触发器开始接收事件或按计划运行。

### 4.2 名称与描述

- 新建时默认名称为 `新自动化`。
- `添加描述` 位于名称下方，作为轻量次级操作。
- 更多菜单中的 `重命名` 用于修改名称。
- 本次未提交名称或描述修改，未验证长度和重复名称规则。

### 4.3 更多菜单

包含：

- 重命名
- 复制
- 分享
- 节点信息
- 删除

删除会打开确认框：

- 标题：`删除 自动化`
- 提示：`确定要删除 "自动化名称" 吗？`
- 操作：`取消`、`移到回收站`

删除采用可恢复的回收站语义，而不是永久删除。本次创建的测试自动化已通过该流程移到回收站。

## 5. 顶部页签与操作

标题栏下方提供：

- `编辑工作流`
- `运行历史`
- `密钥管理`
- `运行测试`

### 5.1 编辑工作流

展示节点画布和节点属性配置，是自动化的默认页签。

### 5.2 运行历史

展示自动化的执行记录、汇总指标和单次运行详情。没有历史时显示：

`当自动化流程运行后，这里会展示运行历史记录。`

### 5.3 密钥管理

位于编辑工作流页签右侧，用于管理动作可能引用的密钥。由于可能涉及真实凭据，本次未展开。

### 5.4 运行测试

- 没有触发器时禁用。
- 触发器配置完成后可用。
- 新增未配置动作后会重新禁用。
- 表明全局运行测试需要当前工作流内所有必需节点通过配置校验。

## 6. 初始触发器选择

空白画布中央展示 `选择一个触发器：`，提供 8 类触发器：

| 触发器 | UI 说明或用途 |
| --- | --- |
| 当记录满足条件时 | 记录进入指定条件后运行 |
| 当记录创建时 | 新建记录时运行 |
| 当记录更新时 | 指定记录发生更新时运行 |
| 当表单提交时 | 表单产生提交时运行 |
| 定时触发 | 根据时区和计划周期运行 |
| 当按钮点击时 | 用户点击表格按钮后运行 |
| 当接收 Webhook 时 | 接收外部 HTTP Webhook 后运行 |
| 当收到新邮件时 | 邮箱收到新邮件后运行 |

触发器选择项采用带图标的纵向操作列表，位于空白画布中央。

## 7. 触发器节点与属性面板

本次选择了 `当记录创建时`：

1. 触发器选择列表被替换为节点卡片。
2. 节点自动编号为 `1.`。
3. 卡片标题为 `1. 当记录创建时`。
4. 卡片显示摘要，例如 `当在 自动推单表 表格中新建记录时`。
5. 卡片带 `触发器` 类型标签。
6. 节点下方出现连接线和 `+` 按钮。

点击节点后，画布右侧打开约 `350 px` 的属性面板。面板包含：

- `属性` 标题。
- 节点 ID。
- 关闭按钮。
- `触发器类型` 下拉框。
- 触发器用途说明。
- 可折叠的 `配置`。
- 可折叠的 `测试步骤`。

### 7.1 配置触发器

`当记录创建时` 的必填配置是 `表格`：

- 未选择时显示 `请选择...`。
- 点击后打开浮层式表格选择器。
- 候选项显示表格图标和名称。
- 选择表格后节点摘要即时更新。
- 修改会自动持久化。

### 7.2 测试触发器

属性面板明确提示：

`测试此触发器以确认其配置正确。此测试的数据可用于后续步骤。`

表格未选择时：

- `选择记录` 禁用。
- `使用推荐记录` 禁用。

表格选择完成后，全局 `运行测试` 可用。

## 8. 全局运行测试与记录选择器

点击顶部 `运行测试` 后打开大尺寸模态框：

```text
┌────────────────────────────────────────────────────────────┐
│ 选择记录                                             [×]   │
│ [全局 ▾] [搜索记录__________________________________ 🔍]   │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ □ | 字段列 | 字段列 | 字段列 | ...                   │ │
│ │ □ | 记录值 | 记录值 | 记录值 | ...                   │ │
│ │ □ | 记录值 | 记录值 | 记录值 | ...                   │ │
│ └────────────────────────────────────────────────────────┘ │
│                                      [取消] [运行自动化]   │
└────────────────────────────────────────────────────────────┘
```

UI 细节：

- 背景使用半透明遮罩，保持原工作流可辨识。
- 顶部包含视图范围选择器、记录搜索和清除/搜索图标。
- 主体是可横向容纳多字段的记录表格。
- 每行左侧有单选复选框。
- 表头显示字段类型图标和字段名。
- 底部操作右对齐。
- 未选择记录时 `运行自动化` 不应执行。

测试会使用选中记录作为触发器样本，并把其数据提供给后续节点。由于测试流程可能执行后续写入或外部调用，本次只检查到记录选择界面，没有点击 `运行自动化`。

## 9. 工作流画布

编辑区采用节点画布：

- 浅色点阵背景。
- 节点垂直排列。
- 节点之间使用带方向的连接线。
- 连接处有圆形 `+` 按钮。
- 流程末端显示圆形终止标记。
- 左下角提供放大、缩小、适配视图。
- 达到最大缩放时放大按钮禁用。

节点卡片视觉结构：

```text
┌──────────────────────────────────────┐
│ [类型图标]  1. 节点标题      [类型] │
│             配置摘要          [状态] │
└──────────────────────────────────────┘
```

- 当前选中节点使用蓝色边框。
- 配置异常节点显示红色警告图标。
- 节点标题含执行顺序编号。
- 触发器与执行动作使用不同类型标签。
- 节点菜单可用于节点级操作，具体菜单项未全部执行。

## 10. 添加动作与逻辑

点击节点下方 `+` 后打开悬浮菜单，分为两种构建方式。

### 10.1 AI 构建

菜单优先展示：

- 运行脚本，带 `推荐` 标记和说明 `使用 AI 自动化任何逻辑`
- Slack
- 发送邮件
- AI 生成
- 创建/更新/获取记录
- 发送 HTTP 请求

这些入口强调按目标选择能力，而不是先选择底层动作类型。

### 10.2 手动构建

可展开区域分为：

操作：

- 创建记录
- 获取记录
- 更新记录
- 发送邮件
- AI 生成
- HTTP 请求

逻辑：

- 当条件满足...

手动构建适合用户明确知道动作类型的场景；AI 构建则通过对话或组合入口降低配置成本。

## 11. 动作节点与配置面板

本次选择了推荐的 `运行脚本`：

- 系统在触发器后自动插入 `2. 运行脚本` 节点。
- 自动创建连接线。
- 新节点自动选中。
- 右侧打开动作属性面板。
- 因动作尚未配置，节点显示红色警告，全局 `运行测试` 禁用。

动作属性面板包含：

- 节点 ID。
- `动作类型` 下拉框。
- 动作用途说明。
- `标签` 区域和描述输入框。
- `配置` 区域。
- `测试步骤` 区域。

### 11.1 运行脚本配置

配置区提供两条路径：

1. `通过 AI 对话配置`
   - Slack
   - 邮件
   - 自定义
2. `手动编辑`

点击 AI 配置入口会展开右侧 AI 助手，并把当前节点作为上下文标签加入输入区。工作区会同步收窄。

单节点 `运行测试` 在节点配置不完整时禁用。动作完成配置后，预期可用触发器测试数据单独验证该步骤。

### 11.2 数据引用关系

触发器测试说明明确指出其输出可供后续步骤使用。由此可确定：

- 节点按编号顺序执行。
- 后续节点可以引用触发器或前序动作的测试输出。
- 单节点测试依赖上游测试数据。
- 修改上游节点后，应重新测试相关下游节点。

## 12. 启用与正式运行

完整现有工作流的编辑画布中出现 `立即启用`，标题栏开关也从禁用变为可操作。

建议的正式运行顺序是：

1. 确保每个节点没有红色配置警告。
2. 测试触发器并确认样本数据。
3. 逐个测试动作节点。
4. 执行一次全局运行测试。
5. 检查动作输出和副作用。
6. 点击 `立即启用` 或标题栏开关。
7. 观察运行历史。

本次未启用任何生产自动化，也未点击已有运行的 `重跑`。

## 13. 运行历史布局

有历史数据时，中间工作区采用三列结构：

```text
┌──────────────────┬──────────────────────┬─────────────────────────┐
│ 运行记录列表     │ 概览统计             │ 单次运行详情            │
│ 状态、耗时、时间 │ 成功、失败、运行中   │ 总状态、诊断、重跑      │
│                  │ 等待、取消、平均耗时 │ 各步骤输入与输出        │
└──────────────────┴──────────────────────┴─────────────────────────┘
```

### 13.1 运行记录列表

每条记录展示：

- 状态图标和文字。
- 运行耗时，例如 `1.9 s`。
- 运行时间，例如 `2026-07-28 20:02:15`。
- 右侧进入详情箭头。

成功使用绿色，失败使用红色，形成明确的语义色。

### 13.2 概览统计

现有 `定时同步订单` 自动化的界面显示以下统计卡：

- 运行成功
- 运行失败
- 运行中
- 等待中
- 已取消
- 平均运行时间

本次观察值为成功 84、失败 14、运行中 0、等待中 0、已取消 0、平均运行时间 27 秒。该数值是观察时的实时业务数据，不是固定产品默认值。

### 13.3 单次运行详情

详情顶部展示：

- 总体运行状态。
- 运行时间。
- 失败时提供 `诊断`。
- 失败时提供 `重跑`。

下方按工作流步骤展示：

- 节点名称。
- 节点运行状态。
- 相对运行时间。
- 输入。
- 输出。
- 原始数据入口。
- 执行耗时。

触发器输入示例包含时区、触发时机、开始时间和原始数据；定时触发器输出包含预计触发时间和下次触发时间。

运行失败时，上游触发器仍可能显示运行成功，说明系统按节点记录状态，便于定位具体失败步骤。

## 14. 运行历史筛选

点击 `过滤条件` 后打开轻量浮层，包含：

- 状态。
- 运行耗时。
- 时间范围。

状态选项包括：

- 全部
- 运行成功
- 运行失败
- 运行中
- 等待中
- 已取消

时间范围通过 `选择日期范围` 打开日期选择器。

选择失败记录或失败统计后，过滤按钮会显示数量，例如 `过滤条件(1)`，运行列表只保留失败记录。

## 15. 失败处理

失败运行的详情页提供：

- 红色失败状态。
- `诊断` 按钮。
- `重跑` 按钮。
- 每个步骤的独立状态。
- 输入和输出展开项。

交互原则：

- `诊断` 用于分析失败原因，预期不会重新执行流程。
- `重跑` 会再次执行自动化，可能产生真实业务副作用，属于高风险操作。
- 用户应先检查失败步骤和输入，再决定是否重跑。

本次只查看了失败详情，没有点击诊断或重跑。

## 16. 状态联动矩阵

| 触发 | UI 状态变化 |
| --- | --- |
| 创建新自动化 | 左侧立即新增节点，进入空白画布 |
| 未选择触发器 | 启用开关和运行测试禁用 |
| 选择触发器 | 生成第 1 个节点和添加动作按钮 |
| 触发器缺少必填配置 | 测试步骤按钮禁用 |
| 完成触发器配置 | 节点摘要更新，全局运行测试可用 |
| 添加动作 | 自动编号、连线、选中，并打开属性面板 |
| 动作配置不完整 | 节点显示红色警告，全局运行测试禁用 |
| 点击节点 | 右侧属性面板打开，画布可用宽度缩小 |
| 点击画布或关闭属性面板 | 属性面板收起，画布恢复宽度 |
| 点击 AI 配置 | AI 助手展开并携带当前节点上下文 |
| 工作流配置完整 | 启用开关可用，出现 `立即启用` |
| 切换运行历史 | 画布替换为历史三列布局 |
| 选择运行记录 | 右侧显示步骤级输入与输出 |
| 筛选运行状态 | 列表过滤，按钮显示已应用条件数量 |
| 删除自动化 | 二次确认后移到回收站 |

## 17. UI 设计细节

### 17.1 视觉语言

- 白色面板配浅灰分隔线，适合高密度配置任务。
- 画布使用浅色点阵，不抢夺节点内容的注意力。
- 紫色用于自动化、触发器和脚本能力识别。
- 蓝色表示当前选中节点。
- 绿色表示成功，红色表示错误，橙色用于执行动作或中间状态。
- 主要依靠边框、浅底色和语义色表达状态，没有重阴影。

### 17.2 信息层级

- 顶部标题栏管理自动化级状态。
- 页签区管理编辑与历史两种工作模式。
- 画布表达执行顺序和节点关系。
- 属性面板处理单节点配置。
- AI 助手是辅助配置工具，不取代节点属性面板。
- 历史页从列表、汇总到详情逐层展开，支持快速扫描和深入排错。

### 17.3 空间与滚动

- 左侧资源树独立于中间工作区。
- 画布支持缩放和适配视图。
- 属性面板在右侧覆盖或占据画布宽度，并可纵向滚动。
- AI 助手展开时再占用一列宽度。
- 运行历史的列表、汇总和详情各有清晰列边界；内容较长时详情区独立滚动。
- 模态记录选择器占据大部分可用宽度，优先保证数据表可读性。

### 17.4 控件状态

关键控件均有明显禁用状态：

- 启用开关。
- 全局运行测试。
- 触发器选择记录。
- 单节点运行测试。
- 画布放大按钮。

红色警告图标直接放在未完成节点上，使配置问题在画布层可见。

## 18. 安全与权限建议

自动化可能写入表格、发送邮件、调用 Slack、执行脚本或 HTTP 请求，因此应纳入权限控制：

- 创建、编辑、启用、停用、删除自动化。
- 查看运行历史。
- 查看节点输入、输出和原始数据。
- 管理密钥。
- 运行测试。
- 诊断和重跑失败任务。
- 分享或复制自动化。

尤其需要限制 `运行脚本`、`HTTP 请求`、`发送邮件`、`Slack`、`密钥管理` 和 `重跑`。

## 19. 待补充验证

以下内容因会影响真实业务或当前环境限制而未执行：

1. 自动化启用和停用时是否有确认提示。
2. 节点全部配置完成后的自动校验反馈。
3. 全局测试成功后的完整结果页面。
4. 创建、更新记录等写操作的字段映射 UI。
5. 条件分支的多条件与嵌套逻辑。
6. Webhook URL 生成、签名与请求日志。
7. 邮件、Slack、HTTP 和 AI 动作的失败重试策略。
8. 密钥管理的新增、编辑、权限和脱敏显示。
9. 复制、分享、节点信息的完整交互。
10. 手机和平板端布局。
11. 删除后从回收站恢复自动化。

## 20. 实现或复刻验收重点

- 创建后立即持久化的行为必须有清晰反馈，避免用户误以为尚未创建。
- 自动保存必须有保存中、已保存和失败状态。
- 启用必须建立在全节点配置有效的前提上。
- 运行测试必须明确提示可能产生的业务副作用。
- 重跑必须显示目标运行、输入来源和副作用警告。
- 节点警告、全局禁用状态和属性面板错误必须保持一致。
- 节点画布缩放、属性面板和 AI 助手同时展开时仍需保证可操作空间。
- 运行历史必须支持状态、耗时和时间范围筛选。
- 日志和原始数据可能含凭据或敏感业务数据，必须脱敏并受权限保护。
- 删除必须进入回收站，并提供恢复路径。
