计划任务

什么是计划任务？

“计划任务” (Schedule) 是安宝助手的核心驱动力。它将您之前创建的平台、凭证和脚本有机地串联起来，定义了一个完整的自动化流程：“在何时、用哪个账号、执行哪个脚本、并传入什么参数”。

功能概览

1. 查看计划任务列表

进入“计划任务”页面后，您会看到一个包含所有已创建任务的列表。列表中会显示任务名称、关联的脚本、执行方式、启用状态以及下次预计的运行时间。

2. 创建新计划

点击页面左上角的 “新建计划” 按钮，进入创建表单。这是一个功能强大的表单，请按以下步骤操作：

1. 任务配置:

   • 任务名称: 为您的任务起一个易于识别的名称。
   • 是否启用: 控制此任务是否会按时执行。您可以随时在此处或列表页中开启/关闭任务。
   • 任务类型:
     • 立即执行: 任务保存后将立刻执行一次。
     • 定时执行: 您需要提供一个标准的 Cron 表达式来定义任务的周期性执行时间（例如 0 9 * * * 代表每天上午9点执行）。

2. 选择脚本与版本:

   • 首先，从“选择脚本”下拉列表中选择您要执行的逻辑脚本。
   • 然后，从“选择版本”下拉列表中选择该脚本的一个具体版本。

3. 填写脚本参数 (核心):

   • 当您选定一个脚本版本后，其下方的表单区域会动态生成该脚本所需的所有输入参数。
   • 请根据表单提示，填写所有必填的参数。

4. 选择凭证 (核心):

   • 智能过滤: 系统会根据您所选脚本的 keywords，自动筛选出兼容的凭证。不兼容的凭证会被禁用，以防止您误选。
   • 多选与优先级: 您可以为一个任务选择多个凭证。在下方的凭证列表中，您可以为每个凭证设置 1-255 的优先级（数字越小，优先级越高）。任务执行时，会按照优先级从高到低的顺序，依次尝试使用这些凭证。

5. 配置长期启动参数 (高级):

   • 在凭证选择下方，您可以找到 “启动参数” 的 JSON 编辑器。
   • 这是一个高级功能，允许您通过编写 JSON 对象来精确控制浏览器启动时的行为。您可以直接在这里设置任何 Playwright 支持的 launchOptions。
   • 常用示例:
     • 开启有头模式并慢速执行: { "headless": false, "slowMo": 100 }
     • 使用系统安装的 Chrome 浏览器: { "channel": "chrome" }
   • 这些参数将被保存，并在每次该任务自动或手动执行时生效，除非被“带参运行”的临时参数覆盖。
   • 重要: 参数的合并规则遵循特定逻辑，详情请参考 [[开发者/元数据块|元数据块]] 文档中的 @launchOptions 说明。

6. 保存任务:

   • 填写完所有信息后，点击 “提交” 按钮。
   • 如果任务类型是“立即执行”，任务会马上开始运行。

3. 列表页快捷操作

在计划任务列表中，您可以对每个任务进行快捷操作：

• 运行: 这是一个下拉按钮，提供了两种运行方式：
  • 直接运行: 无论该任务是定时还是手动类型，点击此按钮都会立即触发一次执行，使用您在表单中配置的长期参数（如果有）。
  • 带参运行: 点击后会弹出一个对话框，其中包含一个 JSON 编辑器，允许您为本次运行提供临时的 launchOptions。这对于需要临时开启“有头模式”来调试或手动登录的场景非常有用。
  • 您在此处输入的 JSON 对象将作为最高优先级的设置，覆盖掉计划任务中配置的“长期启动参数”以及脚本元数据中的默认设置。
• 编辑: 进入表单修改任务配置。
• 删除: 删除该计划任务。