jim800121/visionA
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
173 Commits 3 Branches 0 Tags
Commit Graph

9 Commits

Author SHA1 Message Date
jim800121chen
8270c4fb0e fix(local-agent): AutoOpenBrowser 預設改 false，啟動不自動開瀏覽器 
使用者：local-agent 啟動不需自動開網頁、桌面 GUI 為主。DefaultPreferences
的 AutoOpenBrowser 從 runtime.GOOS!="linux"（mac/win=true）改為所有平台 false。
只影響全新安裝（既有 preferences.json 有明確 autoOpenBrowser 值、Unmarshal
保留，尊重既有設定）。false 分支既有邏輯（SkipStage5 / 不檢查 timeout）未動。
codebase 本就無桌面「Open in Browser」按鈕（DEPRECATED、雲端 UI 遠端設計），
改預設沒弄丟任何手動能力。

reviewer 通過（0C/0M）。build/vet/test 全綠。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-08-03 12:35:10 +08:00
jim800121chen
a6c94e21c5 fix(local-agent): 重啟自動從 token.bin 讀 token，免每次重配對 
app.go 只在 env VISIONA_SESSION_TOKEN 有值時才啟動 tunnel、env 空就等 UI Pair，
從沒觸發 token.bin 的載入 → 每次重啟都要重配對。（Manager.startLocked 本來就會
從 config.TokenStore.Load，只是沒被呼叫。）

修法：抽 shouldAutoStartTunnel — env 有 token 用 env（優先序不變）；env 空則
tokenStore.Load()，有值就自動 Start（免重配對）、空/err/nil store 等 UI Pair 不擋啟動。
Unpair→Delete token.bin→重啟 Load 回空→不自動連（round-trip test 覆蓋）。

reviewer 通過（0C/0M/1m 雙Load技術債）。build/vet/test 全過 + 5 分支 + Unpair round-trip 測試。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-08-02 18:54:09 +08:00
jim800121chen
e4d27594d6 fix(local-agent): 修 camera 即時推論開不了（macOS 攝影機權限 + 假成功） 
三層疊加根因：
1. 主根因：.app 缺 NSCameraUsageDescription → macOS TCC 靜默拒絕、不彈授權
   視窗、綠燈不亮、ffmpeg avfoundation 抓不到 camera。
2. ffmpeg cmd.Start() 只要 fork 成功就回 nil → HTTP 200 假成功（攝影機沒真開）。
3. cmd.Stderr=nil 吞掉 ffmpeg 錯誤 + pipeline 靜默重試 → 極難查。

修法：
- Info.plist + Info.dev.plist 加 NSCameraUsageDescription（wails build template，
  ad-hoc 簽名下只需 usage description，刻意不加 hardened runtime/entitlement
  避免 TCC 直接拒絕）
- ffmpeg WaitForFirstFrame：收到首張完整 JPEG frame 才回成功；早退/逾時回明確
  錯誤 → camera/start 真的回非 200、前端看到真實失敗。timeout 25s（涵蓋首次
  TCC 授權彈窗的使用者反應時間；已授權情境仍秒開）
- stderr 導到有界 ringBuffer + log；pipeline camera 模式連續失敗 50 次結束

reviewer 通過（0C/0M/2m）。只動 camera 鏈路（影片/圖片/批次/tunnel 上傳不受影響）。
build/vet/test/gosec 過、4 新 camera 測試。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-08-02 03:48:30 +08:00
jim800121chen
fac07c39d0 fix(local-agent): 配對前自動 rescan USB，解序號偵測時序問題 
問題：配對時 exchange 撈 GET /api/devices（ListDevices=讀快取、不重新
偵測）。若 agent 啟動時 USB 尚未插入/未偵測到，快取為空 → 配對撈不到
序號 → payload 不帶 devices → 雲端裝置「尚未回報序號」，即便之後插上
USB 也不會自動重偵測。

修法（方案 A、最小侵入）：
- NewLocalDeviceLister 改打 POST /api/devices/scan（ScanDevices →
  Manager.Rescan() 重新偵測 USB），配對前強制重掃一次
- localDeviceListTimeout 2s → localDeviceScanTimeout 8s（真 SDK scan
  kp.core.scan_devices 較慢、給餘裕，逾時走 fallback 不卡配對）
- app.go DeviceLister 注入註解同步更新（Reviewer Mi-1）

不變量保留（Reviewer 獨立驗證）：
- rescan 失敗/逾時 → lister return nil（不 error）→ payload omit devices
  → 配對照常（序號是加值資訊，不中斷配對）
- Rescan 對序號身分未變的 session 保持連線（serialIdentity 相等 continue）、
  只斷被拔除的 → 不誤斷在線 tunnel/inference session
- Pair 由 lifecycleMu 序列化、Rescan write lock 全量重建 → 重試冪等安全

Reviewer 通過（0C/0M/1Mi/2Sug）。兩 module build/vet/test/race 全綠、
8 個新 tunnel 行為測試 PASS（端到端快取空→rescan→序號進 payload +
逾時 fallback）、gitleaks 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-16 15:02:31 +08:00
jim800121chen
26b433eb10 fix(local-agent): review follow-up 小批（TLS Mi-3/4 + WP-0 S-3/4） 
- Mi-3: insecure Transport 改用 DefaultTransport.Clone() 只覆寫 TLSConfig
  （保留 proxy/timeout，消除「開 skip 順便改掉 proxy 行為」副作用）
- Mi-4: exchange 200 分支檢查 Success 欄位（避免 200+success:false 落到
  誤導性的 missing session_token；既有回歸測試改用直接斷言防護不減反增）
- S-3: collectLocalDevices 全空 serial 濾掉不送 devices 陣列（payload 對稱）
- S-4: 假序號比對統一用 EqualFold（防未來 bridge 輸出 casing 變化）

Reviewer 通過（0C/0M/1Mi/3Sug）。兩 module build/vet/test + -race 綠、
gitleaks 0、TLS 行為級測試全 PASS。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-16 11:40:35 +08:00
jim800121chen
b9ee184586 feat(device): WP-0 序號串通 + serial 路由（ADR-018 走向 A' 第一階段） 
- local-agent/server：detector 保留 kn_number（parseScanDevices 可測化、
  合成 ID 語意不動）+ DeviceInfo.SerialNumber + Manager serialToLocalID
  反查表 + GetDevice 雙查（sessions 先、serial 後，純加法）
- visiona-agent：pairing exchange 帶本地裝置清單（DeviceLister 失敗不中斷
  配對、timeout 2s、omitempty 舊版相容）
- visionA-backend：exchange 收 devices —— R1 取第一顆可用序號、R2 假序號
  0x00000000 寫 NULL、R4 同 owner 同序號復用既有 device_id（防 23505）、
  pg+mem 兩實作對齊
- 五個 proxy 操作（flash/inference/camera/connect/disconnect）收斂於
  GetDevice 單一入口，serial 路由一處涵蓋
- docs：api-spec.md §2 增補 POST /api/pairing/exchange（schema + R1/R2/R4）
- 測試：行為級四環節鏈 + dbtest 130 實跑 6/6 + DBOn 回歸 4/4；
  三 module build/vet/test 全綠
- review：通過 0C/0M/6Mi/5Sug（.autoflow/05-implementation/review/
  wp0-serial-routing-review.md）；Minor #1 Rescan stale session 掛 WP-C 前置

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-10 09:31:51 +08:00
jim800121chen
3d30fdc580 feat(local-agent): TLS skip opt-in for self-signed stage + exchange envelope 對齊 
- 新增 VISIONA_INSECURE_SKIP_TLS_VERIFY（DEV/TEST ONLY、須明確 opt-in "true"）：
  pairing exchange HTTP client、tunnel WSS dialer、設定頁 TestConnection 三路徑
  共用 TLSConfigForDial（含 ALPN 釘 http/1.1）；NewApp 唯一 env 讀取點注入欄位
- exchangeResponse 對齊雲端 /api/pairing/exchange success envelope
  （account/relay_url 選填 fallback 保留、舊頂層格式回歸防護）
- .gitignore：.env.stage* + !.env.stage.example + *.pptx（堵 secrets 誤入）
- start-agent.sh（新增）：public 模式 export skip env + 預檢 curl https 帶 -k
- 測試：自簽 TLS server 行為級（預設拒絕驗 x509 / 開啟通過）+ opt-in 規則
  11+5 案例 + TestConnection 3 測試；go build/vet/test 3 packages 全綠
- review：2 輪通過（.autoflow/05-implementation/review/tls-skip-uncommitted-batch-review.md）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-10 09:01:10 +08:00
jim800121chen
72672972c8 chore(local-agent): 從 git 移除誤 commit 的 wails build binary（10MB Mach-O） 
3f0175f commit local-agent/ 時連帶把 wails build 出的執行檔
local-agent/visiona-agent/visiona-agent（10MB Mach-O 64-bit x86_64）
一起進 git，違反「build artifact 不進 git」原則：

- 可重新產生：source 已在 git，clone 後 wails build 即可
- 平台特定：x86_64 macOS 執行檔對其他平台無用
- repo 變胖：git history 永遠保留這 10MB

修法：
- git rm --cached（保留磁碟上檔案，下次 wails build 還會用）
- local-agent/.gitignore 補 /visiona-agent/visiona-agent 防再犯

注意：3f0175f 的 history 仍含此 binary，徹底清除需 git filter-repo
（local-only repo、未 push、暫不處理）。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-01 18:29:22 +08:00
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