故障排查

应用或历史记录无法打开#

请确认 Mac 搭载 Apple 芯片并运行 macOS 14 或更高版本。如果 macOS 阻止启动，请先尝试打开一次，再到系统设置中的“隐私与安全性”允许 Buffera。

如果 ⌘⌥V 不起作用，请从菜单栏图标打开历史记录。关闭占用此快捷键的其他应用，或在“设置 → 快捷键”中选择新的组合。

找不到预期条目#

• 确认 Buffera 正在运行，且记录未暂停。
• 如果 macOS 请求剪贴板访问权限，请允许。
• 按 ⌘0 清除搜索词和筛选条件。
• 重新复制内容。锁定或睡眠期间的复制会被跳过。
• 检查机密内容设置：默认不会保存标记为保密的条目。
• 对于听写或自动插入的文本，请检查“设置 → 历史记录”中的“保存临时记录”。此类记录默认不保存；机密记录还需要开启加密保存功能。

搜索或助手尚未就绪#

打开“AI”。检查模型下载状态，并确认对应功能已启用。语义搜索还需要为历史记录建立索引。使用电池时，选择“立即继续”或接通电源。

如果搜索不到图片中的文字，请在 Buffera 菜单栏菜单中检查 OCR 进度。“重试识别”会重新尝试失败的识别。隐藏图片不会被识别。

智能体无法访问历史记录#

启动当前版本的 Buffera，在“MCP”标签页中启用访问，并检查客户端配置中的路径。更新应用后，请在智能体中重启 MCP。隐藏条目始终不会返回内容。

历史记录中的文件不可用#

Buffera 保存的是原始文件的引用，而非备份。请检查文件是否已移动或删除。若要永久保留图片，请使用“另存为”；“在 Finder 中显示”只会创建临时导出文件。