PhotoCraft 编辑器空白与渲染问题排查

先确定故障发生在哪一步

编辑器空白可能来自文件未下载完成、图形后端初始化失败、画布不在当前可见区域，或特定文档耗尽资源。外围页面正常显示，WebAssembly 应用也可能未启动。先记录观察到的情况，不要重复刷新并假设所有空白都由同一原因造成。

本指南针对本站未经修改的 PhotoCraft v0.12.0，只提供排查顺序，不是性能测试。我们没有发布统一启动时限、文件大小上限，也不保证每种渲染方式适用所有显卡驱动。已有截图与流程测试使用 Chromium，真实硬件和其他浏览器可能不同。

编辑器仍有响应时先保存

文档可见、菜单可操作时，先下载工作版本及参考 PNG，确认文件已在磁盘上，再修改环境。切换渲染器会重启编辑器，刷新也可能丢失未保存修改。提醒不是自动保存。不确定该保留哪些文件时，先看备份流程。

已经无响应时，保留完成的下载，记下最后一步。本站没有服务器文档副本。不要把清除网站数据当作第一步，它可能移除偏好与诊断线索，却不能恢复文档。先厘清已保存内容，再用小样例测试启动。

区分网页加载与编辑器启动

滚动到编辑器，确认其菜单与画布是否出现。外层标题和“打开编辑器”按钮只是网站控件，不能证明应用初始化成功。大屏幕上可能只是尚未滚到画布，小屏幕上则可能是面板挤占工作区域。

必要时用外围按钮另开编辑器标签，以区分嵌入布局与应用启动问题。记住原会话在哪个标签，新标签不会携带未保存内容。一种视图正常、另一种异常时，应记录具体网址和屏幕尺寸，而不只写“PhotoCraft 坏了”。

检查编辑器文件的加载请求

在浏览器开发者工具 Network 中复现，观察 /vendor/photocraft/0.12.0/ 下的 HTML、JavaScript 与 WebAssembly 请求。记录失败请求、状态码及 Console 信息。WASM 未下载成功与下载后图形初始化失败，需要不同处理，也应同时记录浏览器版本。

扩展、网络过滤和临时连接问题都可能阻止加载。可用干净配置或隐私窗口作对照，但这会创建新会话。不要全局关闭安全软件或绕过证书错误；应记录被拦截的文件及错误。

每次只更换一种渲染方式

保存后，依次尝试网站提供的 WebGL2、CPU 画布或默认方式，每次只改一项，等新实例启动，再用同一小样例做同一操作。同时换文件、浏览器和渲染器，会失去定位原因所需的对照。

CPU 画布是排错选项，不保证更快或更兼容；选择图形模式也不证明用了硬件加速。自动 Chromium 测试可能使用软件图形。记录请求的模式与应用实际报告的后端，不要把这种环境推导为用户手机或电脑的速度结论。

使用已知的小文件测试

下载320 × 320 合成 PNG，按完整教程打开、画明显标记并导出。成功只说明本次启动与简单编辑路径有效，可以缩小范围，但不能证明原文档兼容。

样例正常而原文件失败时，记录原格式、尺寸、大小和相关功能。用副本制作更小且不含机密内容的复现。大文档受设备与浏览器内存限制，PSB 格式支持不等于能在标签页中处理任意大文件；本站未测得通用安全容量。

区分导入、编辑与输出问题

观察	记录什么	下一项对照
没有应用画布	请求失败与启动日志	干净浏览器配置及另一渲染器
样例正常，原文件失败	格式、尺寸和功能	更小的脱敏复现
图片打开但画不出笔画	工具、文档和焦点	已知 PNG 流程
导出好像没变化	文件名及参考图	明显修改后的新导出
PSD 重开后不同	保存文件、参考图及结构要求	保存重开检查流程

在编辑器外查看输出，可以区分显示问题与真实导出变化。如果成图正确但画布异常，两种证据都应保留；若输出也错误，则保留最小输入和确切步骤。PSD 指南解释为什么外观与可编辑结构需要分别观察。

收集证据时保护隐私

有用的报告包括网址、编辑器版本、操作系统、浏览器、渲染器和操作顺序，并分开写预期与实际结果。截图应展示相关状态，但移除私人标签页、账号信息、文件名及客户素材。能用合成样例复现时，不必提供原件。

Network 导出和日志也可能包含浏览信息，分享前应移除凭据及无关请求。本站直接加载 GA4、Plausible 统计访问，这些请求与文档处理不同。不能把每个请求都称为图片上传，也不能由本地处理推断浏览过程没有托管元数据。

决定继续排查还是更换工具

保存文件能重开、小样例也正常时，可以逐步回到任务，并在重要操作前后保存。必要功能仍失败时，应保留原件，改用已经验证的工具满足需求。反复把失败文档送入同一路径，不能替代结果检查。

上游软件报告见社区指南，本站链接或文案错误见联系页面。请包含尝试过的操作，包括无效的渲染器切换；无法验证的部分也要明说。准确复现比猜测诊断更有助于下一步调查。