Files
frontend/Client/docs/backend-direct-matching.md
2026-10-15 10:35:55 +08:00

29 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 直接获取零件:真实联调结果与后端调整点
用户要求:用户输入文字/图片,后端按已有信息匹配并返回 components,前台直接加载 URDF、按实际连接点装配并展示全部返回的零件。未提供的可选参数不阻止返回零件,也不要求用户先回答问卷。
## 本次真实接口结果
- 输入“给我拼一个鸟”:返回 ready,confirm 成功,components 有躯干与头。躯干的 child Link 是 LINK_head,头的 child Link 是 Link-head,后端 urdfInfo.frames 均明确 interfaceType=head_0。前台已使用这份显式类型配合实际 URDF 坐标连接,坐标与方向不修改。
- 输入“给我拼一个机器人”:后端返回 needs_clarification、canSubmit=false 和 5 个问题,涉及形态、功能、场景、参数、外观等。前台继续调用确认接口,仍返回 HTTP 409。
```json
{
"code": "DEMAND_REVISION_CONFLICT",
"message": "需求尚未完成解析或仍需补充说明",
"data": null,
"requestId": "13deb48bd5c5462e87e72ab6091801e0"
}
```
接口:`POST /api/robot-analyses/{analysisId}/confirm`;请求体为原 revision 与 confirmed:true,前台没有篡改需求 JSON、canSubmit 或解析状态。
## 后端需调整
1. AI 将未提供的尺寸、质量、材料、预算、场景等保留为空,不将这些可选信息变成追问前置条件。
2. 通用“机器人”等需求按已有信息和可用库存返回一个默认组合;不足时允许返回部分 components,不把完整需求问卷作为必要条件。
3. 调整解析状态与 confirm 的一致性:可匹配时正常返回结果;若保留 needs_clarification 状态,需要 confirm 允许用已有信息匹配。仅删除前端的问卷无法解除现在的服务端 409。
4. 业务完整性或 assembly.status=blocked 不应清空已选出的 components。缺失连接信息时仍返回文件与已有 urdfInfo。
前台已去掉额外追问表单、canSubmit 的本地请求拦截和再次确认步骤。成功返回的 components 自动加载;不能唯一配对的零件仍单独展示,资源请求失败显示具体文件错误。前台不会替用户编造答案,或循环发送消息来绕过后端校验。