mcpField
I
image-batch-runner

image-batch-runner

github.com/postplusai创意与媒体271.0k 次安装1 天前更新
代码仓库

关于 image-batch-runner

通过 PostPlus 执行已明确的托管图像生成和参考图编辑请求的 Skill。适用于创意输入已确定的流程，并记录生成文件、请求、响应和清单，便于审核与交接。

主要功能

  1. 01托管图像生成
  2. 02基于参考图编辑
  3. 03下载本地生成文件
  4. 04保存请求与清单记录
  5. 05轮询异步任务

适用场景

  1. 01根据已批准的概念生成图像
  2. 02使用参考图编辑图像
  3. 03保存输出以供后续审核
  4. 04准备视频渲染所需图像素材

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/postplusai/postplus-skills --skill image-batch-runner

安装后在 Claude Code 中输入/image-batch-runner确认已加载。

详细介绍

图像批量运行器

适用场景

  • 人物设定、概念或镜头输入已准备就绪，下一步是运行托管式图像生成或基于参考图的编辑。
  • 输出必须包含本地图像文件，以及用于后续 QA 或视频渲染的持久化请求、响应和清单记录。

不适用场景

  • 任务属于构思、QA，或交接部分列出的其他已发布技能。
  • 缺少必需输入，且猜测会改变结果。
  • 创意分类、模型／参考图策略或故事板逻辑尚未确定。请先使用 image-generation。

执行边界

  • 托管式图像生成和编辑通过公开的 postplus media create 动词异步运行。提交后会记录运行句柄、当前状态和已完成的成品元数据（不会自动下载字节数据；请参见下方的下载命令）。
  • 此运行器用于验证并执行已确定的请求。不得由其制定创意策略、任务分类或参考图策略。
  • 提供了更高质量的默认模型，以及更快或更便宜的模型系列；除非用户或上游说明要求使用特定系列、比例、质量或分辨率，否则优先使用默认模型。下方生成的示例展示了默认端点键。
  • 只有编辑端点接受 --reference-image（默认编辑端点：image-gpt-image-2-edit）。image-gpt-image-2-text 等文本端点会以 Unknown option 拒绝此标志，因此任何绑定参考图的生成都必须指定编辑端点，而非文本端点。
  • 基于参考图的编辑通过重复使用 --reference-image 标志传入每张源图。每个值可以是本地路径、HTTPS URL、现有 PostPlus 媒体引用或 data URI。CLI 会在单次托管提交前验证并准备本地媒体；不要预先上传，也不要构造手动请求对象。
  • 使用 postplus media-file download --reference <output.data.artifacts[0].mediaReference> --output-file <path> 将已完成的图像输出保存到磁盘。使用已完成结果中的成品引用作为下载源。
  • 标识符和运行本地状态（assetId、runId、localAssetDir、清单路径）由运行器生成或推导——不要自行提供。从结果中读取这些值，以便后续交接。

来源与路径

  • 每个请求都必须以基准测试支持的人物设定锁定、概念或镜头需求、视觉约束、assetPurpose 和 sourceBasis 为依据。
  • 优先使用当前项目／客户端文件夹中的源文件。不要将某个客户端目录视为所有图像工作的默认目录。
  • 将内部请求、响应和清单保存在 .postplus 下；将最终面向用户的图像和清单保存在当前资源文件夹中。如果不存在资源文件夹，请选择一个明确的工作区路径。

审核与交接

  • 提交前，确认人物设定依据、资源用途、来源依据，以及哪些内容必须保持固定、哪些可以变化。
  • 生成后，检查真实感、与基准的契合度、跨视频的可重复性、照搬创作者的风险，以及偏向广告风格的情况。
  • 如果处理仍在等待中，返回清单／请求路径以及轮询命令 postplus media poll --handle <output.data.id> --output path/to/generation-result.json。复用初次提交时完全相同的 --output 路径。轮询完成后，会在该路径原子替换处理中 JSON，并写入已完成的结果；优先使用 CLI 返回的操作或同一操作的恢复命令，遵守其等待／恢复边界，切勿提交替代任务。

停止条件

  • 如果缺少必要的用户意图、源证据或用户提供的输入素材，且猜测会改变结果，则停止。

  • 批次金丝雀：在并行处理一批互不依赖的项目之前，先单独提交第 1 个项目，并轮询至终态。如果金丝雀因内容策略被拦截（下方定义的逐项类型代码），则按批次隔离规则记录并跳过该项目，然后对下一个项目执行金丝雀；只有金丝雀成功完成且未被拦截后，才能并行处理其余项目。其他所有金丝雀失败都属于系统性故障：停止。有些失败只有在轮询时才会显现（异步终态），所以即使提交被接受，整个批次仍可能全部失败——金丝雀可将任何系统性缺陷（引用格式错误、服务中断、身份验证问题）的影响范围限制在 1 个项目，而不是整个批次。

  • 批次隔离：处理一批互不依赖的项目时，逐项的内容／安全拒绝只影响该项目。只有通过类型代码 postplus_cli_hosted_media_content_policy_blocked 才能识别，绝不能通过匹配错误文本来判断；它可能在任一边界显现：失败的 postplus media create 命令，其类型化错误 code 为该代码；或者已提交的运行，其轮询结果包含 output.data.status: failed，且 output.data.error.code 设置为该代码。遇到任一情况时，记录被拦截的项目及其确切原因，跳过该项目，并继续提交和轮询其余项目，然后在最后报告未完成的项目集。不得重试、弱化或重新提交被拦截的项目——这属于禁止的载荷改写。其他所有失败（失败的自有 CLI／脚本命令，其类型化 code 不是该内容策略代码；或者运行的 error.code 不是该内容策略代码——如身份验证、传输、配额、请求格式错误或服务中断）都属于系统性故障：按上述规则停止。

公共命令边界

  • 根据用户输入选择最精简的匹配命令或工作流，并直接运行。

  • 就绪状态诊断：postplus doctor --skill image-batch-runner。

  • 轮询待处理的图像任务：postplus media poll --handle <output.data.id> --output path/to/generation-result.json。 复用初始提交时的结果路径，以便完成后的轮询操作原子性地替换处理中状态的 JSON。优先遵循返回的恢复操作，并在到达 CLI 等待／恢复边界时停止。

  • 只有在需要完整的端点、标志和枚举约定，或需要修复未知请求格式时，才使用 postplus media schema --json。

  • 使用下方生成的命令运行托管图像任务；不要使用其他执行接口。

postplus media create image-gpt-image-2-text \
  --prompt "Describe the result you need" \
  --wait \
  --output ./result.json

遵循 CLI 的结构化结果及其报告的下一步操作；不要根据自由文本消息推断恢复方式。 如有请求，等待用户明确批准；某项操作本身并不代表授权消费、发布或覆盖。 通过返回的检查点或操作继续同一操作；切勿重新提交状态不确定的工作、重复已用尽的恢复操作，或切换服务提供商来绕过故障。

  • 请求的任务使用检查当前价格和余额后现有的 PostPlus 额度执行。 仅估算的请求不执行。额度不足时停止；不得充值、购买订阅，或重复状态不确定的付费操作。

评论

支持 Markdown