应用输入与参数设置（App Inputs & Parameters）

应用的输入（Inputs）决定了用户如何与应用进行交互。
所有输入字段都直接来自工作流（Workflow）的输入定义，因此 工作流输入就是应用表单字段的来源。

本章节将帮助你理解：

输入字段如何生成
字段类型有哪些
如何配置参数属性
默认值与校验规则
输入与工作流运行结果的关系

一、应用输入从哪里来？

应用的输入来自三个来源：

1. Workflow Inputs（工作流输入）——唯一数据源

在工作流中定义：

字段名称
字段类型
默认值
是否必填
提示文本
枚举下拉值

发布应用后，这些字段会自动渲染为表单。

2. 布局管理器中的表单组件（Form Widget）

布局管理器决定：

字段的展示位置
字段的呈现方式（单列/双列）
字段的排列顺序
字段是否可折叠
是否与其他组件组合使用

但布局 不会改变字段本身的定义，核心仍来自工作流输入。

3. 全局参数或运行环境参数（未来扩展）

例如：

用户信息
全局设置里的 API Key
调试参数

这些属于系统级输入，不需要用户填写。

二、支持的字段类型

Pop 支持多种输入类型，并会根据类型自动选择最优组件。

字段类型	表单呈现方式	典型使用场景
`string`	单行文本框	名称、标题、关键词
`text`	多行输入框	文本、描述、AI 提示词
`number`	数字输入	数量、限制、范围
`boolean`	开关（Switch）	开启/关闭某功能
`file`	文件上传	图片、文档、PDF
`image`	图片上传/预览	图像处理类工具
`select`	下拉选择	模型、语言、模式
`json`	JSON 编辑器	高级配置、数据结构
`list`	动态列表输入	批量数据
`date`	日期选择器	时间参数
`model`	AI 模型选择器	GPT / DeepSeek / 本地模型
`vector`	变量引用	高级工作流逻辑

你可以在工作流中决定字段类型，应用界面会自动适配。

三、字段属性详解

每个字段支持以下属性：

1. label（标题）

显示给用户看的名称。

2. name（字段 Key）

工作流内部使用，不要随意更改。

3. default（默认值）

空表单时自动填充，非常重要：

提升体验
避免空参数报错
提供模板指引

4. required（是否必填）

开启后，用户未填写无法点击“运行”。

5. placeholder（提示语）

帮助用户理解输入内容。

6. options（下拉选项）

用于：

模型选择
语言选择
操作模式
数据类型

7. advanced（高级选项）

通常用于开发者设置，可折叠。

四、如何管理输入字段？

你可以在以下两个地方管理字段：

① 工作流编辑器 → 输入字段（Inputs）

在这里你可以：

添加 / 删除字段
调整字段类型
设置默认值
设定提示信息
调整校验规则

这是字段的“源头”。

② 布局管理器（Layout Manager）

你可以决定字段如何展示：

放在哪个区域
是单列还是双列
是否折叠
是否与其他面板组合
排序方式

布局不会改变字段定义，只改变呈现方式。

五、输入字段如何影响工作流运行？

当用户点击“运行”时：

输入表单收集所有字段值
将 JSON 形式的参数传入工作流引擎
工作流从第一个节点开始运行
节点可直接引用这些参数

例如：

在一个 AI 生成文案的应用中：

用户输入 productName = “智能手表”
输入 tone = “专业”

工作流中：

{{ inputs.productName }}
{{ inputs.tone }}

即可引用。

六、输入字段设计建议

为了让应用更易用，建议你遵循以下原则：

✔ 为字段设置默认值

用户体验提升最大的方式之一。

✔ 优先使用下拉框而非纯文本

可以减少输入错误，让选择更明确。

✔ 难懂字段放入“高级选项”

保持界面干净。

✔ 合理组合布局

让重要字段更靠前，次要字段折叠。

✔ 避免过多字段

尽量简化。

七、小结

应用的输入与参数系统，是 Pop 应用体验的核心基础。

它让应用具备：

灵活性
扩展性
控制性
可读性
易用性

你可以自由组合字段、布局和默认值，快速构建专业级的可视化应用。