诊断与日志
Mindwtr 内置诊断日志，可帮助排查同步和崩溃问题。日志仅保存在本地，敏感值会在写入前脱敏。
使用示例数据录屏
选择设置 → 数据 → 打开沙盒，即可使用虚构的任务和项目体验 Mindwtr。界面会持续显示沙盒横幅，提供重置示例数据和退出操作。移动端使用简短的沙盒、重置和退出文字。
该选项位于诊断设置附近。进入前会显示确认提示，说明沙盒用途；选择取消即可留在个人工作区。
示例工作区包含不同状态的任务、领域、项目与分区、重复任务、清单、备注、标签、情境、联系人，以及日期和优先级示例。你可以在录屏时编辑这些示例。修改是临时的，重置会重新载入初始示例数据。
在 v1.3.2 之后的构建中，沙盒设置还允许临时修改任务编辑器、显示及日期时间偏好。桌面端包括编辑器打开方式；移动端包括编辑器布局预设。退出沙盒后这些设置会被丢弃。沙盒中无法使用同步、集成和设备控制。
示例内容支持英语、德语、法语、西班牙语、俄语和简体中文。应用使用任一中文语言时，示例均为简体中文；其他不支持的语言使用英语示例。
个人数据库会单独保留。退出沙盒会返回个人工作区；沙盒打开后重启应用，也会返回个人工作区。进入前会等待正在进行的同步和本地写入完成，切换期间会阻止应用发起新的同步。如果等待超时或保存失败，你会留在个人工作区。沙盒中的修改不会同步，也不会更新小组件、手表、提醒、外部日历或收集集成。
如果问题与某些具体任务、附件或同步历史有关，示例数据可能无法重现。分享前请检查录屏：沙盒不会隐藏操作系统通知或其他应用。
启用调试日志
桌面端
- 打开设置 → 数据
- 开启调试日志
- 重现问题
发布版诊断构建：只有在桌面应用使用 diagnostics feature 构建时，开发者工具和额外日志才可用。
cd apps/desktop
cargo tauri build --features diagnostics
MINDWTR_DIAGNOSTICS=1 ./src-tauri/target/release/mindwtr移动端
- 打开设置 → 数据
- 开启调试日志
- 重现问题
分享或清除日志
桌面端
- 在设置 → 数据 → 诊断中使用保存日志保存一份日志副本，然后附上该文件（v1.3.2 及以上版本）
- 日志文件路径显示在同一界面；旧版本请附上该路径下的文件
- 可在同一界面清除日志
移动端
- 使用分享日志导出日志文件
- 使用清除日志删除旧记录
默认日志位置（桌面端）
| 平台 | 日志文件 |
|---|---|
| Linux | ~/.local/share/mindwtr/logs/mindwtr.log |
| Windows | %APPDATA%/mindwtr/data/logs/mindwtr.log |
| Windows (Microsoft Store) | %LOCALAPPDATA%/Packages/<package>/LocalCache/Roaming/mindwtr/data/logs/mindwtr.log |
| macOS | ~/Library/Application Support/mindwtr/data/logs/mindwtr.log |
表中的 Windows 和 macOS 行适用于 v1.3.2 及更新版本。v1.3.2 之前，logs 目录直接放在 mindwtr 目录里，例如 %APPDATA%/mindwtr/logs/mindwtr.log。Linux 没有变化。
记录哪些内容
- 同步错误和步骤
- 冲突摘要：即使调试日志关闭，已成功解决冲突的合并也始终写入
mindwtr.log，便于事后审计解决结果。这些常驻记录包含记录 ID、更改过的字段名和最终采用的一方，但绝不会写入记录内容（标题、备注）。 - 意外的运行时错误
在移动端，致命 JavaScript 错误可能留下一份本地崩溃记录（最多 16 KiB），即使调试日志关闭也会尝试保存。记录包含时间、应用及构建版本、平台、可识别的技术错误信息和有限的调用栈；无法识别的错误消息会出于隐私考虑省略。下次成功启动时，记录会加入日志。可通过 分享日志，或在发送反馈时明确选择附带诊断信息来分享；不会自动上传。清除日志 也会删除保留的崩溃记录。捕获并非必定成功，无法涵盖原生崩溃、系统终止或错误处理器启动前的故障。
敏感值（API 密钥、令牌、密码、包含凭据的 URL）会自动脱敏。