SuperAPI AI 工具集

spritecook-use-presets

设计与创作

查看项目

更新于 10-16 06:39

技能介绍

用途

SpriteCook Use Presets 用于通过 MCP 使用 SpriteCook 中已保存的预设。预设是保存下来的 SpriteCook 设置与提示词配方,其目的是帮助用户之后获得一致、相似的输出,尤其是在需要一批风格、模型、提示词结构、尺寸、颜色指引和参考图都相同的相关素材时。用户可以在 SpriteCook 应用中微调并保存预设,然后让智能体通过 MCP 使用这些预设。

该技能应与 spritecook-workflow-essentials 以及相关的生成技能配合使用。

何时使用预设

在以下情况使用预设:

  • 用户明确说“使用我的预设”;
  • 用户点名某个已保存的预设;
  • 用户要求生成与某个已保存 SpriteCook 设置匹配的素材;
  • 用户暗示要与某个已命名的已保存风格或工作流保持延续,例如“用我的角色预设来做这个”。

不要在普通生成请求中默认浏览预设。如果用户没有提到或暗示预设,应使用常规的 SpriteCook 生成工作流。

只有在用户要求保存预设或要求为将来保留这些设置时,才使用 save_private_preset。

获取与应用

  1. 调用 list_presets(query=...),传入用户的预设名称或意图。
  2. 优先按标题选择最佳匹配,其次参考 mode、status、description 和 settings。
  3. 如果仍有多个可能匹配的预设,在生成前先提出一个简短的澄清问题。
  4. 调用 get_preset_settings(preset_id=...) 获取所选预设。
  5. 将返回的设置映射到相关的 MCP 工具:
    • prompt -> 基础提示词或提示词指引。
    • themeText -> theme。
    • styleText -> style。
    • width、height、pixel、bgMode、aspectRatio、smartCropEnabled、smartCropMode、detailedModel、resolution、quality 和 colors -> 在目标工具支持时映射为对应的生成参数。
    • settings.reference.styleAssetIds -> generate_game_art 的 style_asset_ids,最多 10 个资产 ID。
    • settings.reference.contextAssetId -> generate_game_art 的 reference_asset_id。
    • settings.reference.editAssetId -> generate_game_art 的 edit_asset_id,仅在用户正在修改该特定图像时使用。
    • tilesetPerspective、tilesetPieceSet 和 tilesetElevation -> generate_tileset 的设置。

应保留用户请求的主体或改动。预设应指导风格与设置,不应覆盖用户的新意图,除非用户要求完全重复。

参考图

私有草稿预设可以返回自有资产 ID:

  • settings.reference.styleAssetIds
  • settings.reference.contextAssetId
  • settings.reference.editAssetId

已发布预设可以返回冻结的预设媒体 URL:

  • settings.reference.styleUploadUrls
  • settings.reference.contextUploadUrl
  • settings.reference.editUploadUrl

使用规则:

  • 调用 generate_game_art 时,将 settings.reference.styleAssetIds 直接用作 style_asset_ids,最多传入 10 个 ID。
  • 当预设提供一个具体的视觉/上下文参考时,将 settings.reference.contextAssetId 用作 reference_asset_id。
  • 仅当用户正在修改该特定图像时,才将 settings.reference.editAssetId 用作 edit_asset_id。
  • 将风格资产 ID 视为环境风格指引图:它们为新相关素材确立风格、调色板、比例和渲染方式。除非用户要求强调某个具体细节,提示词无需再次说明它们是风格参考。
  • 如果预设返回多个风格资产 ID,而目标工具只接受一个,优先使用第一个风格资产,除非用户要求另选。
  • 如果预设返回的上传 URL 无法被目标 MCP 生成工具使用,仍应使用文本/模型/尺寸/颜色设置,并说明该媒体参考无法通过该工具应用。

保存预设

仅在用户要求保存预设后,才使用 save_private_preset(...)。

  • 预设只保存为私有草稿。不要发布、分享或提交任何内容进行审核。
  • 应包含对可重复性重要的设置:提示词模式、主题、风格、模型、尺寸、像素模式、背景模式、智能裁剪、质量、颜色,以及受支持的参考/编辑/风格图像。
  • 当用户希望保存的预设包含这些图像时,使用 style_references、reference_image、edit_image 和 preview 资产 ID。
  • 如果因私有预设数量上限或参考资产不可用而保存失败,简要说明用户可见的问题,不要用缺失的参考重试,除非用户要求。

实用示例

当用户说“用我的角色预设做一个蓝色巫师待机精灵”时:

  1. list_presets(query="character")
  2. 选择可能的角色预设。
  3. get_preset_settings(preset_id="...")
  4. 使用预设的风格/设置加上新主体进行生成:蓝色巫师待机精灵。

限制

资料未提供该技能的具体收费、价格、支持平台、生成效果保证等信息。预设的可用性取决于 SpriteCook 应用中已保存的预设及 MCP 工具的支持范围;部分媒体参考可能无法被目标生成工具使用。