故障排除
常见问题及其解决方案。
macOS：“无法打开 App”
如果 macOS 在首次启动时阻止了 Moraya：
- 前往 系统设置 > 隐私与安全性
- 向下滚动找到关于 Moraya 被阻止的提示
- 点击 “仍要打开”
macOS：开发模式下 Dock 图标显示为通用图标
运行 pnpm tauri dev 时，Dock 图标显示为通用应用图标。这是正常现象 —— 开发模式下没有 .app 包。运行 pnpm tauri build 即可看到正确的图标。
AI：API 密钥无法使用
- 确认 API 密钥正确且未过期
- 检查是否在设置 > AI 中选择了正确的提供商
- 对于 Ollama，确保 Ollama 服务器正在本地运行（
ollama serve）
编辑器：数学公式未渲染
确保使用了正确的语法：单个 $ 用于行内公式，双 $$ 用于块级公式。KaTeX 可能不支持所有 LaTeX 宏包 —— 请查阅 KaTeX 支持的函数 列表。
大文件性能
对于非常大的 Markdown 文件（>1MB），建议使用源码模式（Cmd+/）以获得更好的性能，因为大文档的所见即所得渲染可能较慢。
报告问题
如果你遇到 Bug，请在 GitHub Issues 上报告，并提供：
- 你的操作系统和版本
- Moraya 版本（从 帮助 > 关于 中查看）
- 重现步骤
- 预期行为与实际行为