refactor(packaging): 重构 Windows 打包工具和配置文件

将 Windows 打包相关的文件移动到 packaging/windows 目录，包括 build_app.py、build.bat、PyMeshGen.spec 和 PyMeshGen.iss。更新相关文档和引用路径，优化打包脚本功能并添加中文支持。

主要变更：
- 移动打包文件到新目录
- 更新 README 文档中的路径说明
- 增强 build_app.py 功能并添加中文支持
- 添加新的 build.bat 一键打包脚本
- 更新 spec 和 iss 配置文件

Author: cfd-dev

.github/copilot-instructions.md

@@ -10,7 +10,7 @@
 - Run a named test module: `cd unittests; python run_tests.py cas_file_io`
 - Run one unittest target from repo root: `python -m unittest unittests.test_bowyer_watson.TestBowyerWatsonJSONConfig.test_anw_bowyer_watson`
 - Build source and wheel distributions: `python -m pip install build && python -m build`
-- Preferred distribution path is Python packaging to PyPI; `build_app.py` is only for optional Windows desktop packaging
+- Preferred distribution path is Python packaging to PyPI; `packaging/windows/build_app.py` is only for optional Windows desktop packaging
 - There is no repo-root lint configuration checked in; do not invent Ruff/Flake8/Pylint commands. Prefer the existing unittest scripts and focused unittest targets.
 
 ## High-level architecture

MANIFEST.in

@@ -3,10 +3,6 @@ include VERSION
 include README.md
 include README_zh.md
 include README_PACKAGING.md
-include PyMeshGen.spec
-include PyMeshGen.iss
-include build.bat
-include build_app.py
 graft config
 graft docs
 graft 3rd_party/meshio/src

README.md

@@ -153,7 +153,7 @@ python -m pip install build
 python -m build
 ```
 
-For PyPI publishing and release workflow details, see [`README_PACKAGING.md`](./README_PACKAGING.md). Windows executable packaging remains available as an optional secondary path.
+For PyPI publishing and release workflow details, see [`README_PACKAGING.md`](./README_PACKAGING.md). Optional Windows desktop packaging tools now live under `packaging/windows/`.
 
 ## License
 

README_PACKAGING.md

@@ -111,8 +111,8 @@ GUI usage still depends on GUI/runtime dependencies such as `PyQt5`, `vtk`, and
 Windows executable packaging is still available, but it is no longer the primary distribution mechanism.
 
 ```bash
-python build_app.py
-python build_app.py --all
+python packaging\windows\build_app.py
+python packaging\windows\build_app.py --all
 ```
 
 Typical outputs:
@@ -124,3 +124,16 @@ Typical outputs:
 | Windows installer | `installer/PyMeshGen-Setup-*.exe` |
 
 This path depends on a fully prepared local Python environment plus PyInstaller, and is best treated as an optional desktop-delivery workflow rather than the main release channel.
+
+The optional Windows packaging files now live under `packaging/windows/`:
+
+- `packaging/windows/build_app.py`
+- `packaging/windows/build.bat`
+- `packaging/windows/PyMeshGen.spec`
+- `packaging/windows/PyMeshGen.iss`
+
+You can also invoke the optional Windows wrapper directly:
+
+```bash
+packaging\windows\build.bat
+```

PyMeshGen.iss packaging/windows/PyMeshGen.issPyMeshGen.iss renamed to packaging/windows/PyMeshGen.iss

@@ -2,11 +2,12 @@
 ; PyMeshGen Inno Setup 安装脚本
 ; ============================================================================
 ; 使用方法:
-;   1. 先运行 build.bat 构建可执行文件
+;   1. 先运行 packaging\windows\build.bat 构建可执行文件
 ;   2. 安装 Inno Setup: https://jrsoftware.org/isdl.php
-;   3. 运行: iscc.exe PyMeshGen.iss
+;   3. 运行: iscc.exe packaging\windows\PyMeshGen.iss
 ; ============================================================================
 
+#define RepoRoot "..\.."
 #define MyAppName "PyMeshGen"
 #define MyAppVersion "1.0.0"
 #define MyAppPublisher "PyMeshGen Team"
@@ -25,10 +26,10 @@ AppUpdatesURL={#MyAppURL}
 DefaultDirName={autopf}\{#MyAppName}
 DefaultGroupName={#MyAppName}
 AllowNoIcons=yes
-LicenseFile=LICENSE.txt
-OutputDir=installer
+LicenseFile={#RepoRoot}\LICENSE.txt
+OutputDir={#RepoRoot}\installer
 OutputBaseFilename=PyMeshGen-Setup-{#MyAppVersion}
-SetupIconFile=docs\icon.ico
+SetupIconFile={#RepoRoot}\docs\icon.ico
 UninstallDisplayIcon={app}\{#MyAppExeName}
 Compression=lzma
 SolidCompression=yes
@@ -49,8 +50,8 @@ Name: "quicklaunchicon"; Description: "{cm:CreateQuickLaunchIcon}"; GroupDescrip
 
 [Files]
 ; 主程序文件
-Source: "dist\{#MyAppExeName}"; DestDir: "{app}"; Flags: ignoreversion
-Source: "dist\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs createallsubdirs
+Source: "{#RepoRoot}\dist\{#MyAppExeName}"; DestDir: "{app}"; Flags: ignoreversion
+Source: "{#RepoRoot}\dist\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs createallsubdirs
 
 ; 注意：不要复制以下目录，它们已经包含在 dist 中
 ; Source: "config\*"; DestDir: "{app}\config"; Flags: ignoreversion recursesubdirs createallsubdirs

PyMeshGen.spec packaging/windows/PyMeshGen.specPyMeshGen.spec renamed to packaging/windows/PyMeshGen.spec

@@ -4,7 +4,7 @@ PyMeshGen PyInstaller 打包配置文件
 用于生成 PyMeshGen GUI 应用程序的独立可执行文件
 
 使用方法:
-    pyinstaller PyMeshGen.spec
+    pyinstaller packaging\windows\PyMeshGen.spec
 """
 
 import os
@@ -13,7 +13,8 @@ from PyInstaller.utils.hooks import collect_submodules, collect_data_files, coll
 
 # 项目根目录
 block_cipher = None
-project_root = os.path.dirname(os.path.abspath(SPEC))
+spec_root = os.path.dirname(os.path.abspath(SPEC))
+project_root = os.path.abspath(os.path.join(spec_root, "..", ".."))
 
 # 核心依赖 - 只收集必要的模块
 hiddenimports = [

build.bat packaging/windows/build.batbuild.bat renamed to packaging/windows/build.bat

@@ -1,4 +1,5 @@
 @echo off
+pushd "%~dp0"
 REM ============================================================================
 REM PyMeshGen 一键打包工具 (Windows)
 REM ============================================================================
@@ -62,6 +63,7 @@ echo.
 python build_app.py %ARGS%
 
 if errorlevel 1 (
+    popd
     echo.
     echo ============================================================================
     echo [错误] 打包失败！请检查错误信息。
@@ -76,7 +78,7 @@ echo 打包完成！
 echo ============================================================================
 echo.
 pause
-
+popd
 goto :eof
 
 :help
@@ -108,4 +110,5 @@ echo   安装包：installer\PyMeshGen-Setup-*.exe
 echo   ZIP 包：releases\PyMeshGen-v*.zip
 echo.
 echo ============================================================================
+popd
 goto :eof

build_app.py packaging/windows/build_app.pybuild_app.py renamed to packaging/windows/build_app.py

@@ -11,7 +11,7 @@
     - 可选：创建便携版 ZIP 压缩包
 
 使用方法:
-    python build_app.py [--clean] [--debug] [--installer] [--zip]
+    python packaging\\windows\\build_app.py [--clean] [--debug] [--installer] [--zip]
 
 参数:
     --clean       清理之前的构建文件
@@ -43,7 +43,7 @@ class Config:
     BIN_DIR = "bin"
     INSTALLER_DIR = "installer"
     ZIP_DIR = "releases"
-    SPEC_FILE = "PyMeshGen.spec"
+    SPEC_FILE = Path(__file__).with_name("PyMeshGen.spec")
     MAIN_SCRIPT = "start_gui.py"
 
 
@@ -52,7 +52,7 @@ class Config:
 # ============================================================================
 def get_project_root():
     """获取项目根目录"""
-    return Path(__file__).parent.absolute()
+    return Path(__file__).resolve().parents[2]
 
 
 def get_version(project_root):
@@ -189,9 +189,9 @@ def clean_build_dirs(project_root):
             shutil.rmtree(dir_path)
             cleaned = True
 
-    # 删除多余的 .spec 文件
+    # 删除项目根目录下误放的 .spec 文件
     for spec_file in project_root.glob('*.spec'):
-        if spec_file.name != Config.SPEC_FILE:
+        if spec_file.resolve() != Config.SPEC_FILE.resolve():
             spec_file.unlink()
             print(f"  删除文件：{spec_file}")
             cleaned = True
@@ -211,7 +211,7 @@ def build_executable(project_root, debug=False):
     """使用 PyInstaller 打包"""
     print_section("步骤 4: PyInstaller 打包")
 
-    spec_file = project_root / Config.SPEC_FILE
+    spec_file = Config.SPEC_FILE
 
     if not spec_file.exists():
         print(f"[ERR] Spec 文件不存在：{spec_file}")
@@ -295,7 +295,7 @@ def build_installer(project_root, iscc_path):
     """使用 Inno Setup 构建安装包"""
     print_section("步骤 5: 创建安装包 (Inno Setup)")
 
-    iss_file = project_root / f"{Config.APP_NAME}.iss"
+    iss_file = Path(__file__).with_name(f"{Config.APP_NAME}.iss")
 
     if not iss_file.exists():
         print(f"[ERR] Inno Setup 脚本不存在：{iss_file}")
@@ -433,11 +433,11 @@ def main():
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 示例:
-  python build_app.py              基本构建（仅可执行文件）
-  python build_app.py --clean      清理后构建
-  python build_app.py --installer  创建安装包（需要 Inno Setup）
-  python build_app.py --zip        创建便携版 ZIP
-  python build_app.py --all        创建所有输出
+  python packaging\\windows\\build_app.py              基本构建（仅可执行文件）
+  python packaging\\windows\\build_app.py --clean      清理后构建
+  python packaging\\windows\\build_app.py --installer  创建安装包（需要 Inno Setup）
+  python packaging\\windows\\build_app.py --zip        创建便携版 ZIP
+  python packaging\\windows\\build_app.py --all        创建所有输出
         """
     )