# 需求分析 - 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 |
