From 6809c6f2c6700ea1f4429d1fcc70038166848489 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=AF=92=E5=AF=92?= <2596194220@qq.com>
Date: Sat, 13 Dec 2025 22:57:41 +0800
Subject: [PATCH] =?UTF-8?q?fix:=E6=9B=B4=E6=96=B0=E9=A1=B9=E7=9B=AE?=
=?UTF-8?q?=E8=AF=B4=E6=98=8E=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.idea/workspace.xml | 34 +++++++++++++-------------
IFLOW.md | 34 +++++++++++++++++++++-----
README.md | 30 +++++++++++++++++++----
main_nicegui.py | 8 +++++--
script/setup_nicegui.py | 53 +++++++++++++++++++++++------------------
5 files changed, 107 insertions(+), 52 deletions(-)
diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index 8c275ad..98432dc 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -4,21 +4,12 @@
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
+
+
+
+
@@ -163,7 +154,7 @@
1765613055475
-
+
@@ -173,7 +164,15 @@
1765626269402
-
+
+
+ 1765631607389
+
+
+
+ 1765631607389
+
+
@@ -181,7 +180,8 @@
-
+
+
diff --git a/IFLOW.md b/IFLOW.md
index 546261a..a339cf8 100644
--- a/IFLOW.md
+++ b/IFLOW.md
@@ -2,7 +2,7 @@
## 项目概述
-这是一个基于Python的自动化幼儿园成长报告生成系统。该系统可以从Excel数据文件中读取幼儿信息，结合AI生成个性化评语，并将所有信息批量填充到PPT模板中，最终生成每个学生的个性化成长报告。系统支持双界面运行（命令行界面和图形界面），具备字体安装、图片替换、批量PDF转换、生肖计算等功能。
+这是一个基于Python的自动化幼儿园成长报告生成系统。该系统可以从Excel数据文件中读取幼儿信息，结合AI生成个性化评语，并将所有信息批量填充到PPT模板中，最终生成每个学生的个性化成长报告。系统支持双界面运行（命令行界面、图形界面和NiceGUI界面），具备字体安装、图片替换、批量PDF转换、生肖计算等功能。
## 技术栈
@@ -15,6 +15,7 @@
- **loguru**: 日志记录
- **tomli**: 配置文件解析
- **tkinter**: 图形用户界面
+- **nicegui**: 现代Web界面
## 核心功能
@@ -66,7 +67,9 @@
```
growth_report/
├── main.py # 主程序入口（命令行界面）
-├── UI.py # 图形用户界面入口
+├── UI.py # 图形用户界面入口（tkinter）
+├── main_nicegui.py # NiceGUI界面入口
+├── main.pyw # Windows图形界面启动文件
├── config.env.toml # 项目配置文件
├── pyproject.toml # 项目依赖配置
├── start_app.bat # Windows启动批处理文件
@@ -75,6 +78,19 @@ growth_report/
├── config/
│ ├── config.py # 配置加载工具
│ └── output/ # 配置输出目录
+├── ui/
+│ ├── app_window.py # tkinter图形界面
+│ ├── main_nicegui.py # NiceGUI界面主文件
+│ ├── assets/
+│ │ ├── icon.ico # 应用图标
+│ │ └── style.css # 样式文件
+│ ├── core/
+│ │ ├── logger.py # 日志处理
+│ │ ├── state.py # 应用状态管理
+│ │ ├── task_runner.py # 任务运行器
+│ │ └── __pycache__/
+│ └── views/
+│ └── home_page.py # NiceGUI主页面
├── utils/
│ ├── agent_utils.py # AI评语生成工具
│ ├── file_utils.py # 文件操作工具
@@ -82,6 +98,7 @@ growth_report/
│ ├── generate_utils.py # 核心生成功能
│ ├── growt_utils.py # PPT模板替换工具
│ ├── image_utils.py # 图片处理工具
+│ ├── log_handler.py # 日志处理器
│ ├── pdf_utils.py # PDF转换工具
│ ├── pptx_utils.py # PPT文本和图片替换工具
│ └── zodiac_utils.py # 生肖计算工具
@@ -153,11 +170,16 @@ data/images/
python main.py
```
-#### 图形界面
+#### 图形界面 (tkinter)
```bash
python UI.py
```
+#### NiceGUI界面 (现代Web界面)
+```bash
+python main_nicegui.py
+```
+
或直接运行批处理文件：
```bash
start_app.bat
@@ -184,11 +206,11 @@ pip install -r requirements.txt
## 系统特点
-- **双界面支持**: 提供命令行界面和图形界面两种操作方式
+- **三界面支持**: 提供命令行界面、tkinter图形界面和NiceGUI现代Web界面三种操作方式
- **自动化流程**: 从数据到成品报告的全流程自动化
- **AI集成**: 智能生成个性化评语
- **格式保持**: 替换文本时保持原有格式
-- **用户友好**: 丰富的命令行界面和图形界面，实时日志显示
+- **用户友好**: 丰富的命令行界面和多种图形界面，实时日志显示
- **批量处理**: 支持批量生成和转换
- **错误处理**: 完善的异常处理和日志记录
- **生肖计算**: 自动根据生日计算生肖
@@ -200,7 +222,7 @@ pip install -r requirements.txt
- 使用`loguru`进行日志记录
- 使用`rich`美化命令行输出
-- 使用`tkinter`构建图形界面
+- 使用`tkinter`和`nicegui`构建图形界面
- 配置文件使用TOML格式
- 图片和文本替换使用占位符机制
- 遵循Python代码规范
diff --git a/README.md b/README.md
index 21cc22c..1009930 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
## 项目概述
-基于Python的自动化幼儿园学期成长报告生成系统。该系统可以从Excel数据文件中读取幼儿信息，结合AI生成个性化评语，并将所有信息批量填充到PPT模板中，最终生成每个学生的个性化成长报告。系统支持双界面操作（命令行界面和图形界面），具备字体安装、图片替换、批量PDF转换、生肖计算、模板导出等完整功能。
+基于Python的自动化幼儿园学期成长报告生成系统。该系统可以从Excel数据文件中读取幼儿信息，结合AI生成个性化评语，并将所有信息批量填充到PPT模板中，最终生成每个学生的个性化成长报告。系统支持三界面操作（命令行界面、图形界面和NiceGUI界面），具备字体安装、图片替换、批量PDF转换、生肖计算、模板导出等完整功能。
## ✨ 主要特性
@@ -13,7 +13,7 @@
- 🤖 **AI评语**: 智能生成个性化、治愈系风格的幼儿评语
- 🖼️ **图文并茂**: 支持个人照片、活动照片、班级合影的自动替换
- 📄 **格式转换**: 批量PPT转PDF，便于分发和存档
-- 🎨 **双界面**: 提供命令行界面和图形界面，满足不同用户需求
+- 🎨 **多界面**: 提供命令行界面、tkinter图形界面和NiceGUI现代Web界面，满足不同用户需求
- 🐲 **生肖计算**: 根据生日自动计算生肖信息
- 📦 **模板导出**: 生成标准化数据模板，快速上手
- 🔤 **字体安装**: 自动检测和安装所需字体文件
@@ -28,6 +28,7 @@
- **rich**: 美化命令行界面
- **loguru**: 日志记录
- **tkinter**: 图形用户界面
+- **nicegui**: 现代Web界面
- **tomli**: 配置文件解析
## 📋 系统要求
@@ -67,7 +68,12 @@ pip install -r requirements.txt
### 4. 运行程序
-#### 图形界面（推荐）
+#### NiceGUI界面（推荐，现代Web界面）
+```bash
+python main_nicegui.py
+```
+
+#### 图形界面（tkinter界面）
```bash
python UI.py
```
@@ -131,7 +137,9 @@ data/images/
```
growth_report/
├── main.py # 主程序入口（命令行界面）
-├── UI.py # 图形用户界面入口
+├── UI.py # 图形用户界面入口（tkinter）
+├── main_nicegui.py # NiceGUI界面入口
+├── main.pyw # Windows图形界面启动文件
├── config.env.toml # 项目配置文件
├── pyproject.toml # 项目依赖配置
├── start_app.bat # 启动脚本
@@ -140,6 +148,19 @@ growth_report/
├── config/
│ ├── config.py # 配置加载工具
│ └── output/ # 配置输出目录
+├── ui/
+│ ├── app_window.py # tkinter图形界面
+│ ├── main_nicegui.py # NiceGUI界面主文件
+│ ├── assets/
+│ │ ├── icon.ico # 应用图标
+│ │ └── style.css # 样式文件
+│ ├── core/
+│ │ ├── logger.py # 日志处理
+│ │ ├── state.py # 应用状态管理
+│ │ ├── task_runner.py # 任务运行器
+│ │ └── __pycache__/
+│ └── views/
+│ └── home_page.py # NiceGUI主页面
├── utils/
│ ├── agent_utils.py # AI评语生成工具
│ ├── file_utils.py # 文件操作工具
@@ -147,6 +168,7 @@ growth_report/
│ ├── generate_utils.py # 核心生成功能
│ ├── growt_utils.py # PPT模板替换工具
│ ├── image_utils.py # 图片处理工具
+│ ├── log_handler.py # 日志处理器
│ ├── pdf_utils.py # PDF转换工具
│ ├── pptx_utils.py # PPT文本和图片替换工具
│ └── zodiac_utils.py # 生肖计算工具
diff --git a/main_nicegui.py b/main_nicegui.py
index ab6dd43..2c2813b 100644
--- a/main_nicegui.py
+++ b/main_nicegui.py
@@ -1,7 +1,7 @@
import os
import sys
-from nicegui import ui, app, run
+from nicegui import ui, app, run, native
from loguru import logger
# 导入我们的模块
@@ -9,12 +9,15 @@ from config.config import load_config
from ui.core.logger import setup_logger
from utils.font_utils import install_fonts_from_directory
from ui.views.home_page import create_page
-
+sys.stdout.reconfigure(encoding='utf-8')
+sys.stderr.reconfigure(encoding='utf-8')
# 1. 初始化配置
config = load_config("config.toml")
setup_logger()
+
+
# === 关键修改：定义一个获取路径的通用函数 ===
def get_path(relative_path):
"""
@@ -60,5 +63,6 @@ if __name__ in {"__main__", "__mp_main__"}:
title="尚城幼儿园成长报告助手",
native=True,
window_size=(900, 900),
+ port=native.find_open_port(), # 自动寻找端口
reload=False
)
diff --git a/script/setup_nicegui.py b/script/setup_nicegui.py
index 2116399..5624ea7 100644
--- a/script/setup_nicegui.py
+++ b/script/setup_nicegui.py
@@ -5,31 +5,36 @@ import shutil
import platform
MAIN_FILE = "main_nicegui.py"
+# 【关键修改】提取应用名称为变量，确保打包目录和复制目录一致
+APP_NAME = "尚城幼儿园幼儿学期发展报告"
+
def copy_resources():
"""
- 将资源文件从项目根目录复制到 dist 文件夹中，
+ 将资源文件从项目根目录复制到 dist/APP_NAME 文件夹中 (与 exe 同级)，
以便用户可以直接在 exe 旁边修改这些文件。
"""
current_dir = os.path.dirname(os.path.abspath(__file__))
project_root = os.path.dirname(current_dir)
- dist_dir = os.path.join(current_dir, "dist")
+
+ # 【关键修改】目标目录改为 dist/APP_NAME
+ # 这样资源文件才会出现在 exe 旁边，而不是 dist 根目录
+ dist_dir = os.path.join(current_dir, "dist", APP_NAME)
print(f"\n--- 正在复制外部资源到 {dist_dir} ---")
if not os.path.exists(dist_dir):
- print("错误: dist 文件夹不存在，请先运行打包。")
+ print(f"错误: 目标文件夹不存在: {dist_dir}")
+ print("请检查是否打包成功，或者是否使用了 --onedir 模式。")
return
- # 这里的列表是【给用户看/改的】，不用把 ui/assets 放这里，除非你希望用户改CSS
+ # 这里的列表是【给用户看/改的】
resources_to_copy = [
("config.toml", ""),
("fonts", "fonts"),
("data", "data"),
("templates", "templates"),
("public", "public"),
- # ui/assets 通常不需要用户改，所以这里可以不复制到外部，只打在包里即可
- # 但如果你希望用户能自定义 logo，也可以复制出来
]
for src_name, dest_name in resources_to_copy:
@@ -41,6 +46,7 @@ def copy_resources():
shutil.copy2(src_path, dest_path)
print(f"✅ 已复制文件: {src_name}")
elif os.path.isdir(src_path):
+ # dirs_exist_ok=True 允许覆盖已存在的目录（Python 3.8+）
shutil.copytree(src_path, dest_path, dirs_exist_ok=True)
print(f"✅ 已复制目录: {src_name}")
else:
@@ -48,53 +54,54 @@ def copy_resources():
except Exception as e:
print(f"❌ 复制失败 {src_name}: {e}")
+
def build_exe():
"""使用 PyInstaller 打包"""
- # 1. 确定当前系统的分隔符 (Windows用';', Linux/Mac用':')
sep = ';' if platform.system() == "Windows" else ':'
- # 2. 定义内部资源 (打入 exe 肚子里的)
- # 格式: "源路径{sep}目标路径"
+ # 内部资源 (打入 exe 内部的)
resource_paths = [
- f"../config.toml{sep}.", # 默认配置
- f"../fonts{sep}fonts", # 字体 (程序可能需要内部路径)
- f"../templates{sep}templates", # 模板
- f"../ui/assets{sep}ui/assets", # <--- 关键修复：添加 UI 静态资源
- # public 和 data 如果体积太大且只在运行时读取，可以不打入包内，只保留外部复制
+ f"../config.toml{sep}.",
+ f"../fonts{sep}fonts",
+ f"../templates{sep}templates",
+ f"../ui/assets{sep}ui/assets",
]
try:
command = [
sys.executable, "-m", "PyInstaller",
- "--onefile",
- "--windowed", # 建议：先注释掉这行，打包出来先看黑框有没有报错，没问题了再开启
- "--name=尚城幼儿园幼儿学期发展报告",
- "--clean", # 清理缓存，避免旧文件干扰
- "--distpath=./dist", # 明确输出目录
+ "--onedir", # 文件夹模式
+ "--windowed", # 隐藏控制台 (调试时建议先注释掉)
+ f"--name={APP_NAME}", # 【关键修改】使用变量
+ "--clean",
+ "--distpath=./dist",
"--workpath=./build",
- "--icon=../public/icon.ico", # 确保你真有这个图标，否则会报错
+ "--icon=../public/icon.ico",
"../" + MAIN_FILE
]
- # 添加 --add-data 参数
for res in resource_paths:
command.append(f"--add-data={res}")
- # 添加 hidden-import (NiceGUI 常见缺失)
command.extend(["--hidden-import=nicegui", "--hidden-import=uvicorn"])
print("--- 开始打包 (PyInstaller) ---")
subprocess.run(command, check=True, cwd=os.path.dirname(os.path.abspath(__file__)))
print("\n--- PyInstaller 打包完成！---")
+ # 打包完成后执行复制
copy_resources()
- print(f"\n🎉 全部完成！请查看 'dist' 文件夹。")
+
+ # 打印最终 exe 的位置提示
+ exe_path = os.path.join("dist", APP_NAME, f"{APP_NAME}.exe")
+ print(f"\n🎉 全部完成！可执行文件位于: {exe_path}")
except subprocess.CalledProcessError as e:
print(f"\n❌ 打包失败: {e}")
except Exception as e:
print(f"\n❌ 发生错误: {e}")
+
if __name__ == "__main__":
build_exe()
\ No newline at end of file