mcpField
E
experience-content-media-image-generate

experience-content-media-image-generate

github.com/forcedotcom创意与媒体1.1k54 次安装1 天前更新
代码仓库

关于 experience-content-media-image-generate

这项 skill 用于生成、下载和预览图像资源。它先检查 `media-management` MCP 服务的 `create_image` 工具;若不可用,则提供固定的占位图 URL。

主要功能

  1. 01检查图像生成工具是否可用
  2. 02使用 `create_image` 生成图像
  3. 03配置输出格式与质量
  4. 04下载并预览生成的图像
  5. 05使用固定占位图作为后备

适用场景

  1. 01根据自然语言提示生成图像
  2. 02保存并预览生成的资源
  3. 03生成不可用时提供图像源

MCP 相关

若可用,则调用 `media-management` MCP 服务的 `create_image` 工具;否则指定占位图 URL 作为后备。

安装

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

$npx skills add https://github.com/forcedotcom/sf-skills --skill experience-content-media-image-generate

安装后在 Claude Code 中输入/experience-content-media-image-generate确认已加载。

附带文件scripts/download-image.sh

详细介绍

生成图像

目标

以编程方式生成、下载并预览用户请求的视觉素材,确保符合指定的格式和质量标准,同时提供可靠的备用方案。

工作流

  1. 检查是否已配置 media-management MCP 服务,以及其 create_image 工具是否可用。
  2. 如果可用,使用 create_image 生成图像。
  3. 如果不可用,使用下面的占位图备用方案。

MCP:media-management

工具: create_image

检查可用工具。如果存在 create_image,请将其作为主要图像生成方式,并传入自然语言提示词和下表中适用的参数。(此处的 media-management 指 MCP 服务名称,而非此技能。)

如果工具列表中没有 create_image,则表示未配置 media-management MCP,请使用下面的占位图备用方案。

图像生成参数

除非用户另有指定,否则使用以下默认值:

参数默认值选项
modelStandardStandard、Premium
sizeautoauto、1024x1024、1536x1024、1024x1536(选择最接近用户要求尺寸的选项)
qualitymediumlow、medium、high
outputCompression750–100(仅适用于 webp/jpeg)
outputFormatwebpwebp、jpeg、png
backgroundautoauto、transparent、opaque

**格式规则:**如果 outputFormat 为 png,请将 outputCompression 设为 100。

成功生成后

运行此技能 scripts/ 目录中的 download-image.sh,下载并预览图像:

bash scripts/download-image.sh \
  --url "<image_url_from_response>" \
  --id "<responseId>" \
  --format "<outputFormat>" \
  --preview

此脚本会处理凭据获取、下载和 VS Code 预览。传入 --output-dir <dir> 可覆盖默认的 generatedimages/ 目录。

**切勿使用外部工具调整生成图像的尺寸或进行后期处理。**要控制显示尺寸,请在使用图像的位置通过 CSS 属性(例如 width、height、object-fit)进行设置。

备用方案:使用占位 URL

如果图像生成失败或未启用,请返回以下 URL 作为图像源;不要下载,也不要在本地保存:

https://cdn.scs.static.lightning.force.com/content/assets/d5222d4a11e6c2b735152d7eea824ce4/placeholder.svg

在代码中引用图像时直接使用此 URL(例如作为 src 属性或 CSS url())。

占位图政策

只有一个占位 URL。不要下载或修改它,也不要使用 Python、ImageMagick 或任何其他工具生成替代占位图。

如果用户要求特定尺寸或格式的占位图,请告知他们只有此占位 URL 可用,并引导他们在使用图像的位置通过 CSS 属性(例如 width、height、object-fit)进行缩放。

评论

支持 Markdown