Skip to main content
v0.1.28 起,CLI 不只负责运行任务,也可以管理远端任务、任务组、模板任务和云定时。会修改远端状态的命令都需要显式传入 --yes。

bazhuayu task list(查看采集任务)

列出账号下的采集任务,并获取后续 run、cloud start、data export 等命令需要的 taskId。
可用筛选条件包括 --keyword、--task-group、--status、--task-type、--scheduled true|false、--template-id 和 --template-version-id。v0.1.33 不再将 --template-registration-id 作为公开参数;新脚本统一使用 --template-id。 如果还没有现成任务,可以使用 bazhuayu detect 检测新 URL 并生成任务文件。

查看、复制、重命名、移动与删除任务

task show 查询远端任务详情;task inspect 更偏向采集任务结构检查,也支持本地任务文件。rename、move、delete 会修改远端任务,必须带 --yes。 运行前建议关注 inspect 输出中的 runOnLabel:

bazhuayu task validate(校验任务定义)

正式运行前建议先校验任务:
CLI 支持本地 .json、.xml、.otd 任务文件,可传给 inspect、validate 和 run:
如果校验失败,请根据错误信息更新任务定义,或回到桌面客户端调整不兼容的采集规则。

bazhuayu task-group(任务组管理)

update、delete 和 set-default 会修改远端任务组状态,必须带 --yes。创建任务组后,可在 task copy、task move、template-task create 和 task list --task-group 中复用 groupId。

bazhuayu template 与 template-task

浏览模板市场、查看模板详情和版本:
使用模板创建或更新任务:
template search 会按公开的 templateId 去重后再分页,同一模板的多语言记录只保留排序靠前的名称。template view、template version 和 template-task create 都使用该公开 ID;CLI 会在内部完成与平台 templateRegistrationId 的映射,不应依赖内部字段。 --params / --params-file 需要传入国内模板接口使用的 userInputParameters JSON 对象。两者不能同时使用。template-task update 会修改远端模板任务映射,必须带 --yes。

bazhuayu schedule cloud(云定时)

CLI v0.1.28 仅开放云定时管理;本地定时依赖桌面客户端的本机队列,仍请在客户端中设置。
--type 支持数字或类型名称:1 / date / once、2 / weekly、3 / monthly、4 / interval-minute、5 / every-hour、6 / daily。update、start 和 stop 会修改远端云定时状态,必须带 --yes。

高风险操作确认

以下命令会修改远端状态,需要显式确认:
  • bazhuayu task rename/move/delete ... --yes
  • bazhuayu task-group update/delete/set-default ... --yes
  • bazhuayu template-task update ... --yes
  • bazhuayu schedule cloud update/start/stop ... --yes
detect --agent 的兼容 --yes 不是高风险确认;新 Agent 脚本仍可省略。

下一步

运行采集任务

本地、云端或任务文件运行。

网页检测与任务生成

从 URL 检测结构并生成本地任务文件。