# 批量视频工具

**Repository Path**: nan1314/batch-video-tool

## Basic Information

- **Project Name**: 批量视频工具
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-03
- **Last Updated**: 2026-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 批量视频生成器

一个基于WPF的批量视频处理工具，使用FFmpeg进行视频编辑和合成。

## 功能特性

- ✅ 批量扫描项目文件夹
- ✅ 自动识别视频文件（支持 mp4, avi, mov, mkv, flv, wmv, m4v）
- ✅ 识别Markdown文档
- ✅ 多种视频处理模板
  - 模板1: 标准拼接
  - 模板2: 淡入淡出效果
  - 模板3: 分屏效果
  - 模板4: 自定义
- ✅ 实时处理日志显示
- ✅ 进度条显示

## 系统要求

- Windows 10/11
- **.NET 8 Desktop Runtime（Windows x64）**
- ✅ FFmpeg 已内置在项目中，无需单独安装/配置环境变量

## 安装与运行（推荐：直接运行 EXE）

### 1) 安装 .NET 8 运行时

本项目是 WPF 桌面程序，建议安装 **.NET 8 Desktop Runtime**。

1. 打开（微软官方）：https://dotnet.microsoft.com/zh-cn/download/dotnet/8.0/runtime
2. 在页面中选择 **“.NET Desktop Runtime”**，并下载与你系统匹配的版本（通常是 **Windows x64**）
3. 安装完成后，可用下面命令验证：
   ```powershell
   dotnet --info
   ```
   能看到 `.NET` 版本信息即说明安装成功。

### 2) 启动程序

你可以直接运行编译产物（无需 Visual Studio）：

- Release：`bin/Release/net8.0-windows/BatchVideoGenerator.exe`
- Debug：`bin/Debug/net8.0-windows/BatchVideoGenerator.exe`

如果双击没有反应/闪退，优先检查是否已安装 **.NET 8 Desktop Runtime**。

## 使用方法

### A. 从界面批量生成（本地素材模式）

1. **启动程序**：双击运行 `BatchVideoGenerator.exe`（见上文路径）

2. **选择素材文件夹**
   - 点击"浏览..."按钮选择包含项目文件夹的根目录
   - 项目文件夹结构示例:
     ```
     素材文件夹/
     ├── 项目1/
     │   ├── video1.mp4
     │   ├── video2.mp4
     │   └── readme.md
     ├── 项目2/
     │   ├── clip1.mp4
     │   └── info.md
     └── 项目3/
         └── output.mp4
     ```

3. **选择输出文件夹**
   - 点击"浏览..."按钮选择视频输出目录

4. **选择视频模板**
   - 从下拉菜单中选择处理模板

5. **开始批量生成**
   - 点击"开始批量生成"按钮
   - 查看处理日志和进度

### B. 公众号 URL 模式（需要 DeepSeek Key）

如果你使用的是“公众号 URL 模式”（程序会从文章/Markdown 中提炼字段，并识别成品视频 URL），则必须配置 DeepSeek API Key。

## DeepSeek（可选）

### 1) 这个 Key 用来做什么？

程序会调用 DeepSeek 的 Chat Completions 接口：

- Endpoint：`https://api.deepseek.com/chat/completions`
- Model：`deepseek-chat`
- 作用：从 Markdown/文本中“按模板所需字段”提炼内容，并在需要时返回 `视频URL`（JSON 数组）

### 2) 如何申请 DeepSeek API Key

DeepSeek 的控制台/入口可能会更新；下面给的是通用流程（以其官方开放平台为准）：

1. 打开 DeepSeek 官方开放平台/控制台（搜索“DeepSeek 开放平台”进入官方站点）
2. 注册/登录账号
3. 进入 **API Keys / 密钥管理**（名称可能略有差异）
4. 新建一个 Key（建议命名如：`BatchVideoGenerator`）
5. 复制 Key（通常只在创建时完整展示一次）
6. 如果控制台要求开通计费/充值额度，按其提示完成（否则可能会 402/余额不足/调用被拒绝）

### 3) 如何在本软件里配置

1. 打开程序
2. 在主界面找到：`DeepSeek（可选） -> API Key`
3. 粘贴你的 Key（界面不会把 Key 打到日志里）
4. 程序会自动保存到本机：
   - `%AppData%\BatchVideoGenerator\settings.json`

安全提示：不要把 `settings.json` 或 Key 提交到仓库/发给他人。

程序运行时会强制使用 UI 输入的 Key，并自动保存到：

- `%AppData%\\BatchVideoGenerator\\settings.json`

### 4) 常见问题排查

- **提示必须填写 Key / URL 模式无法继续**：这是预期行为；公众号 URL 模式需要用 DeepSeek 提炼字段与识别成品视频链接。
- **401/403（鉴权失败）**：Key 填错/过期/无权限，重新生成并粘贴。
- **402/余额不足**：到 DeepSeek 控制台开通计费或充值后再试。
- **超时/网络错误**：检查是否能访问 `https://api.deepseek.com`（公司网络/代理/防火墙可能拦截）。

## 构建项目

```powershell
# 还原依赖
dotnet restore

# 编译项目
dotnet build

# 运行项目
dotnet run

# 发布项目
dotnet publish -c Release -r win-x64 --self-contained
```

## 从源码运行（开发者）

如果你要修改代码并运行：

```powershell
dotnet restore
dotnet run
```

## 项目结构

```
BatchVideoGenerator/
├── Models/
│   └── ProjectFolder.cs          # 项目文件夹数据模型
├── Services/
│   ├── FFmpegService.cs          # FFmpeg视频处理服务
│   └── ProjectScanner.cs         # 项目文件夹扫描服务
├── App.xaml                      # 应用程序定义
├── App.xaml.cs                   # 应用程序代码
├── MainWindow.xaml               # 主窗口界面
├── MainWindow.xaml.cs            # 主窗口代码
└── BatchVideoGenerator.csproj    # 项目文件
```

## 技术栈

- **框架**: WPF (.NET 8.0)
- **视频处理**: FFmpeg
- **语言**: C# 12

## 注意事项

1. FFmpeg 已内置，正常情况下无需额外安装/配置环境变量
2. 素材文件夹中的子文件夹会被识别为独立项目
3. 每个项目至少需要包含一个视频文件才会被处理
4. 视频文件会按文件名自然排序后进行拼接
5. 输出的视频文件名与项目文件夹名相同

## 许可证

MIT License

## 贡献

欢迎提交问题和拉取请求！