P1 · 上传文件问答完整走查

这条路径是内测期获得有据（grounded）回答的主要方式：LatentFlow 随附的标准/客户 PDF 语料 出于版权原因偏薄，上传你自己的文档能立刻让问答有具体来源可核实。

适用格式

/app/library 的上传入口接受：

• PDF（.pdf）—— 主要格式，数据表、标准文档、图纸说明书等
• CSV（.csv）—— 结构化表格数据

如果你手头没有合适的 PDF，可以用 docs/alpha-test/samples/sample-datasheet.md 里的合成球阀数据表内容， 打印/导出成 PDF 后上传（Word / 浏览器「打印为 PDF」都可以）。

步骤

1. 上传文档

1. 打开 /app/library。
2. 点击上传按钮，选择一个 PDF 或 CSV 文件。
3. 文档出现在列表中，状态为「处理中」。

2. 等待 ingest 完成

• 系统会解析文档内容（切分、建立索引）以支持后续检索。
• 通常几十秒到几分钟，具体取决于文档长度；如果后端刚从冷启动中被唤醒，第一次会更慢。
• 状态变为「已可引用」后即可用于提问。
• 如果状态变成「失败」，点击失败详情查看原因（常见原因：文件损坏、扫描件无法提取文字、格式不受支持）； 可以重新上传或换一份文件，仍失败请按 FAQ 反馈。

3. 选择文档并发起提问

1. 在文档列表中勾选一个或多个「已可引用」的文档（勾选框只对已就绪的文档可用）。
2. 顶部/底部会出现选择工具栏，显示「已选 N 项」。
3. 点击「就 N 篇文档提问」，系统会创建一个限定在这些文档范围内的 Ask 会话，并跳转到 /app/ask。
4. 在输入框中提问（支持中文或英文），回车发送。

你也可以直接进入 /app/ask 开始一个不限定文档范围的会话，但限定文档范围（先在 Library 里勾选）能让答案更聚焦、引用更准确，建议内测优先走这条路径。

4. 读懂回答与引用

• 每条回答下方会附引用（证据）——具体来源文档与页码/段落。
• 点击引用可以打开来源侧栏，跳转到具体页面高亮对应内容，用于人工核实答案是否站得住。
• 如果回答标注为「已放弃 —— 证据不足以回答」或类似的"证据不足"提示，说明模型认为现有文档 没有足够依据支撑一个具体回答——见下方"无证据"章节。

建议尝试的三类问题

为了覆盖不同难度，测试时建议至少问这三类问题（也是测试脚本 SCENARIO-P1-upload-qa.md 的验收项）：

1. ① 文档里明确写出的数值 —— 例如数据表里的某个压力等级、口径、材料牌号，直接问该数值是多少。 期望：准确回答，引用能定位到对应行/段。
2. ② 需要跨页或表格拼接的问题 —— 例如需要从表格里对照两列数据，或不同页面的信息合并才能回答。 期望：模型能给出合理答案且引用覆盖到相关的多处来源；如果拼接失败或引用不全，这是值得记录的 质量问题（不是必然的 bug，但请打分并反馈）。
3. ③ 文档里没有的信息 —— 故意问一个上传文档完全没提到的问题（比如问一个数据表里不存在的 认证编号）。 期望：系统明确回答"无证据"/拒绝回答，而不是编造一个看似合理但无出处的答案。 这是正确行为，不要因为"没给答案"而当作 bug 提交——除非它反而编造了一个没有引用支撑的具体数值， 那才是真正需要报告的问题。

为什么"无证据"是预期行为

LatentFlow 的问答是基于检索增强（RAG）设计的：只依据你上传/授权范围内的文档回答，不依赖模型的 背景知识编造工程数值。当检索不到相关证据时，系统应当明确说"回答不出/证据不足"，而不是编一个 听起来合理但没有出处的数字——后者在工程场景里比"答不出"危险得多。所以：

• 看到「证据不足，暂不作答」类提示 → 符合预期，请照常记录（可以标注"正确拒答"）。
• 看到一个具体数值/结论但没有可点开的引用，或引用打开后内容对不上 → 请报告，这可能是幻觉 （hallucination）。

常见问题速查

现象	说明
上传后一直「处理中」不变化	等待更久一点；若几分钟无变化，考虑冷启动或刷新页面重试，仍无效再反馈
勾选框点不了	只有「已可引用」的文档才能被选中用于提问，处理中/失败的文档不可选
看到别人上传的文档	内测期共享库是预期行为，见 已知问题清单
引用点开是空的/跳错页	请截图并反馈，附上文档名和提问内容

参考

• Alpha 测试者快速上手
• FAQ / 排障
• 已知问题清单
• 术语表