Spaces:
Running
Running
四、設計規範三處修正為實際畫面
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 +52 -20
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 業主要求
|
| 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 |
-
│
|
| 268 |
-
│
|
| 269 |
-
│
|
| 270 |
-
│
|
| 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 |
-
│
|
| 298 |
└──────────────────────────────────────────┘
|
| 299 |
```
|
| 300 |
|
| 301 |
-
對話
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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 |
|