转码工具页面功能

2026-05-25 10:18:19 +08:00
commit 3db5fe7f13
107 changed files with 8591 additions and 0 deletions
@@ -0,0 +1,123 @@
+# Python 项目集成指南
+
+本指南说明如何将 `F:/04.python/04.python/uf2touft3` 项目与 Qt 应用程序集成。
+
+## 两个方案对比
+
+### 方案一：增强的 QProcess 方案 (推荐用于生产环境)
+
+**优点：**
+- 简单稳定，不易出错
+- 进程隔离，不会影响主应用程序
+- Python 依赖问题独立解决
+- 调试方便
+
+**缺点：**
+- 进程间通信开销
+- 无法直接共享内存
+
+**状态：已实现并集成 ✅**
+
+### 方案二：pybind11 嵌入方案 (高级选项)
+
+**优点：**
+- 更紧密的集成
+- 可以直接调用 Python 函数
+- 更好的性能
+
+**缺点：**
+- 配置复杂
+- 需要 C++ 编译环境
+- 调试困难
+- Python 全局解释器锁 (GIL) 问题
+
+**状态：提供示例代码 ⚠️**
+
+## 使用方案一 (推荐)
+
+### 1. 确保 Python 环境可用
+
+确保系统已安装 Python 3.8+，并且可以在命令行中运行：
+```bash
+python --version
+```
+
+### 2. 确保 Python 项目完整
+
+确保 `F:/04.python/04.python/uf2touft3` 目录包含所有必要文件：
+- `main.py`
+- `processCombination.py`
+- `config.ini`
+- 其他依赖的模块和配置文件
+
+### 3. 使用 Qt 应用程序
+
+直接运行编译好的 `Uft30ChangeCode.exe`，点击"开始转换"按钮即可调用 Python 代码。
+
+## 构建方案二 (高级)
+
+如果你想使用 pybind11 方案，按以下步骤：
+
+### 1. 安装依赖
+
+```bash
+pip install pybind11
+```
+
+### 2. 创建构建目录
+
+```bash
+cd python_bindings/pybind11_binding
+mkdir build
+cd build
+```
+
+### 3. 配置 CMake
+
+```bash
+cmake .. -G "MinGW Makefiles"
+# 或使用 Visual Studio
+# cmake .. -G "Visual Studio 16 2019" -A x64
+```
+
+### 4. 编译
+
+```bash
+cmake --build . --config Release
+```
+
+### 5. 集成到 Qt 项目
+
+在你的 Qt 代码中动态加载编译好的库。
+
+## Python 项目的依赖
+
+确保你的 Python 项目所需的所有依赖都已安装：
+```bash
+pip install -r requirements.txt
+```
+
+*(需要在 uf2touft3 项目中创建 requirements.txt)*
+
+## 故障排查
+
+### Python 无法启动
+- 检查 Python 是否在 PATH 中
+- 尝试设置完整的 Python 路径
+- 检查是否有多个 Python 版本
+
+### 模块导入错误
+- 确保工作目录设置正确
+- 检查所有依赖的模块是否都在 Python 路径中
+- 检查 `config.ini` 中的路径配置是否正确
+
+### 中文路径问题
+- 确保所有路径使用 UTF-8 编码
+- 避免在路径中使用特殊字符
+
+## 自定义配置
+
+如需修改 Python 脚本路径，可以编辑 `mainwindow.cpp` 中的配置：
+```cpp
+QString scriptPath = "F:/04.python/04.python/uf2touft3/main.py";
+```