有用地报告错误的剪切
有用的错误剪切报告解释了失败的原因、失败的位置以及如何重现它。从症状、源格式和尺寸、浏览器和扩展版本、输入法以及首次运行模型设置是否完成开始。
不自动发送私人原件。首先尝试使用无害的替代品或严格裁剪、编辑的示例来重现该问题。支持报告很少需要个人的身份、文档文本、位置或完整的客户资产。
首先判断是质量问题还是故障
“糟糕的剪裁”可能有几种不同的含义：
- 图像无法打开；
- 处理从未开始；
- 处理崩溃或停滞；
- 主题面具移除了重要部分；
- 主题周围保留背景；
- 头发、毛皮、玻璃或薄物体破裂；
- 导出后才出现光晕；
- 下载工作时复制失败；
- 结果在编辑器中看起来正确，但在另一个应用程序中看起来错误。
在第一句中说出类别。 “处理后手柄消失”给了支持一个起点。 “这不起作用”则不起作用。
如果处理完成并且仅边缘需要小的校正，则这可能是正常的细化情况而不是软件故障。包括在使用“添加”或“擦除”画笔之前自动结果执行的操作。
记录最短再现路径
编写这些步骤，就好像另一个人在全新安装时必须遵循这些步骤一样：
- 从工具栏打开扩展。
- 放置尺寸为 2400 × 1600 的本地 JPG。
- 等待处理完成。
- 检查物体手柄内的间隙。 5.下载PNG。
- 观察预览和导出中的间隙是否已填充。
仅使用达到症状所需的步骤。提及更改结果的替代方案，例如“保存为 PNG 时同一文件可以工作”或“下载可以工作，但复制不行”。
对于页面图像问题，包括是否仅通过右键单击路径发生故障以及在本地保存相同图像是否有效。有些网站提供图像的方式会阻止页面工作流程读取图像；该证据将交付限制与模型质量分开。
包含可以改变行为的环境详细信息
一个紧凑的环境块就足够了：
- 扩展版本；
- 浏览器版本；
- 操作系统;
- 如果处理大文件时崩溃，则估算设备内存；
- 模型下载是否完成；
- 源格式、像素尺寸和近似文件大小；
- 输入路径：选择、拖放、粘贴或页面图像；
- 输出路径：下载PNG或复制；
- 重新打开编辑器后问题是否重复。
避免发送完整的系统清单。硬件序列号、帐户名称、网络地址、已安装的应用程序列表和不相关的浏览器历史记录通常会增加风险，而无助于重现边缘缺陷。
从几何角度描述图像
当您无法共享来源时，请描述视觉条件：
- 深色卷发靠在深色墙壁上；
- 明亮背景上的透明玻璃边缘；
- 狭窄的自行车辐条穿过有纹理的街道；
- 灰白色背景下的苍白产品边缘；
- 柔和的地板阴影接触拍摄对象；
- 带压缩块的低分辨率屏幕截图；
- 拍摄对象在画面边缘被部分裁剪。
提及出现错误的位置：左上角边缘、封闭间隙、接触阴影、半透明区域或导出周围的一像素边缘。这个词汇比说模特“不理解照片”更具有可操作性。
尽可能使用安全的替代品
尝试使用可以共享的对象重现相同的视觉问题。如果客户产品缺少手柄，请在类似的背景下拍摄普通杯子的照片。如果私人头发细节失败，请使用假发、刷子、纱线或具有类似边缘结构的植物。
替代品只有在重现症状时才有用。明确指出这是复制品，而不是原件。包括成功和失败条件：
- 低对比度失败，高对比度有效；
- 超过特定图像尺寸时失败，调整大小后有效；
- 通过页面图像操作失败，从保存的文件开始工作；
- 预览正确，导出的 PNG 在指定的本地查看器中显示边缘。
这种比较往往揭示出比原始内容更多的内容。
如果您必须共享图像，请将其最小化
首先获得业主的许可并遵守任何客户或工作场所政策。然后删除调查不需要的所有内容：
- 复制文件，使原始文件保持不变。
- 紧密围绕失败的边缘进行裁剪。
- 如果您批准的工作流程需要元数据，请删除元数据。
- 编辑相关区域外的姓名、屏幕、地址、面孔和识别标记。
- 确认实际导出副本中的密文。
- 仅通过指定的反馈途径分享。
如果文档格式保留图层或隐藏内容，则在文本上绘制黑色可能不够。扁平化、紧密裁剪的光栅副本通常更容易推理，但请遵循组织的规则。
切勿仅仅为了改进错误报告而提交身份证明文件、亲密图像、儿童照片、医疗记录、凭证或机密证据。
在不过度共享的情况下捕获之前和之后
对于边缘质量报告，三种状态的紧密裁剪可以帮助：
- 源边；
- 自动掩模结果；
- 手动优化后的预期结果。
保持裁剪足够大以显示局部对比度和纹理，但又足够小以消除特征和背景。标记每个州。如果屏幕截图包含浏览器选项卡、书签、通知、文件名或帐户头像，请在发送之前将其裁剪掉。
当问题涉及导出时，请在浅色和深色本地背景下检查 PNG。浅色光晕在白色上可能会消失，而在深灰色上仍然很明显。说明缺陷是否存在于编辑器预览、导出的文件中或仅存在于目标应用程序中。
诚实地报告时间和频率
有用的计时是近似的：“进度指示器启动后处理挂起超过两分钟”或“选择文件后立即失败”。不要从一次分心的跑步中报告精确的基准。
状态频率：
- 使用该安全样品的每一次尝试；
- 五次尝试中的两次；
- 一次，重启后不再重现；
- 仅在首次启动时；
- 扩展更新后开始。
一次性事件仍然很重要，但准确地标记它可以使调查保持重点。
不应该包括什么
省略：
- 密码、令牌或帐户凭证；
- 您尚未查看的完整浏览器日志；
- 不相关的个人档案；
- 安全作物重现问题时的原始私人图像；
- 仅基于查看网络活动对服务器上传的假设；
- 在没有证据的情况下对原因进行激进的主张。
首先描述观察结果。 “工作人员错误在这个 30 兆像素的文件上 40 秒后出现”就是证据。 “服务器拒绝了我的照片”是猜测，尤其是当剪切路径设计为在本地运行时。
报告模板
使用这种紧凑的结构：
总结： 一句话命名失败的对象或阶段。
预期： 哪些内容应保持透明、不透明、复制或下载。
观察到： 实际发生了什么以及它出现在哪里。
步骤： 最短的编号复制。
环境： 版本、系统、模型设置状态、源格式和尺寸。
频率： 每次、间歇或一次。
安全示例： 附加复制品、裁剪示例或“无法共享”。
解决方法： 调整大小、重新导出、使用本地文件、手动优化或不进行任何操作。
如果您安装的版本提供了扩展反馈流程，请使用扩展反馈流程。否则，保留报告文本，以便您可以将其粘贴到当前支持路线中，而无需从内存中重建证据。
使报告有用且注重隐私
最有力的报告并不是数据最多的报告。它是可重现示例最小、观察与猜测之间界限最清晰的模型。
如需立即修复，请检查故障排除。在附加任何示例之前，请使用安全测试图像习惯中的习惯。好的报告可以提高剪切质量，而不会将私人内容变成不必要的支持材料。