特斯拉 Paint Shop 贴图设计(全车型)
把任意风格应用到特斯拉官方 UV 模板,输出能被车机 Paint Shop 识别的合规 PNG。内置全部 12 个官方车型模板。
关键铁律(务必遵守)
- 面板外必须透明(alpha=0),不是纯黑也不是纯白 —— 这是「无法识别」的头号原因。
- 文件 < 1,000,000 字节(约 976 KB,特斯拉按十进制 1MB 计,不是 1024 KB),PNG 格式,用模板原始尺寸(1024×1024,Cybertruck 为 1024×768),文件名 ≤30 字符、仅字母/数字/下划线/连字符/空格。
- 只填充模板的白色面板区域,面板轮廓、形状、位置严格不变。
工作流
0. 先确认车型(必须)
若用户没有说明车型,必须先问(用 AskUserQuestion 或直接询问),从下面选择:
| key | 车型 |
|---|---|
| cybertruck | Cybertruck |
| model3 | Model 3(老款) |
| model3-2024-base | Model 3 2024+ 焕新版(标准/高级) |
| model3-2024-performance | Model 3 2024+ 焕新版(Performance) |
| modely | Model Y(老款) |
| modely-2025-base | Model Y 2025+ 焕新版(标准) |
| modely-2025-premium | Model Y 2025+ 焕新版(高级) |
| modely-2025-performance | Model Y 2025+ 焕新版(Performance) |
| modely-l | Model Y L(长轴) |
| models-2021 | Model S 2021+ |
| models-2025-plaid | Model S 2025+ Plaid |
| modelx-2021 | Model X 2021+ |
> 车型、年份、版本(Standard/Premium/Performance/Plaid)都要确认清楚,模板不能混用,否则贴到车上会错位。可选:python3 scripts/process_wrap.py --list-models 列出全部车型。
1. 生成涂装(AI 生图)
- 用图像生成工具(ImageGen),把对应车型的官方模板(assets/templates/<key>.png)作为 image1 输入,prompt 描述风格并要求「只填充白色面板、保持面板轮廓不变、背景保持黑色不变」。
- 若有参考效果图,作为 image1,模板作为 image2 输入。
2. 后处理(核心,用 scripts/process_wrap.py)
python3 scripts/process_wrap.py --gen 生成图.png --model <车型key> --output 输出.png --max-kb 1000
脚本自动完成:
- 用车型模板白色面板 mask 裁剪:面板内保留涂装,面板外 alpha=0 且 RGB=0(同时清除 AI 生图右下角的「AI生成」水印角标)。
- 自动选最高色深(8→7→6→5 bits),使文件 ≤ max-kb。
- 打印校验结果。
3. 校验与交付
确认输出满足:RGBA、模板原始尺寸、≤1 MB、面板外透明、面板内不透明、无水印、文件名合规。详见 references/tesla_paint_shop_specs.md。
常见问题
- 上传「无法识别」:99% 是背景不透明(做成了纯黑)。改为透明背景即可。
- AI 图带水印:水印固定在右下角,落在模板背景区,第 2 步裁剪会连同背景一起清掉(RGB 清零)。
- 文件超 1 MB:降低 posterize 色深(7→6→5 bits)。
- 贴到车上错位:车型模板不匹配,需用与车辆一致的官方模板。
- 能上传但变形:Cybertruck 是 1024×768,不能拉伸成 1024×1024。
Resources
scripts/process_wrap.py—— 后处理:透明裁剪 + 去水印 + 色深控制 + 校验,支持--model选车型。assets/templates/—— 12 个特斯拉官方 UV 模板(<车型key>.png)。references/tesla_paint_shop_specs.md—— 特斯拉 Paint Shop 完整上传规范与故障排查。