補齊「使用手冊」→「使用說明」更名的實際內容改動

上一個 commit（8eccc5a）只有檔案改名本身進去了，實際的文字內容
改動（app_agent.py 的按鈕標籤/檔案路徑/註解、assets/app.css 註解、
docs/ 底下三份文件、使用說明.md 內文與版本日期、重新產生的
使用說明.docx）因為 git add 指令裡一個路徑打錯導致整批加入失敗，
沒有真的進到上一個 commit，這裡補上。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

app_agent.py

@@ -155,7 +155,7 @@ PROMPT_VERSION = "v1"
 # 2026-08-26（「關於本系統」面板用）：跟 PROMPT_VERSION 是兩件不同的事——
 # PROMPT_VERSION 只追蹤 LLM 提示詞內容，這個追蹤的是整個系統（畫面、流程、
 # 各項修正）的版本，給使用者回報問題時對照用。用日期字串（而非 v1.0 這種
-# 語意化版號）是刻意的：日期比較不會忘記更新，且跟 使用手冊.md 文末的
+# 語意化版號）是刻意的：日期比較不會忘記更新，且跟 使用說明.md 文末的
 # 「文件版本」日期同一套慣例。有實質功能異動時手動更新這個日期即可。
 APP_VERSION = "2026-08-26"
 
@@ -179,7 +179,7 @@ ABOUT_CONTENT_MD = f"""## 關於本系統
 文本須先經由「[語料淬鍊（CorpusRefinery）](https://github.com/minchun-git/I_CorpusRefinery)」完成斷詞後才能上傳本系統分析。
 
 ### 開發紀錄
-系統功能與版本異動，請參見導覽列「使用手冊」文末的文件版本紀錄。
+系統功能與版本異動，請參見導覽列「使用說明」文末的文件版本紀錄。
 
 ### 版權聲明
 © 2026｜作者姓名／單位將於論文發表後公開
@@ -2558,7 +2558,7 @@ _ICON_PATHS = {
     # 同一套 Heroicons 風格手繪，path 需與 assets/icons/chat-bubble.svg
     # 內容保持一致，這裡是給 _icon() 行內用法的對應版本，見該函式 docstring）。
     "chat-bubble":  '<path d="M4 5.5h16a1 1 0 0 1 1 1V16a1 1 0 0 1-1 1H9.5L5 21v-4H4a1 1 0 0 1-1-1V6.5a1 1 0 0 1 1-1z"/><line x1="7.5" y1="10" x2="16.5" y2="10"/><line x1="7.5" y1="13.5" x2="13" y2="13.5"/>',
-    # 2026-08-12：導覽列最底的「使用手冊」下載項目（assets/icons/book-open.svg
+    # 2026-08-12：導覽列最底的「使用說明」下載項目（assets/icons/book-open.svg
     # 的行內對應版，path 內容需與該檔一致）。
     # 2026-08-12 二版：初版畫得比其他導覽圖示小一圈（實際上色像素 16×15，
     # 其他多是 18×16——用截圖逐一量非背景像素才看得出來，肉眼只覺得「怪怪的」）。
@@ -3585,9 +3585,9 @@ def create_app():
                             variant="secondary",
                         )
 
-                    # ── 使用手冊（2026-08-12，業主要求）──────────────────
+                    # ── 使用說明（2026-08-12，業主要求）──────────────────
                     # 刻意放在 result_nav_col **外面**、nav_items_scroll 的最後
-                    # 一項：手冊跟分析進度無關，選研究情境前也該拿得到。選情境
+                    # 一項：說明文件跟分析進度無關，選研究情境前也該拿得到。選情境
                     # 後它自然落在「技術執行紀錄」下方，就是業主要的「最後一個
                     # 項目下方」。
                     # 它是下載動作不是頁面，所以跟 nav_dl_* 四顆一樣，不接
@@ -3600,14 +3600,14 @@ def create_app():
                     # #nav_guide_btn 加進 app.css 那幾組選擇器清單。
                     gr.HTML('<div class="result-nav-divider"></div>')
                     nav_guide_btn = gr.DownloadButton(
-                        "使用手冊", value=str(BASE_DIR / "使用手冊.docx"),
+                        "使用說明", value=str(BASE_DIR / "使用說明.docx"),
                         icon=str(BASE_DIR / "assets" / "icons" / "book-open.svg"),
                         elem_id="nav_guide_btn",
                         elem_classes=["result-nav-btn", "result-nav-btn--muted"],
                         variant="secondary",
                     )
                     # ── 關於（2026-08-26，業主要求）───────────────────────
-                    # 跟使用手冊同一顆待遇：住在 result_nav_col 外面，同一份
+                    # 跟使用說明同一顆待遇：住在 result_nav_col 外面，同一份
                     # elem_classes（沿用 #nav_guide_btn 那組樣式選擇器，見
                     # assets/app.css）。這顆是彈窗不是下載，用一般 gr.Button
                     # 搭配下面的 about_overlay 面板，toggle 顯示/隱藏。

assets/app.css

@@ -1735,11 +1735,11 @@ img.button-icon { opacity: .82; }
 /* 2026-07-24 千卉：導覽列所有項目字級一致（以「AI對話」的 .88rem 為基準）。
    技術執行紀錄原本 .82rem 比其他項目小一階，改回 .88rem；它的「低優先度」
    仍靠顏色（--c-text-muted）與上方分隔線表達，不再靠縮小字級。 */
-/* 2026-08-12：「使用手冊」加在 nav-items-scroll 最後一項之後，發現它被推到
+/* 2026-08-12：「使用說明」加在 nav-items-scroll 最後一項之後，發現它被推到
    整個捲動區的最底部——Gradio 給 gr.Column 的預設是 flex:1 1 auto，
    result_nav_col 因此把剩餘高度全部吃掉（實測長到 729px，內容其實只有
    400 出頭）。業主要的是「最後一個項目下方」，不是「釘在欄位底部」，
-   所以讓它只佔內容高度，使用手冊就會緊跟在技術執行紀錄下面。 */
+   所以讓它只佔內容高度，使用說明就會緊跟在技術執行紀錄下面。 */
 #result_nav_col {
     flex: 0 0 auto !important;
 }

docs/README.md

@@ -11,4 +11,4 @@
 ---
 
 - 專案原始碼與執行方式見專案根目錄的 `README.md`
-- 系統操作方式見專案根目錄的 `使用手冊.md`
+- 系統操作方式見專案根目錄的 `使用說明.md`

docs/UIUX優化成果與技術說明.md

@@ -1,7 +1,7 @@
 # 譯彩紛呈 II 分析引擎 SpectraEngine UI/UX 優化成果與技術說明
 
 - 文件建立日期：2026-07-20
-- 最後更新日期：2026-08-12（淺色配色體系重整、AI 訊息頭像、使用手冊入口、2 項修復，對應 commit `2d850f9`）
+- 最後更新日期：2026-08-12（淺色配色體系重整、AI 訊息頭像、使用說明入口、2 項修復，對應 commit `2d850f9`）
 - 專案委託方：致理科技大學應日系 鄧敏君老師
 - 專案執行：利他設計工作室 吳千卉
 - 用途：說明本次 UI/UX 優化執行的工作項目，並保留設計規範與技術決策，供後續工程接手參考
@@ -14,7 +14,7 @@
 |---|---|
 | **一、專案說明** | 系統定位、本次施工的技術限制、以及不可誤改的既有架構。動手前該知道的事都在這裡 |
 | **二、修復既有問題** | 修好 **21 個**原本就存在的問題，分三類：6 個會讓使用者卡死、只能重整頁面的；9 個畫面顯示與實際狀態不符的；6 個看得出來不對的視覺與可讀性瑕疵 |
-| **三、功能新增與調整** | 新增四顆打包下載捷徑（原本要跑三個分頁下載 15 個檔案）、補齊兩個統計子頁缺少的下載入口、加上離開頁面前的防手滑確認、移除畫面底部的多餘連結列、導覽列新增使用手冊下載入口、AI 訊息加上頭像 |
+| **三、功能新增與調整** | 新增四顆打包下載捷徑（原本要跑三個分頁下載 15 個檔案）、補齊兩個統計子頁缺少的下載入口、加上離開頁面前的防手滑確認、移除畫面底部的多餘連結列、導覽列新增使用說明下載入口、AI 訊息加上頭像 |
 | **四、設計規範** | 這次改版怎麼決定畫面長相：資訊架構、三欄式版面、語料說明表單、視覺規範（字級、字體、配色與 WCAG 稽核）、各種空白與錯誤狀態，以及本次另外交付的 `design.md` 設計系統文件 |
 | **五、未完成項目** | **8 項**經評估超出本次委託範圍、或需要業主決定的項目。每項在此僅簡述，完整技術評估見《開發優化建議》 |
 | **六、更新紀錄** | 本文件歷次修改摘要，時間正序 |
@@ -266,13 +266,13 @@ commit `8ac93d8`
 
 commit `d928c91`
 
-### 3.5 導覽列新增「使用手冊」下載入口
+### 3.5 導覽列新增「使用說明」下載入口
 
-左側導覽列最末新增「使用手冊」項目（`nav_guide_btn`，`book-open.svg`），供使用者隨時下載系統操作手冊。
+左側導覽列最末新增「使用說明」項目（`nav_guide_btn`，`book-open.svg`），供使用者隨時下載系統使用說明。
 
 - **位置刻意放在結果導覽區塊之外**：手冊與分析進度無關，選定研究情境之前也應該拿得到。選定情境後它自然落在「技術執行紀錄」下方，以分隔線與上方的結果導覽區隔
 - **不參與導覽的作用中狀態**：它是下載動作而非頁面，與四顆下載捷徑同樣不納入 `_ALL_NAV_IDS`，點擊後不會把作用中狀態從當前結果頁移走
-- **目前接的是專案根目錄既有的 `使用手冊.docx`**（業主原始版本，內容尚未反映本次改版後的介面）。日後更新手冊只需覆蓋同一個檔名，不必改動程式
+- **目前接的是專案根目錄既有的 `使用說明.docx`**（業主原始版本，內容尚未反映本次改版後的介面）。日後更新文件只需覆蓋同一個檔名，不必改動程式
 
 commit `32e7f6c`
 
@@ -360,7 +360,7 @@ commit `32e7f6c`、`2d850f9`
 │ ⬇️ 下載研究報告         │
 │ ⬇️ 下載完整分析資料      │  ← 內容為空的那包不會出現
 ├─────────────────────┤
-│ 📖 使用手冊            │  ← 全程可見，與分析進度無關
+│ 📖 使用說明            │  ← 全程可見，與分析進度無關
 └─────────────────────┘
 ```
 
@@ -382,7 +382,7 @@ commit `32e7f6c`、`2d850f9`
 | 項目 | 圖示檔 | 元件 | 顯示時機 |
 |---|---|---|---|
 | 回首頁 | `home.svg` | `reset_btn` | 進入工作區後全程可見（重置機制見 2.1 ①）|
-| 使用手冊 | `book-open.svg` | `nav_guide_btn` | 進入工作區後全程可見，位於導覽列最末（見 3.5）|
+| 使用說明 | `book-open.svg` | `nav_guide_btn` | 進入工作區後全程可見，位於導覽列最末（見 3.5）|
 
 - 固定窄寬 240–280px
 - **桌面版可收合**成 ChatGPT 式細窄 icon bar（`nav_collapse_toggle`，收合狀態存 localStorage）
@@ -661,4 +661,4 @@ WCAG 1.4.11 要求 UI 元件邊界達 3:1，而原本全站共用的 `--c-border
 | 2026-08-06 | 修正兩處導覽改名後未同步的文案並列入第二章，修復項目由 13 項增為 15 項：空狀態提示指向不存在的「主頁」（改為「AI對話」）、結果頁下載鈕命名不一致（統一為「下載＋該頁名稱」）|
 | 2026-08-06 | 《開發優化建議》原第七節底下的兩個子項提升為第七、第八節，使兩���文件的未完成項目由「8 項對 6 節＋2 子項」變為「8 項對 8 節」，對照時不再需要換算層級；本文件 5.7／5.8 的指向同步更新 |
 | 2026-08-06 | 修復項目由 15 項增為 19 項（2.2 由 4 項增為 8 項）：「開始研究分析」後左側導覽列消失、硬點技術執行紀錄內容區塊空白、技術執行紀錄缺大標題、下載研究報告／完整分析資料在報告撰寫完成前提早出現缺件。前三項根因相同：Gradio 6 元件第一次從隱藏翻顯示時，只有在觸發它的 generator 第一個 yield 設定才會真的掛進 DOM，原寫法套錯了另一段既有修法（4-C 補償）延到第二個 yield 才設，改回第一個 yield。3.1 打包下載機制規則同步更新。commit `56a8c3b` |
-| 2026-08-12 | 依業主回饋進行本輪視覺調整並同步全文：①4.4 配色章改寫——原「不更換配色」與背景色表已不符實作，改為「沿用色相、重新定義底色三層與線條兩級」，並載明結構線低於 1.4.11 門檻是業主拍板的取捨 ②新增 3.5 使用手冊入口、3.6 AI 訊息頭像 ③4.3 補語料說明表單去卡片、比較結構改小標題、radio 標籤對齊與選項被裁切的修正 ④結果分頁排版：語言指標分析的下載鈕由表格之前改到表格之後，六頁一致 ⑤導覽列版面圖與圖示對照表補「回首頁」（2026-07-30 已由「開始新分析」更名）與「使用手冊」⑥修復項目由 19 項增為 21 項：分析運算中途重置後畫面殘留（2.2 ⑨）、表格右側空白帶（2.3 ⑥）⑦`app_agent.py` 行數更新為 4371。commit `32e7f6c`～`2d850f9` |
+| 2026-08-12 | 依業主回饋進行本輪視覺調整並同步全文：①4.4 配色章改寫——原「不更換配色」與背景色表已不符實作，改為「沿用色相、重新定義底色三層與線條兩級」，並載明結構線低於 1.4.11 門檻是業主拍板的取捨 ②新增 3.5 使用說明入口、3.6 AI 訊息頭像 ③4.3 補語料說明表單去卡片、比較結構改小標題、radio 標籤對齊與選項被裁切的修正 ④結果分頁排版：語言指標分析的下載鈕由表格之前改到表格之後，六頁一致 ⑤導覽列版面圖與圖示對照表補「回首頁」（2026-07-30 已由「開始新分析」更名）與「使用說明」⑥修復項目由 19 項增為 21 項：分析運算中途重置後畫面殘留（2.2 ⑨）、表格右側空白帶（2.3 ⑥）⑦`app_agent.py` 行數更新為 4371。commit `32e7f6c`～`2d850f9` |

docs/design.md

@@ -221,7 +221,7 @@ WCAG 1.4.11 對「UI 元件與圖形物件的邊界」要求 3:1，這條在淺
 - **表單欄位不包卡片**（2026-08-12）：語料說明表單的欄位一律「小標題＋內容直接攤開」，不要 Gradio 自動包的白色 `.form` 卡片。Gradio 這層卡片是兩件事疊起來的——`.form` 出框線、內層 `.block`／`fieldset` 出白底與內距——兩層都要清掉才會消失。內距清掉之後欄位左緣自然對齊小標題與下方表格。另外 `.form` 的 `align-items` 要改 `flex-start`：預設的 `stretch` 會把每個欄位的高度鎖成整列高度，而那個列高不含欄位標籤，radio 這種「標籤在上、選項在下」的元件會被裁掉一截
 - **欄位標籤只有一種樣式**（2026-08-12）：`.7rem`／`700`／`--c-text-muted`。這是 Gradio 給文字欄位標籤的既有值，不是另訂的字級，所以不套 `--font-size-base`（標籤比內文小一階是這張表單本來的層級設計）。radio 的 `fieldset` 標籤走 Gradio 另一條規則、預設是一般大小的深色字，要另外對齊，否則同一張表單裡兩種欄位的標籤長得不一樣
 - **表格不自己出捲軸**（2026-08-12）：dataframe 的內部容器一律 `scrollbar-width: none`。Gradio 預設 `max-height: 500px` + `overflow-y: auto`，列多時捲軸會佔掉 10px 版面寬度，表格因此比外框窄一截，右側露出一條空白帶，看起來像最後一欄被切掉（業主回報過）。滾輪／觸控／鍵盤照常可捲。**不要改用移除 `max-height` 的做法**：這個表格是虛擬捲動，靠自身捲動位置決定渲染哪些列，移除後會變成「保留整表高度卻只渲染 1 列」的空表。也**不要用 `::-webkit-scrollbar`**：Gradio 在該元件設了標準屬性 `scrollbar-width`／`scrollbar-color`，Chrome 見到標準屬性就會忽略 legacy 偽元素
-- **導覽列末項**：「使用手冊」固定在左側導覽列最後一項（技術執行紀錄下方，用分隔線隔開），與分析進度無關、全程可見；它是下載動作不是頁面，不參與導覽列的 active 狀態
+- **導覽列末項**：「使用說明」固定在左側導覽列最後一項（技術執行紀錄下方，用分隔線隔開），與分析進度無關、全程可見；它是下載動作不是頁面，不參與導覽列的 active 狀態
 - **基準留白**：導覽列與輸入框四邊留白 16px 為基準，其餘區塊（對話氣泡、Canvas 內容區）對齊同一基準線，避免同一頁面出現兩種留白邏輯
 
 ---

使用說明.docx

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:d7e103888a944595bbd50c2b04b08a81988e1f232a1d780d9cf12de0950456c6
-size 45505
+oid sha256:7dea717e0cd868c5b446117b703e4bbb1cbbc4c192cfd932ddc00e205a297eb4
+size 45900

使用說明.md

@@ -1,8 +1,8 @@
-# 譯彩紛呈：重譯文本分析系統 — 使用手冊
+# 譯彩紛呈：重譯文本分析系統 — 使用說明
 
 **TransPrism: An Analytical Framework for Retranslation II｜分析引擎 SpectraEngine**
 
-> 本手冊說明系統的安裝啟動、操作流程、檔案格式要求、各分頁功能與疑難排解。
+> 本文件說明系統的安裝啟動、操作流程、檔案格式要求、各分頁功能與疑難排解。
 
 ---
 
@@ -38,12 +38,24 @@
 
 ## 2. 系統需求與啟動
 
-### 環境需求
+### 線上使用（Hugging Face Space，推薦）
+
+系統已部署於 Hugging Face Space，開啟瀏覽器前往以下網址即可使用，不需自行安裝任何環境：
+
+**https://minchun-ii-spectraengine.hf.space**
+
+> 🔒 為避免公開網址被無關人士任意使用（分析會呼叫第三方 LLM API，涉及費用與流量），本 Space 設有登入畫面，需輸入帳號密碼才能進入。帳號密碼請洽系統管理者取得，不會公開刊登於本文件。
+
+多數使用情境（實際上傳文本進行分析）建議直接使用線上版本；以下「本機部署」僅適用於需要自行修改程式碼、離線使用，或有其他開發需求的情況。
+
+### 本機部署（開發者／自行架設）
+
+#### 環境需求
 - Python 3.x
 - 套件：`gradio`、`pandas`、`numpy`、`scipy`、`scikit-learn`、`matplotlib`、`python-docx`、`openpyxl`（完整清單見 `requirements_agent.txt`）
 - OpenRouter API 金鑰（供 LLM 呼叫）
 
-### 環境變數設定
+#### 環境變數設定
 LLM 透過 OpenRouter 呼叫，於專案目錄的 `.env` 檔設定以下變數（可複製 `.env.example` 修改）：
 
 ```
@@ -55,7 +67,7 @@ LLM2_API_KEY   你的 OpenRouter 金鑰（工作程序 Agent）
 > 為可重複性設計，已固定寫在程式碼裡，不再支援用環境變數覆寫；要換模型需直接修改
 > `app_agent.py` 的 `LLM1_MODEL`／`LLM2_MODEL` 常數。
 
-### 啟動系統
+#### 啟動系統
 
 於專案目錄執行：
 
@@ -84,7 +96,7 @@ python app_agent.py
 │  非監督式學習               │                                     │
 │  LLM 輔助分析               │                                     │
 │  技術執行紀錄               │                                     │
-│  使用手冊（下載捷徑）         │                                     │
+│  使用說明（下載捷徑）         │                                     │
 └────────────────────────────────────────────────────────────────┘
 ```
 
@@ -93,7 +105,7 @@ python app_agent.py
 - **步驟指示列**：對話視窗上方即時顯示目前所在步驟（情境選擇／文本上傳／語料說明／分析運算），已完成步驟標示 ✓。
 - **技術執行紀錄**：獨立分頁，逐行記錄系統各階段的技術性訊息（格式驗證、指標計算、統計分析、報告撰寫等），供排查問題使用。
 - **結果分頁**：語言指標分析、敘述統計、差異性分析、監督式學習、非監督式學習、LLM 輔助分析，分析完成後自動可瀏覽。
-- **使用手冊**：導覽列最底提供下載捷徑，可直接下載本手冊（`.docx`）。
+- **使用說明**：導覽列最底提供下載捷徑，可直接下載本文件（`.docx`）。
 
 ---
 
@@ -276,4 +288,4 @@ Get-Process python | Stop-Process -Force
 
 ---
 
-*文件版本：2026-08-28｜對應系統：TransPrism II（Spectra Engine）*
+*文件版本：2026-09-01｜對應系統：TransPrism II（Spectra Engine）*