功能說明
适用范围
- 版本：Viozi 1.0（依据截至 2026-10-31 的源码整理，后续版本界面可能变化）。
- 平台：iPhone、iPad、Mac。Apple TV 的「设置」里没有诊断入口，Apple TV 上的问题请在 iPhone 或 Mac 上用文字描述后反馈。
准备工作
- 能上网。上传需要连接作者的服务器。
- 尽量先把问题再复现一次，再立即上传，这样日志里会有刚发生的记录。
- 想好一句话描述：在哪个媒体源、做了什么操作、看到了什么现象、大约几点发生。不要写密码、账号或服务器地址。
入口
- iPhone / iPad：底部「设置」→ 列表最下方「关于」分组 →「诊断报告」。
- Mac：「设置」→「关于」→「诊断日志…」，会打开一个诊断窗口，窗口右上角有「发送给作者」和「导出日志」。
步骤（iPhone / iPad）
- 打开「诊断报告」。如果 Viozi 之前崩溃或卡顿过，列表里会有系统留下的报告，标有日期和大小；没有时显示「暂无诊断报告」。
- 点右上角「发送给作者」。
- 在「附件（可选）」里选择要带上的内容：
- 「诊断报告」：本机保存的崩溃 / 卡顿报告。没有报告时这个开关不能打开。
- 「日志」：Viozi 的运行日志。上传时只带最近的一段。
- 在「需求或建议」里写下问题描述。
- 阅读按钮下方的说明：内容会上传到作者的服务器，只用来排查问题，30 天后删除。同意后点「上传给作者」。
- 依次显示「正在打包…」「正在上传 …%」「正在确认…」。
- 成功后显示「已上传给作者」和一个编号。点「复制编号」。
预期结果
- 你得到一个报告编号。在 palveni.com 留言板或邮件里反馈时附上这个编号，作者就能找到这份报告。
- 报告在作者的服务器上保存 30 天。
可选项与差异
- 正式版（App Store）与测试版（TestFlight）：
- 正式版的「诊断报告」页面没有「导出日志」这一行，日志只能通过「上传给作者」附带最近一段。
- 测试版多一行「导出日志」，可以把完整日志通过分享面板（隔空投送、邮件、存储到「文件」）交给作者。
- 改用邮件发送：上传面板里的「改用邮件发送」会打开系统邮件，收件地址在 App 里显示。正式版的邮件只附诊断报告，不附日志。设备没有设置邮件账户时会提示「无法发送邮件」，这时请改用上传。
- Mac：诊断窗口里的「导出日志」会在访达中显示日志文件，你可以自己决定要不要发出去。窗口还显示内存、CPU、缓存占用和最近 30 天的崩溃次数。
- 只写文字也可以上传：不选任何附件、只填写「需求或建议」也能提交。
限制
- 打包后不能超过 8 MB。
- 每台设备每天的上传次数有限（目前默认 5 次），用完后要等到 App 提示的时间之后才能再传。
- 上传服务暂时不可用时，App 会提示，不会传出任何内容。
- 上传的是你选中的内容。日志会去掉常见的敏感信息，但仍请不要在描述里写密码、令牌或私有地址。
出现问题时
- 上传失败：见 诊断报告上传失败。
- 应用打不开、闪退或卡住：见 闪退、卡住或进入安全模式时怎么办。
- 找不到报告或日志：见 找不到诊断报告或日志。