Popiai-skill/image-creation/minecraft-pixel-art/SKILL.md

name	display-name-zh	summary-cn	summary-en	version	description	tags	tags-cn	allowed-tools	exported-by
minecraft-pixel-art	像素方块画	图片一键转Minecraft像素方块画	Convert images to Minecraft pixel art	0.1.4	将用户提供的图片转换为 Minecraft 像素风格图片（16x16 体素方块风格）。 触发短语（中文）：Minecraft 像素画、MC 像素风格、把图片转成 Minecraft、帮我做 Minecraft 像素画、生成像素方块画、MC 风格图片。 触发短语（英文）：minecraft pixel art、convert to minecraft style、make minecraft version、minecraft block art。 dag_id: 17759317728971100	[Image Pixel-Art Minecraft]	[图片 像素画 我的世界]	hilo_tools_run_dag hilo_tools_query_dag_result hilo_tools_upload_to_cdn	MiniMax-hub

Minecraft 像素画生成

将任意图片转换为 Minecraft 风格的 16x16 体素像素画。

DAG 信息

• dag_id: 17759317728971100

输入参数

固定输入（内置在 DAG 中，用户无需提供）

• Minecraft 像素风格 prompt（16x16 体素方块、MC 方块色板、像素游戏截图风格）

可变输入（用户每次提供）

• ref_image: image — 用户提供的参考图片（本地文件路径或已有 URL），必填

输出资产 (asset_keys)

请求以下 asset_keys：

• minecraft_pixel_art: 最终生成的 Minecraft 像素风格图片（image）

执行流程

STEP 1: 收集用户输入

向用户收集：

• 要转换的图片（本地文件路径）

若用户未提供图片，提示："请提供一张图片，我来帮你转换为 Minecraft 像素风格。"

STEP 2: 上传图片到 CDN

调用 hilo_tools_upload_to_cdn，将用户图片上传并获取 CDN URL：

hilo_tools_upload_to_cdn(file_path=<用户本地图片路径>)
→ 返回：cdn_url

STEP 3: 提交 DAG

调用 hilo_tools_run_dag：

• dag_id: 17759317728971100
• inputs: { "ref_image": "<cdn_url>" }
• asset_keys: ["minecraft_pixel_art"]
• 返回：run_id

重要：inputs 中每个参数都必须传递，可选参数无值时传空字符串 "" 占位。

STEP 4: 轮询结果

调用 hilo_tools_query_dag_result(run_id) 持续轮询：

• 轮询间隔：5–10 秒
• running：继续轮询，可告知用户"正在生成中，请稍候…"
• succeeded：从 asset_outputs 中找 key == "minecraft_pixel_art" 且 status == "finished" 的条目，取其 url
• failed：向用户报告 error_message，建议换一张图片重试

STEP 5: 展示结果

生成成功后：

1. 以 Markdown 图片格式展示结果：![Minecraft Pixel Art](<url>)
2. 提供 CDN URL 供用户下载或分享
3. 提示用户可以继续上传其他图片进行转换

错误处理

• 上传失败：确认本地文件路径是否正确，文件是否存在
• DAG 提交失败：检查 inputs 中 ref_image 是否为有效 URL
• 轮询超时：图片生成通常需要 30–120 秒，建议继续等待后重试轮询
• DAG 执行失败：展示 error_message，建议用户更换图片或调整输入后重试
• 内容审核拦截：asset_outputs 中 status == "sensitive" 时，提示图片内容不符合平台规范