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

62 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 多解析度 ICO16/24/32/48/64/96/128/256PNG-in-ICO 格式) |
| `icon.icns` | macOS .app bundle icon |
## 如何更新 logo
1.`logo.svg` 或改 `gen_icon.go` 的繪圖函數
2.`go run gen_icon.go <output-dir>` 產出各尺寸 PNG
3.`go run gen_ico.go icon.ico <png-dir> 16,24,32,48,64,96,128,256` 產 Windows ICO
4. macOS icns 用 `iconutil`
```bash
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
```
5. 部署:
- `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
6. 重 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` |