2026-04-29-22-49-38 - 修复WebSocket连接+项目状态异常+导入按钮无响应+后端WS路由

工程分析/需求分析-2026-04-29-22-49-38.md

@@ -0,0 +1,48 @@
+# 需求分析 - 2026-04-29-22-49-38
+
+## 需求来源
+- 提出时间: 2026-04-29-22-49-38
+- 需求类型: 缺陷修复
+
+## 原始需求描述
+1. 项目库中视频显示"异常"，且无法点击导入多媒体资源
+2. 控制台 WebSocket 报错：
+   - `WebSocket connection to 'ws://localhost:8000/ws/progress' failed`
+   - `WebSocket is closed before the connection is established`
+
+## 需求拆解
+
+### 需求 1: 修复 WebSocket URL（localhost → IP）
+- **详细描述**: `websocket.ts` 硬编码 `ws://localhost:8000/ws/progress`，浏览器解析为客户端本地地址导致连接失败
+- **优先级**: P0-阻塞
+- **影响范围**: `src/lib/websocket.ts`
+- **验收标准**: WebSocket 连接到服务器实际 IP
+
+### 需求 2: 后端添加 WebSocket 路由
+- **详细描述**: FastAPI 后端未实现 `/ws/progress` WebSocket endpoint，前端连接被拒绝
+- **优先级**: P0-阻塞
+- **影响范围**: `backend/main.py`
+- **验收标准**: 后端接受 WebSocket 连接，可推送解析进度消息
+
+### 需求 3: 修复"导入多媒体资源"按钮点击
+- **详细描述**: `ProjectLibrary.tsx` 中按钮为纯静态 UI，无 `onClick` 事件和文件输入框
+- **优先级**: P0-阻塞
+- **影响范围**: `src/components/ProjectLibrary.tsx`
+- **验收标准**: 点击按钮弹出文件选择器，可选择视频/图片文件
+
+### 需求 4: 修复项目状态显示"异常"
+- **详细描述**: 后端数据库项目默认状态为 `'pending'`，前端只识别 `'Ready'` 和 `'Parsing'`，其他状态均显示"异常"
+- **优先级**: P0-阻塞
+- **影响范围**: `backend/models.py` 或 `src/components/ProjectLibrary.tsx`
+- **验收标准**: 新建项目默认显示正确状态（非"异常"）
+
+## 约束条件
+- 保持中文界面
+- 最小修改原则
+- 不破坏现有 API 契约
+
+## 风险评估
+| 风险点 | 影响 | 缓解措施 |
+|--------|------|----------|
+| WebSocket 实现复杂度高 | 中 | 先实现基础连接和心跳，进度推送后续完善 |
+| 文件上传无后端对接 | 低 | 前端先实现文件选择器，调用已有 uploadMedia API |