# 项目素材导入功能使用指南

## 🎯 功能概述

项目素材导入功能允许用户为特定项目批量导入视频素材，支持选择模特关联、自动标签和自动分镜功能，大大提升素材管理效率。

## 🚀 功能特点

### 1. 灵活的文件选择
- **单文件/多文件选择**: 支持选择一个或多个视频文件
- **文件夹批量导入**: 选择整个文件夹进行批量导入
- **格式支持**: 支持 MP4、AVI、MOV、MKV、WMV、FLV、WebM、M4V 等主流视频格式

### 2. 智能关联功能
- **项目自动关联**: 导入的素材自动关联到当前项目
- **模特标签关联**: 可选择关联的模特，自动添加模特标签
- **项目标签**: 自动添加项目商品名作为标签

### 3. 自动分镜功能
- **智能分镜**: 自动将长视频分割成多个片段
- **场景识别**: 基于场景变化进行分镜
- **便于编辑**: 分镜后的片段更适合后续编辑使用

### 4. 标签管理
- **自定义标签**: 可添加自定义标签
- **自动标签**: 系统自动添加项目和模特相关标签
- **标签预览**: 实时预览将要添加的标签

## 📍 使用位置

在项目详情页面的素材管理区域，点击右上角的"导入素材"按钮即可打开导入功能。

## 🔧 使用步骤

### 步骤1: 打开导入功能
1. 进入项目详情页面
2. 在素材管理区域找到"导入素材"按钮
3. 点击按钮打开导入模态框

### 步骤2: 选择素材文件
有两种选择方式：

#### 方式A: 选择单个或多个文件
1. 点击"选择文件"按钮
2. 在文件选择对话框中选择视频文件
3. 支持按住Ctrl/Cmd键多选文件

#### 方式B: 选择整个文件夹
1. 点击"选择文件夹"按钮
2. 选择包含视频文件的文件夹
3. 系统会自动扫描文件夹中的所有支持格式的视频文件

### 步骤3: 配置导入选项

#### 关联模特（可选）
- 勾选要关联的模特
- 选中的模特标签会自动添加到导入的素材中
- 有助于后续按模特筛选素材

#### 添加标签（可选）
- 在标签输入框中输入自定义标签
- 按回车键或点击"+"按钮添加标签
- 可添加多个标签，点击标签上的删除按钮可移除

#### 自动分镜设置
- 默认启用自动分镜功能
- 取消勾选可禁用自动分镜
- 启用后长视频会被自动分割成多个片段

### 步骤4: 开始导入
1. 确认所有配置无误
2. 点击"开始导入"按钮
3. 等待导入完成

## 📊 导入过程

### 1. 文件验证
- 检查文件格式是否支持
- 验证文件完整性
- 过滤不支持的文件

### 2. 素材处理
- 提取视频元数据（时长、分辨率、帧率等）
- 生成MD5哈希值防重复
- 创建缩略图

### 3. 自动分镜（如果启用）
- 分析视频场景变化
- 智能确定分镜点
- 生成多个视频片段

### 4. 标签处理
- 添加项目相关标签
- 添加模特相关标签
- 添加用户自定义标签

### 5. 数据存储
- 保存素材信息到数据库
- 建立项目关联关系
- 更新素材统计

## 📋 导入结果

导入完成后会显示详细的结果信息：

### 成功信息
- **总文件数**: 尝试导入的文件总数
- **成功导入**: 成功导入的文件数量
- **生成片段**: 自动分镜生成的片段数量
- **跳过文件**: 因重复或其他原因跳过的文件
- **失败文件**: 导入失败的文件数量

### 错误信息
如果有文件导入失败，会显示具体的错误信息，包括：
- 文件名
- 失败原因
- 建议解决方案

## 🎯 最佳实践

### 1. 文件组织
- **统一命名**: 使用有意义的文件名
- **分类存放**: 按类型或用途组织文件夹
- **避免特殊字符**: 文件名避免使用特殊字符

### 2. 标签策略
- **描述性标签**: 使用描述性的标签名称
- **统一规范**: 团队内部统一标签命名规范
- **分层标签**: 使用分层的标签体系

**推荐标签示例**:
```
类型标签: 产品展示、人物介绍、场景拍摄
风格标签: 商务、休闲、时尚、科技
用途标签: 主视频、背景素材、转场素材
```

### 3. 模特关联
- **准确关联**: 确保选择正确的模特
- **完整关联**: 包含该模特的素材都应该关联
- **及时更新**: 新增模特后及时关联相关素材

### 4. 自动分镜
- **长视频启用**: 对于超过1分钟的视频建议启用
- **短视频禁用**: 对于短视频可以禁用以保持完整性
- **后期调整**: 可在导入后手动调整分镜结果

## 🔍 故障排除

### 问题1: 文件选择失败

**可能原因**:
- 文件路径包含特殊字符
- 文件被其他程序占用
- 权限不足

**解决方案**:
1. 检查文件路径，避免特殊字符
2. 关闭可能占用文件的程序
3. 确保有足够的文件访问权限

### 问题2: 导入失败

**可能原因**:
- 文件格式不支持
- 文件损坏
- 磁盘空间不足
- 网络连接问题

**解决方案**:
1. 确认文件格式在支持列表中
2. 检查文件完整性
3. 确保有足够的磁盘空间
4. 检查网络连接状态

### 问题3: 自动分镜效果不佳

**可能原因**:
- 视频场景变化不明显
- 视频质量较低
- 分镜参数不合适

**解决方案**:
1. 对于场景单一的视频可禁用自动分镜
2. 提高视频质量
3. 手动调整分镜结果

### 问题4: 标签丢失

**可能原因**:
- 导入过程中断
- 标签格式错误
- 系统异常

**解决方案**:
1. 重新导入素材
2. 检查标签格式
3. 手动添加丢失的标签

## 🚀 高级功能

### 批量操作
- 支持同时导入多个文件夹
- 支持批量设置标签和模特关联
- 支持批量启用/禁用自动分镜

### 导入模板
- 保存常用的导入配置
- 快速应用预设配置
- 团队共享导入模板

### 进度监控
- 实时显示导入进度
- 支持暂停和恢复导入
- 详细的处理日志

## 📈 性能优化

### 导入速度优化
- **小批量导入**: 避免一次导入过多文件
- **网络稳定**: 确保网络连接稳定
- **系统资源**: 确保系统有足够的内存和CPU资源

### 存储优化
- **定期清理**: 定期清理不需要的素材
- **压缩设置**: 合理设置视频压缩参数
- **分布存储**: 大量素材可考虑分布式存储

---

通过项目素材导入功能，您可以高效地管理项目素材，提升视频制作效率！
