印刷ファイルの文字化け事前チェック

印刷を開始する前に、G コードファイルに対してローカルでの事前チェックを行います。ファイルが破損・文字化けしていないかを確認し、印刷範囲、サイズ、造形高さ、レイヤー数などの情報を集計します。

機能概要

文字化け / 破損チェック：バイト単位で UTF-8 の正当性を検証し（ブロックをまたぐマルチバイトシーケンスにも対応）、最初の不正バイトの行番号とバイトオフセットを正確に特定します。スライサーソフトが GBK などのエンコーディングで中国語を書き込んだことによる非 UTF-8 や、コピー時の破損などの文字化け問題を識別できます
制御文字検出：G コード内で 0x00–0x1F に破損した異常バイト（例：パラメータ文字 E が 0x05 に変更されている）を専門に識別します。これらのバイトは正当な ASCII であり UTF-8 検証では発見できませんが、Klipper が該当行の解析でエラーを起こします。ツールは該当する行番号とバイトオフセットを提示します
非 ASCII 統計：ファイル内の非 ASCII バイト数を集計します。ファイルが正当な UTF-8 であれば、これらのバイトがコメント内に現れても中国語のパラメータ名（ヒータ名など）に現れても破損とはみなされず、印刷に影響しません。命令行に非 ASCII が含まれる場合は、該当する行番号を中立的にリスト表示して照合に供します
印刷範囲分析：G0 / G1 の座標を解析し、X / Y / Z 各軸の最小値、最大値、ストロークを提示し、印刷サイズ（X × Y）、造形高さ（Z）を集計します
印刷情報統計：印刷サイズ（X × Y）、造形高さ（Z）、印刷レイヤー数を推定します
ホスト機のリモート読み取り：ホスト機の IP を入力して Moonraker に接続すると、2 種類のソースからファイルを選択してダウンロードし、ブラウザ上でローカルに事前チェックできます。いずれも最新時間の降順です：
- 印刷ファイル：gcodes ディレクトリ（サブディレクトリを含む）内の G コードファイルをリスト表示し、更新時間の降順で並べ、行内でモデルのサムネイルを遅延読み込みします（リストはデフォルトで最初の 50 個を表示し、「さらに表示」が可能）
- 履歴タスク：印刷履歴（Moonraker History コンポーネント）を読み取り、最近の印刷時間の降順で並べ、ステータス、所要時間、フィラメントを表示し、サムネイルが存在する場合はモデルのプレビュー画像を表示します。いずれかの項目をクリックすると、対応する G コードファイルをダウンロードしてローカルで分析できます
ローカル解析：すべての分析はブラウザ上でローカルに完了し、ファイルの内容がサーバーにアップロードされることはありません

注意事項

.gcode / .gco / .gc / .g / .nc などの一般的な印刷ファイル拡張子に対応しています
より良い体験のために PC でのアクセスを推奨します。大容量ファイル（数百 MB など）の分析には時間がかかる場合がありますので、プログレスバーが完了するまでお待ちください
印刷範囲とレイヤー数は G コードの運動命令に基づいて集計されたもので、空走移動を含む参考値です。実際の造形サイズはスライサーソフトを基準としてください
ファイルが非標準の命令形式や大量のカスタムマクロを使用している場合、範囲の集計が不完全になる可能性があります
ホスト機のリモート読み取りは読み取り専用の操作で、gcodes ディレクトリ内の G コードファイルのダウンロードと印刷履歴の読み取りのみを行い、ホスト機のファイルを変更・削除することはありません。現在のブラウザがホスト機の Moonraker（デフォルトポート 7125）にアクセスできる必要があり、ネットワークが不通の場合や HTTPS の混在コンテンツを使用している場合は接続に失敗することがあります。その場合はローカルアップロードに切り替えてください