☰
Wardrobe:如何用一张照片自动生成完整数字衣橱?AI服装提取工具终极指南
2026/10/7 8:36:11 网站建设 项目流程

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:

  1. 获取代码(需要 clone 仓库时使用:git clone https://gitcode.com/gh_mirrors/wardro/wardrobe)
  2. 安装依赖并复制配置文件:npm install,然后cp .env.example .env
  3. 在.env中填入OPENAI_API_KEY,放一张自己的 PNG 参考照到data/model-reference.png
  4. 运行npm run dev,打开 localhost:5173 🚀

⚠️ 注意:在补齐 API Key 和参考照片之前,导入功能会保持关闭状态——这是项目的设计,确保隐私安全。

配置项说明(完整示例见 .env.example):

变量默认值说明
OPENAI_API_KEY必填OpenAI 接口密钥
OPENAI_VISION_MODELgpt-5.4-mini衣物检测模型
OPENAI_IMAGE_MODELgpt-image-2抠图/模特图生成模型
OPENAI_IMAGE_QUALITYhigh生成质量
WARDROBE_MODEL_REFERENCEdata/model-reference.png人像参考照路径
WARDROBE_DATA_DIRdata本地数据目录

三、导入流程:一张照片如何变成 4 道关卡

Wardrobe 的导入是一个"三级流水线",每一步都需要你确认 ✅:

  1. 检测裁切(Crop):AI 找出照片中的每件衣物并裁出候选区域 → 你点"Use crop"
  2. 服装提取(Garment):生成干净的透明底服装图 → 你填写名称、分类(Tops/Jackets/Bottoms/Accessories/Shoes)、主色与辅色、标签
  3. 模特图(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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询