需求文件：整包下載與防手滑改為已實作，待業主確認清單第 1 項結案

- 第四節缺口 1：從「只做假按鈕、後端交業主拍板」改為已實作完成
- 第九節下載機制：改寫成四顆下載捷徑的實際規格（含 zip 檔名、空包不出現、
只有一組有內容時不另外產生整包）
- 第八節持久化：防手滑補上實作範圍與兩個瀏覽器層面的限制
- 第十四節待業主確認清單第 1 項劃掉結案

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/需求彙整-UIUX改版.md

@@ -1,7 +1,7 @@
 # SpectraEngine（譯彩紛呈 II 分析引擎）UI/UX 改版需求彙整
 
 - 文件建立日期：2026-07-20
-- 最後更新日期：2026-07-20
+- 最後更新日期：2026-07-24
 - 專案委託方：致理科技大學應日系鄧老師
 - 專案執行：吳千卉
 - 用途：①與 UI/UX Pro Max Skill 協作設計時的需求依據 ②向業主說明本次改版變動內容與理由的對照文件
@@ -64,10 +64,10 @@
 
 ## 四、新增功能缺口（非 Bug，需與業主確認是否納入本次改版範圍）
 
-### 缺口 1：無「整包下載」功能
-- `run_computation_pipeline_streaming`（第 1538 行起）只把所有產出檔案路徑收集進 `state["output_files"]`，跑完後僅顯示文字提示「各項結果請點選上方各分頁查看」，**沒有任何 zip 打包邏輯**。`state` 裡雖有 `zip_path` 欄位（第 1367 行）但從未被賦值使用
-- 使用者目前要拿到全部產出，必須跑進 3 個結果分頁各自下載
-- **本次改版做法**：先做 UI 假按鈕（「下載完整報告」，位置見下方左側導覽規劃），**不接真正的 zip 打包邏輯**，是否要做後端由業主決定
+### 缺口 1：無「整包下載」功能（2026-07-24 已實作完成）
+- 原本狀況：`run_computation_pipeline_streaming` 只把所有產出檔案路徑收集進 `state["output_files"]`，跑完後僅顯示文字提示「各項結果請點選上方各分頁查看」，**沒有任何 zip 打包邏輯**。`state` 裡雖有 `zip_path` 欄位但從未被賦值使用
+- 使用者要拿到全部產出，必須跑進 3 個結果分頁各自下載，共 15 個檔案
+- **本次改版做法**（原訂只做假按鈕交業主拍板，2026-07-24 決定直接做完整後端）：在左側導覽列底部新增四顆下載捷徑，各自打包成一個 zip，內容與各結果頁提供的下載檔案完全一致（見第九節）。`state["zip_path"]` 改為 `state["zip_paths"]` 字典並正式啟用
 
 ### 缺口 2：「語料 Metadata 說明」略過後無法回頭補填
 - 目前點「略過」後，系統標記為「使用者未提供」並永久跳過，**沒有任何入口可以事後回來編輯**
@@ -195,7 +195,7 @@
 
 | 機制 | 說明 |
 |---|---|
-| 防手滑 | `beforeunload` 事件，離開頁面前跳出確認 |
+| 防手滑 | `beforeunload` 事件，離開頁面前跳出確認（2026-07-24 已實作：僅在工作區顯示期間生效，回到首頁自動解除。瀏覽器規定使用者需先與頁面互動過確認框才會出現，且提示文字由瀏覽器決定，無法自訂） |
 | 中途下載 | 任一步驟完成即可下載當前已產出的部分成果 |
 | **存檔／讀檔** | 核心機制。存檔內容**含原始上傳文本**（不只中繼結果），確保讀檔後完整還原、不用重新上傳；讀取進度入口在首頁，讀檔後直接跳過首頁回到中斷步驟 |
 | 檔名／格式區分 | 存檔用自訂副檔名（如 `.spectra`），次要按鈕樣式＋警語；成果下載才用一般格式＋醒目主色按鈕，避免非技術使用者誤認「中繼存檔＝最終成果」 |
@@ -203,12 +203,21 @@
 
 ## 九、下載機制與命名
 
-| 下載項目 | 內容 | 格式 | 命名 | 出現時機 |
-|---|---|---|---|---|
-| 下載指標數據 | 75項指標原始數值（工作底稿） | xlsx + csv | 「下載指標數據」 | 指標計算完成即可，不用等全部結束 |
-| 下載完整報告 | LLM生成研究報告本文 | docx + txt | 「下載完整報告」 | 全案完成才出現（**本次先做假按鈕，不接真正zip打包，見缺口1**） |
+左側導覽列底部提供四顆下載捷徑，各自打包成一個 zip（2026-07-24 實作完成）：
 
-⚠️ 兩者性質完全不同（數據 vs 報告），且**出現時機不同**，UI 互動邏輯不可誤設計成兩顆按鈕同時解鎖。
+| 下載項目 | 內容 | zip 檔名 |
+|---|---|---|
+| 下載指標數據 | 75 項指標原始數值（工作底稿）：csv + xlsx | 指標數據.zip |
+| 下載統計圖表 | 敘述統計、差異性分析、特徵重要性、分群樹狀圖／手肘圖／PCA 圖、分群結果 | 統計圖表.zip |
+| 下載研究報告 | 統計技術報告與 LLM 生成研究報告本文（docx） | 研究報告.zip |
+| 下載完整報告 | 以上全部，去重後打成一包 | 完整分析結果.zip |
+
+規則：
+
+- 內容為空的那一包不會產生，對應按鈕就不出現。例如 LLM 報告產製失敗時，「下載研究報告」不會亮出來
+- 只有一組有內容時不另外產生「完整分析結果」，避免兩顆按鈕內容一模一樣讓使用者猶豫該點哪個
+- zip 內容與各結果頁提供的下載檔案完全一致（含檔名改名規則），不含僅供畫面顯示的中間產物
+- ⚠️「下載研究報告」與「下載完整報告」字面接近，非技術使用者可能分不清哪個才是報告本文，命名待實機檢視後確認
 
 ## 十、Footer／設定／API 處理
 
@@ -285,7 +294,7 @@
 
 ## 十四、待業主確認的範圍清單（影響工作量估計，需業主拍板）
 
-1. 「下載完整報告」是否要做真正的 zip 整包後端邏輯（本次僅做假按鈕）
+1. ~~「下載完整報告」是否要做真正的 zip 整包後端邏輯~~ → 2026-07-24 已直接實作完成，不需業主拍板（見第四節缺口 1、第九節）
 2. 是否要做「Metadata 略過後事後回來補填」功能（本次不做，只調整文案）
 3. Session 輸出目錄的清理機制（維運層面，非 UI/UX 範圍，但影響 Hugging Face Space 長期磁碟空間）
 4. 是否要加入致理科技大學品牌／校徽識別（目前系統僅有 SpectraEngine 自身品牌，無委託單位識別）
@@ -299,6 +308,7 @@
 | 2026-07-20 | 新增 Bug 3（步驟列失敗視覺狀態，已確認真實可觸發）＋上傳驗證強化（檔名字首合法性／每組檔案數下限／Metadata群組數一致性）；新增十三章空狀態/極限狀態/錯誤狀態規劃；新增十四章待業主確認清單 |
 | 2026-07-20 | 「監督式學習」「非監督式學習」補下載按鈕確認要做（移出待業主清單），命名定為「下載監督式學習」／「下載非監督式學習」；格式驗證每組檔案數下限確認為既有缺陷修正、非待業主確認事項；精簡缺口3內容；補充 Metadata 表單四種情境皆會出現、差異僅在內容的說明 |
 | 2026-07-20 | 開始與 UI/UX Pro Max Skill 協作視覺設計：確定風格方向（對話區參考AI-Native UI、結果分頁參考Data-Dense Dashboard）、字體（英文數字Crimson Pro＋中文維持Noto Sans TC）、配色（維持業主既有雙主題系統，WCAG對比度驗算通過，不重新設計） |
+| 2026-07-24 | 缺口 1「整包下載」改為直接實作完成（原訂只做假按鈕交業主拍板），第九節下載機制改寫成四顆下載捷徑的實際規格，待業主確認清單第 1 項結案；持久化機制的「防手滑」（`beforeunload`）同步實作完成 |
 
 ---