如何报告问题

清晰的问题报告可以减少来回确认时间。发送前请先保存工作文件副本，并尽量把问题缩小到最少步骤。

提交前

完整退出并重新启动 Blender。
在空白文件中重复相同操作。
记录问题是否只发生在某个文件、对象或工作区。
禁用其他第三方扩展并重启，进行一次对照测试。
如有必要，再禁用 BFJ 并重启，用相同文件和步骤复测。

正确理解禁用对照

如果禁用 BFJ 后问题消失，说明问题更可能与 BFJ 或 BFJ 与其他扩展的交互有关；这并不能证明“不是 BFJ 的问题”。如果禁用后仍然发生，则应继续检查 Blender、驱动、文件和其他扩展。

必需信息

请在报告中填写：

BFJ 版本：
Blender 版本：完整版本号，而不只是“最新版”；
操作系统：Windows 版本或 macOS 版本；
硬件：CPU、GPU、内存；渲染问题还应填写驱动和 Cycles 后端；
问题现象：实际发生了什么；
预期结果：你原本期望什么；
最短复现步骤：从打开文件开始逐步编号；
复现频率：每次、偶尔，或只发生过一次；
空白文件是否复现：
禁用其他扩展后是否复现：
禁用 BFJ 后是否复现：
错误信息或日志：

推荐模板

text

标题：

BFJ 版本：
Blender 版本：
操作系统：
CPU / GPU / 内存：
显卡驱动与 Cycles 后端（如相关）：

预期结果：
实际结果：

最短复现步骤：
1.
2.
3.

复现频率：
空白文件是否复现：
禁用其他第三方扩展后是否复现：
禁用 BFJ 后是否复现：

错误信息 / 日志：
附件：

录屏与截图

录屏应从执行问题步骤之前开始，并显示鼠标操作和关键界面。
截图应包含完整错误信息，不要只截取标题。
如果弹窗文字可以复制，请同时粘贴原文，便于搜索。
不要仅发送“闪退了”或“不能用”的视频而不提供版本和步骤。

日志与错误信息

如果 Blender 闪退或操作无响应：

从终端或命令提示符启动 Blender；
重复最短复现步骤；
保存从操作开始到错误发生后的控制台输出；
保留 Python traceback 的开头、结尾和完整调用栈；
不要只发送日志最后一行。

日志可能包含用户名、文件路径或项目名称。发送前请检查并移除不必要的敏感信息，但不要改写错误内容。

制作最小复现文件

对于只在特定文件或对象中出现的问题：

另存一份副本；
删除与问题无关的对象、集合、材质、图片和动画；
每删除一批内容就复测一次；
保留能够稳定复现问题的最小数据；
在报告中说明打开文件后需要执行的具体步骤。

发送前检查隐私

.blend 文件可能打包纹理、客户名称、项目路径或其他商业数据。只发送已获授权、已经最小化并检查过的文件。不要上传唯一的生产文件。

选择反馈渠道

通过购买、授权或交付页面提供的 BFJ 官方支持渠道提交报告。若排查结果明确指向 Blender、显卡驱动或第三方 GoB/GoZ 工具，也请保留同一份复现资料，并按对应项目的反馈规则提交。