キュー外で同じデコーダーを使ってRAWファイルを1つテストし、ワーカーへの割り当てとジョブログを比較して、形式のサポート状況と実行時の障害を切り分けます。
元のRAWファイルは正常にインポートされるが、プレビューが空白または保留中のままになる場合、この判断が重要になります。競合する状態は、RAWデコードが非対応または失敗している状態と、サムネイルのキュー、ワーカー、権限、または出力ストレージの障害です。保存済みの設定と使い捨てデータを使って開始し、一度に1つの分岐だけを観測します。テストによってデータ損失、権限、または可用性のリスクが拡大する場合は中止してください。
RAWデコードが非対応または失敗している状態と、サムネイルのキュー、ワーカー、権限、または出力ストレージの障害を切り分ける
何かを変更する前に、ソフトウェアとファームウェアのバージョン、デバイスの識別情報、マウント先またはネットワークパス、空き容量、権限、観測された症状など、環境を記録します。元のRAWファイルは正常にインポートされるが、プレビューが空白または保留中のままになる状態を再現できるだけの詳細を、ベースラインに残してください。
1つ目の候補は、RAWデコードが非対応または失敗していることです。2つ目は、サムネイルのキュー、ワーカー、権限、または出力ストレージの障害です。現在のImmichがサポートするメディア形式は、テストで使う仕組みやコマンドの境界を定めるものであり、このホームサーバーでの実際の観測に取って代わるものではありません。
判別テストの実行前に、合格条件と中止条件を記述します。合格するには、他の無関係なサービスに変化を与えずに、片方の仮説が予測する証拠に変化が見られる必要があります。不合格の場合は、推測に基づく修正を連鎖させるのではなく、保存した状態にシステムを戻す必要があります。
管理された条件下で判別テストを実施する
この判別テストを実行します。コピーしたRAWファイル1つに対してメタデータとデコードのプローブを実行し、サムネイルジョブを1件キューに追加して、キューから出力ファイルまで追跡します。結果を変更した変数に帰属できるよう、ワークロード、クライアント、パス、ファイルセット、タイミングを一定に保ちます。
libvipsのデコーダーサポートを使って、分岐を実際に切り分けられる項目を選び、そのタイムスタンプ、終了ステータス、エラーテキスト、デバイスまたはスナップショットの識別情報、レイテンシ、転送バイト数、権限、復旧状態を記録します。識別情報、耐久性、アプリケーションの状態が検証対象の主張である場合、コマンドが正常終了しただけでは不十分です。
元の条件に含まれている場合は、再起動、再接続、再マウント、またはキャッシュのコールド状態の後にテストをもう一度行ってください。最初の実行で破壊的な変更が生じる場合や、環境を復元できない場合は中止し、代わりに使い捨てのコピーで再現してください。
exiftool sample.CR3
# インストール済みの画像処理スタックでコピーをデコードし、サムネイルジョブを1件キューに登録する
証拠がどの分岐を裏付けているかを判断する
合格:デコーダーがキュー処理の前に失敗するか、デコードが成功してもワーカーが派生ファイルを書き込みません。結論が普遍的な主張にならず、条件付きのまま保たれるよう、合格した正確なバージョン、ID、ワークロードを記録してください。
不合格:1台のカメラまたは1つの圧縮方式だけで失敗した場合は、そのサンプルに限定してサポートを行います。不合格だからといって、反対側の分岐が自動的に立証されるわけではありません。ネットワーク、メモリ、権限、ソースの一貫性は両方に影響する可能性があるため、エスカレーションする前に、これらの共通依存要因を切り分けてください。
例外または結果が不明確な場合:オリジナルを保持し、再試行の連発を止め、調査中は正常動作が確認済みのJPEGプレビュー経路を維持してください。ログを保存し、復元可能なコピーを作成するまでは、修復、刈り込み、破壊、パーティション再作成、再帰的な所有権変更の各コマンドを実行しないでください。
該当するアクションを適用して、元の障害を再現する
観測された分岐に対応するアクションを適用し、簡略化した代替条件ではなく、元の条件を再現してください。この判定が有効なのは、デコーダーがキュー処理の前に失敗する場合、またはデコードが成功しても、2サイクルにわたって、あるいは該当する再起動、スリープ、中断、負荷変化の後もワーカーが派生ファイルを書き込まない場合に限られます。
読み取り専用のImmichライブラリを使って、最も近い依存ワークフローを確認します。ただし、元のトリガー条件は変更しないでください。無関係なデータセット、共有、コンテナ、ユーザー、復旧ポイントについては、アクセス権とタイミングを以前の状態に保つ必要があります。
停止境界は明確です。1台のカメラまたは1つの圧縮方式だけで失敗した場合は、そのサンプルに限定してサポートを行い、最後に検証済みの構成に戻し、証拠を保持します。より詳細なプラットフォームまたはハードウェアのテストに進むのは、その分岐が再現可能な場合に限ります。
目的の結果が維持されていることを確認したら、サムネイルジョブのスケジューリングと比較し、修正によって隣接するサービスにリスクが移っていないことを確認してください。対象のテストに成功しても、新たなバックアップ、ID、タイムアウト、または可用性の問題が発生した場合は、変更は失敗です。
よくある質問
RAWプレビューが表示されない問題の診断では、残る検索の多くは、同じカメラのRAWファイルでも処理できるものとできないものがある理由、ファイル権限が正しく見えてもワーカーが失敗する可能性、プレビューをライブラリ全体で再生成すべきかどうかに関するものです。以下の回答では、こうした例外的なケースを主要な判断基準とは分けて説明します。
合否の境界は変わりません。デコードがキュー処理より前に失敗するか、デコードは成功しているのにワーカーが派生ファイルを書き込まないかです。後続の条件によってファイルシステム、ID、ネットワークパス、またはアプリケーションのバージョンが変わる場合は、その変更の影響を受ける判別テストだけを繰り返してください。
特定のカメラまたは圧縮方式だけで失敗する場合は、サンプルを特定してサポートを求める必要があるため、実験の範囲を広げるのはやめてください。その場合は、オリジナルを保管し、リトライの集中を止め、調査中も動作確認済みのJPEGプレビューパスを維持してください。プラットフォーム、ストレージ、またはハードウェアの担当者にエスカレーションする前に、証拠を保全してください。
同じカメラのRAWファイルでも、正常に処理できるものとできないものがあるのはなぜですか?
同じ拡張子でも、カメラのファームウェア、圧縮方式、埋め込みプレビュー、デコーダーのバージョンが異なる場合があります。
ファイル権限が正しく見えても、ワーカーが失敗することはありますか?
はい。ワーカーでは、コンテナパス、UID、出力マウントが異なる場合があります。
プレビューをライブラリ全体で再生成すべきですか?
サンプルが1つ正常に処理され、キューとストレージに作業を処理できる余裕ができるまでは、行わないでください。
同じワークロードで、原因が未対応または失敗したRAWデコード、あるいはサムネイルキュー、ワーカー、権限、出力ストレージの障害にあるという証拠が再現され、対応する処置によって別の症状を引き起こすことなく元の症状が解消した時点で、診断は完了です。どちらの原因も再現性がない場合は、ログと保存状態をそのまま保ってください。不確実であれば、修正を重ねるのではなく、エスカレーションしてください。
サポートとヒント
続きを読む

How to Keep Adult Videos on Your NAS Hidden from Family Members
Keep adult videos private on a family NAS. Check folder permissions, Plex and Jellyfin library access, thumbnails, watch history, shared TV logins and DLNA.

Transformersでコミュニティモデルを読み込む前に確認すべきこと
TransformersのJinjaサンドボックスアップデートを使って、モデルの来歴、チャットテンプレート、リモートコード、シリアライズされた重み、隔離された初回実行を確認しましょう。

Mirageをローカルで実行:1枚の画像から文字認識と物体検出
Cactus Computeの小型ローカルビジョンモデルを試し、実際の入力でOCRとオブジェクト抽出を検証して、メモリ、言語、プライバシーの制限を把握しましょう。



