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

91 lines
2.7 KiB
Go

package driver
import "time"
type DeviceDriver interface {
Info() DeviceInfo
Connect() error
Disconnect() error
IsConnected() bool
Flash(modelPath string, progressCh chan<- FlashProgress) error
StartInference() error
StopInference() error
ReadInference() (*InferenceResult, error)
RunInference(imageData []byte) (*InferenceResult, error)
GetModelInfo() (*ModelInfo, error)
}
type DeviceInfo struct {
ID string `json:"id"`
Name string `json:"name"`
Type string `json:"type"`
Port string `json:"port"`
VendorID uint16 `json:"vendorId,omitempty"`
ProductID uint16 `json:"productId,omitempty"`
Status DeviceStatus `json:"status"`
FirmwareVer string `json:"firmwareVersion,omitempty"`
FlashedModel string `json:"flashedModel,omitempty"`
}
type DeviceStatus string
const (
StatusDetected DeviceStatus = "detected"
StatusConnecting DeviceStatus = "connecting"
StatusConnected DeviceStatus = "connected"
StatusFlashing DeviceStatus = "flashing"
StatusInferencing DeviceStatus = "inferencing"
StatusError DeviceStatus = "error"
StatusDisconnected DeviceStatus = "disconnected"
)
type FlashProgress struct {
Percent int `json:"percent"`
Stage string `json:"stage"`
Message string `json:"message,omitempty"`
Error string `json:"error,omitempty"`
}
type InferenceResult struct {
DeviceID string `json:"deviceId,omitempty"`
ModelID string `json:"modelId,omitempty"`
TaskType string `json:"taskType"`
Timestamp int64 `json:"timestamp"`
LatencyMs float64 `json:"latencyMs"`
Classifications []ClassResult `json:"classifications,omitempty"`
Detections []DetectionResult `json:"detections,omitempty"`
// Batch image fields (omitted for single-image/camera/video modes)
ImageIndex int `json:"imageIndex,omitempty"`
TotalImages int `json:"totalImages,omitempty"`
Filename string `json:"filename,omitempty"`
// Video progress fields (omitted for non-video modes)
FrameIndex int `json:"frameIndex,omitempty"`
TotalFrames int `json:"totalFrames,omitempty"`
}
type ClassResult struct {
Label string `json:"label"`
Confidence float64 `json:"confidence"`
}
type DetectionResult struct {
Label string `json:"label"`
Confidence float64 `json:"confidence"`
BBox BBox `json:"bbox"`
}
type BBox struct {
X float64 `json:"x"`
Y float64 `json:"y"`
Width float64 `json:"width"`
Height float64 `json:"height"`
}
type ModelInfo struct {
ID string `json:"id"`
Name string `json:"name"`
LoadedAt time.Time `json:"loadedAt"`
}