トラブルシューティング
クイックルックアップ
よくある問題と修正の参照先：
| 症状 | 考えられる原因 | 参照先 |
|---|---|---|
| MCP クライアントが接続できない | 古いポートファイル、または VMark が実行されていない | MCP サーバー接続の問題 |
| ファイルが開けない、または文字化けして表示される | 非 UTF-8 エンコーディング、または検疫属性 | ファイルが開けない |
| AI ジーニーがハングするか何も返さない | プロバイダー設定誤り、または PATH に CLI がない | AI ジーニーが応答しない |
| キーボードショートカットが反応しない | 設定で再割り当て、またはシステムによる上書き | キーボードショートカットが機能しない |
| 大きなファイルでエディタが遅い | タブごとのメモリ＋ 1 万行を超える入力遅延 | エディタのパフォーマンス |
| 言語変更後もメニューが英語のまま | メニューは起動時に再構築 | 言語を変更してもメニューバーが英語のまま |
| PDF エクスポートが不完全 | 画像パスまたは書き込み権限 | エクスポート／印刷の問題 |
| Windows で起動が遅い | WebView2 ＋アンチウイルススキャン | Windows でアプリの起動が遅い |
Cmd + R / Ctrl + R が何もしない | 再読み込みは設計上ブロックされている | 再読み込みはブロックされています |
| ファイルをダブルクリックすると実行中の VMark で開かれた | Windows と Linux でのシングルインスタンス転送 | Windows と Linux では VMark は一度に 1 つだけ |
| Linux でウィンドウが空白になる | WebKitGTK の DMABUF レンダラー | Linux で空白のウィンドウが表示される |
macOS でストレートクォートや -- がそのまま残る | VMark ではシステムのスマート置換がオフになっている | macOS のスマート引用符とダッシュ |
| アクティビティモニタで VMark が「App Nap」にならない | AI アシスタントが動作し続けられるよう App Nap が無効になっている | バックグラウンドで VMark がスリープしない（App Nap） |
最近のワークスペースでフォルダ選択ダイアログが開く、またはエラーに forbidden path と表示される | そのフォルダが VMark の読み取れる範囲外にある | フォルダへのアクセスと forbidden path エラー |
上記に記載されていないものは バグの報告 を参照してください。
ログファイル
VMark は問題の診断に役立つログファイルを出力します。ログには Rust バックエンドとフロントエンドの両方からの警告とエラーが含まれます。
ログファイルの場所
| プラットフォーム | パス |
|---|---|
| macOS | ~/Library/Logs/app.vmark/ |
| Windows | %LOCALAPPDATA%\app.vmark\logs\ |
| Linux | ~/.local/share/app.vmark/logs/ |
ログレベル
| レベル | 記録内容 | 本番環境 | 開発環境 |
|---|---|---|---|
| Error | 障害、クラッシュ | はい | はい |
| Warn | 回復可能な問題、フォールバック | はい | はい |
| Info | マイルストーン、状態変化 | はい | はい |
| Debug | 詳細なトレース | いいえ | はい |
ログローテーション
- 最大ファイルサイズ：5 MB
- ローテーション：以前のログファイルを 1 つ保持
- 古いログは自動的に置き換えられます
バグの報告
バグを報告する際は、以下の情報を含めてください：
- VMark のバージョン — ナビゲーションバーのバッジまたは「VMark について」ダイアログに表示されます
- オペレーティングシステム — macOS のバージョン、Windows のビルド、または Linux のディストリビューション
- 再現手順 — 問題が発生する前に行った操作
- ログファイル — 関連するログエントリを添付またはペーストしてください
ログエントリにはタイムスタンプが付与され、モジュールごとにタグ付けされています（例：[HotExit]、[MCP Bridge]、[Export]）。これにより、関連する箇所を簡単に見つけることができます。
関連するログの探し方
- 上の表を参考にログディレクトリを開く
- 最新の
.logファイルを開く - 問題が発生した時刻付近の
ERRORまたはWARNエントリを検索する - 関連する行をコピーしてバグ報告に含める
よくある問題
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 のファイルだけです。（バイトオーダーマークによって）UTF-16 または UTF-32 と示されているファイルは、開く時点で拒否され、トーストが表示されます：「パス は エンコーディング でエンコードされています。VMark が開けるのは UTF-8 のファイルだけです。別のエディタで UTF-8 として保存してから、もう一度開いてください。」それ以外の旧来のエンコーディング（GB2312、Shift-JIS）にはマークがないため、開くことはできますが文字化けすることがあります — まず UTF-8 に変換してください。
- バイトオーダーマークで始まる UTF-8 ファイルは、それを保持します：VMark は開くときも保存するときも BOM を維持します。
- ファイルが別のプロセス（例: 同期クライアントやバックアップツール）によってロックされている場合は、そのプロセスを閉じて再試行してください。
- macOS: VMark の実行中に、ダウンロードしたファイルをダブルクリックしても何も起こらない。 一部のアプリが保存したファイルにはダウンロードの隔離属性（
com.apple.quarantine）が付いており、macOS はそのようなファイルを実行中のアプリで開く要求を黙って破棄することがあります。ワークスペースを開くと、VMark はワークスペースフォルダーと、その直下にある開けるファイルからこの属性を削除します（サブフォルダーには手を加えません） — これは 設定 → 詳細設定 → macOS の ワークスペースを開く際にダウンロードの隔離を解除 設定で、デフォルトでオンです。それ以外のファイルには ファイル → ファイルを開く... を使うか、ターミナルでxattr -d com.apple.quarantine <file>を実行してください。
フォルダへのアクセスと forbidden path エラー
ホームフォルダとマウントされたボリュームの外側 — Windows ではドライブ C:\ から F:\ の外側 — では、VMark はアクセスを許可されたものだけを読み取ります。詳しくは VMark がディスク上で読み取れる範囲 を参照してください。
- 最近のワークスペースを選ぶとフォルダ選択ダイアログが開く。 VMark は、あなたが以前そのフォルダを選んだことを確認できず、ほかにそこを読み取る手段もありません。ダイアログはそのフォルダを開いた状態で表示されます。開く をクリックして確定すると、VMark は以後そのフォルダを覚えています。キャンセルした場合は何も開きません。
- AI アシスタントがフォルダを開くよう要求すると、もう 1 ステップ必要になる。 要求を承認すると、VMark は同じダイアログを表示します。そこでフォルダを選び、アシスタントに再試行させてください。
- エラーに
forbidden pathと表示される、または画像が表示されない。 そのファイルは VMark が読み取れるどの場所にもありません — 多くの場合、単独で開いたドキュメントの隣にある画像です。ファイル → ワークスペースを開く... でドキュメントのフォルダを開くと、VMark にフォルダ全体へのアクセスを与えられます。
エディタのパフォーマンス
非常に大きなファイルや多くの開いているタブがあると、エディタが遅くなる場合があります。
- 未使用のタブを閉じてメモリを解放してください — 各タブは独自のエディタ状態を保持しています。
- 非常に大きなドキュメント（10,000 行以上）は入力遅延を引き起こす可能性があります。小さなファイルに分割することを検討してください。
- 必要ない場合はフォーカスモードとタイプライターモードを無効にしてください。これらは追加のレンダリングオーバーヘッドを発生させます。
AI ジーニーが応答しない
AI ジーニーは機能するために設定された AI プロバイダーが必要です。
- 設定を開き、AI プロバイダー（例: Ollama、OpenAI、Anthropic）が有効なモデル名で設定されていることを確認してください。
- プロバイダーの CLI が PATH で利用可能である必要があります。macOS では、GUI アプリのPATH は最小限です — CLI が Homebrew 経由でインストールされた場合、シェルプロファイルが正しいパスをエクスポートしていることを確認してください。
- モデル名のタイプミスを確認してください。不正なモデル名はサイレントに失敗するか、エラーを返します。
再読み込みはブロックされています
Cmd + R、Ctrl + R、Ctrl + Shift + R は、意図的に何もしません。WebView を再読み込みすると、開いているすべてのエディタ、その元に戻す履歴、未保存の状態がすべて失われてしまうため、VMark はこれらのショートカット、ページのアンロード経路、WebView 自身のコンテキストメニューをブロックしています。例外は 2 つあります。統合ターミナルにフォーカスがあるときは Ctrl + R がシェルに届きます（reverse-i-search）。また F5 はソースピークのショートカットなので、決してブロックされません。開発ビルドでは、代わりに未保存のドキュメントについて警告するだけです。
Windows と Linux では VMark は一度に 1 つだけ
ファイルをダブルクリックしたり、ランチャーから VMark をもう一度起動したりすると、2 つ目のコピーを起動する代わりに、すでに実行中の VMark にファイルが渡され、ウィンドウが前面に表示されます。2 つ目のプロセスは 1 つ目とアプリデータ、セッション、ウィンドウのストレージを共有することになり、2 つが互いの状態を上書きしてしまいます — これが #1330 のデータ損失の原因でした。macOS では、OS の仕組みによって常にこのように動作してきました。開発用（tauri dev）ビルドは独自の識別子を使うため、別のアプリとして扱われます。
Windows で、すでに実行中の VMark が応答しなくなり、受け渡しを受け取れない場合、新しい起動はその横に 2 つ目のコピーを起動しません。代わりにメッセージを表示します。タスク マネージャーを開いてすべての VMark プロセスを終了してから、VMark をもう一度起動してください（#1527）。
Linux では、これは D-Bus のセッションバスに依存しています。使用可能な DBUS_SESSION_BUS_ADDRESS がないセッションでは、VMark は起動しますがこの保護は働きません — もう一度起動すると 2 つ目のコピーが起動し、上記のリスクが生じます — そして、保護がオフであることがログに記録されます。デスクトップセッションから、またはその変数が設定されたシェルから起動してください。
Linux で空白のウィンドウが表示される
AMD / Mesa / WebKitGTK の一部の組み合わせ（報告されたのは KDE Plasma 6 を使う Arch、#1058）では、WebKitGTK の DMABUF レンダラーが失敗し、コンテンツ領域が空白のままになります。これが起きないよう、VMark は WebView の起動前に WEBKIT_DISABLE_DMABUF_RENDERER=1 を設定します。DMABUF レンダラーを使いたい場合は、WEBKIT_DISABLE_DMABUF_RENDERER=0 を付けて起動してください — VMark がこの変数を設定するのは、あなたが設定していない場合だけです。
中国語入力メソッドがオンのときにショートカットが文字を入力してしまう
修正済みです。中国語の句読点がオンの場合、入力メソッドは句読点キーを書き換えます — バッククォートキーは · を、角括弧は 【】 を生成します — そして、キーが押されたことがアプリに伝わる前にその文字を確定します。そのため以前は、Ctrl + ` でターミナルが切り替わるうえにドキュメントに余分な · が残り、変更のないファイルが編集済みとして扱われていました。
現在の VMark は、キー押下ではなく挿入そのものを拒否するため、コマンドのキーの組み合わせでは何も入力されません。通常の中国語入力、デッドキー（Option + e）、ヨーロッパのキーボードの AltGr 文字には影響しません — 拒否されるのは Ctrl または Cmd を押している間に届いた挿入だけであり、「この文字を入力する」という意味を持つ VMark のキーの組み合わせはありません。
それでもショートカットで余分な文字が入力される場合は、入力メソッドの名前と正確なキーの組み合わせを添えて報告していただく価値があります。
macOS のスマート引用符とダッシュ
Mac でスマート引用符とスマートダッシュを使用がオンになっていても、VMark で -- や " を入力するとそのまま残ります。そうしないと、システムがエディタの下でテキストを書き換えてしまうからです — Mermaid ブロック内の --> が —> になっていました。そのため VMark は、自分自身のプロセスに限って、ダッシュ、引用符、ピリオドの自動置換をオフにしています。ほかのアプリには影響せず、入力メソッドやあなた自身のユーザ辞書（テキスト置換）にも影響しません。VMark 内で活字用の引用符を使うには、CJK フォーマッターのスマート引用符ルールまたは引用符スタイルの切り替え（Shift + Mod + '）を使ってください。
バックグラウンドで VMark がスリープしない（App Nap）
macOS では、VMark は実行中ずっと App Nap を無効にしているため、ウィンドウが非表示でもアクティビティモニタには App Nap 状態にならないと表示されます。App Nap は WebView を — そしてそれとともにすべての AI アシスタント（MCP）のリクエストを — ウィンドウを前面に出すまで凍結してしまいます。起きたままでいることで、あなたが別のアプリを使っている間もアシスタントが作業を続けられます。アイドル時にシステムがスリープすることはあります。VMark が求めているのは、App Nap の対象にしないことだけです。