トラブルシューティング
グローバルホットキーが反応しない
- 設定 → サービスの状態 を確認してください — バックグラウンドサービスが実行されていない場合、そのページから再インストールまたは再起動すると、たいていインデックス関連の問題は解消しますが、切り替えホットキー自体はサービスではなく App プロセスが処理しているため、これは二次的な確認事項です。
- フォアグラウンドのアプリが昇格(管理者として実行)されていて SwiftList がそうでない場合、Windows は低い権限のプロセスがそのアプリに入力を送ることをブロックします。SwiftList のバックグラウンドホットキーリスナープロセスは、アカウントが管理者である場合は自動的に昇格されます — 有効にする設定も UAC プロンプトもありません。それでもホットキーが昇格されたウィンドウに届かない場合は、設定 → サービスの状態 を確認し、バックグラウンドサービスが実行中であることを確かめてください。昇格されたリスナーを起動しているのはこのサービスだからです。アカウントが管理者でない場合、回避策はありません — Windows は低い権限のプロセスが高い権限のプロセスにシグナルを送ることを許可しません。
- プロセスブラックリスト を確認してください — フォアグラウンドアプリの実行ファイル名が(意図的にせよ誤ってにせよ)そこに追加されている場合、そのアプリにフォーカスがある間、SwiftList のグローバルホットキーは意図的に素通しされます。
- フォアグラウンドアプリが本当にフルスクリーン(モニター全体を占有)である場合、SwiftList はデフォルトでそのホットキーも自動的に素通しします — フルスクリーンゲームと競合しないようにするためです。設定したキーの組み合わせがフルスクリーンアプリ自体が使うものと衝突しないのであれば、設定 → ホットキー → クイック検索の表示/非表示 の横にある フルスクリーンアプリにフォーカスがあっても応答する を有効にすれば、そこでも動作するようになります。それ以外の場合は、Alt+Tab で一度切り替えるか、排他的フルスクリーンではなくボーダーレス/ウィンドウモードでアプリを実行することで回避できます。
検索結果が古いように見える
NTFS と ReFS のドライブは USN ジャーナルからほぼリアルタイムで更新されます。それ以外のローカルファイルシステム(FAT32、exFAT など)も同様に継続的に、直接変更が監視されます。それでも古いままに見える場合(作成したばかりのファイルが表示されない、削除したファイルがまだ表示されるなど)は、対象のドライブについて 設定 → インデックス → ローカルドライブ(または ネットワークドライブ)の インデックスの再構築 を使用してください。
ネットワークドライブがまったく更新されないように見える
ネットワーク共有には SwiftList が監視できる USN ジャーナルがないため、代わりにスケジュールに基づいて再スキャンされます。設定 → インデックス → ネットワークドライブ でそのドライブの 更新モード を確認してください — 手動 に設定されている場合は自動的には更新されません。定期的な間隔に切り替えるか、インデックスの再構築 でオンデマンドに更新してください。
プレビューウィンドウの表示がおかしい/一部が切れている
通常はこの現象は発生しません — SwiftList は QuickLook プレビューウィンドウの位置とサイズを、モニターの使用可能領域に自動的に収めます。それでもクリッピングが見られる場合は、設定 → 一般 → プレビュー → プレビューウィンドウ設定をリセット を試して、通常とは異なる手動の幅/高さの値が原因でないかを確認し、最新版を使用していることも確認してください。
ファイル/フォルダーがまったく表示されない
- 除外されていないか確認してください — 設定 → インデックス → 除外ルール は完全一致パス、グロブパターン、正規表現に対応しており、この3つのいずれかが意図せず該当している可能性があります。
- そのファイルがあるドライブが 設定 → インデックス → ローカル/ネットワークドライブ で有効になっているか確認してください。
インライン検索ウィンドウで中国語(または他の IME 言語)を入力できない
インラインウィンドウは、ドッキング先のウィンドウから実際のキーボードフォーカスをあえて奪わないようにしています — これにより、フォーカスのちらつきなしに、インラインウィンドウを閉じて元の場所にぴったり戻ることができます。しかし IME の変換処理(候補リストと、実際に確定される文字)は、実際にフォーカスを持っているウィンドウ、つまり常にドッキング先のアプリでのみ発生し、SwiftList では決して発生しません。そのため、入力内容を取得するために SwiftList が横取りできるメッセージが存在しません。これはインラインウィンドウの仕組み上の構造的な制約であり、バグではありません。
2つの選択肢があります:
- ピンインのローマ字表記をそのまま入力する(IME の候補ポップアップは不要)— SwiftList は中国語のファイル名をピンインで自動的にマッチさせます。検索構文を参照してください。
- 代わりにクイックウィンドウを使用する(デフォルトでは
Ctrlのダブルタップ)— これは実際にフォーカスを持つウィンドウなので、そこでは IME の変換が通常どおり機能します。
それでも解決しない場合
GitHub に Issue を立てる前に、設定 → サービスの状態 の Service、App、Hook の各ログタブを確認してください — そこの検索ボックスはキーワードで、レベルのドロップダウンは重大度で絞り込みます。