应用中心/运行应用
运行应用（Running Apps）
运行应用是用户与 Pop 应用中心交互最重要的环节。
无论应用是通过工作流发布、从他人分享导入，还是从应用市场获取，其运行方式都遵循一致的标准流程：
输入参数 → 执行运行 → 查看结果 → 日志调试（可选）
本章节将帮助你全面理解应用的标准运行流程、界面结构与调试方法。
一、应用运行界面结构
应用的“运行界面”由布局管理器构建，因此不同应用界面可能不同，但一般都包含以下核心组成：
1. 输入参数区域（Inputs / Form）
用于填写应用所需的参数，包括：
- 文本 / 数字输入框
- 下拉框
- 文件上传
- 图片上传
- JSON 编辑框
- 模型选择器
- 开关、选项等
用户填写完参数后即可启动应用。
2. 运行按钮（Run / Execute）
通常位于表单下方或右上角。
执行行为包括：
- 启动工作流运行
- 禁用输入，避免重复点击
- 显示执行状态（running / success / failed）
3. 运行状态提示
执行中可能出现以下状态：
| 状态 | 说明 |
|---|---|
| Running… | 工作流正在执行 |
| Success | 执行成功，已生成结果 |
| Failed | 节点报错，可查看日志 |
| Stopped | 手动中断运行 |
二、工作流执行过程（幕后逻辑）
当你点击“运行”：
- 应用收集表单所有字段并生成 JSON 参数
- 发送给工作流执行引擎
- 从第一个节点开始逐个执行
- 节点之间传递数据
- 最终将输出返回给应用界面
- 布局中的“结果组件”负责展示输出
整个过程完全自动，不需要用户干预。
三、结果展示（Outputs）
应用的结果显示区域取决于布局配置，可以包含：
1. Markdown 显示
适用于：
- AI 文本生成
- 报告类应用
- 知识库回答
- 说明文档
2. 图片输出（Image Viewer）
用于：
- AI 生成图像
- 图像处理应用
- OCR 结果预览
3. 表格数据显示
适合：
- Excel / CSV 解析
- 数据分析类工作流
4. JSON Viewer
用于：
- 结构化输出
- 调试信息
- API 请求结果
支持格式美化与折叠。
5. 文件下载
如果节点输出文件，可直接点击下载，例如：
- PDF 报告
- Excel 数据表
- 图像文件
- 代码打包结果
6. 自定义组件输出（高级）
例如：
- 图表（饼图 / 柱状图 / 折线图）
- 代码高亮区
- 特殊渲染插件
只需节点输出对应类型的数据即可。
四、控制台（Console）与调试日志
控制台用于展示工作流运行期间的技术信息，包括：
- 每个节点的输入 / 输出
- AI 请求参数与响应
- 错误堆栈（stack trace）
- 运行耗时
- 调试信息（debug logs）
控制台通常位于界面底部或侧边，可折叠隐藏。
适合：
- 工作流开发者查看问题
- 用户反馈问题时提供截图
- 高级用户理解执行逻辑
五、运行失败如何排查？
以下是常见错误与处理建议：
❌ 1. 输入字段不合法
例如缺少必填字段、格式错误。
➡️ 解决：检查必填项、数字范围、JSON 格式。
❌ 2. AI 调用失败（模型错误 / Key 无效）
表现为：
- AI 节点报错
- 401 / 429 / timeout
➡️ 解决：检查模型设置、网络、余额、API Key。
❌ 3. 文件路径或格式不支持
例如上传了错误类型的文件。
➡️ 解决：检查你的输入是否在支持列表中。
❌ 4. 工作流内部节点错误
布局正常，但工作流逻辑出错。
➡️ 解决：
查看控制台 → 找到失败的节点 → 复现问题并修复。
❌ 5. 大模型响应太长导致解析失败
某些 AI 输出过大可能导致渲染问题。
➡️ 解决：减少输出长度或优化提示词。
六、运行中的交互行为
应用运行时：
- 输入表单会暂时禁用
- 控制台开始滚动输出日志
- 结果组件会被更新
- 可通过“停止运行”中断工作流
- 部分应用支持多次运行历史
运行结束后：
- 表单恢复可编辑
- 可以更改参数并再次运行
七、使用建议（最佳实践）
✔ 单步调试工作流，再发布应用
能大幅减少应用运行报错。
✔ 输入字段尽量设置默认值
避免用户提交空内容导致失败。
✔ 控制台作为调试工具，不必始终展示
普通用户一般不需要。
✔ 输出尽量结构化
例如 JSON、表格、Markdown，会提升可读性。
八、小结
运行应用是 Pop 应用中心的核心体验流程之一。
通过参数输入、节点执行、结果展示和日志调试，用户能在界面层完全掌控工作流的运行结果。
你现在已经理解：
- 应用执行的完整流程
- 结果如何展示
- 如何查看控制台日志
- 如何排查错误
- 运行界面的经典结构