组合动作通过按顺序执行一系列步骤，完成一件具体的事。每一步调用一个模块，步骤之间用变量传递数据。例如做一个「谷歌搜索」动作：选中了文字就搜索这些文字，否则打开谷歌首页。流程如下：
- 步骤
- 变量
组合动作基础
组合动作把多个步骤按顺序执行，用变量传递数据，用如果/否则做分支。
动作编辑器的使用
组合动作编辑器分左中右三栏：工具箱、步骤列表、变量与外观。
组合动作由一串步骤组成。每一步调用一个模块：从变量或固定值取出输入，处理后把结果写回变量。从左侧工具箱把模块拖进步骤列表即可添加。完整窗口见 动作编辑器。中间步骤区示意：
- 模块
模块和步骤
步骤对应模块；输入可绑变量、写固定值，或用 $$ / $= ；输出写入变量。
步骤参数可以绑变量，也可以在输入框里写三种内容。在输入框里按 F1，会在这三种模式之间循环切换：Ctrl+Shift+C：连同 $$ / $= 标记一起复制框里的全部内容。
- 原始值
- 插值
- 表达式
选择或输入步骤参数
参数可写固定值、$$ 插值或 $= 表达式；F1 在三种模式间切换。
变量在步骤之间传递数据。前面步骤的输出放进变量，后面步骤再当输入用。可以把变量看成盒子：名字是标签，类型限制能放什么，默认值是一开始就在盒子里的东西。
- 类型
- 输入和输出
- 变量列表
- 创建和编辑
变量
变量在步骤之间传数据；右侧列表可创建、筛选，对话框里设类型和默认值。
列表用来存一组字符串。例如一次选中的多个文件路径，每一项是一条完整路径。创建变量时选「列表」。默认值按多行填写，每行一项。
- 变量定义
- 和多行文本互转
- 在表达式里
列表类型
列表存一组字符串；可与多行文本互转，用拆分/合并/列表操作模块处理。
词典存「键 → 值」。键是文本，值可以是任意类型。内部对应 C# Dictionary<string, object>。
- 默认值
- 转成 JSON 文本
词典类型
词典存键值对；默认值可用每行 Key:Value 或 JSON；比较值时要先转成同一类型。
表格表示一张二维表，内部是 .NET DataTable。像带标题行的工作表：纵向是列，横向是一行记录。本功能仍是预览，遇到问题欢迎反馈。
- 管理表格数据
- 临时存表
表格变量类型
表格是二维数据表；可预定义列来管理数据，或临时承接查询结果。
动态对象可以存任意类型：简单数字，或复杂的 class。Quicker 用 C# 编写，内部就是 object。C# 里所有类型都能赋给 object。处理复杂结果时用它，例如从 JSON 里取出一个节点（JToken），放进动态对象，再在 表达式 里用该类型的属性和方法。
动态对象变量
动态对象可存任意 C# 对象，在表达式里按原类型调用属性和方法。
模块先收输入，做完操作再把结果写到输出。窗口里通常分成「（输入）参数」和「输出」。两种指定方式：
- 输入
- 计算顺序（1.4.22+）
参数传递
步骤参数先取变量或计算 $$ / $= ，再转成目标类型；输出写入变量。
插值用变量的内容替换文本里的 {变量名}，结果仍是一段文本。参数输入框整段最前面写 $$ 时（不是每一行前面），对后面的内容做插值，并去掉开头的 $$。
- 写法
- 变量表达式（1.9.5+）
- 嵌套（1.4.22+）
文本插值
参数以 $$ 开头时，用变量值替换 {变量名}，得到一段新文本。
在输入框最前面写 $=，后面就是表达式。用来比较、运算，把结果交给参数。拼接文本用 $$ 插值；要计算或比较，用 $=。
- 表达式基础
- 常量
- 启用表达式
- 在表达式中使用变量
表达式
参数以 $= 开头时按表达式计算或比较；插值只负责拼文本。
表达式高级话题
复杂表达式、F1 切换、补全与测试、布尔助手，以及 _context / _eval。
子程序
子程序把步骤和变量封成自定义模块；分动作内、公共、网络共享三类。
可以像命令行一样给动作传参数（1.4.8+）：传入要处理的数据，或告诉动作走哪条分支。外部调用（见 Quicker 启动协议）：
- 怎么传入
- 怎么读取
- 直接写入变量（1.41.0+）
- 返回值
为动作传递参数
从命令行、运行其他动作、热键或右键菜单给动作传参，用 quicker_in_param 读取。
调试运行组合动作
调试运行会记录每步输入输出并打开 HTML 日志；也可只跑选中的步骤。
服务器资源有限，不要频繁、尤其不要循环调用这些接口。否则 IP 可能被屏蔽，Quicker 也会受影响。接口索引：https://tools.getquicker.cn/swagger/index.html
- 动作
- 版本
- 工具 API
- 其它服务
公共API
Quicker 开放的动作、版本和工具 HTTP 接口；不要循环高频调用。
动作若要保存用户产生的数据，请放到：Windows 个人文档目录 \Quicker\动作名\
复杂动作的编程约定
用户数据放在「文档\\Quicker\\动作名」下，用获取系统路径拿到文档目录。
可见性表达式
用 $= 表达式按另一个下拉字段的值，显示或隐藏子程序参数或表单字段。
有的动作要让使用者自己填：依赖程序的路径、API 凭据、个人习惯等。相关：状态存取、表单、自定义右键菜单、动作参数。
- 做法
- 示例：一译
在动作中存储用户设置
把设置变量勾成「作为状态使用」，用右键菜单打开表单修改。
在动作中使用图标
界面项可用 [fa:…]、[icon:…]、[url:…] 等前缀加上标题和可选 tooltip。
为动作设计自定义右键菜单
给动作加右键菜单：点一项等于运行该动作并传入该项的参数。
为输入框设置自定义的文本选择工具
用子程序给表单或用户输入的文本框加自定义文本选择工具。