2026-05-20-11-34-57 完善软著说明书截图与代码汇总

工程分析/经验记录.md

@@ -1171,3 +1171,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 示例素材、专利素材、软著素材只能作为文档或手动导入资源使用，不能命名为“最佳”“推荐”等产品级默认值。今后新增默认位姿或默认参数时，应同时检查前端默认列表、后端状态归一化和项目加载优先级，避免文档素材污染运行时逻辑。
+
+## 2026-05-20-11-34-57 软著截图自动化要兼顾 WebGL 渲染环境
+
+A. 具体问题
+
+为软著说明书插入真实系统截图时，普通 Chrome Headless 能正常截取登录、概况和项目库界面，但进入逆向工作区后页面空白，导致逆向工作区和导出选项截图不可用。
+
+B. 产生问题原因
+
+逆向工作区包含 Three.js 三维融合视图，普通 headless 环境中 WebGL 上下文创建失败，React 渲染链路被三维视图错误打断，最终截图只得到空白页面。
+
+C. 解决问题方案
+
+截图脚本在进入逆向工作区时改用 Chrome 软件 WebGL 参数，包括 `--enable-unsafe-swiftshader`、`--use-gl=angle` 和 `--use-angle=swiftshader`，等待页面稳定后重新截取逆向工作区与导出面板。生成 Word 时解析 Markdown 图片语法，并将 8 张 PNG 以嵌入媒体的形式写入说明书 `.docx`。
+
+D. 后续如何避免问题
+
+凡是为含三维场景的页面生成截图或录屏，都应优先验证截图不是空白，并检查浏览器控制台是否有 WebGL 创建失败信息。自动化截图应准备软件渲染兜底；Word 交付前必须用 `unzip -l` 检查 `word/media/` 是否包含预期图片。