Alpha 测试者快速上手 · Tester Quickstart
欢迎参与 LatentFlow 内测。这是给外部测试者的入口页——先读完这一页，再按需测试三条黄金路径。
This page is the tester entry point. Read this first, then follow one of the three golden paths below.
这是什么
LatentFlow 是一个 AI 辅助的球阀（ball valve）工业设计工作流：把需求（自然语言描述 / 数据表） 交给它，系统依次完成需求澄清 → 工程计算 → 来源核对 → 复核 → CAD/工程图草案。
⚠️ 需求到 CAD（P2）当前只支持球阀（ball valve）。闸阀、截止阀、蝶阀等其他阀型会被系统识别并明确拦截， 不会得到错误的 CAD 结果。报价包（P3）可以分析允许范围内的工业阀门采购资料，但能否形成正式报价仍取决于明确行项目、公司目录匹配和发布门禁。
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://latentflow.dev/app（用 Chrome / Edge 桌面浏览器） - 首次进入如出现**访问令牌（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.
首批 Alpha 采用单公司 owner 模式。测试者不要交换令牌；系统会把项目、报价、审批和分享操作绑定到该令牌对应的公司和操作人。后续启用成员邀请时，只有经 Supabase 验证且与邀请邮箱一致的账号才会获得权限。
冷启动提示 · 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"的情况其实是已知边界：
| 边界 | 说明 |
|---|---|
| 组织隔离 / Organization isolation | 每位测试者使用分配给自己的组织令牌，只能访问所属组织的数据。Alpha 仍只允许公开、合成或已获授权的文件；不要上传未经授权的保密资料。 |
| 审批身份 / Approval identity | 首批 Alpha 仅由指定 owner 审批与发布；看到 403 时不要借用其他人的令牌，请把项目 ID 和操作步骤反馈给运营方。 |
| 仅 Draft / Draft only | 计算结果、CAD 模型、工程图、BOM 均为草稿，未经工程师批准，不可用于采购或制造。 |
| 来源语料偏薄 / Thin bundled sources | 出于版权，随附的标准/客户 PDF 语料未全部上线，内置的来源检索结果会偏少甚至没有。上传你自己的 PDF（路径 P1）是获得有据回答的主要方式。 |
| CAD 仅球阀 / Ball-valve CAD only | P2 的其他阀型请求会被 alpha scope 拦截；P1/P3 的文档理解范围以页面实际门禁为准。 |
三条必测路径 · Three 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 参数契约（第二段）。
路径 P3 · 报价包 → 正式报价
- 进入「报价」并上传公开、合成或已获授权的报价包，等待分析完成。
- 按步骤条依次确认项目与数量、单价、商务与合规，然后审核发布。
- 下载 PDF/Excel；由 owner 开启外部交付后，可创建有收件人和有效期的受控链接。发布后报价锁定，也可以解锁修改或完全重新开始。
完整验收步骤见仓库中的 SCENARIO-P3-quote-package-to-release.md。
怎么反馈问题 · How to report
遇到 bug、卡住、或结果不对，请尽量附上：
- 你做了什么（哪个路径、哪个项目/会话、点了什么）
- 期望 vs 实际
- 截图（若有报错信息）
先看一眼 FAQ / 排障 和 已知问题清单 —— 很多现象已经被记录，不用重复反馈。
主要反馈渠道是页面右下角的「反馈」按钮：请选择问题、建议、困惑或表扬，可主动附上截图。反馈会保存在系统后台；如果运营方配置了通知 webhook，也会同步到值班渠道。
想要逐个功能的详细图文操作步骤（如何创建项目、如何上传管理文档、如何问答、如何冻结/计算/看 CAD）， 见 功能操作手册。
如果你是按测试脚本走查的，请同时参考仓库 docs/alpha-test/ 下的场景脚本与验收清单 （SCENARIO-P1-upload-qa.md / SCENARIO-P2-requirement-to-cad.md / SCENARIO-P3-quote-package-to-release.md / CHECKLIST.md）， 把每一步的 OK/NG 记下来。
感谢帮忙试用 你的反馈会直接影响下一版。