jim800121chen
34bc361527
上一個 commit 讓 Windows 完全開不了：階段 2 直接失敗， 「python runtime unavailable: no python runtime available」。 根因：健康檢查的 probe 環境與實際跑推論的環境不一致。 `import kp` 在 import 當下就要載入 6 個 native DLL（libkplus / libusb / libwdi 等），這些不在 Windows 預設搜尋路徑。專案裡每一處真正用 kp 的地方 都自己補了路徑（kl720_driver.go:142 注入 PATH、platform_windows.go:68 用 add_dll_directory），只有新加的 probe 是裸跑 python -c "import kp"。 於是健康的 venv 被判成壞掉 → 重裝 wheels → 用同一個壞 probe 再驗一次 → 仍失敗 → 回 error → 連 app 都進不去。使用者前一天才手動重建好、推論正常 的環境，裝上新版就完全無法啟動。 修正： - reuseExistingVenv 不回傳 error。venv 存在時的回傳值恆等於舊版 （永遠是 pythonBin, nil），要退化成阻斷版必須改簽章，不會不小心發生 - 首次安裝路徑區分致命與非致命：pip 真的失敗才算致命，probe 沒過就放行 並記 warning - probe 在 import 前補上 DLL 搜尋路徑，對齊 kl720_driver.go 的實際做法 - 新增 GetPythonDepsWarning binding，讓提示出現在 app 內而非啟動阻斷點 原本要解的「wheels 半套安裝永久卡住」仍然有解，但改為非阻斷：修不好也讓 使用者進到 app 看見具體原因，而不是擋在啟動畫面外。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
visionA
Innovedus visionA monorepo — Edge AI 開發平台（離線版 + 雲端版）。
開發環境快速啟動
make dev-up # 起 backend + Member Center（OIDC）+ Postgres
make frontend-dev # 另開 terminal：起 frontend dev server（pnpm dev）
# 開瀏覽器 http://localhost:3000
完整流程（含 OAuth client 手動註冊、port 對照、疑難排解）見 docs/DEV-SETUP.md。
其他 target：make help。
子專案
| 專案 | 角色 | 狀態 |
|---|---|---|
local-tool/ |
離線版 桌面工具（Wails + Go + Next.js） | 穩定維護 |
visionA-frontend/ |
雲端版 web 前端（Next.js） | ✅ Phase 0 雛形 |
visionA-backend/ |
雲端版後端（Go，雙 binary：api-server + remote-proxy） | ✅ Phase 0 雛形 |
local-agent/ |
visionA Agent — 雲端版 local 端代理（Wails + Go + Next.js） | ✅ Phase 0.5 雛形 |
架構關係
離線模式（local-tool 單獨）
使用者瀏覽器 → localhost:3721 (local-tool server) → Kneron 裝置
雲端模式（visionA 雲端版 + visionA Agent）
使用者瀏覽器 → visionA-frontend (CDN) → visionA-backend (api-server)
↓ internal HTTP
visionA-backend (remote-proxy)
↓ WebSocket + yamux tunnel
使用者電腦上的 visionA Agent
↓ 本機 HTTP
Agent 的內部 server → Kneron 裝置
兩種模式可在同一台電腦共存（local-tool 和 visionA Agent 獨立安裝、不衝突）。
產品線原則
- local-tool 不動，需要時 fork
- 雲端 vs 本機差異只在前端部署位置
- 雲端 agent 的 server ≈ local-tool 的 server（差別在沒本機操作 UI）
- 雲端 web UI 先抄 local-tool，之後再加新功能
文件
完整產品文件見 .autoflow/：
- 產品需求：
.autoflow/02-prd/PRD.md - 設計規格：
.autoflow/03-design/design-spec.md - 架構總覽：
.autoflow/04-architecture/design-doc.md - 交付總結：
.autoflow/07-delivery/project-summary.md
License
TBD（內部使用）