Bug 报告附件 / Bug Report Attachments
附件提供视觉证据和技术细节,使 Bug 报告更具可信度和可操作性。
Attachments provide visual evidence and technical details that make bug reports more credible and actionable.
附件要求 / Attachment Requirements
| 附件类型 | 何时使用 | 格式 |
|---|
| 截图 | 视觉问题、错误消息、UI 状态 | PNG / JPG |
| 录屏 | 复杂复现、动画问题 | MP4 / GIF |
| 控制台日志 | JavaScript 错误、API 失败 | 文本 / 截图 |
| 崩溃日志 | 移动端/流媒体设备崩溃 | 文本文件 |
| 网络日志 | API 请求/响应问题 | HAR 截图 |
截图最佳实践 / Screenshot Best Practices
1. 可裁剪但保留上下文
2. 用箭头或方框标注问题
3. 布局问题截取全页
4. 相关时包含浏览器开发者工具
5. 使用时间戳
录屏最佳实践 / Screen Recording Best Practices
1. 保持简短(30 秒以内)
2. 展示从开始到 Bug 出现的完整过程
3. 包含鼠标点击以便看到操作
4. 如有需要可配合语音说明
常见驳回原因 / Common Rejection Reasons
- 截图未清晰显示 Bug
- JS 错误缺少控制台日志
- 视频质量太低无法看清文字
- API 相关问题缺少网络日志