跳转到内容

任务

任务是什么?

任务是 Kabegame 中执行图片收集的工作单元。每个任务代表一次完整的图片收集过程,包括:

  1. 执行插件脚本:任务会执行某个源插件的脚本,从目标网站或本地文件系统收集图片
  2. 按照配置的参数:根据你提供的参数(如搜索关键词、页码、URL 等)执行收集逻辑
  3. 下载图片到指定位置:将收集到的图片下载并保存到你指定的输出目录
  4. 添加到画廊和画册:下载完成后,图片会自动出现在画廊;如果指定了画册,也会立刻出现在该画册里

任务创建后,会在后台自动执行,你可以在任务抽屉中查看进度和状态。

并发:两个独立的设置

任务的执行节奏由两个独立的设置项控制,它们容易被混淆:

设置默认值范围控制对象
同时运行任务数21–10同时可以执行的任务数量
最大并发下载量31–10所有任务合计同时下载的图片数量

也就是说:默认情况下最多只有 2 个任务在跑,其他任务会进入「等待中」;这 2 个任务合计最多同时下载 3 张图片

举例:一次性创建 10 个任务,默认会看到 2 个「运行中」+ 8 个「等待中」。要让更多任务并行,请在「设置」→「下载设置」里调高「同时运行任务数」。要让下载本身更快(同一任务内或跨任务),请调高「最大并发下载量」。


任务状态

任务共有五种状态,在任务抽屉和任务详情页的徽章上统一显示:

状态含义
等待中任务已创建,受「同时运行任务数」限制暂未开跑
运行中任务正在执行,正在抓取列表或下载图片
完成任务正常结束,全部目标都已处理
失败任务执行过程中出现错误,已中止
已取消任务被用户手动停止

运行中的任务卡片上还会出现下载阶段标签(准备中 / 下载中 / 解压中 / 处理中 / 完成 / 失败 / 已取消)与实时进度条,方便你判断当前正卡在哪一步。


任务抽屉

画廊、画册、任务详情页、畅游图片页的右上角都有一个圆形「列表」按钮(带红色未完成数徽章,最多显示 99),点击后任务抽屉从右侧滑入(Android 下为全宽抽屉)。

任务抽屉分为两个可折叠面板:

正在下载

展示当前每一张正在下载的图片:图片 URL、来源插件标签、阶段标签、已收/总字节与进度条。这里直接对应「最大并发下载量」设置。

任务列表

展示每个任务的卡片:插件图标、摘要、进度条,以及下列操作按钮。

按钮作用
参数打开运行参数对话框,查看这次任务用到的插件参数
图片跳转到该任务的详情页
日志打开任务日志对话框,查看脚本执行日志
停止仅在「运行中」且已有进度时显示
×删除该任务记录(运行中会自动先停止)

桌面端右键任务卡片还会出现菜单:查看 / 删除 / 保存为运行配置。保存后的运行配置可以在下次创建任务时快速复用同一套参数。

顶部显示「共 N 个任务」,右侧的「清除所有任务 (N)」按钮会一次性清掉非运行中、非等待中的全部任务;如果当前没有可清的任务,会提示「没有可清除的任务(所有任务都是等待中或运行中)」。

触底加载

任务很多时不用担心抽屉会卡住:任务列表按最新优先排序,一次只加载 20 条,向下滑动到接近底部时会自动继续加载更多历史任务。


任务详情页

在任务抽屉里点击「图片」按钮,或右键任务选择「查看」即可进入任务详情页(/tasks/:id)。

顶部操作

页面 Header 右上角集中了所有任务级操作:刷新、停止任务(仅运行中)、删除任务、加入画册(一键把任务的全部成功图片加入画册)、打开任务抽屉、查看日志、查看运行参数、帮助、快捷设置。Android 上这些按钮会折叠进菜单。

成功 / 失败切换

工具栏中央是「筛选」控件,只有两个选项:

  • 成功图片:默认视图,展示已成功入库的图片网格。
  • 失败图片 (N):展示所有下载失败的记录,括号里是当前失败数量。

搜索、分页、每页数量

  • 搜索框(仅桌面,Android 隐藏):按图片显示名进行子串搜索。
  • 每页数量:100 / 500 / 1000 三档切换,与画廊共用设置。
  • 分页器:图片总数超过一页时出现,可输入页码或翻页。

成功图片视图

ImageGrid 网格,支持:双击预览大图;单击选中、Shift 范围选择;右键菜单包括详情、收藏、加入画册、复制、打开所在文件夹、设置壁纸、隐藏、删除。

失败图片视图

每条失败记录是一张独立卡片,展示:

  • 失败 URL(点击可在浏览器中打开)
  • 错误信息(附「复制」按钮,可把 URL / 错误 / 插件 / 时间一起复制)
  • 插件标签与失败时间
  • 正在重试时会出现进度条 + 阶段标签
  • 「重试」按钮:重新走一次下载流程;若本质问题是权限或 URL 失效,仍会再次失败
  • 「删除」按钮:仅删除失败记录,不涉及本地文件(因为本就没下载成功)

统计副标题

任务标题下方是一串动态统计:共 N 张 · 失败 N 张 · 已删除 N 张 · 去重 N 张 · 运行 XX 分钟

下载进行中时,这些计数会实时刷新,运行时间每秒跳动,无需手动刷新页面。


全部失败图片

除了单个任务详情页里的失败视图,Kabegame 还提供一个跨任务的「全部失败图片」页面,入口是画廊/任务详情页右上角的「失败图片」按钮。

你可以在这里:

  • 插件筛选失败记录,快速聚焦某个源的问题。
  • 全部重试:批量重跑所有符合当前筛选条件的失败下载。
  • 全部删除:批量清除失败记录。
  • 在每条卡片上点「在浏览器打开」直接排查 URL,或点「查看任务」跳回对应任务详情。
  • 对还在等待/重试队列中的条目,点「取消等待」或「取消重试」可以中止它们。

创建任务

方式一:通过收集对话框创建

在画廊页面点击右上角的「开始收集」按钮,打开收集对话框:

  1. 选择源:从下拉列表中选择要使用的插件
  2. 配置参数:根据插件要求填写必要的参数
  3. 输出目录:选择图片保存的位置(留空使用默认下载目录)
  4. 输出画册:可选,选择将图片添加到哪个画册(也可以新建画册)
  5. 运行配置:可选,选择之前保存的运行配置快速复用参数
  6. 点击「开始收集」按钮即可创建任务

方式二:拖入文件自动创建导入任务(仅桌面)

将本地图片文件或文件夹直接拖入应用窗口,会自动创建本地导入任务。Android 上使用系统媒体选择器完成导入。


停止任务

如果任务正在运行,你可以随时停止它:

  • 任务抽屉:找到要停止的任务,点卡片上的「停止」按钮;或右键选择「删除」(会先停止再删除)。
  • 任务详情页:状态为「运行中」时,Header 会显示「停止任务」按钮,点击即可中止。

停止后,已下载的图片会保留,任务状态会变为已取消


删除任务

  • 任务抽屉:找到要删除的任务,点卡片右上角的 × 按钮;或右键选择「删除」。
  • 任务详情页:点击右上角的「删除任务」按钮。
  • 批量清除:在任务抽屉顶部点击「清除所有任务 (N)」,一次性清掉非运行中、非等待中的所有任务。

平台差异

能力WindowsmacOSLinuxAndroid
任务抽屉、任务详情✅(全宽抽屉)
任务详情页搜索框
拖入 zip / 文件夹创建本地导入❌(走系统选择器)
抽屉右键菜单(保存为运行配置等)

延伸阅读

  • 画廊:任务下载完成后图片所在的主视图,以及本地导入、清理等操作。
  • 插件使用:创建任务时如何选择源插件与填写参数。
  • 设置:并发、下载间隔、重试次数、自动去重等会影响任务行为的设置。
  • 命令行:需要脚本化批量创建任务时使用。
  • 快捷键:任务详情页预览与选择相关的按键。