FreeCADWasmDev/docs/current/user-tests-20260915/TEST-REPORT.md

用户手册测试总报告

生成时间：2026-09-15T12:58:29.845Z

手册 21 项：通过 20；失败 1；阻塞/覆盖不足 0；未运行 0。

实际工作台入口 32 个，通过 32 个。不得将路由登记 1452/1452 或独立演示页烟测作为上线验收。

上线结论

当前不具备完整上线放行依据。 登记缺陷 5 个，4 个已通过针对性复测。手册尚未通过：FILE-02 failed。本机性能样本通过不等于生产容量认证，入口可用不代表全部业务命令已经验收。

手册逐项覆盖

编号	项目	状态	依据
UI-01	首次启动	passed	仅限实际执行的步骤和断言 过程
UI-02	文档标签隔离	passed	仅限实际执行的步骤和断言 过程
UI-03	工作台入口	passed	32/32 模块入口通过；入口检查不等于模块业务验收 过程
UI-04	视口交互	passed	仅限实际执行的步骤和断言 过程
GEO-01	Box 参数与重算	passed	仅限实际执行的步骤和断言 过程
GEO-02	参数修改事务	passed	仅限实际执行的步骤和断言 过程
GEO-03	多对象与布尔	passed	仅限实际执行的步骤和断言 过程
GEO-04	选择与删除恢复	passed	仅限实际执行的步骤和断言 过程
FILE-01	STEP 导入	passed	仅限实际执行的步骤和断言 过程
FILE-02	多格式导入	failed	Error: IFC native import is not available: AC14-FZK-Haus.ifc: No native import handler is registered for .ifc 过程
FILE-03	保存与重开	passed	仅限实际执行的步骤和断言 过程
FILE-04	OPFS 刷新恢复	passed	仅限实际执行的步骤和断言 过程
FILE-05	STL 导出回读	passed	仅限实际执行的步骤和断言 过程
DOC-01	属性编辑	passed	仅限实际执行的步骤和断言 过程
DOC-02	分组与层级	passed	仅限实际执行的步骤和断言 过程
DOC-03	链接替换与解除	passed	仅限实际执行的步骤和断言 过程
ERR-01	取消	passed	仅限实际执行的步骤和断言 过程
ERR-02	非法输入	passed	仅限实际执行的步骤和断言 过程
ERR-03	重复请求	passed	仅限实际执行的步骤和断言 过程
PERF-01	大文件加载	passed	仅限实际执行的步骤和断言 过程
PERF-02	长时间稳定性	passed	仅限实际执行的步骤和断言 过程

缺陷与修复复测

UT-001 工作台渲染崩溃 (P1)

当前状态：resolved_by_retest

原始问题：浏览器抛出 ReferenceError: WebMacroDebugTask is not defined；原生模块登记不能使 React 组件自动导入。

1. 打开首页。
2. 点击任一工作台导航，或访问 /workbench.html?module=Part。
3. 观察只有导航而无工作台业务界面，Console 抛出 ReferenceError。

原始证据 1

修复复测 1 修复复测 2 修复复测 3 修复复测 4 修复复测 5 修复复测 6 修复复测 7 修复复测 8 修复复测 9 修复复测 10 修复复测 11 修复复测 12 修复复测 13 修复复测 14 修复复测 15 修复复测 16 修复复测 17 修复复测 18 修复复测 19 修复复测 20 修复复测 21 修复复测 22 修复复测 23 修复复测 24 修复复测 25 修复复测 26 修复复测 27 修复复测 28 修复复测 29 修复复测 30 修复复测 31 修复复测 32 修复复测 33 修复复测 34 修复复测 35 修复复测 36 修复复测 37 修复复测 38 修复复测 39 修复复测 40 修复复测 41 修复复测 42 修复复测 43 修复复测 44 修复复测 45 修复复测 46 修复复测 47 修复复测 48 修复复测 49 修复复测 50 修复复测 51 修复复测 52 修复复测 53 修复复测 54 修复复测 55 修复复测 56 修复复测 57 修复复测 58 修复复测 59 修复复测 60 修复复测 61 修复复测 62 修复复测 63 修复复测 64 修复复测 65 修复复测 66 修复复测 67 修复复测 68 修复复测 69 修复复测 70 修复复测 71 修复复测 72 修复复测 73 修复复测 74 修复复测 75 修复复测 76 修复复测 77 修复复测 78 修复复测 79 修复复测 80 修复复测 81 修复复测 82 修复复测 83 修复复测 84 修复复测 85 修复复测 86 修复复测 87 修复复测 88 修复复测 89 修复复测 90 修复复测 91 修复复测 92 修复复测 93 修复复测 94 修复复测 95 修复复测 96

UT-002 分组创建缺少 Python json 模块 (P1)

当前状态：resolved_by_retest

原始问题：主工作区 Create group 返回 native_view_failed: No module named json。

1. 首页创建 Box。
2. 展开 New Group。
3. 点击 Create group。
4. 记录错误消息以及树中未新增 Group。

原始证据 1

修复复测 1 修复复测 2

UT-003 对象颜色保存重开丢失 (P2)

当前状态：resolved_by_retest

原始问题：颜色编辑为 #cc3344 后保存 FCStd，重开显示默认 #73c6d4；Label 已保留。

1. 创建 Box 并修改 Label。
2. 将 Object Color 改为 #cc3344。
3. 保存 FCStd 到 OPFS。
4. 刷新后从 OPFS 打开，比较 Object Color。

原始证据 1 原始证据 2 原始证据 3 原始证据 4

修复复测 1 修复复测 2 修复复测 3 修复复测 4 修复复测 5

UT-004 窗口宿主初始化协议及原生登记遗漏 (P1)

当前状态：resolved_by_retest

原始问题：工作台能够渲染但窗口命令报 invalid_request / Native view command returned no result。窗口命令被套用几何契约，且原生处理函数未加入标准命令分发表。

1. 打开工作台并等待窗口工具栏初始化。
2. 检查顶部错误提示。
3. 展开面板菜单并切换工具栏锁定。

原始证据 1 原始证据 2 原始证据 3

修复复测 1 修复复测 2 修复复测 3 修复复测 4 修复复测 5 修复复测 6 修复复测 7 修复复测 8 修复复测 9 修复复测 10 修复复测 11 修复复测 12 修复复测 13 修复复测 14 修复复测 15 修复复测 16 修复复测 17 修复复测 18 修复复测 19 修复复测 20 修复复测 21 修复复测 22 修复复测 23 修复复测 24 修复复测 25 修复复测 26 修复复测 27 修复复测 28 修复复测 29 修复复测 30 修复复测 31 修复复测 32 修复复测 33 修复复测 34 修复复测 35 修复复测 36 修复复测 37 修复复测 38 修复复测 39 修复复测 40 修复复测 41 修复复测 42 修复复测 43 修复复测 44 修复复测 45 修复复测 46 修复复测 47 修复复测 48 修复复测 49 修复复测 50 修复复测 51 修复复测 52 修复复测 53 修复复测 54 修复复测 55 修复复测 56 修复复测 57 修复复测 58 修复复测 59 修复复测 60 修复复测 61 修复复测 62 修复复测 63 修复复测 64 修复复测 65 修复复测 66 修复复测 67 修复复测 68 修复复测 69 修复复测 70 修复复测 71 修复复测 72 修复复测 73 修复复测 74 修复复测 75 修复复测 76 修复复测 77 修复复测 78 修复复测 79 修复复测 80 修复复测 81 修复复测 82 修复复测 83 修复复测 84 修复复测 85 修复复测 86 修复复测 87 修复复测 88 修复复测 89 修复复测 90 修复复测 91 修复复测 92 修复复测 93 修复复测 94 修复复测 95 修复复测 96 修复复测 97 修复复测 98 修复复测 99

UT-005 IFC 缺少真实 IfcOpenShell WASM 绑定 (P1)

当前状态：open

原始问题：真实 IFC 样本无法导入；当前 BIM 初始化仅有 declaration-only IfcOpenShell 替身，PartBox 无 IFC 原生导入器。不能将显式报错算作 IFC 支持。

1. 打开 Web / Std_Open。
2. 选择本机 AC14-FZK-Haus.ifc。
3. 检查 file_open_failed 和 No native import handler is registered for .ifc。

原始证据 1 原始证据 2 原始证据 3 原始证据 4 原始证据 5 原始证据 6 原始证据 7

修复复测 1 修复复测 2 修复复测 3 修复复测 4 修复复测 5 修复复测 6 修复复测 7

批次与耗时

• manual-2026-09-15T08-09-15-351Z：52 条案例记录，累计案例耗时 378.1 秒。
• manual-2026-09-15T08-17-01-302Z：14 条案例记录，累计案例耗时 18.7 秒。
• manual-2026-09-15T11-27-34-084Z：6 条案例记录，累计案例耗时 15.1 秒。
• manual-2026-09-15T11-28-15-149Z：38 条案例记录，累计案例耗时 30.2 秒。
• manual-2026-09-15T11-34-24-151Z：39 条案例记录，累计案例耗时 41.0 秒。
• manual-2026-09-15T11-39-57-314Z：2 条案例记录，累计案例耗时 3.2 秒。
• manual-2026-09-15T11-46-55-124Z：3 条案例记录，累计案例耗时 5.0 秒。
• manual-2026-09-15T11-47-41-751Z：40 条案例记录，累计案例耗时 63.8 秒。
• manual-2026-09-15T11-59-56-715Z：4 条案例记录，累计案例耗时 125.5 秒。
• manual-2026-09-15T12-11-58-260Z：2 条案例记录，累计案例耗时 36.5 秒。
• manual-2026-09-15T12-19-47-979Z：5 条案例记录，累计案例耗时 123.1 秒。
• manual-2026-09-15T12-22-44-844Z：3 条案例记录，累计案例耗时 187.9 秒。
• manual-2026-09-15T12-34-56-291Z：3 条案例记录，累计案例耗时 12.0 秒。
• manual-2026-09-15T12-36-05-542Z：1 条案例记录，累计案例耗时 16.6 秒。
• manual-2026-09-15T12-47-40-067Z：3 条案例记录，累计案例耗时 34.2 秒。
• manual-2026-09-15T12-53-49-351Z：9 条案例记录，累计案例耗时 173.2 秒。

解释与限制

• 同一手册项目以最新批次为准，旧失败和复测证据均保留。旧 summary.tsv 不纳入本报告。
• 首批 FILE-03 在关闭完成前点击打开，属于测试时序错误；补充等待后单独复测。
• 首批后段 Chrome GPU 进程退出并报临时空间不足，超时不能直接归为业务缺陷。受影响的入口使用新浏览器复测。
• PERF-02 以最新批次为准：最初仅有 Box 循环，后续扩展为 20 轮真实 STEP 导入、修改、保存、刷新重开及进程 RSS 采样。
• PERF-01 的 small/medium/large 是所提供桌面示例的相对分级，最大约 577 KiB；帧回调频率不是 CAD 绘制帧率。本轮不证明更大生产模型的性能。
• 软件 WebGL、单一 Chrome 测试，不代表 Edge/Firefox/移动设备兼容。
• command-coverage.csv 列出 1452 条登记命令，单命令验收仍为 not_individually_tested；不从入口检查推导业务通过。
• 原 PDF 中文字体异常，本次严格使用每批 manual-snapshot.md；不沿用 PDF 已可交付的早期错误结论。

后续顺序

1. 按缺陷状态处理仍开放的问题；已修复问题保留原始失败和复测证据。
2. 正式构建必须通过严格 TypeScript 检查；检查 repair-checks-*/results.json 中的当前记录。
3. 对失败入口及其依赖的文件、链接、结构命令补做真实业务测试；不需要重跑无关已通过项。
4. 补充真实分级样本和浏览器/硬件矩阵，再进行性能及上线签署。