一句話:本卡屬 FR-188(母卡 CM-3728)。Agent 主控台兩處文案與實際不符:待核准時總覽寫「這台 Agent 已被撤銷或停用」;服務與重啟頁的白名單說明寫「安裝時設定底線」。只改 FE repo 的主控台文案與一處顯示判斷。來源:2026-11-09 首腦在 190 全新安裝 Agent 1.7.4 實測。
問題是什麼(白話)
① 新裝的 Agent 開通授權照後、平台還沒核准前,主控台總覽「註冊狀態」寫「最後一次心跳失敗:這台 Agent 已被撤銷或停用」。對現場人員來說這像是出事了,其實只是在等平台核准。FR-185 的 CM-3727(Agent 1.7.4)已經把總覽頂端的雲端燈改成「尚未連上主系統,主系統尚未核准或已停用這台」,但這一行是另一個元件的文案,那張卡寫「主控台前端不需改」,所以漏了。
② 服務與重啟頁「主控台連入白名單」的說明寫「安裝時設定底線,主系統只能再收緊」。FR-185 CM-3670/3671 之後安裝與首次設定都不問白名單了,這句會讓人以為安裝時漏填。
首腦核對過的證據
- 190 實測截圖(1.7.4、授權已開通、平台待核准):總覽註冊狀態「註冊:未完成|最後一次心跳失敗:這台 Agent 已被撤銷或停用」。
- 文案來源:FE src/config/locales/i18n/zh-tw/agent-console-ops.json:29
reg_heartbeat_error「最後一次心跳失敗:{err}」+:32 錯誤種類 forbidden「這台 Agent 已被撤銷或停用」;en 同鍵。
- Agent 回報的錯誤種類 forbidden 同時代表待核准與已撤銷/停用(主系統刻意回同一個 403,不洩漏報到成功)。CM-3727 在 Agent 端雲端燈的寫法是「主系統尚未核准或已停用這台」,本卡用同一句,不另造說法。
- 白名單說明:服務與重啟頁(FE console/views/Ops.vue)讀 agent-console-ops.json 的白名單說明鍵,實測文字「安裝時設定底線,主系統只能再收緊;本機 127.0.0.1 永遠放行。設錯導致無法連入時,請聯絡負責這台 Agent 主機的系統管理員重設。」
怎麼改
- (extend)
forbidden 文案改成「主系統尚未核准或已停用這台」,跟雲端燈一致;en 同步。不新增錯誤種類、不改 Agent。
- (extend)白名單說明改成:「預設不限,上線後由主系統管理員在 Agent 管理頁設定。用設定檔安裝時若設了底線,主系統只能在底線範圍內再收緊。本機 127.0.0.1 永遠放行。」後半句設錯時的處理保留。en 同步。
- 先 grep 兩份 agent-console*.json 還有沒有其他「安裝時設定」「首次設定頁填」白名單的字樣,一起改。
驗證
- 跑 FE 既有 agent-console 相關 vitest;build dist-console 通過。
- 手測(headless 截圖即可):待核准中的 Agent 總覽註冊狀態顯示新文案;服務與重啟頁白名單說明為新文案。
紀律
- 只改 FE repo:src/config/locales/i18n/zh-tw/agent-console-ops.json、src/config/locales/i18n/en/agent-console-ops.json;必要時 agent-console.json 同兩份。
- 🔴 agent-console*.json 是登記型共用檔,FR-188 批 6 的 CM-3742 F-2 也改它,所以本卡排批 7,開工先確認 F-2 已合回。
- FE 資安規範在 FE repo .claude/rules/security/frontend.md,從 BE 開的 session 不會自動載入,動手前自己讀。UI 不改,只改文案。