PhAIカスタムチャット作成支援【PythonでExcel→Word】
バージョン 1.0.0

■ はじめに
Excelを、PhAIカスタムチャットのナレッジとして読み取りやすいWordに変換するアプリです。
Excel内の文字と数値を「シート名 → 元の行 → 項目名：値」の順に整理します。
カスタムチャットの設計書やプロンプトを自動で執筆するアプリではありません。

■ 起動
1. ZIPをすべて展開します。
2. START_PhAI_Excel_to_Word.html をChromeまたはEdgeで開きます。
3. 「サンプルで試す」で一連の操作を確認できます。
Python・Officeのインストール、ログイン、APIキー、インターネット接続は不要です。
HTMLにPythonとExcel読込ライブラリを同梱しています。

■ 変換
1. Excel（.xlsx / .xlsm）を選ぶか、画面にドロップします。
2. シートを選びます。非表示の行・列・シートも含める設定が初期値です。
3. 見出しがあるときは行番号を指定します。見出しが3～4行目なら開始3、終了4。
   見出しがない帳票は両方0のまま変換できます。
   「○行目を使う」は候補のため、元データを見て確認してください。
4. 「Wordに変換する」を押します。
5. 「Wordを保存」または「まとめて保存 .zip」でダウンロードします。
6. Wordの内容を確認してPhAIカスタムチャットに添付してください。

■ 出力の特徴
・1シートにつき1つ以上のWordを作ります。大きなシートは文字数で分割します。
・Wordは PhAI_001.docx など半角英数字の名前です。元ファイル名とシート名は本文に記載します。
・表の画像ではなく、編集・検索できる本文とWordの見出しを出力します。
・見出しを指定しても、タイトルや見出し行を含む元セルの値を省略しません。
・重複する見出しも、セル位置（例 B7、C7）で区別できます。
・縦の結合セルは、実データのある後続行に「結合元」を明記して引き継ぎます。
・横の結合セルや複数段見出しをたどり「大見出し / 小見出し」を項目名にできます。
・ZIPの conversion_report.json で、対象セル数、対象外セル数、未計算数式の位置、出力ファイルの対応を確認できます。

■ 数式・表示形式
数式はExcelに保存されている計算結果を使用し、このアプリでは再計算しません。
計算結果が保存されていない場合は、Excelで再計算・保存してください。
確認用に出力したい場合は「未計算の数式を『要確認』として残す」をオンにします。
この場合、数式そのものが「保存済み計算値なし」と明記されます。
保存済み計算値が古い場合も自動判別できません。最新状態で保存したExcelをお使いください。
一般的な数値・割合・桁区切り・ゼロ埋め・日付に対応します。
特殊な表示形式は元の数値とExcelの表示形式を併記します。セルの見た目を完全再現する機能ではありません。

■ 対象外
旧形式 .xls、CSV、パスワードで暗号化されたExcelには対応しません。
Excelで .xlsx に保存し直してください。
画像内の文字、図形、グラフの見た目、コメント本文、リンク先、書式は出力しません。
画像や図形がある場合は画面で知らせます。必要な情報は元資料で確認・補足してください。
マクロは実行せず、Wordにも引き継ぎません。

■ データの扱い
選択したファイルのコピーを、ブラウザ内のPythonで処理します。外部に送信しません。
元ファイルは変更しません。完成ファイルはダウンロード操作で保存します。
ページを閉じる／再読み込みすると、入力・生成結果は消えます。
別ファイルの読み込み、設定変更、新しい変換で前の生成結果を消去します。
変換中は「中止する」で停止できます。処理は最大120秒です。

■ アプリ独自の制限
入力20 MB、展開後80 MB、内部セル10万個、50シート、結合セルの展開合計20万セル、Word200ファイルまで。
分割文字数は本文の目安です。文書タイトル等を加えるためファイル全体の文字数とは異なります。
これらはPhAIの添付上限ではありません。
Wordへの変換で構造を整理しますが、PhAI側の形式・容量制限や障害による添付エラーの解消を保証するものではありません。
実際のPhAIへの添付試験およびWindows実機での確認は未実施です。
MacのローカルHTTPプレビューで変換・ZIP保存を検証しています。HTMLの直接起動はブラウザ検証ツールの制約で未検証です。

■ 困ったとき
・何も起きない：ZIPを展開し、HTMLをChromeまたはEdgeで開き直してください。
・時間切れ：Excelのシート数や行数を減らして分割してください。
・項目名が合わない：見出し行を修正するか、0に戻してください。セル位置は常に残ります。
・出力が空：対象シートに文字・数値があるか、非表示の設定で除外していないか確認してください。
・PhAIでまだエラーになる：小さめのWordに分割し、PhAI側の対応形式・上限をご確認ください。