故障排查

解决命令缺失、空白视图、模板错误、许可证问题和桌面 AI 不可用等情况。

本页内容

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

启动时停止

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

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

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

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

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

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

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

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

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

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

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

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