PyInstallerEx 0.1.9__tar.gz → 0.2.3__tar.gz

{pyinstallerex-0.1.9/src/PyInstallerEx.egg-info → pyinstallerex-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyInstallerEx
-Version: 0.1.9
+Version: 0.2.3
 Summary: 扩展PyInstaller 使其拥有单文件安装功能不用每次都解压执行
 Home-page: https://gitee.com/iiixxxiii/py-installer-ex
 Author: lixin
@@ -27,6 +27,7 @@ Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: PyInstaller>=3.2.1
+Requires-Dist: pyquickwebgui
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -52,6 +53,10 @@ PyInstallerEx 是一个基于 PyInstaller 的增强版打包工具，能够将 P
 4. **灵活解压模式**：支持解压到系统临时目录或 exe 所在目录（通过 `--extract-mode` 参数控制）
 5. **跨平台支持**：Windows、Linux x86/ARM全平台覆盖
 6. **配置灵活**：支持嵌入式配置读取，命令行参数覆盖配置文件
+7. **命令行参数透传**：打包后的可执行文件支持将命令行参数传递给内部程序
+8. **Web GUI 界面**：无参数启动时自动打开图形化界面，可视化配置打包参数
+   - **多语言支持**：支持中文/英文界面切换，设置持久化保存
+   - **文件选择对话框**：原生 tkinter 文件/文件夹选择器，支持初始路径记忆
 
 ## 🔧 环境要求
 
@@ -130,6 +135,26 @@ pip install pyinstallerex
 
 ### 基本用法
 
+#### 启动 Web GUI（图形界面）
+
+直接运行命令，不带任何参数，即可启动 Web GUI 界面：
+
+```bash
+# 以下三种方式均可
+PyInstallerEx
+pyinstallerex
+python -m PyInstallerEx
+```
+
+启动后会自动打开浏览器窗口，支持：
+- 选择脚本或文件夹打包模式
+- 可视化配置输出名称、版本、引擎、图标等参数
+- 实时查看构建日志和结果
+
+#### 命令行模式
+
+带参数时使用命令行模式：
+
 ```bash
 # 使用 pyinstallerex 命令
 pyinstallerex your_script.py
@@ -176,6 +201,7 @@ test\test_script.exe  # Windows
 | 04 | `04 - hello_world - PyOxidizer` | 使用 PyOxidizer 引擎打包 | `--engine-mode pyoxidizer` |
 | 05 | `05 - hello_world - icon` | 自定义 exe 图标（`.ico` 格式） | `--icon "exe.ico"` |
 | 06 | `06 - hello_world - folder` | 文件夹直接打包，跳过引擎构建，将指定文件夹封装为单文件 | `--folder "hello_folder" --run "hello.exe"` |
+| 07 | `07 - hello_world - parameter` | 命令行参数透传，支持 `--add1` 和 `--add2` 参数进行加法运算 | 无额外打包参数，运行时传参 |
 
 > 每个示例均提供 `package.bat`（Windows）和 `package.sh`（Linux/Mac）两套构建脚本。
 
@@ -225,6 +251,32 @@ python -m PyInstallerEx your_script.py --engine-mode pyoxidizer
 - **Nuitka**：需要安装 Nuitka (`pip install nuitka`) 和 C 编译器（如 Visual Studio Build Tools）
 - **PyOxidizer**：需要单独安装 PyOxidizer，详见 [PyOxidizer 文档](https://pyoxidizer.readthedocs.io/)
 
+### 命令行参数透传
+
+打包后的可执行文件支持将命令行参数透传给内部程序，无需额外配置：
+
+```bash
+# 打包程序
+python -m PyInstallerEx hello.py -n hello_param
+
+# 运行并传递参数
+hello_param.exe --add1 10 --add2 20
+# 输出：Calculation: 10.0 + 20.0 = 30.0
+
+# 查看帮助
+hello_param.exe --help
+```
+
+**工作原理**：
+- Rust 启动器在运行内部程序时，自动收集并传递所有命令行参数
+- 支持任意参数格式，完全兼容 `argparse` 等参数解析库
+- 参数透传对所有打包模式（脚本模式、文件夹模式）均有效
+
+**使用场景**：
+- 需要接收用户输入的命令行工具
+- 支持配置参数的自动化脚本
+- 需要灵活控制运行时行为的工具程序
+
 ### 文件夹直接打包模式
 
 使用 `--folder` 参数跳过 PyInstaller/Nuitka 等引擎打包流程，直接将指定文件夹压缩并附加到 Rust 启动器尾部，生成最终可执行文件。
@@ -327,7 +379,11 @@ py-installer-ex/
 │   ├── PyInstallerEx/            # Python 主程序
 │   │   ├── __init__.py
 │   │   ├── __main__.py           # CLI入口点
+│   │   ├── server.py             # Web GUI 后端服务
 │   │   ├── PyInstallerEx.py      # 主模块
+│   │   ├── web/
+│   │   │   ├── index.html        # Web GUI 前端页面
+│   │   │   └── favicon.ico       # 页面图标
 │   │   ├── core/
 │   │   │   ├── config.py         # 配置管理
 │   │   │   └── packager.py       # 打包逻辑
@@ -433,6 +489,7 @@ script\install.bat
 - ✅ **智能安装**：首次运行自动提取，后续运行复用已安装版本
 - ✅ **配置解析**：从可执行文件中读取和处理配置信息
 - ✅ **临时目录管理**：自动管理临时文件和清理
+- ✅ **命令行参数透传**：自动将启动器的命令行参数传递给内部程序
 
 ### 3. 文件夹直接打包
 - ✅ **`--folder` 参数**：跳过引擎构建，直接将指定文件夹压缩打包
@@ -449,20 +506,39 @@ script\install.bat
 
 - **Python 2.7+ / 3.x**: 主要开发语言
 - **PyInstaller >= 3.2.1**: 应用程序打包基础
+- **pyquickwebgui**: Web GUI 图形界面框架
 - **Rust (edition 2021)**: 启动器开发语言（serde/serde_json、md5、flate2）
 - **JSON**: 配置文件格式
 - **ZIP**: 应用程序压缩格式
 
-## 🔮 未来扩展方向
+##  未来扩展方向
 
-1. **GUI界面**：添加图形化配置界面
-2. **数字签名**：支持代码签名和安全验证
-3. **增量更新**：实现应用程序的增量更新功能
-4. **更多平台**：支持macOS等其他操作系统
-5. **插件系统**：允许扩展自定义打包逻辑
+1. ~~**GUI界面**~~：✅ 已实现 Web GUI 图形化界面（基于 pyquickwebgui）
+2. ~~**多语言支持**~~：✅ 已实现中英文双语界面，localStorage + 配置文件双持久化
+3. **数字签名**：支持代码签名和安全验证
+4. **增量更新**：实现应用程序的增量更新功能
+5. **更多平台**：支持macOS等其他操作系统
+6. **插件系统**：允许扩展自定义打包逻辑
 
 ##  更新日志
 
+- 2026-07-11 V 0.2.3
+  - 新增 **命令行参数透传**：Rust 启动器自动将命令行参数传递给内部程序
+  - 新增 **示例 07**：`07 - hello_world - parameter` 演示参数透传功能（`--add1`、`--add2`）
+  - 优化 `package.sh` 脚本：添加错误处理、路径优化、环境检查
+
+- 2026-07-07 V 0.2.2
+  - 新增 **Web GUI 多语言支持**：支持中文/英文界面实时切换
+  - 新增 **语言设置持久化**：使用用户主目录下 `.pyinstallerex/ui_config.json` 配置文件保存语言偏好
+
+
+- 2026-07-07 V 0.2.1
+  - 新增 **Web GUI 图形界面**：不带参数直接运行 `PyInstallerEx` 即可启动
+  - 基于 `pyquickwebgui` 实现，支持脚本模式/文件夹模式切换
+  - 可视化配置打包参数（引擎、图标、解压模式、输出目录等）
+  - 实时日志输出与构建状态轮询
+  - 新增 `server.py` 后端服务及 `web/` 前端页面
+
 - 2026-07-03 V 0.1.10
   - 新增 `--folder` 参数，支持文件夹直接打包模式：跳过引擎构建，直接将指定文件夹压缩并附加到启动器
   - 新增 `--run` 参数，支持自定义解压后运行的主程序入口（配置 `main` 字段）

{pyinstallerex-0.1.9 → pyinstallerex-0.2.3}/README.md

@@ -18,6 +18,10 @@ PyInstallerEx 是一个基于 PyInstaller 的增强版打包工具，能够将 P
 4. **灵活解压模式**：支持解压到系统临时目录或 exe 所在目录（通过 `--extract-mode` 参数控制）
 5. **跨平台支持**：Windows、Linux x86/ARM全平台覆盖
 6. **配置灵活**：支持嵌入式配置读取，命令行参数覆盖配置文件
+7. **命令行参数透传**：打包后的可执行文件支持将命令行参数传递给内部程序
+8. **Web GUI 界面**：无参数启动时自动打开图形化界面，可视化配置打包参数
+   - **多语言支持**：支持中文/英文界面切换，设置持久化保存
+   - **文件选择对话框**：原生 tkinter 文件/文件夹选择器，支持初始路径记忆
 
 ## 🔧 环境要求
 
@@ -96,6 +100,26 @@ pip install pyinstallerex
 
 ### 基本用法
 
+#### 启动 Web GUI（图形界面）
+
+直接运行命令，不带任何参数，即可启动 Web GUI 界面：
+
+```bash
+# 以下三种方式均可
+PyInstallerEx
+pyinstallerex
+python -m PyInstallerEx
+```
+
+启动后会自动打开浏览器窗口，支持：
+- 选择脚本或文件夹打包模式
+- 可视化配置输出名称、版本、引擎、图标等参数
+- 实时查看构建日志和结果
+
+#### 命令行模式
+
+带参数时使用命令行模式：
+
 ```bash
 # 使用 pyinstallerex 命令
 pyinstallerex your_script.py
@@ -142,6 +166,7 @@ test\test_script.exe  # Windows
 | 04 | `04 - hello_world - PyOxidizer` | 使用 PyOxidizer 引擎打包 | `--engine-mode pyoxidizer` |
 | 05 | `05 - hello_world - icon` | 自定义 exe 图标（`.ico` 格式） | `--icon "exe.ico"` |
 | 06 | `06 - hello_world - folder` | 文件夹直接打包，跳过引擎构建，将指定文件夹封装为单文件 | `--folder "hello_folder" --run "hello.exe"` |
+| 07 | `07 - hello_world - parameter` | 命令行参数透传，支持 `--add1` 和 `--add2` 参数进行加法运算 | 无额外打包参数，运行时传参 |
 
 > 每个示例均提供 `package.bat`（Windows）和 `package.sh`（Linux/Mac）两套构建脚本。
 
@@ -191,6 +216,32 @@ python -m PyInstallerEx your_script.py --engine-mode pyoxidizer
 - **Nuitka**：需要安装 Nuitka (`pip install nuitka`) 和 C 编译器（如 Visual Studio Build Tools）
 - **PyOxidizer**：需要单独安装 PyOxidizer，详见 [PyOxidizer 文档](https://pyoxidizer.readthedocs.io/)
 
+### 命令行参数透传
+
+打包后的可执行文件支持将命令行参数透传给内部程序，无需额外配置：
+
+```bash
+# 打包程序
+python -m PyInstallerEx hello.py -n hello_param
+
+# 运行并传递参数
+hello_param.exe --add1 10 --add2 20
+# 输出：Calculation: 10.0 + 20.0 = 30.0
+
+# 查看帮助
+hello_param.exe --help
+```
+
+**工作原理**：
+- Rust 启动器在运行内部程序时，自动收集并传递所有命令行参数
+- 支持任意参数格式，完全兼容 `argparse` 等参数解析库
+- 参数透传对所有打包模式（脚本模式、文件夹模式）均有效
+
+**使用场景**：
+- 需要接收用户输入的命令行工具
+- 支持配置参数的自动化脚本
+- 需要灵活控制运行时行为的工具程序
+
 ### 文件夹直接打包模式
 
 使用 `--folder` 参数跳过 PyInstaller/Nuitka 等引擎打包流程，直接将指定文件夹压缩并附加到 Rust 启动器尾部，生成最终可执行文件。
@@ -293,7 +344,11 @@ py-installer-ex/
 │   ├── PyInstallerEx/            # Python 主程序
 │   │   ├── __init__.py
 │   │   ├── __main__.py           # CLI入口点
+│   │   ├── server.py             # Web GUI 后端服务
 │   │   ├── PyInstallerEx.py      # 主模块
+│   │   ├── web/
+│   │   │   ├── index.html        # Web GUI 前端页面
+│   │   │   └── favicon.ico       # 页面图标
 │   │   ├── core/
 │   │   │   ├── config.py         # 配置管理
 │   │   │   └── packager.py       # 打包逻辑
@@ -399,6 +454,7 @@ script\install.bat
 - ✅ **智能安装**：首次运行自动提取，后续运行复用已安装版本
 - ✅ **配置解析**：从可执行文件中读取和处理配置信息
 - ✅ **临时目录管理**：自动管理临时文件和清理
+- ✅ **命令行参数透传**：自动将启动器的命令行参数传递给内部程序
 
 ### 3. 文件夹直接打包
 - ✅ **`--folder` 参数**：跳过引擎构建，直接将指定文件夹压缩打包
@@ -415,20 +471,39 @@ script\install.bat
 
 - **Python 2.7+ / 3.x**: 主要开发语言
 - **PyInstaller >= 3.2.1**: 应用程序打包基础
+- **pyquickwebgui**: Web GUI 图形界面框架
 - **Rust (edition 2021)**: 启动器开发语言（serde/serde_json、md5、flate2）
 - **JSON**: 配置文件格式
 - **ZIP**: 应用程序压缩格式
 
-## 🔮 未来扩展方向
+##  未来扩展方向
 
-1. **GUI界面**：添加图形化配置界面
-2. **数字签名**：支持代码签名和安全验证
-3. **增量更新**：实现应用程序的增量更新功能
-4. **更多平台**：支持macOS等其他操作系统
-5. **插件系统**：允许扩展自定义打包逻辑
+1. ~~**GUI界面**~~：✅ 已实现 Web GUI 图形化界面（基于 pyquickwebgui）
+2. ~~**多语言支持**~~：✅ 已实现中英文双语界面，localStorage + 配置文件双持久化
+3. **数字签名**：支持代码签名和安全验证
+4. **增量更新**：实现应用程序的增量更新功能
+5. **更多平台**：支持macOS等其他操作系统
+6. **插件系统**：允许扩展自定义打包逻辑
 
 ##  更新日志
 
+- 2026-07-11 V 0.2.3
+  - 新增 **命令行参数透传**：Rust 启动器自动将命令行参数传递给内部程序
+  - 新增 **示例 07**：`07 - hello_world - parameter` 演示参数透传功能（`--add1`、`--add2`）
+  - 优化 `package.sh` 脚本：添加错误处理、路径优化、环境检查
+
+- 2026-07-07 V 0.2.2
+  - 新增 **Web GUI 多语言支持**：支持中文/英文界面实时切换
+  - 新增 **语言设置持久化**：使用用户主目录下 `.pyinstallerex/ui_config.json` 配置文件保存语言偏好
+
+
+- 2026-07-07 V 0.2.1
+  - 新增 **Web GUI 图形界面**：不带参数直接运行 `PyInstallerEx` 即可启动
+  - 基于 `pyquickwebgui` 实现，支持脚本模式/文件夹模式切换
+  - 可视化配置打包参数（引擎、图标、解压模式、输出目录等）
+  - 实时日志输出与构建状态轮询
+  - 新增 `server.py` 后端服务及 `web/` 前端页面
+
 - 2026-07-03 V 0.1.10
   - 新增 `--folder` 参数，支持文件夹直接打包模式：跳过引擎构建，直接将指定文件夹压缩并附加到启动器
   - 新增 `--run` 参数，支持自定义解压后运行的主程序入口（配置 `main` 字段）

{pyinstallerex-0.1.9 → pyinstallerex-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "PyInstallerEx"
-version = "0.1.9"
+version = "0.2.3"
 description = "扩展PyInstaller 使其拥有单文件安装功能不用每次都解压执行"
 readme = "README.md"
 requires-python = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
@@ -32,6 +32,7 @@ classifiers = [
 ]
 dependencies = [
     "PyInstaller>=3.2.1",
+    "pyquickwebgui",
 ]
 
 [project.urls]
@@ -45,4 +46,4 @@ PyInstallerEx = "PyInstallerEx.__main__:main"
 where = ["src"]
 
 [tool.setuptools.package-data]
-PyInstallerEx = ["../bin/*"]
+PyInstallerEx = ["../bin/*", "web/*"]

{pyinstallerex-0.1.9 → pyinstallerex-0.2.3}/setup.py

@@ -25,7 +25,7 @@ setup(
     packages=find_packages(where="src"),  # 自动发现src目录下的子包
     include_package_data=True,      # 包含包数据文件
     package_data={
-        "PyInstallerEx": ["../bin/*"],  # 包含bin目录中的所有文件
+        "PyInstallerEx": ["../bin/*", "web/*"],  # 包含bin目录中的所有文件及web前端文件
     },
     data_files=[
         ('bin', [
@@ -35,6 +35,7 @@ setup(
     python_requires=">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",  # 兼容 2.7 和 3.4+
     install_requires=[              # 依赖列表
         "PyInstaller>=3.2.1",
+        "pyquickwebgui",
         # Windows平台可选依赖，用于设置exe图标（需要手动安装）
         # pip install pywin32 或 pip install pefile
     ],

{pyinstallerex-0.1.9 → pyinstallerex-0.2.3}/src/PyInstallerEx/__main__.py

@@ -46,6 +46,12 @@ def main():
     
     args = parser.parse_args()
     
+    # 无任何参数时启动 Web GUI 模式
+    if not args.script and not args.folder:
+        from .server import start_web_gui
+        start_web_gui()
+        return
+    
     # 设置日志
     setup_logging(args.verbose)
     
@@ -55,11 +61,6 @@ def main():
             print("[FAIL] Error: 'script' and '--folder' are mutually exclusive. Please specify only one.", file=sys.stderr)
             sys.exit(1)
         
-        # 必须提供 script 或 --folder 之一
-        if not args.script and not args.folder:
-            print("[FAIL] Error: either 'script' or '--folder' must be specified.", file=sys.stderr)
-            sys.exit(1)
-        
         # --folder 模式校验：目录必须存在
         if args.folder:
             if not os.path.isdir(args.folder):

pyinstallerex-0.2.3/src/PyInstallerEx/server.py

@@ -0,0 +1,291 @@
+# -*- coding: utf-8 -*-
+"""
+PyInstallerEx Web GUI 服务器
+基于 pyquickwebgui 提供图形化打包界面
+"""
+
+from __future__ import print_function
+import os
+import sys
+import json
+import threading
+
+from pyquickwebgui import QuikeUI
+
+from .core.packager import PackageBuilder
+from .core.config import PackageConfig
+from .utils.logging import setup_logging
+
+
+# 全局构建状态
+_build_status = {
+    "running": False,
+    "progress": "",
+    "output": "",
+    "success": None,
+    "log": [],
+}
+
+# UI 配置文件路径（存储语言等设置）- 放在用户主目录下
+_user_home = os.path.expanduser('~')
+_ui_config_dir = os.path.join(_user_home, '.pyinstallerex')
+if not os.path.exists(_ui_config_dir):
+    try:
+        os.makedirs(_ui_config_dir)
+    except Exception:
+        pass
+_ui_config_file = os.path.join(_ui_config_dir, 'ui_config.json')
+
+
+def _load_ui_config():
+    """加载 UI 配置（语言等）"""
+    try:
+        if os.path.exists(_ui_config_file):
+            with open(_ui_config_file, 'r', encoding='utf-8') as f:
+                return json.load(f)
+    except Exception:
+        pass
+    return {"language": "en"}
+
+
+def _save_ui_config(config):
+    """保存 UI 配置"""
+    try:
+        with open(_ui_config_file, 'w', encoding='utf-8') as f:
+            json.dump(config, f, ensure_ascii=False, indent=2)
+    except Exception as e:
+        print("[PyInstallerEx] Failed to save UI config: {0}".format(e))
+
+# 全局 QuikeUI 实例
+_web_dir = os.path.join(os.path.dirname(os.path.abspath(__file__)), "web")
+qui = QuikeUI(
+    web_path=_web_dir,
+    index_html="index.html",
+    title="PyInstallerEx",
+    icon="favicon.ico",
+    width=900,
+    height=680,
+    debug=False,
+)
+
+
+def _reset_status():
+    """重置构建状态"""
+    _build_status["running"] = False
+    _build_status["progress"] = ""
+    _build_status["output"] = ""
+    _build_status["success"] = None
+    _build_status["log"] = []
+
+
+def _append_log(msg):
+    """追加日志"""
+    _build_status["log"].append(msg)
+    print(msg)
+
+
+@qui.expose
+def get_status():
+    """获取当前构建状态"""
+    return dict(_build_status)
+
+
+@qui.expose
+def pick_file(initial_dir, file_types):
+    """打开文件选择对话框
+
+    Args:
+        initial_dir: 初始目录
+        file_types: 文件类型过滤，如 '.py' 或 '.ico'
+    """
+    try:
+        import tkinter as tk
+        from tkinter import filedialog
+        if initial_dir and os.path.isdir(initial_dir):
+            print("[PyInstallerEx] pick_file folder: {0}".format(initial_dir))
+            root = tk.Tk()
+            root.attributes("-topmost", True)
+            root.withdraw()
+            ft = [("{0} files".format(file_types), "*{0}".format(file_types)), ("All files", "*.*")]
+            result = filedialog.askopenfilename(initialdir=initial_dir, filetypes=ft)
+            print("[PyInstallerEx] pick_file result: {0}".format(repr(result)))
+            return result if result else ""
+        else:
+            return 'Not valid folder'
+    except Exception as e:
+        print("[PyInstallerEx] pick_file error: {0}".format(e))
+        return "Error: {0}".format(e)
+
+
+@qui.expose
+def pick_folder(initial_dir):
+    """打开文件夹选择对话框
+
+    Args:
+        initial_dir: 初始目录
+    """
+    try:
+        import tkinter as tk
+        from tkinter import filedialog
+        if initial_dir and os.path.isdir(initial_dir):
+            print("[PyInstallerEx] pick_folder folder: {0}".format(initial_dir))
+            root = tk.Tk()
+            root.attributes("-topmost", True)
+            root.withdraw()
+            result = filedialog.askdirectory(initialdir=initial_dir)
+            print("[PyInstallerEx] pick_folder result: {0}".format(repr(result)))
+            return result if result else ""
+        else:
+            return 'Not valid folder'
+    except Exception as e:
+        print("[PyInstallerEx] pick_folder error: {0}".format(e))
+        return "Error: {0}".format(e)
+
+
+@qui.expose
+def start_build(config_json):
+    """
+    启动打包构建任务
+
+    Args:
+        config_json: JSON 字符串，包含打包配置
+    """
+    if _build_status["running"]:
+        return {"success": False, "message": "A build task is already running"}
+
+    _reset_status()
+    _build_status["running"] = True
+
+    try:
+        cfg = json.loads(config_json)
+    except Exception as e:
+        _build_status["running"] = False
+        return {"success": False, "message": "Invalid config JSON: {0}".format(e)}
+
+    def _run_build():
+        try:
+            _append_log("[INFO] Starting build...")
+            _build_status["progress"] = "Initializing..."
+
+            # 构建 PackageConfig
+            config = PackageConfig()
+            config.filename = cfg.get("filename", "{filename}")
+            config.version = cfg.get("version", "1.0.0")
+            config.description = cfg.get("description", "")
+            config.author = cfg.get("author", "Unknown")
+            config.extract_mode = cfg.get("extract_mode", "temp")
+            config.engine_mode = cfg.get("engine_mode", "pyinstaller")
+            config.main = cfg.get("main", None)
+
+            # 图标处理
+            icon_path = cfg.get("icon", None)
+            if icon_path and os.path.exists(icon_path):
+                config.icon = icon_path
+            else:
+                default_icon = os.path.join(os.path.dirname(os.path.abspath(__file__)), "logo.ico")
+                if os.path.exists(default_icon):
+                    config.icon = default_icon
+                else:
+                    config.icon = None
+
+            # 设置日志级别
+            verbose = cfg.get("verbose", False)
+            setup_logging(verbose)
+
+            builder = PackageBuilder(config, verbose=verbose)
+            output_dir = cfg.get("output_dir", None) or None
+
+            # 文件夹模式 or 脚本模式
+            folder_path = cfg.get("folder", None)
+            script_path = cfg.get("script", None)
+
+            if folder_path:
+                _build_status["progress"] = "Packaging folder..."
+                if not os.path.isdir(folder_path):
+                    raise ValueError("Folder not found: {0}".format(folder_path))
+
+                if cfg.get("name"):
+                    config.filename = cfg["name"]
+                elif config.filename == "{filename}":
+                    config.filename = os.path.basename(folder_path)
+
+                result_path = builder.build_folder(folder_path, output_dir)
+            elif script_path:
+                _build_status["progress"] = "Packaging script..."
+                if not os.path.isfile(script_path):
+                    raise ValueError("Script not found: {0}".format(script_path))
+
+                if cfg.get("name"):
+                    config.filename = cfg["name"]
+                elif config.filename == "{filename}":
+                    config.filename = os.path.splitext(os.path.basename(script_path))[0]
+
+                result_path = builder.build(script_path, output_dir)
+            else:
+                raise ValueError("Either 'script' or 'folder' must be specified")
+
+            _build_status["progress"] = "Done"
+            _build_status["output"] = result_path
+            _build_status["success"] = True
+            _append_log("[OK] Build completed: {0}".format(result_path))
+
+        except Exception as e:
+            _build_status["progress"] = "Failed"
+            _build_status["success"] = False
+            _build_status["output"] = str(e)
+            _append_log("[FAIL] Build failed: {0}".format(e))
+        finally:
+            _build_status["running"] = False
+
+    # 在后台线程执行构建
+    t = threading.Thread(target=_run_build)
+    t.daemon = True
+    t.start()
+
+    return {"success": True, "message": "Build started"}
+
+
+@qui.expose
+def get_default_config():
+    """获取默认配置模板"""
+    default_icon = os.path.join(os.path.dirname(os.path.abspath(__file__)), "logo.ico")
+    ui_config = _load_ui_config()
+    return {
+        "filename": "{filename}",
+        "version": "1.0.0",
+        "description": "Application packaged with PyInstallerEx",
+        "author": "Unknown",
+        "extract_mode": "temp",
+        "engine_mode": "pyinstaller",
+        "icon": default_icon if os.path.exists(default_icon) else "",
+        "output_dir": "",
+        "verbose": False,
+        "language": ui_config.get("language", "en"),
+    }
+
+
+@qui.expose
+def set_language(lang):
+    """设置界面语言并保存到配置文件
+
+    Args:
+        lang: 'en' or 'cn'
+    """
+    if lang not in ('en', 'cn'):
+        return {"success": False, "message": "Invalid language: {0}".format(lang)}
+    
+    ui_config = _load_ui_config()
+    ui_config["language"] = lang
+    _save_ui_config(ui_config)
+    print("[PyInstallerEx] Language saved: {0}".format(lang))
+    return {"success": True, "language": lang}
+
+
+def start_web_gui():
+    """启动 Web GUI"""
+    print("[PyInstallerEx] Starting Web GUI...")
+    qui.run()
+
+
+if __name__ == "__main__":
+    start_web_gui()