流程编排 ★
一句话：流程编排是全租户工作流程的清单与生命周期管理页——手工建的、AI 规划器产出的流程都在这，看状态、翻执行历史、比版本，再进编辑器改草稿。
功能在哪
- 菜单路径：AI → AI 助手 → 流程编排
- 地址栏路由：
/ai/agent/workflow - 主要权限：
agent:workflow:query（打开本页）；保存 / 发布 / 运行等动作另受agent:workflow:update/publish/run控制
界面认识
| 区域 | 作用 | 常用操作 |
|---|---|---|
| 查询区 | 流程编码 / 流程名称 / 状态（草稿 / 已发布 / 已停用）/ 来源（手动添加 / 自动生成） | 「搜索」「重置」 |
| 工具条 | 新建流程、触发案例、批量删除（勾选后亮起） | 「新增」「触发案例」 |
| 采纳率横幅 | AI 规划采纳率统计：生成 / 采纳 / 手改 三个数 | 只读展示 |
| 列表 | 勾选 / 序号 / 流程编码 / 流程名称 / 版本 / 状态 / 来源 / 触发方式 / 负责人 / 创建 / 操作 | 行内「执行历史」「版本」「设计 / 查看设计」，其余收进「更多」 |
行内第三个按钮随状态变文案：草稿 = 「设计」（进编辑器可改），已发布 / 已停用 = 「查看设计」（只读态进编辑器）。
执行历史抽屉：每一次运行的台账
行内「执行历史」打开抽屉，标题带流程名；每次执行一行：执行编号 / 版本 / 状态 / 当前节点 / 挂起闸口 / 触发用户 / 耗时 / 操作：
- 「当前节点」停在
__END__表示跑完了全程；停在中途某节点 = 那次执行还没走完（比如在等人工确认）； - 「挂起闸口」列出执行暂停等待的确认点；
- 行内「画布回放」把当次执行按节点还原到画布上，逐步看它走到哪、每步产出什么。
版本管理抽屉：同一条流程的迭代链
行内「版本」打开抽屉（标题同样带流程名），同一编码下的所有版本按行铺开，并提供两两对比：
- 「主版本」徽标 = 当前对外生效的那一版（同编码同时只有一版是主版本）；
- 顶部「版本对比」选 A / B 两版后「对比 DSL」看结构差异；
- 行内「回滚到此版」= 同编码下追加一个新版本（内容取自被回滚版），老版本原样保留在链上。
常用操作
新建一条流程
「新增」弹窗建出草稿后直接带进工作流编辑器；建出来的行状态 = 草稿、来源 = 手动添加。
改草稿 / 看已发布版
草稿行点「设计」进编辑器可改可存；已发布 / 已停用行点「查看设计」进只读态——编辑器顶部会挂只读横幅并给两个出口（复制为新草稿 / 回滚为新草稿），见工作流编辑器 · 常见问题。
查一次执行到底发生了什么
「执行历史」→ 找到那次执行 → 看状态与当前节点 → 需要逐步复盘就点「画布回放」。
回滚与复制的区别
| 动作 | 结果 |
|---|---|
| 版本抽屉「回滚到此版」 | 同编码追加新版本，历史版本链不断 |
| 编辑器里「复制为新草稿」 | 另起一个编码的独立流程，与原流程再无关系 |
视角对照
| 视角 | 看到什么 |
|---|---|
租户管理员 docadmin | 全租户流程的清单与全部动作（设计 / 发布 / 回滚 / 删除） |
普通员工 salesman01 | 角色无 agent:workflow:query，菜单里看不到流程编排；他们在智能助手里与流程互动（草稿卡确认、追问执行记录） |
进阶
- 「来源 = 自动生成」的行是 AI 规划器的产物（编码
wf_plan_开头）：采纳率横幅的「生成 / 采纳 / 手改」三个数就是对这些行的统计； - 版本列是行内流程在该编码链上的版本号：派生 / 回滚都会 +1 追加新行，老版本不会被覆盖；
- 「触发方式」列展示流程的触发类型，共五种：手动 / 接口（none）、对话驱动（chat）、表单事件（form_event）、定时（schedule）、Webhook（webhook）；「触发案例」按钮给每种触发方式一个开箱即可通过体检的配置样例；
- 🔴 手动 / 接口（none）这一档发布后界面上没有「运行」按钮：它只能由外部按流程编码调用 run 接口触发，列表页与编辑器都不提供手动运行入口。想在不写代码的前提下验证一条流程，请改用其余四种触发方式之一；
- 表单事件（form_event）是「自己醒过来」的触发方式：发布后不需要任何人点运行，只要被监听的那张表单发生新增 / 修改 / 删除，平台就把这次变更（表单编码 + 事件类型 + 数据主键）作为入参唤起流程；同一张表挂多条 form_event 流程时，一次变更会把它们全部触发一遍，注意别让它们互写同一张表；
- 执行历史里的「版本」列说明那次执行跑的是哪一版——发布新版不影响在跑的旧实例。
常见问题
Q：列表里为什么有一堆 wf_plan_ 开头的流程？ A：AI 规划器在智能助手里草拟并被确认运行后落库的流程，来源列 = 自动生成；采纳率横幅统计的就是它们。
Q：「设计」和「查看设计」有什么区别？ A：草稿行是「设计」（可改可存）；已发布 / 已停用行是「查看设计」（只读态）。只读态想改，用编辑器横幅给的「复制为新草稿」或「回滚为新草稿」两个出口。
Q：回滚会把老版本删掉吗？ A：不会。回滚 = 同编码追加一个新版本（内容取自被回滚版），版本链上所有老版本原样保留、仍可对比与再回滚。
Q：批量删除能删已发布的吗？ A：删除受状态与权限双重控制；已发布的流程先停用再删，避免正在被触发的流程突然消失。