トラブルシューティング

Q: GPU または描画エラーで起動できないのはなぜですか？

Linux: グラフィカルセッションと Vulkan 対応の GPU ドライバーが必要です。 そのセッションのターミナルから実行します。 vulkaninfo がない場合は、ディストリビューションのパッケージマネージャーで vulkan-tools をインストールしてください。診断ツールがないことは、 Vulkan が利用できないことを意味しません。 コマンドが失敗するか GPU が表示されない場合は、Vulkan ローダーと ドライバーを確認してください。ローダーのパッケージは Debian/Ubuntu の libvulkan1、Fedora の vulkan-loader、Arch の vulkan-icd-loader です。 GPU に合う Vulkan ドライバーをインストールします。対応する Intel/AMD GPU には Mesa、NVIDIA には適切な NVIDIA ドライバーを使います。Paneflow を 再起動し、エラーが続く場合はその内容を記録してください。 macOS: Apple Silicon Mac と macOS 13 Ventura 以降を使用しているか 確認し、macOS を更新して再試行してください。 macOS のインストール要件 を参照してください。 Windows: NoSupportedDeviceFound の場合は、PC または GPU メーカーの ドライバーを更新し、Paneflow を再起動してください。DirectX 11 の機能レベル 10 以降に対応する必要があります。GPU とドライバーの情報を記録します。

Q: Wayland セッションでウィンドウが空白になるのはなぜですか？

空白のウィンドウは、グラフィックスドライバーやディスプレイサーバーに 関係する場合があります。それだけで原因は特定できません。上記の手順で Vulkan を確認し、Paneflow を終了して、同じグラフィカルセッションから XWayland を試します。 XWayland と有効な DISPLAY 変数が必要です。この起動だけ X11 が選択 されます。開く場合は一時的な回避策として使い、ドライバーの更新を確認し、 両方の起動結果を問題報告に記載してください。

Q: paneflow.json が読み込まれないのはなぜですか？

実行中のアプリが使う設定を編集したか確認してください。 リリース版の標準パスは次のとおりです。 PANEFLOW_HOME に絶対パスを設定すると、フォルダーが変わります。 その場合は、以下のコマンドのパスを変更してください。 Python 3 がインストール済みの Linux または macOS: Windows: 構文エラーを修正し、保存して再試行してください。ファイルがない場合は 既定値を使います。起動時に設定が無効な場合も既定値を使い、実行中の 編集が無効な場合は最後の有効な設定を保持します。 これらのコマンドは JSON 構文を確認します。設定名、型、許可される値は 設定スキーマのリファレンス で確認してください。 最上位の未知のキーは無視されるため、入力ミスが設定の反映失敗に見える 場合があります。 window_decorations と window_backdrop の変更には再起動が必要です。

Q: ショートカットが動かないのはなぜですか？

shortcuts の各項目は、キーの組み合わせとアクション名を対応づけます。 この例は ctrl+shift+t でタブを作成し、ctrl+shift+w を無効にします。 既存の設定に項目を追加してください。 キーボードショートカットのリファレンス にある new_tab、split_horizontally、toggle_search などの名前を使います。 未知のアクションは警告を記録して無視されます。 特定の場所だけで動かない場合は、フォーカスのあるビューを確認してください。 Terminal、Search、Markdown、Diff のアクションにはそれぞれ適用範囲があります。

Q: テーマが自動で再読み込みされないのはなぜですか？

最上位の theme に "One Dark" または "PaneFlow Light" を指定します。 テーマ設定と例 を参照してください。 上記の設定パスと PANEFLOW_HOME の指定を確認します。 JSON 構文とテーマ名を確認し、ファイルを保存します。 少し待ち、反映されない場合は Paneflow を再起動します。 保存では反映されず、再起動で反映される場合は問題を報告してください。 ファイルがネットワークドライブやマウントされたファイルシステム上に あるかも記載します。

Q: paneflow が PATH にないのはなぜですか？

対処方法はインストール方法によって異なります。 Linux: .deb と .rpm はシステムのディレクトリにコマンドを インストールします。AppImage と .tar.gz では ~/.local/bin を PATH に追加する必要がある場合があります。 Linux のコマンドと PATH の手順 に従ってください。 macOS: Homebrew または DMG で PaneFlow.app をインストールしても、 実行ファイルはシェルの PATH に自動追加されません。 macOS のターミナル利用手順 に従ってください。 Windows: MSI のインストール後はターミナルを閉じ、スタートメニューから PowerShell を開き直してください。まだコマンドがない場合は Windows のコマンド確認手順 に従ってください。

Q: Apple がアプリを確認できないと表示されるのはなぜですか？

公式 DMG は署名と公証が済んでいます。 Paneflow の最新リリース から再ダウンロードし、警告の正確な文言を確認してください。 macOS の Gatekeeper 手順 では、初回起動の 確認とアプリのブロックを区別しています。アプリの破損やコンピューターへの 危害を示す警告の場合は、ブロックしたまま正確なメッセージを報告してください。

Q: SmartScreen が MSI をブロックするのはなぜですか？

署名済みのインストーラーでも、SmartScreen の評価に関する警告が表示される 場合があります。続行前に Windows の署名確認手順 を実施してください。署名が Valid で、発行元が Strivex であることを 確認します。どちらかが一致しない場合は、公式リリースから MSI を再ダウンロード してください。組織のポリシーでブロックされる場合は管理者に問い合わせてください。

Q: 問題報告には何を含めればよいですか？

アプリが開く場合は Help > System Info、Copy の順に選択します。 その情報に加え、使用するシェル、正確なエラー、再現手順、期待した結果、 このページで試した確認手順を記載してください。 アプリが開かない場合は、Paneflow と OS のバージョン、アーキテクチャ、 インストール形式、GPU とドライバーの情報を手動で記載してください。 Windows のバージョンとビルドは winver で確認できます。 プラットフォームに合う報告フォームを使ってください。 Linux または macOS の問題を報告: バージョン、ディスプレイサーバー、GPU、再現手順、アプリの出力。 Windows の問題を報告: Windows ビルド、GPU ドライバー、シェル、再現手順、アプリの出力。 アプリの出力を集めるには、まず Paneflow を終了し、ログを有効にして ターミナルから起動します。Linux または macOS: 標準の MSI インストール先を使う Windows: コマンドや実行ファイルが見つからない場合は、PATH の項目を確認するか、 インストール済み実行ファイルのフルパスを使ってください。macOS の DMG では paneflow を /Applications/PaneFlow.app/Contents/MacOS/paneflow に置き換えます。 問題を再現し、関連するターミナル出力を報告に貼り付けます。公開前に トークン、非公開のパス、プロジェクトの内容を取り除いてください。 読み取り専用 MCP ブリッジ はペインの出力を読み取ります。 起動、設定、描画の問題には、上記のコマンドでアプリのログを集めてください。

Paneflow の起動、描画、設定、ショートカット、テーマ、PATH、署名の問題を確認します。症状に合う手順と問題報告に必要な情報をまとめます。

2026年10月2日に更新

該当する症状を見つけ、確認手順に沿って進めてください。何が効いたか分かるよう、変更は 1 つずつ行います。問題が続く場合は、ページ末尾の手順で診断情報を集めてください。

症状	プラットフォーム	最初の確認
起動時の GPU または描画エラー	Linux	Vulkan とグラフィックスドライバーを確認。
Wayland でウィンドウが空白	Linux	Wayland と XWayland の起動を比較。
起動時の `NoSupportedDeviceFound`	Windows	GPU ドライバーを更新し、バージョンを記録。
設定変更が反映されない	すべて	ファイルのパス、JSON 構文、設定の型を確認。
ショートカットが動かない	すべて	アクション名とアプリ内のフォーカスを確認。
テーマ変更が反映されない	すべて	テーマ名を確認し、設定を保存。
`paneflow` コマンドが見つからない	すべて	インストール方法に合う PATH 手順を確認。
Gatekeeper がアプリをブロック	macOS	ダウンロード元と正確な警告を確認。
SmartScreen が MSI をブロック	Windows	インストーラーの署名と発行元を確認。

起動と描画

GPU または描画エラーで起動できないのはなぜですか？

Linux: グラフィカルセッションと Vulkan 対応の GPU ドライバーが必要です。そのセッションのターミナルから実行します。

bash

vulkaninfo --summary

vulkaninfo がない場合は、ディストリビューションのパッケージマネージャーで vulkan-tools をインストールしてください。診断ツールがないことは、 Vulkan が利用できないことを意味しません。

コマンドが失敗するか GPU が表示されない場合は、Vulkan ローダーとドライバーを確認してください。ローダーのパッケージは Debian/Ubuntu の libvulkan1、Fedora の vulkan-loader、Arch の vulkan-icd-loader です。 GPU に合う Vulkan ドライバーをインストールします。対応する Intel/AMD GPU には Mesa、NVIDIA には適切な NVIDIA ドライバーを使います。Paneflow を再起動し、エラーが続く場合はその内容を記録してください。

macOS: Apple Silicon Mac と macOS 13 Ventura 以降を使用しているか確認し、macOS を更新して再試行してください。 macOS のインストール要件を参照してください。

Windows: NoSupportedDeviceFound の場合は、PC または GPU メーカーのドライバーを更新し、Paneflow を再起動してください。DirectX 11 の機能レベル 10 以降に対応する必要があります。GPU とドライバーの情報を記録します。

powershell

Get-CimInstance Win32_VideoController |
  Select-Object Name, DriverVersion, DriverDate

Wayland セッションでウィンドウが空白になるのはなぜですか？

空白のウィンドウは、グラフィックスドライバーやディスプレイサーバーに関係する場合があります。それだけで原因は特定できません。上記の手順で Vulkan を確認し、Paneflow を終了して、同じグラフィカルセッションから XWayland を試します。

bash

env -u WAYLAND_DISPLAY paneflow

XWayland と有効な DISPLAY 変数が必要です。この起動だけ X11 が選択されます。開く場合は一時的な回避策として使い、ドライバーの更新を確認し、両方の起動結果を問題報告に記載してください。

設定とショートカット

paneflow.json が読み込まれないのはなぜですか？

実行中のアプリが使う設定を編集したか確認してください。リリース版の標準パスは次のとおりです。

プラットフォーム	パス
Linux と macOS	`~/.paneflow/paneflow.json`
Windows	`%USERPROFILE%\.paneflow\paneflow.json`

PANEFLOW_HOME に絶対パスを設定すると、フォルダーが変わります。その場合は、以下のコマンドのパスを変更してください。

Python 3 がインストール済みの Linux または macOS:

bash

python3 -m json.tool ~/.paneflow/paneflow.json

Windows:

powershell

Get-Content $env:USERPROFILE\.paneflow\paneflow.json -Raw |
  ConvertFrom-Json | Out-Null

構文エラーを修正し、保存して再試行してください。ファイルがない場合は既定値を使います。起動時に設定が無効な場合も既定値を使い、実行中の編集が無効な場合は最後の有効な設定を保持します。

これらのコマンドは JSON 構文を確認します。設定名、型、許可される値は設定スキーマのリファレンスで確認してください。最上位の未知のキーは無視されるため、入力ミスが設定の反映失敗に見える場合があります。

window_decorations と window_backdrop の変更には再起動が必要です。

ショートカットが動かないのはなぜですか？

shortcuts の各項目は、キーの組み合わせとアクション名を対応づけます。この例は ctrl+shift+t でタブを作成し、ctrl+shift+w を無効にします。既存の設定に項目を追加してください。

キーボードショートカットのリファレンスにある new_tab、split_horizontally、toggle_search などの名前を使います。未知のアクションは警告を記録して無視されます。

json

{
  "shortcuts": {
    "ctrl+shift+t": "new_tab",
    "ctrl+shift+w": "none"
  }
}

特定の場所だけで動かない場合は、フォーカスのあるビューを確認してください。 Terminal、Search、Markdown、Diff のアクションにはそれぞれ適用範囲があります。

テーマが自動で再読み込みされないのはなぜですか？

最上位の theme に "One Dark" または "PaneFlow Light" を指定します。テーマ設定と例を参照してください。

上記の設定パスと PANEFLOW_HOME の指定を確認します。
JSON 構文とテーマ名を確認し、ファイルを保存します。
少し待ち、反映されない場合は Paneflow を再起動します。
保存では反映されず、再起動で反映される場合は問題を報告してください。ファイルがネットワークドライブやマウントされたファイルシステム上にあるかも記載します。

インストールと署名

paneflow が PATH にないのはなぜですか？

対処方法はインストール方法によって異なります。

Linux: .deb と .rpm はシステムのディレクトリにコマンドをインストールします。AppImage と .tar.gz では ~/.local/bin を PATH に追加する必要がある場合があります。 Linux のコマンドと PATH の手順に従ってください。
macOS: Homebrew または DMG で PaneFlow.app をインストールしても、実行ファイルはシェルの PATH に自動追加されません。 macOS のターミナル利用手順に従ってください。
Windows: MSI のインストール後はターミナルを閉じ、スタートメニューから PowerShell を開き直してください。まだコマンドがない場合は Windows のコマンド確認手順に従ってください。

Apple がアプリを確認できないと表示されるのはなぜですか？

公式 DMG は署名と公証が済んでいます。 Paneflow の最新リリースから再ダウンロードし、警告の正確な文言を確認してください。 macOS の Gatekeeper 手順では、初回起動の確認とアプリのブロックを区別しています。アプリの破損やコンピューターへの危害を示す警告の場合は、ブロックしたまま正確なメッセージを報告してください。

SmartScreen が MSI をブロックするのはなぜですか？

署名済みのインストーラーでも、SmartScreen の評価に関する警告が表示される場合があります。続行前に Windows の署名確認手順を実施してください。署名が Valid で、発行元が Strivex であることを確認します。どちらかが一致しない場合は、公式リリースから MSI を再ダウンロードしてください。組織のポリシーでブロックされる場合は管理者に問い合わせてください。

診断情報の収集

問題報告には何を含めればよいですか？

アプリが開く場合は Help > System Info、Copy の順に選択します。その情報に加え、使用するシェル、正確なエラー、再現手順、期待した結果、このページで試した確認手順を記載してください。

アプリが開かない場合は、Paneflow と OS のバージョン、アーキテクチャ、インストール形式、GPU とドライバーの情報を手動で記載してください。 Windows のバージョンとビルドは winver で確認できます。

プラットフォームに合う報告フォームを使ってください。

Linux または macOS の問題を報告バージョン、ディスプレイサーバー、GPU、再現手順、アプリの出力。Windows の問題を報告Windows ビルド、GPU ドライバー、シェル、再現手順、アプリの出力。

アプリの出力を集めるには、まず Paneflow を終了し、ログを有効にしてターミナルから起動します。Linux または macOS:

bash

RUST_LOG=info paneflow

標準の MSI インストール先を使う Windows:

powershell

$env:RUST_LOG = "info"
$env:RUST_BACKTRACE = "1"
& "$env:ProgramFiles\PaneFlow\paneflow.exe"

コマンドや実行ファイルが見つからない場合は、PATH の項目を確認するか、インストール済み実行ファイルのフルパスを使ってください。macOS の DMG では paneflow を /Applications/PaneFlow.app/Contents/MacOS/paneflow に置き換えます。

問題を再現し、関連するターミナル出力を報告に貼り付けます。公開前にトークン、非公開のパス、プロジェクトの内容を取り除いてください。

読み取り専用 MCP ブリッジはペインの出力を読み取ります。起動、設定、描画の問題には、上記のコマンドでアプリのログを集めてください。