visionA

jim800121/visionA

Fork 0

Commit Graph

Author	SHA1	Message	Date
jim800121chen	d1ff55005a	debug(local-tool): driver install verbose 輸出 + 安裝後自我驗證 - Python script 對每個 PID install 後 capture traceback，不再 swallow - 裝完立刻 scan_devices() 驗證 SDK 能不能開 handle，印 is_connectable - 安裝結果完整寫到 server.stderr.log（而不是只回錯誤摘要） - 判斷 DONE 標記 + 至少一個 OK 才算成功這讓我們能清楚看到 libwdi 到底是「沒權限 / DLL 載入失敗 / 綁定成功但裝置 is_connectable 還是 False（代表 driver 層級 OK 但裝置需要重插）」哪一種情境，而不是只看到籠統的「error 28」。 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-12 07:38:43 +08:00
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

Author

SHA1

Message

Date

jim800121chen

d1ff55005a

debug(local-tool): driver install verbose 輸出 + 安裝後自我驗證

- Python script 對每個 PID install 後 capture traceback，不再 swallow
- 裝完立刻 scan_devices() 驗證 SDK 能不能開 handle，印 is_connectable
- 安裝結果完整寫到 server.stderr.log（而不是只回錯誤摘要）
- 判斷 DONE 標記 + 至少一個 OK 才算成功

這讓我們能清楚看到 libwdi 到底是「沒權限 / DLL 載入失敗 / 綁定成功但
裝置 is_connectable 還是 False（代表 driver 層級 OK 但裝置需要重插）」
哪一種情境，而不是只看到籠統的「error 28」。

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

2026-04-12 07:38:43 +08:00

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

2 Commits