基础与进阶概念

组合动作通过按顺序执行一系列步骤，完成一件具体的事。每一步调用一个模块，步骤之间用变量传递数据。例如做一个「谷歌搜索」动作：选中了文字就搜索这些文字，否则打开谷歌首页。流程如下：

• 步骤
• 变量

组合动作由一串步骤组成。每一步调用一个模块：从变量或固定值取出输入，处理后把结果写回变量。从左侧工具箱把模块拖进步骤列表即可添加。完整窗口见 动作编辑器。中间步骤区示意：

• 模块

步骤参数可以绑变量，也可以在输入框里写三种内容。在输入框里按 F1，会在这三种模式之间循环切换：Ctrl+Shift+C：连同 $$ / $= 标记一起复制框里的全部内容。

• 原始值
• 插值
• 表达式
• 不离开步骤窗口编辑变量

变量在步骤之间传递数据。前面步骤的输出放进变量，后面步骤再当输入用。2.2.17 起，从步骤窗口的“变量”按钮打开时，左侧变量列表默认展开，便于集中管理；在右侧变量列表双击某个变量时，默认收起列表，集中编辑该变量。可用窗口中的列表开关切换视图。

• 类型
• 输入和输出
• 变量列表
• 在步骤窗口中编辑变量

列表用来存一组字符串。例如一次选中的多个文件路径，每一项是一条完整路径。创建变量时选「列表」。默认值按多行填写，每行一项。

• 变量定义
• 和多行文本互转
• 在表达式里

词典存「键 → 值」。键是文本，值可以是任意类型。内部对应 C# Dictionary<string, object>。

• 默认值
• 转成 JSON 文本

表格表示一张二维表，内部是 .NET DataTable。像带标题行的工作表：纵向是列，横向是一行记录。本功能仍是预览，遇到问题欢迎反馈。

• 管理表格数据
• 临时存表

动态对象可以存任意类型：简单数字，或复杂的 class。Quicker 用 C# 编写，内部就是 object。C# 里所有类型都能赋给 object。处理复杂结果时用它，例如从 JSON 里取出一个节点（JToken），放进动态对象，再在 表达式 里用该类型的属性和方法。

• 可选的 C# 类型提示

模块先收输入，做完操作再把结果写到输出。窗口里通常分成「（输入）参数」和「输出」。两种指定方式：

• 输入
• 计算顺序（1.4.22+）

插值用变量的内容替换文本里的 {变量名}，结果仍是一段文本。参数输入框整段最前面写 $$ 时（不是每一行前面），对后面的内容做插值，并去掉开头的 $$。

• 写法
• 变量表达式（1.9.5+）
• 嵌套（1.4.22+）

在输入框最前面写 $=，后面就是表达式。用来比较、运算，把结果交给参数。拼接文本用 $$ 插值；要计算或比较，用 $=。

• 表达式基础
• 常量
• 启用表达式
• 在表达式中使用变量

可以像命令行一样给动作传参数（1.4.8+）：传入要处理的数据，或告诉动作走哪条分支。外部调用（见 Quicker 启动协议）：

• 怎么传入
• 怎么读取
• 直接写入变量（1.41.0+）
• 返回值

服务器资源有限，不要频繁、尤其不要循环调用这些接口。否则 IP 可能被屏蔽，Quicker 也会受影响。接口索引：https://tools.getquicker.cn/swagger/index.html

• 动作
• 版本
• 工具 API
• 其它服务

动作若要保存用户产生的数据，请放到：Windows 个人文档目录 \Quicker\动作名\

有的动作要让使用者自己填：依赖程序的路径、API 凭据、个人习惯等。相关：状态存取、表单、自定义右键菜单、动作参数。

• 做法
• 示例：一译