wangdequan
72152ef356
Real IFC2X3/IFC4 import tested. Full BIM authoring/export remains out of scope; 349-second building import performance remains to optimize.
Web FreeCAD 用户测试工作区
2026-09-16 最新：IFC 原生导入修复与复测。FILE-02 的真实 IFC 导入现已通过，累计手册 21 项通过；完整 BIM 作者/IFC 导出 API 不在本次关闭范围。
最新授权修复结果见 修复与复测记录。原始失败保留在旧时间戳目录，当前缺陷状态以 defects.json 和最新报告为准。
原剩余九项的后续结果见 九项执行结果与 IFC 依赖缺口：8 项通过、IFC 所在的多格式项失败，未以“已执行”冒充“已通过”。
范围和事实基线
本目录执行用户手册中的真实浏览器操作，保存通过、失败和阻塞证据。1452/1452 是实现登记数，不是用户验收通过数。此前“完整烟测已通过”的表述不成立：旧流程没有完成浏览器业务链路，TypeScript 门禁也存在错误。
本目录根部的 summary.tsv、模块日志及 PNG 为最初的旧烟测框架探索批次。部分场景名不被旧框架支持，部分截图可能来自旧框架已有文件，不能据此签署验收。后续以 manual-时间戳/ 里的新鲜证据为准。
分步计划
- 读取 Markdown 手册，保存本轮输入快照和发布文件指纹。
- 启动带 COOP/COEP 的本地预览服务，创建独立 Chrome 配置，隔离 OPFS 和下载。
- 执行 UI-01/02、GEO-01 至 GEO-04，记录新建、尺寸、事务、布尔和删除。
- 执行 FILE-01/03/04、DOC-01，记录导入、FCStd、OPFS、属性和重开。
- 执行 UI-04、ERR-02/03，记录相机交互、非法输入和重复请求。
- 访问结构、链接、多格式及导出流程；入口失败时保留失败截图，后续业务步骤记未执行，不能由其他格式代替。
- 按注册表逐一访问 32 个真实工作台入口，不能用独立模块演示页代替工作台。
- 运行 20 轮有限稳定性循环，单列未覆盖的大文件、完整导入循环和内存评估。
- 输出手册覆盖矩阵、缺陷清单和上线结论。任何 P0/P1 或关键未测项都禁止据此宣布可上线。
运行与恢复
在 FreeCAD 仓库目录执行：
node tools/run_user_manual_tests.mjs
仅复测指定项目，不重复已通过的无关项：
FREECAD_MANUAL_IDS=FILE-03,DOC-01 node tools/run_user_manual_tests.mjs
每轮生成新目录。脚本有步骤超时、异常快速退出、逐项落盘和进程清理。results.json 是机器可读进度，checkpoint.json 是恢复入口，report.md 是逐步过程。返回非零表示存在失败/阻塞，不表示整批未运行。
文件管理
| 文件 | 用途 |
|---|---|
| manual-snapshot.md | 当次测试所依据的手册，不随后续编辑变化 |
| environment.json | 浏览器、样本 SHA-256、发布物指纹、视口和渲染环境 |
| results.json | 编号、步骤、实际值、状态、耗时、证据路径 |
| checkpoint.json | 当前项目、已完成项目、下一步处理方式 |
| 编号-步骤.png / .json | 当步截图和页面状态；错误也保留 |
| events.json / chrome.log | 浏览器异常、网络响应、Chrome 输出 |
| downloads/ | 本轮用户操作下载的文件 |
| report.md | 按步骤编排的最终执行报告 |
状态：passed 仅适用于实际断言；failed 表示执行后不符合预期；blocked 表示条件不足或覆盖不完整。流程中的第一个失败会停止该案例后续依赖步骤，不影响其他独立案例。
安全和限制
- 测试脚本只使用本机发布产物和示例，不修改业务代码或功能验收登记。后续用户授权的修复与增量构建单列于 REPAIR-REPORT.md，不与原始测试记录混淆。
- 清理存储只针对脚本创建的临时测试源和配置；保留测试配置路径供排查，不删除真实用户文件。
- 当前为 Chrome headless 软件 WebGL，不能作为用户 GPU、Firefox/Edge、真实移动设备或性能容量通过证据。
- 原 PDF 在生成时有中文字体缺失告警，不能认定为可靠验收输入；本轮使用保存的 UTF-8 Markdown 快照，PDF 可读性需另行修正。