Alpha 测试者快速上手 · Tester Quickstart
欢迎参与 LatentFlow 内测。这是给外部测试者的入口页——先读完这一页，再按需点进两条路径的详细走查。
This page is the tester entry point. Read this first, then follow one of the two path walkthroughs linked below.
这是什么
LatentFlow 是一个 AI 辅助的球阀（ball valve）工业设计工作流：把需求（自然语言描述 / 数据表） 交给它，系统依次完成需求澄清 → 工程计算 → 来源核对 → 复核 → CAD/工程图草案。
⚠️ Alpha 当前只支持球阀（ball valve）。闸阀、截止阀、蝶阀等其他阀型会被系统识别并明确拦截， 不会得到（错误的）结果——这是预期行为，不是 bug。
Alpha supports ball valves only. Other valve types (gate/globe/butterfly/…) are detected and blocked with a clear message — that block is expected behavior, not a bug.
所有计算、CAD 与工程图输出都标注为 Draft（草稿），用于验证工作流本身，不可直接用于生产。
如何访问 · Access
- 打开测试地址：
https://<发给你的前端地址> - 首次进入会看到一个**访问令牌（access token）**输入框，粘贴我私下发给你的令牌，点击进入。
- 令牌会记在这台设备/浏览器里，之后不用再输（除非换设备或清了浏览器数据）。
The token gates every page under
/app. Paste it once — it's stored in this browser only. Don't share it outside the test group.
冷启动提示 · Cold start
后端部署在按需启停的实例上，闲置一段时间会休眠。你在测试期间如果遇到：
- 打开页面后第一次请求转圈好几秒甚至报错
- 上传/提问第一次没反应
这是正常现象 —— 通常是后端正在被唤醒，等几秒、刷新一次页面（或重新提交一次操作）即可。 连续两次都失败再按下方渠道反馈。
The backend may sleep when idle. The first request after idle time can take a few seconds or time out once — wait a moment and retry/refresh before reporting it as a bug.
已知边界（内测阶段）· Known limits
在开始之前，请先建立这几条预期，很多"看起来像 bug"的情况其实是已知边界：
| 边界 | 说明 |
|---|---|
| 共享库 / Shared library | 内测期所有测试者共用一份项目库和文档库，你能看到别人建的项目和上传的文档，别人也能看到你的。请勿上传敏感或保密数据。 |
| 仅 Draft / Draft only | 计算结果、CAD 模型、工程图、BOM 均为草稿，未经工程师批准，不可用于采购或制造。 |
| 来源语料偏薄 / Thin bundled sources | 出于版权，随附的标准/客户 PDF 语料未全部上线，内置的来源检索结果会偏少甚至没有。上传你自己的 PDF（路径 P1）是获得有据回答的主要方式。 |
| 仅球阀 / Ball valve only | 其他阀型请求会被 alpha scope 拦截，见上文。 |
两条必测路径 · Two golden paths
内测的核心是这两条路径，其他功能都是围绕它们展开的。
路径 P1 · 上传文件问答（3 步开始）
- 打开
/app/library，上传一个 PDF（或 CSV）——可以是你自己的资料，也可以用测试脚本目录docs/alpha-test/samples/里的合成数据表打印成 PDF。 - 等文档状态变成「已可引用」（ingest 完成，通常几十秒到几分钟，冷启动刚唤醒时会更慢）。
- 勾选该文档 → 点击「就 N 篇文档提问」→ 进入
/app/ask提问，答案会带引用，点击引用可跳转到来源页。
完整走查（含三类提问示例、如何读引用、"无证据"为何是正确行为）见 P1 · 上传文件问答完整走查。
路径 P2 · 需求 → CAD/预览（3 步开始）
- 打开
/app/projects/new，用中文或英文描述一个球阀需求（口径/DN、压力等级、介质、温度……）。 - 回答系统的澄清提问补全缺失字段，然后在项目的 requirement 页 冻结需求（Freeze intake）—— 这是运行计算前的必需步骤。
- 运行工程计算，在 calculations 页看结果，在 cad 页看 3D Draft 预览、参数映射与 Draft BOM， 尝试导出 STEP/DXF/SVG。
完整走查（含冻结的含义、FreeCAD 不可用时如何降级）见 P2 · 需求到 CAD 完整走查。
第一段 · 需求录入 → 结构化规格（粘贴需求 → agent 抽取字段并追踪确认/假设/待处理项）：
第二段 · 冻结 → 计算 → CAD（补全字段后冻结规格 spec@v1 → 运行工程计算 → CAD 参数契约全部 agreement，可导出 STEP/DXF/SVG）：
说明：上面两段动图合起来覆盖完整 P2——需求录入与结构化抽取（第一段），冻结、工程计算与 CAD 参数契约（第二段）。
怎么反馈问题 · How to report
遇到 bug、卡住、或结果不对，请尽量附上：
- 你做了什么（哪个路径、哪个项目/会话、点了什么）
- 期望 vs 实际
- 截图（若有报错信息）
先看一眼 FAQ / 排障 和 已知问题清单 —— 很多现象已经被记录，不用重复反馈。
反馈渠道：<在此填入你的反馈渠道：微信群 / 邮箱 / 表单链接>
Report channel: <insert your feedback channel — group chat / email / form link>
如果你是按测试脚本走查的，请同时参考仓库 docs/alpha-test/ 下的场景脚本与验收清单 （SCENARIO-P1-upload-qa.md / SCENARIO-P2-requirement-to-cad.md / CHECKLIST.md）， 把每一步的 OK/NG 记下来。
感谢帮忙试用 你的反馈会直接影响下一版。