修進工作區後左側導覽列消失、技術執行紀錄空白缺標題、下載捷徑提早缺件三個 bug

- result_nav_col／canvas_exec_col 第一次從 visible=False 翻 True 時，
Gradio 前端只認觸發它的 generator 第一個 yield 才會真的掛進 DOM；
on_start_analysis_show 原本延到第二個 yield 才設，導致「開始研究
分析」後左側導覽列只剩「回首頁」、硬點技術執行紀錄也是空白。搬到
第一個 yield，比照 on_scenario_pick 已驗證可行的寫法。
- 技術執行紀錄頁補上獨立的靜態標題，不再依賴逐行累加的 log 內容。
- 下載研究報告／下載完整分析資料兩顆導覽列捷徑，改成等 LLM 報告階段
真正跑到終態（done/failed）才生成與顯示，避免報告還在寫的時候就
把缺件的 zip 遞出去。

app_agent.py

@@ -1668,18 +1668,23 @@ _ZIP_GROUPS = [
 ]
 
 
-def _make_result_zips(output_dir: Path, grouped: dict) -> dict:
+def _make_result_zips(output_dir: Path, grouped: dict, allow_all: bool = True) -> dict:
     """把各組產出打包成 zip，回傳 {group_key: zip 路徑字串}。
 
     grouped：{group_key: [檔案路徑, ...]}，不含 "all"（由本函式自己合併）。
     只打包真實存在的檔案；某組完全沒有檔案就不產生該包（對應的下載捷徑
     也就不會出現），例如 LLM 報告失敗時「研究報告」那包不該憑空生出來。
+
+    allow_all：呼叫端還有「必然會出現、但目前尚未跑完」的組別時傳
+    False，即使目前已有 ≥2 組非空也先不合併「整包」——避免「完整分析
+    資料」在報告撰寫階段還沒結束前，就用 idx+stat 兩組拼出一包名不副實
+    的「完整」資料（2026-08-06 踩坑，見呼叫端 report_stage_done 註解）。
     """
     targets = {k: [f for f in v if Path(f).exists()] for k, v in grouped.items()}
 
     # 整包 = 各組去重合併。只有一組有東西時，整包跟那一組內容完全一樣，
     # 多給一顆按鈕只會讓人猶豫該點哪個，這種情況不另外產生整包。
-    if sum(1 for v in targets.values() if v) >= 2:
+    if allow_all and sum(1 for v in targets.values() if v) >= 2:
         seen = set()
         targets["all"] = [f for v in targets.values() for f in v
                           if not (f in seen or seen.add(f))]
@@ -3119,6 +3124,14 @@ def create_app():
                     # 跟其他三個結果頁一樣的 visible=True/False 語意，交給
                     # applyActivePage() JS 決定要不要顯示。
                     with gr.Column(visible=False, elem_id="canvas_exec", elem_classes=["canvas-result"]) as canvas_exec_col:
+                        # 千卉回報（2026-08-06）：這頁一直缺大標題文字。原因是
+                        # 另外三個結果頁（語言指標分析／敘述統計／研究報告）的
+                        # 「### 標題」都是烤進 _populate_tabs 每次重新賦值的內容
+                        # 字串裡（一次性結果，整段換新）；但這頁是逐行往下累加
+                        # 的執行 log（見 _log_append），不會整段重寫，所以從沒
+                        # 機會把標題烤進 exec_log 的值裡。改成跟內容分開、獨立
+                        # 一顆靜態 gr.Markdown，不受 log 累加邏輯影響。
+                        gr.Markdown("### 技術執行紀錄")
                         exec_log = gr.Markdown(
                             value="",
                             elem_id="exec_log",
@@ -3303,19 +3316,30 @@ def create_app():
             # 下載清單只留敘述統計技術報告跟 LLM 輔助報告兩份，複製成使用者
             # 指定的檔名（保留原始檔案不動，避免影響其他邏輯依賴原檔名）；
             # 原始 .txt 不提供下載，僅用於上方 R[18] 的文字顯示
+            #
+            # 千卉發現的踩坑（2026-08-06）：final_rpts（敘述統計技術報告）
+            # 是統計階段一完成就存在，早於 LLM 報告撰寫階段。若不設防，
+            # 「報告撰寫」子階段還在跑的當下，這裡就會把只有統計報告、缺
+            # LLM 報告的清單當成「研究報告」打包出去——使用者這時點下載，
+            # 拿到的檔案內容不完整。改成整段等 report 子階段真正跑到終態
+            # （done 或 failed，不再是 running/pending）才組清單；報告若
+            # 失敗，final_rpts 仍在，讓使用者至少能拿到統計報告，不會被
+            # 卡死拿不到任何東西。
+            report_stage_done = state["analysis"].get("report", {}).get("status") in ("done", "failed")
             dl_rpt = []
-            if final_rpts:
-                ts = final_rpts[0].stem.split("Final_Report-")[-1]
-                stats_dst = output_dir / f"TransPrism_stats_{ts}.docx"
-                if not stats_dst.exists():
-                    shutil.copy(str(final_rpts[0]), str(stats_dst))
-                dl_rpt.append(str(stats_dst))
-            if docx_files:
-                ts = docx_files[0].stem.split("LLM_Analysis-")[-1]
-                llm_dst = output_dir / f"TransPrism_LLM Report_{ts}.docx"
-                if not llm_dst.exists():
-                    shutil.copy(str(docx_files[0]), str(llm_dst))
-                dl_rpt.append(str(llm_dst))
+            if report_stage_done:
+                if final_rpts:
+                    ts = final_rpts[0].stem.split("Final_Report-")[-1]
+                    stats_dst = output_dir / f"TransPrism_stats_{ts}.docx"
+                    if not stats_dst.exists():
+                        shutil.copy(str(final_rpts[0]), str(stats_dst))
+                    dl_rpt.append(str(stats_dst))
+                if docx_files:
+                    ts = docx_files[0].stem.split("LLM_Analysis-")[-1]
+                    llm_dst = output_dir / f"TransPrism_LLM Report_{ts}.docx"
+                    if not llm_dst.exists():
+                        shutil.copy(str(docx_files[0]), str(llm_dst))
+                    dl_rpt.append(str(llm_dst))
             if dl_rpt:
                 R[19] = gr.update(value=dl_rpt, visible=True)
 
@@ -3323,11 +3347,16 @@ def create_app():
             # 刻意沿用上面已經整理好的清單變數，不另外去 output_dir 掃檔案：
             # 掃出來的會含 LLM_Analysis-*.txt 這種只供畫面顯示、不提供下載的
             # 中間產物，也含前一次打包留下的 .zip 自己。
+            #
+            # allow_all=report_stage_done：「完整分析資料」整包同理，report
+            # 子階段還在跑時，即使 idx／stat 兩組都已完成（湊到 ≥2 組的舊
+            # 門檻），也不該急著把「完整」兩字掛出來卻漏掉報告——見上面
+            # report_stage_done 的踩坑說明。
             zips = _make_result_zips(output_dir, {
                 "idx":    [str(csv_path)] + [str(p) for p in xlsx_list[-1:]],
                 "stat":   [str(p) for p in [desc_path, diff_path, box_path]] + imp_dl + cluster_dl,
                 "report": dl_rpt,
-            })
+            }, allow_all=report_stage_done)
             state["zip_paths"] = zips
             for _i, _key in ((26, "idx"), (27, "stat"), (28, "report"), (29, "all")):
                 if zips.get(_key):
@@ -3606,6 +3635,24 @@ def create_app():
             # yield 1：workspace_row 從 visible=False 翻回 True 的那一批（祖先
             # 翻轉），scenario_select_row 本來就要在這時候顯示 True。子元件的
             # 補償刻意留到下一個 yield，不跟這批同時處理（理由見上方大段註解）。
+            #
+            # result_nav_col／canvas_exec_col 例外：2026-08-06 千卉實測發現，
+            # 「元件第一次從 visible=False 翻成 True（此生第一次掛進 DOM）」
+            # 這件事，只有在觸發它的 generator 的第一個 yield 裡設定才會真的
+            # 生效——on_scenario_pick 的 result_nav_col／canvas_exec_col 就是
+            # 這樣，在第一個 yield 就設 visible=True（見該函式），所以按鈕跟
+            # 內容區塊真的會出現。這裡原本學 4-C 的做法把兩者延到下一個 yield
+            # 才設，結果變成「Python 端送出了 visible=True，前端卻從頭到尾
+            # 沒把這批按鈕跟內容掛進 DOM」——使用者點「開始研究分析」進入
+            # 研究選擇畫面後，左側導覽列只剩「回首頁」，AI對話／技術執行紀錄
+            # 等全部消失；就算硬點技術執行紀錄，右邊內容區塊也是一片空白
+            # （canvas_exec_col 同樣沒掛進 DOM，不是只缺標題文字）。4-C 的
+            # 「延一個 yield」技巧解的是另一種問題（曾經 True 過的元件被自動
+            # 還原），不適用在「這輩子第一次要 True」的元件上，兩者不能套
+            # 同一招。canvas_exec_col 跟著 result_nav_col 一起搬進第一個
+            # yield，也符合 nav_exec_btn 建構時刻意不設 interactive=False
+            # 的原始設計意圖（見該按鈕附近註解：「技術執行紀錄……從第一秒
+            # 就有內容」，代表它從一開始就該是可點、有內容可看的狀態）。
             yield (
                 gr.update(visible=False),                             # homepage_col
                 gr.update(visible=True),                               # workspace_row
@@ -3613,8 +3660,8 @@ def create_app():
                 gr.update(value=_build_header_html(current_step=1)),   # app_header_html：站上第1步「研究選擇」
                 state,
                 gr.update(), gr.update(), gr.update(), gr.update(), gr.update(),  # upload_row/metadata_row/canvas_idx/stat/report 留到下一個 yield
-                gr.update(),  # result_nav_col 留到下一個 yield
-                gr.update(),  # canvas_exec_col 留到下一個 yield
+                gr.update(visible=True),  # result_nav_col：第一次掛載必須跟祖先同一個 yield，見上方說明
+                gr.update(visible=True),  # canvas_exec_col：同上，且從第一秒就該有內容可看
                 gr.update(),  # nav_dl_group 留到第三個 yield
             )
             # yield 2（4-C 補償，緊接著上一個 yield，同一個 generator/連線）：
@@ -3622,7 +3669,8 @@ def create_app():
             # （要等對應結果產出才 enable，見 create_app 的 interactive=False
             # 與 _populate_tabs 的閘門，這批不動那個閘門邏輯），改成「進工作區
             # 就顯示」只是讓使用者一開始就看得到完整的流程地圖，不是讓他們能
-            # 提前點。
+            # 提前點。result_nav_col／canvas_exec_col 本身已在上一個 yield
+            # 掛載完成，��裡不再重複設定（重複設 visible=True 無害，但沒必要）。
             yield (
                 gr.update(), gr.update(), gr.update(), gr.update(), state,
                 gr.update(visible=False),  # upload_row
@@ -3630,18 +3678,18 @@ def create_app():
                 gr.update(visible=False),  # canvas_idx_col
                 gr.update(visible=False),  # canvas_stat_col
                 gr.update(visible=False),  # canvas_report_col
-                gr.update(visible=True),   # result_nav_col（4-a：一進工作區就顯示）
-                gr.update(visible=False),  # canvas_exec_col
+                gr.update(),               # result_nav_col：已在第一個 yield 掛載完成，這裡不再重複設定
+                gr.update(),               # canvas_exec_col：同上，這裡不再重複設定
                 gr.update(),               # nav_dl_group 留到下一個 yield（見下方說明）
             )
             # yield 3：nav_dl_group（下載捷徑那組分隔線＋四顆按鈕）住在
             # result_nav_col 裡面，是比 result_nav_col 更深一層的子元件。
-            # result_nav_col 剛在上一個 yield 翻成 visible=True，若 nav_dl_group
-            # 在「同一個」yield 裡也跟著壓 False，會被同一種 still-mounted-
-            # snapback 蓋回舊值（跟 metadata_row 那組是同一條地雷，只是換了
-            # 一層祖先/子元件）；所以要等 result_nav_col 的翻轉在上一個 yield
-            # 沉澱完，這裡才安全，之後有 zip 產出時 _populate_tabs 會自己把它
-            # 翻回 True，不受影響。
+            # result_nav_col 已在第一個 yield 翻成 visible=True，若 nav_dl_group
+            # 太早跟著壓 False，會被同一種 still-mounted-snapback 蓋回舊值
+            # （跟 metadata_row 那組是同一條地雷，只是換了一層祖先/子元件）；
+            # 這裡隔了兩個 yield 才動 nav_dl_group，比原本的一個 yield 間隔
+            # 更保守安全，之後有 zip 產出時 _populate_tabs 會自己把它翻回
+            # True，不受影響。
             yield (
                 gr.update(), gr.update(), gr.update(), gr.update(), state,
                 gr.update(), gr.update(), gr.update(), gr.update(), gr.update(),