故障排查

先检查受影响的源笔记和准确错误信息。更改自定义 Markdown 或模板前，请保留副本。Reset vault 会删除仓库内容，不是这些问题的修复步骤。

启动时停止

检查同一仓库是否启用了 Obsibrain V1。禁用 V1 并重新加载 Obsidian。只要 V1 仍启用，V2 就会在写入设置或仓库内容前停止。

确认 V2 插件文件位于 .obsidian/plugins/obsibrain/，且来自同一提供的版本。V2 需要 Obsidian 1.13.7 或更高版本。

使用 iCloud 时视图或操作缓慢

如果视图一直提示重新加载，或 Open Today 耗时很长，请检查 iCloud 是否已下载所有仓库文件。为整个仓库文件夹启用 Keep Downloaded（保留下载），等待下载完成后重新启动 Obsidian。请按同步和移动端中的步骤操作。如果所有文件下载完成后问题仍然存在，请准备支持报告。

命令缺失

回顾命令缺失时，请检查 Obsibrain 设置中的 Review Cycles。使用目标完成命令前，请先打开目标。

迁移向导和 AI Alpha 仅限桌面端，不作为移动功能提供。

视图为空或报错

打开底层笔记，检查 type、日期、链接、完成状态和 archived 属性。文件夹名称或旧 V1 标签不能替代 V2 元数据。

对于自定义代码块，请与组件库中新添加的组件比较。未知视图和无效选项会报错。Dataview 或 Templater 代码不会自动变成 V2 代码块。

模板失败

打开 templates/obsibrain/ 中对应文件。检查原生标记是否拼写错误或缺少大括号。会议日程标记应放在 Meeting 模板中，回顾标记应放在匹配的回顾模板中。

已启用但缺失的模板会重新创建。现有自定义模板会保留，因此更新不会替换有错误的编辑内容。

无法更改内容或 AI 不可用

许可证报错时，请联网并验证购买邮箱和密钥。离线访问在最近一次成功验证后三十天到期。

AI 出错时，请检查 Pi 认证、Pi CLI 0.84.2 或更高版本、Obsidian CLI 和可执行文件路径。核心工作流程与这些桌面前置工具相互独立。

更改界面语言

Obsibrain 遵循 Obsidian 的语言偏好。在 Obsidian 设置中更改语言并重新加载应用。插件支持英语、法语、德语、西班牙语、葡萄牙语、中文、日语、韩语和阿拉伯语。不受支持的语言回退为英语。现有笔记文本保持不变。

准备支持报告

运行 Copy diagnostics。检查报告后，通过 Contact support 连同错误信息和复现步骤一起分享。只有粘贴报告时，报告才会离开设备。导入问题请使用迁移向导中经过敏感信息删减的支持摘要。