mxivideo/scripts/test_console_window_fix.md

# 测试控制台窗口修复方案

## 测试目的

验证在Windows平台上打包后的Tauri应用调用Python命令时不再出现控制台窗口闪现的问题。

## 测试环境

### 系统要求
- Windows 10/11
- Python 3.8+
- Node.js 16+
- Rust 1.70+

### 测试前准备
1. 确保Python已安装并在PATH中
2. 安装项目依赖：`pnpm install`
3. 安装Rust依赖：`cargo install tauri-cli`

## 测试步骤

### 1. Debug模式测试（开发环境）

```bash
# 启动开发模式
cargo tauri dev
```

**预期行为**：
- 应用正常启动
- 调用Python命令时可以看到控制台窗口（用于调试）
- 所有功能正常工作

**测试操作**：
1. 打开AI视频页面
2. 点击"测试环境"按钮
3. 观察是否有控制台窗口出现
4. 检查功能是否正常

### 2. Release模式测试（生产环境）

```bash
# 构建生产版本
cargo tauri build
```

**预期行为**：
- 构建成功
- 生成的exe文件在`src-tauri/target/release/bundle/`目录下
- 运行时不应该看到控制台窗口闪现

**测试操作**：
1. 运行生成的exe文件
2. 打开AI视频页面
3. 点击"测试环境"按钮
4. **重点观察**：不应该看到任何控制台窗口闪现
5. 检查功能是否正常

### 3. 功能完整性测试

测试以下功能确保修复没有破坏现有功能：

#### AI视频生成
1. 上传图片
2. 设置参数
3. 生成视频
4. 检查输出

#### 项目管理
1. 创建项目
2. 打开项目文件夹
3. 导入素材

#### 模板管理
1. 导入模板
2. 批量处理

#### 文件操作
1. 选择文件
2. 打开文件夹
3. 文件预览

## 测试检查点

### ✅ 成功标准

#### Debug模式
- [ ] 应用正常启动
- [ ] Python命令执行成功
- [ ] 可以看到控制台窗口（用于调试）
- [ ] 所有功能正常工作
- [ ] 日志输出正常

#### Release模式
- [ ] 应用正常启动
- [ ] Python命令执行成功
- [ ] **不会看到控制台窗口闪现**
- [ ] 所有功能正常工作
- [ ] 用户体验流畅

### ❌ 失败标准

#### 任何模式
- [ ] 应用启动失败
- [ ] Python命令执行失败
- [ ] 功能异常或错误
- [ ] 性能明显下降

#### Release模式特有
- [ ] 仍然看到控制台窗口闪现
- [ ] 用户体验不佳

## 测试用例

### 用例1：AI视频环境测试
```
操作：点击"测试AI视频环境"按钮
预期：
- Debug: 看到控制台窗口，显示Python版本和库信息
- Release: 不看到控制台窗口，但功能正常，返回正确结果
```

### 用例2：Python脚本执行
```
操作：执行任何AI视频生成任务
预期：
- Debug: 可能看到Python进程的控制台窗口
- Release: 不看到任何控制台窗口闪现
```

### 用例3：文件系统操作
```
操作：打开文件夹或文件
预期：
- Debug: 可能看到系统命令的控制台窗口
- Release: 不看到控制台窗口，直接打开目标
```

### 用例4：批量操作
```
操作：批量导入模板或处理文件
预期：
- Debug: 可能看到多个控制台窗口
- Release: 不看到任何控制台窗口，操作流畅
```

## 性能测试

### 响应时间测试
1. 记录修复前后的操作响应时间
2. 确保没有性能回退
3. 验证用户感知性能提升

### 内存使用测试
1. 监控应用内存使用
2. 确保没有内存泄漏
3. 验证资源使用合理

## 跨平台验证

### Windows平台
- 主要测试平台
- 验证控制台窗口隐藏功能

### macOS平台
```bash
# 在macOS上测试
cargo tauri dev
cargo tauri build
```
- 确保修改不影响macOS功能
- 验证跨平台兼容性

### Linux平台
```bash
# 在Linux上测试
cargo tauri dev
cargo tauri build
```
- 确保修改不影响Linux功能
- 验证跨平台兼容性

## 回归测试

### 现有功能验证
1. 所有页面正常加载
2. 所有按钮正常响应
3. 所有API调用正常
4. 文件操作正常
5. 数据持久化正常

### 边界情况测试
1. Python未安装的情况
2. 权限不足的情况
3. 网络异常的情况
4. 文件路径异常的情况

## 测试报告模板

```
测试日期：____
测试人员：____
测试环境：Windows __ / Python __ / Node.js __

Debug模式测试结果：
- 应用启动：✅/❌
- 控制台窗口可见：✅/❌
- 功能正常：✅/❌
- 备注：____

Release模式测试结果：
- 应用启动：✅/❌
- 控制台窗口隐藏：✅/❌
- 功能正常：✅/❌
- 用户体验：✅/❌
- 备注：____

跨平台测试结果：
- macOS：✅/❌/未测试
- Linux：✅/❌/未测试
- 备注：____

总体评价：
- 修复成功：✅/❌
- 建议：____
```

## 故障排除

### 常见问题

#### 问题1：控制台窗口仍然闪现
**检查项**：
- 确认是Release模式构建
- 检查是否所有Command都使用了新的配置
- 验证Windows平台特定代码是否生效

#### 问题2：功能异常
**检查项**：
- 检查Python路径和权限
- 验证命令行参数是否正确
- 查看应用日志和错误信息

#### 问题3：编译错误
**检查项**：
- 检查Rust版本兼容性
- 验证条件编译配置
- 确认依赖项正确安装

## 验收标准

### 必须满足
1. ✅ Release模式下不出现控制台窗口闪现
2. ✅ 所有现有功能正常工作
3. ✅ 跨平台兼容性保持
4. ✅ 性能无明显下降

### 期望满足
1. ✅ 用户体验明显提升
2. ✅ Debug模式保持调试便利性
3. ✅ 代码结构清晰易维护
4. ✅ 文档完整易理解

---

通过这个全面的测试方案，我们可以确保控制台窗口修复方案的有效性和稳定性。