yeuimu
6c61a4e871
- Debian-based api image (bookworm-slim), docker/debian mirrors, prisma binaryTargets for openssl 3.0 - nginx: admin SPA under /admin, TLS via acme.sh (ZeroSSL) + auto-renewal cron, http->https redirect - prisma: add origin_goods.delisted migration, sync missing schema (good_image/tag_font_color/good_tags), fix users.createdAt Timestamptz - api: CORS wildcard reflection, helmet CORP cross-origin, price backfill in persistProductDetail, categoryIcon ancestor fallback, mediaByColor per-color gallery in public goods detail - admin: /admin base path (vite + router) - import-data.mjs: udt_name casting, serial sequence advance fix
20 KiB
Teable 自动化 UI、交互与运行流程说明
页面范围：
https://teable.inkreach.cc/base/bseVtXyL4aojvUDwFhn/automation/*
梳理日期：2026-07-29
梳理方式：管理员账号黑盒交互验证。创建了临时自动化用于检查编辑流程，未执行任何会改写业务数据或调用外部系统的动作，测试自动化最终已移到回收站。
1. 功能定位
自动化用于把触发事件、条件判断和执行动作组成可运行的工作流。其基本生命周期为：
创建自动化
↓
选择并配置触发器
↓
测试触发器，生成后续步骤可引用的样本数据
↓
添加一个或多个动作、逻辑节点
↓
逐步配置并测试节点
↓
启用自动化
↓
事件触发或定时运行
↓
在运行历史中查看状态、耗时、输入、输出和错误
页面没有显式的“保存工作流”按钮。节点新增、表格选择等修改会即时持久化，重新打开页面后仍然存在，因此整体采用自动保存模型。
2. 自动化入口与创建
2.1 创建菜单
数据库左侧导航中有一个横向的 创建 按钮。点击后打开菜单：
- 新表格
- 新自动化
- 新应用
- 新文件夹
- CSV 文件
- Microsoft Excel
自动化入口为 新自动化，与表格、应用和文件夹创建处于同一级。
2.2 创建行为
点击 新自动化 后：
- 系统立即创建一条名为
新自动化的草稿。 - 新自动化作为一级节点插入左侧数据库树并自动选中。
- URL 跳转到
/base/{baseId}/automation/{workflowId}。 - 主工作区切换到工作流编辑器。
- 初始启用开关禁用。
- 初始
运行测试按钮禁用。 - 画布中展示触发器选择面板。
创建过程没有二次确认，也没有独立命名步骤。即使还没有配置触发器，自动化实体已经存在。
3. 页面整体布局
自动化页面沿用数据库应用外壳，桌面端由四个主要区域组成：
┌──────────────────┬─────────────────────────────────────┬───────────────┐
│ 数据库左侧导航 │ 自动化主工作区 │ 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.。 - 卡片标题为
1. 当记录创建时。 - 卡片显示摘要，例如
当在 自动推单表 表格中新建记录时。 - 卡片带
触发器类型标签。 - 节点下方出现连接线和
+按钮。
点击节点后，画布右侧打开约 350 px 的属性面板。面板包含：
属性标题。- 节点 ID。
- 关闭按钮。
触发器类型下拉框。- 触发器用途说明。
- 可折叠的
配置。 - 可折叠的
测试步骤。
7.1 配置触发器
当记录创建时 的必填配置是 表格：
- 未选择时显示
请选择...。 - 点击后打开浮层式表格选择器。
- 候选项显示表格图标和名称。
- 选择表格后节点摘要即时更新。
- 修改会自动持久化。
7.2 测试触发器
属性面板明确提示：
测试此触发器以确认其配置正确。此测试的数据可用于后续步骤。
表格未选择时：
选择记录禁用。使用推荐记录禁用。
表格选择完成后，全局 运行测试 可用。
8. 全局运行测试与记录选择器
点击顶部 运行测试 后打开大尺寸模态框：
┌────────────────────────────────────────────────────────────┐
│ 选择记录 [×] │
│ [全局 ▾] [搜索记录__________________________________ 🔍] │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ □ | 字段列 | 字段列 | 字段列 | ... │ │
│ │ □ | 记录值 | 记录值 | 记录值 | ... │ │
│ │ □ | 记录值 | 记录值 | 记录值 | ... │ │
│ └────────────────────────────────────────────────────────┘ │
│ [取消] [运行自动化] │
└────────────────────────────────────────────────────────────┘
UI 细节：
- 背景使用半透明遮罩，保持原工作流可辨识。
- 顶部包含视图范围选择器、记录搜索和清除/搜索图标。
- 主体是可横向容纳多字段的记录表格。
- 每行左侧有单选复选框。
- 表头显示字段类型图标和字段名。
- 底部操作右对齐。
- 未选择记录时
运行自动化不应执行。
测试会使用选中记录作为触发器样本，并把其数据提供给后续节点。由于测试流程可能执行后续写入或外部调用，本次只检查到记录选择界面，没有点击 运行自动化。
9. 工作流画布
编辑区采用节点画布：
- 浅色点阵背景。
- 节点垂直排列。
- 节点之间使用带方向的连接线。
- 连接处有圆形
+按钮。 - 流程末端显示圆形终止标记。
- 左下角提供放大、缩小、适配视图。
- 达到最大缩放时放大按钮禁用。
节点卡片视觉结构：
┌──────────────────────────────────────┐
│ [类型图标] 1. 节点标题 [类型] │
│ 配置摘要 [状态] │
└──────────────────────────────────────┘
- 当前选中节点使用蓝色边框。
- 配置异常节点显示红色警告图标。
- 节点标题含执行顺序编号。
- 触发器与执行动作使用不同类型标签。
- 节点菜单可用于节点级操作，具体菜单项未全部执行。
10. 添加动作与逻辑
点击节点下方 + 后打开悬浮菜单，分为两种构建方式。
10.1 AI 构建
菜单优先展示：
- 运行脚本，带
推荐标记和说明使用 AI 自动化任何逻辑 - Slack
- 发送邮件
- AI 生成
- 创建/更新/获取记录
- 发送 HTTP 请求
这些入口强调按目标选择能力，而不是先选择底层动作类型。
10.2 手动构建
可展开区域分为：
操作：
- 创建记录
- 获取记录
- 更新记录
- 发送邮件
- AI 生成
- HTTP 请求
逻辑：
- 当条件满足...
手动构建适合用户明确知道动作类型的场景；AI 构建则通过对话或组合入口降低配置成本。
11. 动作节点与配置面板
本次选择了推荐的 运行脚本：
- 系统在触发器后自动插入
2. 运行脚本节点。 - 自动创建连接线。
- 新节点自动选中。
- 右侧打开动作属性面板。
- 因动作尚未配置，节点显示红色警告，全局
运行测试禁用。
动作属性面板包含：
- 节点 ID。
动作类型下拉框。- 动作用途说明。
标签区域和描述输入框。配置区域。测试步骤区域。
11.1 运行脚本配置
配置区提供两条路径：
通过 AI 对话配置- Slack
- 邮件
- 自定义
手动编辑
点击 AI 配置入口会展开右侧 AI 助手，并把当前节点作为上下文标签加入输入区。工作区会同步收窄。
单节点 运行测试 在节点配置不完整时禁用。动作完成配置后，预期可用触发器测试数据单独验证该步骤。
11.2 数据引用关系
触发器测试说明明确指出其输出可供后续步骤使用。由此可确定：
- 节点按编号顺序执行。
- 后续节点可以引用触发器或前序动作的测试输出。
- 单节点测试依赖上游测试数据。
- 修改上游节点后，应重新测试相关下游节点。
12. 启用与正式运行
完整现有工作流的编辑画布中出现 立即启用，标题栏开关也从禁用变为可操作。
建议的正式运行顺序是：
- 确保每个节点没有红色配置警告。
- 测试触发器并确认样本数据。
- 逐个测试动作节点。
- 执行一次全局运行测试。
- 检查动作输出和副作用。
- 点击
立即启用或标题栏开关。 - 观察运行历史。
本次未启用任何生产自动化，也未点击已有运行的 重跑。
13. 运行历史布局
有历史数据时，中间工作区采用三列结构：
┌──────────────────┬──────────────────────┬─────────────────────────┐
│ 运行记录列表 │ 概览统计 │ 单次运行详情 │
│ 状态、耗时、时间 │ 成功、失败、运行中 │ 总状态、诊断、重跑 │
│ │ 等待、取消、平均耗时 │ 各步骤输入与输出 │
└──────────────────┴──────────────────────┴─────────────────────────┘
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. 待补充验证
以下内容因会影响真实业务或当前环境限制而未执行：
- 自动化启用和停用时是否有确认提示。
- 节点全部配置完成后的自动校验反馈。
- 全局测试成功后的完整结果页面。
- 创建、更新记录等写操作的字段映射 UI。
- 条件分支的多条件与嵌套逻辑。
- Webhook URL 生成、签名与请求日志。
- 邮件、Slack、HTTP 和 AI 动作的失败重试策略。
- 密钥管理的新增、编辑、权限和脱敏显示。
- 复制、分享、节点信息的完整交互。
- 手机和平板端布局。
- 删除后从回收站恢复自动化。
20. 实现或复刻验收重点
- 创建后立即持久化的行为必须有清晰反馈，避免用户误以为尚未创建。
- 自动保存必须有保存中、已保存和失败状态。
- 启用必须建立在全节点配置有效的前提上。
- 运行测试必须明确提示可能产生的业务副作用。
- 重跑必须显示目标运行、输入来源和副作用警告。
- 节点警告、全局禁用状态和属性面板错误必须保持一致。
- 节点画布缩放、属性面板和 AI 助手同时展开时仍需保证可操作空间。
- 运行历史必须支持状态、耗时和时间范围筛选。
- 日志和原始数据可能含凭据或敏感业务数据，必须脱敏并受权限保护。
- 删除必须进入回收站，并提供恢复路径。