20260429_231526-fix: upload field mismatch, WebSocket StrictMode crash, project list refresh after upload

工程分析/实现方案-20260429_231526.md

@@ -0,0 +1,26 @@
+# 实现方案 — 2026-04-28
+
+## R1/R2 — uploadMedia 字段修复
+**文件**: `src/lib/api.ts`
+**变更**: 
+- 解构 `response.data` 的 `file_url`、`object_name` 字段
+- 返回 `{ url: file_url, id: object_name }` 以兼容前端既有接口
+
+## R3 — 上传后刷新项目列表
+**文件**: `src/components/ProjectLibrary.tsx`
+**变更**: 
+- `uploadMedia()` resolve 后调用 `getProjects()` 并 `setProjects()` 写入 Zustand
+- 失败时 alert 并打印错误
+
+## R4 — WebSocket disconnect 崩溃修复
+**文件**: `src/lib/websocket.ts`
+**变更**: 
+- `disconnect()` 中仅当 `this.ws.readyState === WebSocket.OPEN` 时才调用 `.close()`
+- 否则直接置空引用，避免对 CONNECTING 套接字调用 close
+
+## R5 — StrictMode 竞态防护
+**文件**: `src/components/Dashboard.tsx`
+**变更**: 
+- 增加 `mounted` ref，cleanup 时置 `false`
+- `onProgress` callback 与 `setInterval` callback 均检查 `mounted`
+- 增加 500ms 延迟连接，避免 mount/unmount 过快时创建无意义连接