fix

scripts/test_console_window_fix.md

@@ -0,0 +1,266 @@
+# 测试控制台窗口修复方案
+
+## 测试目的
+
+验证在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. ✅ 文档完整易理解
+
+---
+
+通过这个全面的测试方案，我们可以确保控制台窗口修复方案的有效性和稳定性。