トラブルシューティング

クイックルックアップ

よくある問題と修正の参照先：

症状	考えられる原因	参照先
MCP クライアントが接続できない	古いポートファイル、または VMark が実行されていない	MCP サーバー接続の問題
ファイルが開けない、または文字化けして表示される	非 UTF-8 エンコーディング、または検疫属性	ファイルが開けない
AI ジーニーがハングするか何も返さない	プロバイダー設定誤り、または PATH に CLI がない	AI ジーニーが応答しない
キーボードショートカットが反応しない	設定で再割り当て、またはシステムによる上書き	キーボードショートカットが機能しない
大きなファイルでエディタが遅い	タブごとのメモリ＋ 1 万行を超える入力遅延	エディタのパフォーマンス
言語変更後もメニューが英語のまま	メニューは起動時に再構築	言語を変更してもメニューバーが英語のまま
PDF エクスポートが不完全	画像パスまたは書き込み権限	エクスポート／印刷の問題
Windows で起動が遅い	WebView2 ＋アンチウイルススキャン	Windows でアプリの起動が遅い

上記に記載されていないものは バグの報告 を参照してください。

ログファイル

VMark は問題の診断に役立つログファイルを出力します。ログには Rust バックエンドとフロントエンドの両方からの警告とエラーが含まれます。

ログファイルの場所

プラットフォーム	パス
macOS	~/Library/Logs/app.vmark/
Windows	%APPDATA%\app.vmark\logs\
Linux	~/.local/share/app.vmark/logs/

ログレベル

レベル	記録内容	本番環境	開発環境
Error	障害、クラッシュ	はい	はい
Warn	回復可能な問題、フォールバック	はい	はい
Info	マイルストーン、状態変化	はい	はい
Debug	詳細なトレース	いいえ	はい

ログローテーション

• 最大ファイルサイズ：5 MB
• ローテーション：以前のログファイルを 1 つ保持
• 古いログは自動的に置き換えられます

バグの報告

バグを報告する際は、以下の情報を含めてください：

1. VMark のバージョン — ナビゲーションバーのバッジまたは「VMark について」ダイアログに表示されます
2. オペレーティングシステム — macOS のバージョン、Windows のビルド、または Linux のディストリビューション
3. 再現手順 — 問題が発生する前に行った操作
4. ログファイル — 関連するログエントリを添付またはペーストしてください

ログエントリにはタイムスタンプが付与され、モジュールごとにタグ付けされています（例：[HotExit]、[MCP Bridge]、[Export]）。これにより、関連する箇所を簡単に見つけることができます。

関連するログの探し方

1. 上の表を参考にログディレクトリを開く
2. 最新の .log ファイルを開く
3. 問題が発生した時刻付近の ERROR または WARN エントリを検索する
4. 関連する行をコピーしてバグ報告に含める

よくある問題

Windows でアプリの起動が遅い

VMark は macOS 向けに最適化されています。Windows では、WebView2 の初期化のため起動が遅くなる場合があります。以下を確認してください：

• WebView2 Runtime が最新版に更新されていること
• ウイルス対策ソフトがアプリのデータディレクトリをリアルタイムスキャンしていないこと

言語を変更してもメニューバーが英語のまま

設定で言語を切り替えた後もメニューバーが英語のままの場合は、VMark を再起動してください。次回起動時に、保存された言語設定でメニューが再構築されます。

ターミナルで CJK 句読点が入力できない

v0.6.5 以降で修正済みです。最新バージョンに更新してください。

MCP サーバー接続の問題

MCP サーバーが起動しない、またはクライアントが接続できない場合があります。

• VMark が実行中であることを確認してください — MCP サーバーはアプリが開いている時のみ起動します。
• 他のプロセスが同じポートを使用していないことを確認してください。MCP サーバーはクライアント検出用にポートファイルを書き込みます。前回のセッションの古いポートファイルが競合を引き起こす場合があります。VMark を再起動して再生成してください。
• ログファイルの [MCP Bridge] エントリを確認して接続エラーを特定してください。

キーボードショートカットが機能しない

ショートカットが別のバインドと競合しているか、カスタマイズされている場合、応答しないように見えることがあります。

• 設定（Mod + ,）を開き、ショートカット タブに移動して、ショートカットが再割り当てされていないか確認してください。
• 重複したバインドを探してください — 2 つのアクションが同じキーの組み合わせを共有している場合、1 つだけが実行されます。
• macOS では、一部のショートカットがシステムレベルのバインドと競合する場合があります（例: Mission Control、Spotlight）。システム設定 > キーボード > キーボードショートカット を確認してください。

エクスポート/印刷の問題

PDF エクスポートがハングしたり、不完全な出力が生成される場合があります。

• エクスポートで画像が欠けている場合は、画像パスがドキュメントからの相対パスで、ファイルがディスク上に存在することを確認してください。絶対 URL やリモート画像はアクセス可能である必要があります。
• 出力ディレクトリのファイル権限を確認してください — VMark はエクスポートしたファイルを保存するために書き込みアクセスが必要です。
• 大きなドキュメントの場合、エクスポートに時間がかかることがあります。動かないように見える場合は、ログファイルの [Export] エントリを確認してください。

ファイルが開けない

VMark がファイルを開けない、または文字化けしたコンテンツが表示される場合があります。

• ファイルにユーザーアカウントの読み取り権限があることを確認してください。
• VMark は UTF-8 エンコードの Markdown を期待しています。他のエンコーディング（例: GB2312、Shift-JIS）のファイルは正しく表示されない場合があります — まず UTF-8 に変換してください。
• ファイルが別のプロセス（例: 同期クライアントやバックアップツール）によってロックされている場合は、そのプロセスを閉じて再試行してください。

エディタのパフォーマンス

非常に大きなファイルや多くの開いているタブがあると、エディタが遅くなる場合があります。

• 未使用のタブを閉じてメモリを解放してください — 各タブは独自のエディタ状態を保持しています。
• 非常に大きなドキュメント（10,000 行以上）は入力遅延を引き起こす可能性があります。小さなファイルに分割することを検討してください。
• 必要ない場合はフォーカスモードとタイプライターモードを無効にしてください。これらは追加のレンダリングオーバーヘッドを発生させます。

AI ジーニーが応答しない

AI ジーニーは機能するために設定された AI プロバイダーが必要です。

• 設定を開き、AI プロバイダー（例: Ollama、OpenAI、Anthropic）が有効なモデル名で設定されていることを確認してください。
• プロバイダーの CLI が PATH で利用可能である必要があります。macOS では、GUI アプリのPATH は最小限です — CLI が Homebrew 経由でインストールされた場合、シェルプロファイルが正しいパスをエクスポートしていることを確認してください。
• モデル名のタイプミスを確認してください。不正なモデル名はサイレントに失敗するか、エラーを返します。