Freeplane项目：文件损坏问题分析与解决方案

问题现象

近期有用户报告Freeplane软件出现异常行为，主要表现为：

1. 软件启动后无法正确加载原有的思维导图文件
2. 所有文件节点显示为品红色，而非原有的格式和颜色
3. 分支结构、云状标注和节点着色等样式信息丢失
4. 仅保留根节点内容，其他格式化信息全部消失

该问题影响多个Freeplane版本（1.11.14至1.12.4u1），且重新安装软件无法解决。用户环境为Windows 11 Pro 23H2系统，使用Java 8 Update 421。

问题根源分析

经过技术团队深入调查，发现问题由两个独立因素共同导致：

1. 聚光灯功能默认启用：用户在"首选项->外观"中启用了"默认激活聚光灯"选项，该功能会高亮显示当前选中节点，导致其他节点显示异常。

2. 节点内容格式问题：部分节点内容以等号"="开头（如="Thank you"），Freeplane会尝试将其解释为Groovy脚本代码，但由于不是有效的Groovy语法，导致解析异常。

解决方案

方法一：修改聚光灯设置

1. 关闭所有Freeplane实例
2. 打开Freeplane软件
3. 导航至"首选项->外观"
4. 取消勾选"默认激活聚光灯"选项
5. 重启Freeplane

方法二：重置配置文件（全面解决方案）

1. 关闭所有Freeplane实例
2. 备份配置文件目录（位于用户AppData/Roaming/Freeplane/1.12.x）
3. 删除以下目录和文件：
   • auto.properties文件内容（保留空文件）
   • scripts/init目录
   • compiledscripts目录
   • addons目录
   • resources目录
4. 重新启动Freeplane 1.12.4u1
5. 通过"文件->打开思维导图"菜单逐一检查文件恢复情况

预防措施

1. 定期备份：建议用户定期备份重要的思维导图文件
2. 内容规范：避免在节点内容开头使用特殊字符（如=、+、-等）
3. 配置检查：在启用新功能前，先了解其可能产生的影响
4. 版本管理：考虑使用版本控制系统管理重要思维导图文件

技术说明

Freeplane的聚光灯功能设计用于突出显示当前选中节点，当设置为默认启用时，可能会影响整体显示效果。而节点内容解析机制中，以等号开头的内容会被识别为脚本代码，这是Freeplane的高级功能特性，但需要确保内容符合Groovy语法规范。

对于普通用户，建议保持默认配置，避免修改高级选项，除非确实理解其功能原理。如遇类似问题，可优先考虑重置配置文件的方法恢复软件正常运行。