反馈与诊断
回留提供完整的反馈和诊断工具,帮助你快速定位问题并向开发团队提供有效信息。
反馈入口
路径：我的 -> 反馈建议
反馈页面支持：
- 填写反馈内容
- 附加截图
- 选择性附带运行日志和结构化诊断摘要
- 留下联系方式（可选）
诊断排障
路径：我的 -> 诊断排障
诊断排障提供两种模式：
关闭排查（推荐日常使用）
- 不额外记录诊断信息
- 不会自动上传日志
- 适合日常正常使用
开启排查
- 记录关键阶段信息
- 确认授权后，应用发生崩溃、卡死、ANR 或异常退出时，会在下次启动自动提交脱敏诊断反馈
- 问题发生时会先在应用私有目录保存一份白名单现场快照，后台上传时优先使用这份快照
- 自动反馈可能包含：
- 诊断摘要
- 设备环境、权限状态和关键功能设置
- 崩溃日志
- 运行日志
- 系统退出 Trace
- 主线程栈采样
- 上次会话尾部日志
- 现场快照只保留最近一段时间，上传成功或关闭自动诊断后会清理
注意
开启排查需要明确授权。旧版本已开启的"帮助排查"会重置为关闭状态，需要重新手动开启并确认。
运行日志
在反馈页可以选择附带运行日志。进入页面不会自动准备运行日志，只有主动勾选后才生成附件。运行日志会记录：
- 关键功能流程
- 错误和异常
- 性能相关事件
开启运行日志后：
- 日志会保存在本地
- 未确认自动上传时，需要在反馈页手动附带
- 日志内容会自动脱敏处理
问题反馈默认附带白名单诊断摘要，功能建议和其他反馈默认不附带。诊断摘要只包含设备环境、权限状态、关键行为设置和运行状态，不会遍历或上传完整设置文件；所有附件都可以在提交前关闭。
如何有效反馈问题
建议按以下方式提交反馈：
描述问题：
- 说明在什么页面、做什么操作时出现问题
- 描述期望的行为和实际的行为
- 如果能复现，写明复现步骤
附加截图：
- 错误提示
- 异常界面
- 相关设置页面
开启运行日志：
- 对于崩溃、卡死、功能异常等问题特别重要
- 可以帮助开发团队快速定位原因
留下联系方式（可选）：
- 方便开发团队在需要时进一步沟通
- 获取问题进展和解决方案
诊断信息说明
诊断日志会自动脱敏，不会包含：
- 联系方式原文
- 反馈正文原文
- 支付订单串或 token
- 设备唯一标识
- 完整本地路径
- 原始 Uri
- 文件名、文件夹名、标签、备注和搜索词
- 剪贴板内容
诊断信息主要用于：
- 定位崩溃原因
- 分析性能问题
- 理解功能异常的上下文
- 改进应用稳定性
重新查看引导
路径：我的 -> 服务与支持 -> 重新查看引导与提示
这个功能会重新展示：
- 首次引导
- 整理页提示
- 文件夹筛选说明卡
- 日期筛选说明卡
- 回收站说明
- 对比页说明
适合在忘记某个功能用法时使用。
常见问题排查顺序
遇到问题时建议按以下顺序排查：
媒体库相关问题（灰底、数量不对、显示异常）：
- 进入
我的 -> 设置 -> 媒体库维护 - 先执行「刷新媒体库」
- 仍有异常时执行「修复媒体索引」
- 进入
相似检测结果异常：
- 检查是否开启相似照片检测
- 尝试调整相似度阈值
- 执行「重建相似检测数据」
会员恢复问题：
- 确认支付是否成功
- 使用订单号恢复功能
- 仍不正常时保留订单号并提交反馈
其他功能问题：
- 开启诊断排障
- 复现问题
- 提交反馈并附带运行日志