mcpField
I
image-superres-enhance

image-superres-enhance

github.com/meitu创意与媒体36117 次安装9 周前更新
代码仓库

关于 image-superres-enhance

image-superres-enhance 是提升已有图片清晰度并按目标分辨率放大的技能，适用于商品图、文档和一般图片。它根据内容类型选择专用或通用处理接口；按倍数放大则不属于此工具的用途。

主要功能

  1. 01按内容类型选择超分算法
  2. 02处理商品图与扫描文档
  3. 03支持通用图片超分
  4. 04以目标分辨率为处理重点
  5. 05失败时切换通用接口重试

适用场景

  1. 01提升电商商品图清晰度
  2. 02增强扫描件、发票或合同文字
  3. 03将风景或人像照片提升至目标分辨率

安装

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

$npx skills add https://github.com/meitu/meitu-skills --skill image-superres-enhance

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

详细介绍

来自项目 README

Image Superres Enhance

Overview

对已有图片做清晰度提升 / 超分放大，按内容类型自动选最优算法，覆盖通用超分、电商商品图超分、文字文档超分。关键区分："放大到 4K/2K/1080P"（分辨率目标）走本工具；"放大 2/4/8 倍"（倍数放大）走 image-transform。

API Mapping

  • 通用超分：api_v2_image_restoration_async
  • 电商商品图超分：api_v1_dlbeautygoodsimagesr_async
  • 文字文档/扫描件超分：api_v1_dlbeautytextimagesr_async

Dependencies

  • meitu-cli: >=2.0.6
  • 凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 实际执行（见根 CONFIG.md）
  • 环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

路径别名：$VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver
Preflight
  1. meitu --version ≥ 2.0.6
  2. 已用 CONFIG AKSK 跑过 meitu tools update
  3. 当前 AKSK = EXEC，MEITU_OPENAPI_TOOL_TASK_MODE=command
  4. output_dir：openclaw.yaml → ./output/ ｜else → $VISUAL/output/image-superres-enhance/；mkdir -p
Execute

触发信号 / 路由规则

核心维度：Agent 画面识别的内容类型（prompt 信号词）。

场景判定关键词路由
电商商品图商品、产品、SKU、电商、白底商品api_v1_dlbeautygoodsimagesr_async
文字文档文档、文字、图表、扫描件、发票、合同、表格api_v1_dlbeautytextimagesr_async
通用 / 未指定人像、风景、老照片、其他api_v2_image_restoration_async
混合内容--默认走通用或询问
商品图 + 指定分辨率商品图变 4Kapi_v1_dlbeautygoodsimagesr_async（场景专用优于通用）

路由原则：场景专用优于通用；Agent 调用前先识别图片内容生成 prompt，无法判断则 prompt 写"通用图片"走默认。

参数定义

参数类型必填说明
image_urlSTRING是图片地址。缺失 → 提示"请提供需要超清处理的图片"
promptSTRING是Agent 对图片内容的描述，用于内部路由判断（如"电商白底商品图""扫描件文字文档""风景照片"）

所有 API 仅使用 image_url + prompt，无额外参数。

工具调用

meitu image-superres-enhance --image_url <url> --prompt "<content desc>" --json --download-dir {output_dir} --skill_name skill_image-superres-enhance

错误降级

场景处理方式
image_url 缺失提示"请提供需要超清处理的图片"
image_url 不可访问直接返回图片链接无效错误，不重试
prompt 为空或无信号词默认走 api_v2_image_restoration_async
混合内容（文字 + 商品）询问或默认走通用
任一 API 调用失败切换 api_v2_image_restoration_async 重试 1 次 → 仍失败返回错误
内容合规拦截直接返回合规提示，不重试、不降级
商品图 + 指定分辨率优先走商品超分（场景专用优先），分辨率由 API 内部处理
Deliver
  • 使用 Preflight 解析的 output_dir
  • 从 downloaded_files[0].saved_path 读取已下载文件路径
  • mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-superres-enhance.{ext}

Output

  • 格式：image
  • 位置：项目 → ./output/，一次性 → $VISUAL/output/image-superres-enhance/

基线 Task ID

见 references/task-id-baseline.md 中对应行。

评论

支持 Markdown