Phase 4：Bug3主體——步驟列補上「失敗」視覺狀態

- make_initial_state 新增 failed_step 欄位（1-based，成功時維持 None）
- _build_header_html 新增 failed_step 參數，該步驟改用紅色警示樣式，
不再套用「進行中」的呼吸動畫（原本失敗時圓點會永遠卡在動畫）
- run_computation_pipeline_streaming 的指標計算/統計分析例外分支
分別標記 failed_step=5/6，錯誤訊息補上「請重新整理頁面重新開始」
的下一步指引（完整的重置機制留給 Phase 6 一併處理）
- 新增 .step-pill--failed CSS 樣式

已用直接呼叫 _build_header_html(failed_step=5) 驗證渲染邏輯正確；
Phase 3 的驗證強化讓最容易觸發此失敗路徑的成因（分組不完整）已被攔在
格式驗證階段，因此另外完整跑一次情境1 happy path 確認沒有回歸。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

app_agent.py

@@ -1370,6 +1370,7 @@ def make_initial_state(session_id: str) -> dict:
         "analysis_result": None,
         "done_steps":     [],    # 已完成步驟（1-based）
         "current_step":   None,  # 目前執行步驟
+        "failed_step":    None,  # 執行失敗時卡在哪一步（1-based），成功時維持 None
     }
 
 
@@ -1386,18 +1387,27 @@ _STEPS = [
 ]
 
 
-def _build_header_html(done_steps: list = None, current_step: int = None) -> str:
+def _build_header_html(done_steps: list = None, current_step: int = None,
+                        failed_step: int = None) -> str:
     """
     產生完整標題區塊 HTML（標題＋動態步驟列＋進度條），確定性、不依賴 LLM。
     取代原本寫死不會變的步驟列，以及原本另外放在右欄、跟這裡資訊重複的
     「執行進度」面板——進度資訊現在只在這裡出現一次。
     done_steps: 已完成步驟（1-based list）
     current_step: 目前執行步驟（1-based int）
+    failed_step: 執行失敗時卡住的步驟（1-based int），失敗時該步驟改用失敗樣式，
+                 不再顯示「進行中」的呼吸動畫（原本失敗時圓點會永遠卡在動畫，
+                 使用者容易誤以為系統還在運算而手滑刷新頁面）
     """
     done_steps = done_steps or []
     pills = []
     for num, name in _STEPS:
-        if num in done_steps:
+        if num == failed_step:
+            pills.append(
+                f'<span class="step-pill step-pill--failed">'
+                f'<span class="step-num">!</span>{name}</span>'
+            )
+        elif num in done_steps:
             pills.append(
                 f'<span class="step-pill step-pill--done">'
                 f'<span class="step-num">✓</span>{name}</span>'
@@ -1588,7 +1598,8 @@ def run_computation_pipeline_streaming(state: dict):
         yield f"  [OK] 指標計算完成（{len(idx_df)} 個文本）", False, state
     except Exception as e:
         state["state"] = "COMPLETE"
-        yield f"[ERROR] 指標計算失敗：{e}", True, state
+        state["failed_step"] = 5
+        yield f"[ERROR] 指標計算失敗：{e}\n\n請重新整理頁面，重新開始分析。", True, state
         return
 
     # ── 步驟 2：統計分析 ─────────────────────────────────────────────────────
@@ -1612,7 +1623,8 @@ def run_computation_pipeline_streaming(state: dict):
     except Exception as e:
         state["state"] = "COMPLETE"
         state["output_files"] = results_paths
-        yield f"[ERROR] 統計分析失敗：{e}", True, state
+        state["failed_step"] = 6
+        yield f"[ERROR] 統計分析失敗：{e}\n\n請重新整理頁面，重新開始分析。", True, state
         return
 
     # ── 步驟 3：LLM 研究報告 ────────────────────────────────────────────────
@@ -1935,6 +1947,18 @@ _CUSTOM_CSS = """
     0%, 100% { box-shadow: 0 0 0 0 rgba(var(--c-accent-rgb),.35); }
     50%      { box-shadow: 0 0 0 5px rgba(var(--c-accent-rgb),0); }
 }
+/* 執行失敗卡住的步驟：紅色警示樣式，且不套用 stepPulse 呼吸動畫——原本
+   失敗時圓點會卡在「進行中」動畫永遠閃爍，讓使用者誤以為系統還在運算 */
+.step-pill--failed {
+    background: rgba(220,38,38,.14);
+    border-color: rgba(220,38,38,.4);
+    color: #dc2626;
+    font-weight: 700;
+}
+.step-pill--failed .step-num {
+    background: #dc2626;
+    color: #fff;
+}
 /* 步驟列下方的整體進度條，取代原本另外放在右欄、跟步驟列資訊重複的執行進度面板 */
 .step-progress-track {
     height: 4px;
@@ -3159,6 +3183,7 @@ def create_app():
                 value=_build_header_html(
                     state.get("done_steps", []),
                     state.get("current_step"),
+                    state.get("failed_step"),
                 )
             )