Input Text（输入文本）
向当前获得焦点的输入框打字。
用途
向获得焦点的输入框打一串字——用户名、搜索词、聊天消息。文本可用 {{name}} 嵌入变量，你也可声明运行前由操作员填写的输入。
它还能先清空旧内容、打完后按 Enter，所以一次搜索或登录是一个节点而非三个。
何时用
- 填登录表单、搜索框或聊天消息。
- 输入操作员按次提供的数据。
- 打另一节点计算或读 取的值。
何时不用
设备向已获焦点的东西打字。没有焦点，文字就进入虚空，而节点仍报 Success。总在它正前面用 Click 点击输入框。
前提
设备上有一个获得焦点的输入框。
如何运行
- 解析文本。 整串
{{name}}/${name}占位符已被运行管线替换成提供的值；表达式文本此刻求值。 - 若开了 Clear before input，把光标移到末尾并退格删除旧内容。
- 把解析后的文本发往设备。
- 若开了 Submit after input，按 Enter。
- 路由 Success；输出报告打字长度。
设置
| 设置 | 类型 | 范围 | 默认 | 作用 |
|---|---|---|---|---|
| Text | 字符串或表达式 | — | — | 要打什么。用 {{name}} 表变量，或运行时求值的 {expr} |
| Variable Name（列表） | 列表 | ≤ 50 项 | — | 声明的运行时输入：name、type、可选 default |
| Clear before input | boolean | — | false | 先删除框里已有内容 |
| Submit after input | boolean | — | false | 打完按 Enter |
| Wait after | integer | 0–60000 ms | — | 打字后停顿 |
声明的输入
Variable Name 列表里每项有：
| 字段 | 备注 |
|---|---|
name | 标识符——字母、数字、下划线；不能以数字开头 |
type | string、integer、float、boolean、json、array 之一 |
default | 可选。为 Test Node / Test Flow 播种，并预填 Run Condition 表单 |
声明的名字也可供流程里其他节点使用——它们是普通变量，不是本节点私有。
占位符必须能解析
不是真实变量或声明输入的 {{name}} 会被原样打出——框收到字符 {{name}}。它悄悄失败、看起来像数据 bug，所以引用前先声明。
Clear 有界
输入前清空最多退格删除固定数量的字符。对很长的已有内容，它不是保证"清空框"。
端口
| 端口 | 走它的时机 | 必接 |
|---|---|---|
| Success | 文本已发送（输出：打字长度） | 是 |
| Failure | 文本为空、含不支持字符，或框无法清空 | 否 |
| Timeout | 输入命令未按时完成 | 否 |
| Cancelled | 打字中运行被停 | 否——永不被走 |
| Fatal | 设备断连 | 否——永不被走 |
基础示例
打搜索词并提交：
- Text：
alliance shop - Submit after input：开
实际示例——登录步骤
每个 Input Text 前都有一个聚焦其框的 Click。第一个框上的 Clear before input 确保上次尝试残留的半填表单不污染值。
高级示例——按次数据
把 account_name 声明为 string 类型的输入，然后把 Text 设为 {{account_name}}。
同一个已保存流程现在按每个队列条目登录不同账号，操作员在 Run Condition 表单提供值——不改流程、不复制流程。
最佳实践
- 总先 Click 框。 "文字没进去"的头号成因。
- 用
{x}选择器插入变量，而非手打括号——它插入真实存在的名字。 - 开 Submit after input 在一个节点里发搜索或消息，而非再接 Key Press。
- 可能重填的表单上开 Clear before input。
- 验证结果。 打字后接一个确认预期下一屏的检测节点。
- 文本保持在目标键盘接受的字符范围内。
性能笔记
- 打字时间随字符串长度——文本逐字发往设备。
- Clear before input 额外耗时，与已有内容成正比，因为它退格。已知空的框就跳过。
- 循环里的长字符串是常见的隐藏成本；优先短而有针对性的值。
内存笔记
- 节点只持有解析后的字符串。声明的输入像任何变量一样住在运行上下文里。
- 按次提供的值在启动时播种进上下文；不在运行中从磁盘重读。
常见错误
| 错误 | 后果 | 修复 |
|---|---|---|
| 没有获焦框 | 文字进虚空，节点仍报 Success | 正前面点击框 |
{{name}} 未声明 | 字面文本 {{name}} 被打出 | 先声明变量或输入 |
| Emoji 或不支持符号 | 走 Failure | 限制到键盘接受的字符 |
| 指望框被清空 | Clear 有退格上界 | 长内容用应用自身控件清 |
| 以 为 Enter 提交了表单 | 有些表单要点按钮 | 用检测节点验证 |
故障排查
什么都没打却报 Success。 没有东西获得焦点。在本节点正前面加一个框上的 Click。
框里出现字面文本 {{username}}。
占位符不解析。查拼写与变量/输入是否已声明。
仅某些输入走 Failure。 不支持字符。测试确切字符串；许多模拟器键盘拒绝非 ASCII。
旧值还在。 Clear before input 关着，或旧内容超过退格上界。
FAQ
{{name}} 与 ${name} 有别吗？
无——都接受、一致。
能打多行文本吗？ Submit after input 发 Enter。多行内容接多个节点。
声明的输入只属于本节点吗？ 不。它们是普通流程变量，全流程可用。
默认值对真实运行生效吗？ 它为 Test 播种并预填 Run Condition 表单；真实运行提供的值覆盖它。
相关节点
- Click——先聚焦框
- Key Press——Enter、Back 及其他系统键
- Variable——计算要打的值
- Find Image——验证结果
相关页面
- 变量与记忆——声明运行时输入