接口2(/api/v1/hair/grow)的 image_url 和接口5(/api/v1/hairline/generate) 的 image_middle/high/low_url 从「原图+白线合成 JPG」改为「透明底 PNG(仅含 发际线曲线)」,前端需叠加原图显示。grown_image_url 生发图保持不变(ComfyUI 完整人像照片)。 实现: - app.py 新增 _rgba_png_b64() 编码 RGBA 透明层为 PNG base64(保留 alpha) - hairline/service.py 接口2/5 改用 build_overlay_layer(返回 RGBA 透明层) 替代 render_hairline_overlay(合成到原图) - 网关零改动:rewrite_base64_to_url 已按 \x89PNG 魔数嗅探落盘为 .png 测试页:test_interface2/5.html 改为「原图打底 + 透明PNG 绝对定位叠加」显示 (复用 .img-stack 结构,固定叠加无开关)。 文档:接口文档.md / integration.html 更新接口2/5 图片字段说明。 测试:43 passed,接口2 image_base64 改断言为 PNG 魔数,接口5 三档叠图同。
文档索引
旷视五接口(四庭七眼测量 / C端生发 / B端生发 / 用户特征 / 发际线PNG)。系统拆成 外网网关 + 高性能 worker(GPU) 两台机器、一个仓库。
| 文档 | 作用 |
|---|---|
| 实现说明.md | 实现总览:架构、五个接口怎么实现、base64→URL 映射、错误码、部署/环境要点。先读这份。 |
| 接口文档.md | 对外 API 契约(字段 / 错误码)。字段命名的唯一权威。 |
| 旷视具体需求.md | 原始需求。 |
| ../OFFLINE_ASSETS.md | worker 离线模型权重/字体清单(内网部署)。 |
原先分散的「各接口技术方案 / 开发任务书 / 系统架构 / 网关任务书」已合并进
实现说明.md(细节可查 git 历史)。