====================================================
 RelicOCR（遺物儀式画面検出ツール）使い方ガイド
====================================================

■ これは何をするツール？

  エルデンリング ナイトレーンをプレイした動画から、「遺物儀式画面」の
  情報を自動で読み取り、一覧にまとめてくれるツールです。

  さらに、「このキャラでこの効果が欲しい」と条件を入れると、手持ちの遺物の中から
  一番良い組み合わせをコンピューターが自動で計算して提案してくれます。

  大まかな流れはこの4ステップです。

    1. プレイ動画から遺物の画像を切り出す
    2. AI（Claude）に画像を読ませて、遺物の名前と効果をテキスト化する
    3. 読み取った内容を「持っている遺物リスト」としてまとめる
    4. キャラクターと欲しい効果を指定して、最強の組み合わせを検索する


----------------------------------------------------
■ 使い始める前に必要なもの
----------------------------------------------------

  1. Windowsパソコン
       特別なソフトのインストールは不要です（フォルダを展開してすぐ使えます）。

  2. 遺物儀式の画面が映っているプレイ動画
       ファイル形式：mp4 / avi / mov のいずれか
       スマホでの録画でも、キャプチャソフトでの録画でも構いません。

  3. Anthropic（アンソロピック）社のAPIキー　※手順2「AI文字起こし」を使う場合のみ必要
       これはAI（Claude）に画像を読ませるための「利用券」のようなものです。
       下記サイトでアカウントを作り、取得してください。

         https://console.anthropic.com/

       注意点：
        ・このAPIキーは有料サービスの認証情報です。使った分だけ料金が発生します
          （目安：遺物1枚あたり数円程度。事前に「概算費用」が画面に表示されるので、
           内容を確認してから実行するかどうか選べます）。
        ・APIキーは絶対に他人に見せたり、SNSや掲示板に貼ったりしないでください。
          第三者があなたのアカウントを使ってAIを利用できてしまい、高額請求の
          原因になります。
        ・このツールはAPIキーをパソコンに保存しません。起動するたびに毎回、
          画面に入力してもらう仕組みです（入力した文字も画面には表示されません）。


----------------------------------------------------
■ 起動方法
----------------------------------------------------

  1. お渡ししたフォルダ（zipファイル）を、好きな場所に展開（解凍）してください。

  2. フォルダの中にある「RelicOCR.exe」をダブルクリックすると、
     黒い画面（コマンドプロンプトのような画面）が開いて起動します。

     ※ 初回起動時にWindowsが「発行元不明のアプリです」といった警告を出すことが
        あります。信頼できる配布元から入手したものであれば「詳細情報」→
        「実行」を選んで進めてください。


----------------------------------------------------
■ 基本の使い方（メニュー画面の操作）
----------------------------------------------------

  起動すると、以下のようなメニューが表示されます。
  使いたい番号を入力してEnterキーを押すと、その機能が始まります。

    === 遺物儀式画面検出ツール ===
    1. 遺物画像収集
    2. AI文字起こし
    3. 所持遺物リストを再構築
    4. ビルド検索
    0. 終了

  --------------------------------------------------
  【手順1】 まずは動画を用意する
  --------------------------------------------------
    フォルダの中にある「videos」フォルダに、遺物儀式画面を撮影した動画ファイル
    （mp4 / avi / mov）を入れてください。
    （videosフォルダが無ければ、一度起動すると自動で作られます）

  --------------------------------------------------
  【手順2】 メニュー「1. 遺物画像収集」
  --------------------------------------------------
    videosフォルダの中の動画を選ぶと、動画の中から遺物儀式の画面を自動で見つけ出し、
    遺物1つ1つの画像を切り出して保存します。
    動画の長さによっては数分かかることがあります。そのまま待ってください。

  --------------------------------------------------
  【手順3】 メニュー「2. AI文字起こし」
  --------------------------------------------------
    手順2で切り出した画像を選び、AIに読み込ませて「遺物の名前」と「効果」を
    テキストデータに変換します。

    操作の流れ：
      ・対象フォルダを選ぶ（直前に収集した画像のフォルダなど）
      ・処理方法を選ぶ
          1: ランダムでN枚だけ試す（お試し・費用を抑えたいとき向け）
          2: 特定の番号の画像だけ処理する
          3: 全部まとめて処理する
      ・「Anthropic APIキーを入力してください」と聞かれるので、
        持っているAPIキーを貼り付けてEnter（画面には表示されません）
      ・実行前におおよその料金（概算）が表示されるので、確認してから
        続けるかどうかを y（はい）/ n（いいえ）で選べます

    ポイント：
      ・途中で処理を中断してしまっても（Ctrl+Cや、エラーで止まった場合など）、
        次にもう一度この機能を使うと「途中から再開しますか？」と聞かれ、
        続きから処理できます。最初からやり直す必要はありません。

  --------------------------------------------------
  【手順4】 メニュー「3. 所持遺物リストを再構築」
  --------------------------------------------------
    手順3でテキスト化した遺物データをもとに、「今持っている遺物の一覧」を
    作り直します。何かキー入力を求められることは基本的にありません。
    手順2を実行するたびに、このメニューも実行しておくと安心です。

  --------------------------------------------------
  【手順5】 メニュー「4. ビルド検索」
  --------------------------------------------------
    「このキャラクターでこういう効果が欲しい」という条件を入力すると、
    持っている遺物の中から一番スコアの高い組み合わせを自動で探して
    提示してくれます。

    操作の流れ：
      ・キャラクターを一覧から選ぶ
      ・欲しい効果を1つずつ入力していく
          （効果名の一部を入力すると、近い候補がいくつか表示されるので、
           番号で選択してください）
          ・「g」と入力すると、あらかじめ用意された「よくある効果セット」から
            まとめて選ぶこともできます
          ・入力が終わったら何も入力せずEnterで検索開始
      ・結果として、遺物の組み合わせ（最大6個）とスコアが表示されます
      ・気に入った検索条件は「プリセット」として保存でき、次回から
        選ぶだけで同じ条件を呼び出せます


----------------------------------------------------
■ 終了方法
----------------------------------------------------

  メニュー画面で「0」を入力してEnterを押すと終了します。
  （黒い画面のバツボタンで閉じても問題ありません）


----------------------------------------------------
■ よくある質問・困ったときは
----------------------------------------------------

  Q. 「動画ファイルが見つかりません」と表示される
  A. フォルダの中の「videos」フォルダに動画（mp4/avi/mov）が入っているか
     確認してください。

  Q. 「画像が見つかりません。先に検出を実行してください」と表示される
  A. 先に「1. 遺物画像収集」を実行して、遺物の画像を切り出す必要があります。

  Q. AI文字起こしでエラーが出る
  A. 入力したAPIキーが正しいか、Anthropicのアカウントに利用残高があるかを
     確認してください。エラーで止まっても、処理済みのデータは保存されて
     いるので、もう一度実行すれば途中から再開できます。

  Q. AIが読み取った遺物の名前や効果が一部間違っている
  A. AIによる自動読み取りは完璧ではなく、まれに読み間違いが起こります。
     多くの遺物を処理した場合は、結果をざっと見直してから
     「3. 所持遺物リストを再構築」を行うことをおすすめします。

  Q. APIキーは保存されますか？
  A. されません。安全のため、起動して「2. AI文字起こし」を使うたびに
     毎回入力する仕組みになっています。


----------------------------------------------------
■ 配布・取り扱いについての注意
----------------------------------------------------

  ・このツール自体にAPIキーは含まれていません。利用する方がそれぞれ
    自分のAnthropicアカウントでAPIキーを取得し、使うときだけ入力します。
  ・「2. AI文字起こし」を使うとAnthropic社のサーバーに遺物画像が送信されます。
    ゲーム画面の一部が外部サービスに送られることを理解した上でご利用ください。
  ・本ツールで生成される所持遺物データ・検索結果は、お使いのパソコン内にのみ
    保存されます（外部には送信されません）。

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