トラブルシューティング
一般的な問題とその解決策です。
macOS: 「アプリを開けません」
初回起動時に macOS が Moraya をブロックした場合：
- システム設定 > プライバシーとセキュリティ に移動します
- Moraya がブロックされたというメッセージまでスクロールします
- 「このまま開く」 をクリックします
macOS: 開発モードで Dock アイコンが汎用的に表示される
pnpm tauri dev を実行すると、Dock アイコンが汎用アプリアイコンとして表示されます。これは想定内の動作です。開発モードでは .app バンドルが存在しません。正しいアイコンを確認するには pnpm tauri build を実行してください。
AI: API キーが機能しない
- API キーが正しく、期限切れになっていないことを確認してください
- 設定 > AI で正しいプロバイダーが選択されていることを確認してください
- Ollama の場合、Ollama サーバーがローカルで実行中であることを確認してください（
ollama serve）
エディタ: 数式がレンダリングされない
正しい構文を使用していることを確認してください：インラインには $ 1 つ、ブロックには $$ 2 つを使用します。KaTeX はすべての LaTeX パッケージをサポートしているわけではありません。KaTeX 対応関数 の一覧を確認してください。
大きなファイルのパフォーマンス
非常に大きな Markdown ファイル（1MB 超）の場合、パフォーマンス向上のためにソースモード（Cmd+/）の使用を検討してください。大きなドキュメントの WYSIWYG レンダリングは動作が遅くなる場合があります。
問題の報告
バグを発見した場合は、GitHub Issues に以下の情報を添えて報告してください：
- お使いの OS とバージョン
- Moraya のバージョン（ヘルプ > Moraya について から確認）
- 問題を再現する手順
- 期待される動作と実際の動作