mcpField
O
od-next-media-inputs

od-next-media-inputs

github.com/nexu-io创意与媒体104.6k346 次安装今天更新
代码仓库

关于 od-next-media-inputs

OD Next Media Inputs 是用于按现有项目计划准备媒体素材的 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/nexu-io/open-design --skill od-next-media-inputs

安装后在 Claude Code 中输入/od-next-media-inputs确认已加载。

详细介绍

OD Next 媒体输入

仅在当前任务需要媒体输入时使用。只要这些说明仍适用,就继续遵循;对于不涉及素材的任务,不要加载这些说明。遵循当前路线、阶段、冻结计划和交付边界。在 contract_repair 阶段,不得调用任何工具。必须先完成所需的输入工作,再写入依赖这些输入的交付内容。不得将写入后的产物检查、渲染、验证或修复标记为输入准备,以规避写入即交付规则。

保留必需的素材槽位

使用现有工作上下文中冻结的素材要求:用途、主体、来源/许可限制、几何属性、复用位置和就绪状态。复用合适的用户素材,并在多个页面中使用同一素材。对工作去重,但不要合并不同主体或必需状态。不要添加新的计划、清单、审批步骤或审核 Agent。保留每项必需素材及其质量要求,包括语义契合度、真实性、许可、本地或内嵌引用,以及图像几何属性。

为每个图像槽位选择路线

根据 Core imagery-by-type 规则决定每个槽位的路线,以及素材搜索可使用哪些库;该规则是这些规则的唯一来源。

搜索图库照片

  • 使用经过身份验证的守护进程包装器和现有的 Vela 登录,通过公司服务在一次调用中获取所有图库槽位: "$OD_NODE_BIN" "$OD_BIN" media stock-search --slots '[{"id":"hero","query":"black eyeglasses frame","width":1200,"orientation":"landscape"}]'。 使用英文撰写查询,并将主体置于首位。该服务遵循已配置的渠道优先级,在尝试次数限制内每个渠道最多尝试一次,根据替代文本排序,并返回每项结果。包装器会将图像下载到 assets/stock/,并在 assets/stock/credits.json 中记录署名信息。提供商密钥保存在服务器上;绝不要要求用户配置图库提供商密钥。
  • 如果命令失败或超时,或者某个槽位返回 error、not_found 或 budget_exceeded,请保留成功下载的本地文件,并仅对缺失槽位使用可用的网页/图像搜索工具。这包括服务/登录不可用、API 错误、速率限制和图像下载失败的情况。对于这些失败的槽位,不要再次调用图库工具。
  • 搜索图库的公开页面,或搜索真实具名主体的正确官方来源。选择实际图像 URL 前,先阅读每项结果的标题/替代文本、来源和许可;绝不要捏造 URL 或 ID。
  • 对互不依赖的下载进行批处理,将每个请求限制在 10–15 秒内,并在现有获取预算耗尽时停止。遇到 HTTP 403/429 时,改用其他来源,不要循环重试;每个缺失槽位最多进行一次替代网页搜索。保留成功的图像;若未找到可用图像,须说明使用了设计占位图。
  • 按显示尺寸下载(最长边不超过 1600 px),并将每张 JPEG 或 WebP 控制在约 400 KB 以下。
  • 在素材旁的 sidecar 文件中保留每张照片的页面 URL、作者(如有显示)和来源许可。根据 Core Image attribution 规则,决定这些元数据是否需要出现在可见成品中。
  • 时间预算耗尽时,保留已成功获取的文件。对于任何剩余槽位,使用并说明占位图。

复用能力并按原因恢复

仅使用本次运行实际提供的工具、模型 ID、参数和权限。复用完整且有效的能力结果。仅查询缺失、截断或已失效的信息;当环境、授权或错误导致决策发生变化时,刷新相关信息。目录中的条目本身并不能证明已获授权或已就绪。不要猜测工具或模型名称,也不要泄露凭据值。

重试前先对失败进行分类:

  • 授权:稳定存在的凭据缺失或无效,不能通过更换主题或猜测其他模型来解决。仅使用经验证且获准的替代方案,或现有约定中的回退方案;绝不要绕过访问控制。
  • 参数:根据实际能力或错误信息更正不受支持的输入,不要查找猜测的别名。
  • 临时故障:遵循现有的重试指导和预算。如果任务已被接受,先获取其结果,再创建另一个任务。根据相关指导,可对可重试的瞬时错误使用不变的参数重试。
  • 资源不匹配:更正该占位位置的主题或构图;不要重命名所请求的主题、删除该位置,也不要扭曲内容来掩盖失败。

仅当更改能解决原因、相关状态发生变化,或现有指导允许重试临时故障时,才进行重试。 不要为了减少调用次数而牺牲必要质量;应在时间预算内进行图库照片搜索。

批量处理相互独立的输入

当工具支持且输入相互独立时,应批量执行搜索、获取、下载、格式处理以及固有宽高测量。保留每个项目的结果和失败情况;依赖请求应按顺序执行。对未更改的文件复用有效测量结果;转换后,在调整容器大小之前,重新测量受影响的文件。

HTTP 成功和文件/大小探测不能证明内容符合要求;应按照“核心图像规则”所述进行判断,不要将图像读回对话中。

收集结果并在完成后停止

保留每个实际任务 ID、状态、返回的游标、原始响应和输出位置。仅使用受支持的等待或批量操作。仅凭提交成功和退出成功,不能证明资源已就绪。在获得明确的终态结果且输出/错误信息完整后,停止轮询该任务;失败或中断的终态结果不可用作资源。对于仍在运行的任务、不完整结果或新错误,继续执行必要的获取操作。重新解析已保存的响应,不要仅为更改格式而再次请求。

当所有必需位置都满足其内容和输入条件时,停止获取资源。如果必需资源仍不可用,则遵循现有的回退/失败约定并保留不确定性;绝不要仅仅因为调用次数较少就宣告完成。

评论

支持 Markdown