HD2 Chat Translator　初回設定ガイド
====================================

このファイルは、初めて使う人向けの短い導入手順です。
詳しい機能、ホットキー、調整項目は README_JA.md を確認してください。


1. ZIPを展開する
-----------------

ZIPを右クリックし、「すべて展開」を選んでください。
ZIPの中から直接 Start-HD2ChatTranslator.cmd を起動すると、同梱ファイルを見つけられず起動できません。


2. 必要なもの
--------------

・Windows 11
・Steam版 HELLDIVERS 2
・OpenAI PlatformのAPIキー
・インターネット接続

ChatGPT Plusなどの月額契約とOpenAI APIの料金は別です。
APIは従量課金です。先にAPI側の支払い設定と利用上限を確認してください。


3. OpenAI APIを準備する
------------------------

OpenAI Platformへログインします。
https://platform.openai.com/

このツール専用のプロジェクトを作る方法がおすすめです。

1) Settings → Organization → Projects を開く
2) Create project を押す
3) 名前を「HD2ChatTranslator」などにして作成する
4) 作成したプロジェクトへ切り替える

専用プロジェクトにすると、このツールだけの利用額、APIキー、Share対象を分けて管理できます。


4. 支払いと利用上限を設定する
------------------------------

ChatGPTの有料プランとは別に、OpenAI Platform側でAPIの支払い設定が必要です。

1) Settings → Organization → Billing を開く
2) Payment methods／Billing overviewから支払い方法を登録する
3) 前払い方式が表示された場合は、必要なクレジットを購入する
4) Auto recharge（自動追加購入）が不要なら、初回購入の確定前にOFFにする

2026年8月時点では、前払いクレジットの最低購入額は5米ドルです。購入分は1年で失効し、
原則として返金されません。金額や条件が変わった場合は、購入画面の表示を優先してください。

Auto rechargeは初期状態でONになる場合があります。ONのまま使う場合は、補充額、
補充を開始する残高、月間の自動補充上限を確認してください。

次に、HD2ChatTranslatorプロジェクトの Settings → Limits → Spend で
「Edit spend limit」を開き、月額上限と通知を設定します。
確実に止めたい場合は「Enforce hard limit」（画面によっては「Enforce a hard limit」）を
ONにします。Spend alert／通知だけでは、
上限を超えてもAPIリクエストが継続します。Hard limitも反映が瞬時ではないため、
記録額が設定値をわずかに超える場合があります。

OpenAI公式のSpend limit説明：
https://developers.openai.com/api/docs/guides/spend-limits


5. Share設定を決める（任意）
----------------------------

Shareは翻訳に必須ではありません。OpenAI APIでは、入力・出力の共有は初期状態でOFFです。
変更できるのはOrganization Ownerです。設定が表示されない場合は、現在のOrganizationと
アカウント権限を確認してください。

設定ページ：
https://platform.openai.com/settings/organization/data-controls/sharing

OpenAI公式のShare説明：
https://help.openai.com/en/articles/10306912-sharing-feedback-evaluation-and-fine-tuning-data-and-api-inputs-and-outputs-with-openai

無料トークン特典の対象かは、この画面に
「You're eligible for free daily usage on traffic shared with OpenAI」
などの案内が出ているかで確認します。案内がなければ、現在は対象外です。

共有する場合のおすすめ設定：

1) 「Share inputs and outputs with OpenAI」を探す
2) 「Enabled for selected projects」を選ぶ
3) HD2ChatTranslator専用プロジェクトだけを選ぶ
4) 保存後、「enrolled for complimentary daily tokens」などの表示を確認する

「Model feedback」や「Evaluation and fine-tuning data」のShareは、この翻訳ツールを
動かすためには不要です。無料トークン対象の通信を共有する設定は
「Share inputs and outputs with OpenAI」です。

このツールで共有対象になり得るもの：
・OCRで読み取ったプレイヤー名
・チャット本文
・翻訳結果
・翻訳用に送る直近の会話文脈と用語集

スクリーンショットとAPIキーは、翻訳の入力データとして送信しません。

注意：ShareをONにすると、対象プロジェクトの入力と出力がOpenAIのモデル改善等に
利用される場合があります。プレイヤー名やチャットに個人情報、機密情報が含まれる可能性を
許容できない場合は、ShareをOFFのまま使ってください。無料特典よりプライバシー優先で大丈夫です。

ShareをONにして無料トークン対象になった場合も、APIを使うにはプラスの残高が必要です。
2026年8月時点では、このツールの既定モデル gpt-5.6-luna は特典対象モデルに含まれます。
対象者の1日あたり上限は、Usage Tier 1～2では最大250万トークン、Tier 3～5では
最大1,000万トークンの対象モデル共通枠です。対象モデル・対象者・無料枠は変更されることが
あるため、実際のShare設定画面と上記公式説明の表示を優先してください。


6. APIキーを作成して保存する
------------------------------

HD2ChatTranslator専用プロジェクトへ切り替えた状態で、API Keysを開きます。
https://platform.openai.com/api-keys

1) Create new secret key を押す
2) 名前を「HD2ChatTranslator」などにする
3) Projectが専用プロジェクトになっていることを確認する
4) PermissionsはRestrictedを選び、ResponsesのWriteを許可する
5) 作成直後に表示されたAPIキーをコピーする

権限画面でResponsesを個別指定できない場合や、Restrictedで権限エラーになる場合だけ、
Allで作り直して動作確認してください。Read Onlyでは翻訳リクエストを送信できません。

APIキーは秘密情報です。作成後に表示される完全なキーは再表示できない場合があります。
チャット、スクリーンショット、配布ZIP、公開リポジトリへ貼らないでください。

次に、展開したフォルダーの Save-APIKey.cmd を起動し、コピーしたAPIキーを貼り付けてEnterを押します。

openai-api-key.dpapi が作成されます。このファイルは同じWindowsユーザーでのみ復号できますが、
APIキーを利用するための重要なファイルです。他人へ送らないでください。

キーを保存したくない場合は、Save-APIKey.cmdを省略できます。その場合は起動時に毎回入力します。


7. WindowsのOCR言語を確認する
--------------------------------

Windowsの「設定」→「時刻と言語」→「言語と地域」で、翻訳したい言語の言語機能を追加します。

推奨：
・英語（米国）
・中国語（簡体字、中国）
・韓国語
・ロシア語
・スペイン語（メキシコ）
・日本語

すべて必須ではありません。インストール済みのOCR言語だけが使われます。

起動時のPowerShell画面に、実際に使用する `OCR: 言語タグ` が表示されることを確認してください。複数のOCR言語が入っている環境では複数表示されます。設定タグと実際のタグが地域コード違いでも、同じ言語族（中国語は簡体字／繁体字を維持）へ自動照合されます。解決できない設定は起動時にまとめて警告されます。


8. ゲーム画面を設定する
-----------------------

Settings-HD2ChatTranslator.cmd を起動します。

初期値は次の環境向けです。

・ゲーム画面の左上：X=0、Y=0
・ゲーム解像度：2560×1440
・ゲーム画面：メインモニター

初期値と異なる場合：

1) 「検出したモニター」からゲームを表示するモニターを選ぶ
2) ゲームがそのモニター全面に表示されるなら、表示された幅と高さをそのまま使う
3) ゲーム内解像度が異なる場合は「ゲーム解像度・幅／高さ」を修正する
4) 「この画面設定からOCR範囲と待機位置を自動計算」を押す
5) 下のOCR範囲などを確認し、最後に「保存」を押す
6) 翻訳ツールを再起動する

複数モニターでは、左側のモニターに負のX座標が表示される場合があります。異常ではありません。


9. ゲームと翻訳ツールを起動する
---------------------------------

1) HELLDIVERS 2を起動する
2) 必要ならゲームの表示モードを「ボーダーレスウィンドウ」にする
3) Start-HD2ChatTranslator.cmd を起動する
4) 白縁の待機アイコンが表示されることを確認する
5) 待機中アイコンを左ドラッグして位置を変え、マウスを離すと保存されることを確認する。アイコンの矩形内はゲームをクリックできないため、キーボードで移動する場合は Ctrl + Shift + Alt + 矢印を使う
6) 他プレイヤーの「名前: 本文」形式のチャットで翻訳を確認する


10. 読取り範囲を確認する
-----------------------

認識しない場合は、設定画面で「last-capture.png を保存」をONにして翻訳ツールを再起動します。
作成された last-capture.png に右側チャット欄が入っているか確認してください。

確認後は画像保存をOFFに戻すことをおすすめします。
last-capture.png にはゲーム画面、プレイヤー名、チャット内容が写る可能性があります。


11. 停止や誤動作が起きたとき
---------------------------

・通知領域のアイコンを右クリックし、一時停止／再開を試す
・Ctrl + Shift + F10で一時停止／再開
・Ctrl + Shift + F12で終了
・startup-error.log の末尾を確認する

ログにはAPIキーを記録しません。展開先とWindowsユーザーフォルダーは原則として
<APP_FOLDER>／<USER_PROFILE>へ置換しますが、他人へ送る場合は念のため内容を確認してください。


12. 他人へ再配布するときに除外するファイル
-----------------------------------------

次のファイルは送らないでください。

・openai-api-key.dpapi
・startup-error.log
・last-capture.png

配布用ZIPには、各利用者が自分の環境で作成するこれらのファイルを含めないでください。

assets内の画像には、入手元ごとの利用規約や再配布条件があります。
このガイドは画像素材の再配布許可を保証するものではありません。共有前に配布元の条件を確認してください。


13. このツールが扱うデータ
---------------------------

・ゲーム画面の指定範囲をWindows内蔵OCRでローカル解析します
・OpenAI APIへ送るのはOCR後のチャット文字列と直近の会話文脈です
・スクリーンショットやAPIキーをOpenAI APIへの翻訳本文として送信しません
・OpenAI Responses APIでは store: false を指定しています
・store: falseはAPIレスポンスを後から取得するための保存をしない指定です
・Share設定はstore: falseとは別の組織／プロジェクト設定です。ShareをONにした場合は、
  対象プロジェクトのAPI入力と出力が共有対象になります
・ゲームへのDLL注入、メモリ読取り、ゲームファイル変更、キー自動入力は行いません
