visionA

History

jim800121chen 4902cb5531 feat(local-tool): Kneron WinUSB driver 透過 KneronPLUS SDK libwdi 安裝

根因：
  KP_ERROR_CONNECT_FAILED (error code 28) — Kneron USB 裝置預設沒綁定
  WinUSB driver，SDK 無法開 handle。原 .iss 的 pnputil /add-driver 做法
  需要 .cat 簽章（Windows 10/11 driver signing enforcement），我們沒有。

參考 edge-ai-platform/installer/platform_windows.go 的 installKneronDriverViaSDK：
  KneronPLUS SDK 內建 libwdi wrapper — kp.core.install_driver_for_windows(pid)
  libwdi 會自動用臨時自簽憑證，不需要 .cat 檔，只需要 UAC 提權。

實作：
- server/internal/api/handlers/system_driver_windows.go（新）：
  組 Python script → kp.core.install_driver_for_windows 對 KL520/KL720/KL720_LEGACY →
  PowerShell Start-Process -Verb RunAs 提權執行 → 結果寫 temp 檔讀回
- server/internal/api/handlers/system_driver_other.go（新）：非 Windows stub
- system_handler.go: NewSystemHandler 新增 pythonBin 參數 + InstallDriver handler
  先判斷 runtime.GOOS==windows 才執行
- router.go: 新增 POST /system/install-driver
- main.go: 解析 pythonBin（VISIONA_PYTHON env var → cfg.PythonBin）傳入

前端：
- frontend/src/app/devices/page.tsx：Windows only 多一個「安裝 USB Driver」按鈕
  （用 navigator.userAgent 判斷平台）
- frontend/src/stores/device-store.ts：connect 失敗訊息偵測 winusb / error 28 /
  KP_ERROR_CONNECT_FAILED 特徵字串，回一條明確的繁中提示引導使用者去點按鈕

Wails app 端：
- visiona-local/app.go: 新增 InstallKneronDriver() binding 作為備用入口（目前前端沒用到，
  因為前端跑在 http://127.0.0.1 不是 wails://，但保留給未來 splash 階段觸發用）
- visiona-local/platform_{windows,darwin,linux}.go: installKneronWinUSBDriver 平台實作
  / 跨平台 stub

.iss:
- 移除 pnputil /add-driver 的 [Run] entry（它是 silent-fail 的 dead code，
  因為沒 .cat 簽章）
- 新增註解說明：driver 安裝改由 app 端呼叫 libwdi 完成

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-12 05:25:32 +08:00

data

Initial commit: visionA monorepo with local-tool subproject

2026-04-11 22:10:38 +08:00

internal

feat(local-tool): Kneron WinUSB driver 透過 KneronPLUS SDK libwdi 安裝

2026-04-12 05:25:32 +08:00

pkg

Initial commit: visionA monorepo with local-tool subproject

2026-04-11 22:10:38 +08:00

scripts

Initial commit: visionA monorepo with local-tool subproject