FAQ / 排障
内测期常见现象与处理方式。很多"看起来像 bug"的情况其实是已知边界，先在这里查一下， 能省掉一次不必要的反馈往返。
打开页面/第一次操作很慢，甚至报错（冷启动）
现象：进入网站或第一次上传/提问/运行计算时，转圈很久，或者直接报错。
原因：后端部署在闲时会休眠的实例上，长时间无请求后会"睡着"，第一次请求要把它唤醒， 通常需要几秒到十几秒。
该怎么办：等几秒，刷新页面或重新提交一次同样的操作。如果连续两次唤醒后仍然失败， 才需要反馈——请注明"疑似冷启动之外的问题"，附上操作步骤和报错截图。
我能看到别人建的项目/上传的文档
现象：/app/projects、/app/library 里出现不是自己创建的项目或文档。
原因：内测阶段所有测试者共用同一份项目库和文档库，没有按人隔离数据。这是当前阶段 刻意的简化设计，不是权限漏洞。
该怎么办：不用反馈。请注意不要上传敏感或保密数据。如果你发现别人的数据明显不合适 （例如内容异常/不该出现在测试环境），直接私下告诉我们即可。
描述了球阀以外的阀型，被拦截了
现象：需求里提到闸阀（gate valve）、截止阀（globe valve）、蝶阀（butterfly valve）等， 系统提示"Alpha 仅支持球阀"，不继续往下解析或计算。
原因：Alpha 当前只支持球阀，这是产品范围的硬性限制，通过关键词识别主动拦截， 避免在不支持的阀型上产出错误的工程结果。
该怎么办：不用反馈——这是预期行为。测试脚本里的超范围用例就是专门验证这个提示是否清晰。 如果提示语义不清楚、拦截后页面卡死或崩溃，这才需要反馈。
上传文档问答时经常拿不到具体答案 / 来源很少
现象：在 /app/ask 问一个问题，系统回答"证据不足"或给出的引用很少。
原因：随附的标准/客户 PDF 语料出于版权原因并未全部上线，内置来源检索本身就偏薄。
该怎么办：优先上传你自己的 PDF 资料（见 P1 走查）， 在自己上传的文档范围内提问，得到的回答会更有据。如果针对你自己上传的文档提问， 文档里明明有答案却仍然显示"无证据"，或者答案的引用明显对不上文档内容——这种情况请反馈， 附上文档名和问题原文。
问了一个文档里没有的问题，系统说答不出来
现象：故意问一个上传文档完全没提到的内容，系统回答类似"证据不足，暂不作答"。
这是预期行为，不是 bug。 LatentFlow 的问答基于检索增强设计，只依据已授权文档回答， 不会用模型的背景知识编造工程数值。"答不出"比"编一个看似合理但没出处的数字"更安全。 真正需要反馈的是反过来的情况：系统给出一个具体数值/结论，但没有可核实的引用支撑—— 这才是需要报告的幻觉（hallucination）问题。
导出 CAD 文件是空的，或者 STEP 导不出来
现象：点击导出后没有文件，或者 STEP/FCStd 提示不可用。
原因一（预期降级）：服务端环境未安装 FreeCAD 时，系统会明确提示"当前环境未安装 FreeCAD —— 无法生成 STEP 文件"，但零件映射、DXF/SVG 图纸草稿与 BOM 仍会正常生成。 这是已知的部署限制，不用反馈。
原因二（需要反馈）：如果连 DXF/SVG 都拿不到，或者提示信息本身就是空白/报错崩溃， 或者「导出受阻」提示没有说清楚具体缺什么参数——这属于需要反馈的问题，请附上项目 ID、 运行到哪一步、以及页面截图。
冻结需求（Freeze intake）点了没反应，或提示"受阻"
现象：点击冻结按钮，弹出阻塞提示，列出若干缺失字段。
这是预期设计：冻结前系统会检查必填字段是否齐全，缺项会被列出来，需要你先回到 requirement 页补全或通过澄清对话回答后再次点击冻结。
该怎么办：按提示补全缺项后重试。如果提示信息本身语焉不详（例如只写"冻结失败"却不说 缺哪个字段），或者补全后仍然反复受阻、找不到原因——这需要反馈，附上项目 ID 和缺失字段截图。
遇到一个通用报错 / 页面崩溃，不属于上面任何一种
该怎么办：直接反馈，请尽量提供：
- 你在哪个页面、做了什么操作（哪个路径 P1/P2、哪个项目/会话）
- 期望结果 vs 实际结果
- 报错文案或页面截图
- 是否可以稳定复现
反馈渠道：<在此填入你的反馈渠道：微信群 / 邮箱 / 表单链接>