Z24 兩種使用方式說明
========================

【方式 A】靜態發布版（您目前這個資料夾）
----------------------------------------
用途：閱讀報告、瀏覽論文／分析圖、互動圖表、表格下載
需要：只需瀏覽器，不需 Python

如何開啟：
  1. 雙擊 index.html
  2. 或整包資料夾用 GitHub Pages / Cloudflare 線上瀏覽

限制：
  - 資料是「建置當下」的快照，不會自動更新
  - 僅含報告與圖庫有引用的 CSV／JSON／圖片
  - 無「執行流程」、無法重新跑分析 pipeline
  - 無法讀取 lab/、原始 SAP 檔等未匯入圖庫的資料


【方式 B】完整分析平台（需另外下載整包專案）
----------------------------------------
用途：與開發者相同的完整功能（報告＋圖庫＋流程執行＋即時讀 outputs）
需要：Windows 10/11、Python 3.10+、第一次需網路安裝套件

如何取得：
  向專案維護者索取「Z24 完整專案」ZIP（即 Z24已整理 整個資料夾）。
  注意：GitHub 上的 Z24 倉庫目前僅含靜態發布版，不含完整原始碼與全部 outputs。

如何啟動（在完整專案「根目錄」，不是發布版子資料夾）：
  1. 解壓 ZIP 到本機，例如 D:\Z24已整理
  2. 雙擊根目錄的「啟動Z24平台.bat」
  3. 依畫面指示建立 .venv 與安裝套件（第一次較久）
  4. 瀏覽器會開啟 http://127.0.0.1:8765

download 資料夾內的「啟動Z24平台.bat」：
  那是給「完整專案根目錄」使用的啟動檔。
  請勿只在發布版資料夾內單獨執行；需連同 code/、outputs/ 等一併解壓。


兩者差異摘要
------------
| 項目           | 靜態發布版     | 完整平台           |
|----------------|----------------|--------------------|
| 需要 Python    | 否             | 是                 |
| 報告／圖庫     | 有             | 有                 |
| 互動圖表       | 有（預匯出）   | 有（即時產生）     |
| 執行流程       | 無             | 有                 |
| 全部 outputs   | 僅圖庫引用部分 | 是（本機資料夾）   |
| 資料更新       | 需重新建置發布 | 改檔後重新整理即可 |
| 適合對象       | 讀者、審查     | 研究員、開發       |

發布版建置（維護者用，在完整專案根目錄）：
  .venv\Scripts\python.exe code/tools/build_static_site.py