|
|
f5655e38b1
|
feat(local-tool): hard timeout 5min + Stage 6 隱藏到 header + 全屏 splash
回應使用者三項需求：
1. 整體 hard timeout 180s → 300s（5 分鐘）
每個 stage 已有 soft timeout 20s 提示機制，整體 budget 不需緊湊。
5 分鐘是「使用者點完一杯咖啡都還沒好」的心理上限。pause 機制
（Stage 1 seed / Stage 2 Python bootstrap / Stage 3 waitHealthy）
仍維持作為「一次性 bootstrap 完全不算 budget」的快速通道。
- 同步更新 i18n 紅 banner 文案 180 → 5 分鐘
- 同步更新 unit tests（HardTimeout 用 -305s，SkipBypass 用 -320s，
PreventsHardTimeout 註解 effective<300s）
2. Stage 6「等待 Web UI 連線」從 6 階段面板隱藏到 header 連線指示燈
Go 端 pipeline 仍保持 6 階段（不動），前端 UI 只顯示 5 階段：
- startup-panel.js: TOTAL_STAGES=5 顯示用，PIPELINE_STAGES=6 內部
state 用。renderStages / paintProgressBar / 進度數字都用 5。
- updateStage 仍會收 stage 6 events 更新內部 state（控 collapse 時機）
但 stage 6 不 paint UI（n > TOTAL_STAGES early return）
- 新增 onConnectionStatusChange listener 機制：stage 6 status 變化
時通知外層
- control-panel.js: setWebUIStatus 把連線狀態 (pending/running/
completed/failed) 渲染到 header 的 meta-webui 指示燈：圓點顏色
+ 文字 (等待連線/已連線/未連線)
- index.html: server-meta 新增 <dd id="meta-webui"> 指示燈位置
- i18n: control.meta.webui / control.webui.{connected,waiting,disconnected}
- style.css: .webui-status::before 圓點 + pulse 動畫 + 顏色對應
state (pending=灰 / running=warning+pulse / connected=success / failed=destructive)
- app.js: 註冊 onConnectionStatusChange listener，初始化呼叫
setWebUIStatus('pending')
3. 全屏 spinner splash 取代「啟動中...」三個字
原本 app 啟動最一開始的「啟動中」狀態只有 header 上三個字很不
明顯，使用者體感像沒反應。改為 DOM ready 時就顯示 fullscreen
spinner overlay，收到第一個 startup:progress event 才隱藏。
- index.html: <div id="boot-splash"> 內含 logo + spinner-lg + 文字
- style.css: .boot-splash position:fixed inset:0 z-index:1000，
.boot-splash.hidden { display:none } 用 class 控制（避免和
[hidden]!important 衝突）
- app.js: hideBootSplash() helper，4 個 hide 觸發點：
(a) 收到 startup:progress event
(b) snapshot 補漏發現 pipeline 已啟動
(c) 收到 startup:error event（即使失敗也要看到錯誤）
(d) handleServerStatus 收到非 idle 狀態（restart wails app
server 還活著的情境）
更新 fix marker 為「d946561+ (5min hard timeout + 5-stage UI + fullscreen splash)」
驗證：
- visiona-local 套件 go build / vet / test -race 全綠
- macOS dmg 163MB 重 build OK
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
|
2026-04-16 01:23:55 +08:00 |
|
