美匠作品集多模态踩坑系列导读最近在做化妆师作品集与「以图搜妆」时连续踩了几处坑分类写死、异步打标写不进 category、淡妆被误杀、架构图被误放行、本地 URL 云端拉不到、服务没配 VL Key。本系列按问题拆短文便于检索也适合当面试案例。目录篇标题核心一句话01妆容分类从写死到可扩展用字典表 VL 标签而不是 switch 四个枚举02未选分类上传后分类为空用户可见字段不要只靠「异步 公网 URL」回填03妆容图被误判为非妆容门禁提示词要从宽认妆并做人像向纠偏04本地联调云端拉不到图片上传门禁用图片字节 / base6405架构图被当成创意妆示意图硬拒绝防止模型幻觉扩展阅读以图搜妆·鉴妆入库联调与踩坑含 API 清单与上述坑位汇总。技术栈背景微信小程序作品集管理Spring Boot 微服务portfolio / ai / data-platform通义千问 Qwen-VL text-embedding阅读建议先 04模型看不见图→ 02字段何时写入→ 03/05判错两端→ 01分类扩展。