设置引导（无直接工具）

AI 无响应 / 报错
├── "API key invalid" → 设置 → AI 模型 → 检查对应 Provider 的 Key
├── "model not found" → Provider 的 baseURL 是否正确？自定义模型 ID 是否匹配？
├── 能发送但无回复 → 检查网络 / 代理设置，确认 Provider 服务可达
└── 回复乱码 → 换一个支持中文的模型

邮件/日历不工作
├── 未显示 → 设置中确认已启用对应账户
└── 同步失败 → 账户授权可能过期，重新授权

终端不工作
├── 无法打开 → 检查终端路径设置是否正确（设置 → 基础设置 → 终端）
├── 命令执行失败 → 确认 shell 路径和环境变量配置
└── 显示异常 → 尝试重启终端会话或清除终端缓存

编辑器问题
├── 无法保存 → 检查文件权限和磁盘空间
├── 语法高亮失效 → 确认文件类型识别正确，尝试手动选择语言模式
└── 代码补全不工作 → 确认 AI 模型配置正常，检查网络连接

文件管理器问题
├── 目录不显示 → 检查项目路径设置（设置 → 项目）
├── 文件操作失败 → 确认文件系统权限
└── 搜索无结果 → 确认搜索范围和索引状态

界面问题
├── 语言没切换 → 刷新页面或重启应用（缓存未更新）
├── 主题不生效 → 确认未设为"跟随系统"导致覆盖
└── Widget 加载失败 → 使用 WidgetCheck 查看编译错误