把照片变成高质量 Minecraft…

当你有一张照片（人物、食物/产品、场景均可），想把它编辑成 Minecraft 截图风格，同时让人物或指定物体保持照片级真实时，用这个技能自动路由并生成单张图。

适用场景

解决思路

1. 读取照片并执行 Step 0 路由器：在三种模式中只选一种，用单行 `MODE: object-only` / `MODE: background-only` / `MODE: object+background` 声明，然后应用 Step 3 对应 prompt block；各模式引擎、调色、质量一致，只改变什么被体素化以及是否浮动 loot tags。
2. 按 object-only 模式定义操作：只体素化手持/主体对象（食物、饮料、产品）及其餐具；人物和背景保持完全照片真实；在每个英雄对象上方浮动 Minecraft loot-tag 标签。
3. 按 background-only 模式定义操作：只把背景/环境体素化为 Minecraft 方块；人物保持照片真实；若存在附带物体，也保持照片真实；不加 loot tags。
4. 按 object+background 模式定义操作：把除人物外的一切体素化（对象和背景）；loot tags 可选。
5. 决策树：如果用户明确要求体素化一切（如 “voxelize everything” / “object and background” / “full voxel world”），选 `MODE: object+background`。
6. 决策树：否则，如果照片有人的脸或身体，且手持/突出对象（食物/产品）是主体，选 `MODE: object-only`，并在对象上浮动 loot tags。
7. 决策树：否则，如果照片有人但没有突出对象（人物在场景中的照片），选 `MODE: background-only`，这是脸在场景照片的默认模式。
8. 决策树：如果没有人，且是纯对象照（一餐、产品、平铺、桌面装备），选 `MODE: object-only`。
9. 决策树：如果没有人，且是风景/无突出对象的场景，选 `MODE: background-only`。
10. 决策树：如果真正模糊（无法判断对象还是场景是重点），问用户一行：`voxelize just the object, just the background, or everything but you?`
11. 路由意图：无突出对象的脸默认 background-only；有突出对象选 object-only；object+background 只在明确要求时使用。
12. 输入：`<source>` 可以是任意照片（路径、URL 或聊天粘贴图像）；适用于对象照、人+物照和宽场景。
13. 空参数菜单：提示用户 “Drop the photo (path, URL, or paste it). I'll auto-pick the mode — object-only (voxelize just the food/product you're featuring, with Minecraft loot tags), background-only (voxelize the scene around you, keep you and anything you're holding real), or object+background (voxelize everything but you). Tell me if you want to force a specific mode.”；不询问 provider，始终 gpt-image-2。
14. 引擎：始终用 `gpt-image-2`，`quality=“high”`，`output_format=“png”`；它是 recipe 需要的强编辑器并让世界变成方块。不要用 `nano-banana-pro`，因为它会 under-voxelizes（即使被告知方块化也保留主体照片真实），世界几乎不变。
15. 超时处理：在 `quality=“high”` 下同步调用常超过约 260s 工具预算并客户端超时；始终用 `background=true` 调用，并轮询 `task_status(task_id)` 直到 `completed`。
16. 工作目录：使用 `<project>/voxel-it/<run-id>/`，每次 run 独立文件夹。
17. Step 1 获取源为 Pika-CDN URL：如果是 HTTPS URL，直接使用。
18. Step 1 本地文件：上传（Step 2）。HEIC 转换用 `sips -s format jpeg in.HEIC --out out.jpg`；这会剥离 EXIF 方向标志，JPEG 可能侧翻；查看它；仅当侧翻时用 `sips -r 90` 或 `sips -r 270`（哪个方向正确用哪个）旋转正，再查看确认；上传前必须竖直，因为模型按参考像素原样烘焙。
19. Step 1 聊天粘贴图像：不保证在磁盘。如果用户命名文件（例如 macOS Desktop 截图，AM/PM 前有窄不换行空格 U+202F，用 glob 匹配），复制它。
20. Step 1 否则从会话 transcript 提取：进入 `~/.claude/projects/<project-slug>/`，取最新 `*.jsonl` 作为当前会话；用原文 Python 脚本解析 `role==“user”` 且 `content` 中 `type==“image”` 的 `source.data` 和 `media_type`，按 `[-1:]` 保存最后 1 张粘贴图像（批量改 `[-N:]`），扩展名映射 `image/webp→webp`、`image/jpeg→jpg`、`image/png→png`，输出路径、字节数、sha256；生成前总是回看保存的文件。
21. Step 2 上传到 Pika CDN：调用 `upload_asset({filename, mime_type, size_bytes, sha256})`，得到 `presigned_url`。
22. Step 2 用 `curl -X PUT -H “content-type: <type>” --upload-file <file> “<presigned_url>”` 把字节 PUT 到 `presigned_url`，`content-type` 使用响应中的精确类型，期望 HTTP 200。
23. Step 2 使用返回的 `public_url`。
24. Step 3 运行编辑：调用 `generate_image_edit`，`provider=“gpt-image-2”`，`quality=“high”`，`output_format=“png”`，`background=true`（轮询），`images` 放 CDN URL，`aspect_ratio=“auto”`，让 worker 测量参考并匹配方向，不手动选或重算比例；从照片读取填充 COLOR GRADING mood 行。
25. Step 3 分支：使用 Step 0 提交的模式对应的 prompt block。
26. object+background prompt：ROLE 设为 expert image-transformation artist specializing in stylized photo-to-game-world conversions and cinematic color grading。
27. object+background prompt：TASK 设为把参考照片转换为高质量 Minecraft 截图，人类主体保持完全照片真实且不变，其余一切变成详细 Minecraft 方块几何，然后根据原照片氛围应用电影调色。
28. object+background prompt：CORE CONCEPT 保持：真实照片级真人站在完全体素/方块 Minecraft 世界中；现实人物和方块环境的对比是整张图重点，不能偏离。
29. object+background CONVERSION RULE 1：KEEP PHOTOREALISTIC，不改变人类主体；脸、皮肤、头发、服装、姿势、比例完全按原样渲染——不风格化、不方块化。
30. object+background CONVERSION RULE 2：CONVERT TO MINECRAFT 高质量方块模型；所有非人类元素——地形、地面、植物、物体、结构、家具、车辆、天空、背景；使用干净立方/体素几何和清晰 16x16 风格方块纹理；质量参考现代 Minecraft 截图配 premium shaders（SEUS/BSL 风格）——真实光照、柔和阴影、AO、体积光、锐利方块边缘。
31. object+background CONVERSION RULE 3：SPATIAL FIDELITY 严格：保持精确相机角度、取景、构图；每个元素保持原始位置；每个元素保持原始相对大小和比例；人类占据与源相同位置和比例；不要添加、移除或重排物体。
32. object+background COLOR GRADING Step 1：先分析原始照片，识别时间、光照方向、主色调、暖/冷、整体氛围，并填入读取的 mood，例如 `moody night street, cool blue sky with warm street-lamp glow` / `golden-hour warm` / `overcast neutral`。
33. object+background COLOR GRADING Step 2：应用匹配该分析氛围的电影调色：filmic contrast curve，平衡高光和阴影；色调与原照片氛围一致；细微 vignette 和 depth；在真实人物和方块环境之间统一，使它们像一张图。
34. object+background OUTPUT SPECIFICATIONS：单张高分辨率图像；锐利、详细、专业 Minecraft 截图质量；照片真实人物 + 体素世界，无缝调色。
35. object+background SELF-CHECK：最终前检查：人类仍 100% 照片真实且不变？其余清晰 Minecraft 方块几何？位置、大小、构图与源相同？调色匹配原照片分析氛围？真实人物和方块世界统一，不像粘贴？
36. object+background 中 loot tags 可选：如果用户想要，或有清晰可命名英雄对象，在 CONVERSION RULES 和 COLOR GRADING 之间插入 LOOT TAGS block，并把 tag line 加到 TASK 和 SELF-CHECK。
37. LOOT TAGS block：在每个英雄体素对象上方或附近，浮动 Minecraft inventory-style name tag——深色半透明圆角矩形上干净白色像素/位图字体（Minecraft item-tooltip / named-entity tag）——命名该物品：列出每个英雄对象→短名，例如 “Mojito”、“Sesame Latte”、“Apple Cake”、“Air Jordan 1”、“Leica M6”；保持标签整洁、清晰、可读、不重叠，漂浮在每个物品正上方，绝不覆盖人脸；SELF-CHECK 加“每个英雄对象是否都有干净可读且不遮脸的 Minecraft 名牌？”
38. background-only：使用同 @rohxit7 recipe，但扩大 CONVERSION RULE 1，使人物不是唯一保持真实；也保持任何 incidental held/foreground object 照片真实；具体替换 RULE 1 和 RULE 2。
39. background-only 替换 RULE 1：KEEP PHOTOREALISTIC，不改变人类主体——脸、皮肤、头发、服装、姿势、比例——以及人物手持或紧邻前景中的任何物体（手机、饮料、包、道具）；全部完全按原样渲染，不风格化、不方块化。
40. background-only 替换 RULE 2：CONVERT TO MINECRAFT 仅背景和环境——地形、地面、植物、结构、家具、车辆、天空、主体身后和周围的场景；使用干净立方/体素几何和清晰 16x16 风格方块纹理；质量参考现代 Minecraft 截图配 premium shaders（SEUS/BSL）——真实光照、柔和阴影、AO、体积光、锐利方块边缘；不要体素化人物或他们持有的任何东西。
41. background-only 保留 CORE CONCEPT、SPATIAL FIDELITY（RULE 3）、COLOR GRADING、OUTPUT SPECIFICATIONS、SELF-CHECK 与 object+background block 逐字不变；background-only 无 loot tags。
42. object-only：这是退役的 Minecraft-Food recipe；按物品填 bracketed list，保持 KEEP 和 label 条款逐字。
43. object-only prompt：Edit this exact photo. KEEP [the person + their face, hair, hands, clothing, accessories / 或 flat-lay: the table, containers, plates, cups, tray, utensils] 和 background/scene 和 lighting 100% PHOTOREALISTIC and unchanged——不要 stylize [the person] at all。
44. object-only prompt：ONLY transform the FOOD, DRINK and the food's TABLEWARE into 3D Minecraft voxel blocks——chunky、低分辨率 cube-pixel geometry 和 flat blocky textures，完全像 Minecraft items，每个自然坐在真实物品的位置：[逐项映射——例如 “the ramen bowl → a blocky voxel bowl of yellow cube-noodles”；“the pepperoni slice → cube crust + voxel cheese + cube pepperoni discs”；“the steamed rice → a mound of white voxel rice cubes”]。
45. object-only prompt：Above or near EACH transformed item, add a Minecraft inventory-style text label: clean white pixel/bitmap font on a dark semi-transparent rounded rectangle, naming the item (e.g. [item labels])。Keep labels tidy and readable, non-overlapping, and never over [the person's face]。
46. object-only prompt：Final look: a real photorealistic [person / scene], but every piece of food, drink and tableware is a Minecraft voxel object with floating Minecraft inventory labels。
47. object-only 然后应用 object+background block 的 COLOR GRADING 步骤：分析源氛围，整帧调色匹配，让体素对象和真实人物/场景读作一张图。
48. object-only 生成前枚举：object-only 质量最大杠杆是逐项命名每个食物/产品 AND 它应变成的体素物体，逐项在 prompt 中；先读源并列出每道菜/饮料/餐具；泛泛 “turn the food into blocks” 很模糊，逐项映射才落地。
49. 任何模式 groups：在 KEEP 条款中命名每个人，避免有人被方块化。
50. Contact objects：手持杯、饮料、盘子等接触物体在 object-only / object+background 中随对象体素化，但在 background-only 中保持真实。
51. Step 4 下载、显示、打开：下载到 `<run-dir>/voxel-it-<subject>.png`，显示它，在 Finder 中 `open`，不做 analyze_media 复查，直接看；除非要求，否则只输出 PNG。
52. Step 4 旋转检查：gpt-image-2 偶尔返回 90° 旋转的编辑；如果天空/天花板不在上方，用 `sips -r 90` 或 `sips -r 270`（哪个能竖直就哪个，免费，不重生成）旋转回正并再查看；仅静态图。
53. 失败模式：输出旋转 90°：用 `sips -r 90` / `sips -r 270` 旋转回正。
54. 失败模式：人物被方块化：重新强调 KEEP 条款；多人时命名每个人。
55. 失败模式：世界几乎没体素化：你在用 `nano-banana-pro`——切换到 `gpt-image-2`。
56. 失败模式：人物看起来像粘贴：确保 COLOR GRADING block + mood line 存在——那是统一器。
57. 失败模式：体素化了错误东西：重查 Step 0——模式选错；object-only = 只突出对象；background-only = 只场景；object+background = 除人物外一切。
58. 失败模式：background-only 中对象被体素化：扩大 KEEP 条款，明确命名手持/前景对象。
59. 失败模式：object-only 中标签缺失/物品错误：忘了 label 条款，或没按名称列出英雄物品；列出每个。
60. 失败模式：标签乱/重叠/在脸上：用 “keep labels non-overlapping, just above each item, never over a face”；重新生成。
61. 失败模式：标签出现了但不该有：你在 background-only（无标签）——去掉 label 条款。
62. 失败模式：昼夜颠倒：在 COLOR GRADING 中明确命名夜晚氛围。
63. 失败模式：裁剪 vs 源：传 `aspect_ratio=“auto”`——worker 匹配参考方向。
64. 失败模式：脸漂移：预期（maskless recipe）；高级修复见下。
65. 高级保证身份（off-recipe）：在源上 `remove_background`（`mode=“portrait”`）→ 用 alpha 作为 gpt-image-2 `mask`（transparent=repaint，opaque=keep），这样只有目标区域转换，人物像素永不被触碰；偏离 @rohxit7 路径；仅在脸必须字节级完美时用。
66. 参考：引擎是 @rohxit7 viral recipe verbatim；object-only prompt + loot tags 来自 @aibyjoe “Minecraft Food”；此技能吸收并退役 minecraft-food（object-only）和 minecraft-world（object+background）；结论：始终 `gpt-image-2`；一个 recipe，三个输入驱动模式。

适用边界 · 注意事项

• 当要求人脸字节级完美不变时，默认 maskless 单画布编辑会重新生成脸并可能漂移；应改用高级 mask 路径或不用此技能。
• 当无法使用 Pika MCP 的 `upload_asset`、`generate_image_edit`、`remove_background` 或 `gpt-image-2` 时。
• 当用户不想把照片变成 Minecraft 体素截图，或要处理视频/多帧时（原文仅支持单张静态图）。