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

移除情境標籤敘述,修正步驟列的顯示條件

Browse files

情境標籤(「情境:X ○○○○ [變更]」)在文件中被寫成已實作,實際上不
存在:app_header_html(app_agent.py:2918)只輸出 _build_header_html()
的步驟列,全檔沒有任何情境資訊的畫面輸出,CSS 也沒有對應樣式。程式碼
註解裡出現的「頂部步驟列+情境標籤」是 Phase 8-B 當時的歷史敘述,該
標籤後來沒有留下。

改為記錄為「已取消的規劃」並說明原因:情境選擇 2026-07-30 搬回工作區
成為步驟列第 1 步後,步驟列本身即可辨識情境進度,變更也已由「開始新
分析」涵蓋,標籤失去存在必要。左側導覽與右欄兩張版面圖一併移除該列,
小節標題由「選擇與標示」改為「選擇與變更」。

順帶修正步驟列的生命週期敘述:原寫「全部完成後隱藏」,實際上是只在
「AI 對話」頁顯示,切到任何結果頁都不顯示(見 app_agent.py:2913 起的
2-A 註解與 elem_id=app_header_wrap 的 CSS 規則)。

docs/UIUX優化成果與技術說明.md CHANGED
@@ -217,7 +217,7 @@ 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 步(詳見下方「研究情境的選擇與標示」)
221
  - 「讀取進度」目前是首頁下方標示「功能開發中」的佔位連結(`_build_homepage_footer_html()`,app_agent.py:2548),尚未實作(見 5.2)
222
 
223
  #### 導覽層級:頂部步驟列 vs 左側結果導覽
@@ -228,13 +228,13 @@ commit `d928c91`
228
  |---|---|---|
229
  | 性質 | 時間軸型:進度到第幾步 | 空間型:跳著看已完成結果 |
230
  | 內容 | ①研究選擇 ②文本上傳 ③語料說明 ④分析運算(共 4 步,見 `_STEPS` app_agent.py:1437)。「分析運算」底下再分指標計算/統計分析/報告撰寫三個子階段,以內容區塊分段呈現,不佔步驟列位置(見 `_ANALYSIS_STAGES` app_agent.py:1445)| AI 對話/語言指標分析/敘述統計/差異性分析/監督式學習/非監督式學習/LLM 輔助分析/技術執行紀錄 |
231
- | 生命週期 | 全部完成(第 4 步)後**隱藏**,讓畫面空間交給結果內容 | 分析開始前不出現;完成後接手成為主要瀏覽方式,與步驟列隱藏的時機交接一致。各項目在對應結果產出前為 disabled 狀態,避免點進空白頁 |
232
 
233
  **步驟列沿革(原始規劃 8 步 → 最終 4 步)**:2026-07-24 運算階段重構,格式驗證退為「文本上傳」的內部處理,指標計算+統計分析+報告撰寫合併為「分析運算」單一步驟,收斂為 3 步;2026-07-30 情境選擇搬回工作區,補回為第 1 步「研究選擇」,成為現行的 4 步。
234
 
235
  **左側結果導覽沿革**:①「統計比較分析」父項與 Accordion 展開機制已於 2026-07-24 拿掉,四個統計子頁直接平鋪 ②「技術執行紀錄」已於 2026-07-23 從對話區底部的手風琴轉正為獨立頁面(`nav_exec_btn`,app_agent.py:2838)
236
 
237
- #### 研究情境的選擇與標示
238
 
239
  **選擇:工作區第 1 步**
240
 
@@ -249,12 +249,15 @@ commit `d928c91`
249
  | 3. 不同譯者的同期譯本 | 比較同一時期不同譯者的譯本,聚焦個人風格差異(已排除時代因素)。 |
250
  | 4. 同一原文的不同時期人工譯本 | 比較同一原文在不同時期的譯本,聚焦歷時語言變化與翻譯規範演變。 |
251
 
252
- **標示:常駐情境標籤**
253
 
254
- - 進入工作區後常駐顯示「目前情境」小標籤,**獨立於步驟列存在**(步驟列隱藏後仍要留著)
255
- - 格式:「情境:3. 不同譯者的同期譯本 [變更]」
256
- - 位置:工作區右欄頂部,與步驟列同一區塊(app_agent.py:2902 起)。原規劃寫「全頁最上方」,後因首頁也會看到而改為只在工作區顯示
257
- - 「變更」連結沿用「開始新分析」的重置機制(換情境=重新開始,見 2.1 ①,app_agent.py:3763)
 
 
 
258
 
259
  ### 4.2 版面配置
260
 
@@ -266,8 +269,7 @@ commit `d928c91`
266
  ┌─────────────────────┐
267
  │ 🆕 開始新分析 │
268
  ├─────────────────────┤
269
- │ 情境:X. ○○○○ [變更] │ ← 分析開始後才出現
270
- │ 💬 AI對話 │
271
  │ 📈 語言指標分析 │
272
  │ 📊 敘述統計 │ ← 八個項目全部同一層級,
273
  │ ⚖️ 差異性分析 │ 沒有父項、沒有縮排、
@@ -305,8 +307,7 @@ commit `d928c91`
305
 
306
  ```
307
  ┌──────────────────────────────────────────┐
308
- │ 情境:3. 不同譯者的同期譯本 [變更] │ ← 常駐情境標籤
309
- │ ① 研究選擇 ② 文本上傳 ③ 語料說明 ④ 分析運算 │ ← 頂部步驟列(4步,完成後淡出)
310
  ├──────────────────────────────────────────┤
311
  │ 對話串(AI訊息左側/使用者訊息右側) │
312
  │ [Metadata 步驟 → 內容區插入獨立表單卡片, │
 
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 左側結果導覽
 
228
  |---|---|---|
229
  | 性質 | 時間軸型:進度到第幾步 | 空間型:跳著看已完成結果 |
230
  | 內容 | ①研究選擇 ②文本上傳 ③語料說明 ④分析運算(共 4 步,見 `_STEPS` app_agent.py:1437)。「分析運算」底下再分指標計算/統計分析/報告撰寫三個子階段,以內容區塊分段呈現,不佔步驟列位置(見 `_ANALYSIS_STAGES` app_agent.py:1445)| AI 對話/語言指標分析/敘述統計/差異性分析/監督式學習/非監督式學習/LLM 輔助分析/技術執行紀錄 |
231
+ | 生命週期 | **只在「AI 對話」頁顯示**,切到任何結果頁(語言指標分析/敘述統計/⋯/技術執行紀錄)都不顯示,把畫面空間交給結果內容(以 `elem_id="app_header_wrap"` 供 CSS 鎖定,app_agent.py:2918)| 分析開始前不出現;分析開始後接手成為主要瀏覽方式。各項目在對應結果產出前為 disabled 狀態,避免點進空白頁 |
232
 
233
  **步驟列沿革(原始規劃 8 步 → 最終 4 步)**:2026-07-24 運算階段重構,格式驗證退為「文本上傳」的內部處理,指標計算+統計分析+報告撰寫合併為「分析運算」單一步驟,收斂為 3 步;2026-07-30 情境選擇搬回工作區,補回為第 1 步「研究選擇」,成為現行的 4 步。
234
 
235
  **左側結果導覽沿革**:①「統計比較分析」父項與 Accordion 展開機制已於 2026-07-24 拿掉,四個統計子頁直接平鋪 ②「技術執行紀錄」已於 2026-07-23 從對話區底部的手風琴轉正為獨立頁面(`nav_exec_btn`,app_agent.py:2838)
236
 
237
+ #### 研究情境的選擇與變更
238
 
239
  **選擇:工作區第 1 步**
240
 
 
249
  | 3. 不同譯者的同期譯本 | 比較同一時期不同譯者的譯本,聚焦個人風格差異(已排除時代因素)。 |
250
  | 4. 同一原文的不同時期人工譯本 | 比較同一原文在不同時期的譯本,聚焦歷時語言變化與翻譯規範演變。 |
251
 
252
+ **變更情境**
253
 
254
+ 使用者選錯情境時,透過左側導覽列的「開始新分析」重置(換情境=重新開始,共用同一套重置機制,見 2.1 ①,app_agent.py:3763)。
255
+
256
+ **已取消的規劃:常駐情境標籤**
257
+
258
+ 原規劃在工作區常駐一個「情境:3. 不同譯者的同期譯本 [變更]」小標籤,獨立於步驟列存在,讓步驟列隱藏後仍能辨識目前情境。**最終未實作**:情境選擇 2026-07-30 搬回工作區成為步驟列第 1 步後,步驟列本身即可辨識情境進度,「變更」也已由「開始新分析」涵蓋,這個標籤不再有存在必要。
259
+
260
+ 目前 `app_header_html`(app_agent.py:2918)只輸出步驟列(`_build_header_html()`),不含任何情境資訊。
261
 
262
  ### 4.2 版面配置
263
 
 
269
  ┌─────────────────────┐
270
  │ 🆕 開始新分析 │
271
  ├─────────────────────┤
272
+ │ 💬 AI對話 │ ← 以下八項分析開始後才出現
 
273
  │ 📈 語言指標分析 │
274
  │ 📊 敘述統計 │ ← 八個項目全部同一層級,
275
  │ ⚖️ 差異性分析 │ 沒有父項、沒有縮排、
 
307
 
308
  ```
309
  ┌──────────────────────────────────────────┐
310
+ │ ① 研究選擇 ② 文本上傳 ③ 語料說明 ④ 分析運算 │ ← 頂部步驟列(4步)
 
311
  ├──────────────────────────────────────────┤
312
  │ 對話串(AI訊息左側/使用者訊息右側) │
313
  │ [Metadata 步驟 → 內容區插入獨立表單卡片, │