cloudinary-transformations

Cloudinary 转换规则

适用场景

• 构建 Cloudinary 交付／转换 URL
• 将自然语言请求转换为转换语法
• 调试无法正常使用的转换 URL
• 使用 Cloudinary 优化图像或视频
• 应用效果、叠加、调整大小或裁剪

快速入门

默认最佳实践：始终进行优化

在几乎所有转换 URL 的末尾添加 f_auto/q_auto（作为最后的组件）：

• 自动交付最佳格式
• 优化质量，在视觉质量和文件大小之间取得最佳平衡
• 减少带宽占用并提升性能

示例： c_fill,g_auto,w_400,h_300/f_auto/q_auto

例外情况——不要添加优化组件：

• 账号已启用“Optimize By Default”（默认优化），系统已自动应用优化
• 对质量有特殊要求（改用 q_auto:best、q_auto:low 或手动指定 q_N）
• 需要特定格式（将 f_auto 替换为 f_png、f_jpg 等）
• 原样交付，不做任何修改

常见转换示例（含优化）：

1. 调整大小：c_scale,w_400/f_auto/q_auto
2. 智能裁剪：c_fill,g_auto,h_300,w_400/f_auto/q_auto
3. 移除背景：e_background_removal/f_png/q_auto
4. 文字叠加：co_yellow,l_text:Arial_40:Hello%20World/fl_layer_apply,g_south/f_auto/q_auto
5. 图像叠加：l_logo/c_scale,w_100/fl_layer_apply,g_north_west,x_10,y_10/f_auto/q_auto

重要： 本技能中展示的所有转换字符串都只是用于说明语法和概念的示例。生成转换内容时，应根据用户的实际需求和使用场景选择具体值（尺寸、颜色、位置等），而不是照搬示例中的值。

调试： 详细的故障排查步骤请参阅 references/debugging.md。

收集需求

生成转换 URL 前，如果用户尚未说明，请根据其请求确认以下细节：

调整大小／裁剪请求

必需信息：

• 至少一个尺寸（宽度或高度）
• 如果指定了宽度和高度，需确认裁剪方式（填充、留白、缩放、限制等）

需要确认：

• 焦点／重力（尤其是裁剪时）：人脸检测？居中？智能自动检测？
• 是否保持宽高比？（只指定一个尺寸时会自动保持）

示例问题：

• “需要什么尺寸？（宽度和／或高度）”
• “应该填满空间（可能会裁剪），还是完整放入空间（不裁剪）？”
• “是否有重要的焦点？（人脸、中心或特定区域）”

AI 转换请求

移除背景：

• 输出格式要求（透明背景用 PNG，纯色背景用 JPG）
• 如何处理透明区域（保持透明、添加颜色或使用 gen_fill）

生成式填充：

• 目标尺寸或宽高比
• 需要扩展多少

生成式替换：

• 要替换的对象（from）
• 替换成什么（to）
• 是否保留原始形状？（适用于衣物／物体）

生成式移除：

• 要移除的对象
• 移除所有实例还是只移除一个？

生成式背景替换：

• 描述所需背景（或使用自动生成）
• 是否需要可复现？（可考虑使用 seed 参数）

视频转换请求

剪辑：

• 开始和结束时间，或时长
• 使用秒数还是视频百分比

编解码器／格式：

• 输出格式要求（MP4、WebM 等）
• 质量要求（不确定时使用 vc_auto）

音频：

• 保留还是移除音轨
• 如果用于自动播放，建议移除音频（ac_none）

始终建议

除非用户另有说明：

• 在转换 URL 的末尾添加 f_auto/q_auto（例外情况请参阅“快速入门”部分）
• 填充尺寸时使用 g_auto 进行智能裁剪
• 考虑 AI 转换的成本（告知用户转换额度消耗）

快速参考

URL 结构

https://res.cloudinary.com/<cloud_name>/<asset_type>/<delivery_type>/<transformations>/<version>/<public_id>.<ext>

关键规则：

• 逗号（,）用于分隔同一组件内的参数
• 斜杠（/）用于分隔不同变换的组件
• 每个组件都会作用于前一个组件的输出

参数类型

操作参数：执行变换（每个组件执行一个操作：每个操作变换都应以斜杠分隔） 限定参数：调整操作行为（与操作位于同一组件中，以逗号分隔）

请查看变换参考，以判断参数属于操作参数还是限定参数。

核心变换

调整大小与裁剪

尺寸值格式：

• 整数（例如，w_400、h_300）= 像素
• 小数（例如，w_0.5、h_1.0）= 原始尺寸的百分比（0.5 = 50%，1.0 = 100%）

选择合适的裁剪模式：

在以下情况下使用 c_scale：

• 调整大小时保持原始宽高比
• 仅指定一个尺寸（宽度或高度）
• 无需裁剪
• 用户有意通过改变宽高比来拉伸或压扁图像

在以下情况下使用 c_fill：

• 必须符合精确尺寸（例如，缩略图网格、固定布局）
• 可以裁掉图像的一部分
• 与 g_auto 搭配以实现智能裁剪，或与 g_face 搭配用于人像

在以下情况下使用 c_fit：

• 图像必须适配指定尺寸且不裁剪
• 可以接受留白
• 保留完整图像内容至关重要

在以下情况下使用 c_pad：

• 必须符合精确尺寸且不裁剪
• 需要用背景颜色／模糊效果（仅适用于视频）／AI 生成的像素填充空白区域
• 与 b_<color>、b_auto、b_blurred（模糊背景，仅适用于视频）或 b_gen_fill 搭配使用

在以下情况下使用 c_limit：

• 设置最大尺寸，但不放大小图像
• 保留小图像的原始质量很重要

在以下情况下使用 c_thumb：

• 创建缩略图（通常是头像）
• 与 g_face 搭配以裁剪出居中的人脸

在以下情况下使用 c_auto：

• 让 Cloudinary 智能裁剪到有趣的内容
• 与 g_auto 搭配以获得最佳效果
• 适用于焦点各异的动态内容

示例：

c_scale,w_400                      # Resize width to 400px, maintain aspect ratio
c_scale,w_0.5                      # Resize to 50% of original width
c_fill,g_auto,h_300,w_400          # Fill 400x300px dimensions, smart crop
c_fit,h_300,w_400                  # Fit within dimensions, no crop
c_pad,b_white,h_300,w_400          # Pad to exact size with white background
c_pad,w_1.0                        # Pad to original width (100%)
c_limit,w_1000                     # Limit max width, no upscale
c_thumb,g_face,h_150,w_150         # Face-centered square thumbnail
c_auto,g_auto,w_800                # Auto crop to interesting area

重要：始终明确指定裁剪模式。避免将两个尺寸与 c_scale 同时使用（宽高比不匹配时会导致图像变形）；建议只指定一个尺寸以保持宽高比。

重力（焦点）

重力用于确定裁剪时图像中要聚焦的部分：

• g_auto - 智能检测（推荐用于内容多样的场景；可检测人脸、物体和对比度）
• g_face - 人脸检测（人像、头像）
• g_center - 中心位置（居中主体、徽标）
• g_north、g_south_east 等 - 罗盘方向位置（固定位置、叠加定位）
• x_N,y_N - 自定义偏移（整数 = 像素，小数 = 百分比：0.8 = 80%）

示例：

c_fill,g_auto,w_400,h_300                      # Smart crop
c_thumb,g_face,w_200,h_200                     # Face-centered
l_logo/fl_layer_apply,g_south_east,x_10,y_10  # Logo bottom-right

重要：

• g_auto 仅适用于 c_fill、c_lfill、c_crop、c_thumb、c_auto
• 同时使用 x、y、h、w 时，须全部使用整数或全部使用小数（不要混用）

格式与质量

推荐默认设置：

• f_auto/q_auto - 适用于大多数生产环境中的图像（向支持的浏览器提供 WebP，优化文件大小）

特定格式（按需使用）：

• f_png - 需要透明背景时使用（例如，移除背景后）
• f_jpg - 强制使用 JPEG（移除透明度）
• q_N - 手动设置质量，范围为 1–100（例如，缩略图使用 q_60，主视觉图像使用 q_90）
• dpr_auto - 用于 Retina 显示屏（仅限 Chromium，需要 Client Hints；请参见下方的限制）

示例：

f_auto/q_auto           # Recommended default
f_png/q_auto            # PNG with transparency
q_80                    # Manual 80% quality

最佳实践：使用 / 将格式和质量分隔为不同组件。

响应式图像（dpr_auto、w_auto）

dpr_auto - 自动适配设备像素比（Retina 显示屏）

• 仅支持 Chromium（Chrome、Edge、Opera、Samsung Internet）
• 需要配置 Client Hints
• 在其他浏览器中回退为 dpr_1.0
• 不适用于命名转换

通用支持的替代方案： 使用显式的 dpr_2.0，或通过 <img srcset> 提供 1x/2x 版本

有关 Client Hints 配置、浏览器兼容性、响应式断点和框架集成，请参阅 references/responsive-images.md

效果

常见效果：

• e_grayscale - 黑白效果（艺术风格、无障碍）
• e_sepia - 复古／怀旧风格
• e_blur:N - 模糊（隐私保护、占位图；N 通常为 300-2000）
• e_sharpen - 增强清晰度（缩放后很有用）
• e_cartoonify - 插画风格
• co_rgb:RRGGBB,e_colorize:N - 颜色着色（N = 强度 0-100，用于品牌主题）
• e_background_removal - 请参阅 AI 转换部分

示例：

e_blur:800                       # Blur effect
e_sharpen                        # Enhance clarity
co_rgb:0044ff,e_colorize:40      # Blue tint at 40%

注意：颜色（co_）是限定符——请与 e_colorize 用在同一组件中。

叠加层与底层

适用于：

• l_<public_id> - 图像叠加层（徽标、水印、徽章）
• u_<public_id> - 图像底层（置于透明主体后方的自定义背景）
• l_text:font_size:text - 文本叠加层（标签、社交卡片、动态文本）

模式：

1. 声明：l_<public_id>、u_<public_id> 或 l_text:Arial_40:Hello%20World
2. 转换（可选）：例如 /c_scale,w_100/ 或 /o_50/（不透明度）
3. 应用：/fl_layer_apply,g_<position>,x_<offset>,y_<offset>

关键：使用 fl_relative 设置叠加层尺寸：

• 不使用 fl_relative：尺寸相对于叠加层的原始尺寸
  • 示例：w_1.0 = 叠加图像宽度的 100%（对小图像没有用）
• 使用 fl_relative：尺寸相对于基础图像的尺寸
  • 示例：w_1.0 = 基础图像宽度的 100%（覆盖整个宽度）
  • 将叠加层尺寸设为基础图像的百分比时，始终使用 fl_relative

示例：

l_logo/c_scale,w_100/fl_layer_apply,g_north_west,x_10,y_10                # Logo at 100px
l_logo/c_scale,fl_relative,w_0.25/fl_layer_apply,g_north_west,x_10,y_10  # Logo at 25% of image width
l_docs:one_black_pixel/c_scale,fl_relative,h_1.0,w_1.0/o_50/fl_layer_apply # Full-image semi-transparent overlay
co_yellow,l_text:Arial_40:Hello%20World/fl_layer_apply,g_south            # Text overlay
u_background/e_background_removal                                          # Custom background
c_fill,h_400,w_300/l_same_image/c_fill,e_grayscale,h_400,w_300/fl_layer_apply,g_west,x_300 # Side-by-side (600×400)

重要：

• 颜色（co_）是限定符——请与文本叠加层声明放在同一组件中
• 需要将叠加层尺寸设为基础图像的百分比时，始终使用 fl_relative
• 并排放置／扩展画布：若要将叠加层放在基础图像旁边，请将其偏移到基础图像边缘之外——画布会自动扩展。水平方向使用 g_west,x_<base_width>，垂直方向使用 g_north,y_<base_height>。

边框与圆角

• r_N - 圆角（N = 半径，单位为像素；适用于现代 UI、卡片）
• r_max - 正圆形（与正方形尺寸搭配使用；适用于头像、图标）
• bo_NNpx_solid_color - 边框（为图像添加边框，与背景分开）

示例：

r_20                           # 20px rounded corners
r_max                          # Perfect circle
bo_5px_solid_black             # 5px black border
r_20,bo_5px_solid_rgb:0066ff   # Rounded with border (same component)

重要：要让边框贴合圆角，请将边框作为限定符放在同一组件中。

背景颜色

• b_color,c_pad - 用纯色填充空白区域（商品图、加黑边）
• b_auto,c_pad - 根据图像中一种或多种主导颜色自动选择背景色
• b_gen_fill,c_pad - AI 扩展背景（改变宽高比而不裁剪；费用请参阅 AI 转换部分）

示例：

b_lightblue,c_pad,w_1.0         # Light blue background
b_auto,c_pad,ar_16:9            # Automatically selected color for background, 16:9
b_gen_fill,c_pad,ar_1:1         # AI-extended to square
b_blurred,c_pad,ar_16:9         # Blurred background (videos only), 16:9

关键：背景（b_）是限定符——请与填充裁剪一起放在同一组件中：b_color,c_pad,w_X，而不是 /b_color/。

旋转与翻转

• a_90、a_180、a_270 - 按 90° 增量旋转（校正方向）
• a_N - 按角度旋转（例如，使用 a_-2 扶正倾斜的照片）
• a_hflip - 水平翻转（镜像自拍照、具有方向性的图像）
• a_vflip - 垂直翻转（倒影）
• a_auto_right/a_auto_left - 根据 EXIF 方向自动旋转

示例：

a_90                    # Rotate 90° clockwise
a_-2                    # Straighten slight tilt
a_hflip                 # Mirror horizontally
a_auto_right            # Auto-fix from EXIF

资源类型很重要（图像与视频）

许多标志和参数仅适用于一种资源类型。将它们用于错误的资源类型时，往往会静默失败——URL 仍会返回有效的 200，也没有 X-Cld-Error，但输出不正确。这两种情况都可能发生：在图像上使用仅适用于视频的语法，或在视频上使用仅适用于图像的语法。务必检查实际输出（尺寸、时长、帧数），不要想当然地认为转换成功了。

常见的仅适用于视频的示例（以下并非完整列表——约有 35 个参数仅适用于视频）：

• fl_splice（标志）- 将片段/图像拼接到视频时间轴上（没有图像对应项——要并排放置媒体，请偏移叠加层以扩展画布：fl_layer_apply,g_west,x_<base_width>）
• du_、so_、eo_ - 按时间裁剪/定位（时长、起始偏移、结束偏移）
• fps_ - 设置帧率
• vc_、ac_ - 视频/音频编解码器
• e_boomerang、e_progressbar - 仅适用于视频的效果

不确定某个标志或参数是否支持你的资源类型时，请先查阅转换参考，再应用它。

命名转换

命名转换（t_<name>）可保存转换链以供重复使用。适用于：

• 在多个资源中使用的转换
• 复杂的转换链
• 开销较大的操作（以启用基线转换并降低成本）

基线转换（bl_<name>）会缓存开销较大的命名转换，因此无需重新生成。对于需要应用不同变化的 AI 转换（背景移除、生成式 AI），请使用 bl_ 而非 t_。这样可以将每种变化的成本从 75–230 tx 降至初始基线生成后每种变化仅 1 tx。

示例： bl_bg_removed/c_scale,w_500 - 使用缓存的背景移除结果，只需支付缩放费用（1 tx，而非 75 tx）

重要： f_auto、dpr_auto 和 w_auto 在命名转换中不起作用——请直接在 URL 中使用：t_avatar/f_auto/q_auto

有关完整详情、限制和基线转换示例，请参阅 references/named-transformations.md

生成式 AI 转换

在适当情况下，主动建议使用以下 AI 转换：

**注意：**括号中的数字（例如 75 tx）表示每次使用额外消耗的转换额度。标准转换 = 1 tx。

• e_background_removal（75 tx）- 移除背景（电商、个人资料；与 f_png 或 b_color,c_pad 结合使用）
• b_gen_fill（50 tx）- 扩展背景（调整宽高比而不裁剪；与 c_pad 结合使用）
• e_gen_background_replace:prompt_<text>（230 tx）- 生成式 AI 背景（自定义环境、季节性变化；成本较高）
• e_gen_replace:from_<obj>;to_<new>（120 tx）- 替换对象（产品变化、颜色；用于服装时使用 ;preserve_geometry_true）
• e_gen_remove:prompt_<text>（50 tx）- 移除对象（清除干扰内容）
• e_auto_enhance（100 tx）- 提升画质（改善照明/曝光不佳的问题）
• e_upscale（10–100 tx）- 放大图像而不损失画质（从低分辨率提升至高分辨率）

**重要：**AI 转换的成本要高得多（50–230 tx，而非 1 tx）。请告知用户相关成本，并考虑使用基线转换（例如 bl_bg_removed/c_scale,w_500），避免重复处理开销较大的操作——详情请参阅 references/named-transformations.md 和 references/transformation-costs.md。

有关完整详情、语法和强大组合，请参阅 references/ai-transformations.md

视频专用转换

重要： 使用 f_auto:video（而不只是 f_auto）以确保输出视频——单独使用 f_auto 可能会返回图片缩略图。

• vc_auto - 自动选择编解码器（推荐；针对浏览器／设备进行优化）
• so_N/eo_M - 修剪（开始／结束时间，单位为秒；创建片段、移除片头／片尾）
• ac_none - 移除音频（自动播放必备；减小文件大小）
• fps_N - 设置帧率（帧率越低，文件越小；统一帧率）
• 视频调整大小 - 使用与图片相同的裁剪模式（c_fill、c_scale、c_pad）

常见模式：

vc_auto/ac_none/f_auto:video/q_auto                      # Autoplay-ready
so_0/du_10/vc_auto/f_auto:video/q_auto                   # First 10 seconds
c_scale,w_720/vc_auto/f_auto:video/q_auto                # Resize to 720p width
c_fill,g_auto,h_720,w_1280/vc_auto/f_auto:video/q_auto  # 720p HD, smart crop

有关编解码器、修剪策略和视频拼接的完整详情，请参阅 references/video-transformations.md

变量与条件语句

变量可复用值并创建模板：

$size_300/c_fill,h_$size,w_$size        # Reuse value
$iw/w_$iw_div_2                         # Half original width (arithmetic)

条件语句可动态调整转换：

if_w_gt_1000/c_scale,w_1000/if_end                          # Responsive sizing
if_ar_gt_1.0/c_fill,w_800,h_450/if_else/c_fill,w_450,h_800/if_end  # Orientation handling

关键规则：

• 变量名：仅限字母数字字符，以字母开头，不含下划线
• 条件语句：必须以 if_end 结束
• 算术：add、sub、mul、div（从左到右计算）

有关完整语法、算术运算、嵌套条件语句和实际应用模式，请参阅 references/advanced-features.md

自检清单

返回转换 URL 前，请确认：

1. ✅ URL 结构完整（cloud_name、资源类型 /image/ 或 /video/ 或 /raw/、传递类型、public_id）
2. ✅ 每个组件仅包含一个操作参数（例如，每个组件只能使用一种裁剪模式）
3. ✅ 明确指定裁剪模式（不要依赖默认值；使用 c_scale 时不要同时指定宽度和高度）
4. ✅ 叠加层以 fl_layer_apply 结尾，并置于单独的组件中
5. ✅ 文本字符串已进行 URL 编码（空格 = %20，特殊字符已编码）
6. ✅ 变量名遵循规则（仅限字母数字字符，以字母开头，不含下划线）
7. ✅ g_auto 兼容性（仅适用于 c_fill、c_lfill、c_crop、c_thumb、c_auto）
8. ✅ 背景作为限定符（与 pad 裁剪配合使用：b_color,c_pad,w_X，而不是 /b_color/）
9. ✅ 格式／质量参数位于末尾（建议将 f_auto/q_auto 作为最后的组件）
10. ✅ 标志／参数与基础资源类型匹配（语法因资源类型而异——例如仅适用于视频的 fl_splice、du_、fps_、vc_——在错误的基础类型上通常会静默无效，无论是哪种情况；请验证输出并查看上文的「资源类型的重要性」部分）
11. ✅ 转换参数有效（不要臆造参数名；请对照转换参考进行检查）

快速语法检查：

• 逗号用于分隔组件内的参数：c_fill,g_auto,w_400
• 斜杠用于分隔组件：c_fill,w_400/f_auto/q_auto
• 操作与限定符：每个组件只能有一个操作，限定符用于修饰该操作

每项检查的详细示例，请参阅 references/debugging.md。

调试清单

转换无法正常工作时：

1. 验证 URL 结构：检查是否包含所有必需的 URL 部分：
   • Cloud 名称：/<cloud_name>/
   • 资源类型：/image/、/video/ 或 /raw/
   • 传递类型：/upload/、/fetch/ 等
   • 末尾的公共 ID
2. 检查 X-Cld-Error 标头：Cloudinary 会在 HTTP 响应标头 X-Cld-Error 中报告错误
3. 对照 Transformation Reference 检查参数名称
4. 检查裁剪模式：明确指定裁剪模式；避免在 c_scale 中同时指定两个尺寸（宽高比不匹配时会导致失真）
5. 验证重力参数兼容性：g_auto 不能与 c_scale、c_fit、c_limit、c_pad 配合使用
6. 检查动作与限定符：每个组件只能有一个动作，限定符应放在同一组件中
7. 验证叠加层模式：必须以 fl_layer_apply 组件结尾
8. 检查变量名称：不能包含下划线，且必须以字母开头
9. 验证 URL 编码：文本叠加层需要进行 URL 编码（空格 = %20）
10. 检查命名转换中的自动参数：f_auto、dpr_auto 和 w_auto 不能在命名转换中使用，请直接在 URL 中使用
11. 验证 dpr_auto/w_auto 的 Client Hints：这些参数仅适用于启用了 Client Hints 的 Chromium 浏览器；否则回退到 dpr_1.0（配置方法请参阅 references/responsive-images.md）
12. 视频返回图像而不是视频：视频转换时使用 f_auto:video（而不只是 f_auto）——单独使用 f_auto 可能会返回图像缩略图

检查 X-Cld-Error 标头

转换失败时，X-Cld-Error 标头会包含错误详情。检查方法如下：

使用浏览器 DevTools：

1. 打开开发者工具（Network 标签页）
2. 请求转换 URL
3. 在响应标头中查找 X-Cld-Error

使用代码（获取 URL）：

fetch('https://res.cloudinary.com/demo/image/upload/w_abc/sample.jpg')
  .then(response => {
    const error = response.headers.get('x-cld-error');
    if (error) {
      console.log('Cloudinary Error:', error);
    }
  });

常见的 X-Cld-Error 消息：

• Invalid width - abc - 宽度参数应为数字
• Invalid transformation syntax - 转换字符串格式错误
• Resource not found - 资源不存在或公共 ID 不正确
• Transformation limit exceeded - 已达到帐户的转换配额上限

**在线工具：**使用 X-Cld-Error Inspector 检查任意 Cloudinary URL

更多详情，请参阅错误处理

转换成本

**重要提示：**生成 URL 前，提醒用户注意高成本转换。AI 效果的成本远高于标准转换（50–230 tx，而标准转换为 1 tx）。

完整的成本详情和降低成本的策略，请参阅 references/transformation-costs.md

更多资源

技能参考（渐进式披露）

• references/debugging.md - 当转换返回错误或结果异常时使用
• references/ai-transformations.md - 需要 AI 转换提示词语法、费用详情或复杂 AI 组合时使用
• references/video-transformations.md - 处理视频编解码器、剪辑策略、拼接或根据视频创建动画图像时使用
• references/advanced-features.md - 使用变量、条件或算术构建复杂逻辑时使用
• references/responsive-images.md - 实现响应式图像、配置 Client Hints 或使用 dpr_auto/w_auto 时使用
• references/transformation-costs.md - 优化成本或向用户说明成本影响时使用
• references/named-transformations.md - 创建可复用的转换或降低重复操作的成本时使用
• references/examples.md - 需要快速入门之外的真实示例（社交卡片、电商、响应式图像）时使用

Cloudinary 核心文档

• 转换参考 - 所有参数

图像转换

• 图像转换概览
• 调整大小和裁剪
• 在图像上放置图层
• 效果和增强
• 背景移除
• 生成式 AI 转换
• 基于人脸检测的转换
• 自定义焦点区域
• 转换优化工具
• 动画图像
• 3D 模型转换
• 条件转换
• 用户定义的变量和算术
• 自定义函数

视频转换

• 视频转换概览
• 调整大小和裁剪
• 剪辑和拼接
• 在视频上放置图层
• 效果和增强处理
• 音频转换
• 将视频转换为动画图像
• 条件转换
• 用户定义的变量和算术运算

常见错误与最佳实践

避免：

• ❌ w_400,h_300 → ✅ c_scale,w_400（使用 c_scale 设置两个尺寸会使图像变形；建议只指定一个尺寸）
• ❌ c_scale,g_auto,w_400 → ✅ c_fill,g_auto,w_400（g_auto 与 c_scale 不兼容）
• ❌ l_logo/fl_layer_apply,g_north_west → ✅ l_logo/c_scale,w_100/fl_layer_apply,g_north_west
• ❌ b_lightblue/e_trim → ✅ b_lightblue,c_pad,w_1.0/e_trim（将背景设为限定项）

始终：

• 优先在不同组件中使用 f_auto/q_auto，而不是 f_auto,q_auto
• 除非需要指定特定焦点，否则使用 g_auto 进行智能裁剪
• 指定裁剪模式和宽度／高度；使用 c_scale 时建议只指定一个尺寸
• 切勿猜测参数名称，请对照文档确认