jim800121chen
67737334c8
問題：連線後裝置詳情頁連線狀態顯示 unknown、載入模型按鈕永遠 disabled。
根因=雲端 GET /api/devices/:id 是純 DB 讀、沒 proxy 到 local agent → DB 只有
tunnel 層 status（online/offline/unknown）、沒有 driver 七態（detected/
connected/...）→ 前端 gate isDriverConnected 永遠 false。（上輪 C1/C5 查證
假設 status 拿得到、沒追到寫入點的漏洞）
修法（方案 Y-2、local agent 零改、gate 零改）：
- backend device_driver_status.go（新）：driverStatusFetcher 介面 +
forwarderDriverStatusFetcher（走既有 session.Forwarder proxy）+ envelope 解析
- devices.go devicesGetHandler：讀 DB metadata 後，device 有序號時額外 proxy
打 local agent GET /api/devices/{serial}（serial 路由對齊 WP-C）拿即時 driver
status 覆蓋 USBStatus；remoteStatus/tunnel_online 保留（offline banner 不壞）
- graceful fallback（全回 200 不掛 500）：無序號/tunnel 離線/不可達/timeout/
非2xx/success:false/空status/Forwarder未配置 → 保留 DB status + Debug log
- 2s 短 timeout（不拖詳情頁）、serial path url.PathEscape 防禦
- frontend：DeviceHardwareStatus 加 unknown + coerceHardwareStatus（非七值→
unknown）+ normalizeDevice fallback disconnected→unknown（修誤顯未連接）+
i18n devices.status.unknown 兩語系（未確認/Unknown）
Reviewer 通過（0C/0M/3Mi/2Sug、Y-2 10/10、端到端追證 gate 放行 + 8 fallback
分支無一掛 500）。backend 8 測試 + frontend 49 passed、build/vet/test 綠、
gitleaks 0。端到端「即時 connected 覆蓋 unknown」需在線 agent+登入實測（單元
測試已覆蓋合併+fallback）。
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（內部使用）