# 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 助手同时展开时仍需保证可操作空间。 - 运行历史必须支持状态、耗时和时间范围筛选。 - 日志和原始数据可能含凭据或敏感业务数据，必须脱敏并受权限保护。 - 删除必须进入回收站，并提供恢复路径。