# 投稿上传功能 v2.0 实现指南

## 概述

基于 [biliup-rs](https://github.com/biliup/biliup-rs) 项目的实现思路，我们重新开发了B站投稿上传功能，支持多种上传线路、智能线路选择和完整的错误处理。

## 新功能特性

### 🚀 核心功能
- **多种上传线路**: 支持 bda2、qn、alia、bldsa、tx、txa、bda 等线路
- **智能线路选择**: 自动测速选择最佳上传线路
- **分片上传**: 支持大文件分片上传，提高稳定性
- **完整错误处理**: 详细的错误信息和重试机制
- **进度跟踪**: 实时上传进度和状态更新

### 🔧 技术改进
- **基于 biliup-rs**: 借鉴成熟的实现方案
- **异步处理**: 完整的异步上传流程
- **Cookie管理**: 修复了加密系统，支持正确的密钥格式
- **API兼容**: 与现有系统完全兼容

## 实现架构

### 文件结构
```
backend/services/
├── bilibili_service.py          # 原有服务（已更新）
├── bilibili_upload_v2.py        # 新的v2.0上传实现
└── bilibili_service_backup.py   # 备份文件
```

### 核心类
- `BilibiliUploaderV2`: 核心上传器，处理具体的上传逻辑
- `BilibiliUploadServiceV2`: 上传服务，管理上传流程和状态

## 使用步骤

### 1. 重新导入Cookie

由于加密系统已更新，需要重新导入B站Cookie：

1. **获取Cookie**:
   - 登录B站网页版
   - 打开开发者工具 (F12)
   - 在Network标签页中找到任意请求
   - 复制Cookie值

2. **导入Cookie**:
   - 访问投稿状态页面: `http://localhost:3000/upload-status`
   - 点击"投稿状态"按钮进入B站管理
   - 在"账号管理"标签页中点击"添加账号"
   - 选择"Cookie登录"方式
   - 粘贴完整的Cookie字符串

### 2. 测试上传功能

1. **检查账号状态**:
   - 确保账号状态显示为"活跃"
   - 检查Cookie是否有效

2. **创建投稿任务**:
   - 在项目详情页选择视频切片
   - 点击"投稿到B站"按钮
   - 填写标题、描述、标签等信息
   - 选择投稿账号和分区

3. **监控上传进度**:
   - 在投稿状态页面查看任务进度
   - 实时监控上传状态和错误信息

## 技术细节

### 上传流程
```
1. 验证登录状态 → 2. 预上传获取ID → 3. 选择最佳线路
    ↓
4. 分片上传 → 5. 合并分片 → 6. 提交投稿 → 7. 返回BV号
```

### 上传线路
| 线路 | 提供商 | 特点 |
|------|--------|------|
| bda2 | 百度云 | 默认线路，稳定性好 |
| qn | 七牛 | 速度快 |
| alia | 阿里云海外 | 海外访问优化 |
| bldsa | B站自建 | 官方线路 |
| tx | 腾讯云 | 国内优化 |
| txa | 腾讯云海外 | 海外优化 |
| bda | 百度云海外 | 海外优化 |

### 错误处理
- **网络错误**: 自动重试，最多3次
- **认证错误**: 提示重新登录
- **文件错误**: 检查文件格式和大小
- **API错误**: 详细错误信息显示

## 配置说明

### 环境变量
```bash
# 加密密钥（已自动生成）
export ENCRYPTION_KEY="BekpMhcsOolyI_n9Hz9NxzLqMgll3vfa9qJYPOxtQXM="
```

### 上传参数
```python
metadata = {
    'title': '视频标题',           # 最大80字符
    'description': '视频描述',     # 最大2000字符
    'tags': ['标签1', '标签2'],   # 标签列表
    'partition_id': 3             # 分区ID
}
```

## 故障排除

### 常见问题

1. **Cookie解密失败**
   - 原因: 使用了旧的加密密钥
   - 解决: 重新导入Cookie

2. **上传失败**
   - 原因: 网络问题或API限制
   - 解决: 检查网络连接，尝试不同线路

3. **文件过大**
   - 原因: 超过B站8GB限制
   - 解决: 压缩视频或分割文件

4. **账号状态异常**
   - 原因: Cookie过期或无效
   - 解决: 重新登录获取新Cookie

### 调试方法

1. **查看日志**:
   ```bash
   tail -f logs/celery.log
   ```

2. **检查数据库**:
   ```sql
   SELECT * FROM bilibili_upload_records ORDER BY created_at DESC LIMIT 5;
   ```

3. **测试API**:
   ```bash
   curl -s http://localhost:8000/api/v1/upload/records | jq .
   ```

## 性能优化

### 上传速度优化
- **并发上传**: 支持多分片并发上传
- **线路选择**: 自动选择最快线路
- **重试机制**: 智能重试失败的分片

### 稳定性优化
- **错误恢复**: 自动处理网络中断
- **状态同步**: 实时更新上传状态
- **数据完整性**: 确保文件完整上传

## 更新日志

### v2.0.0 (2025-09-11)
- ✅ 基于 biliup-rs 重新实现上传功能
- ✅ 支持多种上传线路和智能选择
- ✅ 修复Cookie加密系统
- ✅ 完善错误处理和重试机制
- ✅ 添加详细的上传进度跟踪

### 后续计划
- 🔄 支持多P投稿
- 🔄 添加上传队列管理
- 🔄 实现断点续传
- 🔄 支持批量投稿

## 相关链接

- [biliup-rs 项目](https://github.com/biliup/biliup-rs)
- [B站投稿API文档](https://github.com/biliup/biliup-rs)
- [投稿状态页面使用指南](./UPLOAD_STATUS_PAGE_GUIDE.md)