Wardrobe:如何用一张照片自动生成完整数字衣橱?AI服装提取工具终极指南
【免费下载链接】wardrobeYour clothes, extracted and organized with gpt-image.项目地址: https://gitcode.com/gh_mirrors/wardro/wardrobe
Wardrobe 是一款开源的 AI 服装提取与数字衣橱管理工具,它能从一张照片中自动检测所有衣物、用 gpt-image 生成干净的服装抠图,并整理成本地化的数字衣橱图库。全程数据保存在你自己的电脑上,本地优先、隐私友好,是个人穿搭资产管理的免费完整方案。
一、Wardrobe 能做什么?
简单来说,Wardrobe 把你的旧照片变成一座"数字衣橱" 📸:
- 衣物检测:通过 OpenAI Responses API 自动识别照片中的每一件单品(上衣、外套、下装、配饰、鞋子)
- 服装提取:用 OpenAI Images API 生成干净的产品级抠图,去除人物、皮肤、道具与背景
- 模特图生成:基于你的人像参考照片,为每件衣物生成"穿着效果"的模特展示图
- 本地化管理:原始照片、生成图片和 JSON 数据库全部保存在本地
data/目录,不上传云端 - 人工审核:支持拖拽、粘贴、编辑、重新生成与逐项审批,AI 出活、你做主
核心能力一览来自 README.md,前端主界面实现在 src/App.jsx,导入流水线在 src/import-flow.jsx。
二、快速上手:3 个命令启动你的 AI 数字衣橱
准备工作很简单,只需 Node.js 22+ 和一把 OpenAI API Key:
- 获取代码(需要 clone 仓库时使用:
git clone https://gitcode.com/gh_mirrors/wardro/wardrobe) - 安装依赖并复制配置文件:
npm install,然后cp .env.example .env - 在
.env中填入OPENAI_API_KEY,放一张自己的 PNG 参考照到data/model-reference.png - 运行
npm run dev,打开 localhost:5173 🚀
⚠️ 注意:在补齐 API Key 和参考照片之前,导入功能会保持关闭状态——这是项目的设计,确保隐私安全。
配置项说明(完整示例见 .env.example):
| 变量 | 默认值 | 说明 |
|---|---|---|
OPENAI_API_KEY | 必填 | OpenAI 接口密钥 |
OPENAI_VISION_MODEL | gpt-5.4-mini | 衣物检测模型 |
OPENAI_IMAGE_MODEL | gpt-image-2 | 抠图/模特图生成模型 |
OPENAI_IMAGE_QUALITY | high | 生成质量 |
WARDROBE_MODEL_REFERENCE | data/model-reference.png | 人像参考照路径 |
WARDROBE_DATA_DIR | data | 本地数据目录 |
三、导入流程:一张照片如何变成 4 道关卡
Wardrobe 的导入是一个"三级流水线",每一步都需要你确认 ✅:
- 检测裁切(Crop):AI 找出照片中的每件衣物并裁出候选区域 → 你点"Use crop"
- 服装提取(Garment):生成干净的透明底服装图 → 你填写名称、分类(Tops/Jackets/Bottoms/Accessories/Shoes)、主色与辅色、标签
- 模特图(Modeled):结合你的人像参考生成穿着展示图 → 满意即批准入库
每一步都可以点击Regenerate并附上具体修改方向(例如"保留原拉链、去掉吊牌"),不满意直接 Reject。如果自动背景清理不干净,还有一个本地清理强度滑块让你手动调整边缘,不会重复调用图像模型。这套状态机逻辑实现在 src/import-flow.jsx,任务接口在 scripts/import-job-api.mjs。
小技巧:照片拍得越清晰、主体越完整,检测结果越准;整身穿搭照也可以直接导入,AI 会把每件单品拆开单独建档 👕。
四、进阶玩法:用 AI 助手批量导入整柜衣服
如果你有成千上万张穿搭照片,Web UI 一张张导入太慢。项目内置了两个 Codex 技能 🤖:
- import-clothes:指向一个照片文件夹,AI 自动完成"提取—建模—审核—写入
data/library.json"全流程,大批量时还会拆分子任务并行处理,详见 .agents/skills/import-clothes/SKILL.md - generate-outfits:从你的衣橱里自动搭配,生成模特版"造型手册"(lookbook),详见 .agents/skills/generate-outfits/SKILL.md
在 Codex 中打开仓库后,只需输入一句话,例如"$import-clothes 导入 ~/Pictures/outfits 里的衣服",剩下的交给它。
五、项目结构与常用入口
| 路径 | 说明 |
|---|---|
| src/App.jsx | 衣橱主界面:分类、检索、调色板提取 |
| src/import-flow.jsx | 导入队列、三级审核、重新生成 |
| scripts/import-job-api.mjs | 导入任务后端 API |
| scripts/responsive-image-api.mjs | 响应式图片优化(基于 sharp + ipx) |
| data/library.json | 本地衣橱数据库(自动创建) |
| CONTRIBUTING.md | 贡献规范:注意不要提交.env与个人照片 |
六、常见问题 FAQ
需要花多少钱?工具本身免费开源(MIT 协议),但调用 OpenAI 的视觉与图像生成接口会产生 API 费用。
照片会上传吗?你的原始照片只会在本地处理与存储;检测与生成环节会按 OpenAI 接口规范发送必要图像,而参考照与衣橱数据始终留在data/本地。
支持哪些分类?上衣、外套、下装、配饰、鞋子五大类,加一个"造型(Outfits)"合集视图。
总结
Wardrobe 把"AI 服装提取 + 数字衣橱管理"变成了开箱即用的完整方案:一张照片进来,检测、抠图、模特展示、分类入库全流程自动跑完,而你始终握有审批权。如果你正在寻找免费的个人穿搭数字化工具,这套本地优先的开源方案值得放进你的工具清单 🧥。
【免费下载链接】wardrobeYour clothes, extracted and organized with gpt-image.项目地址: https://gitcode.com/gh_mirrors/wardro/wardrobe
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考