日志
控制日志级别、文件持久化、轮转大小和保留时间。
日志用于排查应用、运行环境、任务和平台问题。日常使用建议保留默认的“信息”级别，只在能够稳定复现问题时临时提高详细程度。
内存日志与文件日志
应用始终保留一个有容量限制的本次运行日志缓冲区，诊断包会把它导出为 session.log。关闭“保存日志到文件”只停止磁盘持久化，不会让本次运行的诊断日志消失。
开启文件持久化后，日志写入应用数据目录的 logs 文件夹：
- 当前文件为
hanafubuki.log； - 达到大小上限后，旧文件改为带 UTC 时间戳的名称，新文件继续记录；
- 超过保留天数的历史
.log文件会被清理； - 当前活动日志、目录和符号链接不会被保留策略删除。
字段说明
| 设置 | 范围或行为 |
|---|---|
| 保存日志到文件 | 控制是否把日志持久化到磁盘 |
| 日志文件大小上限 | 1–512 MB；达到上限后轮转 |
| 日志保留天数 | 1–365 天；清理过期历史日志 |
| 日志级别 | 跟踪、调试、信息、警告、错误或关闭 |
数字字段在按 Enter 或离开输入框时保存。关闭文件持久化后，大小上限不可编辑；保留天数仍用于处理磁盘中已经存在的历史日志。
选择日志级别
| 级别 | 建议用途 |
|---|---|
| 信息 | 日常使用，保留关键阶段与错误 |
| 调试 | 排查流程和状态变化 |
| 跟踪 | 短时间复现最难定位的问题，包含最详细内容 |
| 警告 | 只关注异常和潜在问题 |
| 错误 | 只记录失败 |
| 关闭 | 不输出普通日志，不适合排查问题 |
跟踪日志可能包含更多本地内容
trace 可能记录经过长度限制的 Agent
请求、推理或工具内容，以及路径、环境和命令信息。仅在明确需要时短时间开启；复现完成后恢复“信息”，并在分享日志或诊断包前检查敏感内容。
推荐排查流程
先用默认“信息”级别复现，并查看任务中心中的直接错误。
信息不足时切换到“调试”；只有仍无法定位时才使用“跟踪”。
清晰记录复现时间和操作，问题出现后立即生成诊断包。
恢复原日志级别，避免持续增加磁盘使用和敏感内容范围。