代码 review 后的清理: - 接口4 由网关本机实现,worker app.py 的 /face/features 回退 Mock(保持 worker 无外网依赖); worker requirements 标注 volcengine 改为网关侧;移除 worker 的接口4 测试(随实现挪到网关) - 网关接口4 业务错误 HTTP 状态统一改 200(与其余接口/worker 约定一致,原为400/503) - 接口文档:gender 非法码 1004(原误写1008);修正指向已删文档的链接 文档合并:把各接口技术方案/开发任务书/系统架构/网关任务书 合并成 docs/实现说明.md(简要总览), 删除原 7 份分散文档,README 收敛为索引(实现说明/接口文档/需求/OFFLINE_ASSETS)。 pytest 44 全绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
文档索引
旷视五接口(四庭七眼测量 / C端生发 / B端生发 / 用户特征 / 发际线PNG)。系统拆成 外网网关 + 高性能 worker(GPU) 两台机器、一个仓库。
| 文档 | 作用 |
|---|---|
| 实现说明.md | 实现总览:架构、五个接口怎么实现、base64→URL 映射、错误码、部署/环境要点。先读这份。 |
| 接口文档.md | 对外 API 契约(字段 / 错误码)。字段命名的唯一权威。 |
| 旷视具体需求.md | 原始需求。 |
| ../OFFLINE_ASSETS.md | worker 离线模型权重/字体清单(内网部署)。 |
原先分散的「各接口技术方案 / 开发任务书 / 系统架构 / 网关任务书」已合并进
实现说明.md(细节可查 git 历史)。