プレート

UIが描画するのと同じコードでCLIから直接レンダリングされます — python docs/make_plates.py で再生成できます。

同じバイト、1つの数値だけが異なります。これがストライド提案機能が存在する理由です：誤った行ストライドは写真を斜めのノイズに変え、写真が存在しないと結論づけてしまうからです。

ARCHITECTURE.md はその構成方法を示しています：何が提供されるか、すべてのサーフェスが継承するブランディング、新しい画面が従うべき規約、そして意図的な制限事項です。SECURITY.md はセキュリティ態勢です。

クイックスタート

サーバーの実行

セッショントークンを含むURLが表示されるので、それを開いてください。すべての /api ルートはトークンを必要とします。なぜなら「localhost のみでリッスンする」ことは、別のタブのWebページに対する防御にはならず、他のオリジンと同様に 127.0.0.1 に到達できるからです。SECURITY.md にその理由が記載されています。

ファイルアクセスは --root（デフォルト：作業ディレクトリ）に制限されており、その外のパスは拒否されます。

制限

4つすべてにフラグと環境変数があり、4つすべてがローカル呼び出しが意図以上にリソースを消費するのを防ぐために存在します。デフォルトはラップトップ向けに選択されています。マシンがより大きい場合は引き上げてください。

解析は ~/.cache/binviz（または $BINVIZ_CACHE）にコンテンツハッシュをキーとしてキャッシュされるため、バイナリを再度開くのは即座です。より多く保持したい場合は --max-cache を引き上げてください。キャッシュはいつでも手動で削除しても安全です — 最悪の場合、次回のオープンで再解析されるだけです。

その他のフラグ：--token は再起動をまたいでトークンを固定します（BINVIZ_TOKEN を読み取る Vite dev プロキシで便利）、--port、--cache、CI 用の --no-auth。--no-auth は何を無効にしたかを示すバナーを表示します。共有マシンでは使用しないでください。

デスクトップウィンドウ

binviz serve と同じサーバー、同じトークン、同じ --root 制限 — 違いは表示方法だけです。pywebview がインストールされていない場合、binviz app は代わりにブラウザを開きます。

提供中のURLを意図的に表示します：UIをウィンドウにラップしてもネットワークリスナーは削除されず、存在を忘れやすくなるだけです。リスナーはいずれにせよ認証されており、binviz app には --no-auth はありません。

ウィンドウはページに対して正確に1つの関数 — ネイティブファイルピッカー — のみを公開し、それ以外は何も公開しません。そのリストがなぜこれほど短いかの理由は src/binviz/app.py を参照してください。

スタンドアロンアプリのビルド

リリースはホイールのみを提供します。capstone と lief をバンドルし、パックされたバイナリの解析のために存在する署名なしのフリーズ済み Python 実行可能ファイルは、まさに SmartScreen と AV ヒューリスティックが誤検知するプロファイルです — そのため、それを提供する代わりに、リポジトリには自分でビルドするために必要なものが含まれており、コード署名を完全に回避します。

約100 MB を想定してください。numpy と lief が大部分を占めます。これは onedir バンドルであり、単一の自己解凍ファイルではありません：デスクトップウィンドウ用に dist/binviz/binviz.exe を起動するか（またはダブルクリック）、任意のサブコマンドを渡します — dist/binviz/binviz.exe triage sample.exe — フリーズ済みビルドはウィンドウだけでなくCLI全体だからです。

ステージング手順は必須です。web/dist は Python パッケージの外にあるため、これをスキップするとウィンドウが JSON 404 で開くアプリが生成されます。spec はこれを静かに起こさせずにビルドを拒否します。

macOS では同じコマンドで packaging/icons/icon.icns からブランド化された dist/Striate.app も生成されます。どちらも Mac で実行されたことはありません — ARCHITECTURE.md §5 を参照してください。

--root は依然として作業ディレクトリをデフォルトとするため、ダブルクリックされた実行可能ファイルは起動したフォルダに制限されます — 通常はアプリ自身のフォルダです。ショートカットの「作業フォルダー」を設定するか、--root DIR を指定して起動してください。

ダブルクリックされた実行可能ファイルは資格情報を要求します。 引数なしの場合、フリーズ済みビルドは binviz app --auth local を実行します。これはホイールのデフォルト（サインイン画面なし）との唯一の違いです。この2つは異なる問いに答えます：ターミナルに入力された binviz app はセッション所有者による意図的な行為ですが、ダブルクリックは何も確立しません — ターミナルなし、入力されたコマンドなし、制限の決定なしの唯一の起動経路です。資格情報を要求することは、ウィンドウがターミナルが言うであろうことを声に出して言う方法です。先に binviz passwd を実行して設定するか、--auth none を明示的に渡してスキップしてください。コマンドラインで指定したものは常に優先されます。

サインイン

デフォルトではログイン画面もコピーするものもありません：サーバーはセッショントークンを生成し、提供するページに注入するため、http://127.0.0.1:8000/ を開くだけで機能し、すべてのAPI呼び出しは依然として認証されています。

共有マシンでは、サインイン画面を有効にしてください：

binviz passwd をスキップすると、最初のサインインがインストールを主張します — 起動バナーがこれについて警告します。なぜなら、ポートに最初に到達した人がアカウントになるからです。

ダブルクリックされたフリーズ済み実行可能ファイルは自身で --auth local を有効にします。このデフォルトがホイールと異なる理由は スタンドアロンアプリのビルド を参照してください。

ログイン画面はセキュリティ境界ではありません。すべての /api ルートのトークンチェックが境界です。マシン上の何でもフォームをスキップしてAPIを直接呼び出すことができ、これこそがトークンが存在する理由です。SECURITY.md を参照してください。

セキュリティ

binviz は攻撃者が選択したファイルを開きます — これはエッジケースではなく仕事であり、マルウェアの解析がアナリストを危険にさらすトリアージツールは利用可能な最悪の失敗です。サンプルは解析され、実行されることはありません。 残りについては以下の対応が行われています：

悪意のあるバイナリに対して

• 解析は失敗するのではなく劣化します：LIEF が解釈できないバイナリは生のモデルにフォールバックするため、最も解析したい不正なサンプルも依然として検査可能です。
• すべてのマッピングは EOF にクランプされ、切り詰められたものは静かに修正されるのではなく、モデルの警告で報告されます。
• 逆アセンブルは無限ループできません — スイープは100万命令で上限に達し、訪問済みセットを保持するため、自己ジャンプはタイムアウトではなく構造的に終了します。ジャンプテーブル復元は256エントリで上限に達します。
• キャッシュパスはトラバースできません：すべての /api/{id}/… ルートの id は、パスの構築に使用される前に正確に64文字の16進数でなければなりません。
• 大きなファイルはバッファリングではなくストリーミングされるため、RAM より大きいファイルはメモリ不足クラッシュではなく遅くなるだけです。

悪意のあるブラウザに対して — 「localhost のみでリッスンする」という脅威は対処しません。なぜなら、別のタブのページは他のオリジンと同様に 127.0.0.1 に到達できるからです：

• すべての /api ルートはトークンを必要とします。 起動時に生成され、ページに注入されるため、手動で貼り付けるものはなく、開かれたルートもありません。
• ログイン画面はセキュリティ境界ではありません — トークンチェックが境界です。フォームはスキップできますが、トークンはスキップできません。
• ファイルアクセスは --root に制限され、デフォルトは作業ディレクトリです。その外のパスは拒否されます。
• Host 許可リストと狭い CORS により、アクセスが必要なオリジンのみがアクセスを取得します。
• バイナリメタデータはスクリプトになり得ません：サンプルから抽出された文字列 — セクション名、シンボル — は CSP でバックアップされた単一のエスケーパーを通過します。
• リクエストは制限され検証されます — アップロードサイズ、キャッシュサイズ、ラスターディメンション、解析同時実行数にはすべて上限があります（制限 を参照）。

デスクトップウィンドウはネットワークリスナーを削除せず、存在を忘れやすくするだけです。そのため binviz app には --no-auth はなく、js_api ブリッジは正確に1つのメソッド — pick_file()（引数なし、同じ --root 制限を通じてパスを返す）— のみを公開します。2番目のメソッドが現れた場合、テストは失敗します。

--auth local の資格情報はモード 0600 で書き込まれる scrypt ダイジェストです。binviz は平文パスワードを保存しません。

SECURITY.md には脅威モデル、各制御の背後にある理由、意図的にまだ行われていないこと、および脆弱性を非公開で報告する方法が記載されています。

ライセンス

MIT — LICENSE を参照してください。

コーパスは zig cc で ELF サンプルをクロスコンパイルするため、Windows/macOS で Linux ツールチェーンは不要です — サンプルは解析され、実行されることはありません。