從 local-tool 複製出獨立的「visionA Agent」桌面應用(A3 純橋樑: tunnel client + 配對 UI + 設定,不開 HTTP port、不做本機裝置/推論 UI)。 Bundle ID 與 local-tool 不同(com.innovedus.visiona-agent vs visiona-local), 雙 app 可共存。fork 後不主動 sync,需要時手動 cherry-pick。 Backend / Wails Go(AB1-AB13): - internal/tunnel:6 狀態機(Idle/Connecting/Connected/Reconnecting/Failed/Stopped) + Pair/Unpair/Reconnect/Disconnect binding + ClientHooks event - internal/auth:encrypted file token store(AES-GCM + scrypt + machineID fallback salt + 13 tests) - internal/config:YAML validation + atomic write + 11 tests - internal/log:ring buffer + ExportLog 升級 zip - visionA-backend /api/pairing/exchange:SessionTokenStore + 17 new tests - 三平台 build 驗證(macOS DMG 160 MB / Windows EXE / Linux AppImage) - end-to-end 5 milestone 全綠(pairing → tunnel → forward → reuse 防護 → tunnel drop failover) Frontend / Next.js(AF1-AF7,沿用 visionA-frontend 基礎): - AppShell + Header + TabNav(StatusView / PairView / SettingsView 三 tab) - ConnectionStatusBadge 5 種狀態 - TokenInput regex 驗證 + 7 種錯誤 + 0.5s auto-switch 到狀態頁 - 設定頁 4 區塊(含重新配對 AlertDialog) - agent-api.ts 封裝 Wails bindings(mock/real 雙實作)+ 90 tests Phase 0.7 review-driven fix(Round 2): - A1 Session fixation 防護(RotateSessionID) - A3 mock pairing 預設改 false(必須明確 opt-in)+ startup log - A4 Pair 失敗後 state 清理矩陣(exchange/Save/Start fail 各自終態) - A5 Pair/Unpair/Reconnect lifecycleMu + 50 goroutine race test - F1 重新配對次按鈕 / F2 PairView Esc cancel / F3 Wails BrowserOpenURL / F4 Settings draft 持久 + 未儲存 badge 驗證:agent backend go test -race -count=3 ./... 4 packages 全綠 / agent frontend pnpm test 119 tests 全綠 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
macOS DMG 美化資源
檔案
| 檔案 | 用途 |
|---|---|
make-dmg-background.py |
生成背景圖的 Python script(需 Pillow) |
background.png |
640×400 DMG 背景圖(1x) |
background@2x.png |
1280×800 DMG 背景圖(Retina,create-dmg 自動挑用) |
使用
# 一次性安裝
brew install create-dmg
# Build 美化 DMG
make dmg
make dmg 會自動偵測 create-dmg:
- 有裝 → 產出美化版(深色背景 + 拖曳示意)
- 沒裝 → fallback 到
make dmg-plain(原本的 hdiutil UDZO,CI 友善)
可直接指定 target:
make dmg-fancy— 強制美化版(create-dmg未裝會報錯)make dmg-plain— 強制 plain 版
重新生成背景圖
改配色或文案時:
python3 installer/macos/make-dmg-background.py
會同時輸出 background.png 與 background@2x.png。
設計對齊
背景圖配色對齊 Wails 控制台深色 splash(#111827 → #0B0F19 漸層 + #38BDF8 accent)。
左側 app icon 位於 (180, 200),右側 Applications 捷徑位於 (460, 200),箭頭在中間。