自動パッチ適用ツール (apply_patch)

========================================

 自動パッチ適用ツール (apply_patch) 取扱説明書

========================================

■ ツール概要

本アプリは、AI（ChatGPT等）を用いたコード修正のやり取りで出力される 

「SEARCH/REPLACEブロック」を、専用のGUI操作で対象のPythonファイルなどへ 

安全かつ一括で適用するためのデスクトップツールです。

■ 動作環境

・OS: Windows 10 / 11 (64bit)

・前提条件: 特殊な事前インストールは不要です（Python環境がないPCでも動作します）。

■ 起動方法

1. 配布されたZIPファイルを任意の場所に解凍します。

2. 解凍したフォルダ内にある実行ファイル（例: `apply_patch.exe`）をダブルクリックして起動します。

   ※初回起動時は内部の準備等でわずかに立ち上がりに時間がかかる場合があります。

■ パッチコードのフォーマット（出力形式）

AIにコード修正を依頼する際は、以下のフォーマットで出力させてください。

複数の修正ブロックが縦に並んでいる場合も、そのまま一括で貼り付けることができます。

<<<<<<< SEARCH

修正前の該当コード（周辺のコードを含む）

=======

修正後の該当コード（周辺のコードを含む）

>>>>>>> REPLACE

【文字コード・改行コードについての補足】

・パッチテキストやパッチファイルは、基本的には UTF-8 (BOMなし) での保存・コピペを推奨します。

・本ツールは内部で UTF-8 および Shift-JIS の自動判定、ならびに Windows/Mac等の改行コードの自動正規化を行っているため、一般的なテキストであればそのまま適用可能です。

■ 使い方

1. 対象ファイルの指定

   ・「対象Pythonファイル」の「参照...」ボタンを押して、パッチを適用したい .py ファイルなどを選択します。

   （※同じフォルダ内にPythonファイルが1つだけ存在する場合は、自動的にパスが検出されます）

2. パッチコードの入力

   ・AIから出力された修正コードを、ツール中段の大きなテキストエリアにそのまま丸ごとコピー＆ペーストします。

   （※複数のブロックが連続していても、まとめて貼り付け可能です）

3. パッチの実行

   ・「パッチを実行する」ボタンをクリックします。

   ・処理結果やデバッグログが下部のコンソールエリアにリアルタイムで表示され、成功するとポップアップでお知らせします。

■ トラブルシューティング

・「WindowsによってPCが保護されました」と表示される場合

  個人開発のフリーソフト特有の警告です。「詳細情報」をクリックし、

  「実行」ボタンを押すことで通常通り起動できます。

・「一致するコードが見つかりませんでした」とエラーが出る場合

  対象ファイルのコードと、AIが指定した SEARCH ブロックのインデントや

  前後数行のコンテキスト（周辺コード）に差異がないかご確認ください。