diff --git "a/app_agent.py" "b/app_agent.py"
--- "a/app_agent.py"
+++ "b/app_agent.py"
@@ -1397,6 +1397,19 @@ def make_initial_state(session_id: str) -> dict:
"stat": {"status": "pending", "line": ""},
"report": {"status": "pending", "line": ""},
},
+ # 「文本上傳」步驟底下兩個子階段的即時狀態,結構比照上面的 analysis
+ # (3-C,2026-07-30):供 Canvas 內容區塊分段呈現上傳進度(見
+ # _build_upload_html),status: pending / running / done / failed;
+ # line: 給人看的一句結果或失敗原因。由 on_upload_confirm 邊跑邊寫入。
+ "upload": {
+ "receive": {"status": "pending", "line": ""},
+ "validate": {"status": "pending", "line": ""},
+ },
+ # 2026-07-31(Batch E 第 7 項):原本這裡有 "tabs_toast_shown": False,
+ # 是 Bug 4-A 修復時為了擋「分析結果已就緒」toast 重複跳出而加的旗標
+ # (_populate_tabs 現在會在每個子階段剛完成時都被呼叫,不再只呼叫
+ # 一次)。業主要求拿掉那顆 toast 本身(見 _populate_tabs),旗標
+ # 跟著失去用途,一併移除,不留無作用的殘留狀態。
}
@@ -1417,10 +1430,15 @@ def make_initial_state(session_id: str) -> dict:
# generator 依序跑完的運算,中間沒有任何使用者操作關卡。三段各自有失敗
# 可能,但「壞在哪一段、其他段有沒有救」這種細節,藥丸大小的步驟列講不
# 清楚,改由 Canvas 的分析運算內容區塊分段呈現(見 _build_analysis_html)。
+# 2026-07-30:業主要求把情境選擇從首頁搬回工作區,成為正式的第 1 步「研究
+# 選擇」(見 create_app() 的 scenario_select_row、on_start_analysis_show/
+# on_scenario_pick)。原本①提到「情境選擇搬去首頁後不算步驟列一步」在此
+# 已不成立,_STEPS 從 3 步變 4 步,後面三步的編號全部 +1。
_STEPS = [
- (1, "文本上傳"),
- (2, "語料說明"),
- (3, "分析運算"),
+ (1, "研究選擇"),
+ (2, "文本上傳"),
+ (3, "語料說明"),
+ (4, "分析運算"),
]
# 分析運算底下的三個子階段(key 用於 state["analysis"]、內容區塊分段、入口連結)
@@ -1476,9 +1494,14 @@ def _build_header_html(done_steps: list = None, current_step: int = None,
f'{num}{name}'
)
+ # 2026-07-31(Batch E 第 4-b 項):業主指定頂部列不要標題文字,
+ # 原本的
整行移除,只留步驟列(四顆藥丸)。
+ # .title-line 這個 class 的 CSS 規則(含深色模式那份漸層文字修正)
+ # 留著不刪:跟前四批同名 class 的踩坑記錄綁在一起,且沒有其他地方
+ # 在用會自動失效,不影響畫面;真的要清理屬於「順手清理死碼」,
+ # 這批任務範圍不包含。
return (
'
'
)
@@ -1494,9 +1517,11 @@ def handle_scenario_select(user_input: str, state: dict):
sc_num = m.group()
sc_info = SCENARIOS[sc_num]
state["scenario"] = sc_num
- # 情境選擇本身已不是步驟列的一步(在首頁完成),選完直接站上「文本上傳」
- state["done_steps"] = []
- state["current_step"] = 1
+ # 2026-07-30:研究選擇(3-A)搬進工作區成為正式第 1 步後,選定情境=
+ # 完成第 1 步,直接站上第 2 步「文本上傳」(原本情境選擇在首頁完成、
+ # 不算步驟列一步,_STEPS 只有 3 步;現在 _STEPS 變 4 步,步驟編號全部 +1)
+ state["done_steps"] = [1]
+ state["current_step"] = 2
# 固定文字,不經 LLM:確保每次措辭一致,並直接引導使用者去看上傳卡片裡的
# 格式要求,不需要另外由工作程序 Agent 生成一則重複格式細節的引導訊息
@@ -1830,6 +1855,10 @@ _ICON_PATHS = {
"download": '',
"moon": '',
"sun": '',
+ # 2026-07-30(2-B 第 3 項):「AI對話」改用對話氣泡圖示(跟 home.svg
+ # 同一套 Heroicons 風格手繪,path 需與 assets/icons/chat-bubble.svg
+ # 內容保持一致,這裡是給 _icon() 行內用法的對應版本,見該函式 docstring)。
+ "chat-bubble": '',
}
@@ -2393,9 +2422,18 @@ div[role="log"][aria-label="chatbot conversation"],
水平 padding 1rem 會把可見氣泡再往內推 16px——bubble-wrap 已給 16px,
疊起來可見氣泡實際落在 32px。水平內距歸零,可見氣泡才真的貼在 16px;
氣泡內的文字留白由 .md 自己的 padding 提供。 */
+/* 2026-07-30(2-C 第 6 項):對話氣泡文字改 12px(千卉指定)。字級固定寫在
+ 這裡跟下面 .message-row.bot .message/.message p/.message .md 四個地方
+ ——不是重複設定,是 Gradio 這個氣泡結構本來就有巢狀 /
+ 各自帶自己的字級(見下面兩則舊註解,實測不會沿用外層容器字級),四層
+ 都要一起改成 12px,畫面上才會真的變小;只改最外層這條,實際顯示的文字
+ 仍會被內層 .p/.md 的 var(--font-size-base) 蓋掉,完全看不出效果。 */
+/* 2026-07-31(Batch G 第 3 項):業主回報 12px 太小,改 14px。四處連動改,
+ 理由同上——只改一處字級不一致,這裡跟下面 .message-row.bot .message/
+ .message p/.message .md 四處都要同步改成 14px。 */
.main-chat .message-row .message {
border-radius: 10px !important;
- font-size: var(--font-size-base) !important;
+ font-size: 14px !important;
line-height: 1.7 !important;
padding: 0 !important;
width: fit-content !important;
@@ -2438,7 +2476,7 @@ div[role="log"][aria-label="chatbot conversation"],
border: none !important;
border-radius: 0 !important;
color: var(--c-text) !important;
- font-size: var(--font-size-base) !important;
+ font-size: 14px !important;
line-height: 1.7 !important;
box-shadow: none !important;
text-align: left !important;
@@ -2447,7 +2485,7 @@ div[role="log"][aria-label="chatbot conversation"],
不會沿用上面設在外層容器的字級,且段落間距預設高達 16px,
視覺上偏大又有明顯空行,這裡直接命中 覆寫 */
.main-chat .message-row .message p {
- font-size: var(--font-size-base) !important;
+ font-size: 14px !important;
line-height: 1.6 !important;
margin: 0 0 .5rem !important;
}
@@ -2458,7 +2496,7 @@ div[role="log"][aria-label="chatbot conversation"],
改成 block 並統一字級後,這段隱形空隙就會消失 */
.main-chat .message-row .message .md {
display: block !important;
- font-size: var(--font-size-base) !important;
+ font-size: 14px !important;
line-height: 1.6 !important;
padding: 0.9rem 1.1rem !important;
/* 2026-07-24:氣泡底色改白(淺色)/較淺的 surface(深色)。原本是
@@ -2560,15 +2598,66 @@ div[role="log"][aria-label="chatbot conversation"],
max-width: 220px !important;
display: flex !important;
flex-direction: column !important;
+ /* Bug 4-B 修復(2026-07-30):跟 .chat-col/.canvas-col/.main-layout-row
+ 一樣補上 flex-wrap:nowrap。這裡沿用 Gradio .column 預設的 wrap 值,
+ _populate_tabs 把下載捷徑那組(nav_dl_group)掛進來後,導覽列內容
+ 一旦超過這個固定 height,就會被摺到第二條 flex line(往右排到可視
+ 寬度外),再被下面的 overflow-x:hidden 裁掉——節點還在 DOM,只是渲染
+ 到看不見的地方,這正是「報告完成後導覽列項目整組消失」的根因。
+ 超高內容改走既有的 overflow-y:auto 垂直捲動,不要再被摺行。
+ 這條 flex-wrap:nowrap 是本檔的地雷區,2-B 這輪改版千萬不要移除
+ ——見下一則註解。 */
+ flex-wrap: nowrap !important;
gap: .3rem !important;
height: 100% !important;
- overflow-y: auto !important;
- overflow-x: hidden !important;
+ /* 2026-07-30(2-B 第 2 項)三段式改版:原本 overflow-y:auto 直接設在
+ .nav-col 本身,讓「品牌字標+操作項目+(曾經在頂端的)明暗/收合鈕」
+ 整欄一起捲動。這輪把明暗切換/收合鈕搬到欄底常駐(置底+置右),
+ 如果還是讓 .nav-col 整欄捲動,內容一多,底部工具列會被捲動推出可視
+ 範圍——等於復發 Bug 4-B(「內容一多,重要項目跟著捲不見」)的同一種
+ 症狀,只是這次主角換成底部工具列而不是下載捷徑。修法:改成「上方
+ 品牌列(固定)+中間 .nav-items-scroll(flex:1,自己 overflow-y:auto)
+ +底部 .nav-bottom-toolbar(固定)」三段式結構,捲動只發生在中間段,
+ .nav-col 自己的 overflow 改成 hidden(三個直屬子項各自負責自己要不要
+ 溢出,nav-col 本身不再需要當捲動容器)。flex-wrap:nowrap 依然保留在
+ 這裡:三個直屬子項總高度若超過 100%,沒有這條會被摺到第二條 flex
+ line,跟 Bug 4-B 是同一種機制,不能拿掉。 */
+ overflow: hidden !important;
border-right: 1px solid var(--c-border) !important;
/* 5-A:導覽列上下左右統一 16px 留��。所有按鈕/項目寬度撐滿這個內距框,
右上收合鈕的右緣也就落在 16px 處,不再多出 ~20px 空隙。 */
padding: 16px !important;
}
+/* 中間可捲動項目區:研究情境(已隱藏的空殼)、回首頁連結、結果導覽都在
+ 這裡面。flex:1 讓它吃掉扣除頂端品牌列與底部工具列之後的剩餘高度;
+ min-height:0 是關鍵——flex 子項預設 min-height:auto 會用內容高度當下限,
+ 讓這個子項無法縮小到比內容矮,overflow-y:auto 就永遠不會真的觸發捲動,
+ 而是把 .nav-col 撐爆(跟 Bug 4-B 的成因是同一條 flexbox 規範,只是換了
+ 一層)。flex-wrap:nowrap 同理沿用 .nav-col 的防禦寫法,避免這裡也被
+ Gradio 預設的 .column flex-wrap:wrap 摺行。 */
+.nav-items-scroll {
+ display: flex !important;
+ flex: 1 1 auto !important;
+ flex-direction: column !important;
+ flex-wrap: nowrap !important;
+ min-height: 0 !important;
+ gap: .3rem !important;
+ overflow-y: auto !important;
+ overflow-x: hidden !important;
+}
+/* 底部工具列(明暗切換+收合):flex:none 固定高度,不參與中間段的縮放,
+ 永遠貼在 .nav-col 底部;border-top 當作千卉指定的「上方水平分隔線」。
+ justify-content:flex-end 靠右對齊(千卉指定「置底+置右」)。 */
+#nav_bottom_toolbar, #nav_bottom_toolbar > .html-container { padding: 0 !important; margin: 0 !important; }
+.nav-bottom-toolbar {
+ display: flex !important;
+ flex: none !important;
+ align-items: center !important;
+ justify-content: flex-end !important;
+ gap: 2px !important;
+ padding-top: .6rem !important;
+ border-top: 1px solid var(--c-border) !important;
+}
/* 5-D:scenario_btn_col 是 Phase 8 留下的空 Column(只為既有可見性 wiring
保留,E3 待清)。它夾在頂端列與「開始新分析」之間,即使沒內容,flex gap
仍會在它前後各插一份間距,把兩者推遠(這正是千卉回報的「間距太遠」)。
@@ -2628,6 +2717,19 @@ div[role="log"][aria-label="chatbot conversation"],
.canvas-col .app-header {
flex-shrink: 0 !important;
}
+/* 2-A(2026-07-30):頂部產品名+步驟列只在「AI 對話」頁顯示,其他結果頁
+ (語言指標分析/敘述統計/差異性分析/監督式學習/非監督式學習/
+ LLM輔助分析/技術執行紀錄)都不顯示——那幾頁已經佔滿 Canvas 寬度,
+ 步驟列這時只是重複資訊。data-page 屬性是 _APP_HEAD_SCRIPT 的
+ applyActivePage() 寫在 .main-layout-row 上的既有機制,這裡純加一條
+ CSS,不需要新增任何 Python wiring。用 :not([data-page="chat"]) 反選,
+ 不用把 5 個結果頁 key 都列一次。elem_id 鎖 app_header_html 的外層
+ wrapper——elem_classes 會同時蓋在外層 .block 與內層 .prose 兩層 div 上
+ (本檔多處踩過這坑,見 .upload-hint 那段完整記錄),id 選擇器沒有這個
+ 問題。 */
+.main-layout-row:not([data-page="chat"]) #app_header_wrap {
+ display: none !important;
+}
/* 最後一段殘餘留白(10px):Gradio 幫所有 gr.HTML() 元件的內容包了一層
.html-container,本身有 padding:10px 12px,這是全站每個 gr.HTML()
共用的預設樣式(首頁卡片、運算中提示等都靠它),不能整個歸零,只精準
@@ -2660,8 +2762,11 @@ div[role="log"][aria-label="chatbot conversation"],
!important 蓋得過沒加 !important 的 inline style」原則)。
踩坑(新案例,跟 8-B 的 .column flex-wrap 是同一大類但這次是 .row 本身
從沒被設過):.main-layout-row(gr.Row)本身從來沒設過 flex-wrap:nowrap
- ——nav-col/chat-col/canvas-col 各自「內部」的 flex-wrap:nowrap 只管
- 它們自己的子元件怎麼排,不影響 main-layout-row 怎麼排這三欄本身。平常
+ ——chat-col/canvas-col 各自「內部」的 flex-wrap:nowrap 只管它們自己的
+ 子元件怎麼排,不影響 main-layout-row 怎麼排這三欄本身。(訂正 2026-07-30:
+ 這裡原本誤寫成 nav-col 也在這份清單裡,實際上當時 nav-col 從未設過
+ flex-wrap:nowrap——這正是 Bug 4-B「報告完成後導覽列整組消失」被忽略的
+ 直接原因,已於上方 .nav-col 規則補上,見該處 2026-07-30 註解。)平常
三欄用 flex-grow 精準分配寬度、剛好不超版所以wrap從沒被觸發過;這次
canvas-col 拿掉 max-width 上限、又改用 flex-basis:auto 之後,內容較寬
的表格會把 canvas-col 的 intrinsic 寬度撐到跟 nav-col 放不進同一行,
@@ -2755,24 +2860,22 @@ div[role="log"][aria-label="chatbot conversation"],
.homepage-col { max-width: 50rem; margin: 2.5rem auto 3rem; padding: 0 1rem; }
.homepage-hero { text-align: center; margin-bottom: 2.4rem; }
-.homepage-hero .kicker {
- display: inline-flex; align-items: center; gap: .5rem;
- font-family: 'Crimson Pro', serif; font-style: italic;
- font-size: 1.05rem; color: var(--c-text-muted);
-}
-.homepage-hero .kicker::before, .homepage-hero .kicker::after {
- content: ""; width: 28px; height: 1px; background: var(--c-border-hover);
-}
+/* 2026-07-30(1-C):業主指定移除首頁第一行「重譯文本量化分析平台」
+ (原本的 .kicker),HTML 端已拿掉該 ,.kicker 本身連同兩側裝飾線
+ 的 CSS 規則一併移除(沒有任何元素會再套用它)。 */
/* 2026-07-27:老師確認「譯彩紛呈:重譯文本分析系統」是大系列品牌名稱,
這一款子產品其實叫「II 分析引擎 SpectraEngine」——原本大系列名稱佔用
最大最搶眼的 h1+漸層,子產品名反而縮在最小的一行,跟實際定位相反。
重新分配視覺權重:大系列名稱降級成小字(series-name),子產品名稱升級
成 h1 大標題+漸層。 */
+/* 2026-07-30(1-D/1-E):業主指定放大到 18px/14px(原本 .95rem/.85rem,
+ 換算 16px 根基約 15.2px/13.6px)。直接寫死 px,不用 rem,避免驗收量測
+ 時因根字級假設不同而跟業主指定的精確數字對不上。 */
.homepage-hero .series-name {
- margin: .9rem 0 .1rem; font-size: .95rem; font-weight: 600;
+ margin: .9rem 0 .1rem; font-size: 18px; font-weight: 600;
color: var(--c-text-soft);
}
-.homepage-hero .subtitle { margin: 0 0 1.1rem; font-size: .85rem; color: var(--c-text-muted); }
+.homepage-hero .subtitle { margin: 0 0 1.1rem; font-size: 14px; color: var(--c-text-muted); }
.homepage-hero h1 {
margin: 0 0 .6rem; font-size: 2.1rem; line-height: 1.3; font-weight: 700;
/* 同 .app-header .title-line 的漸層文字踩坑(見 _DARK_MODE_HEAD_CSS 上方註解):
@@ -2785,12 +2888,49 @@ div[role="log"][aria-label="chatbot conversation"],
-webkit-background-clip: text; background-clip: text;
color: transparent; -webkit-text-fill-color: transparent;
}
+/* 2026-07-31(Batch E 第 1 項):業主回報這行沒有跟其他行對齊置中。
+ 量測證實:.lede 是唯一被覆寫成 text-align:left 的行,其餘行
+ (series-name/subtitle/h1/footnote)都吃 .homepage-hero 本身的
+ text-align:center。文字方塊( 的 border box)四行寬度其實一致,
+ 問題出在「視覺文字置中」——.lede 文字換行後每行長度不同,
+ text-align:left 讓每行從方塊左緣起排,量出來的文字視覺中心會比
+ 方塊中心明顯偏左(1280px 寬實測:文字視覺中心 x≈602,其他行
+ x≈640,偏差近 40px,方向是「偏左」不是業主主觀感受的「偏右」,
+ 可能是她螢幕寬度或縮放比例不同所致)。拿掉這條 text-align:left
+ 覆寫,改回跟其他行一致的置中,四行的文字視覺中心才會真正對齊。 */
.homepage-hero .lede {
- margin: 1.8rem 0 0; text-align: left; font-size: var(--font-size-base);
+ margin: 1.8rem 0 0; text-align: center; font-size: var(--font-size-base);
line-height: 1.8; color: var(--c-text-muted);
}
-.scenario-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; margin-top: 2rem; }
-@media (max-width: 640px) { .scenario-grid { grid-template-columns: 1fr; } }
+/* 1-B:首頁「開始研究分析」按鈕,進入工作區的唯一入口。這是真正的
+ gr.Button(不是首頁卡片那種 HTML+隱藏按鈕橋接手法——單一按鈕不需要,
+ 見 create_app() 裡 start_analysis_btn 旁的說明),elem_classes 直接掛在
+
'
)
+ return f'
{"".join(cards)}
'
+
+
+def _build_homepage_hero_html() -> str:
+ """首頁介紹區塊上半部(品牌名稱+標題+描述)。
+ 2026-07-30(Phase 9):業主指定情境卡片搬去工作區的「研究選擇」步驟
+ (見 3-A、_build_scenario_cards_html),首頁只留介紹文字與一顆
+ 「開始研究分析」按鈕(1-B,見 create_app() 的 start_analysis_btn)。
+ 按鈕是真正的 gr.Button(需要接 Python 事件,不能用 gr.HTML() 刻),
+ 因此原本一整塊首頁 HTML 拆成 hero/footer 兩段(見下面
+ _build_homepage_footer_html),讓 create_app() 能把 gr.Button 插在
+ 兩段中間;兩段共用同一個 .homepage-col 外層,改由 create_app() 用
+ gr.Column(elem_classes=["homepage-col"]) 包起來,不是這裡自己吐一個
+ 大 。
+ """
return (
- '
'
'
'
- '
重譯文本量化分析平台'
+ # 1-C:業主指定移除第一行「重譯文本量化分析平台」(原本的
+ #
),下方直接從系列名稱開始。
'譯彩紛呈:重譯文本分析系統
'
'TransPrism: An Analytical Framework for Retranslation
'
'II 分析引擎 SpectraEngine
'
+ # 1-F:描述文字砍掉原本結尾「請先選擇最符合您研究設計的比較情境:」
+ # ——情境選擇已搬去工作區,首頁不用再提示選情境。
'上傳已斷詞的譯本文本,系統將自動計算 75 項語言指標並進行統計分析,'
- '協助您完成重譯研究的量化論證。請先選擇最符合您研究設計的比較情境:
'
+ '協助您完成重譯研究的量化論證。'
''
- f'
{"".join(cards)}
'
+ )
+
+
+def _build_homepage_footer_html() -> str:
+ """首頁介紹區塊下半部(讀取進度佔位連結+底部說明),接在 1-B 的
+ 「開始研究分析」按鈕下方。見 _build_homepage_hero_html 上方說明。
+ """
+ return (
'
'
f'{_icon("folder", 16)}讀取進度(功能開發中)'
'
'
- ''
- '
'
+ # 1-G:底部說明文字改版,原文「選擇任一情境即開始分析」也不再適用
+ # (首頁不選情境了)。
+ ''
)
@@ -4414,26 +4764,45 @@ def create_app():
# ══════════════════════════════════════════════════════════════
# 主頁(Phase 8-C:不再包在 gr.Tabs()/gr.Tab() 裡,外層分頁列已拿掉)
# ══════════════════════════════════════════════════════════════
- # Phase 8:首頁改成 4 張情境卡片(gr.HTML()+JS橋接,Gradio 無原生
- # 卡片元件,點卡片=模擬點擊下方隱藏版 sc_btn_1..4,見
- # _APP_HEAD_SCRIPT 的 bindScenarioCards())。情境選定後這塊隱藏,
- # workspace_row(對話+操作區)才出現。
+ # Phase 9(2026-07-30):首頁只留品牌介紹+一顆「開始研究分析」入口
+ # 按鈕(1-A/1-B)。原本住這裡的 4 張情境卡片搬去工作區的「研究
+ # 選擇」步驟(見下方 scenario_select_row、3-A),首頁不再展示情境
+ # 內容,也不需要在首頁解析使用者選了哪個情境。
+ # .homepage-col 這個外層改由這裡的 gr.Column 承接(elem_classes),
+ # 不是 _build_homepage_hero_html()/_build_homepage_footer_html()
+ # 自己吐一個
——因為「開始研究分析」是
+ # 真正的 gr.Button(需要接 Python 事件),必須插在 hero/footer
+ # 兩段 HTML 中間,同一個 Column 才能讓三者視覺上仍是同一塊。
with gr.Column(visible=True) as homepage_col:
- gr.HTML(_build_homepage_html())
- # 隱藏版情境按鈕:純作 JS 橋接目標(.sc-bridge-btn,見 CSS/
- # bindScenarioCards()),.click() 綁定邏輯完全不動。必須放在
- # 一開始就 visible=True 的容器裡(homepage_col),因為 Gradio
- # 對「建構時就 visible=False」的容器是整段不掛載進 DOM,不是
- # 只用 CSS display:none 藏起來——放在 workspace_row 裡會導致
- # 這幾顆按鈕在情境選定前根本不存在於 DOM,JS 找不到可點的對象。
- sc_btn_1 = gr.Button("1 人工翻譯 vs 機器翻譯", variant="secondary",
- elem_id="sc_btn_1", elem_classes=["sc-bridge-btn"])
- sc_btn_2 = gr.Button("2 全譯 vs 編譯/節譯/改寫", variant="secondary",
- elem_id="sc_btn_2", elem_classes=["sc-bridge-btn"])
- sc_btn_3 = gr.Button("3 同期不同譯者譯本比較", variant="secondary",
- elem_id="sc_btn_3", elem_classes=["sc-bridge-btn"])
- sc_btn_4 = gr.Button("4 不同時期重譯本的歷時比較", variant="secondary",
- elem_id="sc_btn_4", elem_classes=["sc-bridge-btn"])
+ with gr.Column(elem_classes=["homepage-col"]):
+ gr.HTML(_build_homepage_hero_html())
+ # 1-B:真正的 gr.Button,不是首頁卡片那種「HTML+隱藏按鈕
+ # JS 橋接」手法——那個手法存在的理由是 Gradio 沒有原生卡片
+ # 元件,單顆按鈕不需要繞這一圈,直接掛 .click() 即可(見下方
+ # start_analysis_btn.click() wiring)。
+ start_analysis_btn = gr.Button(
+ "開始研究分析", elem_id="start_analysis_btn", variant="primary",
+ )
+ gr.HTML(_build_homepage_footer_html())
+
+ # 3-A:研究選擇用的 4 顆隱藏版情境按鈕(.sc-bridge-btn,JS 橋接
+ # 目標,見 _APP_HEAD_SCRIPT 的 document click 代理)。原本住在
+ # homepage_col 裡,首頁改版後 homepage_col 進工作區時會被設成
+ # visible=False——Gradio 對「visible=False 的容器」是整段從 DOM
+ # 卸載(不是只用 CSS 隱藏),這幾顆按鈕會跟著被卸載,JS 就再也點
+ # 不到卡片。搬到這裡(跟 mobile_nav_toggle_html/nav_backdrop_html
+ # 同一層級:最外層、一開始就 visible=True、建構時就掛進 DOM 的
+ # 位置),不管 homepage_col 或 workspace_row 怎麼切換可見性,這
+ # 幾顆按鈕永遠掛在 DOM 上,JS 永遠找得到可點的對象。.click() 綁定
+ # 邏輯(on_scenario_pick)完全不用改。
+ sc_btn_1 = gr.Button("1 人工翻譯 vs 機器翻譯", variant="secondary",
+ elem_id="sc_btn_1", elem_classes=["sc-bridge-btn"])
+ sc_btn_2 = gr.Button("2 全譯 vs 編譯/節譯/改寫", variant="secondary",
+ elem_id="sc_btn_2", elem_classes=["sc-bridge-btn"])
+ sc_btn_3 = gr.Button("3 同期不同譯者譯本比較", variant="secondary",
+ elem_id="sc_btn_3", elem_classes=["sc-bridge-btn"])
+ sc_btn_4 = gr.Button("4 不同時期重譯本的歷時比較", variant="secondary",
+ elem_id="sc_btn_4", elem_classes=["sc-bridge-btn"])
# Phase 8-E:手機漢堡開關+抽屜背景遮罩。跟 sc_btn_1..4 同一類坑:
# 建構時 visible=False 的容器整段不掛載進 DOM,而這兩個元件要在
@@ -4472,7 +4841,8 @@ def create_app():
elem_id="nav_backdrop_wrap",
)
- # 「開始新分析」確認對話框(2026-07-24 改成置中 modal):原本是
+ # 「回首頁」確認對話框(2026-07-24 改成置中 modal,2026-07-30
+ # 隨按鈕改名一併調整文案):原本是
# nav-col 裡的一張內嵌卡片,擠在 220px 窄欄裡,收合成 60px icon bar
# 時更不成人形(8-E 當時還為此加了「收合狀態下點重置先自動展開
# nav-col」的變通,改成 modal 後那個理由消失,該變通已一併移除)。
@@ -4480,15 +4850,21 @@ def create_app():
# position:fixed+transform 的抽屜,而被 transform 的祖先會讓子孫的
# position:fixed 改以該祖先為定位基準,對話框會被關在抽屜裡而不是
# 覆蓋整個視窗。
+ # 2026-07-30(2-B 第 4 項):按鈕改名「回首頁」後,文案也要跟著改,
+ # 但行為完全沒變——千卉已確認回首頁一樣是整個重置(進度會遺失),
+ # 不是單純切換畫面,所以文案刻意保留「遺失進度」這句,避免使用者
+ # 誤以為只是導覽切換。elem_id(reset_confirm_overlay/panel/
+ # reset_cancel_btn/reset_confirm_btn)與 on_reset_clear_workspace/
+ # on_reset_confirm 的 wiring 完全不動,純文案異動。
with gr.Column(visible=False, elem_id="reset_confirm_overlay",
elem_classes=["reset-confirm-overlay"]) as reset_confirm_row:
with gr.Column(elem_id="reset_confirm_panel", elem_classes=["reset-confirm-panel"]):
- gr.Markdown("確定要開始新分析嗎?目前進度將會遺失。",
+ gr.Markdown("確定要回首頁嗎?目前進度將會遺失,需要重新開始整個分析流程。",
elem_classes=["reset-confirm-text"])
with gr.Row(elem_classes=["reset-confirm-actions"]):
reset_cancel_btn = gr.Button("取消", elem_id="reset_cancel_btn",
scale=1, variant="secondary")
- reset_confirm_btn = gr.Button("確定重新開始", elem_id="reset_confirm_btn",
+ reset_confirm_btn = gr.Button("確定回首頁", elem_id="reset_confirm_btn",
scale=1, variant="primary")
# Phase 8-B:三欄式工作區——nav-col(窄,導覽/重置)+chat-col
@@ -4496,31 +4872,25 @@ def create_app():
# 執行紀錄,獨立捲動)。手機寬度見 CSS 的 media query 改上下堆疊。
with gr.Row(elem_classes=["main-layout-row"], visible=False) as workspace_row:
with gr.Column(scale=2, min_width=200, elem_classes=["nav-col"]) as nav_col:
- # Phase 8-E:收合/抽屜控制列。兩顆按鈕互斥顯示(CSS
- # media query 切換,見 5e 區塊):桌面寬度顯示收合鈕
- # (nav_collapse_toggle,縮成 icon bar);手機寬度顯示
- # 關閉鈕(nav_drawer_close,收起抽屜)。純畫面操作,
- # 不牽動任何後端狀態,沿用 result_nav_col 同一套「事件
- # 代理綁在 document」手法(見 _APP_HEAD_SCRIPT)。
- # 2026-07-24:頂端一列=品牌字標(左)+ 明暗切換/收合鈕(右),
- # 仿 Claude 側欄左上字標。品牌字標純英文「SpectraEngine」漸層
- # (canvas 頂部另有中英文完整版);明暗切換鈕放收合鈕左邊(千卉
- # 指定)。收合成 icon bar 時字標用 font-size:0 隱藏、只留兩顆 icon。
+ # 2026-07-30(2-B 第 1/2 項全面改版):nav-col 這輪拆成三段式
+ # 結構——①這裡(頂端品牌列,固定不捲動)②下面
+ # nav_items_scroll(中段,flex:1 自己 overflow-y:auto)③欄位
+ # 收尾處的 nav_bottom_toolbar(底部工具列,固定不捲動)。原因
+ # 見 .nav-col CSS 規則本身的長註解:明暗切換/收合鈕這輪要移到
+ # 「置底+置右」,如果整欄還是共用同一個捲動容器,內容一多,
+ # 底部工具列就會被捲出視窗——跟 Bug 4-B(下載捷徑那組被摺行
+ # 裁掉)是同一類「flex 子項可以無限長大、把重要項目擠出可視
+ # 範圍」的問題,只是換了個受害者,這次拆結構從根本避免。
+ # 2026-07-31(Batch E 第 2 項):品牌字標從 3 行改 2 行(業主
+ # 改主意,見 .nav-brand CSS 的同批註解),字級統一改 1.1rem;
+ # 手機抽屜關閉鈕(nav_drawer_close)跟品牌字標一起留在這個
+ # 固定頂端列,抽屜開關本來就该在使用者一打開就摸得到的
+ # 地方,不用跟著挪。
gr.HTML(
'
'
- '
SpectraEngine'
- '
'
- # 兩個圖示都先放進去、用 CSS 依 data-theme-icon 切換顯示。
- # 不用 JS 改寫 innerHTML:改寫會把
'
'
'
@@ -4530,146 +4900,188 @@ def create_app():
elem_id="nav_top_html",
)
- # 研究情境是封閉式的固定四選一,改用可點擊按鈕取代打字輸入
- # 數字再解析,選定後即隱藏,對話視窗回歸純輸出角色
- # Phase 8:情境選擇按鈕已搬到 homepage_col(見上方,理由是
- # Gradio 對建構時 visible=False 的容器不掛載進 DOM,見該處
- # 註解)。這個 Column 目前是空的,只留來讓 on_scenario_pick/
- # on_reset_confirm 既有的可見性輸出繼續運作,不動更多 wiring;
- # Phase 8-F 全站清理時一併拿掉。
- with gr.Column(elem_classes=["scenario-buttons"]) as scenario_btn_col:
- pass
-
- # 「開始新分析」與其確認彈窗:換情境/重新開始都走這一套共用
- # 機制。情境是封閉式按鈕選擇,不透過對話框打字,所以「換
- # 情境」也統一走這顆按鈕,不恢復文字解析路徑。
- reset_btn = gr.Button(
- "開始新分析", icon=str(BASE_DIR / "assets" / "icons" / "plus.svg"),
- elem_id="reset_btn", elem_classes=["reset-btn"], variant="secondary",
- )
- # Phase 8-D:結果導覽——情境選定後顯示,讓使用者不用手動
- # 往下捲一大段就能跳到 Canvas 對應區塊。這幾顆按鈕刻意不接
- # Python .click():純粹是「捲動+切換巢狀子分頁」的畫面
- # 操作,不牽動任何後端狀態,改用跟首頁情境卡片同一套手法
- # (_APP_HEAD_SCRIPT 的 JS 監聽),完全不用走 Gradio queue
- # 來回,反應更快。(下載捷徑當初規劃留到下一輪補,已於
- # 2026-07-24 補齊,見下方 nav_dl_* 那四顆。)
- with gr.Column(visible=False, elem_id="result_nav_col", elem_classes=["result-nav"]) as result_nav_col:
- # 2026-07-23 改名「AI對話」+改變功能定位:原本純粹是
- # 「捲回 Canvas 最上面」的畫面操作,現在身兼「切回流程頁」
- # 的角色(見 applyActivePage() JS)——流程進行中(上傳/
- # 表單/運算中)對話欄常駐顯示,點結果類項目才收起;點
- # 這顆按鈕會讓對話欄彈回來。圖示維持 home(語意上仍是
- #「回到主要工作流程」,不用重畫新圖示)。
- nav_top_btn = gr.Button(
- "AI對話", icon=str(BASE_DIR / "assets" / "icons" / "home.svg"),
- elem_id="nav_top_btn", elem_classes=["result-nav-btn"], variant="secondary",
- )
- # 2026-07-24(A2):結果類導覽項目預設 interactive=False。
- # 運算完成前它們就已經隨 result_nav_col 顯示,但對應的
- # canvas_*_col 還是 Gradio visible=False,點下去只會切到一片
- # 空白(JS 只能清 display,蓋不過 Python 的 visible=False)。
- # 改成先 disable(灰階),由 _populate_tabs 依各結果是否真的
- # 產出來逐一啟用——LLM 輔助分析尤其:報告失敗時它維持灰的,
- # 剛好是失敗訊號的第二道確認。AI 對話與技術執行紀錄不在此列
- # (前者永遠可回、後者從第一秒就有內容)。
- nav_idx_btn = gr.Button(
- "語言指標分析", icon=str(BASE_DIR / "assets" / "icons" / "trending-up.svg"),
- elem_id="nav_idx_btn", elem_classes=["result-nav-btn"], variant="secondary",
- interactive=False,
+ # 中段可捲動區:研究情境(已隱藏的空殼)、回首頁連結、結果導覽
+ # 全部包進來,只有這個 Column 自己 overflow-y:auto(見
+ # .nav-items-scroll CSS),不影響上下兩段固定區塊。
+ with gr.Column(elem_classes=["nav-items-scroll"]) as nav_items_scroll:
+ # 研究情境是封閉式的固定四選一,改用可點擊按鈕取代打字輸入
+ # 數字再解���,選定後即隱藏,對話視窗回歸純輸出角色
+ # Phase 8:情境選擇按鈕已搬到 homepage_col(見上方,理由是
+ # Gradio 對建構時 visible=False 的容器不掛載進 DOM,見該處
+ # 註解)。這個 Column 目前是空的,只留來讓 on_scenario_pick/
+ # on_reset_confirm 既有的可見性輸出繼續運作,不動更多 wiring;
+ # Phase 8-F 全站清理時一併拿掉。
+ with gr.Column(elem_classes=["scenario-buttons"]) as scenario_btn_col:
+ pass
+
+ # 「回首頁」連結與其確認彈窗:換情境/回首頁都走這一套共用
+ # 機制。情境是封閉式按鈕選擇,不透過對話框打字,所以「換
+ # 情境」也統一走這顆按鈕,不恢復文字解析路徑。
+ # 2026-07-30(2-B 第 3 項):原本是置中的「開始新分析」大按鈕,
+ # 千卉這輪改成置左的「回首頁」文字連結,圖示也跟著換成 home
+ # (對話氣泡讓給下面的「AI對話」,語意上 home 更適合「回首頁」)。
+ # elem_id="reset_btn" 不動,後面所有 .click() wiring/收合狀態
+ # 選擇器都靠這個 id,行為完全不變(見 on_reset_confirm 附近
+ # 註解:仍然是整個重置,不是單純換頁面)。
+ reset_btn = gr.Button(
+ "回首頁", icon=str(BASE_DIR / "assets" / "icons" / "home.svg"),
+ elem_id="reset_btn", elem_classes=["reset-btn"], variant="secondary",
)
- # 2026-07-24 千卉決定:拿掉「統計比較分析」這層 Accordion
- # (標題文字與收合效果都不要),四個子頁直接跟其他導覽項目
- # 平列。它原本存在的理由(2026-07-23 改 open=True 時的說法)
- # 是「讓人看得出底下還有四個子頁面」,但四頁攤開後這層標題
- # 只剩下多一列文字跟一個不會有人去點的箭頭。
- # 副作用:原本「統計比較分析」那一列兼任 stat 頁的 active
- # 指示器,拿掉後改由使用者實際點的那個子項目自己標 active,
- # 見 _APP_HEAD_SCRIPT 的 applyActivePage()。
- nav_stat_sub_0 = gr.Button(
- "敘述統計", icon=str(BASE_DIR / "assets" / "icons" / "table-cells.svg"),
- elem_id="nav_stat_sub_0", elem_classes=["result-nav-btn"], variant="secondary",
- interactive=False)
- nav_stat_sub_1 = gr.Button(
- "差異性分析", icon=str(BASE_DIR / "assets" / "icons" / "scale.svg"),
- elem_id="nav_stat_sub_1", elem_classes=["result-nav-btn"], variant="secondary",
- interactive=False)
- nav_stat_sub_2 = gr.Button(
- "監督式學習", icon=str(BASE_DIR / "assets" / "icons" / "academic-cap.svg"),
- elem_id="nav_stat_sub_2", elem_classes=["result-nav-btn"], variant="secondary",
- interactive=False)
- nav_stat_sub_3 = gr.Button(
- "非監督式學習", icon=str(BASE_DIR / "assets" / "icons" / "squares-2x2.svg"),
- elem_id="nav_stat_sub_3", elem_classes=["result-nav-btn"], variant="secondary",
- interactive=False)
- nav_report_btn = gr.Button(
- "LLM輔助分析", icon=str(BASE_DIR / "assets" / "icons" / "document.svg"),
- elem_id="nav_report_btn", elem_classes=["result-nav-btn"], variant="secondary",
- interactive=False,
- )
- # ── 下載捷徑(2026-07-24)────────────────────────────
- # 上面四項是「去看結果」,這四顆是「把結果帶走」,性質
- # 不同所以用分隔線隔開。原本使用者要拿到全部產出得點進
- # 三個結果頁各按各的下載鈕(共 15 個檔案),這裡各打成
- # 一包 zip。內容為空的那幾包不會產生,對應按鈕就不出現
- # (例如 LLM 報告失敗時「下載研究報告」不會亮出來)。
- # 分隔線與四顆按鈕整組包進 nav_dl_group:沒有任何一包 zip
- # 時整組隱藏(否則分隔線會孤零零留在畫面上,還跟下面技術
- # 執行紀錄的分隔線貼在一起變兩條);有 zip 時整組顯示,
- # 個別按鈕再依自己那包是��存在決定。群組與個別可見性都由
- # _populate_tabs 設定。
- with gr.Column(visible=False, elem_id="nav_dl_group",
- elem_classes=["result-nav-dl-group"]) as nav_dl_group:
- gr.HTML('
')
- nav_dl_idx_btn = gr.DownloadButton(
- "下載指標數據", icon=str(BASE_DIR / "assets" / "icons" / "download.svg"),
- visible=False, elem_id="nav_dl_idx_btn",
- elem_classes=["result-nav-btn", "result-nav-dl"], variant="secondary",
+ # Phase 8-D:結果導覽——情境選定後顯示,讓使用者不用手動
+ # 往下捲一大段就能跳到 Canvas 對應區塊。這幾顆按鈕刻意不接
+ # Python .click():純粹是「捲動+切換巢狀子分頁」的畫面
+ # 操作,不牽動任何後端狀態,改用跟首頁情境卡片同一套手法
+ # (_APP_HEAD_SCRIPT 的 JS 監聽),完全不用走 Gradio queue
+ # 來回,反應更快。(下載捷徑當初規劃留到下一輪補,已於
+ # 2026-07-24 補齊,見下方 nav_dl_* 那四顆。)
+ with gr.Column(visible=False, elem_id="result_nav_col", elem_classes=["result-nav"]) as result_nav_col:
+ # 2026-07-23 改名「AI對話」+改變功能定位:原本純粹是
+ # 「捲回 Canvas 最上面」的畫面操作,現在身兼「切回流程頁」
+ # 的角色(見 applyActivePage() JS)——流程進行中(上傳/
+ # 表單/運算中)對話欄常駐顯示,點結果類項目才收起;點
+ # 這顆按鈕會讓對話欄彈回來。
+ # 2026-07-30(2-B 第 3 項):圖示改用對話氣泡(chat-bubble.
+ # svg),語意上比原本借用的 home 圖示更準確——home 這次讓給
+ # 上面新改名的「回首頁」連結,兩顆圖示不再共用同一個。
+ nav_top_btn = gr.Button(
+ "AI對話", icon=str(BASE_DIR / "assets" / "icons" / "chat-bubble.svg"),
+ elem_id="nav_top_btn", elem_classes=["result-nav-btn"], variant="secondary",
)
- nav_dl_stat_btn = gr.DownloadButton(
- "下載統計圖表", icon=str(BASE_DIR / "assets" / "icons" / "download.svg"),
- visible=False, elem_id="nav_dl_stat_btn",
- elem_classes=["result-nav-btn", "result-nav-dl"], variant="secondary",
+ # 2026-07-24(A2):結果類導覽項目預設 interactive=False。
+ # 運算完成前它們就已經隨 result_nav_col 顯示,但對應的
+ # canvas_*_col 還是 Gradio visible=False,點下去只會切到一片
+ # 空白(JS 只能清 display,蓋不過 Python 的 visible=False)。
+ # 改成先 disable(灰階),由 _populate_tabs 依各結果是否真的
+ # 產出來逐一啟用——LLM 輔助分析尤其:報告失敗時它維持灰的,
+ # 剛好是失敗訊號的第二道確認。AI 對話與技術執行紀錄不在此列
+ # (前者永遠可回、後者從第一秒就有內容)。
+ nav_idx_btn = gr.Button(
+ "語言指標分析", icon=str(BASE_DIR / "assets" / "icons" / "trending-up.svg"),
+ elem_id="nav_idx_btn", elem_classes=["result-nav-btn"], variant="secondary",
+ interactive=False,
)
- nav_dl_report_btn = gr.DownloadButton(
- "下載研究報告", icon=str(BASE_DIR / "assets" / "icons" / "download.svg"),
- visible=False, elem_id="nav_dl_report_btn",
- elem_classes=["result-nav-btn", "result-nav-dl"], variant="secondary",
+ # 2026-07-24 千卉決定:拿掉「統計比較分析」這層 Accordion
+ # (標題文字與收合效果都不要),四個子頁直接跟其他導覽項目
+ # 平列。它原本存在的理由(2026-07-23 改 open=True 時的說法)
+ # 是「讓人看得出底下還有四個子頁面」,但四頁攤開後這層標題
+ # 只剩下多一列文字跟一個不會有人去點的箭頭。
+ # 副作用:原本「統計比較分析」那一列兼任 stat 頁的 active
+ # 指示器,拿掉後改由使用者實際點的那個子項目自己標 active,
+ # 見 _APP_HEAD_SCRIPT 的 applyActivePage()。
+ nav_stat_sub_0 = gr.Button(
+ "敘述統計", icon=str(BASE_DIR / "assets" / "icons" / "table-cells.svg"),
+ elem_id="nav_stat_sub_0", elem_classes=["result-nav-btn"], variant="secondary",
+ interactive=False)
+ nav_stat_sub_1 = gr.Button(
+ "差異性分析", icon=str(BASE_DIR / "assets" / "icons" / "scale.svg"),
+ elem_id="nav_stat_sub_1", elem_classes=["result-nav-btn"], variant="secondary",
+ interactive=False)
+ nav_stat_sub_2 = gr.Button(
+ "監督式學習", icon=str(BASE_DIR / "assets" / "icons" / "academic-cap.svg"),
+ elem_id="nav_stat_sub_2", elem_classes=["result-nav-btn"], variant="secondary",
+ interactive=False)
+ nav_stat_sub_3 = gr.Button(
+ "非監督式學習", icon=str(BASE_DIR / "assets" / "icons" / "squares-2x2.svg"),
+ elem_id="nav_stat_sub_3", elem_classes=["result-nav-btn"], variant="secondary",
+ interactive=False)
+ nav_report_btn = gr.Button(
+ "LLM輔助分析", icon=str(BASE_DIR / "assets" / "icons" / "document.svg"),
+ elem_id="nav_report_btn", elem_classes=["result-nav-btn"], variant="secondary",
+ interactive=False,
)
- nav_dl_all_btn = gr.DownloadButton(
- "下載完整分析資料", icon=str(BASE_DIR / "assets" / "icons" / "download.svg"),
- visible=False, elem_id="nav_dl_all_btn",
- elem_classes=["result-nav-btn", "result-nav-dl"], variant="secondary",
+ # ── 下載捷徑(2026-07-24)────────────────────────────
+ # 上面四項是「去看結果」,這四顆是「把結果帶走」,性質
+ # 不同所以用分隔線隔開。原本使用者要拿到全部產出得點進
+ # 三個結果頁各按各的下載鈕(共 15 個檔案),這裡各打成
+ # 一包 zip。內容為空的那幾包不會產生,對應按鈕就不出現
+ # (例如 LLM 報告失敗時「下載研究報告」不會亮出來)。
+ # 分隔線與四顆按鈕整組包進 nav_dl_group:沒有任何一包 zip
+ # 時整組隱藏(否則分隔線會孤零零留在畫面上,還跟下面技術
+ # 執行紀錄的分隔線貼在一起變兩條);有 zip 時整組顯示,
+ # 個別按鈕再依自己那包是否存在決定。群組與個別可見性都由
+ # _populate_tabs 設定。
+ with gr.Column(visible=False, elem_id="nav_dl_group",
+ elem_classes=["result-nav-dl-group"]) as nav_dl_group:
+ gr.HTML('
')
+ nav_dl_idx_btn = gr.DownloadButton(
+ "下載指標數據", icon=str(BASE_DIR / "assets" / "icons" / "download.svg"),
+ visible=False, elem_id="nav_dl_idx_btn",
+ elem_classes=["result-nav-btn", "result-nav-dl"], variant="secondary",
+ )
+ nav_dl_stat_btn = gr.DownloadButton(
+ "下載統計圖表", icon=str(BASE_DIR / "assets" / "icons" / "download.svg"),
+ visible=False, elem_id="nav_dl_stat_btn",
+ elem_classes=["result-nav-btn", "result-nav-dl"], variant="secondary",
+ )
+ nav_dl_report_btn = gr.DownloadButton(
+ "下載研究報告", icon=str(BASE_DIR / "assets" / "icons" / "download.svg"),
+ visible=False, elem_id="nav_dl_report_btn",
+ elem_classes=["result-nav-btn", "result-nav-dl"], variant="secondary",
+ )
+ nav_dl_all_btn = gr.DownloadButton(
+ "下載完整分析資料", icon=str(BASE_DIR / "assets" / "icons" / "download.svg"),
+ visible=False, elem_id="nav_dl_all_btn",
+ elem_classes=["result-nav-btn", "result-nav-dl"], variant="secondary",
+ )
+
+ # 2026-07-23:技術執行紀錄從手風琴轉正成獨立頁面(原本
+ # exec_log_accordion 在 canvas-col 底部,現在跟其他三個
+ # 結果頁同一種待遇)。用分隔線隔開,視覺上表達「低優先度
+ # 診斷工具,不是主要分析結果」,避免跟上面三項混為一談。
+ gr.HTML('
')
+ nav_exec_btn = gr.Button(
+ "技術執行紀錄", icon=str(BASE_DIR / "assets" / "icons" / "folder.svg"),
+ elem_id="nav_exec_btn", elem_classes=["result-nav-btn", "result-nav-btn--muted"],
+ variant="secondary",
)
-
- # 2026-07-23:技術執行紀錄從手風琴轉正成獨立頁面(原本
- # exec_log_accordion 在 canvas-col 底部,現在跟其他三個
- # 結果頁同一種待遇)。用分隔線隔開,視覺上表達「低優先度
- # 診斷工具,不是主要分析結果」,避免跟上面三項混為一談。
- gr.HTML('
')
- nav_exec_btn = gr.Button(
- "技術執行紀錄", icon=str(BASE_DIR / "assets" / "icons" / "folder.svg"),
- elem_id="nav_exec_btn", elem_classes=["result-nav-btn", "result-nav-btn--muted"],
- variant="secondary",
- )
+ # ↑ nav_items_scroll 到此結束(中段可捲動區)。
+
+ # 底部工具列(固定,不隨中段捲動):明暗切換/收合鈕原本在頂端
+ # 品牌列右側,這輪千卉指定移到「置底+置右」,上方用一條水平線
+ # (border-top,見 .nav-bottom-toolbar CSS)分隔。兩顆按鈕本身
+ # 的 id/aria-label/內部 SVG 完全沿用,只是搬了位置,_APP_HEAD_
+ # SCRIPT 裡靠 #theme_toggle/#nav_collapse_toggle 這兩個 id 找
+ # 元件的事件代理(document 層級)完全不受影響,不用動 JS。
+ gr.HTML(
+ '
'
+ f''
+ f''
+ '
',
+ elem_id="nav_bottom_toolbar",
+ )
with gr.Column(scale=3, min_width=280, elem_classes=["chat-col"]):
- # 高度不再寫死 px,改用 CSS flex-grow 讓對話視窗跟輸入框依
- # chat-col 當下的可用高度按 5:1 比例分配(見 .main-chat/
- # #chat_upload_zone 的 flex 設定),視窗縮放時比例仍會維持。
+ # main-chat 用 flex:1 1 auto 吃掉 chat-col 的全部高度(見該
+ # CSS 規則),下面 chat_upload_col 這輪起改成 visible=False
+ # 常駐隱藏,對話視窗因此自然吃滿整欄高度,不用另外調 flex 比例。
chatbot = gr.Chatbot(
show_label=False,
elem_classes=["main-chat"],
)
- # Phase 8(千卉實測後回頭調整):對話輸入框改回「常駐顯示、
- # 不負責上傳」——業主原本設計就是用拖曳/點擊上傳的卡片
- # (見下方 upload_row),對話框目前也沒有其他打字用途
- # (全站掃過沒有任何地方會解析使用者自由輸入文字),暫時
- # 只留著當畫面元素,不接 sources=["upload"],避免顯示
- # 附加檔案的迴紋針卻沒有作用。(原本的 chat_upload.submit()
- # 轉接函式 on_chat_upload_submit 已於 2026-07-24 當死碼移除,
- # 之後要復活直接重接 .submit() 即可,見該處註解。)
- with gr.Column(visible=True, elem_id="chat_upload_zone", elem_classes=["upload-zone-plain"]) as chat_upload_col:
+ # 2026-07-30(2-C 第 5 項):對話輸入框這輪改成常駐隱藏
+ # (visible=False,不刪元件——降低風險,也保留 Phase 8 這段
+ # 沿革紀錄)。它本來就是「沒有真正作用的佔位元件」(見下方
+ # 沿革說明),千卉這輪決定乾脆藏起來,讓對話視窗吃滿整欄。
+ # 用 visible=False 而不是拿掉整個 gr.Column:component 仍在
+ # DOM 樹裡建構好,之後若要復活只要把這裡改回 True,不用重寫
+ # wiring;而且這是「建構當下就設定好、從未被事件動態切換過」
+ # 的靜態可見性,不吃本檔開頭記錄的 Gradio 6 容器卸載地雷
+ # (那個地雷只在「同一批訊息裡跟祖先可見性一起翻轉」時才會
+ # 咬人,這裡從頭到尾都是 False,沒有翻轉可言)。
+ # ── 以下是 Phase 8 沿革(千卉實測後回頭調整):對話輸入框當時
+ # 改回「常駐顯示、不負責上傳」——業主原本設計就是用拖曳/點擊
+ # 上傳的卡片(見下方 upload_row),對話框目前也沒有其他打字
+ # 用途(全站掃過沒有任何地方會解析使用者自由輸入文字),當時
+ # 只留著當畫面元素,不接 sources=["upload"],避免顯示附加
+ # 檔案的迴紋針卻沒有作用。(原本的 chat_upload.submit() 轉接
+ # 函式 on_chat_upload_submit 已於 2026-07-24 當死碼移除,之後
+ # 要復活直接重接 .submit() 即可,見該處註解。)
+ with gr.Column(visible=False, elem_id="chat_upload_zone", elem_classes=["upload-zone-plain"]) as chat_upload_col:
chat_upload = gr.MultimodalTextbox(
file_types=[".txt"],
sources=[],
@@ -4692,9 +5104,32 @@ def create_app():
# (已實測踩坑)。正確做法:步驟列留在捲動區外面(跟著
# canvas-col 本身固定不動),下面另外包一層
# canvas-scroll 才是真正會捲動的區域,兩者高度各自獨立。
- app_header_html = gr.HTML(_build_header_html())
+ # 2-A(2026-07-30):elem_id 給頂部列的 wrapper,讓 CSS 能鎖定它
+ # 只在「AI 對話」頁顯示(見 5d 區塊 .main-layout-row:not(...)
+ # 那條規則),其他結果頁(語言指標分析/敘述統計/…/技術
+ # 執行紀錄)都不顯示。用 elem_id 而不是 elem_classes:
+ # elem_classes 會同時蓋在外層 .block 與內層 .prose 兩層 div
+ # 上(本檔多處踩過這坑),id 選擇器鎖 wrapper 比較可靠。
+ app_header_html = gr.HTML(_build_header_html(), elem_id="app_header_wrap")
with gr.Column(elem_classes=["canvas-scroll"]):
+ # 3-A(2026-07-30):研究選擇區塊,工作區的第 1 步。點選
+ # 首頁「開始研究分析」進工作區後預設顯示(見
+ # on_start_analysis_show),使用者選定情境後隱藏、換
+ # upload_row 出現(見 on_scenario_pick 的延伸,同一份
+ # yield 裡把這裡設 visible=False)。卡片內容沿用
+ # _build_scenario_cards_html(),跟原本首頁那 4 張卡片
+ # 是同一份 SCENARIOS 資料,不重複刻兩份。視覺樣式沿用
+ # upload-zone/metadata-zone 同一批扁平卡片語彙(見
+ # .scenario-select-zone CSS)。
+ with gr.Column(visible=True, elem_id="scenario_select_zone",
+ elem_classes=["scenario-select-zone"]) as scenario_select_row:
+ # 標題+說明文字沿用 metadata_row 那則 Markdown 的寫法
+ # (純 "### 標題\n說明文字",不套 elem_classes),維持
+ # 同一批「Canvas 操作區塊」卡片的既有排版慣例。
+ gr.Markdown("### 研究選擇\n請選擇最符合您研究設計的比較情境,選定後將進入下一步「文本上傳」。")
+ gr.HTML(_build_scenario_cards_html("workspace_scenario_grid"))
+
# Phase 8(千卉實測後回頭調整):這張卡片改回正式使用
# 中的上傳入口(拖曳/點擊上傳),符合業主原本設計;
# Phase 7 曾經把它永久隱藏、改用對話框上傳,這次反
@@ -4710,9 +5145,27 @@ def create_app():
# 隱藏+清空檔案,使用者按了之後畫面沒有任何上傳入口、
# 等於把自己鎖在流程外,沒有實際用途。要換檔案直接在檔案
# 清單上逐一按 ×,要重來走「開始新分析」。
+ # 2026-07-31(Batch G 第 1 項):業主要求在「確認上傳」
+ # 左邊加一顆「重新選擇研究情境」返回鈕,讓使用者選錯情境
+ # 後不必整個「開始新分析」重來一次。次要樣式
+ # (variant="secondary"),視覺權重刻意低於「確認上傳」,
+ # 不跟主要動作搶注意力。wiring 見下方 back_to_scenario_btn
+ # .click()。
with gr.Row(elem_classes=["upload-actions"]):
+ back_to_scenario_btn = gr.Button("重新選擇研究情境", scale=1, variant="secondary")
upload_btn = gr.Button("確認上傳", scale=1, variant="primary")
+ # 3-C(2026-07-30):文本上傳工作進度說明,比照「分析運算」
+ # 內容區塊(_build_analysis_html/computing_html)的做法,
+ # 業主回報「上傳過程都一片白,只在對話視窗出現文字氣泡,
+ # 用戶會不知道發生什麼事」。獨立於 upload_row 之外(不是
+ # 巢狀在裡面):on_upload_confirm 的第一步就會把 upload_row
+ # 設 visible=False(避免遮罩擋住操作),若進度說明巢狀在
+ # upload_row 裡會跟著一起被藏起來,等於沒有解決業主回報的
+ # 問題。空字串=上傳尚未開始、不顯示,跟 computing_html
+ # 同一種語意,見 _build_upload_html。
+ upload_progress_html = gr.HTML(value="", elem_id="upload_progress_zone")
+
# ── 語料 Metadata 說明表單(上傳後、分析前)───────
with gr.Column(visible=False, elem_id="metadata_zone", elem_classes=["metadata-zone"]) as metadata_row:
gr.Markdown("### 📑 語料 Metadata 說明\n請於正式分析前說明語料來源、範圍與比較結構,將寫入研究報告。")
@@ -5065,11 +5518,9 @@ def create_app():
R[30] = gr.update(visible=True)
# ── 顯示各分頁 Tab(index 20-22)+結果導覽閘門(31-36,A2)──────
- any_tab_ready = False
if csv_path.exists():
R[20] = gr.update(visible=True) # 語言指標分析
R[31] = gr.update(interactive=True) # nav_idx_btn
- any_tab_ready = True
stat_ready = desc_path.exists() or imp_path.exists() \
or any(p.exists() for p in [dendro_path, elbow_path, pca_fig_path])
if stat_ready:
@@ -5077,17 +5528,20 @@ def create_app():
# 統計四個子頁共用同一頁,統計一產出就四個一起開
for _i in (32, 33, 34, 35):
R[_i] = gr.update(interactive=True)
- any_tab_ready = True
if txt_files or docx_files:
R[22] = gr.update(visible=True) # 研究報告
R[36] = gr.update(interactive=True) # nav_report_btn(報告失敗時維持 disable)
- any_tab_ready = True
- # 分頁內容(大表格、多張圖)從「不可見」變「可見」到實際整理進畫面
- # 中間有一段沒有任何提示的空檔,加上這段運算本身就要跑數分鐘,使用
- # 者常誤以為系統當掉了——這裡明確用 toast 告知「現在真的可以點了」
- if any_tab_ready:
- gr.Info("分析結果已就緒,請點選左側導覽列查看各項結果!")
+ # 2026-07-31(Batch E 第 7 項):業主要求拿掉統計分析跑完後跳出的
+ # gr.Info toast(理由:其他階段都沒有通知,只有這裡有,不一致又
+ # 干擾)。原本用來擋重複 toast 的 state["tabs_toast_shown"] 旗標
+ # (Bug 4-A 修復時加的,因為 _populate_tabs 現在會在 idx/stat/
+ # report 三個子階段各自完成時+結尾各呼叫一次,不再只呼叫一次)
+ # 連同 any_tab_ready 這個只為了算 toast 條件而存在的區域變數
+ # 一併移除——拿掉 toast 之後兩者都沒有其他用途,留著是無作用的
+ # 殘留狀態,不是這批任務要避免的「順手重構」,是移除本項本身的
+ # 必要連帶清理。state["tabs_toast_shown"] 的初始化也一併從
+ # make_initial_state 拿掉(見該處)。
return R
@@ -5106,9 +5560,12 @@ def create_app():
def on_load_ready(chat_history, log_history, state):
"""第二步:顯示固定歡迎訊息。"""
+ # 2026-07-31(Batch E 第 4-d 項):業主拿掉「(或下方)」——情境
+ # 選擇已搬進工作區右側 Canvas,對話框不再需要提示「或下方」
+ # 這個舊版單欄置中版面才有意義的說法。
intro = (
"歡迎使用 TransPrism II 分析引擎 SpectraEngine。\n\n"
- "請依照您的研究設計,點選右方(或下方)最符合的研究情境開始分析:"
+ "請依照您的研究設計,點選右方最符合的研究情境開始分析:"
)
return (
[_assistant_msg(intro)],
@@ -5139,7 +5596,10 @@ def create_app():
# ── Phase 8-D:Canvas 運算中提示(粗粒度階段文字+轉圈動畫)─────
# 只在三段運算階段顯示(2026-07-23 步驟列收斂後 key 從 5/6/7 改成
- # 4/5/6,這個字典的 key 是 _STEPS 的步驟編號,改步驟列一定要一起改),
+ # 4/5/6,這段是當時還用數字 key 時的歷史紀錄;現在 _ANALYSIS_ENTRY
+ # 的 key 已經是 "idx"/"stat"/"report" 字串,不是 _STEPS 的步驟編號,
+ # 2026-07-30 新增「研究選擇」步驟、_STEPS 從 3 步變 4 步、純步驟編號
+ # 全部 +1,跟這個字典無關,不用一起改),
# 不新增運算邏輯;用 gr.HTML() 單一元件承載,空字串=不顯示、不用另外
# 接一個 visibility 輸出,wiring 只多一個輸出點。
# 2026-07-24:原本這裡是「運算中…(步驟 N/3)」單行提示。它跟步驟列
@@ -5210,12 +5670,185 @@ def create_app():
def _computing_update(state):
return gr.update(value=_build_analysis_html(state))
+ # ── 3-C(2026-07-30):文本上傳工作進度說明 ─────────────────────
+ # 業主回報「上傳過程都一片白,只在對話視窗出現文字氣泡,用戶會不
+ # 知道發生什麼事」。比照上面「分析運算」內容區塊的做法:同一組
+ # .analysis-panel CSS 視覺語彙(標題/狀態圖示/spinner),不另創
+ # 一套樣式;子階段切成「檔案接收」與「格式驗證」兩段,對應
+ # on_upload_confirm 現有的處理流程(接收檔案→跑 run_format_check)。
+ _UPLOAD_STAGES = [
+ ("receive", "檔案接收"),
+ ("validate", "格式驗證"),
+ ]
+
+ def _build_upload_html(state):
+ if not state:
+ return ""
+ U = state.get("upload") or {}
+ if not U or all(U.get(k, {}).get("status", "pending") == "pending"
+ for k, _ in _UPLOAD_STAGES):
+ return "" # 上傳還沒開始,不顯示(同 _build_analysis_html 的語意)
+
+ rows = []
+ for key, title in _UPLOAD_STAGES:
+ info = U.get(key, {})
+ status = info.get("status", "pending")
+ line = info.get("line", "")
+ if status == "running":
+ icon = '
'
+ line = line or "處理中……"
+ elif status == "done":
+ icon = '
✓'
+ elif status == "failed":
+ icon = '
!'
+ else: # pending
+ icon = '
•'
+ line = line or "等待中"
+ rows.append(
+ '
'
+ f'
{icon}'
+ f'{title}
'
+ f'
{line}
'
+ '
'
+ )
+ return (
+ '
'
+ '
文本上傳
'
+ + "".join(rows) +
+ ''
+ )
+
+ def _upload_update(state):
+ return gr.update(value=_build_upload_html(state))
+
+ # ── 1-B/3-A(2026-07-30):「開始研究分析」進入工作區 ──────────────
+ # 首頁改版後,homepage_col → workspace_row 的翻轉搬到這裡(原本
+ # 「進工作區」跟「選定情境」是同一個事件 on_scenario_pick 的第一個
+ # yield;現在拆成兩個獨立事件:這裡只負責「進工作區、顯示研究選擇
+ # 卡片」,on_scenario_pick 改成只負責「選定情境後的下一步」。
+ # on_scenario_pick 仍保留對 homepage_col/workspace_row 的 gr.update()
+ # 呼叫——此時它們已經是目標值,重複賦值是 no-op,拿掉徒增對「已修好
+ # 的三個 bug」邏輯的改動風險,不如保留不動。
+ #
+ # 4-C 回歸修復(2026-07-31,Batch G 第 0 項):這裡曾經被拆成三個用
+ # .then() 串接的獨立事件(on_start_analysis_show → 補償子元件 →
+ # 補償 nav_dl_group)。實測(DOM 輪詢量測+螢幕截圖)證實:拆成
+ # 「三個獨立 Blocks 事件」跟拆成「同一個 generator 裡的三個 yield」
+ # 不是等價寫法——.then() 串接的每一段都是獨立送出的請求,前端要收到
+ # ��一段回應、畫面重繪完,才會送出下一段請求;這中間有一段肉眼可見
+ # 的時間差(本機量測約 100ms,正式環境網路延遲更大時會更久)。
+ # workspace_row 從 visible=False 翻回 True 那一刻(第一段事件),
+ # 只要 metadata_row/canvas_idx_col/canvas_stat_col/canvas_report_col
+ # 曾經因為走過一次上傳確認/分析完成而被設成過 visible=True,Gradio
+ # 6 就會在這一批訊息把它們的舊 True 值還原回來(本檔開頭記錄的地雷);
+ # 這個還原值會先被畫出來,直到「補償子元件」那段事件送達才會被蓋掉。
+ # 兩段之間的那段真空時間,使用者看到的就是「上一輪的語料說明表單
+ # 疊在新一輪研究選擇卡片下方」——也就是業主回報的 4-C 復發。
+ #
+ # 修法:改回跟 on_scenario_pick 完全一致的做法——單一個 generator
+ # 函式,用多個 yield 取代多個 .then() 事件。同一個 generator 的多次
+ # yield 走的是同一條已建立的連線(stream),前端不需要再送一次新
+ # 請求才能收到下一段更新,兩個 yield 之間的間隔是伺服器端逐行執行
+ # 的時間,量測結果從「~100ms 的網路來回」降到「同一 tick 內」,不會
+ # 再讓使用者看到中間的還原值。
+ #
+ # 【給後續改動者】:這個「祖先容器可見性翻轉」跟「子元件補償重置」
+ # 的先後順序,永遠只能靠「同一個 generator 的下一個 yield」保證,
+ # 不能靠「另一個用 .then() 串接的獨立事件」——後者在 Gradio 6 裡是
+ # 兩個獨立的請求/回應循環,即使邏輯上「馬上接著執行」,使用者仍然
+ # 會先看到一次錯誤畫面。往後如果「進工作區」的入口又搬家(就像這次
+ # 從 on_scenario_pick 搬到 start_analysis_btn 一樣),這三個 yield
+ # 要整組一起搬,不要只搬第一個 yield、把後面兩個留在原地或拆成
+ # .then()。
+ def on_start_analysis_show(state):
+ if state is None:
+ yield (
+ gr.update(visible=False), gr.update(visible=True),
+ gr.update(visible=True), gr.update(), state,
+ gr.update(), gr.update(), gr.update(), gr.update(), gr.update(),
+ gr.update(), gr.update(), gr.update(),
+ )
+ return
+ state["current_step"] = 1
+ # yield 1:workspace_row 從 visible=False 翻回 True 的那一批(祖先
+ # 翻轉),scenario_select_row 本來就要在這時候顯示 True。子元件的
+ # 補償刻意留到下一個 yield,不跟這批同時處理(理由見上方大段註解)。
+ yield (
+ gr.update(visible=False), # homepage_col
+ gr.update(visible=True), # workspace_row
+ gr.update(visible=True), # scenario_select_row
+ 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(), # nav_dl_group 留到第三個 yield
+ )
+ # yield 2(4-C 補償,緊接著上一個 yield,同一個 generator/連線):
+ # 4-a:result_nav_col 這幾顆結果類項目本來就都是 disabled 狀態
+ # (要等對應結果產出才 enable,見 create_app 的 interactive=False
+ # 與 _populate_tabs 的閘門,這批不動那個閘門邏輯),改成「進工作區
+ # 就顯示」只是讓使用者一開始就看得到完整的流程地圖,不是讓他們能
+ # 提前點。
+ yield (
+ gr.update(), gr.update(), gr.update(), gr.update(), state,
+ gr.update(visible=False), # upload_row
+ gr.update(visible=False), # metadata_row
+ 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(), # 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,不受影響。
+ yield (
+ gr.update(), gr.update(), gr.update(), gr.update(), state,
+ gr.update(), gr.update(), gr.update(), gr.update(), gr.update(),
+ gr.update(), gr.update(),
+ gr.update(visible=False), # nav_dl_group
+ )
+
+ start_analysis_btn.click(
+ fn=on_start_analysis_show,
+ inputs=[session_state],
+ outputs=[homepage_col, workspace_row, scenario_select_row, app_header_html, session_state,
+ upload_row, metadata_row, canvas_idx_col, canvas_stat_col, canvas_report_col,
+ result_nav_col, canvas_exec_col, nav_dl_group],
+ )
+
# ── 文字送出(streaming generator)──────────────────────────────────
# ── 研究情境選擇(封閉式固定四選一,按鈕直接觸發,不再解析打字輸入)──
+ # Bug 4-C 補強(2026-07-30,驗證時發現):Gradio 6 對「visible 曾經被
+ # 設過 True 的元件」有個比原本認知更棘手的行為——不是只有「祖先隱藏時
+ # 子元件的 update 被丟棄」,實測(掛 MutationObserver 追蹤 class 變化,
+ # 確認是同一個 DOM 節點、不是重新掛載)發現:workspace_row 這個祖先
+ # 一旦從 visible=False 翻回 True(也就是這裡、使用者選情境的當下),
+ # 底下曾經被設過 True 的子元件(metadata_row/canvas_idx_col/
+ # canvas_stat_col/canvas_report_col——只要曾經因為真的走過一次上傳
+ # 確認/分析完成而被設成 visible=True)會被 Gradio 自動翻回 True,
+ # 蓋掉 on_reset_clear_workspace 稍早設的 False,跟這次選情境的
+ # on_scenario_pick 本身完全無關。canvas_exec_col/result_nav_col
+ # 不受影響,是因為下面第二個 yield 本來就會把它們重新設一次 True,
+ # 剛好跟 Gradio 的還原值一致,看不出差異;file_input/computing_html
+ # 也不受影響,因為它們動的是 value 不是 visible,不吃這個坑。
+ # 純靠 on_reset_confirm 那邊「藏起來」不夠可靠,唯一穩定的做法是在
+ # workspace_row 每次重新變 True 的這個時間點,主動把這四個「應該要
+ # 從乾淨狀態開始」的結果/表單容器重新設回 False,蓋過 Gradio 的還原
+ # 值,不管它是怎麼還原回來的。
def on_scenario_pick(sc_num, chat_history, log_history, state):
if state is None:
yield (chat_history, log_history, state, gr.update(), gr.update(), gr.update(), gr.update(),
- gr.update(), gr.update(), gr.update(), gr.update())
+ gr.update(), gr.update(), gr.update(), gr.update(),
+ gr.update(), gr.update(), gr.update(), gr.update(),
+ gr.update())
return
sc_info = SCENARIOS[sc_num]
@@ -5231,38 +5864,64 @@ def create_app():
# 沿用 gr.update() 不動即可,不用每次都重複賦值。
yield (chat_history, log_history, state, gr.update(), gr.update(), gr.update(), gr.update(),
gr.update(visible=False), gr.update(visible=True), gr.update(visible=True),
- gr.update(visible=True))
+ gr.update(visible=True),
+ gr.update(), gr.update(), gr.update(), gr.update(),
+ gr.update())
reply, state = handle_scenario_select(sc_num, state)
log_history = _log_append(log_history, "✅ 情境選擇完成")
chat_history = chat_history + [_assistant_msg(reply)]
+ # 4-C 補強:metadata_row/canvas_idx_col/canvas_stat_col/
+ # canvas_report_col 的重新隱藏刻意放在「跟 workspace_row 翻成
+ # visible=True 不同的一個 yield」,不是圖方便才分開寫。實測
+ # (MutationObserver 追蹤同一個 DOM 節點)發現:這幾個子元件若
+ # 曾經因為真的走過一次上傳確認/分析完成而被設成 visible=True,
+ # Gradio 的前端會在 workspace_row 這個祖先「同一批訊息」翻回
+ # visible=True 的當下,把它們的舊 True 值蓋回來,跟這批訊息裡我們
+ # 自己對它們下的 visible=False 更新互相��架、我們的更新輸了。
+ # 等 workspace_row 的翻轉已經在前一個 yield 處理完、沉澱下來,
+ # 這一個 yield 才不會再觸發同一種還原,我們的 False 才是最後贏家。
yield (chat_history, log_history, state, gr.update(), _todo_update(state), gr.update(), gr.update(),
- gr.update(), gr.update(), gr.update(), gr.update())
-
- # STEP 1 文本上傳:確認訊息已經導向上傳卡片的「格式要求」區塊,不再
- # 另外用 LLM 生成一則重複格式細節的引導訊息,避免對話視窗出現冗餘
- # 內容。這裡原本是獨立的「上傳引導」步驟,但它跟前一步在同一個
- # generator 內連續完成、中間沒有任何使用者動作,步驟列上永遠只會一
- # 起亮起,2026-07-23 併進「文本上傳」,只留等待上傳的狀態切換。
- state["current_step"] = 1
+ gr.update(), gr.update(), gr.update(), gr.update(),
+ gr.update(visible=False), gr.update(visible=False), gr.update(visible=False),
+ gr.update(visible=False),
+ gr.update())
+
+ # STEP 2 文本上傳(3-A:研究選擇搬進工作區成為正式第 1 步後,
+ # 這裡的步驟編號全部 +1):確認訊息已經導向上傳卡片的「格式要求」
+ # 區塊,不再另外用 LLM 生成一則重複格式細節的引導訊息,避免對話
+ # 視窗出現冗餘內容。這裡原本是獨立的「上傳引導」步驟,但它跟前一步
+ # 在同一個 generator 內連續完成、中間沒有任何使用者動作,步驟列上
+ # 永遠只會一起亮起,2026-07-23 併進「文本上傳」,只留等待上傳的
+ # 狀態切換。
+ state["current_step"] = 2
state["state"] = "UPLOAD_WAIT"
log_history = _log_append(log_history, "⏳ 等待上傳文本……")
- # 情境已選定,按鈕收起;對話視窗自此回歸純輸出角色。
- # 格式要求直接寫進上傳卡片本身(upload_hint_md),使用者不用往上
- # 捲回對話視窗找 AI 剛剛說過的規則——卡片本身就要自己講清楚。
+ # 情境已選定,研究選擇區塊收起、換上傳卡片出現(3-A 延伸:原本
+ # 這裡只切 scenario_btn_col/upload_hint_md,現在 scenario_select_row
+ # 也在同一個 yield 一起隱藏——這個 yield 離 workspace_row 自身的
+ # True/False 翻轉已經隔了兩個 yield,不受本函式上方記錄的 Gradio
+ # 6 still-mounted-snapback 地雷影響,可以放心跟其他更新同批)。
+ # 對話視窗自此回歸純輸出角色。格式要求直接寫進上傳卡片本身
+ # (upload_hint_md),使用者不用往上捲回對話視窗找 AI 剛剛說過的
+ # 規則——卡片本身就要自己講清楚。
hint = (
f"**格式要求**\n\n{sc_info['upload_prompt']}"
)
yield (chat_history, log_history, state, gr.update(visible=True),
_todo_update(state), gr.update(visible=False), gr.update(value=hint),
- gr.update(), gr.update(), gr.update(), gr.update())
+ gr.update(), gr.update(), gr.update(), gr.update(),
+ gr.update(), gr.update(), gr.update(), gr.update(),
+ gr.update(visible=False))
for _sc_num, _sc_btn in (("1", sc_btn_1), ("2", sc_btn_2), ("3", sc_btn_3), ("4", sc_btn_4)):
_sc_btn.click(
fn=functools.partial(on_scenario_pick, _sc_num),
inputs=[chatbot, exec_log, session_state],
outputs=[chatbot, exec_log, session_state, upload_row, app_header_html, scenario_btn_col,
- upload_hint_md, homepage_col, workspace_row, result_nav_col, canvas_exec_col],
+ upload_hint_md, homepage_col, workspace_row, result_nav_col, canvas_exec_col,
+ metadata_row, canvas_idx_col, canvas_stat_col, canvas_report_col,
+ scenario_select_row],
).then(
fn=_populate_tabs,
inputs=[session_state],
@@ -5273,12 +5932,41 @@ def create_app():
# 任何路徑能設回 visible=True,使用者選錯情境後無法變更。這裡補上
# 共用的重置機制:換情境=重新開始,統一走這顆按鈕(不恢復對話框
# 打字選情境的舊路徑)──────────────────────────────────────────
+ # Bug 4-C 修復(2026-07-30):Gradio 6 的 gr.Column/Row(visible=False)
+ # 會把子元件整段從 DOM 卸載,不只是 CSS 隱藏。原本 on_reset_confirm
+ # 在同一個 return 裡,一邊把 workspace_row 設 visible=False,一邊又要
+ # 重置住在 workspace_row 內部的子元件(metadata_row/file_input/
+ # canvas_*_col/computing_html/result_nav_col)——這些子元件那一刻
+ # 已經被卸載,重置的 update 會被靜默丟棄,於是 metadata_row 帶著
+ # 上一輪 _show_metadata_form 設的 visible=True 回來,file_input 也還
+ # 留著舊檔案,就是使用者回報「重置後再進工作區,殘留上一輪畫面」的
+ # 根因。修法:拆成兩個串接的獨立事件。第一個事件
+ # (on_reset_clear_workspace)沒有 inputs,只做「藏起來/清空」,
+ # 在 workspace_row 還可見、子元件仍掛載的當下執行,update 才會生效;
+ # 第二個事件(沿用原名 on_reset_confirm)才把 workspace_row 本身
+ # 連同首頁切換一起做掉,session_state 的重建(make_initial_state)
+ # 也留在這一支。兩支的 outputs 清單不重疊。
+ def on_reset_clear_workspace():
+ return (
+ gr.update(visible=False), # metadata_row
+ gr.update(value=None), # file_input(Phase 8:upload_row 變正式入口後一併清空)
+ gr.update(visible=False), # canvas_idx_col 語言指標分析
+ gr.update(visible=False), # canvas_stat_col 統計比較分析
+ gr.update(visible=False), # canvas_report_col LLM輔助分析
+ gr.update(visible=False), # canvas_exec_col 技術執行紀錄(2026-07-23 轉正後,跟其他三個結果頁一樣重置為隱藏)
+ gr.update(value=""), # computing_html(Phase 8-D:中途重置要清掉運算中提示)
+ gr.update(visible=False), # result_nav_col(Phase 8-D:重新開始=回到首頁,導覽收起)
+ gr.update(value=""), # upload_progress_html(3-C:中途重置要清掉上傳進度提示,同 computing_html)
+ )
+
def on_reset_confirm():
sid = str(uuid.uuid4())[:8]
state = make_initial_state(sid)
+ # 2026-07-31(Batch E 第 4-d 項):同 on_load_ready,拿掉
+ # 「(或下方)」,兩處歡迎詞要保持一致。
intro = (
"歡迎使用 TransPrism II 分析引擎 SpectraEngine。\n\n"
- "請依照您的研究設計,點選右方(或下方)最符合的研究情境開始分析:"
+ "請依照您的研究設計,點選右方最符合的研究情境開始分析:"
)
new_log = f"{_ts()} 已重新開始分析。"
return (
@@ -5288,72 +5976,103 @@ def create_app():
gr.update(value=_build_header_html()), # app_header_html
gr.update(visible=True), # scenario_btn_col(Bug1 關鍵一行)
gr.update(visible=False), # upload_row(Phase 8:正式上傳入口改這張卡片)
- gr.update(value=None), # chat_upload(對話框仍清空一下,雖然目前不接上傳)
- gr.update(visible=False), # metadata_row
- gr.update(visible=False), # canvas_idx_col 語言指標分析
- gr.update(visible=False), # canvas_stat_col 統計比較分析
- gr.update(visible=False), # canvas_report_col LLM輔助分析
gr.update(visible=False), # reset_confirm_row(關掉確認彈窗自己)
- gr.update(visible=False), # canvas_exec_col 技術執行紀錄(2026-07-23 轉正後,跟其他三個結果頁一樣重置為隱藏)
gr.update(visible=True), # homepage_col(Phase 8:重新開始=回到首頁選情境)
gr.update(visible=False), # workspace_row
- gr.update(value=None), # file_input(Phase 8:upload_row 變正式入口後一併清空)
- gr.update(value=""), # computing_html(Phase 8-D:中途重置要清掉運算中提示)
- gr.update(visible=False), # result_nav_col(Phase 8-D:重新開始=回到首頁,導覽收起)
)
reset_btn.click(fn=lambda: gr.update(visible=True), outputs=[reset_confirm_row])
reset_cancel_btn.click(fn=lambda: gr.update(visible=False), outputs=[reset_confirm_row])
reset_confirm_btn.click(
+ fn=on_reset_clear_workspace,
+ outputs=[metadata_row, file_input, canvas_idx_col, canvas_stat_col,
+ canvas_report_col, canvas_exec_col, computing_html, result_nav_col,
+ upload_progress_html],
+ ).then(
fn=on_reset_confirm,
+ # 2026-07-30(2-C 第 5 項):chat_upload 這輪常駐隱藏、不再接任何
+ # wiring(見 chat_upload_col 定義處註解),這裡把它從 outputs 移除,
+ # 不留無意義的清空動作。回傳 tuple 的元素個數/順序已同步調整為
+ # 9 個,跟這份 outputs 清單一一對應。
outputs=[chatbot, exec_log, session_state, app_header_html,
- scenario_btn_col, upload_row, chat_upload, metadata_row,
- canvas_idx_col, canvas_stat_col, canvas_report_col,
- reset_confirm_row, canvas_exec_col, homepage_col, workspace_row, file_input,
- computing_html, result_nav_col],
+ scenario_btn_col, upload_row,
+ reset_confirm_row, homepage_col, workspace_row],
)
# ── 檔案上傳確認(streaming generator)──────────────────────────────
def on_upload_confirm(files, chat_history, log_history, state):
if not files or state is None:
- yield chat_history, log_history, state, gr.update(visible=True), gr.update()
+ yield chat_history, log_history, state, gr.update(visible=True), gr.update(), gr.update()
return
- # 文本上傳(step 1):開始處理即關閉上傳彈窗,避免遮罩擋住操作
- state["current_step"] = 1
+ # 文本上傳(step 2:3-A 新增「研究選擇」為第 1 步後,這裡的步驟
+ # 編號全部 +1):開始處理即關閉上傳彈窗,避免遮罩擋住操作。
+ # 3-C:同時把「檔案接收」子階段標成 running,寫進 upload_progress_html
+ # ——業主回報「上傳過程都一片白,只在對話視窗出現文字氣泡,用戶會
+ # 不知道發生什麼事」,這裡讓內容區塊跟技術執行紀錄同步顯示進度。
+ state["current_step"] = 2
+ state["upload"]["receive"]["status"] = "running"
+ state["upload"]["receive"]["line"] = "接收上傳檔案中……"
+ state["upload"]["validate"]["status"] = "pending"
+ state["upload"]["validate"]["line"] = ""
log_history = _log_append(log_history, "⏳ 接收上傳檔案中……")
- yield chat_history, log_history, state, gr.update(visible=False), _todo_update(state)
+ yield (chat_history, log_history, state, gr.update(visible=False),
+ _todo_update(state), _upload_update(state))
recv_msg, state = handle_uploaded_files(files, state)
chat_history = chat_history + [_assistant_msg(recv_msg)]
+ state["upload"]["receive"]["status"] = "done"
+ state["upload"]["receive"]["line"] = f"已接收 {len(files)} 個檔案"
log_history = _log_append(log_history, f"✅ 已接收 {len(files)} 個檔案")
- yield chat_history, log_history, state, gr.update(visible=False), _todo_update(state)
+ yield (chat_history, log_history, state, gr.update(visible=False),
+ _todo_update(state), _upload_update(state))
# 格式驗證:2026-07-24 起不再是獨立步驟(見 _STEPS 註解),只是「文本
- # 上傳」這一步內部的一道處理,逐行進技術執行紀錄,不動步驟列。step 1
+ # 上傳」這一步內部的一道處理,逐行進技術執行紀錄,不動步驟列。step 2
# 在格式驗證通過後才標 done——通過前維持「進行中」,失敗時原地留著要求
# 重新上傳,畫面與步驟列不會互相矛盾。
+ state["upload"]["validate"]["status"] = "running"
+ state["upload"]["validate"]["line"] = "格式驗證中……"
log_history = _log_append(log_history, "⏳ 格式驗證中……")
- yield chat_history, log_history, state, gr.update(visible=False), _todo_update(state)
+ yield (chat_history, log_history, state, gr.update(visible=False),
+ _todo_update(state), _upload_update(state))
check_msg, state, has_errors = run_format_check(state)
chat_history = chat_history + [_assistant_msg(check_msg)]
if has_errors:
+ state["upload"]["validate"]["status"] = "failed"
+ state["upload"]["validate"]["line"] = "格式不符,請重新上傳"
log_history = _log_append(log_history, "⚠️ 格式不符,請重新上傳")
- state["current_step"] = 1
- yield chat_history, log_history, state, gr.update(visible=True), _todo_update(state)
+ state["current_step"] = 2
+ yield (chat_history, log_history, state, gr.update(visible=True),
+ _todo_update(state), _upload_update(state))
return
- state["done_steps"] = list(set(state.get("done_steps", []) + [1]))
- state["current_step"] = 2
+ state["upload"]["validate"]["status"] = "done"
+ state["upload"]["validate"]["line"] = "格式驗證通過"
+ state["done_steps"] = list(set(state.get("done_steps", []) + [2]))
+ state["current_step"] = 3
log_history = _log_append(log_history, "✅ 格式驗證通過")
- # 格式通過後:顯示 metadata 說明表單(語料說明=step 2),等使用者填寫
+ # 格式通過後:顯示 metadata 說明表單(語料說明=step 3),等使用者填寫
state["state"] = "METADATA_INPUT"
meta_hint = "請填寫語料 Metadata 說明(原文資訊、群組層與個體層),完成後點「確認並開始分析」。"
chat_history = chat_history + [_assistant_msg(meta_hint)]
log_history = _log_append(log_history, "📑 請填寫語料 Metadata 說明")
- yield chat_history, log_history, state, gr.update(visible=False), _todo_update(state)
+ # 2026-07-31(Batch E 第 5、6 項):業主回報「語料說明」「分析
+ # 運算」兩步驟畫面上還留著「文本上傳」的進度區塊(檔案接收 ✓/
+ # 格式驗證 ✓),流程往下推進後這塊資訊已經沒用。清空的時機點
+ # 選在這裡(格式驗證成功、正要進「語料說明」的這個 yield):
+ # 往前推進的唯一入口只有這條成功路徑,往後 metadata 表單出現時
+ # upload_progress_html 就已經是空字串;格式驗證失敗那條路徑
+ # (上面 has_errors 分支)維持呼叫 _upload_update(state)、繼續
+ # 停在文本上傳步驟,不會被這裡影響——那時使用者正需要看到失敗
+ # 在哪一段。往後「分析運算」步驟本身不會再寫這個元件的值(見
+ # _run_computation 的 yield 沒有 upload_progress_html),空字串
+ # 會一路帶到分析運算步驟,不需要在那裡另外清一次。跟 computing_html
+ # 同一種「空字串=不顯示」語意,直接設空字串,不用改動 state。
+ yield (chat_history, log_history, state, gr.update(visible=False),
+ _todo_update(state), gr.update(value=""))
# ── metadata 表單 helpers ───────────────────────────────────────────
def _build_meta_tables(state):
@@ -5406,33 +6125,56 @@ def create_app():
# 2026-07-23:技術執行紀錄轉正成獨立頁面後,可見性只在情境選定
# (on_scenario_pick)與重置(on_reset_confirm)時切換一次,
# 這裡不用再逐步更新開合狀態/摘要標籤,改回傳 gr.update() 不動。
- # 「語料說明」(step 2) 在這裡收尾:confirm 與 skip 兩條路徑都會走進
- # _run_computation,標記在這一處就好,不用在兩個 handler 各寫一次。
- # 2026-07-24 步驟列收斂到 3 步:語料說明=2、分析運算=3。分析運算是
- # 單一步驟,底下三個子階段的細狀態改由 state["analysis"] 承載(見
- # run_computation_pipeline_streaming),這裡不再逐段搬動 current_step,
- # 只在最後依子階段結果決定第 3 步是 done 還是 failed。
- state["done_steps"] = list(set(state.get("done_steps", []) + [2]))
- state["current_step"] = 3
+ # 「語料說明」(step 3:2026-07-30 新增「研究選擇」為第 1 步後,
+ # 這裡的步驟編號全部 +1) 在這裡收尾:confirm 與 skip 兩條路徑都會
+ # 走進 _run_computation,標記在這一處就好,不用在兩個 handler 各寫
+ # 一次。2026-07-24 步驟列收斂到 3 步時是語料說明=2、分析運算=3;
+ # 分析運算是單一步驟,底下三個子階段的細狀態改由 state["analysis"]
+ # 承載(見 run_computation_pipeline_streaming),這裡不再逐段搬動
+ # current_step,只在最後依子階段結果決定第 4 步是 done 還是 failed。
+ state["done_steps"] = list(set(state.get("done_steps", []) + [3]))
+ state["current_step"] = 4
log_history = _log_append(log_history, "⏳ 分析運算開始……")
+ # Bug 4-A 修復(2026-07-30):報告撰寫佔掉幾乎全部等待時間
+ # (30-90 秒以上),原本 _populate_tabs 只掛在整段 generator 跑完
+ # 後的 .then(),指標計算/統計分析早就做完,使用者卻要等報告
+ # 撰寫也結束才看得到——內容區塊的「查看…」連結點了沒反應、左側
+ # 導覽也還是 disabled。改成用 _no_tab_change 當預設(大部分 yield
+ # 不動 _TAB_OUTPUTS),只在下面偵測到某個子階段「剛轉成 done」時
+ # 才呼叫一次 _populate_tabs,把當下已完成的結果併進這次 yield。
+ _no_tab_change = [gr.update()] * _N_TAB
yield (chat_history, log_history, state, _todo_update(state),
- gr.update(), _computing_update(state))
+ gr.update(), _computing_update(state), *_no_tab_change)
+ # 記錄每個子階段「上一次看到的狀態是不是 done」,跟目前狀態比對
+ # 才知道是不是「剛」轉成 done——避免同一階段已經 done 之後,後面
+ # 每個 yield(例如下一階段的 running/done)都重複呼叫一次
+ # _populate_tabs(它會讀 CSV、複製 docx、打包 zip,很浪費)。
+ prev_done = {k: False for k, _, _ in _ANALYSIS_STAGES}
for prog_msg, is_final, state in run_computation_pipeline_streaming(state):
log_history = _log_append(log_history, prog_msg)
if is_final:
chat_history = chat_history + [_assistant_msg(prog_msg)]
- # 三個子階段任一失敗 → 第 3 步標紅(頂部步驟列據實呈現,
+ # 三個子階段任一失敗 → 第 4 步標紅(頂部步驟列據實呈現,
# 內容區塊講清楚壞在哪一段);全部成功才標 ✓。
stages_failed = any(
state["analysis"][k]["status"] == "failed" for k, _, _ in _ANALYSIS_STAGES
)
state["current_step"] = None
if stages_failed:
- state["failed_step"] = 3
+ state["failed_step"] = 4
else:
- state["done_steps"] = list(set(state.get("done_steps", []) + [3]))
+ state["done_steps"] = list(set(state.get("done_steps", []) + [4]))
+
+ newly_done = False
+ for k, _, _ in _ANALYSIS_STAGES:
+ is_done = state["analysis"][k]["status"] == "done"
+ if is_done and not prev_done[k]:
+ newly_done = True
+ prev_done[k] = is_done
+ tab_updates = _populate_tabs(state) if newly_done else _no_tab_change
+
yield (chat_history, log_history, state, _todo_update(state),
- gr.update(), _computing_update(state))
+ gr.update(), _computing_update(state), *tab_updates)
def _show_metadata_form(state):
_NO = gr.update()
@@ -5455,7 +6197,7 @@ def create_app():
).then(
fn=on_upload_confirm,
inputs=[file_input, chatbot, exec_log, session_state],
- outputs=[chatbot, exec_log, session_state, upload_row, app_header_html],
+ outputs=[chatbot, exec_log, session_state, upload_row, app_header_html, upload_progress_html],
).then(
fn=_unlock_upload, inputs=None, outputs=[upload_btn],
).then(
@@ -5464,6 +6206,49 @@ def create_app():
outputs=[metadata_row, meta_group_df, meta_indiv_df, meta_compare_group],
)
+ # 2026-07-31(Batch G 第 1 項):「重新選擇研究情境」返回鈕。叫回
+ # scenario_select_row、收起 upload_row,步驟列退回「① 研究選擇
+ # 進行中」(done_steps 拿掉 1、current_step 設回 1)。session 不重置
+ # (不呼叫 make_initial_state,沿用同一個 session_id),跟「回首頁」
+ # 是兩件不同的事。
+ #
+ # 這裡「不需要」像 on_start_analysis_show/on_reset_clear_workspace
+ # 那樣拆成多個 yield/.then():scenario_select_row、upload_row、
+ # upload_progress_html 都是「已顯示」的 workspace_row 底下的兄弟節點,
+ # 這次改動完全沒有動到 workspace_row 本身的可見性(它從頭到尾都是
+ # visible=True),所以不會踩本檔開頭記錄的 Gradio 6 地雷(該地雷只在
+ # 「祖先容器」從 visible=False 翻回 True 那一刻才會發生)。放同一批
+ # gr.update() 即可,不要照抄「回首頁」那套分批模式。
+ #
+ # 檔案清單清空是正確性問題,不是體驗問題:研究情境決定允許的檔名
+ # 字首(情境 1、2 只收 A_/B_;情境 3、4 才收 C_),使用者若在情境 3
+ # 傳了 C_xx.txt 後改選情境 1,那個檔案會變成不合法卻還留在清單裡。
+ # state["uploaded_files"]/state["cleaned_files"] 與 file_input 的
+ # value 都要清空,upload_progress_html 也要清成空字串(回到「尚未
+ # 上傳」的初始語意,跟 _build_upload_html 對空字串的既有語意一致)。
+ def on_back_to_scenario(state):
+ if state is None:
+ return (gr.update(visible=True), gr.update(visible=False), gr.update(),
+ gr.update(value=None), gr.update(value=""), state)
+ state["uploaded_files"] = []
+ state["cleaned_files"] = []
+ state["current_step"] = 1
+ state["done_steps"] = [s for s in state.get("done_steps", []) if s != 1]
+ return (
+ gr.update(visible=True), # scenario_select_row
+ gr.update(visible=False), # upload_row
+ gr.update(value=_build_header_html(state["done_steps"], current_step=1)), # app_header_html
+ gr.update(value=None), # file_input:清空已選檔案
+ gr.update(value=""), # upload_progress_html:清掉上一輪的上傳進度卡片
+ state,
+ )
+
+ back_to_scenario_btn.click(
+ fn=on_back_to_scenario,
+ inputs=[session_state],
+ outputs=[scenario_select_row, upload_row, app_header_html, file_input, upload_progress_html, session_state],
+ )
+
# 2026-07-24(E2):這裡原本有 on_chat_upload_submit(Phase 7 的
# MultimodalTextbox 轉接生成器),Phase 8 對話框改回純展示後就沒有任何
# 地方呼叫它,屬死碼,已移除。之後若對話框要恢復接上傳,直接在 chat_upload
@@ -5476,8 +6261,14 @@ def create_app():
def on_metadata_confirm(title, author, lang, pubyear, version,
ngroups, method, group_df, indiv_df,
chat_history, log_history, state):
+ # Bug 4-A 修復(2026-07-30):outputs 併入 _TAB_OUTPUTS(見下方
+ # wiring),generator 的每個 yield 元素個數都要跟 outputs 長度
+ # 完全一致——這裡先包一份「_TAB_OUTPUTS 全部不動」的預設值,
+ # 沒有新結果的 yield(early return/running 中)直接複用它。
+ _no_tabs = [gr.update()] * _N_TAB
if state is None:
- yield chat_history, log_history, state, gr.update(), _todo_update(state), gr.update(), gr.update()
+ yield (chat_history, log_history, state, gr.update(), _todo_update(state),
+ gr.update(), gr.update(), *_no_tabs)
return
# 群組數量跟實際上傳分組是否一致:只有情境3/4才會顯示這個選項,
@@ -5496,7 +6287,7 @@ def create_app():
chat_history = chat_history + [_assistant_msg(warn_msg)]
log_history = _log_append(log_history, "⚠️ 群組數量與上傳檔案不一致")
yield (chat_history, log_history, state, gr.update(visible=True),
- _todo_update(state), gr.update(), gr.update())
+ _todo_update(state), gr.update(), gr.update(), *_no_tabs)
return
state["user_metadata"] = _compile_metadata(state, title, author, lang, pubyear,
@@ -5505,10 +6296,12 @@ def create_app():
# 在主對話視窗立即顯示「開始分析」訊息,避免長時間運算期間畫面看起來像沒有反應
chat_history = chat_history + [_assistant_msg(_ANALYSIS_START_MSG)]
yield (chat_history, log_history, state, gr.update(visible=False),
- _todo_update(state), gr.update(), _computing_update(state))
- for ch, lh, st, todo, acc, comp in _run_computation(chat_history, log_history, state):
+ _todo_update(state), gr.update(), _computing_update(state), *_no_tabs)
+ # _run_computation 現在也 yield _TAB_OUTPUTS 那一份(見該函式
+ # 2026-07-30 註解),用 *tabs 原樣轉發,不在這裡重新組裝
+ for ch, lh, st, todo, acc, comp, *tabs in _run_computation(chat_history, log_history, state):
chat_history, log_history, state = ch, lh, st
- yield chat_history, log_history, state, gr.update(visible=False), todo, acc, comp
+ yield (chat_history, log_history, state, gr.update(visible=False), todo, acc, comp, *tabs)
def _lock_meta():
return gr.update(interactive=False), gr.update(interactive=False)
@@ -5523,24 +6316,32 @@ def create_app():
inputs=[meta_title, meta_author, meta_lang, meta_pubyear, meta_version,
meta_ngroups, meta_method, meta_group_df, meta_indiv_df,
chatbot, exec_log, session_state],
+ # Bug 4-A 修復(2026-07-30):併入 _TAB_OUTPUTS,讓 on_metadata_confirm
+ # 能在 streaming 過程中(不用等這條 .then() 鏈跑到最後)就把已完成
+ # 子階段的結果 populate 進畫面。結尾這顆 _populate_tabs 仍保留,
+ # 收尾時做一次完整填充(例如 zip 打包這種只需最後做一次的事)。
outputs=[chatbot, exec_log, session_state, metadata_row, app_header_html,
- canvas_exec_col, computing_html],
+ canvas_exec_col, computing_html, *_TAB_OUTPUTS],
).then(
fn=_unlock_meta, inputs=None, outputs=[meta_confirm_btn, meta_cancel_btn],
).then(fn=_populate_tabs, inputs=[session_state], outputs=_TAB_OUTPUTS)
def on_metadata_skip(chat_history, log_history, state):
+ # 同 on_metadata_confirm,outputs 併入 _TAB_OUTPUTS 後每個 yield
+ # 都要補滿這份長度,見該處 2026-07-30 註解。
+ _no_tabs = [gr.update()] * _N_TAB
if state is None:
- yield chat_history, log_history, state, gr.update(), _todo_update(state), gr.update(), gr.update()
+ yield (chat_history, log_history, state, gr.update(), _todo_update(state),
+ gr.update(), gr.update(), *_no_tabs)
return
state["user_metadata"] = state.get("user_metadata", "") or "(使用者未提供語料 Metadata 說明)"
log_history = _log_append(log_history, "⏭️ 已略過 Metadata,直接開始分析")
chat_history = chat_history + [_assistant_msg(_ANALYSIS_START_MSG)]
yield (chat_history, log_history, state, gr.update(visible=False),
- _todo_update(state), gr.update(), _computing_update(state))
- for ch, lh, st, todo, acc, comp in _run_computation(chat_history, log_history, state):
+ _todo_update(state), gr.update(), _computing_update(state), *_no_tabs)
+ for ch, lh, st, todo, acc, comp, *tabs in _run_computation(chat_history, log_history, state):
chat_history, log_history, state = ch, lh, st
- yield chat_history, log_history, state, gr.update(visible=False), todo, acc, comp
+ yield (chat_history, log_history, state, gr.update(visible=False), todo, acc, comp, *tabs)
meta_cancel_btn.click(
fn=_lock_meta, inputs=None, outputs=[meta_confirm_btn, meta_cancel_btn],
@@ -5548,7 +6349,7 @@ def create_app():
fn=on_metadata_skip,
inputs=[chatbot, exec_log, session_state],
outputs=[chatbot, exec_log, session_state, metadata_row, app_header_html,
- canvas_exec_col, computing_html],
+ canvas_exec_col, computing_html, *_TAB_OUTPUTS],
).then(
fn=_unlock_meta, inputs=None, outputs=[meta_confirm_btn, meta_cancel_btn],
).then(fn=_populate_tabs, inputs=[session_state], outputs=_TAB_OUTPUTS)