Automation Studio 自动化
用一个模板自动处理放入热文件夹的每张照片,并可选择自动上传和自动打印。
Automation Studio 是一个"热文件夹"处理器。给它指定一个文件夹,放进去的每张照片都会依次套用你的某个模板进行处理,全程无需有人操作电脑。它不用来制作模板,而是套用你已经做好的模板。
适用版本:Advanced Pro
Automation Studio 自 5.2.0.0 起加入 Q-Booth 5。它需要 Advanced 或 Pro 许可证(包括其演示版),Basic 上不会出现。模板本身的要求仍然适用:例如 AI Offline 工作流模板需要 Pro 才能运行。
使用场景
- 把照片保存到某个文件夹的相机或联机拍摄软件。
- 流动摄影师的照片会进入共享文件夹或网络文件夹。
- 用同一个模板批量重新处理大量已有照片。
Automation 独立运行,不在任何 Event 之内。它运行时会占用整台电脑,最好使用一台专用电脑。
可用的模板
| 可用 | 不可用 |
|---|---|
Photo Studio(.qsp)、拼贴 Collage(.qsc)、AI Online(.qso,仅限图片输出)、AI Offline 和换脸 Face Swap(.qsd) | Motion、艺术工作室(.qsk)、Lenticular、Flipbook、Augmented Reality |
模板还必须满足:
- 只需要一张照片作为输入;
- 不需要宾客输入文字;
- 输出图片而不是视频(以视频结尾的 AI Online 模板会被拒绝)。
AI Online 模板每处理一个文件都会消耗额度。请先用 Photo Studio 模板测试你的设置。
设置
打开 Studio › Automation。左侧是设置,中间是源文件夹和结果文件夹列表,右侧是 预览 / 日志 标签页。右上角的标记显示 Automation 已关闭 或 Automation 已开启。

1. 模板
- 在 模板 区点击 打开。
- 选择 从相册...、浏览文件... 或 最近文件。
- 如果模板不符合上述规则,Q-Booth 会拒绝载入并说明原因(见下表)。按钮下方会显示已载入模板的完整路径,或 未载入文件。
| 提示信息 | 含义 |
|---|---|
| "模板必须只需要一个照片输入才能用于 Automation" | 模板需要 0 张或 2 张以上照片。对拼贴来说,必须正好有一个独立照片图层;3 张或 4 张照片的条幅无法使用。请做一个只有一个照片位的版本。 |
| "需要文字输入的模板不能用于 Automation" | 去掉文字问题(拼贴中的 User Input Text 图层,或 AI 模板中的动态提示词问题)。 |
| "Automation 暂不支持视频输出" | AI Online 模板以视频结尾。请使用图片模型。 |
| "未知或不支持的模板类型" | Motion、艺术工作室、Lenticular、Flipbook、Augmented Reality,或不是模板文件。 |
2. 文件夹
- 点击 源文件夹 › 选择文件夹...,选择照片进入的文件夹。最近的文件夹 列出用过的文件夹。
- 点击 结果文件夹 › 选择文件夹...,选择成品存放位置。如果文件夹还不存在,Q-Booth 会自动创建。源文件夹和结果文件夹请使用两个不同的文件夹。
- Q-Booth 只读取
.jpg、.jpeg和.png文件,按时间从旧到新处理。其他文件(例如 RAW 或 HEIC)会被忽略。 - 只处理直接放在源文件夹中的文件,子文件夹里的照片不会被处理。
- 每张处理过的照片会被移动到源文件夹内的
done文件夹,所以不会被重复处理。处理失败的照片会移到error文件夹,队列继续处理下一张。不要让相机软件把照片保存到done或error中。 - 要重试失败的照片,先在 日志 中查看原因并修正,再把照片从
error移回源文件夹。
Automation 会移动你的源照片。请务必让它处理副本,不要处理你唯一的原件。
3. 输出(文件名)
| 选项 | 结果 |
|---|---|
| 结果文件格式 › 自动 | 自动生成的唯一名称,例如 event_1722244000_a3fd.jpg。 |
| 结果文件格式 › 输入名称 | 按源文件命名并加上你的 前缀,例如 beach_IMG_0231.jpg。前缀为必填。 |
| 如果文件已存在 › 覆盖 | 替换同名的已有文件。 |
| 如果文件已存在 › 新建 + 后缀 | 创建带数字后缀的新文件,例如 beach_IMG_0231_1.jpg。 |
如果文件已存在 只对 输入名称 有意义,因为自动名称总是唯一的。当模板为一张照片生成多个结果时,输入名称会给额外的结果编号:beach_IMG_0231.jpg、beach_IMG_0231_1.jpg,依此类推。如果模板保存了原始照片的副本,该副本保留自动名称。
4. 叠加
自 5.9.6.1 起,这里是一个 Disabled / Auto / Custom 切换(Disabled 就是以前的 Off)。
- Auto:遵循模板自身的叠加设置。模板设为默认时,使用设置 › 叠加与滤镜 中的全局叠加。
- Custom:用你通过 选择叠加图片 选的 JPG 或 PNG 替换模板叠加(此模式下必须选图)。
- Disabled(5.9.6.1 之前为 Off):完全不加叠加,即使模板里设置了叠加。
Custom 和 Disabled 只在 Automation 中生效,不会修改模板文件。
自 5.9.6.1 起,选 Custom 时,把照片放进相框的窗口里 开关会把每个结果放进相框的窗口里(参见 把照片放进相框)。和叠加图片一样,它只在本次 Automation 中有效。
结果上的二维码
Automation 遵循模板自身的 QR Overlay 设置:默认 使用设置中的全局 QR on Result 设置,禁用 和 自定义 则按模板设置执行。它从不使用 Event 的二维码设置,因为它不在 Event 中运行。
- 二维码在文件重命名之后添加,所以总是指向文件的最终名称。
- 必须在 设置 › QR 分享 中设置好 Web QR。否则会跳过二维码,日志显示"已跳过在结果上添加二维码 — 尚未设置 Web QR。"
- 带二维码的结果总会被上传,即使 自动上传 Web QR 已关闭,因为照片不在线的话,印出来的二维码毫无用处。
5. 选项:自动上传与自动打印
- 自动上传 Web QR:把每个结果上传以生成二维码链接,使用 设置 › QR 分享 中设置的上传方式(API 或 FTP)。上传在后台进行,下一张照片无需等待。未设置 Web QR 时不会上传任何内容。
- 自动打印结果(自 5.5.1.0 起):每生成一个结果就打印一份,使用 Q-Booth 的自动打印机选择(设置中已开启的打印机里最空闲的那台)。请先在 打印机设置 中设好打印机。
- 始终只打印一份。只打印图片;视频结果会被跳过("已跳过自动打印 — 此结果没有可打印的图片。")。
- 如果模板生成多个结果,只打印第一张图片。
- 打印机出问题永远不会让 Automation 停下:问题会写入日志,下一张照片照常处理。
- 没有设置打印机时,日志显示"已跳过自动打印 — 尚未设置打印机。"
测试时请保持两个开关关闭。自动打印会真的用纸,自动上传会真的上传。自动打印结果 在重启后仍保持开启;自动上传 Web QR 则不会(见 会被记住的设置)。
6. 时序
处理间隔延迟 是处理每张照片前的等待时间,单位为 秒(最少 1 秒,默认 5 秒)。适当的间隔可避免电脑过载,也让操作员有时间暂停。
启动 Automation
- 点击 启动 Automation。Q-Booth 会先检查设置;如果缺少模板、文件夹、前缀(输入名称 模式)或自定义叠加图片,或者延迟无效,就不会启动。显示 Background Job In Process 时也不会启动:说明后台结果(例如宾客的"稍后领取")还在生成。请等待,或在 Jobs 面板中暂停后台队列。
- 标记变为绿色:Automation 已开启。
- 每张照片处理前会弹出倒计时窗口,显示 上一个结果、下一张图片 和倒计时秒数。点击 立即处理 跳过等待,或点击 暂停 Automation 停下。
- 随后照片会进入普通的处理窗口,与在 Studio 中处理完全相同。

查看运行情况
- 照片逐张从 源文件夹 列表中消失,结果出现在 结果文件夹 列表中。每个列表都显示文件数量。
- 预览 标签页显示你点击的文件,每次处理成功后会自动跳到最新结果。
- 日志 标签页按时间记录每一步:模板已加载、Automation 已启动 (ON)、处理中、处理成功、上传和打印记录、错误、Automation 已停止 (OFF)。照片处理失败时,日志会显示原因("Process error : …")。日志保留最近 100 行,关闭 Q-Booth 时清空。
- 文件夹清空后,Automation 仍会继续监视,每秒检查一次。放入新照片,它会立刻被处理。
- 倒计时窗口和处理窗口位于应用最上层,所以在处理照片期间无法在 Q-Booth 中做其他操作。

停止 Automation
点击 停止 Automation。处理会在下一个安全点停止,而不是在处理某张照片的中途停下。标记恢复为 Automation 已关闭。倒计时期间请用 暂停 Automation。处理期间,如果处理窗口提供 取消,取消也会停止 Automation;该照片留在源文件夹中,下次启动时会重新处理。
分享 会为预览中显示的文件打开分享窗口,方便你手动重新发送某个结果。
如果软件或电脑突然停止,只需再次点击 启动 Automation。源文件夹本身就是队列,只要照片还没被移到 done 或 error,就不会丢失也不会重复处理。
会被记住的设置
- 模板、源文件夹、结果文件夹 和 自动打印结果 在关闭 Q-Booth 后仍会被记住,所以专用的自动处理电脑重启后即可直接使用。
- 其他设置(输出、叠加、自动上传 Web QR、延迟)在 Q-Booth 打开期间保持不变,但重启后会恢复默认值。
- 重置(仅在 Automation 关闭时可用)会在询问"重置所有 Automation 设置?"后清除全部设置,不会删除任何文件。
小提示
- 处理副本:源照片会被移动。
- 先在关闭打印和上传的情况下测试,再打开它们。
- 使用只需一张照片、无需输入文字的模板。
- 如需把结果与相机原始文件对应起来,请使用带前缀的 输入名称。
- 运行结束后检查
error文件夹和 日志。
故障排除
点击启动 Automation 没反应或出现警告。
阅读提示信息:"未选择模板"、"未选择源文件夹"、"未选择结果文件夹"、"此选项需要文件前缀"、"请为 Custom overlay 选择一张 overlay 图片"或"延迟至少为 1 秒"。修正对应设置后再启动。
我的模板被拒绝了。
该模板需要多张照片、需要输入文字、输出视频,或来自 Automation 不支持的 Studio(Motion、艺术工作室、Lenticular、Flipbook、Augmented Reality)。请使用单张照片、输出图片的模板。
新照片没有被处理。
确认照片以 JPG 或 PNG 格式(不是 RAW 或 HEIC)直接保存在源文件夹中(不是子文件夹),并且 Automation 处于开启状态。
我的原始照片去哪儿了?
在源文件夹内的 done(成功)或 error(失败)子文件夹中。
结果互相覆盖。
你使用的是 输入名称 加 覆盖。请改为 新建 + 后缀。
无法启动:"Background Job In Process"。
等待后台结果完成,或在 Jobs 面板中暂停队列。
重启后设置被重置了。
只有模板、文件夹和自动打印结果会被记住。
"已跳过自动打印 — 尚未设置打印机。"
先在设置中配置打印机,再开启 自动打印结果。
"已跳过在结果上添加二维码 — 尚未设置 Web QR。"
在 设置 › QR 分享 中配置 Web QR。
下一步
仍需要帮助?
我们的团队在 WhatsApp 上为您解答。请告知 Q-Booth 版本及屏幕上显示的内容。