# AI漫画帝国 Studio 3.0 はじめに

## 初めて使うとき

ZIPを「すべて展開」してから、OSに合うファイルをダブルクリックしてください。

- Windows：`00_【最初にクリック】ここから導入（Windows）.vbs`
- Mac：`00_【最初にクリック】ここから導入（Mac）.app`

Studioの配置、必要環境の確認、デスクトップ起動アイコンの作成をまとめて行い、作品一覧を開きます。2回目からはデスクトップの「AI漫画帝国 Studio」をダブルクリックします。普段の起動でターミナル入力やCodexアプリは不要です。

Python 3.9以上またはCodex CLIが不足している場合だけ、初回セットアップ画面が開きます。表示を確認してインストールを許可し、ご自身のChatGPTアカウントでログインしてください。コマンドを自分で入力する必要はなく、APIキーも不要です。パスワードやログイン情報をStudioへ入力しないでください。

ダウンロードしたファイルの初回実行時にはOSの確認画面が出る場合があります。本配布物は署名・公証済みのストアアプリではありません。組織で実行が制限されている場合は、運営または管理者へご相談ください。

## 漫画を作る・続きを作る

1. 作品一覧で仮のタイトルを入力し「漫画づくりを始める」を押します。
2. Step 0の「壁打ちを始める」から質問に答えます。「OK」などの返信候補も使えます。
3. 左側の「作品一覧」へ戻ると、他の漫画を新規作成・再開できます。移動前に自動保存します。
4. 「複製する」で、構成・文章・参照画像をコピーした別作品を作れます。コピー後の編集は元作品に影響しません。

作品のタイトルは制作画面の左上で変更できます。作品ごとに設定、会話、進捗、ページ出力、参照画像を分けて保存します。同じ作品を複数のタブで編集して保存が競合した場合は、上書きを止めて案内します。

## 起動と終了

WindowsでEdge、MacでChromeが使える場合は専用ウィンドウで開きます。それ以外は標準ブラウザで開きます。画面を閉じてもローカルサーバーはバックグラウンドで待機します。

完全に終了したい場合は、設置先の「AI漫画帝国 Studioを終了.bat」（Windows）または「AI漫画帝国 Studioを終了.command」（Mac）を実行してください。PC再起動時にも終了します。

設置先：

- Windows：`%LOCALAPPDATA%\AI Manga Studio`
- Mac：`~/Applications/AI Manga Studio`

## 作品のバックアップ

作品は設置先の `data/` に保存します。フォルダごと別の場所にコピーすると、全作品と参照画像をバックアップできます。コピー前にStudioを終了してください。

制作画面の「書き出し」は、その作品の文章・設定・進捗をJSONとして保存します。**参照画像はJSONに含まれません。** JSONの「読み込み」は新しい作品として追加するので、現在の作品は上書きされません。読み込んだ作品の画像は別途登録してください。

## 旧版から更新するとき

1. 旧版で作品を書き出し、旧版の `data/` フォルダもコピーして保管します。
2. 旧版の終了ファイルを実行します。
3. 旧版のフォルダへ新版の配布内容を重ねてコピーします。`data/` は残してください。
4. 更新したフォルダ内の「ここから導入」を実行します。所定の設置先にデータがまだなければ、旧版の `data/` もコピーされます。
5. 作品一覧から既存作品を開きます。

所定の設置先にすでに `data/` がある場合、導入処理はそれを維持し、別フォルダのデータを上書きしません。別フォルダの作品はJSONから読み込むか、運営へ統合をご相談ください。

## 困ったとき

- 起動できない：初回セットアップを実行してください。WindowsのPython検出には `find-python.ps1` を使います。独自配置のPythonは `STUDIO_PYTHON` 環境変数に実体のフルパスを指定できます。
- 別のStudioが起動中と表示される：そちらの終了ファイルを実行してから起動してください。
- AI接続に失敗する：Codex CLIのログインを確認してください。作品一覧や保存済み内容の確認はAI接続の診断完了を待たずに利用できます。
- 解決しない：作品データは消さず、`data/server.log`（Windowsは `data/server-error.log` も）を運営へお知らせください。

Anifusionでの画像生成は、引き続き手動操作です。
