5.13 发布工作流为应用（App）

Pop 的工作流不仅可以在画布中可视化运行，还可以直接 发布为独立应用（App）。
发布后的应用可用于：

内部业务自动化
对外提供工具服务
团队共享流程
作为“无代码应用”提供给用户操作
嵌入到布局管理器（Layout）形成完整产品界面

本章将介绍完整的应用发布流程、应用结构、参数配置、版本更新机制以及最佳实践。

🚀 一、什么是“应用发布”（App Publishing）

“应用”本质上是：

一个具有输入表单、运行逻辑（工作流）、界面布局的可执行单元。

一个 App 通常包含：

组成部分	说明
工作流（核心逻辑）	所有自动化过程由工作流提供
输入表单（Inputs）	用户在应用界面填写的字段
布局管理器（Layout）	应用的 UI 结构、面板布局、图表、文本等
输出展示（Outputs）	展示运算结果、图表、文本、文件等
版本信息	用于更新、回滚、管理

发布后，用户可以像使用普通软件一样操作 App。

🧩 二、发布流程概览

发布一个 App 通常需要三步：

1️⃣ 步骤一：准备工作流

确保所有节点配置正确
输入输出参数明确
画布运行正常且无错误
运行日志正常

2️⃣ 步骤二：创建 App

在工作流右上角菜单选择：

发布为应用（Publish as App）

随后填写：

应用名称
应用描述
应用图标（可选）
应用分组（Category）
版本号（自动生成或手动）

3️⃣ 步骤三：绑定布局（可选但推荐）

你可以选择：

使用默认布局（自动生成）
手动构建 Layout 作为应用界面
引入已有的布局模板

完成后即可生成一个完整的应用。

🏗 三、应用的界面结构

应用界面由 Layout 管理器定义（如果你已经绑定了 Layout）。

典型结构包含：

[输入表单区域（Form）]
[运行按钮（Run）]
[结果展示区（Outputs）]
    ├ 图表（charts）
    ├ 表格（tables）
    ├ 文本（markdown / HTML）
    ├ 文件下载（PDF/Excel）
    └ 自定义组件

如果没有 Layout，系统会生成默认界面：

左：输入表单
中：运行按钮
右：输出结果

📦 四、App 的组成结构（内部实现）

发布后的 App 包括：

{
  "id": "app_xxxxx",
  "name": "文档批量摘要助手",
  "version": "1.0.0",
  "workflowId": "wf_abc123",
  "layoutId": "layout_003",
  "createdAt": "...",
  "updatedAt": "...",
  "inputs": [...],
  "outputs": [...],
  "metadata": {...}
}

这意味着：

内容	从哪里来
workflowId	绑定的工作流
layoutId	绑定的布局
inputs	工作流 Inputs 自动生成
outputs	工作流 Outputs 自动生成
version	每次发布自动更新

🔄 五、应用的运行方式

发布后的应用可以：

✔ 从 App 列表运行

左侧导航 → “应用（Apps）” → 点击运行。

✔ 嵌入布局管理器

你可以在 Layout 中添加：

表单面板
图表展示面板
文本面板
文件预览器
ChatOutput 等高级组件

最终形成一个完整的小型产品界面。

🔧 六、版本管理（Versioning）

每次发布应用时，Pop 会自动记录：

版本号（例如 1.0.1 → 1.0.2）
发布时间
工作流快照
布局快照

你可以：

回滚到旧版本
创建新版本作为升级
比较两个版本之间的差异（即将支持）

版本管理对于企业级用户非常重要。

🚨 七、发布前检查清单（Recommended）

发布前建议确保：

检查项	状态
工作流全程运行成功	✔
输入参数已命名清晰	✔
输出参数正确映射在布局中	✔
节点未使用本地绝对路径	✔
AI 模型设置正确	✔
HTTP 请求已测试通过	✔
循环节点 / 脚本节点无风险逻辑	✔

🧪 八、示例：发布一个“批量摘要生成”应用

流程：

创建工作流：
- 输入：上传文件
- 处理：AI 文本摘要
- 输出：结果列表
构建 Layout：
- 左侧输入区
- 右侧展示摘要列表
发布为应用：
- 名称：文档摘要助手
- 图标：📝
- 版本：1.0.0
用户体验：
- 上传文件 → 点击运行 → 获得所有摘要

🧭 九、最佳实践

建议	原因
为所有输入添加默认值	防止表单为空导致错误
在关键节点添加错误处理	避免流程中断
使用布局展示输出	App 可用性更高
对流程进行分层模块化	更易维护
发布前多设备测试	部分 AI/文件节点可能表现不同

🎯 十、小结

通过发布功能，你可以将工作流变成：

可复用的自动化工具
面向用户的完整应用
企业内部流程自动化入口
可嵌入的界面产品

工作流从“逻辑构建”到“应用产品化”的转变，就是 Pop 的核心价值之一。