頁面導覽文案盤點與改寫對照
本文件是頁面導覽文案的改寫規格，供實作與審稿使用。下方「專屬導覽：逐步文案對照」的建議尚未套用到語系檔。
範圍是登入後 DashboardLayout 掛載的頁面導覽。登入、首次設定、註冊引導與公開介紹頁沒有這套 UserGuide。每個路由都已有專屬導覽（frontend/src/components/UserGuide/pageGuides/ 與 UserGuide.jsx 的 PAGE_GUIDES）。
讀者與完成標準
導覽的讀者是假設不知道 VM、LXC、PVE、DNS、Token 等術語的新使用者。讀完單一步驟，至少要能回答：這裡是什麼、什麼情況要用、現在要看或做什麼、做完會發生什麼、哪個動作會真的改動資料。頁面標題、欄位名稱已在畫面上，導覽不應只再念一次。
每一步建議用「情境 → 判斷依據 → 下一個動作／結果」寫成 1–2 句。先教正常路徑，再說會卡住的條件；只有涉及刪除、外部曝光、憑證、權限的步驟才額外提醒後果。對空資料、載入失敗、權限不足分別給不同說明，不以同一張假清單代替所有狀態。
現況與共通問題
| 項目 | 目前實作 | 問題 | 改寫方向 |
|---|---|---|---|
| 舊文案與畫面脫節 | 學生首頁導覽寫「填寫容器名稱與密碼」，目前快速練習確認頁是核對環境、機器與規則後建立 | 使用者會找不到導覽提到的欄位 | 以現在的頁面流程改稿，實作時逐步核對被聚光的元件 |
| 流程狀態 | optional 步驟可能直接消失；專屬導覽會自動切分頁、開對話框 | 導覽口吻常在「這裡有」與「導覽已打開」之間跳動 | 文案按已發生的畫面狀態寫；無資料時告訴讀者前置條件，不假裝功能已可用 |
| 觀看紀錄與驗收 | 看過的導覽依導覽 id 記在帳號上（seen_user_guides），改稿不會重置 | 已看過的使用者不會因改稿再收到自動提示 | 重大改稿若要讓使用者重看，需另外決定提示方式；用學生、教師、管理員及空／有資料兩種狀態驗收 |
實作時的文案結構
例：機器清單不寫「這裡顯示機器名稱、IP、狀態」。改成：「先看狀態欄：執行中才能開啟終端機；若是已停止，先到右側選單啟動。IP 是這台機器在校內網路的位置，遠端連線時才需要複製。」讀者看完能決定下一步。
下方各表的「建議標題與說明」是應顯示給使用者的文案草稿。術語第一次出現時應用畫面上的實際名稱，並加一句白話解釋。
專屬導覽：逐步文案對照
這些頁面已有專用聚光目標。保留可用的操作流程，改寫重點是讓讀者知道判斷標準，並修正過長、只列名詞或與畫面狀態不一致的說法。下表「現行」取自 zh-TW/common.json 的步驟標題；「建議」是新標題與內文草稿。
學生首頁、課程、週次
| 頁面／步驟 | 現行標題 | 現行說明 | 建議標題與說明 |
|---|---|---|---|
| 學生首頁 1 | 從你的進行中課程開始 | 課程期間內都會顯示在這裡，不必等到上課當天。綠色代表正在上課；其他課程仍可點入使用機器、查看任務或課後練習。 | 先找今天要上的課。 綠色表示正在上課；其他仍在課程期間內的卡片也能進入。點卡片後再看本週任務與機器。 |
| 學生首頁 2 | 臨時練習不用等待人工審核 | 需要快速測試指令或做輕量練習時，選擇模板並填寫容器名稱與密碼，系統會自動核准並開始建立。 | 只想練一下，選快速練習。 選範本後先核對機器與使用時長；確認建立才會占用自己的配額。 |
| 學生首頁 3 | 下課練習或自主研究 | 不是現在要上課時，可以從這裡回到上次的課程進度；自主研究則會帶你前往資源申請。 | 課後延續與自主研究走不同入口。 回課程看老師安排的內容；要一台自己規劃規格的機器，才到「我的申請」。 |
| 課程列表 1 | 先從課程列表選擇要學習的課程 | 這裡會列出你目前可以進入的所有課程。導覽期間會加入一張虛線框的安全模擬課程，讓你實際練習點進去，不會變更真實資料。 | 先選你目前要上的課程。 卡片會列時間與名稱；導覽中的虛線卡是安全練習，不會新增課程或機器。 |
| 課程列表 2 | 這張是導覽專用的模擬課程 | 票券會顯示課程名稱、上課時間地點，票根的條碼是練習進度，操作方式和真實課程相同。虛線外框與「安全模擬」標籤表示內容不會被儲存。 | 練習辨認課程卡。 看名稱、上課時間與地點，再按卡片進入；「安全模擬」標籤代表這筆不是真實課程。 |
| 課程列表 3 | 點進課程查看機器與每週內容 | 按下一步後，導覽會進入這門模擬課程，接著示範課堂機器、學習進度與每週任務的位置。 | 下一步進入課程。 進入後先看本週進度，再決定要開機器還是讀任務；此步只打開模擬頁。 |
| 課程總覽 3 | 課堂機器可以從這裡進入 | 真實課程中，點機器卡可啟動並進入終端機或控制台，右側資訊按鈕可查看完整設定。模擬內容不會真的啟動機器。 | 做實作時從機器卡進入。 機器就緒後可開終端機或控制台；若尚未就緒，先看狀態，不需另外申請課堂機器。 |
| 課程總覽 4 | 每週內容集中列在這裡 | 一列代表一週，顯示日期、檢查項目數與完成狀態。每週只保留一個整體完成勾選。 | 按週次找任務。 一列是一週；先比對日期與主題，再看檢查項目及完成標記。 |
| 課程總覽 5 | 點進一週查看回饋與指定機器 | 按下一步後會進入模擬的第一週，示範檢查回饋、本週指定機器與教材內容。 | 進入這週，才看得到完整教材與回饋。 導覽會打開模擬週次；正式課程中請選老師指定的週。 |
| 週次 1 | 頁首確認目前課程、週次與日期 | 先確認自己位於正確的課程與週次；返回課程按鈕可回到完整週次列表。 | 先核對課程與週次。 做錯週的作業前，從頁首返回課程列表重新選擇。 |
| 週次 2 | 這裡查看每個檢查項目的最新回饋 | 你會看到通過狀態、得分及老師或 AI 公開的評語。這裡只顯示結果，不會在開啟頁面時重新執行檢查。 | 用回饋找下一個要修的地方。 先看通過狀態，再看評語與得分；打開本頁只讀取最近結果，不會重新執行檢查。 |
| 週次 3 | 這裡是本週指定使用的機器 | 真實課程若已發布網址，可直接開啟服務；也能前往機器與主控台查看完整狀態。模擬導覽不會建立或啟動機器。 | 作業要用哪台機器，看這裡。 機器就緒後可進終端機或已發布的服務；若沒看到可用入口，先確認機器狀態。 |
| 週次 4 | 本週教材會集中放在這裡 | 點教材可在新分頁開啟。模擬檔案只用於說明位置，不會下載任何內容。 | 教材在這裡開。 點檔案會在新分頁開啟；先看老師說明再動手做本週任務。模擬檔案不會下載。 |
個人申請與機器
| 頁面／步驟 | 現行標題 | 現行說明 | 建議標題與說明 |
|---|---|---|---|
| 我的申請 1 | 這裡才是實際的資源申請介面 | 導覽已直接帶你進入申請表單。這裡用來申請專題或自主研究需要的虛擬機／容器；老師分發的課堂機器不需要重複申請。 | 專題或自主研究，需要自己的機器才在這裡申請。 課堂機器由老師分配，不必重複申請；導覽目前開的是申請表。 |
| 我的申請 2 | 不確定怎麼填，可以直接問 AI | 點右下角 AI 助手，用自己的話描述用途，例如「我要架設 Python 網站，使用兩週」。AI 會繼續詢問必要資訊、建議合適規格，並協助把結果填入這份表單；送出前仍可自行修改。 | 不會選規格時，先描述要做什麼。 例如「架 Python 網站，用兩週」；AI 可整理需求並填入建議，但送出前要自己核對。 |
| 我的申請 3 | 先命名，再選擇作業系統 | 資源名稱方便日後辨識；選擇映像檔或環境範本後，系統會判斷要建立虛擬機或容器，並帶入建議的基本規格。 | 先選要跑的系統，名稱留給自己辨認。 範本會帶入基本規格，也決定是 VM（完整虛擬電腦）或 LXC（較輕的容器）。 |
| 我的申請 4 | 依工作量調整硬體規格 | CPU、記憶體與硬碟越高會占用越多配額。一般網站或練習先使用建議值即可，需要圖形介面、Windows 或運算加速時再選擇 VM／GPU。 | 先用建議規格，有明確需求再增加。 CPU、記憶體和磁碟都占配額；圖形介面或特定系統才需要較大的 VM。 |
| 我的申請 5 | 設定實際需要使用的時間 | 立即使用適合現在開始；預約時段適合課程或指定日期。設定期限能讓系統正確保留資源，結束後也可自動釋放。 | 填真正需要的開始與結束時間。 立即用選現在開始；指定日期選預約。期限會影響資源保留與回收。 |
| 我的申請 6 | 說明用途，讓審核者看得懂 | 簡短寫出專題、課程或服務用途，以及為什麼需要這些規格。AI 助手也可以根據前面的選擇產生一段可修改的申請理由。 | 用一句話交代要做什麼，另一句交代為何需要這個規格。 例如服務內容、使用人數與期間；只有「測試」通常不足以審核。 |
| 我的申請 7 | 右側會即時整理完整申請 | 送出前先核對類型、名稱、作業系統、硬體與時段。任何欄位變更都會同步反映在這張摘要卡。 | 把摘要當成送出前檢查表。 逐項核對系統、規格與時段；若配額或時間不合，回左側修改。 |
| 我的申請 8 | 確認無誤後再送出申請 | 送出後會回到「我的申請」追蹤審核與建立狀態；這個動作才會正式建立申請，導覽本身不會送出任何資料。 | 按送出才會成立申請。 之後到「我的申請」追狀態；核准與機器建好是兩個不同階段。 |
| 我的資源 1 | 這些數字是你的使用額度 | 左邊是目前已使用量，右邊是可用上限。例如「2 / 4 台」表示已用了 2 台、最多可以有 4 台。接近上限時需先釋放資源。 | 先看還能不能建立機器。 「2／4 台」代表已用兩台、最多四台；若達上限，先釋放不用的資源。 |
| 我的資源 2 | 沒有資源時，先從這裡提出申請 | 「申請資源」會帶你進入完整申請表；可以自行填寫，也可以請右下角的 AI 助理協助整理需求並填表。 | 需要自訂機器時按「申請資源」。 會進完整表單；只是課堂實作，先到課程找老師分配的機器。 |
| 我的資源 3 | 先看懂一台機器的狀態 | 名稱、系統、執行狀態、內網 IP、到期日與所在節點都集中在這一列。若目前沒有資源，這裡顯示的是安全的模擬資料，不會建立任何機器。 | 先看狀態，再決定能否連線。 執行中可進入；已停止先啟動。IP 是機器在網路上的位址，到期日表示可使用到何時。 |
| 我的資源 4 | 從這裡直接進入機器 | LXC 會開啟終端機，VM 會開啟圖形主控台；機器必須在執行中才能連線。導覽不會真的連入。 | 執行中才能開啟操作畫面。 LXC 進文字終端機，VM 進圖形控制台；按導覽的下一步不會真的連入。 |
| 我的資源 5 | 更多操作包含電源與管理功能 | 這裡可以啟動、關機、重啟或重設機器；具備權限時也能轉成範本或刪除。高風險操作仍會要求確認。 | 電源操作先看目前狀態。 啟動停止的機器、重啟卡住的機器；刪除與重設會影響資料，先確認對象。 |
| 我的資源 6 | 點機器名稱，繼續查看全部設定 | 下一步會實際進入這台機器的詳情頁。若帳號目前沒有資源，則進入不寫入資料的模擬詳情頁。 | 要查規格、監控或快照，點名稱進詳情。 無資源時導覽會開不寫入資料的示例頁。 |
| 機器詳情 1 | 所有功能依用途分成六個分頁 | 導覽會依序打開總覽、監控、規格、快照、操作紀錄與進階設定，讓你看完整個管理流程。 | 先選任務，再選分頁。 查連線用總覽；查用量用監控；改規格、回復狀態或查紀錄再去對應分頁。 |
| 機器詳情 2 | 總覽：先確認狀態與連線資訊 | 這裡集中顯示開機狀態、IP、資源用量、到期時間與 SSH 或服務連結，通常是進入機器後第一個查看的位置。 | 連不上機器時先看總覽。 確認是否執行中、IP 是否出現、是否已到期；再找 SSH 或服務入口。 |
| 機器詳情 3 | 監控：查看即時與歷史用量 | 查看 CPU、記憶體、磁碟與網路流量，並切換時間範圍判斷是否需要調整資源。 | 用時間範圍判斷是否長期吃緊。 持續接近上限才考慮調規格；短暫尖峰先對照當時工作。 |
| 機器詳情 4 | 規格：調整 CPU、記憶體與磁碟 | 拖曳滑桿提出規格變更；一般使用者送出的是審核申請，管理員才會直接套用。 | 改規格前先比對用量和配額。 一般使用者送出變更申請、待審後生效；管理員操作依畫面提示直接套用。 |
| 機器詳情 5 | 快照：建立可回復的時間點 | 更新或實驗前可先建立快照；需要時可以還原。建立、還原與刪除都會有明確確認，不會由導覽執行。 | 改系統前先留快照。 還原會把機器帶回該時間點，之後的變更可能失去；選對快照再確認。 |
| 機器詳情 6 | 操作紀錄：追查誰在何時做了什麼 | 電源、規格與設定變更會記錄在這裡，適合排查問題或確認管理操作。 | 狀態突然變了，就查操作紀錄。 依時間找電源、規格與設定變更，確認操作者與結果。 |
| 機器詳情 7 | 進階設定：機器的完整管理區 | 下方還有生命週期、防火牆、開機選項、登入憑證與共享轉移，導覽會逐項說明。 | 要改連線、登入或使用期限時，才進入進階設定。 先選下面對應區塊，別一次改多項設定。 |
| 機器詳情 8 | 生命週期與到期時間 | 設定使用期限、自動關機或取消排程；變更可能影響機器何時停止與回收。 | 確認機器何時自動停止或回收。 延長或取消排程前，先看是否與課程／申請期限一致。 |
| 機器詳情 9 | 這台機器自己的防火牆 | 管理此機器允許的連入與連出規則。先確認來源、協定與 Port，避免誤擋服務。 | 服務連不上時，檢查這台機器的規則。 對照來源、方向、協定與 Port；開放範圍要符合實際使用者。 |
| 機器詳情 10 | 開機裝置與順序 | 調整磁碟、網路與 ISO 的開機優先順序，也可掛載或卸載安裝映像。 | 只有安裝或修復系統時才調開機順序。 選磁碟、網路或 ISO 前，確認下次重開機要從哪裡啟動。 |
| 機器詳情 11 | 登入密碼與 SSH 金鑰 | 可重設密碼、更新平台金鑰或加入個人 SSH 公鑰；敏感內容只會在必要時顯示。 | 進不去機器時先判斷用密碼還是 SSH 金鑰。 重設憑證後原登入方式可能失效，更新連線設定再試。 |
| 機器詳情 12 | 共享與所有權 | 可以授權其他人共同使用或移轉所有權；移轉前請確認對方帳號與自己是否仍保留存取權。 | 讓別人一起用與移轉擁有者是不同操作。 先確認對方帳號及自己的剩餘權限，再儲存。 |
防火牆、網域、AI API
| 頁面／步驟 | 現行標題 | 現行說明 | 建議標題與說明 |
|---|---|---|---|
| 防火牆 1 | 第一步：把游標移到來源機器邊緣的圓點 | 先決定連線要從哪台機器出發。把游標移到來源機器上，四邊會浮現連接點；從任何一個圓點都能開始拖曳，線會自動走離目標最近的那一側。 | 先決定誰要連出去。 來源是發起連線的機器；從它邊緣的圓點開始拖曳。不方便拖曳時用「新增連線」。 |
| 防火牆 2 | 第二步：按住圓點並持續拖曳 | 在圓點上按住滑鼠左鍵，維持按住不要放開，再把游標拉向目標機器。畫面上的動畫會示範完整移動方向。 | 把線拉向要連到的機器。 按住來源圓點，移到目標圓點；這一步只選兩端，尚未建立規則。 |
| 防火牆 3 | 第三步：對準目標機器的圓點後放開 | 把游標拖到目標機器邊緣的圓點中央，確認已對準後再放開滑鼠。成功時會開啟連線設定，接著選擇允許的 Port；若沒有開啟，代表沒有對準圓點，請重新拖曳一次。 | 放開後確認是否出現設定視窗。 有視窗才代表兩端選成功；沒出現就重新對準目標圓點。 |
| 防火牆 4 | 也可以用「新增連線」完整填寫 | 不方便拖曳時，按「新增連線」，選擇來源、目標與允許的 Port。沒有明確需求時不必新增。 | 不用拖曳也能新增。 選「讓機器上網」、「對外提供服務」或「機器互通」等用途，系統再帶你填來源與目的地。 |
| 防火牆 5 | 表單先問你要做什麼 | 導覽已實際打開新增連線視窗。先選一種意圖：讓機器能上網、開放服務給外部、讓兩台機器互通，或自己寫規則；選定後再挑機器與允許的 Port，方向由意圖決定。 | 先選用途，再核對連線方向。 Port 是服務使用的門牌號碼；只開這個服務需要的 Port。 |
| 防火牆 6 | 確認內容後才建立規則 | 送出前再次確認方向、協定與 Port。導覽只展示表單，不會替你送出。 | 送出前讀成一句話。 「哪台機器可以用哪種協定、哪個 Port 連到哪裡」；確認無誤才建立，導覽本身不送出。 |
| 防火牆 7 | 建立後會回到拓撲圖查看結果 | 每條線代表目前允許的連線，線上標籤顯示 Port；點選機器還能查看它自己的規則。 | 用線確認規則已出現。 線條與 Port 標籤是已允許的流向；要查某台機器全部規則就點它。 |
| 防火牆 8 | 這些按鈕只改變查看方式 | 「自動排列」整理位置；「連線標籤」顯示或隱藏 Port；「地圖」切換右下角縮圖，不會修改任何防火牆規則。 | 排列與標籤只影響畫面。 自動排列、連線標籤與縮圖不改防火牆；修改規則要點連線或機器。 |
| 網域 1 | 第一次使用先設定 Cloudflare | 按「連線設定」輸入 Account ID 與 API Token；「測試連線」只驗證設定是否有效，不會修改 DNS。 | 先讓平台能管理 Cloudflare。 準備 Account ID 與可編輯指定 DNS 區域的 Token；測試連線只驗證存取。 |
| 網域 2 | 連線設定會實際打開完整表單 | 填入 Cloudflare Account ID 與具備最小必要權限的 API Token；預設 DNS 目標會提供反向代理使用。導覽不會儲存憑證。 | 填帳號識別與 API Token。 核對授權範圍與預設 DNS 目標；導覽會打開表單，但不儲存憑證。 |
| 網域 3 | 這裡顯示連線是否正常 | 「已連線」代表平台可以管理 DNS；上次驗證時間可協助判斷憑證是否仍有效。未連線時無法載入網域。 | 看到已連線後再管理 DNS。 若驗證失敗，先檢查 Token 權限與到期日；右側更新時間可幫你判斷狀態是否新鮮。 |
| 網域 4 | Zones 數字是可管理的網域數 | 例如「Zones（3）」表示帳號中有 3 個網域可選。先點左側網域，右側才會顯示它的 DNS 紀錄。 | 先選要改的網域。 Zone 是一個可管理的網域；選錯 Zone 可能把紀錄加到錯的站台。 |
| 網域 5 | 在這裡搜尋或新增 DNS 紀錄 | 搜尋框用來找既有紀錄；「新增紀錄」會建立名稱與 IP／服務之間的對應。不確定紀錄類型時不要直接修改正式網域。 | 先搜尋是否已有同名紀錄。 找到就檢查現值；沒有才新增，避免同一名稱出現互相衝突的設定。 |
| 網域 6 | 新增 DNS 記錄也會帶入完整表單 | 依用途選 A、AAAA、CNAME 等類型，再填名稱、內容、TTL 與是否代理。導覽只展示欄位，不會新增記錄。 | 依目標選紀錄類型。 A／AAAA 指向 IP，CNAME 指向另一個名稱；再填內容、TTL 和代理選項，導覽不會送出。 |
| AI API 1 | 三個分頁搭配「申請金鑰」彈窗 | 按「申請金鑰」送出申請；「API 金鑰」放核准後的金鑰，「申請紀錄」追蹤審核進度，「我的用量」查看金鑰的實際消耗。接下來會實際操作每個步驟。 | 先看整個流程。 申請紀錄看審核進度；通過後在 API 金鑰頁取連線資料；我的用量看程式是否真的在呼叫。 |
| AI API 2 | 「＋ 申請金鑰」：申請新的 API Key | 按此按鈕會開啟申請彈窗，告訴審核者「哪個專案要用 AI、要用多久」。送出後不會立刻拿到金鑰，需要等待審核通過。 | 先申請一把給專案用的金鑰。 申請會進審核，不會立即產生可用金鑰。 |
| AI API 3 | 金鑰名稱是給自己辨認的 | 建議填課程或專案名稱，例如「畢業專題聊天機器人」。它不是 API Key 本身，之後可以修改。 | 名稱寫得出用途。 例如「畢業專題聊天機器人」；這不是秘密金鑰內容，日後可改名。 |
| AI API 4 | 申請目的會提供給審核者 | 至少填 10 個字，清楚寫出課程、專題以及預計串接的功能，比只寫「測試」更容易讓審核者理解。 | 寫出功能、課程或專案情境。 至少十字，讓審核者知道誰會使用、要完成什麼；只寫「測試」資訊不足。 |
| AI API 5 | 有效期限決定金鑰能用多久 | 短期作業可選幾天，長期專題再選較長期限。到期後 API Key 會停止使用，但不會刪除你的申請紀錄。 | 期限對齊專案期間。 到期後呼叫會失敗；短期作業不用申請超長期限。 |
| AI API 6 | 資料完整後再送出 | 送出後彈窗會關閉，畫面會帶到「申請紀錄」查看進度；核准後金鑰會出現在「API 金鑰」。 | 送出前確認名稱、目的與期限。 送出後到申請紀錄追審核；導覽不會替你送出。 |
| AI API 7 | API 金鑰：取得程式需要的連線資料 | 申請核准後才會在這頁出現金鑰。程式通常需要 Base URL 與 API Key 兩個值；API Key 等同密碼，不要貼到作業或公開儲存庫。Base URL 與範例程式在「API 快速開始」裡。 | 程式需要 Base URL 和 API Key。 Base URL 是服務位置，API Key 像密碼；從快速開始看接法，金鑰不要貼在公開程式碼。 |
| AI API 8 | 每一列代表一把已核發的金鑰 | 狀態顯示金鑰是否能用，也會列出建立與到期時間；已失效的金鑰預設收在表格下方。若畫面顯示「還沒有金鑰」，代表還沒有申請通過。 | 先看狀態與到期日。 沒有金鑰時先回申請紀錄；失效金鑰即使還在清單，也不能呼叫。 |
| AI API 9 | 顯示、複製、重新產生與刪除的差別 | 點擊有底線的金鑰名稱，即可在詳細視窗查看及複製完整金鑰；「⋮」裡是重新命名、重新產生與刪除。重新產生會讓舊 Key 失效，並彈出完整的新 Key。刪除後正在使用該金鑰的程式會連線失敗。 | 重新產生會立即使舊金鑰失效。 先複製新值並更新使用它的程式；刪除會使該專案連線失敗。 |
| AI API 10 | 申請紀錄：確認審核走到哪裡 | 所有送出的 AI API 申請都保留在這頁。它只顯示申請與審核結果，不是拿取金鑰的地方。 | 到這裡追審核，不在這裡複製金鑰。 通過後切到 API 金鑰分頁。 |
| AI API 11 | 狀態與備註告訴你下一步 | 「待審核」表示尚未處理；「已通過」後到「API 金鑰」取用；「已拒絕」時查看審核意見，再依原因重新調整申請。 | 按狀態決定下一步。 待審核先等待；通過去取金鑰；拒絕先讀意見、修正用途或期限後重申請。 |
| AI API 12 | 我的用量：了解程式實際用了多少 AI | 這頁用來查使用趨勢與 Token 消耗，不會顯示或修改 API Key。大量增加時，可以回頭檢查程式是否重複呼叫。 | 先看呼叫數與 Token 趨勢。 Token 是模型讀入與產出的文字量；突然增加時檢查程式有沒有重複呼叫。 |
| AI API 13 | 先選擇要統計的日期範圍 | 7、30、90 天只會改變報表範圍，不會限制金鑰期限。右側日期是目前報表實際包含的開始與結束日期。 | 切換 7／30／90 天只改報表。 它不改金鑰有效期限；先確認圖表涵蓋的日期再比較。 |
| AI API 14 | 統一用量：兩種路由的消耗一次加總 | 總呼叫次數是 AI 模型路由與 AI 系統路由的加總；輸入 Tokens 是送給模型的文字量、輸出 Tokens 是模型回覆量，再往下可依模型檢視。 | 把總量往下拆。 先看總呼叫，再看模型路由與系統路由各占多少；輸入／輸出 Token 用來辨認成本來源。 |
| AI API 15 | 細項紀錄：每一筆呼叫都能對帳 | 逐筆列出時間、呼叫類型、模型、Tokens 與成功／失敗狀態；失敗的呼叫會顯示錯誤訊息，方便排查問題。 | 查失敗或暴增時看逐筆紀錄。 依時間、模型、狀態與錯誤訊息找到是哪次程式呼叫造成。 |
導覽互動與驗收要求
- 聚光必須指向文案正在說的物件。 每個步驟都用穩定的
data-guide目標，不用抓頁面第一個section、button或連結的通用選擇器；改 UI 時要一起搬目標。 - 以任務分段，不用每頁固定三步。 審核頁應是「選待審 → 核對 → 決定」；監控頁是「看總況 → 找時段 → 查來源」；設定頁是「理解影響 → 調整 → 驗證」。
- 不替使用者執行有寫入效果的動作。 自動開分頁、開表單可保留；核准、儲存、建立、刪除、重設、發布都讓使用者自己明確操作。
- 導覽按角色分支。
/dashboard有三種內容；機器詳情中一般使用者是送審、管理員可能直接套用。不能讓同一句話同時教兩種行為。 - 空狀態仍要教下一步。 例如沒有申請時，指向建立申請；沒有班級時，指向新增班級。若功能因權限／條件不可用，說出缺少哪個前置條件。
- 文字 QA。 以完全沒用過平台的人測試：看完每步能說出下一次點哪裡、為什麼、會不會更動資料。若只能複述按鈕名，該步重寫。
- 技術 QA。 核對繁中、英文、日文對應 key；以空資料、有資料及三種角色跑完導覽，不得出現聚光錯位、步驟憑空消失、模擬資料被誤認為真資料。
建議實作順序
- 先精簡現有專屬導覽：保留能教操作的段落，讓每一步只回答一個決策；移除重複的「導覽會……」句子。
- 再處理多語系、空狀態與角色分支，按上方驗收條件逐頁檢查。
盤點來源
- 路由與角色條件：
frontend/src/App.jsx - 路由與導覽 id 對照：
frontend/src/components/UserGuide/routeGuides.js - 各頁專屬導覽：
frontend/src/components/UserGuide/pageGuides/ - 導覽流程與互動（含學生首頁、課程、機器詳情）：
frontend/src/components/UserGuide/UserGuide.jsx - 目前繁中文案：
frontend/src/locales/zh-TW/common.json - 各頁實際區塊：
frontend/src/pages/；側欄分類：frontend/src/components/Sidebar/Sidebar.jsx