Spaces:
Sleeping
Sleeping
Commit History
-
補齊「使用手冊」→「使用說明」更名的實際內容改動
上一個 commit（8eccc5a）只有檔案改名本身進去了，實際的文字內容 改動（app_agent.py 的按鈕標籤/檔案路徑/註解、assets/app.css 註解、 docs/ 底下三份文件、使用說明.md 內文與版本日期、重新產生的 使用說明.docx）因為 git add 指令裡一個路徑打錯導致整批加入失敗， 沒有真的進到上一個 commit，這裡補上。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>9615d53
-
文件同步：兩份交付文件補上 2026-08-12 本輪改動
《UIUX優化成果與技術說明》停在 8/6，本輪 8 個 commit 全未反映，且 4.4 節 「本次改版不更換配色」與背景色表（#f8fafc／#020617）已與實作不符——那是 交付給業主的文件裡的錯誤敘述，優先修掉。 本次修正： - 4.4 配色章改寫：拆成「強調色（未更動）／底色三層／線條兩級」三段， 補上淺色為何維持白底表格、以及結構線最終 1.46:1 低於 WCAG 1.4.11 的 3:1 門檻是業主連續三輪要求柔和後拍板的取捨（文字對比不受影響） - 新增 3.5 導覽列「使用手冊」下載入口、3.6 AI 訊息頭像 - 4.3 語料說明表單補：欄位不包白色卡片、「比較結構」改小標題（gr.Group→ gr.Column）、radio 欄位標籤對齊文字欄位、選項被裁切的成因與修法 - 4.2 結果分頁排版：語言指標分析的下載鈕由表格之前改到表格之後，六頁一致； 導覽列版面圖與圖示對照表補「回首頁」與「使用手冊」兩項 - 第二章修復項目 19→21：新增 2.2 ⑨（運算中途重置後畫面殘留，含「不是漏清 而是沒中止 generator」的根因）與 2.3 ⑥（表格右側空白帶，含「欄位其實 沒有錯位、13 張表逐欄量測一致」的查證結果與兩條排除掉的修法） - 4.1「開始新分析」更正為現行名稱「回首頁」（2026-07-30 已更名）並註明 第二章部分描述沿用舊名；2.3 ⑤ 的交叉引用編號修正 - app_agent.py 行數 4232→4371；更新紀錄補一列（時間正序，放最後） 《design.md》升 v1.3：AI 頭像改實心與尺寸規格、新增「導覽圖示要量實際 上色範圍」檢查、欄位標籤唯一樣式、表格不自己出捲軸（含兩條不可用的替代 做法）。 《開發優化建議》與 docs/README.md 本輪不需異動（前者結論不受影響，後者 是三份文件對照表、文件未增減）。 驗證：章節數量前後一致（2.1 六項＋2.2 九項＋2.3 六項＝標題與總覽表的 21 項，以腳本逐節數過）；design.md front matter 可被 YAML 解析、色票值 與 assets/app.css 現值相符；兩份文件所有表格欄數一致。 Co-Authored-By: Claude Opus 5 <noreply@anth…659e17c -
淺色再調：線條改用次要按鈕邊框色、底色轉淺、白氣泡、語料表單去卡片
千卉四項指定： 1. 導覽列／對話列／內容列的邊線與水平線「改成跟『重新選擇研究情境』按鈕 的邊框色一樣」→ --c-border-strong 淺色改 rgba(2,132,199,.30)，就是 button.secondary 用的那個值（實測 nav 分隔線與按鈕邊框已完全同色）。 對底 1.46:1。這是連續第三輪往柔和調，明確離開 WCAG 1.4.11 的 3:1， 屬業主拍板的視覺取捨；文字對比不受影響，仍全數通過 AA。 2. 淺色背景再淺一點 → --c-bg #e8f1fa → #f3f8fd。 3. 對話氣泡改白 → --c-bubble-bg 淺色 #ffffff（深色 #172136 不動）。 氣泡與欄底填色差剩 1.07:1，邊界改由 --c-bubble-border 撐（淺 1.69:1、 深 1.61:1，兩邊同一級）。 4. 語料說明表單去卡片： - 原文標題／作者／語言／出版年／版本：移除 Gradio 自動包的白色卡片。 這層卡片是兩件事疊起來的——.form 出框線、內層 .block 出白底與內距—— 兩層都要清才會消失。內距清掉後欄位左緣自然對齊小標題與下方表格， 達成業主要的「參考群組層資訊、水平橫列、靠左對齊」。 - 比較結構：gr.Group 改 gr.Column，Gradio 那條藍色標題橫幅與外框跟著 消失，標題自動變成跟「原文資訊」同款的藍色小標題。順帶符合本專案 既有定論——這版 Gradio 的 gr.Group 設 visible=False 只清空內容、 容器仍是 display:flex 會留空色塊，可切換的容器一律用 gr.Column。 已實測情境 1（不需要比較結構）該區塊 display:none、高度 0，無殘留。 - 群組數量／比較方式：同批去掉白底與內距。 順帶修掉一個既有 bug（業主截圖裡就已存在，不是這批造成）：那兩組 radio 的選項被裁掉一半。真因是 .form 的 align-items:stretch 把每個欄位的高度 鎖成整列高度，而那個列高只算到選項區（61px）、沒算欄位標籤（20+8px）， 多出來的 28px 被 fieldset…b1b0036 -
淡藍底色體系：降低純白／純黑面積，深淺共用三層結構
千卉回報「純黑或純白背景面積很大，整個視覺壓力也變大」，並指定淺色走 「氣泡淡藍＋對話欄底稍深淡藍」（她的方案 2）、深色邏輯相同。量過之後 確認抱怨來源不只對話欄：淺色頁面底 #f8fafc 幾乎等於白，真正的大面積 純白是 --c-surface（表格資料列＋所有 Gradio 區塊）；深色則是 #020617 近乎純黑。 底色改成三層，淺深共用同一套邏輯： 底（--c-bg） 淺 #f8fafc→#e8f1fa 深 #020617→#0b1424 浮起物（--c-bubble-bg）淺 #eef2f7→#f5faff 深 #0d1526→#172136 資料紙張（--c-surface）淺 #ffffff 維持 深 #0d1526→#172136 淺色的表格／卡片刻意維持純白：75 項指標表格是資料密集區，可讀性優先於 「消滅所有純白」；染藍的是它下面那層底，白表格因此變成浮在淡藍上的紙張。 連帶 --c-surface2／--c-thead-bg／--background-fill-secondary 同批換成 同色相的值，避免藍底配灰塊。 線條改走 sky 相（千卉：淺色邊框不要太深，要維持亮麗的淺藍）： --c-border-strong #a3aebd→#6ba3d6（結構線，約 2.3:1） --c-divider #b6c0cd→#a9cbe8（表格資料列細線） --c-input-border #a3aebd→#7fb0d9（約 2.0:1） 亮度級距不動，只換色相，手感與上一輪柔化後相同。 順帶修掉一個自己上一輪引入的深淺不一致：氣泡邊框原本共用 --c-divider， 淺色值卻是對著「深色結構線那一級（alpha .28）」挑的，而深色 --c-divider 是更淡的 .18，實測深色 1.37:1／淺色 1.61:1，兩個主題看起來不一樣。改成 獨立 token --c-bubble-border（淺 #a9cbe8、深 rgba(148,163,184,.26)）， 兩邊實測都是 1.61:1，--c-divider 也回歸單一用途。 docs/design.md 同步：新增「底色體系：三層」章節（含淺色表格為何維持白底 的準則）、線條表換新值並補「淺色一…3dc69f8 -
線條柔化：結構線降到 2.25:1、氣泡邊框改細線與深色對齊
千卉看實機截圖後回饋兩點：①淺色氣泡的邊框要跟深色一樣淡、兩個模式一致 ②整體線條對比太高、看起來醜，要更柔和。 - --c-border-strong（淺色）#7c8798 → #a3aebd：對白從 3.64:1 降到 2.25:1。 這是刻意離開 WCAG 1.4.11 的 3:1 門檻的視覺決定，但仍是改版前 1.2:1 的 近兩倍，業主原本回報的「淺色看不清楚區塊」在這個亮度差已解決；文字對比 不受影響，全站文字維持 AA。日後若要嚴格達標，把這個 token 調回 #7c8798 即可，19 處線條會一起跟上。 - 對話氣泡邊框從結構線降到細線 --c-divider：淺色 #b6c0cd 對氣泡底 1.64:1、 對欄底 1.76:1，深色 rgba(148,163,184,.28) 疊 #0d1526 是 1.67:1，兩個模式 的邊框亮度差幾乎相同——「深淺一致」是量出來的，不是各挑一個順眼的值。 - --c-input-border（淺色）同步柔化成 #a3aebd。 - 使用者訊息氣泡維持與 AI 同款（業主確認先這樣，只靠左右對齊區分）。 docs/design.md 同步三處：token 表數值、結構線離開 3:1 的取捨說明、氣泡 邊框改用細線的量測依據。 驗證：重啟後實測淺色氣泡邊框 1.64/1.76:1、結構線 2.15-2.25:1，深色數值 與改動前完全相同；情境 1 走到語料說明表單、深淺兩色截圖確認，console 僅 3 筆既有外部資源錯誤。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MQuAXWC1hCsiT48TXftPc7059e85b -
業主第四輪修改：淺色對比度、AI 頭像、下載位置、使用手冊
1. 淺色模式對比度（深色維持原樣） 新增兩級線條 token：--c-border-strong（結構線，淺色 #7c8798，對白 3.64:1、對近白底 3.2-3.5:1）與 --c-divider（表格資料列細線）。深色值 沿用原本散在 .app-header／欄邊框／標題底線各處的 rgba(148,163,184,.28) 硬寫值，那批個別覆寫規則一併刪除。三個 token 宣告點（app.css :root／ .dark、app_agent.py _DARK_MODE_HEAD_CSS）同步。 對話氣泡：淺色底改 --c-bubble-bg #eef2f7（原本白底疊欄底只有 1.07:1） 並加 1px 結構線邊框。表格表頭底改 --c-thead-bg #e2e8f0、表頭分界線改 結構線。輸入框邊框（淺色）從 1.3:1 改 3.6:1。 2. AI 對話氣泡加頭像 gr.Chatbot(avatar_images=(None, ai-avatar.svg))，28px 圓形。漸層畫在 CSS 的 .avatar-container（吃 accent token、隨主題切換），SVG 檔只放 白色四角星——avatar_images 是 Python 端參數，同一個檔沒辦法隨主題換色。 3. 語言指標分析的下載區塊移到表格下方，與其他五個結果頁順序一致 （純宣告順序調整，_TAB_IDX 位置對應不動）。 4. 左側導覽列最後加「使用手冊」下載項目 放在 result_nav_col 外、nav-items-scroll 最末，全程可見；接專案根目錄 既有的 使用手冊.docx（實測下載 41783 bytes 一致，不用改 allowed_paths）。 它是下載動作不是頁面，不進 _ALL_NAV_IDS，不搶導覽 active 狀態。 #nav_guide_btn 比照 #reset_btn 加進導覽列樣式與收合狀態的選擇器清單。 順帶讓 result_nav_col 只佔內容高度（Gradio 預設 flex:1 1 auto 會把它 撐滿、把使用手冊推到欄底）。 docs/design.md 同步：兩級線條準則、對話氣泡…f5990cb
-
文件同步：補記 4 項導覽掛載與下載時序修復（commit 56a8c3b）
修復項目由 15 項增為 19 項，2.2 由 4 項增為 8 項：開始研究分析後 左側導覽列消失、硬點技術執行紀錄內容區塊空白、技術執行紀錄缺大 標題、下載研究報告／完整分析資料在報告撰寫完成前提早出現缺件。 3.1 打包下載機制規則同步更新，程式碼行號一併校正。6afdd75 -
範圍聲明的未檢視特性改用 ISO/IEC 25010:2023 的特性名稱
該段列舉「不在本次檢視範圍」的特性時，用的是 2011 版的中文譯名（功能 適合性、效能效率、易用性、可攜性），與本專案其他文件及 knowledge/軟體 品質模型/ISO25010與CIA速查.md 採用的 2023 版術語不一致。 改為 2023 版名稱：功能適切性、性能效率、相容性、互動能力、彈性、安全 防護。易用性在 2023 版已改稱互動能力，可攜性拆分後對應彈性，安全防護 （Safety）為 2023 版新增的頂層特性，一併補入。 本段只是範圍聲明的列舉，不涉及任何實際檢視項目，內容與結論均未變動。090658c -
檢視角度：保留 CIA 為主框架，補上「非全面品質稽核」的範圍聲明
上一版曾考慮改以 ISO/IEC 25010 為單一框架（該標準的 Security 特性 底下確實包含 Confidentiality 與 Integrity，Availability 則在 Reliability 底下），但這樣宣稱會有兩個問題：本文件只用到四個角度， 而 25010 有八到九項特性（依 2011 或 2023 版而異）；且四者混用了頂層 特性與子特性兩種層級，講成全面套用並不誠實。 CIA 三項則是完整用到、且本次發現確實三類都命中，可以理直氣壯稱為 框架。故維持 CIA 為主，可維護性標示為額外加入，出處只點名 ISO/IEC 25010 的 Maintainability 特性，不報特性總數，一併迴避版本差異。 新增一段範圍聲明，明說本文件不是全面的軟體品質稽核，功能適合性、 效能效率、相容性、易用性、可攜性等特性不在檢視範圍及其理由，避免 讀者誤以為這是完整的品質評估報告。f389355 -
檢視角度改以 CIA 三要素為框架，並校準完整性的定義
原本四個角度只是列舉，沒有說明依據。改為明確採用資訊安全的 CIA 三 要素（機密性／完整性／可用性，ISO/IEC 27000 系列對資訊安全的定義 基礎），並說明選它的理由：任何資訊系統的風險最終都會落在「不該看到 的人看到了」「產出被破壞或殘缺」「該用時用不了」三類之一，涵蓋面完整。 第四項「可維護性」明確標示不屬於 CIA，出處為 ISO/IEC 25010 軟體品質 模型，並說明納入理由（前三項的改善都落在同一份程式碼上）。 同時校準「完整性」的定義。原本寫的是「錯誤情境有沒有處理完」，那是 錯誤處理健全度，不是 Integrity 的標準意思；若直接掛上 CIA 而定義對 不上，反而降低可信度。改為標準定義「資訊與產出保持正確、完整，未遭 意外或未授權的變更」。 第三節補上歸類理由，讓內文支撐表格的分類：LLM 呼叫失敗時系統不會停 下來，而是標記該階段失敗後繼續，使用者仍拿到一份看起來完成、實際缺 了報告本文的產出。缺乏重試機制的後果因此不只是慢或要重跑，而是可能 交付殘缺成果，這才是 Integrity 問題。 表格改為四欄：角度、標準定義、在本系統的具體提問、帶出的項目。8ee55f5 -
建議書第七節底下兩子項提升為第七、第八節，與成果說明八項齊平
成果說明「五、未完成項目」是 8 個平級小節，建議書卻是 6 個主節加 1 個 含 2 子項的第七節。兩邊項目其實一一對應，但排版層級不同，對照時第一眼 會誤以為數量不符（實際發生過）。 將原 7.1、7.2 提升為第七節、第八節，項目總覽表拆為兩列。原本併在 「待決策的項目」底下是因為兩項同屬產品決策、不需工程資源，這個分類 資訊在總覽表的「主要角度」欄已標明，另在兩節末尾各補一句說明，攤平後 不會遺失。 成果說明 5.7／5.8 的指向由「7.1／7.2」改為「第七節／第八節」，八項 現在對八節，不需要換算層級。更新紀錄補三筆本日的修改摘要。a77d188 -
開發優化建議改為中性技術文件，移除第一人稱與第二人稱
原文件以「我對業主提建議」的書信口吻寫成，全文 50 處「我」「您」。 這份文件的實際讀者是後續承接的工程資源，內容是技術評估與施工方向， 用人稱敘述會讓它讀起來像一封信而不是可依循的技術文件；且交接後提出 人不一定在場，「我」指涉誰會失去對象。 全文改為中性陳述，六個含人稱的章節標題一併改寫： - 為什麼我把這一項排在第一位 → 列為最高優先的理由 - 請您確認的事項 → 待確認事項 - 我為什麼提出這件事 → 問題背景 - 我為什麼把它歸類為工程範疇⋯ → 歸類為工程範疇、不納入本次改版施工範圍的理由 - 我建議的實作順序 → 建議的實作順序 - 七、待您決策的項目 → 七、待決策的項目 「我測試時」改為「本次測試時」、「我建議」改為「建議」、「等您決定」 改為「待決定」，其餘依此類推。所有事實、數據、程式碼行號與章節結構 均未變動。順帶修掉一處以破折號作補充說明的寫法。5c42d58 -
修正空狀態提示的過時頁名，統一六顆結果頁下載鈕的命名
兩處都是改版過程中因為導覽項目改名、而文案沒有同步造成的殘留，各改 一行字串，不動任何邏輯。 _EMPTY_HINT（app_agent.py:1837）：結果頁在資料尚未產出時提示「請先於 「主頁」完成分析流程」，但左側導覽列上沒有任何叫「主頁」的項目，對應 的是「AI對話」，使用者照著找不到入口。文案改為「請先於「AI對話」完成 分析流程」，與導覽項目名稱一致。 結果頁下載鈕命名（app_agent.py:3042、3111）：四個統計子頁用「下載＋ 該頁名稱」（下載敘述統計／下載差異性分析／下載監督式學習／下載非監督 式學習），但語言指標分析那顆是「下載檔案」、LLM 輔助分析那顆是「下載 報告」，使用者切換頁面時無法從按鈕文字判斷拿到的是哪一份。依專案既有 的主流命名規則（六顆中四顆已是此形式）統一為「下載語言指標分析」與 「下載LLM輔助分析」。 文件同步：兩項從「已知待修正」升格為第二章的修復項目，第二章由 13 項 增為 15 項（2.2 三項增為四項、2.3 四項增為五項），總覽表數字一併更新。 驗證：AST 解析通過；grep 確認三處字串已改、六顆下載鈕標籤全部一致。 瀏覽器實地渲染尚未驗證，見 commit 說明外的回報。29017e5 -
拆分對話區塊與內容區塊，逐項對照程式碼校正 4.1-4.5
原「右欄（對話畫面）」把對話區塊與內容區塊混為一段，且版面圖畫成 單欄。實際結構是：AI 對話頁為三欄（導覽＋對話＋內容），其他結果頁 為二欄（對話區塊收起，由 JS 在 .main-layout-row 記 data-nav、CSS 據此控制顯隱）。拆成兩個小節分別說明，各自附版面圖與元件對照。 內容區塊補充步驟列與捲動區分兩層的原因（步驟列自己 position:sticky 會被 Gradio 自動包的 .block wrapper 框住而跟著捲走，已實測）。 結果分頁排版表改為逐頁列出實際元件順序，並補上監督式學習表格與圖 的 1:2 寬度比、非監督式學習兩張圖等寬並排等細節。 空狀態補上 _EMPTY_HINT 的實際文案與行號；無顯著指標的情況補上 tab_box_img 預設 visible=False、該處確實一片空白的說明。 新增兩處「已知待修正」： - 下載鈕命名不一致：四個統計子頁用具名標籤，但語言指標分析是 「下載檔案」、LLM 輔助分析是「下載報告」 - _EMPTY_HINT 文案「請先於「主頁」完成分析流程」是舊版導覽用語， 現行導覽列沒有「主頁」項目，對應的是「AI 對話」 4.3 語料 Metadata 表單經對照確認與程式碼一致，未修改。e4f9e7e -
移除情境標籤敘述，修正步驟列的顯示條件
情境標籤（「情境：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 規則）。4ebbb31 -
四、設計規範三處修正為實際畫面
情境卡片說明文字原本寫在「首頁」段落裡，但情境選擇 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 但無任何地方解析輸入文字）與日後啟用方式。4d9fe25 -
README 精簡為三份文件的對照表
移除三段閱讀路徑導引與行號提醒。導引預設了讀者的來意，實際上翻開 對照表就能自己判斷要看哪份；行號提醒在《開發優化建議》附錄已有 同樣說明，不需要在此重複。15fd1d3 -
移除文件中的「貴系」「貴校」字樣
改為「學校」與省略主詞。兩份文件都要交給業主，用敬稱指稱對方的機構 讀起來像對外提案，不像交付文件。70518f0 -
成果說明文件重整為六章成果導向架構，新增 docs/README.md
原文件為十五章的需求規格結構，是協作時的工作文件，交給業主閱讀時 找不到「這次做了什麼」。重整為六章，分類邏輯從文件書寫順序改為讀者 會問的問題：修好了什麼、新增了什麼、怎麼設計的、還沒做什麼。 新增文首「文件架構與成果總覽」表，兼目錄與成果摘要，一頁掌握全貌。 第二章依使用者實際遭遇情況重新分為三類共 13 項：流程卡住只能重整 頁面（6 項）、畫面與實際狀態不符（3 項）、視覺與可讀性（4 項）。 除原第三章的 5 個 Bug 外，補入改版過程中發現並修復但從未記錄的問題 （上傳取消鈕鎖死入口、重置後情境卡片失效、報告失敗誤報全部完成、 表單殘留上一輪內容、明暗切換失效、標題漸層消失），每項附 commit。 純視覺微調不列入此章，歸入 4.4。 功能項目與其規格章節合併：原第四章缺口 1 與原第九章下載機制併為 3.1、缺口 3 併為 3.2，避免同一件事拆兩處。設計相關的原第五、六、 七、十一、十三章整併為「四、設計規範」，新增 4.6 說明 design.md 的三個用途（工程取值依據、其他系統沿用同一設計語言、設計與程式的 單一事實來源）及其與本章的分工。 第五章未完成項目統一為 8 項，順序與《開發優化建議》一一對應，避免 兩份文件數量對不上。原第十二章既有架構限制移入 1.3。 修正 Footer 章節：原寫「透過 API 使用：保留」，實際 footer_links=[] 為全部移除（commit d928c91），決策後來改變但文件未同步。 新增 docs/README.md 說明三份交付文件的用途與適合讀者，並依「想知道 做了什麼」「準備接手維護」「要調整樣式」三種來意給出閱讀路徑。 刪除 docs/進度報告-2026-07-21.md（2026-07-21 的階段性快照，11 階段 只完成 6 個，內容已被本次重整取代且與現況不符）。docs/design/ 的 四情境首頁設計原型已過時（該設計 2026-07-30 已被推翻），其中的 Crimson Pro 字體檔移至 assets/fonts/ 保留，日後若要移除對 Google Fonts CDN 的依賴可直接使用。 《開發優化建議》六處交叉引用改為新章節編號。798601b -
文件改名與三處內容修正
需求彙整-UIUX改版.md 改名為 UIUX優化成果與技術說明.md（git mv，保留 檔案歷史）。原檔名讓業主誤以為是專案開跑前的內部文件而不會打開，但 文件在補上「本次改版完成項目總覽」後，主要用途已是向業主說明執行成果； 新檔名同時保留「技術說明」，讓工程接手時知道規格仍在這份文件裡。 內文標題同步更新。 第八節標題移除「方案 D」代號：該代號源自 2026-07-20 訪談時的多方案 比較，但 A/B/C 三案從未寫進本文件，單獨留一個 D 對任何讀者都沒有指涉 對象。更新紀錄與開發優化建議.md 內的三處引用一併清除。 第四節缺口 3（監督式／非監督式學習下載按鈕）補註已完成：實作在 commit 80da6cc（Phase 5），元件為 tab_imp_file / tab_cluster_file， 但文件停留在規劃語氣加「✅已確認要做」，與缺口 1 當初有回頭標註 「已實作完成」的處理不一致，容易被誤讀為未施工。 開發優化建議.md：六處對舊檔名／舊稱呼的引用改為《UIUX優化成果與 技術說明》。eba3775 -
兩份交付文件改版：優化建議重構為四視角、需求文件同步最終實作
開發優化建議.md： 以完整性／可用性／可維護性／機密性四個角度重新檢視，新增兩節。 第一節（機密性）研究語料經 prompt 送往 OpenRouter 與其上游供應商， 程式碼無任何資料政策或使用者告知處理，列出三項帳號層級確認事項。 第五節（可維護性）主檔 4232 行、handler 全巢狀定義在 create_app() 內無法單獨測試、零測試檔、設定散落四處，說明它如何放大其他各節的 施工風險。各節依急迫性重排。 補實測數據修正原本的錯誤結論：專案預設 Gemma 模型 reasoning_tokens 為 0、單次 21 秒，先前記錄的 reasoning 浪費與耗時偏長來自本機 .env 覆寫成 openrouter/free（同一代號兩次呼叫路由到不同模型），非專案 預設行為；原文件據此要求業主「換回付費模型」的前提有誤，改為確認 計費與勿用 :free 變體（實測 429，upstream_provider_shared_pool）。 全檔 19 處程式碼行號重抓：原文件行號停留在 aa1f341，CSS 抽出後全檔 位移近兩千行，引用的 :5846/:6124/:6372 均已超出檔案總行數。 需求彙整-UIUX改版.md： 新增「本次改版完成項目總覽」章節置於文首，以非技術語言分四類說明 本次合作實際完成的工作，供業主快速掌握；技術章節原樣保留供工程接手。 其餘就地同步為最終實作結果：5.1 首頁（情境卡片 2026-07-30 已搬回 工作區成第 1 步，首頁只留品牌介紹＋單一入口）、5.2 步驟列 7 步更正 為 4 步與導覽列最終項目、6.2/6.3 版面圖（下載捷徑四顆、技術執行紀錄 轉正為獨立頁、設定/API 連結列移除、二欄改三欄）、6.4 補技術執行紀錄 頁、第八節註明存檔／讀檔未實作（首頁為「功能開發中」佔位連結）、 13.1 首頁空狀態、第十四節移除校徽識別項、第二節風險分區行號。e16c550
-
新增 docs/design.md 設計系統文件
依千卉既有 DESIGN.md 慣例格式（YAML frontmatter 機器可讀 tokens + Markdown 本文說明判斷準則），從 assets/app.css 與需求彙整文件第十一節 「視覺規範」萃取本案設計系統：雙主題配色（WCAG AA 驗算通過）、字體 （Crimson Pro 英文數字 + Noto Sans TC 中文）、造型間距、圖示規範、 已知技術限制（Gradio CSS pipeline 的 :root 前綴問題等）。5ece6e2 -
開發優化建議文件補充：提醒業主正式上線前需換回付費模型
目前 .env 的 LLM1_MODEL/LLM2_MODEL 是 openrouter/free 免費模型自動 路由，僅供本次改版測試使用；2.3節列出的路由不穩定、思考過程浪費 時間等問題很大一部分是免費模型固有限制，正式上線前需換成付費模型 並確認額度/付款方式已就緒。54bc138 -
新增開發優化建議文件，彙整超出本次改版範圍的工程項目給業主
- Phase 10 持久化機制（存檔/讀取進度）：問題重現、原始需求、架構說明、三個實作選項優缺點 - LLM API 呼叫可靠性強化：無重試機制、180秒逾時未真正生效、免費模型自動路由浪費 reasoning token - 本機啟動 share=True 預設開啟公開分享連結的安全性疑慮 - Session 輸出目錄清理機制 - 待業主決策項目：Metadata 補填、致理品牌識別、上傳檔案大小上限761ab7f
-
需求文件：補記運算階段重構與誠實失敗（更新紀錄）
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>5cc1a8b -
確認框改置中 modal、移除統計比較分析手風琴、整包下載按鈕改名
「開始新分析」確認框（千卉指定）： - 從 nav-col 內嵌卡片改成全螢幕半透明深灰遮罩 + 水平垂直置中的橫式對話框 - 元件搬到 workspace_row 外層是必要的，不是順手：nav-col 在手機寬度是 position:fixed + transform 的抽屜，被 transform 的祖先會讓子孫的 position:fixed 改以該祖先為定位基準，對話框會被關在抽屜裡 - overlay 刻意不設 display：Gradio 的 visible=False 就是靠 display:none 生效，寫 display:flex !important 會把隱藏本身蓋掉。改用「維持 Gradio 給的 flex 排版 + 面板 margin:auto」達成置中 - 深色模式另給 rgba(0,0,0,.62)：頁面本身已是深色，同一階深灰疊上去看不出 被壓暗，遮罩形同不存在 - 補上點遮罩關閉與 Esc 關閉（沿用手機抽屜既有的互動慣例） - 移除 8-E 的「收合狀態下點重置先自動展開 nav-col」變通，該變通存在的理由 （彈窗會擠在 60px 窄欄）已隨 modal 消失 移除「統計比較分析」手風琴（千卉指定：標題文字與收合效果都不要）： - 四個子頁改成跟其他導覽項目平列的一般項目 - 原本那一列兼任 stat 頁的 active 指示器，拿掉後改由使用者實際點的子項目 自己標 active：applyActivePage() 多收 navId 參數，結果記在 data-nav， 讓每 400ms 的 _reapplyActivePage()（不帶 navId）不會把 active 清掉 - 連帶移除 #nav_stat_accordion 與 .result-nav-accordion 整組死 CSS 整包下載按鈕改名「下載完整報告」→「下載完整分析資料」（zip 檔名同步）， 原名與「下載研究報告」字面過於接近，分不出哪個才是報告本文。 修掉一個自己剛引入的 bug：Esc 關閉對話框原本用 offsetParent !== null 判斷 可見性，但 position:fixed 元素的 offsetParent 永遠是 null，會判成「沒開」， Esc 永遠關不到。改讀 computed…89ca669 -
需求文件：整包下載與防手滑改為已實作，待業主確認清單第 1 項結案
- 第四節缺口 1：從「只做假按鈕、後端交業主拍板」改為已實作完成 - 第九節下載機制：改寫成四顆下載捷徑的實際規格（含 zip 檔名、空包不出現、 只有一組有內容時不另外產生整包） - 第八節持久化：防手滑補上實作範圍與兩個瀏覽器層面的限制 - 第十四節待業主確認清單第 1 項劃掉結案 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>35486cb -
把 docs/ 文件納入版本控制，.gitignore 補 .venv/ 與本機測試樣本
- docs/需求彙整-UIUX改版.md 與 docs/進度報告-2026-07-21.md 從建立至今 未被追蹤過，前者是要交付業主的需求文件 - docs/design/ 維持排除（設計素材不進版本控制，沿用原本排除 00pic/ 的慣例） - .gitignore 補 .venv/ 與 _bug2test/ Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>5668fa5