jim800121chen
d7b5a2398a
A 階段第一個 milestone、純 bridge.py 層 + ctypes 直接呼叫 KneronPLUS C symbol。
Source:
- server/scripts/kneron_bridge.py: 1207 → 2058 行（+851）
- server/scripts/test_kneron_bridge_firmware.py: 新檔 840 行、36 unit tests 全綠 0.076s
Firmware bundled:
- server/scripts/firmware/KL520/fw_loader.bin（90112 bytes、MD5 aef7cca17bc023abbd6152c46c18e774、與 warrenchen 一致）
- server/scripts/firmware/{KL520,KL720}/VERSION（v2.2.0）
實作對齊 TDD §6.1 規格（98% 對齊度）：
- handler input/output schema 100%
- stage enum: preparing/loading/flashing/verifying/done/error（採 Design 命名）
- reason enum 7/8（disconnect_during_op 留 M9-5 實機測試）
- ctypes binding 1:1 對齊 warrenchen legacy_plus121_runner.py
- 4 個情境 stage 序列驗證通過（KL520 KDP1+loader / KL520 KDP1 缺 loader / KL720 legacy / 已 KDP2）
- timeout 60s/200s、USB stable 5-8s wait、SIGTERM 拒絕邏輯
- progress event schema 完整（percent/stage/message/elapsed_ms/eta_ms/extra）
Reviewer 兩輪審查：
- 第 1 輪：0 Critical / 3 Major / 4 Minor / 4 Suggestion
- 第 2 輪：通過 with 1 Minor + 1 Suggestion（m5 test 死碼 / s5 test 註解、留 M9-2 順手清）
- M3 firmware 字串覆蓋從 substring → 顯式 enumeration + KDP3+ forward-compat（防未來 brick 風險）
- M2 控制流重構（needs_loader/should_run_loader_stage/loader_required_but_missing 三個顯式 bool）
- m3 single-owner disconnect 原則完整落地
既有 6 個 handler（scan/connect/disconnect/reset/load_model/inference）零改動、無 spillover risk。
下一步：M9-2 Go driver UpgradeFirmware + firmware/service.go
Co-Authored-By: Claude Opus 4.7 (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（內部使用）