出现异常时不要先删除数据
- 不要删除笔记目录、
assets、.trash或云端目录。 - 不要在没有备份时重置同步状态。
- 不要反复覆盖安装不同版本来碰运气。
一、通用排查顺序
- 保存能保存的笔记，暂停自动同步。
- 在设置中记下笔记目录和软件版本。
- 退出 NexaNote，复制整个笔记目录作为备份。
- 重新打开并只复现一次，记录每一步和完整错误文字。
- 判断问题属于本地文件、索引、AI 网络还是云同步，再阅读对应章节。
二、无法启动、白屏或界面卡住
双击后没有窗口
在任务管理器结束残留的 NexaNote 进程，重启 Windows 后再试。确认安全软件没有隔离程序，并核对安装包来源。
窗口打开但长时间白屏
等待一分钟后正常关闭并重启。若每次都发生，记录是否刚更换目录、导入大量文件或升级版本，并提交截图和版本信息。
界面很慢
暂停同步和 AI 批量任务，关闭超大笔记，检查笔记目录是否位于速度很慢或断连的磁盘。大量导入完成后重建索引并重启。
三、保存失败、笔记消失或目录不对
- 确认设置中的笔记目录存在且当前 Windows 账号有写入权限。
- 检查磁盘空间、移动磁盘或网络盘是否仍在线。
- 在资源管理器中直接查看 Markdown 文件是否存在。
- 如果刚更换目录，旧笔记可能仍在旧位置；切勿把“看不到”误判为“已删除”。
- 标题栏黄色圆点一直不消失时，再次保存并记录提示。
四、列表或搜索缺少笔记
- 确认文件在当前笔记目录内且扩展名为
.md。 - 点击工作台的“重建智能索引”。
- 等待扫描完成，再使用标题中的明确关键词搜索。
- 仍缺失时重启 NexaNote，并检查文件是否在
.trash中。
五、图片或附件无法显示、打开、定位
- 检查对应
assets文件是否真实存在。 - 如果只复制了 Markdown，重新从备份或另一台设备补回附件目录。
- 文件被外部改名后，正文引用可能失效；优先恢复原文件名。
- 附件存在但打不开时，确认 Windows 有对应文件类型的默认程序。
- 同步场景还要检查日志中的 assets 上传和下载记录。
六、今日笔记不正确
- 检查 Windows 日期、时间和时区。
- 在
Daily文件夹查找当天日期对应文件。 - 检查回收站中是否有当天同名笔记。
- 如果曾删除同名日记，先恢复需要的内容或永久删除冲突项，再重启软件。
七、AI 与同步问题
AI 报错请按AI 常见错误检查密钥、地址、模型和网络。同步异常时立即暂停自动监听，备份每台设备的笔记目录，再按同步错误检查顺序处理。同步问题不要通过删除云端目录或反复重置来试错。
八、提交一份可定位的反馈
- NexaNote 版本和 Windows 版本。
- 问题发生前后逐步操作，不要只写“不能用”。
- 完整错误文字、截图或同步日志。
- 笔记目录类型：本地磁盘、移动磁盘、NAS 或云盘目录。
- 问题是否稳定复现，以及重启后是否仍存在。
发送前遮盖 API Key、密码、Client Secret、SecretKey、Token、邮箱、私人路径和笔记正文。准备好后前往联系技术支持。