jim800121chen 3f0175f1a9 feat(local-agent): Phase 0.5 visionA Agent — Wails 桌面 + tunnel client + 配對 UI

從 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>

2026-05-01 11:22:01 +08:00

2.4 KiB

Raw Permalink Blame History

visionA Agent — Branding Assets

此目錄存放 visionA Agent 的品牌視覺資產。

檔案

檔案	用途
`logo.svg`	向量原始設計稿（1024×1024）
`icon-1024.png`	Wails build 的 appicon（會被 Wails 複製到 `visiona-agent/build/appicon.png`）
`icon-512.png` / `icon-256.png` / `icon-128.png`	各尺寸 PNG 備用
`icon.ico`	Windows 多解析度 ICO（16/24/32/48/64/96/128/256，PNG-in-ICO 格式）
`icon.icns`	macOS .app bundle icon

如何更新 logo

改 logo.svg 或改 gen_icon.go 的繪圖函數
跑 go run gen_icon.go <output-dir> 產出各尺寸 PNG
跑 go run gen_ico.go icon.ico <png-dir> 16,24,32,48,64,96,128,256 產 Windows ICO

macOS icns 用 iconutil：

mkdir icon.iconset
cp icon-16.png icon.iconset/icon_16x16.png
cp icon-32.png icon.iconset/icon_16x16@2x.png
cp icon-32.png icon.iconset/icon_32x32.png
cp icon-64.png icon.iconset/icon_32x32@2x.png
cp icon-128.png icon.iconset/icon_128x128.png
cp icon-256.png icon.iconset/icon_128x128@2x.png
cp icon-256.png icon.iconset/icon_256x256.png
cp icon-512.png icon.iconset/icon_256x256@2x.png
cp icon-512.png icon.iconset/icon_512x512.png
cp icon-1024.png icon.iconset/icon_512x512@2x.png
iconutil -c icns icon.iconset -o icon.icns

部署：
- cp icon-1024.png ../visiona-agent/build/appicon.png — Wails build
- cp icon-256.png ../visiona-agent/frontend/icon.png — splash page
- cp icon.ico ../frontend/src/app/favicon.ico — Next.js favicon
- cp icon-256.png ../frontend/src/app/icon.png — Next.js App Router icon
重 build：make clean-all && make exe（Windows）或 make clean-all && make dmg（macOS）

設計理念

圓角方形背景（符合現代 app icon 容器標準）
深藍漸層底（#1A1F36 → #0E1222）傳達專業、科技感
雙層同心圓環 = 相機鏡頭 / 視覺感測器隱喻
中央「V」字形 = vision 首字母
三個 pixel 點 + 右上 active indicator = Edge AI / pixel-level 運算的視覺語彙
主色 #4F7EFF（電子藍）搭配 #6EF3C5（mint）點綴，避免純藍的冰冷

色票

用途	HEX
主色	`#4F7EFF`
主色亮色	`#6EA8FF`
點綴	`#6EF3C5`
深色背景頂	`#1A1F36`
深色背景底	`#0E1222`
警示	`#FF6B6B`
中性灰	`#8890B0`

2.4 KiB Raw Permalink Blame History Unescape Escape

visionA Agent — Branding Assets

檔案

如何更新 logo

設計理念

色票

2.4 KiB

Raw Permalink Blame History