==================================================
PIXTA Uploader GUI Free（Windows GUI版 / 体験版）
==================================================

【体験版の制限】
・本体験版は動作確認用です（本番投稿の完了はできません）
・`テスト実行（実際には投稿しない）` のみ利用できます（最終審査申請は行いません）
・投稿情報CSVファイルの実行は1件までです
・画面を表示しない実行は利用できません

【有料版への案内】
・複数件の投稿情報CSVファイル実行、本実行（テスト実行OFF）、画面を表示しない実行は有料版の対象です
・まずは体験版で「環境で動くか」「操作感が合うか」を確認してください

【概要】
本ツールは、PIXTA への作品投稿作業を 投稿情報CSVファイル（`.csv`）+ 画像フォルダで順次実行するWindows向けGUIアプリです。

ブラウザのインストール、手動ログイン情報の保存、投稿実行をGUIから操作できます。

※ 本ツールは PIXTA の公式ツールではありません。
※ 画面付きの詳しい操作手順は、同梱の `manual.pdf` を参照してください。


==================================================
最短の使い方（初回セットアップ）
==================================================

1. ZIPを展開し、書き込み可能な場所に配置する
2. `PixtaUploaderGUI.bat` を起動する
3. `ブラウザをインストール` を押してブラウザを準備する（初回のみ）
4. `ログイン情報を作成` を押し、手動ログインしてログイン情報を保存する
5. 画像フォルダ / 投稿情報CSVファイル / 各設定を確認し、`投稿を開始` を実行する

※ `Program Files` 配下は避け、`data/` `log/` `runtime/` に書き込み可能な場所へ展開してください。


==================================================
テスト実行での事前確認（推奨）
==================================================

初回は `テスト実行（実際には投稿しない）` をONにして 1件だけ確認することを推奨します。

・アップロード、入力、登録ボタン押下（「選択した作品を登録」）までは実行します
・最終の審査申請ボタン（表示された場合）は押しません
・実際の登録完了までは進めません

【初回確認のおすすめ手順】
1. `sample.csv` をコピーして、まずは1件だけ残す
2. `テスト実行（実際には投稿しない）` を ON にする
3. `投稿を開始` を実行する
4. 実行結果ファイル（`result.csv`）とログを確認する


==================================================
配布物の構成（展開後）
==================================================

PixtaUploaderGUIFree
├─ PixtaUploaderGUIFree.bat   （起動用バッチ）
├─ app/                   （実行ファイル一式）
├─ data/                  （設定 / ログイン情報 / 実行結果ファイル などの保存先）
├─ log/                   （アプリログ）
├─ runtime/
│  └─ ms-playwright/      （ブラウザの保存先。初回「ブラウザをインストール」で作成）
├─ LICENSES/              （第三者ライセンス）
├─ LICENCE.txt            （使用許諾）
├─ README.txt             （本ファイル）
├─ sample.csv             （投稿情報CSVファイルのサンプル）
└─ manual.pdf             （画面付き操作マニュアル。同梱時）


==================================================
主な機能
==================================================

・ブラウザのインストール
・ログイン情報作成（手動ログイン後にログイン情報ファイルを保存）
・投稿前の詳細チェック（投稿情報CSVファイル / 画像 / ログイン情報 / 実行環境 / 待機秒数）
・投稿情報CSVファイルの一括実行（体験版は1件まで）
・テスト実行（最終審査申請をスキップ / 体験版では固定）
・画面を表示しない実行（有料版機能）
・ログ / エラー証跡（失敗時スクリーンショット・HTML保存）


==================================================
実行結果ファイル（result.csv）の見方
==================================================

実行結果は、`ログイン情報を保存したフォルダ/result.csv` に出力されます。

主な `status` の意味:

・`ok`      : 投稿処理が完了した
・`dry_run` : テスト実行で確認完了した
・`error`   : エラーで処理失敗した
・`aborted` : 停止操作により中断した


==================================================
注意事項
==================================================

・PIXTA 側の画面仕様変更により動作しなくなる可能性があります
・本ツールは自動ログインしません（`ログイン情報を作成` は手動ログイン）
・初回は `ブラウザをインストール` によりブラウザのダウンロードが発生します
・ログイン情報ファイルはログイン状態を含むため、第三者に共有しないでください
・体験版では本番投稿完了（最終審査申請）はできません


==================================================
トラブル時の確認先
==================================================

・アプリログ: `log/app.log`
・投稿失敗時の証跡: `ログイン情報を保存したフォルダ/log/screenshots/`, `ログイン情報を保存したフォルダ/log/html/`
・実行結果: `ログイン情報を保存したフォルダ/result.csv`

確認順（推奨）:
1. `result.csv` で失敗行（`status=error`）を確認
2. `log/app.log` で `row=` と `現在URL[...]` を確認
3. `ログイン情報を保存したフォルダ/log/screenshots/` と `log/html/` を確認


==================================================
サポート対象外（参考）
==================================================

・PIXTA 側の仕様変更 / UI変更 / 審査結果
・アカウント制限や確認要求
・利用者環境起因の通信制限（企業PC / プロキシ / セキュリティ製品等）


==================================================
第三者ライセンス
==================================================

同梱の `LICENSES` フォルダを参照してください。
