mindppt遇到bug时，应优先通过“帮助→反馈”提交带日志的报告；若不可用则发结构化邮件至xmind-2024@xmind.app；还可清除cache缓存、切换网络刷新授权、或用安全模式排查干扰。
如果您在使用 MindPPT 过程中遇到功能异常、界面卡顿、生成失败或闪退等 Bug，问题可能源于本地缓存冲突、授权验证中断、模板解析错误或AI服务临时响应延迟。以下是处理此类问题的具体操作路径：
AI一键生成成品PPT☜☜☜☜☜点击生成；
一、通过内置“反馈”入口提交详细信息
该方式可自动附带运行日志与环境快照，是官方优先处理的通道。系统将采集当前会话的软件版本、操作系统标识、内存占用峰值及最近三分钟的操作行为序列。
1、启动 MindPPT 后，点击左上角“帮助”菜单。
2、选择“反馈”选项，弹出标准化表单窗口。
3、在“问题类型”下拉框中选择Bug 报告，勿选“建议”或“咨询”。
4、在描述框内分段填写：复现步骤（精确到每一步点击位置）、预期结果、实际结果、是否每次必现。
5、勾选“包含诊断数据”与“上传最近一次生成失败的源文件（如已保存）”，点击“提交”。
二、发送结构化邮件至专属客服邮箱
适用于无法启动软件、反馈入口无响应或需附带敏感截图/录屏的情形。邮件标题格式直接影响工单分派优先级，必须严格遵循命名规则。
1、新建邮件，收件人填写：xmind-2024@xmind.app（MindPPT 当前统一客服邮箱）。
2、标题按顺序拼接：【Bug】【v1.0.0】【Win11_23H2】+ 8字以内现象关键词（例：【Bug】【v1.0.0】【Win11_23H2】导出PDF空白）。
3、正文中逐项列出：操作系统全称及版本号、设备内存容量、MindPPT 安装方式（官网EXE/应用宝APK）、问题首次出现时间（精确到小时）。
4、将报错界面截图保存为 PNG 格式，直接拖入邮件正文；若含多张，按“1_错误提示、2_状态栏、3_任务管理器内存占用”编号命名。
三、清除本地运行环境后重试
此操作可排除因缓存损坏、临时授权密钥失效或GPU渲染层异常导致的偶发性 Bug，不删除用户账号、历史记录及已保存的PPT文件。
1、关闭 MindPPT 所有进程，包括后台托盘图标。
2、在文件管理器中定位缓存目录：Windows：C:\Users\[用户名]\AppData\Local\MindPPT\Cache；Android：内部存储/Android/data/cn.mindppt/files/cache。
3、选中 Cache 文件夹内全部内容，按 Shift + Delete 永久删除。
4、重新启动 MindPPT，首次加载时右下角将显示“正在重建本地索引…”，等待进度条完成后再执行原操作验证。
四、切换网络环境并强制刷新授权状态
部分 Bug（如AI生成中途终止、模板库加载为空）由CDN节点故障或授权服务器心跳超时引发，更换网络出口可绕过区域性服务中断。
1、断开当前 Wi-Fi 或移动数据，启用手机热点或切换至另一宽带网络。
2、打开 MindPPT，进入“我的→账户中心”，下拉至页面底部。
3、点击“手动刷新授权”按钮，界面显示“授权状态：已激活（2026-04-15 01:03:17）”即表示同步成功。
4、返回首页，尝试重新生成一页新幻灯片，观察是否仍触发相同异常。
五、使用安全模式启动以隔离干扰组件
当 Bug 仅在特定操作路径下出现（如添加图表后崩溃），可能由第三方字体注入、系统级屏幕录制工具或杀毒软件实时扫描引发，安全模式将禁用所有非核心模块。
1、Windows 用户：按 Win + R 输入 mindppt.exe --safe，回车启动；Android 用户：长按桌面图标 → “应用信息” → “强行停止” → 开启“开发者选项” → 启用“停用插件加载”。
2、在安全模式界面中，仅执行引发 Bug 的最小操作集（例如：新建一页 → 粘贴一段文字 → 点击“AI优化”）。
3、若该路径下无异常，则退出安全模式，在常规模式中依次关闭近期安装的输入法、录屏、剪贴板增强类应用。
