Claude Skill

material-enhancement

材质质感增强与纹理重建。糊掉的图 + 高清商品图 → 纹理清晰可信的图。当用户说「增强质感」「图糊了」「补纹理」「提清晰度」时使用。

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Virus-scanned Reviewed automatically before listing.

Full trust report

Download dlazy-ai-ecommerce-skills-skills_material-enhancement-c022f20.zip · 23 KB
Part of dlazy-ai/ecommerce-skills — 26 skills

Install

skills CLI npx skills add https://github.com/dlazy-ai/ecommerce-skills/tree/main/skills/material-enhancement
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install dlazy-ai-ecommerce-skills@llmmart
Git git clone https://github.com/dlazy-ai/ecommerce-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole dlazy-ai/ecommerce-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

material-enhancement — 优化服装材质和细节质感

把一张面料糊掉的商拍图修成面料清晰真实的图,构图和人一动不动。

这是一个后处理技能:AI 生成的服装图最容易崩的就是面料——远看还行,放大一看针织变成一片糊。给它一张真实的高清商品图当参照,把表面重建回来。


生成效果示例

输入:原图(待增强) 输入:高清商品图(真实面料)
source-image.jpg — 军绿麻花毛衣上身图,1024×1536 hires-product.jpg — 同款毛衣高清平铺图,800×800

实际执行的命令:

dlazy gpt-image-2 \
  --prompt 'Texture enhancement pass. Image 1 is the on-model photo to improve. Image 2 is the high-resolution product photo that defines the true fabric. Rebuild the sweater surface in image 1 using the real texture from image 2: crisp cable-braid relief, visible knit loops and yarn twist, natural wool loft, correct fold shadows and a matte fibre sheen. Do not change anything else — the model face, hair, hands, pose, brown trousers, background, framing and colour grading must stay identical to image 1. The garment silhouette and colour must not shift; only the material fidelity and micro-detail improve. Photorealistic, sharp, no text, no watermark.' \
  --images docs/material-enhancement/source-image.jpg docs/material-enhancement/hires-product.jpg \
  --size 1024x1536 --quality high --imageFormat jpeg \
  --save docs/material-enhancement/example-output.jpg

输出

example-output.jpg — 1024×1536,60 credits。麻花辫的立体起伏、菱形提花的凹凸、羊毛的绒毛感与褶皱处的暗部层次被重建;模特五官、发型、手部、姿势、棕色长裤、灰墙背景与整体色调保持不变,毛衣轮廓与军绿色未偏移。


1、能力边界

输入 作用
原图 要改善的商拍图,决定构图、模特、姿势、背景与色调
高清商品图 提供真实面料信息(织法、纹理、绒感、光泽)
服装类型 帮助判断哪些表面特征该被强化
只改 不改
面料表面纹理、微观细节、褶皱阴影层次、纤维光泽 构图、模特(脸/发/手/姿势)、其他服饰、背景、色调、服装轮廓与颜色

不做:不改服装轮廓与颜色;不改模特与背景;不把一种面料换成另一种(换面料请用 fabric-on-body)。


2、输入素材规则

生成前先自检这几条硬性约束:

  • 大小:20KB ~ 15MB
  • 分辨率:大于 400×400
  • 格式:jpg / jpeg / png / webp

原图(✅):构图与人物都满意、只有面料不行的图。

高清商品图(✅):同一件商品的高分辨率平铺图或特写,能看清织法。

注意事项

情况 说明
⚠️ 两张图必须是同一件商品 面料不同的两张图会导致材质张冠李戴
⚠️ 原图颜色如果已经偏了 本技能只管纹理,颜色偏差要在生成阶段解决
❌ 原图崩坏严重(版型错、结构乱) 材质增强救不了结构问题,重跑生成
❌ 原图分辨率极低 没有足够信息定位纹理该长在哪

3、材质增强的两条铁律

铁律一:只改表面,别的一个像素都别动。

Do not change anything else — the model face, hair, hands, pose, other garments,
background, framing and colour grading must stay identical to image 1.
The garment silhouette and colour must not shift; only material fidelity
and micro-detail improve.

铁律二:把「好质感」翻译成具体的表面特征,否则模型只会整体加锐化。

面料 要重建的具体特征
粗针织 crisp cable-braid relief, visible knit loops and yarn twist, natural wool loft, matte fibre sheen
精纺羊毛 fine even weave, subtle fibre halo, soft directional sheen
缎面 smooth continuous specular gradients along the folds, no texture noise
灯芯绒 parallel wale ridges with correct pitch, matte pile catching light on the ridge tops
牛仔 diagonal twill lines, slub irregularity, whiskering at stress folds
皮革 grain pores, broad soft creases, low-frequency specular sheen
摇粒绒/绒毛 dense short pile, fuzzy silhouette edge, light scattering rather than specular

再加一条褶皱层次:correct fold shadows with proper ambient occlusion in the creases——这是「看起来有厚度」的来源。


4、工具调用

本技能使用 dLazy 的 gpt-image-2(图像编辑模型 + --quality high;材质增强要求「几何与色彩零变化、表面高频信息重建」,是典型的双图参考定向修复)。

调用方式

两种等价写法,选一种。统一入口会自动选后端、失败重试、建目录落盘、估算成本:

# A. 统一入口(推荐):可切任意后端,加 --dry-run 不计费空跑
node scripts/gen.mjs --task material-enhancement \
  --prompt '<见下方 Prompt 模板>' \
  --images <按下表顺序> \
  --save output/material-enhancement-<sku>.jpg

# B. 直接用 dLazy CLI(不想引入 Node 依赖时,效果等价)
dlazy gpt-image-2 --prompt '...' --images ... --save output/material-enhancement.jpg

参数约定(本技能固定用法)

参数 取值 理由
--images [原图, 高清商品图] 顺序即 prompt 中的 image 1 / 2
--size 与原图比例一致 增强不该改构图
--quality high(必须) 本技能的产出就是高频细节
--imageFormat jpeg 通用格式
--batch 2 纹理重建有随机性
--save docs/material-enhancement/output-<sku>-enhanced.jpg 与原图分开归档便于对比

Command Examples

# basic call
dlazy gpt-image-2 \
  --prompt 'Texture enhancement pass. Image 1 is the on-model photo to improve. Image 2 is the high-resolution product photo defining the true fabric. Rebuild the garment surface in image 1 using the real texture from image 2: crisp knit relief, visible loops and yarn twist, natural loft, correct fold shadows. Do not change anything else — model, pose, background, framing and colour grading stay identical to image 1. Only material fidelity improves.' \
  --images docs/material-enhancement/source-image.jpg docs/material-enhancement/hires-product.jpg \
  --size 1024x1536 --quality high

# complex call: 批量给一组生成图做材质后处理
HIRES=docs/material-enhancement/hires-product.jpg
LOCK='Do not change anything else — the model face, hair, hands, pose, other garments, background, framing and colour grading must stay identical to image 1. The garment silhouette and colour must not shift; only material fidelity and micro-detail improve. Photorealistic, sharp, no text, no watermark.'
FEAT='crisp cable-braid relief, visible knit loops and yarn twist, natural wool loft, matte fibre sheen, correct fold shadows with proper ambient occlusion in the creases'
for f in docs/material-enhancement/raw/*.jpg; do
  dlazy gpt-image-2 \
    --prompt "Texture enhancement pass. Image 1 is the on-model photo to improve. Image 2 is the high-resolution product photo that defines the true fabric. Rebuild the garment surface in image 1 using the real texture from image 2: $FEAT. $LOCK" \
    --images "$f" "$HIRES" \
    --size 1024x1536 --quality high --imageFormat jpeg \
    --save "docs/material-enhancement/enhanced/$(basename $f)"
done

# 先估价不真跑
dlazy gpt-image-2 --dry-run --prompt '...' --images a.jpg b.jpg --size 1024x1536 --quality high

延伸阅读

要查什么 去哪
认证、多后端配置、输出结构、错误码 references/provider-cli.md
gpt-image-2 的全部可用参数 references/model-flags.md
统一入口的全部选项 node scripts/gen.mjs --help

5、Prompt 模板

Texture enhancement pass.
Image 1 is the on-model photo to improve.
Image 2 is the high-resolution product photo that defines the true fabric.

Rebuild the [服装部位] surface in image 1 using the real texture from image 2:
[第三节表格里对应面料的具体特征],
correct fold shadows with proper ambient occlusion in the creases.

Do not change anything else — the model face, hair, hands, pose, other garments,
background, framing and colour grading must stay identical to image 1.
The garment silhouette and colour must not shift; only material fidelity
and micro-detail improve.

Photorealistic, sharp, no text, no watermark.

按问题追加的修正句

问题 追加到 prompt 末尾
只是整体变锐利了 This is not sharpening: reconstruct the actual [织法单位] structure, loop by loop, matching image 2.
人脸/背景也变了 Only pixels inside the garment region may change. Everything outside it must be identical to image 1.
颜色被改了 Preserve the exact garment colour from image 1; do not shift hue, saturation or brightness.
纹理密度不对 Match the texture scale to the garment size in image 1: about [N] knit loops per [尺寸].
褶皱变平 Deepen the crease shadows with ambient occlusion; the garment must read as [厚度描述] fabric.

6、执行流程

  1. 确认两张图是同一件商品——这是最容易犯的错。
  2. 判断原图值不值得救:结构崩坏的重跑生成,只有面料糊的才用本技能。
  3. 写面料特征:查第三节表格,用具体特征替代「质感更好」。
  4. 写两条铁律:只改表面 + 别的不许动。
  5. --quality high(必须) → --batch 2 挑图,落盘到 docs/material-enhancement/。
  6. 并排对比原图与输出:面料是否真的重建了(不是加锐化)、脸和背景是否没动、颜色是否没偏。

7、常见问题

现象 原因 处理
只是变锐利了 未要求重建结构 追加「这不是锐化」句,要求逐个线圈重建
人脸/背景也被改 未锁定区域 追加只允许服装区域变化句
颜色偏了 模型顺手调色 追加保色句
纹理密度不对(线圈太大/太小) 未给尺度参照 追加纹理尺度句
褶皱变平、没厚度 缺 AO 描述 追加加深褶皱暗部句
结构崩坏没被修好 超出能力 本技能只管表面,结构问题回到生成环节重跑

Tips

Visit https://dlazy.com for more information.

Files (ecommerce-skills)
  • examples
    • brand.yaml 1.6 KB
      # ⚠️ 由 scripts/build-skills.mjs 从 shared/examples/brand.yaml 同步生成,不要直接改这里。
      # 店铺品牌视觉规范 —— 所有生图技能读这一份,保证几百个 SKU 看起来像同一家店。
      #   node scripts/brand.mjs --brand brand.yaml --for flat-lay
      #   node scripts/gen.mjs --task flat-lay --brand brand.yaml --prompt '...'
      
      brand:
        name: 示例品牌
        # 一句话概括调性,会原样进 prompt
        tone: quiet minimalist, warm and lived-in, never glossy or commercial
      
      model:
        # 锁模特:给一张脸的参考图,所有技能都会把它作为最后一张参考图传入
        reference: assets/model/face-a.jpg
        description: East Asian woman, late twenties, natural makeup, shoulder-length black hair
        body: slim, height around 168cm
      
      photography:
        background: seamless off-white studio backdrop, RGB 248 248 246
        lighting: soft large softbox from camera left, gentle fill, no hard shadows
        camera: 85mm equivalent, eye level, shallow depth of field
        grade: neutral white balance around 5200K, low contrast, slightly lifted blacks
        crop: full body with headroom, product centered
      
      layout:
        # 给带排版的技能(主图 / 详情页)用
        margin: at least 8% empty margin on all sides
        typeface: clean sans-serif, no decorative fonts
        text_color: near-black on light background
      
      forbid:
        - no visible brand logos other than the product's own
        - no text or watermark
        - no exaggerated poses or dramatic wind effects
        - no oversaturated colors
      
      # 可选:把这些直接写进合规目标,生成时就按平台要求出图
      compliance:
        platform: amazon
      
  • references
    • model-flags.md 2.1 KB
      # `gpt-image-2` 参数清单
      
      本技能默认用的模型的完整参数。日常只需要「参数约定」里那几个,
      这份清单在需要用到非常规参数时再看。
      
      **CRITICAL INSTRUCTION FOR AGENT**:
      Run the `dlazy gpt-image-2` command to get results.
      
      ```bash
      dlazy gpt-image-2 -h
      
      Options:
        --prompt <prompt>            Prompt
        --images [images...]         Images [image: url or local path] (max 5)
        --size <size>                Size [default: auto] (choices: "1024x1024",
                                     "1536x1024", "1024x1536", "2048x2048",
                                     "2048x1152", "3840x2160", "2160x3840", "auto")
        --imageFormat <imageFormat>  Image Format [default: jpeg] (choices: "jpeg",
                                     "png", "webp")
        --quality <quality>          Quality [default: medium] (choices: "low",
                                     "medium", "high")
        --dry-run                    Print payload without executing the tool
        --no-wait                    Return generateId immediately for async tasks
        --timeout <seconds>          Max seconds to wait for async completion
                                     (default: "1800")
        --input <jsonOrFile>         Inline JSON or @path/to/file.json — merged under
                                     flag values (flags win)
        --save <path>                Download the result asset to this local path
                                     (mkdir + retry handled for you). A destination
                                     path — NOT a response format; for stdout shape
                                     use --format
        --batch <n>                  Fan-out N parallel runs (cloud tools only)
                                     (default: "1")
        -h, --help                   display help for command
      ```
      
      > Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.
      
      ---
      
      换其他后端时参数由 `scripts/gen.mjs` 统一翻译,见 [`provider-cli.md`](provider-cli.md)。
      
    • provider-cli.md 4.7 KB
      <!-- 由 scripts/build-skills.mjs 从 shared/references/provider-cli.md 同步生成,不要直接改这里。 -->
      # 后端调用参考
      
      技能正文只写「要生成什么」。认证、计费、错误码、输出结构这些每个技能都一样的东西放在这里,
      **用到时再读**,不占技能的常驻上下文。
      
      ---
      
      ## 一、认证
      
      ### 默认后端 dLazy
      
      ```bash
      dlazy login            # 设备码流程,远程 shell 也能用,自动写入本地配置
      dlazy auth set <KEY>   # 已有 key 时直接写入
      ```
      
      key 存在用户配置目录(macOS/Linux `~/.dlazy/config.json`,Windows `%USERPROFILE%\.dlazy\config.json`),
      权限限本机用户。也可以每次调用用环境变量 `DLAZY_API_KEY` 传入。
      
      手动获取:登录 [dlazy.com](https://dlazy.com) → [API Key 页面](https://dlazy.com/dashboard/organization/api-key)。
      key 按组织隔离,可随时轮换或吊销。
      
      ### 其他后端
      
      本技能库不锁定单一厂商。配好任意一家的 key 即可跑:
      
      | 后端 | 环境变量 | 说明 |
      | --- | --- | --- |
      | `dlazy` | `dlazy login` 或 `DLAZY_API_KEY` | 默认,最省事 |
      | `openai` | `OPENAI_API_KEY` | 走 `/v1/images/edits` 与 `/v1/images/generations` |
      | `gemini` | `GEMINI_API_KEY` | Nano Banana 系列 |
      | `fal` | `FAL_KEY` | |
      | `replicate` | `REPLICATE_API_TOKEN` | |
      | `ark` | `ARK_API_KEY` + `ARK_MODEL` | 火山方舟,模型 ID 需按开通情况填 |
      
      选路优先级:`--provider` 参数 > `PROVIDER` 环境变量 > 第一个配了 key 的 > `dlazy`。
      
      ```bash
      node scripts/gen.mjs --doctor     # 看当前哪个后端可用
      ```
      
      各后端的模型 ID 可用 `GEN_MODEL_OPENAI` / `GEN_MODEL_GEMINI` / `GEN_MODEL_FAL` /
      `GEN_MODEL_REPLICATE` / `GEN_MODEL_ARK` 覆盖。**厂商目录会变,以各家最新文档为准。**
      
      ---
      
      ## 二、两种调用方式
      
      ### 方式 A:统一入口(推荐)
      
      ```bash
      node scripts/gen.mjs --task <技能名> --prompt '...' --images a.jpg b.jpg --save out.jpg
      ```
      
      它负责:后端选路、默认尺寸档位、失败重试(429/5xx 指数退避)、落盘建目录、成本估算。
      
      ```bash
      node scripts/gen.mjs --task flat-lay --prompt '...' --dry-run   # 不调用不计费,只看要发什么
      node scripts/gen.mjs --help
      ```
      
      ### 方式 B:直接用 dLazy CLI
      
      不想引入 Node 依赖时,技能正文里的 `dlazy ...` 命令可以原样执行,效果等价。
      
      ```bash
      npx @dlazy/cli@1.2.3 <command>     # 不装全局二进制
      ```
      
      - CLI 源码:[github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli) · npm 包 `@dlazy/cli`
      
      ---
      
      ## 三、数据流向
      
      调用 dLazy 时:提示词与参数发往 `api.dlazy.com`;传入的本地图片会上传到 `files.dlazy.com`
      供模型读取;产出 URL 同样托管在 `files.dlazy.com`。这是云端生成 API 的通用形态。
      换成其他后端时,数据流向对应厂商,不经过 dLazy。
      
      ---
      
      ## 四、输出结构
      
      `gen.mjs`(加 `--json`):
      
      ```json
      {
        "ok": true,
        "task": "flat-lay",
        "provider": "dlazy",
        "model": "gpt-image-2",
        "files": ["docs/flat-lay/output-sku001.jpg"],
        "texts": [],
        "estimatedCredits": 60,
        "elapsedMs": 58213
      }
      ```
      
      dLazy CLI 原生:
      
      ```json
      {
        "ok": true,
        "result": {
          "tool": "gpt-image-2",
          "data": { "urls": ["https://files.dlazy.com/data/ai/....jpg"] },
          "savedPath": "docs/flat-lay/example-output.jpg"
        }
      }
      ```
      
      加 `--no-wait` 的异步任务不返回 `data`,返回 `task: { generateId, status }`,
      用 `dlazy status <generateId> --wait` 轮询。
      
      文本类模型(如质检)产出在 `result.data.texts[0]`:
      
      ```bash
      dlazy claude-sonnet-5 --prompt '...' --images x.jpg \
        | python3 -c 'import sys,json;print(json.load(sys.stdin)["result"]["data"]["texts"][0])'
      ```
      
      ---
      
      ## 五、错误处理
      
      | Code | 类型 | 示例 |
      | --- | --- | --- |
      | 401 | 未授权 / 无 key | `ok: false, code: "unauthorized"` |
      | 501 | 缺必填参数 | `error: required option '--prompt <prompt>' not specified` |
      | 502 | 本地文件读不到 | `Error: Image file not found: ...` |
      | 503 | 余额不足 | `ok: false, code: "insufficient_balance"` |
      | 503 | 服务端错误 | `HTTP status code error (500)` |
      | 504 | 异步任务失败 | `=== Generation Failed ===` / `Prompt violates safety policy` |
      
      **给 Agent 的硬性要求**
      
      1. 命中 `insufficient_balance` → 明确告诉用户算力不足,并给出充值入口
         <https://dlazy.com/dashboard/organization/settings?tab=credits>
      2. 命中 `unauthorized` / 缺 key → 告诉用户去 <https://dlazy.com/dashboard/organization/api-key>
         取 key,用 `dlazy auth set <key>` 存好再继续。
      3. 用 `gen.mjs` 时,429 与 5xx 已自动重试;仍失败才向用户报错。
      4. **不要**为了「跑通」而偷偷降级参数(尺寸、档位、批量),先问用户。
      
  • scripts
    • lib
      • miniyaml.mjs 2.8 KB · in bundle
      • providers.mjs 11.9 KB · in bundle
      • tasks.json 3.1 KB
        {
          "_note": "技能 → 默认模型与参数。dlazy 列为默认后端的模型名;其他后端走 providers.mjs 的通用映射,可用 GEN_MODEL_<PROVIDER> 覆盖。",
          "_credits": { "gpt-image-2": 60, "seedream-5.0": 30, "seedream-5.0-pro": 45, "banana-pro": 25, "claude-sonnet-5": 3 },
          "tasks": {
            "flat-lay":                { "model": "gpt-image-2",      "size": "1024x1536", "quality": "high",   "format": "jpeg" },
            "wear-everything":         { "model": "gpt-image-2",      "size": "1024x1536", "quality": "medium", "format": "jpeg" },
            "image-fusion":            { "model": "seedream-5.0",     "size": "3:4",       "resolution": "2k" },
            "one-shot":                { "model": "gpt-image-2",      "size": "1024x1536", "quality": "medium", "format": "jpeg" },
            "fission-pattern":         { "model": "gpt-image-2",      "size": "1024x1536", "quality": "medium", "format": "jpeg" },
            "item-detail":             { "model": "seedream-5.0-pro", "size": "3:4",       "resolution": "2k" },
            "creative-scene":          { "model": "banana-pro",       "size": "1024x1536", "format": "jpeg" },
            "batch-image":             { "model": "seedream-5.0",     "size": "3:4",       "resolution": "2k" },
            "to-3d":                   { "model": "gpt-image-2",      "size": "1024x1024", "quality": "high",   "format": "jpeg" },
            "clothing-extraction":     { "model": "gpt-image-2",      "size": "1024x1024", "quality": "high",   "format": "jpeg" },
            "fabric-on-body":          { "model": "gpt-image-2",      "size": "1024x1536", "quality": "high",   "format": "jpeg" },
            "clothing-detail":         { "model": "gpt-image-2",      "size": "1024x1024", "quality": "high",   "format": "jpeg" },
            "clothing-grass-planting": { "model": "gpt-image-2",      "size": "1024x1536", "quality": "medium", "format": "jpeg" },
            "item-selling-point":      { "model": "seedream-5.0-pro", "size": "1:1",       "resolution": "2k" },
            "item-change-background":  { "model": "gpt-image-2",      "size": "1024x1024", "quality": "high",   "format": "jpeg" },
            "remove-watermark":        { "model": "gpt-image-2",      "size": "1024x1024", "quality": "high",   "format": "jpeg" },
            "material-enhancement":    { "model": "gpt-image-2",      "size": "1024x1024", "quality": "high",   "format": "jpeg" },
            "item-repair":             { "model": "gpt-image-2",      "size": "1024x1024", "quality": "high",   "format": "jpeg" },
            "detect-task":             { "model": "claude-sonnet-5",  "text": true },
            "listing-optimizer":       { "model": "gpt-image-2",      "size": "1024x1024", "quality": "high",   "format": "jpeg" },
            "cross-border-localize":   { "model": "seedream-5.0-pro", "size": "1:1",       "resolution": "2k" },
            "brand-kit":               { "model": "gpt-image-2",      "size": "1024x1536", "quality": "high",   "format": "jpeg" },
            "platform-compliance":     { "model": "claude-sonnet-5",  "text": true },
            "main-image-video":        { "model": "$DLAZY_VIDEO_MODEL", "video": true },
            "product-video-ad":        { "model": "$DLAZY_VIDEO_MODEL", "video": true },
            "ugc-testimonial":         { "model": "$DLAZY_VIDEO_MODEL", "video": true }
          }
        }
        
    • brand.mjs 4.4 KB · in bundle
    • gen.mjs 9.3 KB · in bundle
  • skill.md 11 KB
    ---
    name: material-enhancement
    description: 材质质感增强与纹理重建。糊掉的图 + 高清商品图 → 纹理清晰可信的图。当用户说「增强质感」「图糊了」「补纹理」「提清晰度」时使用。
    ---
    
    # material-enhancement — 优化服装材质和细节质感
    
    把一张**面料糊掉的商拍图**修成**面料清晰真实**的图,构图和人一动不动。
    
    这是一个**后处理技能**:AI 生成的服装图最容易崩的就是面料——远看还行,放大一看针织变成一片糊。给它一张真实的高清商品图当参照,把表面重建回来。
    
    ---
    
    ## 生成效果示例
    
    | 输入:原图(待增强) | 输入:高清商品图(真实面料) |
    | --- | --- |
    | <img src="../../docs/material-enhancement/source-image.jpg" width="240"> | <img src="../../docs/material-enhancement/hires-product.jpg" width="240"> |
    | `source-image.jpg` — 军绿麻花毛衣上身图,1024×1536 | `hires-product.jpg` — 同款毛衣高清平铺图,800×800 |
    
    实际执行的命令:
    
    ```bash
    dlazy gpt-image-2 \
      --prompt 'Texture enhancement pass. Image 1 is the on-model photo to improve. Image 2 is the high-resolution product photo that defines the true fabric. Rebuild the sweater surface in image 1 using the real texture from image 2: crisp cable-braid relief, visible knit loops and yarn twist, natural wool loft, correct fold shadows and a matte fibre sheen. Do not change anything else — the model face, hair, hands, pose, brown trousers, background, framing and colour grading must stay identical to image 1. The garment silhouette and colour must not shift; only the material fidelity and micro-detail improve. Photorealistic, sharp, no text, no watermark.' \
      --images docs/material-enhancement/source-image.jpg docs/material-enhancement/hires-product.jpg \
      --size 1024x1536 --quality high --imageFormat jpeg \
      --save docs/material-enhancement/example-output.jpg
    ```
    
    **输出**
    
    <img src="../../docs/material-enhancement/example-output.jpg" width="320">
    
    `example-output.jpg` — 1024×1536,60 credits。麻花辫的立体起伏、菱形提花的凹凸、羊毛的绒毛感与褶皱处的暗部层次被重建;模特五官、发型、手部、姿势、棕色长裤、灰墙背景与整体色调保持不变,毛衣轮廓与军绿色未偏移。
    
    ---
    
    ## 1、能力边界
    
    | 输入 | 作用 |
    | --- | --- |
    | 原图 | 要改善的商拍图,决定构图、模特、姿势、背景与色调 |
    | 高清商品图 | 提供真实面料信息(织法、纹理、绒感、光泽) |
    | 服装类型 | 帮助判断哪些表面特征该被强化 |
    
    | 只改 | 不改 |
    | --- | --- |
    | 面料表面纹理、微观细节、褶皱阴影层次、纤维光泽 | 构图、模特(脸/发/手/姿势)、其他服饰、背景、色调、服装轮廓与颜色 |
    
    **不做**:不改服装轮廓与颜色;不改模特与背景;不把一种面料换成另一种(换面料请用 [fabric-on-body](../fabric-on-body/skill.md))。
    
    ---
    
    ## 2、输入素材规则
    
    生成前先自检这几条硬性约束:
    
    - 大小:**20KB ~ 15MB**
    - 分辨率:**大于 400×400**
    - 格式:**jpg / jpeg / png / webp**
    
    **原图(✅)**:构图与人物都满意、只有面料不行的图。
    
    **高清商品图(✅)**:同一件商品的高分辨率平铺图或特写,能看清织法。
    
    **注意事项**
    
    | 情况 | 说明 |
    | --- | --- |
    | ⚠️ 两张图必须是同一件商品 | 面料不同的两张图会导致材质张冠李戴 |
    | ⚠️ 原图颜色如果已经偏了 | 本技能只管纹理,颜色偏差要在生成阶段解决 |
    | ❌ 原图崩坏严重(版型错、结构乱) | 材质增强救不了结构问题,重跑生成 |
    | ❌ 原图分辨率极低 | 没有足够信息定位纹理该长在哪 |
    
    ---
    
    ## 3、材质增强的两条铁律
    
    **铁律一:只改表面,别的一个像素都别动。**
    
    ```text
    Do not change anything else — the model face, hair, hands, pose, other garments,
    background, framing and colour grading must stay identical to image 1.
    The garment silhouette and colour must not shift; only material fidelity
    and micro-detail improve.
    ```
    
    **铁律二:把「好质感」翻译成具体的表面特征**,否则模型只会整体加锐化。
    
    | 面料 | 要重建的具体特征 |
    | --- | --- |
    | 粗针织 | `crisp cable-braid relief, visible knit loops and yarn twist, natural wool loft, matte fibre sheen` |
    | 精纺羊毛 | `fine even weave, subtle fibre halo, soft directional sheen` |
    | 缎面 | `smooth continuous specular gradients along the folds, no texture noise` |
    | 灯芯绒 | `parallel wale ridges with correct pitch, matte pile catching light on the ridge tops` |
    | 牛仔 | `diagonal twill lines, slub irregularity, whiskering at stress folds` |
    | 皮革 | `grain pores, broad soft creases, low-frequency specular sheen` |
    | 摇粒绒/绒毛 | `dense short pile, fuzzy silhouette edge, light scattering rather than specular` |
    
    再加一条**褶皱层次**:`correct fold shadows with proper ambient occlusion in the creases`——这是「看起来有厚度」的来源。
    
    ---
    
    ## 4、工具调用
    
    本技能使用 dLazy 的 **`gpt-image-2`**(图像编辑模型 + `--quality high`;材质增强要求「几何与色彩零变化、表面高频信息重建」,是典型的双图参考定向修复)。
    
    ### 调用方式
    
    两种等价写法,选一种。统一入口会自动选后端、失败重试、建目录落盘、估算成本:
    
    ```bash
    # A. 统一入口(推荐):可切任意后端,加 --dry-run 不计费空跑
    node scripts/gen.mjs --task material-enhancement \
      --prompt '<见下方 Prompt 模板>' \
      --images <按下表顺序> \
      --save output/material-enhancement-<sku>.jpg
    
    # B. 直接用 dLazy CLI(不想引入 Node 依赖时,效果等价)
    dlazy gpt-image-2 --prompt '...' --images ... --save output/material-enhancement.jpg
    ```
    
    **参数约定(本技能固定用法)**
    
    | 参数 | 取值 | 理由 |
    | --- | --- | --- |
    | `--images` | `[原图, 高清商品图]` | 顺序即 prompt 中的 image 1 / 2 |
    | `--size` | 与原图比例一致 | 增强不该改构图 |
    | `--quality` | `high`(**必须**) | 本技能的产出就是高频细节 |
    | `--imageFormat` | `jpeg` | 通用格式 |
    | `--batch` | `2` | 纹理重建有随机性 |
    | `--save` | `docs/material-enhancement/output-<sku>-enhanced.jpg` | 与原图分开归档便于对比 |
    
    ### Command Examples
    
    ```bash
    # basic call
    dlazy gpt-image-2 \
      --prompt 'Texture enhancement pass. Image 1 is the on-model photo to improve. Image 2 is the high-resolution product photo defining the true fabric. Rebuild the garment surface in image 1 using the real texture from image 2: crisp knit relief, visible loops and yarn twist, natural loft, correct fold shadows. Do not change anything else — model, pose, background, framing and colour grading stay identical to image 1. Only material fidelity improves.' \
      --images docs/material-enhancement/source-image.jpg docs/material-enhancement/hires-product.jpg \
      --size 1024x1536 --quality high
    
    # complex call: 批量给一组生成图做材质后处理
    HIRES=docs/material-enhancement/hires-product.jpg
    LOCK='Do not change anything else — the model face, hair, hands, pose, other garments, background, framing and colour grading must stay identical to image 1. The garment silhouette and colour must not shift; only material fidelity and micro-detail improve. Photorealistic, sharp, no text, no watermark.'
    FEAT='crisp cable-braid relief, visible knit loops and yarn twist, natural wool loft, matte fibre sheen, correct fold shadows with proper ambient occlusion in the creases'
    for f in docs/material-enhancement/raw/*.jpg; do
      dlazy gpt-image-2 \
        --prompt "Texture enhancement pass. Image 1 is the on-model photo to improve. Image 2 is the high-resolution product photo that defines the true fabric. Rebuild the garment surface in image 1 using the real texture from image 2: $FEAT. $LOCK" \
        --images "$f" "$HIRES" \
        --size 1024x1536 --quality high --imageFormat jpeg \
        --save "docs/material-enhancement/enhanced/$(basename $f)"
    done
    
    # 先估价不真跑
    dlazy gpt-image-2 --dry-run --prompt '...' --images a.jpg b.jpg --size 1024x1536 --quality high
    ```
    
    ### 延伸阅读
    
    | 要查什么 | 去哪 |
    | --- | --- |
    | 认证、多后端配置、输出结构、错误码 | [`references/provider-cli.md`](references/provider-cli.md) |
    | `gpt-image-2` 的全部可用参数 | [`references/model-flags.md`](references/model-flags.md) |
    | 统一入口的全部选项 | `node scripts/gen.mjs --help` |
    
    ## 5、Prompt 模板
    
    ```text
    Texture enhancement pass.
    Image 1 is the on-model photo to improve.
    Image 2 is the high-resolution product photo that defines the true fabric.
    
    Rebuild the [服装部位] surface in image 1 using the real texture from image 2:
    [第三节表格里对应面料的具体特征],
    correct fold shadows with proper ambient occlusion in the creases.
    
    Do not change anything else — the model face, hair, hands, pose, other garments,
    background, framing and colour grading must stay identical to image 1.
    The garment silhouette and colour must not shift; only material fidelity
    and micro-detail improve.
    
    Photorealistic, sharp, no text, no watermark.
    ```
    
    **按问题追加的修正句**
    
    | 问题 | 追加到 prompt 末尾 |
    | --- | --- |
    | 只是整体变锐利了 | `This is not sharpening: reconstruct the actual [织法单位] structure, loop by loop, matching image 2.` |
    | 人脸/背景也变了 | `Only pixels inside the garment region may change. Everything outside it must be identical to image 1.` |
    | 颜色被改了 | `Preserve the exact garment colour from image 1; do not shift hue, saturation or brightness.` |
    | 纹理密度不对 | `Match the texture scale to the garment size in image 1: about [N] knit loops per [尺寸].` |
    | 褶皱变平 | `Deepen the crease shadows with ambient occlusion; the garment must read as [厚度描述] fabric.` |
    
    ---
    
    ## 6、执行流程
    
    1. **确认两张图是同一件商品**——这是最容易犯的错。
    2. **判断原图值不值得救**:结构崩坏的重跑生成,只有面料糊的才用本技能。
    3. **写面料特征**:查第三节表格,用具体特征替代「质感更好」。
    4. **写两条铁律**:只改表面 + 别的不许动。
    5. **`--quality high`(必须)** → `--batch 2` 挑图,落盘到 `docs/material-enhancement/`。
    6. **并排对比原图与输出**:面料是否真的重建了(不是加锐化)、脸和背景是否没动、颜色是否没偏。
    
    ---
    
    ## 7、常见问题
    
    | 现象 | 原因 | 处理 |
    | --- | --- | --- |
    | 只是变锐利了 | 未要求重建结构 | 追加「这不是锐化」句,要求逐个线圈重建 |
    | 人脸/背景也被改 | 未锁定区域 | 追加只允许服装区域变化句 |
    | 颜色偏了 | 模型顺手调色 | 追加保色句 |
    | 纹理密度不对(线圈太大/太小) | 未给尺度参照 | 追加纹理尺度句 |
    | 褶皱变平、没厚度 | 缺 AO 描述 | 追加加深褶皱暗部句 |
    | 结构崩坏没被修好 | 超出能力 | 本技能只管表面,结构问题回到生成环节重跑 |
    
    ---
    
    ## Tips
    
    Visit https://dlazy.com for more information.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.

Related