画布无法导入、生成或同步
Mermaid 导入失败
只支持 flowchart/graph
NoteGen 画布 Mermaid 导入只支持 flowchart 和 graph 两种语法类型：
✅ 可以导入：
flowchart TD
A --> B❌ 不能直接导入（需要先装转或截图）：
sequenceDiagram
A->>B: 发送导入其他 Mermaid 类型会报错或只导入部分内容。
语法错误
Mermaid 导入时 NoteGen 会解析语法，语法错了就导入不了。建议：
- 先在 Mermaid Live Editor 里验证语法正确
- 确认节点文本没有特殊字符（引号、反引号等可能需要转义）
画布 PNG/SVG 导出异常
| 问题 | 解决 |
|---|---|
| 导出空白 | 先"适应视图"再导出；检查远程图片是否可访问 |
| 导出只有一部分 | 缩小画布范围，或只选中要导出的元素 |
| SVG 文件太大 | 复杂大画布分几次导出，或改用 PNG |
| 字体乱码 | 导出后文字可能变成系统默认字体，导出前确认字体兼容性 |
AI 图表生成不出
AI 图表需要：
- 可用的聊天模型——不是嵌入模型，是能生成文本的对话模型
- 有效数据——手动输入或从笔记提取
- 网络连接（如果用在线模型）
排查：
- 模型连接检测通过了吗？（见模型连接排错）
- 数据里有没有明显格式问题？
- 换一个更简单的图表类型试试（比如先画一个饼图确认通道通了）
画布同步失败
画布数据保存在 NoteGen 应用数据中，随"记录与配置同步"一起同步。
检查清单
- 同步状态——NoteGen 同步设置显示"已连接"吗？
- 自动同步——"记录与配置自动同步"开了吗？画布不会手动触发同步，需要自动
- 冲突——有显示冲突待处理吗？先处理冲突再看
- 不要重复删除重建——同步失败时先保留本地画布，检查同步队列
画布丢失怎么办
- 先在其他设备 NoteGen 里看看能不能找回
- 本地 ZIP 备份里包含画布数据（如果启用记录与配置同步）
- 画布 JSON 导出文件如果之前保存过，可以重新导入
画布缩放/布局问题
- 自动布局后乱了——先"撤销"，手动拖动调整节点位置，再让 AI 重新布局
- 小地图找不到——画布缩放过小或过大时先"适应视图"，小地图会重新定位
- 网格吸附太严格——画布设置里可以关掉网格或调吸附强度
画布 vs Markdown 导出
Mermaid 只覆盖流程图节点和连线，自由绘制、图片、图表、分组等元素不会完整保留。需要无损备份画布一定要导出 NoteGen 画布 JSON。