トラブルシューティング
1FileTool のよくある問題の直し方をまとめました：インストーラーの警告、実行エラー、OCR とモデルダウンロードの停滞、日次制限の通知、ライセンス認証の失敗、AI Chat が応答しない場合——症状ごとのセクションで具体的な解決手順を示します。
1FileTool の問題のほとんどは、インストーラー、初回ダウンロードのブロック、あるいは Replace source が書かれたとおりに動いたことが原因です——症状に合うセクションを進めてください。
インストールとアップデート
Windows が「Windows protected your PC」と表示する（SmartScreen）。 Windows インストーラーはまだコード署名されていないため、SmartScreen が初回起動時にフラグを立てます。More info → Run anyway を選んでください——ダウンロードは公式リリースからです。（macOS ビルドは署名・公証済み。この警告は Windows のみです。）
AppImage が Linux で起動しない。 実行権限を付けてください（chmod +x）。ディストリビューションに FUSE がない場合は libfuse2/fuse をインストールするか、--appimage-extract-and-run 付きで実行します。Linux ビルドは未署名です——パッケージマネージャーが .deb にも警告を出すことがあります。
Windows や Linux に ARM ビルドはありません。 アプリが ARM ビルドを出すのは Apple Silicon のみです。Windows と Linux は x64 がサポートされています。
アップデート： アプリメニュー（macOS）または File メニュー（Windows/Linux）の Check for Updates... を使います。アプリは6時間ごとに GitHub Releases も自動チェックします。Settings › Updates で管理します。
ツールの実行
まず元ファイルを守る
Replace source はデフォルトでオンです。出力が元ファイルを上書きし、バックアップは残りません。手順を始める前に Settings › General を開いて Replace source をオフにするか、別の出力フォルダを選んでください。
結果が見つからない。 実行後の結果カードを確認し、次に History を見てください——すべての実行が記録されています。Replace source がオンだった場合、出力は元のファイルそのものです（その場で上書き）。オフだった場合は ~/Documents/1FileTool または Change で選んだフォルダを確認してください。
ツールがエラーメッセージ付きで失敗した。 結果カードにエラーテキストが表示されます。再試行前にコピーしておきましょう。よくある原因：そのツールが入力形式をサポートしていない（例：HEIC は入力専用——HEIC への変換はできません）、ソースファイルの破損、ファイルが別アプリにロックされている。
出力ファイルが元より大きい。 それは正当に起こりえます——ソースによっては（最適化済みファイル、PNG として再エンコードされた低品質 JPEG など）縮みません。結果カードは常に前後のサイズを表示するので、隠されるものはありません。
OCR の結果が文字化けまたは空。 Tesseract.js は英語のみで、検索可能な PDF ではなく .txt ファイルを書き出します。手書きや低解像度スキャンはうまく読めません。
AI 機能がモデルのダウンロードを求めてきた。 想定どおりです——ボイス（Hugging Face から約63 MB）や Background Removal（GitHub から約178 MB）の初回使用時にモデルを一度だけダウンロードします。止まったら接続を確認して再試行してください。ダウンロード後はオフラインで動きます。
制限とライセンス
「Daily limit reached — resets tomorrow」。 無料プランは暦日ごとに8出力ファイルを数えます。サイドバーのカウンターが現在位置を示します。Pro は上限を解除します——無料版と Pro を参照。
ライセンス認証に失敗した。 Settings › License でキー全体を貼り直し、デバイス上限（1/3/5）内にいるか確認し、同じタブから古いデバイスを無効化してから再試行してください。認証には Lemon Squeezy へのネットワークアクセスが必要です。
AI Chat
AI Chat が動かない。 これはあなたが自分でインストールした AI CLI（Claude Code、Gemini CLI、Codex など）へのブリッジです——CLI はインストールかつサインイン済みである必要があり、モデルプロバイダーは読んだものをすべて見ます。自動セットアップは Claude Code と Gemini CLI をカバーし、他の CLI は手動設定が必要です。何も応答しない場合は、ターミナルを開いて CLI が単体で動くか先に確認してください。