nvzhuang

环境要求

• Docker 与 Docker Compose（推荐部署方式）
• 现代浏览器，用于访问前端图集与服务
• 可选：OpenAI / 豆包 / Gemini 等生图服务的 API Key
• 可选：本地运行后端需自备 Go 编译环境

安装与启动步骤

1. 1获取项目代码

   克隆仓库并进入项目根目录，后续后端与前端命令都在此目录下执行。

   git clone https://github.com/paipiange/nvzhuang.git
   cd nvzhuang

   复制

2. 2打开前端图集

   前端是纯静态站点，无需构建，用任意静态文件服务器托管前端目录即可浏览 1407 张参考图。

3. 3复制配置模板

   在 backend/config 路径下把示例配置复制为正式配置；不复制时系统会自动回退加载模板并监听 8000。

   cp backend/manifest/config/config.example.yaml backend/manifest/config/config.yaml

   复制

4. 4填写模型配置

   编辑 config.yaml 的 llm.models，按需设置 provider、baseURL、model，并填 apiKey 或用 envKey 指向环境变量。

5. 5注入模型密钥

   用环境变量传入 Key 更安全，envKey 优先级高于配置文件里的 apiKey 字段。

   export ARK_API_KEY="ark-xxxxxxxx"
   export OPENAI_API_KEY="sk-xxxxxxxx"

   复制

6. 6一键启动后端

   在项目根目录执行 Docker Compose 启动后端，容器默认监听 8000 端口。

   docker compose up -d

   复制

关键配置

如何确认成功

浏览器访问 http://localhost:8000 能正常返回服务，前端图集可筛选、搜索并查看大图。

常见问题

注意事项

• 所有图片均为 AI 生成的服装设计概念图，不是现实品牌商品照片。
• 调用大模型会消耗对应第三方服务的配额，请自行评估成本。
• 公网部署时建议启用 Bearer Token 鉴权、CORS 白名单、限流与图片大小校验等安全项。
• README 另给出 docker run 单命令方式，需已有 costume-tryon 镜像，并映射 8000 端口、注入模型 Key。