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模式测试（开发环境）

# 启动开发模式
cargo tauri dev

预期行为：

• 应用正常启动
• 调用Python命令时可以看到控制台窗口（用于调试）
• 所有功能正常工作

测试操作：

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

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

# 构建生产版本
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平台

# 在macOS上测试
cargo tauri dev
cargo tauri build

• 确保修改不影响macOS功能
• 验证跨平台兼容性

Linux平台

# 在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. ✅ 文档完整易理解

---

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