chengnan/
├── .gitea/workflows/
│   ├── build-windows-cross-linux.yml # Linux Runner 交叉编译 Windows 发布包
│   └── build-windows-release.yml     # Windows Runner 原生构建备用工作流
├── app/
│   ├── include/                     # 头文件
│   └── src/                         # 源文件
├── CMakeLists.txt
├── .gitignore
└── README.md

构建与发布

本项目不在仓库中保存编译工具或第三方二进制依赖。所有构建工作都在 Gitea Actions 工作流中完成。

当前优先使用 .gitea/workflows/build-windows-cross-linux.yml：在自建 9950x Linux Runner 的 Fedora 41 容器中，通过 MinGW-w64 交叉编译生成 Windows x86_64 发布包。.gitea/workflows/build-windows-release.yml 保留为 Windows Runner 原生构建备用工作流。

交叉编译工作流会临时完成以下步骤：

拉取源码
安装 Fedora / MinGW-w64 构建环境和依赖
配置 CMake
编译 Release 版本
收集 Qt / OpenCV / MinGW 运行时依赖
打包 Windows 发布包
生成 SHA256 校验文件
上传发布包到 Gitea Packages

编译工具链版本

交叉编译工作流固定使用以下环境和包版本：

组件	版本
Runner 标签	`9950x`
容器镜像	`fedora:41`
C++ 语言标准	`C++17`
MinGW-w64 GCC C++	`mingw64-gcc-c++ 14.2.1-3.fc41`
CMake	`cmake 3.28.3-7.fc41`
Ninja	`ninja-build 1.12.1-3.fc41`
Qt 6 Base	`mingw64-qt6-qtbase 6.7.2-3.fc41`
OpenCV	`mingw64-opencv 4.10.0-1.fc41`

版本来源为 Fedora 41 Everything/x86_64 仓库元数据；构建时由工作流临时安装，不提交到源码仓库。

触发方式：

push 到 main
创建 v* 标签
Pull Request 到 main
手动触发 workflow_dispatch

构建产物：

chengnan-windows-x86_64-cross.zip
chengnan-windows-x86_64-cross.zip.sha256

发布包解压后，双击 chengnan.exe 运行。请保留同目录 DLL 和 Qt 插件目录，不要只复制单个 exe。

本地开发说明

仓库不提供本地依赖安装脚本，也不保存编译工具。若需要本地开发，请自行在 Windows 上安装：

CMake
Ninja
Qt 6
OpenCV
C++ 编译器（MSVC 或 MinGW）

然后按常规 CMake 项目方式配置和构建。正式发布以 Gitea Actions 产物为准。

依赖管理原则

不提交编译器、CMake、Ninja、Qt、OpenCV、MSYS2、vcpkg 等工具或 SDK
不提交 build-*、dist-*、.exe、.dll 等构建产物
第三方依赖只在工作流运行期间临时安装
发布包只作为工作流产物或 Gitea Packages 文件产出，不进入源码仓库

验收标准

可以打开常见图片格式，例如 PNG、JPG、BMP
可以保存当前处理后的图片
可以另存为指定路径
可以在同一界面中对比显示处理前和处理后图片
支持缩放、平移、旋转操作
至少实现目标提取或分类功能之一
图片显示使用 QWidget 体系，不使用 OpenCV 窗口显示函数
图像处理任务不会明显阻塞 UI
Windows 发布包可直接解压运行

README.md Unescape Escape

chengnan

项目定位

功能

技术栈

目录结构

构建与发布

编译工具链版本

本地开发说明

依赖管理原则

验收标准

README.md