un2266 commited on
Commit
4d9fe25
·
1 Parent(s): 15fd1d3

四、設計規範三處修正為實際畫面

Browse files

情境卡片說明文字原本寫在「首頁」段落裡,但情境選擇 2026-07-30 已搬
回工作區,內容與段落標題不符。原「情境標籤」小節改名為「研究情境的
選擇與標示」,把卡片說明併入,首頁段落只留一句指向。

左側導覽列版面圖修正:原圖把四個統計子頁縮排畫在「語言指標分析」
底下,看起來像父子層級,實際上八個項目全部平級(2026-07-24 移除
「統計比較分析」父項與 Accordion 後即如此)。補上每個項目對應的
SVG 圖示檔名與元件 id 對照表。

對話輸入框補註實際狀態:元件已實作(chat_upload,app_agent.py:2891)
但外層 chat_upload_col 為 visible=False(app_agent.py:2890),依業主
要求先隱藏不開放。一併記錄目前的參數狀態(sources=[]、submit_btn=
False、interactive=True 但無任何地方解析輸入文字)與日後啟用方式。

docs/UIUX優化成果與技術說明.md CHANGED
@@ -217,18 +217,9 @@ commit `d928c91`
217
 
218
  - 單欄置中:品牌名稱+大標題+簡短說明(`_build_homepage_hero_html()`,app_agent.py:2520)
219
  - **首頁只有一顆「開始研究分析」主按鈕**(`start_analysis_btn`,app_agent.py:2599),點擊後進入工作區
220
- - **情境選擇不在首頁**:原規劃是首頁直接展示 4 張情境卡片,2026-07-30 業主要求把情境選擇搬回工作區,成為步驟列的正式第 1 步「研究選擇」。情境卡片改在工作區的 `scenario_select_row` 呈現(渲染邏輯見 `_build_scenario_cards_html()`,app_agent.py:2498)
221
  - 「讀取進度」目前是首頁下方標示「功能開發中」的佔位連結(`_build_homepage_footer_html()`,app_agent.py:2548),尚未實作(見 5.2)
222
 
223
- 情境卡片說明文字(沿用 `SCENARIOS` 字典的 `desc` 欄位改寫):
224
-
225
- | 情境 | 卡片說明文字 |
226
- |---|---|
227
- | 1. 人工翻譯 vs 機器翻譯 | 比較人工與機器譯本在語言特徵上的差異,聚焦人機翻譯風格對比。 |
228
- | 2. 全譯 vs 編譯(節譯、改寫) | 比較完整翻譯與節譯/改寫版本,聚焦文本完整性與改寫策略。 |
229
- | 3. 不同譯者的同期譯本 | 比較同一時期不同譯者的譯本,聚焦個人風格差異(已排除時代因素)。 |
230
- | 4. 同一原文的不同時期人工譯本 | 比較同一原文在不同時期的譯本,聚焦歷時語言變化與翻譯規範演變。 |
231
-
232
  #### 導覽層級:頂部步驟列 vs 左側結果導覽
233
 
234
  兩者互補、不衝突,視覺上做出層級差異避免使用者誤認重複:
@@ -243,7 +234,22 @@ commit `d928c91`
243
 
244
  **左側結果導覽沿革**:①「統計比較分析」父項與 Accordion 展開機制已於 2026-07-24 拿掉,四個統計子頁直接平鋪 ②「技術執行紀錄」已於 2026-07-23 從對話區底部的手風琴轉正為獨立頁面(`nav_exec_btn`,app_agent.py:2838)
245
 
246
- #### 情境標籤
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
247
 
248
  - 進入工作區後常駐顯示「目前情境」小標籤,**獨立於步驟列存在**(步驟列隱藏後仍要留著)
249
  - 格式:「情境:3. 不同譯者的同期譯本 [變更]」
@@ -261,13 +267,13 @@ commit `d928c91`
261
  │ 🆕 開始新分析 │
262
  ├─────────────────────┤
263
  │ 情境:X. ○○○○ [變更] │ ← 分析開始後才出現
264
- │ 💬 AI 對話 │
265
- │ 📊 語言指標分析 │
266
- │ 敘述統計 │ ← 四個統計子頁平鋪,
267
- │ 差異性分析 │ 無父項、無 Accordion
268
- │ 監督式學習 │
269
- │ 非監督式學習 │
270
- │ 📝 LLM輔助分析 │
271
  │ 📁 技術執行紀錄 │ ← 從對話區底部手風琴轉正
272
  ├─────────────────────┤
273
  │ ⬇️ 下載指標數據 │ ← 指標計算一跑完即可下載
@@ -277,6 +283,19 @@ commit `d928c91`
277
  └─────────────────────┘
278
  ```
279
 
 
 
 
 
 
 
 
 
 
 
 
 
 
280
  - 固定窄寬 240–280px
281
  - **桌面版可收合**成 ChatGPT 式細窄 icon bar(`nav_collapse_toggle`,收合狀態存 localStorage)
282
  - **手機版**:漢堡選單/抽屜收合(`mobile_nav_toggle`/`nav_drawer_close`/`nav_backdrop`),預設只顯示對話主畫面,點擊展開側欄
@@ -294,11 +313,24 @@ commit `d928c91`
294
  │ 不套用聊天泡泡左右分欄邏輯,佔滿全欄寬, │
295
  │ 同頁面往下捲動、非彈出視窗] │
296
  ├──────────────────────────────────────────┤
297
- │ 📎 [ 輸入文字,或附加檔案… ] 送出 → │ ← gr.MultimodalTextbox
298
  └──────────────────────────────────────────┘
299
  ```
300
 
301
- 對話與上傳採 `gr.MultimodalTextbox`(app_agent.py:2891)合併。原本的 UI 是對話框在上、上傳欄在下要往下滾動,使用者常找不到。
 
 
 
 
 
 
 
 
 
 
 
 
 
302
 
303
  #### 結果分頁排版
304
 
 
217
 
218
  - 單欄置中:品牌名稱+大標題+簡短說明(`_build_homepage_hero_html()`,app_agent.py:2520)
219
  - **首頁只有一顆「開始研究分析」主按鈕**(`start_analysis_btn`,app_agent.py:2599),點擊後進入工作區
220
+ - **情境選擇不在首頁**:原規劃是首頁直接展示 4 張情境卡片,2026-07-30 業主要求搬回工作區成為步驟列第 1 步(詳見下方「研究情境的選擇與標示」)
221
  - 「讀取進度」目前是首頁下方標示「功能開發中」的佔位連結(`_build_homepage_footer_html()`,app_agent.py:2548),尚未實作(見 5.2)
222
 
 
 
 
 
 
 
 
 
 
223
  #### 導覽層級:頂部步驟列 vs 左側結果導覽
224
 
225
  兩者互補、不衝突,視覺上做出層級差異避免使用者誤認重複:
 
234
 
235
  **左側結果導覽沿革**:①「統計比較分析」父項與 Accordion 展開機制已於 2026-07-24 拿掉,四個統計子頁直接平鋪 ②「技術執行紀錄」已於 2026-07-23 從對話區底部的手風琴轉正為獨立頁面(`nav_exec_btn`,app_agent.py:2838)
236
 
237
+ #### 研究情境的選擇與標示
238
+
239
+ **選擇:工作區第 1 步**
240
+
241
+ 原規劃是首頁直接展示 4 張情境卡片,選了任一張即開始。2026-07-30 業主要求把情境選擇搬回工作區,成為步驟列的正式第 1 步「研究選擇」。情境卡片改在工作區的 `scenario_select_row` 呈現(渲染邏輯見 `_build_scenario_cards_html()`,app_agent.py:2498)。
242
+
243
+ 卡片說明文字沿用 `SCENARIOS` 字典的 `desc` 欄位改寫。原本在對話中選情境時旁邊只有短標籤,改為卡片後沒有 AI 陪同引導,需要更清楚的說明避免選錯:
244
+
245
+ | 情境 | 卡片說明文字 |
246
+ |---|---|
247
+ | 1. 人工翻譯 vs 機器翻譯 | 比較人工與機器譯本在語言特徵上的差異,聚焦人機翻譯風格對比。 |
248
+ | 2. 全譯 vs 編譯(節譯、改寫) | 比較完整翻譯與節譯/改寫版本,聚焦文本完整性與改寫策略。 |
249
+ | 3. 不同譯者的同期譯本 | 比較同一時期不同譯者的譯本,聚焦個人風格差異(已排除時代因素)。 |
250
+ | 4. 同一原文的不同時期人工譯本 | 比較同一原文在不同時期的譯本,聚焦歷時語言變化與翻譯規範演變。 |
251
+
252
+ **標示:常駐情境標籤**
253
 
254
  - 進入工作區後常駐顯示「目前情境」小標籤,**獨立於步驟列存在**(步驟列隱藏後仍要留著)
255
  - 格式:「情境:3. 不同譯者的同期譯本 [變更]」
 
267
  │ 🆕 開始新分析 │
268
  ├─────────────────────┤
269
  │ 情境:X. ○○○○ [變更] │ ← 分析開始後才出現
270
+ │ 💬 AI對話 │
271
+ │ 📈 語言指標分析 │
272
+ │ 📊 敘述統計 │ ← 八個項目全部同一層級,
273
+ │ ⚖️ 差異性分析 │ 沒有父項、沒有縮排、
274
+ │ 🎓 監督式學習 │ 沒有 Accordion 展開
275
+ │ ▦ 非監督式學習 │
276
+ │ 📄 LLM輔助分析 │
277
  │ 📁 技術執行紀錄 │ ← 從對話區底部手風琴轉正
278
  ├─────────────────────┤
279
  │ ⬇️ 下載指標數據 │ ← 指標計算一跑完即可下載
 
283
  └─────────────────────┘
284
  ```
285
 
286
+ **八個導覽項目一律平級,各自配一個圖示**(`assets/icons/` 下的 SVG,非 emoji;上圖以 emoji 示意)。原規劃是「統計比較分析」作為父項、底下四個子頁用 Accordion 展開,2026-07-24 移除該層級,四個��計子頁提升到與其他項目相同層級:
287
+
288
+ | 項目 | 圖示檔 | 元件 |
289
+ |---|---|---|
290
+ | AI對話 | `chat-bubble.svg` | `nav_top_btn` |
291
+ | 語言指標分析 | `trending-up.svg` | `nav_idx_btn` |
292
+ | 敘述統計 | `table-cells.svg` | `nav_stat_sub_0` |
293
+ | 差異性分析 | `scale.svg` | `nav_stat_sub_1` |
294
+ | 監督式學習 | `academic-cap.svg` | `nav_stat_sub_2` |
295
+ | 非監督式學習 | `squares-2x2.svg` | `nav_stat_sub_3` |
296
+ | LLM輔助分析 | `document.svg` | `nav_report_btn` |
297
+ | 技術執行紀錄 | `folder.svg` | `nav_exec_btn`(套 `--muted` 樣式弱化)|
298
+
299
  - 固定窄寬 240–280px
300
  - **桌面版可收合**成 ChatGPT 式細窄 icon bar(`nav_collapse_toggle`,收合狀態存 localStorage)
301
  - **手機版**:漢堡選單/抽屜收合(`mobile_nav_toggle`/`nav_drawer_close`/`nav_backdrop`),預設只顯示對話主畫面,點擊展開側欄
 
313
  │ 不套用聊天泡泡左右分欄邏輯,佔滿全欄寬, │
314
  │ 同頁面往下捲動、非彈出視窗] │
315
  ├──────────────────────────────────────────┤
316
+ │ [ 對話輸入框 ] │ ← 已實作,目前隱藏
317
  └──────────────────────────────────────────┘
318
  ```
319
 
320
+ **對話輸入框已實作但目前隱藏,依業主要求先不對使用者開放。**
321
+
322
+ 原規劃是把對話與上傳合併成單一輸入框(`gr.MultimodalTextbox`),解決舊版「對話框在上、上傳欄在下要往下滾動、使用者常找不到」的問題。元件已建置完成(`chat_upload`,app_agent.py:2891),但外層 `chat_upload_col` 設為 `visible=False`(app_agent.py:2890),畫面上看不到。
323
+
324
+ 目前的實作狀態:
325
+
326
+ - `sources=[]`:不掛附加檔案功能,避免顯示迴紋針圖示卻按了沒作用
327
+ - `submit_btn=False`:不顯示送出鈕
328
+ - `interactive=True`:可以打字,但**系統目前沒有任何地方會解析使用者自由輸入的文字**
329
+ - placeholder 文案為「對話輸入框(功能開發中)」
330
+
331
+ 原本的轉接函式 `on_chat_upload_submit` 已於 2026-07-24 當作死碼移除。日後要啟用時,把 `chat_upload_col` 改為 `visible=True` 並重新接上 `.submit()` 事件即可,程式碼中該處留有註解說明。
332
+
333
+ 檔案上傳目前走獨立的上傳卡片(`file_input`,app_agent.py:2946),不受此影響。
334
 
335
  #### 結果分頁排版
336