# 诊断与崩溃日志

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：数据与同步。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/diagnostics/

## 什么时候使用

遇到闪退、冻屏或难以复现的异常时，打开 **设置 → 连接与高级 → 诊断与崩溃日志**，查看已记录的故障报告及应用运行日志。

## 采集运行日志

日志采集默认关闭。需要排查时，先开启页面中的日志采集开关，再回到出问题的页面复现。默认采集警告与错误；需要更多线索时可开启详细日志，包含 INFO / DEBUG。反馈云盘备份、同步类问题时请先开启详细日志再复现，否则报告里看不到备份流程的过程记录。采集在 15 分钟窗口内会跨页面、跨重启自动续采，不必每次重新开启。采集会在 15 分钟后自动停止，重启应用后保持关闭。

运行日志只保留最近约 2 MiB。页面预览展示末尾内容，导出包含当前保留的完整日志；需要时也可清理运行日志。

分享或导出的报告还包含 **内存水位**：应用在启动、前后台切换、打开对话、系统内存告警时以及运行期间每 10 分钟记录一次内存占用，保留最近 240 条，闪退或重启后仍在，便于判断闪退前内存是否持续上涨。它不受日志采集开关影响，只记录内存数值、同时生成的回复数和浏览器标签数，不包含对话内容。

## 如何反馈

1. 复现后返回诊断页面，刷新查看最新记录。
2. 使用 **分享报告**，或选择 **导出** 保存 TXT 文件。按需要选择是否包含故障详情。
3. 打开 **设置 → 反馈与建议**，在新工单或补充消息中添加 TXT 日志附件。
4. 同时说明发生时间、操作步骤、是否可以稳定复现，便于对照日志定位。

反馈支持 1 个不超过 5 MiB 的 UTF-8 TXT 文件。选择附件不会立即上传，提交或发送时才会上传。日志可能包含运行过程中的信息，发送前请检查内容，避免附上密钥或其他不希望分享的信息。没有故障报告不代表没有发生问题，也可以提供运行日志和复现步骤。