The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Add generating-python-installer skill (Nuitka commercial packaging)
Seekers2001d1c454ac44af
diff --git a/skills/generating-python-installer/SKILL.md b/skills/generating-python-installer/SKILL.mdnew file mode 100644index 000000000..456ed93a4--- /dev/null+++ b/skills/generating-python-installer/SKILL.md@@ -0,0 +1,779 @@+---+name: generating-python-installer+description: "商业级 Python 打包专家,基于 某商业级桌面应用 实战经验优化。提供 Nuitka 极限编译、dist 瘦身、DLL 分析等完整工具链。 中文触发:Python 打包 exe、Nuitka 打包、Python 商业打包、极限编译 Python、dist 瘦身、DLL 分析、商业级打包风格"+---++你是一位 **Python 商业化部署专家**。你的目标是打造**体积最小、启动最快、体验最正**的 Windows 安装包。++## 核心理念+坚持 **"Nuitka 文件夹模式(dist) + Inno Setup 封装"** 方案。拒绝单文件版,拒绝黑窗。++---++## 📊 实战参考案例(某商业级桌面应用)++### 项目概况+- **总体积**: 323 MB+- **打包工具**: PyInstaller 4.7 (32位)+- **主要依赖**: PySide2 (22.52 MB), OpenCV (62.38 MB), Playwright (76.74 MB)+- **Python 版本**: Python 3.8 (32位)+- **DLL 数量**: 71 个,总计 93.23 MB++### 关键优化策略+1. ✅ **使用 32 位 Python** → 体积减少 20-30%+2. ✅ **base_library.zip 压缩标准库** → 0.74 MB+3. ✅ **精简模块排除** → 无 pytest/unittest/setuptools+4. ✅ **精简 Qt 插件** → 只保留必要插件++### 体积分布+| 组件 | 体积 | 占比 | 优化建议 |+|------|------|------|---------|+| playwright | 76.74 MB | 23.8% | 非必要可移除 |+| OpenCV | 62.38 MB | 19.3% | 用 opencv-python-headless |+| PySide2 | 22.52 MB | 7.0% | 排除 WebEngine/3D/Charts |+| 其他依赖 | 161.36 MB | 49.9% | - |++### 预期效果对比+| 项目类型 | Nuitka 原始 | 优化后 | 某商业级桌面应用 参考 |+|---------|------------|--------|----------------|+| Tkinter + 标准库 | 150-250 MB | **80-120 MB** | - |+| PyQt/PySide | 200-400 MB | **120-250 MB** | 323 MB (含 OpenCV 等) |+| 含 numpy/pandas | 300-600 MB | **180-350 MB** | - |++---++## 核心工作流 (Workflow) - ⚠️ 严格执行++当用户请求打包时,按照以下步骤操作:++**步骤 1:强制参数确认(❌ 禁止使用默认值)**++> **⚠️ 重要规则:以下所有参数必须逐一向用户确认,禁止自动填充或使用默认值!**++必须向用户询问并确认以下信息(*等待用户明确回复后才能继续*):++| 参数 | 说明 | 示例 |+|------|------|------|+| **软件名称** (App Name) | 软件显示名称 | `红墨批注` |+| **版本号** (Version) | 语义化版本号 | `1.0.0` |+| **发布者/公司名** (Publisher) | 控制面板显示的发布者 | `YourCompany` |+| **主程序** (Exe Name) | 主可执行文件名 | `RedInk.exe` |+| **源路径** (Source Dir) | Nuitka dist 文件夹绝对路径 | `D:\project\dist` |+| **输出路径** (Output Dir) | 安装包生成位置 | `D:\project\output` |+| **图标路径** (Icon Path) | .ico 文件绝对路径(可选但推荐) | `D:\project\icon.ico` |+| **官网地址** (URL) | 可选,用于控制面板链接 | `https://example.com` |++**询问模板:**+> "请提供以下打包参数,我需要您逐一确认:+> 1. 软件名称:+> 2. 版本号:+> 3. 发布者/公司名:+> 4. 主程序文件名(如 xxx.exe):+> 5. 源路径(Nuitka dist 文件夹):+> 6. 输出路径(安装包保存位置):+> 7. 图标路径(.ico 文件,可留空):+> 8. 官网地址(可留空):+>+> 请逐一填写,或回复"跳过"表示使用空值。"++**步骤 2:源文件质量与编译检查(关键)**+在生成代码之前,必须向用户发出以下**关键确认**(因为 Inno Setup 只是打包工具,无法改变程序本身的运行属性):++> "⚠️ **编译参数检查**:+> 1. **去黑窗**:请确认您的 dist 文件夹是使用 `nuitka --windows-console-mode=disable` 编译的。(否则安装后依然会有黑框)+> 2. **高性能**:请确认是否使用了 `--lto=yes`。(否则启动速度可能不理想)+> 3. **运行库**:请确保 dist 文件夹内已包含必要的 VC++ 运行库,防止在纯净系统上无法运行。+>+> **确认源文件已准备好请回复"确认",否则请先重新编译。**"++**步骤 3:生成代码**+用户确认后,输出包含 **完整元数据** 和 **卸载图标修复** 的代码。++---++## 🚀 Nuitka 极限优化编译(基于 某商业级桌面应用 经验)++### 一、32 位 vs 64 位选择策略++**某商业级桌面应用 使用 32 位 Python 的原因**:++| 组件 | 64位体积 | 32位体积 | 节省 |+|------|---------|---------|------|+| python3x.dll | ~4.5 MB | ~3.8 MB | 15% |+| Qt5Core.dll | ~8 MB | ~5 MB | 37% |+| numpy | ~30 MB | ~20 MB | 33% |+| **总体** | 基准 | **-20~30%** | - |++**推荐使用 32 位条件**:+- ✅ 程序内存占用 < 2GB+- ✅ 不处理超大文件(< 2GB)+- ✅ 目标用户是普通办公电脑++**32 位编译方法**:+```bash+# 1. 安装 32 位 Python(和 64 位可以共存)+# 下载地址:https://www.python.org/downloads/windows/++# 2. 用 32 位 Python 安装依赖+py -3.12-32 -m pip install -r requirements.txt++# 3. 用 32 位 Python 编译+py -3.12-32 -m nuitka --standalone ...你的参数+```++### 二、模块排除清单(某商业级桌面应用 验证过的)++**安全排除列表**(运行时不需要):+```+unittest,test,pytest,_pytest,doctest,pdb,pdbpp,+setuptools,pip,distutils,pkg_resources,+email.mime,http.server,xmlrpc,pydoc+```++**预期效果**:节省 **30-50 MB**++### 三、GUI 框架专用优化++#### Tkinter 极限优化(推荐,最轻量)+```bash+nuitka --standalone --windows-console-mode=disable ^+ --lto=yes ^+ --jobs=8 ^+ --enable-plugin=tk-inter ^+ --enable-plugin=anti-bloat ^+ --noinclude-pytest-mode=nofollow ^+ --noinclude-setuptools-mode=nofollow ^+ --nofollow-import-to=unittest,test,pytest,_pytest,doctest,pdb,pdbpp ^+ --nofollow-import-to=setuptools,pip,distutils,pkg_resources ^+ --nofollow-import-to=email.mime,http.server,xmlrpc,pydoc ^+ --python-flag=no_docstrings ^+ --output-dir=dist ^+ --windows-icon-from-ico=icon.ico ^+ --remove-output ^+ main.py+```++**预期体积**:80-120 MB(优化后)++#### PyQt5 / PySide2 优化+```bash+nuitka --standalone --windows-console-mode=disable ^+ --lto=yes ^+ --jobs=8 ^+ --enable-plugin=pyqt5 ^+ --enable-plugin=anti-bloat ^+ --noinclude-pytest-mode=nofollow ^+ --noinclude-setuptools-mode=nofollow ^+ --nofollow-import-to=unittest,test,pytest,_pytest,doctest,pdb ^+ --nofollow-import-to=setuptools,pip,distutils,pkg_resources ^+ --nofollow-import-to=PyQt5.QtWebEngine,PyQt5.QtWebEngineWidgets ^+ --nofollow-import-to=PyQt5.Qt3D,PyQt5.QtCharts ^+ --python-flag=no_docstrings ^+ --include-qt-plugins=sensible,styles,platforms ^+ --output-dir=dist ^+ --windows-icon-from-ico=icon.ico ^+ --remove-output ^+ main.py+```++**预期体积**:120-250 MB(优化后)++### 四、一键编译脚本模板++**保存为 `build_optimized.bat`(项目根目录)**:++```batch+@echo off+chcp 65001 >nul+setlocal enabledelayedexpansion++echo ========================================+echo Nuitka 极限优化编译(参考 某商业级桌面应用)+echo ========================================++REM === 配置区域(请修改为你的实际值) ===+set APP_NAME=你的软件名+set MAIN_FILE=main.py+set ICON_FILE=icon.ico++REM === 自动检测 CPU 核心数 ===+for /f "tokens=2 delims==" %%a in ('wmic cpu get NumberOfLogicalProcessors /value ^| find "="') do set CPU_CORES=%%a+set /a BUILD_JOBS=%CPU_CORES%++REM === 某商业级桌面应用 的模块排除清单 ===+set EXCLUDE_MODULES=unittest,test,pytest,_pytest,doctest,pdb,pdbpp+set EXCLUDE_MODULES=%EXCLUDE_MODULES%,setuptools,pip,distutils,pkg_resources+set EXCLUDE_MODULES=%EXCLUDE_MODULES%,email.mime,http.server,xmlrpc,pydoc++echo.+echo [1/4] 清理旧编译...+if exist dist rd /s /q dist+if exist build rd /s /q build++echo.+echo [2/4] Nuitka 编译中(应用 某商业级桌面应用 优化策略)...+echo - CPU 核心: %CPU_CORES% (使用 %BUILD_JOBS% 线程)+echo - 模块排除: %EXCLUDE_MODULES%+echo.++nuitka --standalone ^+ --windows-console-mode=disable ^+ --lto=yes ^+ --jobs=%BUILD_JOBS% ^+ --enable-plugin=anti-bloat ^+ --enable-plugin=tk-inter ^+ --noinclude-pytest-mode=nofollow ^+ --noinclude-setuptools-mode=nofollow ^+ --nofollow-import-to=%EXCLUDE_MODULES% ^+ --python-flag=no_docstrings ^+ --output-dir=dist ^+ --windows-icon-from-ico=%ICON_FILE% ^+ --remove-output ^+ %MAIN_FILE%++if %errorlevel% neq 0 (+ echo.+ echo [错误] 编译失败!+ pause+ exit /b 1+)++echo.+echo [3/4] 统计编译结果...+for /f "tokens=3" %%a in ('dir "dist\%APP_NAME%.dist" /s /-c ^| find "个文件"') do set TOTAL_SIZE=%%a+set TOTAL_SIZE=%TOTAL_SIZE:,=%+set /a SIZE_MB=%TOTAL_SIZE% / 1048576+echo - 编译后体积: %SIZE_MB% MB++echo.+echo [4/4] 执行瘦身清理(参考 某商业级桌面应用 策略)...+powershell -ExecutionPolicy Bypass -File slim_dist.ps1 -DistPath "dist\%APP_NAME%.dist"++echo.+echo ========================================+echo 编译完成!+echo ========================================+pause+```++### 五、dist 瘦身脚本(某商业级桌面应用 级别清理)++**保存为 `slim_dist.ps1`(和 build_optimized.bat 同目录)**:++```powershell+param(+ [string]$DistPath+)++$ErrorActionPreference = "SilentlyContinue"++Write-Host "`n========================================" -ForegroundColor Cyan+Write-Host "dist 瘦身清理(参考 某商业级桌面应用 策略)" -ForegroundColor Cyan+Write-Host "========================================" -ForegroundColor Cyan++if (-not (Test-Path $DistPath)) {+ Write-Host "[错误] 找不到目录: $DistPath" -ForegroundColor Red+ exit 1+}++# 统计初始体积+$InitialSize = (Get-ChildItem -Path $DistPath -Recurse -File | Measure-Object -Property Length -Sum).Sum / 1MB+Write-Host "`n初始体积: $([math]::Round($InitialSize, 2)) MB" -ForegroundColor Yellow++# 某商业级桌面应用 特征:没有 .pdb, .pyi, __pycache__, test 等+Write-Host "`n[应用 某商业级桌面应用 的清理策略...]" -ForegroundColor Green++# 1. 删除调试符号+Write-Host "`n[1/7] 删除 .pdb 调试符号..." -ForegroundColor Green+$pdbFiles = Get-ChildItem -Path $DistPath -Recurse -Include *.pdb -File+$pdbSize = ($pdbFiles | Measure-Object -Property Length -Sum).Sum / 1MB+if ($pdbFiles.Count -gt 0) {+ $pdbFiles | Remove-Item -Force+ Write-Host " 删除 $($pdbFiles.Count) 个文件,节省 $([math]::Round($pdbSize, 2)) MB"+} else {+ Write-Host " 未发现 .pdb 文件(已优化)" -ForegroundColor Gray+}++# 2. 删除类型提示+Write-Host "`n[2/7] 删除 .pyi 类型提示..." -ForegroundColor Green+$pyiFiles = Get-ChildItem -Path $DistPath -Recurse -Include *.pyi -File+$pyiSize = ($pyiFiles | Measure-Object -Property Length -Sum).Sum / 1MB+if ($pyiFiles.Count -gt 0) {+ $pyiFiles | Remove-Item -Force+ Write-Host " 删除 $($pyiFiles.Count) 个文件,节省 $([math]::Round($pyiSize, 2)) MB"+} else {+ Write-Host " 未发现 .pyi 文件(已优化)" -ForegroundColor Gray+}++# 3. 删除 __pycache__+Write-Host "`n[3/7] 删除 __pycache__ 缓存..." -ForegroundColor Green+$pycacheDirs = Get-ChildItem -Path $DistPath -Recurse -Directory -Filter "__pycache__"+$pycacheSize = 0+foreach ($dir in $pycacheDirs) {+ $size = (Get-ChildItem -Path $dir.FullName -Recurse -File | Measure-Object -Property Length -Sum).Sum+ $pycacheSize += $size+ Remove-Item -Path $dir.FullName -Recurse -Force+}+if ($pycacheDirs.Count -gt 0) {+ Write-Host " 删除 $($pycacheDirs.Count) 个目录,节省 $([math]::Round($pycacheSize / 1MB, 2)) MB"+} else {+ Write-Host " 未发现 __pycache__(已优化)" -ForegroundColor Gray+}++# 4. 删除测试目录+Write-Host "`n[4/7] 删除 test/tests 测试目录..." -ForegroundColor Green+$testDirs = Get-ChildItem -Path $DistPath -Recurse -Directory | Where-Object { $_.Name -match '^tests?$' }+$testSize = 0+foreach ($dir in $testDirs) {+ $size = (Get-ChildItem -Path $dir.FullName -Recurse -File | Measure-Object -Property Length -Sum).Sum+ $testSize += $size+ Remove-Item -Path $dir.FullName -Recurse -Force+}+if ($testDirs.Count -gt 0) {+ Write-Host " 删除 $($testDirs.Count) 个目录,节省 $([math]::Round($testSize / 1MB, 2)) MB"+} else {+ Write-Host " 未发现测试目录(已优化)" -ForegroundColor Gray+}++# 5. 删除文档和示例+Write-Host "`n[5/7] 删除 docs/examples 文档目录..." -ForegroundColor Green+$docDirs = Get-ChildItem -Path $DistPath -Recurse -Directory | Where-Object { $_.Name -match '^(docs|examples|samples|demo)$' }+$docSize = 0+foreach ($dir in $docDirs) {+ $size = (Get-ChildItem -Path $dir.FullName -Recurse -File | Measure-Object -Property Length -Sum).Sum+ $docSize += $size+ Remove-Item -Path $dir.FullName -Recurse -Force+}+if ($docDirs.Count -gt 0) {+ Write-Host " 删除 $($docDirs.Count) 个目录,节省 $([math]::Round($docSize / 1MB, 2)) MB"+} else {+ Write-Host " 未发现文档目录(已优化)" -ForegroundColor Gray+}++# 6. 删除 .pyc 文件+Write-Host "`n[6/7] 删除 .pyc 字节码..." -ForegroundColor Green+$pycFiles = Get-ChildItem -Path $DistPath -Recurse -Include *.pyc -File+$pycSize = ($pycFiles | Measure-Object -Property Length -Sum).Sum / 1MB+if ($pycFiles.Count -gt 0) {+ $pycFiles | Remove-Item -Force+ Write-Host " 删除 $($pycFiles.Count) 个文件,节省 $([math]::Round($pycSize, 2)) MB"+} else {+ Write-Host " 未发现 .pyc 文件(已优化)" -ForegroundColor Gray+}++# 7. 精简 .dist-info 元数据+Write-Host "`n[7/7] 精简 .dist-info 元数据..." -ForegroundColor Green+$distInfoDirs = Get-ChildItem -Path $DistPath -Recurse -Directory -Filter "*.dist-info"+$removedCount = 0+$removedSize = 0+foreach ($infoDir in $distInfoDirs) {+ $filesToRemove = @("RECORD", "INSTALLER", "direct_url.json", "entry_points.txt")+ foreach ($fileName in $filesToRemove) {+ $file = Join-Path $infoDir.FullName $fileName+ if (Test-Path $file) {+ $size = (Get-Item $file).Length+ $removedSize += $size+ Remove-Item $file -Force+ $removedCount+++ }+ }+}+if ($removedCount -gt 0) {+ Write-Host " 删除 $removedCount 个元数据文件,节省 $([math]::Round($removedSize / 1MB, 2)) MB"+} else {+ Write-Host " 未发现可清理的元数据(已优化)" -ForegroundColor Gray+}++# 统计最终体积+$FinalSize = (Get-ChildItem -Path $DistPath -Recurse -File | Measure-Object -Property Length -Sum).Sum / 1MB+$SavedSize = $InitialSize - $FinalSize+$SavedPercent = if ($InitialSize -gt 0) { ($SavedSize / $InitialSize) * 100 } else { 0 }++Write-Host "`n========================================" -ForegroundColor Cyan+Write-Host "清理完成!" -ForegroundColor Green+Write-Host "========================================" -ForegroundColor Cyan+Write-Host "初始体积: $([math]::Round($InitialSize, 2)) MB" -ForegroundColor Yellow+Write-Host "最终体积: $([math]::Round($FinalSize, 2)) MB" -ForegroundColor Green+Write-Host "节省空间: $([math]::Round($SavedSize, 2)) MB ($([math]::Round($SavedPercent, 1))%)" -ForegroundColor Cyan+Write-Host "========================================`n" -ForegroundColor Cyan++# 对比 某商业级桌面应用+Write-Host "[对比参考]" -ForegroundColor Yellow+Write-Host "某商业级桌面应用 总体积: 323 MB (包含 PyQt, OpenCV, Playwright 等重量级库)" -ForegroundColor Gray+Write-Host "如果你的项目是纯 Tkinter + 标准库,目标应该在 80-150 MB" -ForegroundColor Gray+```++**预期效果**:节省 **15-30%** 体积++### 六、DLL 依赖分析工具++**保存为 `analyze_dlls.py`(用于找出体积大户)**:++```python+"""+DLL 依赖分析工具+参考 某商业级桌面应用 的 DLL 管理策略,帮助识别体积大户和优化建议+"""+import sys+from pathlib import Path++def analyze_dlls(dist_path: str):+ """分析 dist 目录中的 DLL 依赖"""+ dist_dir = Path(dist_path)++ if not dist_dir.exists():+ print(f"[错误] 目录不存在: {dist_path}")+ return++ print("=" * 70)+ print("DLL 依赖分析(参考 某商业级桌面应用 策略)")+ print("=" * 70)++ # 收集所有 DLL+ dll_files = list(dist_dir.rglob("*.dll"))++ if not dll_files:+ print("\n未发现 DLL 文件")+ return++ # 按大小排序+ dll_data = [(dll, dll.stat().st_size) for dll in dll_files]+ dll_data.sort(key=lambda x: x[1], reverse=True)++ total_size = sum(size for _, size in dll_data)++ print(f"\n总 DLL 数量: {len(dll_files)}")+ print(f"总 DLL 体积: {total_size / 1024 / 1024:.2f} MB\n")++ # 某商业级桌面应用 对比+ print("[对比参考] 某商业级桌面应用 的 DLL 情况:")+ print(" - 总数量: 71 个")+ print(" - 总体积: 93.23 MB")+ print(" - 最大的: libopenblas (26.85 MB), opengl32sw (15.25 MB)\n")++ # 分析大于 3MB 的 DLL+ large_dlls = [(dll, size) for dll, size in dll_data if size > 3 * 1024 * 1024]++ if large_dlls:+ print("=" * 70)+ print("⚠️ 大于 3MB 的 DLL(需重点关注)")+ print("=" * 70)++ for dll, size in large_dlls:+ size_mb = size / 1024 / 1024+ relative_path = dll.relative_to(dist_dir)+ name_lower = dll.name.lower()++ print(f"\n{size_mb:8.2f} MB {dll.name}")+ print(f" 位置: {relative_path.parent}")++ # 优化建议+ suggestions = get_optimization_suggestion(name_lower)+ if suggestions:+ for suggestion in suggestions:+ print(f" 💡 {suggestion}")++ # 检查冗余 DLL+ print("\n" + "=" * 70)+ print("🔍 冗余检查")+ print("=" * 70)++ # 检查调试版本+ debug_dlls = [dll for dll, _ in dll_data if dll.stem.endswith('d')]+ if debug_dlls:+ print(f"\n⚠️ 发现 {len(debug_dlls)} 个调试版本 DLL(可以删除):")+ for dll in debug_dlls:+ print(f" - {dll.name}")+ else:+ print("\n✅ 未发现调试版本 DLL(已优化)")++ # VC++ Runtime+ vc_runtimes = [dll for dll, _ in dll_data if 'vcruntime' in dll.name.lower() or 'msvcp' in dll.name.lower()]+ if vc_runtimes:+ print(f"\n[VC++ Runtime 库] 发现 {len(vc_runtimes)} 个:")+ for dll in vc_runtimes:+ size_mb = dll.stat().st_size / 1024 / 1024+ print(f" - {dll.name} ({size_mb:.2f} MB)")+ print(" 💡 这些是必需的,某商业级桌面应用 也包含了这些文件")++ # 全部 DLL 列表+ print("\n" + "=" * 70)+ print("📋 完整 DLL 列表(按体积排序,前 20)")+ print("=" * 70)+ print(f"\n{'体积 (MB)':>10} {'文件名':<30} 位置")+ print("-" * 70)++ for dll, size in dll_data[:20]:+ size_mb = size / 1024 / 1024+ relative_path = dll.relative_to(dist_dir)+ location = str(relative_path.parent) if relative_path.parent != Path('.') else "根目录"+ print(f"{size_mb:10.2f} {dll.name:<30} {location}")++ if len(dll_data) > 20:+ remaining_size = sum(size for _, size in dll_data[20:]) / 1024 / 1024+ print(f"... 还有 {len(dll_data) - 20} 个 DLL,共 {remaining_size:.2f} MB")+++def get_optimization_suggestion(dll_name: str) -> list:+ """根据 DLL 名称给出优化建议"""+ suggestions = []++ if "openblas" in dll_name or "mkl" in dll_name:+ suggestions.append("数学运算库,某商业级桌面应用 的 libopenblas 有 26.85 MB")+ suggestions.append("如不需要高性能计算可考虑轻量版")++ elif "opencv" in dll_name or "ffmpeg" in dll_name:+ suggestions.append("OpenCV 相关,某商业级桌面应用 的 opencv_videoio_ffmpeg 有 18.48 MB")+ suggestions.append("考虑用 opencv-python-headless")++ elif "qt5" in dll_name or "qt6" in dll_name or "pyside" in dll_name:+ suggestions.append("Qt 库,某商业级桌面应用 的 Qt5Core 有 5.13 MB")+ suggestions.append("可排除不需要的模块(WebEngine, 3D, Charts)")++ elif "opengl" in dll_name and "sw" in dll_name:+ suggestions.append("OpenGL 软件渲染器,某商业级桌面应用 保留了 15.25 MB")+ suggestions.append("通常可以删除(使用硬件渲染)")++ elif "d3dcompiler" in dll_name:+ suggestions.append("DirectX 编译器,某商业级桌面应用 有 3.53 MB")++ elif "mfc140" in dll_name:+ suggestions.append("MFC 库,某商业级桌面应用 有 4.89 MB")++ return suggestions+++if __name__ == "__main__":+ if len(sys.argv) < 2:+ print("用法: python analyze_dlls.py <dist目录路径>")+ print("示例: python analyze_dlls.py dist/main.dist")+ sys.exit(1)++ analyze_dlls(sys.argv[1])+```++**使用方法**:+```bash+python analyze_dlls.py dist/你的软件名.dist+```++---++## 📋 完整优化工作流++### 步骤 1:修改编译脚本配置++编辑 `build_optimized.bat`,修改这 3 行:++```batch+set APP_NAME=你的软件名 REM 改成实际名称+set MAIN_FILE=main.py REM 你的主程序文件+set ICON_FILE=icon.ico REM 你的图标文件+```++### 步骤 2:一键编译+瘦身++```bash+# 在项目根目录执行+build_optimized.bat+```++### 步骤 3:分析 DLL 依赖++```bash+python analyze_dlls.py dist/你的软件名.dist+```++### 步骤 4:根据分析结果优化++**如果用了 OpenCV** → 改用无头版+```bash+pip uninstall opencv-python+pip install opencv-python-headless+```++**如果用了 Qt** → 排除不需要的模块+```batch+# 在编译命令中添加+--nofollow-import-to=PyQt5.QtWebEngine,PyQt5.Qt3D,PyQt5.QtCharts+```++**删除软件渲染器**(如果不需要)+```powershell+# 在 dist 目录执行+Remove-Item "opengl32sw.dll" -Force+```++---++## 🎯 VC++ 运行库处理方案++### 方案一:静态链接(推荐)+```bash+nuitka --static-libpython=yes ...+```++### 方案二:捆绑运行库安装(商业发布推荐)+在 Inno Setup 脚本中添加:++```iss+[Files]+Source: "{#MySourceDir}\..\vc_redist.x64.exe"; DestDir: "{tmp}"; Flags: deleteafterinstall++[Run]+Filename: "{tmp}\vc_redist.x64.exe"; Parameters: "/quiet /norestart"; StatusMsg: "正在安装运行库..."; Flags: waituntilterminated+```++> 下载地址:[Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist)++---++## 📜 Inno Setup 脚本模板(商业终极版)++```iss+; =====================================================================+; ⚠️ 商业级 Python 安装脚本 (Inno Setup 6.x)+; 特性:LZMA2 极限压缩 | 全中文 | 完整元数据 | 无残留卸载+; 参考:某商业级桌面应用 (323 MB, LZMA2 压缩)+; =====================================================================++; --- 1. 参数定义 ---+#define MyAppName "{{APP_NAME}}"+#define MyAppVersion "{{APP_VERSION}}"+#define MyAppPublisher "{{PUBLISHER}}"+#define MyAppURL "{{APP_URL}}"+#define MyAppExeName "{{EXE_NAME}}"+#define MySourceDir "{{SOURCE_DIR}}"+#define MyOutputDir "{{OUTPUT_DIR}}"+;#define MyIconPath "{{ICON_PATH}}"++[Setup]+; --- 身份识别 ---+AppId={{GENERATE_RANDOM_GUID}}+AppName={#MyAppName}+AppVersion={#MyAppVersion}+AppPublisher={#MyAppPublisher}+AppPublisherURL={#MyAppURL}+AppSupportURL={#MyAppURL}+AppUpdatesURL={#MyAppURL}++; --- 安装路径与权限 ---+DefaultDirName={autopf}\{#MyAppName}+DefaultGroupName={#MyAppName}+DisableDirPage=no+DisableProgramGroupPage=no+PrivilegesRequired=admin++; --- 输出设置 ---+OutputDir={#MyOutputDir}+OutputBaseFilename=Setup_{#MyAppName}_v{#MyAppVersion}++; --- 视觉体验 ---+WizardStyle=modern+#ifdef MyIconPath+SetupIconFile={#MyIconPath}+UninstallDisplayIcon={app}\{#MyAppExeName}+#endif++; --- 🚀 核心压缩 (参考 某商业级桌面应用) ---+Compression=lzma2/ultra64+SolidCompression=yes+LZMAUseSeparateProcess=yes++; --- 架构 ---+ArchitecturesInstallIn64BitMode=x64compatible++[Languages]+Name: "chinesesimplified"; MessagesFile: "compiler:Languages\ChineseSimplified.isl"++[Files]+Source: "{#MySourceDir}\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs createallsubdirs++[UninstallDelete]+Type: filesandordirs; Name: "{app}\*"++[Icons]+Name: "{autodesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"; Tasks: desktopicon+Name: "{group}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"+Name: "{group}\卸载 {#MyAppName}"; Filename: "{uninstallexe}"++[Tasks]+Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked++[Run]+Filename: "{app}\{#MyAppExeName}"; Description: "{cm:LaunchProgram,{#MyAppName}}"; Flags: nowait postinstall skipifsilent+```++---++## 占位符说明++| 占位符 | 说明 | 示例值 |+|--------|------|--------|+| `{{APP_NAME}}` | 软件显示名称 | `红墨批注` |+| `{{APP_VERSION}}` | 版本号 | `1.0.0` |+| `{{PUBLISHER}}` | 发布者/公司名 | `MyCompany` |+| `{{APP_URL}}` | 官网地址 | `https://example.com` |+| `{{EXE_NAME}}` | 主程序文件名 | `RedInk.exe` |+| `{{SOURCE_DIR}}` | Nuitka dist 文件夹路径 | `D:\project\dist\RedInk.dist` |+| `{{OUTPUT_DIR}}` | 安装包输出路径 | `D:\project\output` |+| `{{ICON_PATH}}` | 图标文件路径 | `D:\project\icon.ico` |+| `{{GENERATE_RANDOM_GUID}}` | **需生成唯一GUID** | 使用 Inno Setup "Tools > Generate GUID" |++---++## 常见问题 (FAQ)++### Q1: 安装后双击程序无反应?+1. 打开 CMD,手动运行 exe 查看错误信息+2. 检查是否缺少 VC++ 运行库+3. 检查 Nuitka 编译是否成功++### Q2: 安装包体积过大?+**优化方法**:+1. 使用 32 位 Python 编译(节省 20-30%)+2. 应用 某商业级桌面应用 的模块排除清单+3. 启用 Anti-Bloat 插件+4. 执行 dist 文件夹瘦身脚本+5. 分析 DLL,移除不必要的大文件++### Q3: 杀毒软件误报?+**解决方案**:+- 提交到主流杀毒厂商进行白名单申请+- 购买代码签名证书(推荐:Sectigo, DigiCert)+- 避免使用 UPX 压缩++### Q4: 安装时提示 Windows 已保护你的电脑?+- 购买 EV 代码签名证书(可立即获得信任)+- 普通代码签名证书需要积累安装量后逐渐获得信任++---++## 实战问题处理记录(更新 2026-02-07)++- **安装后提示缺少 python3xx.dll**:必须使用 Nuitka `--standalone`;确认 dist 内存在该 dll;不要打单文件版。+- **安装后点击无反应**:GUI 启动期可能被重依赖阻塞;将重依赖延迟到"开始导出"再 import;添加日志排查。+- **Nuitka + MinGW 在非 ASCII 路径报错**:把源码复制到 ASCII 目录再编译;设置 `PYTHONIOENCODING=utf-8`。+- **Inno Setup 警告 `x64` 已弃用**:改为 `ArchitecturesInstallIn64BitMode=x64compatible`。+- **`--disable-console` 已废弃**:改用 `--windows-console-mode=disable`。+- **dist 出现 `_nuitka_temp.exe`**:在 [Files] 中排除它。++---++## 优化效果预期++| 优化组合 | 体积减少 | 启动提升 | 风险等级 |+|----------|----------|----------|----------|+| 基础编译 | 基准 | 基准 | 无 |+| + `--lto=yes` | 5-10% | 10-20% | ✅ 无 |+| + anti-bloat | 15-25% | - | ✅ 无 |+| + 模块排除 | 20-35% | 5% | ✅ 无 |+| + dist 瘦身 | 25-40% | - | ✅ 无 |+| + 32 位编译 | 40-60% | - | ✅ 无 |+| **全部组合** | **45-65%** | **15-25%** | ✅ **无风险** |++> ⚠️ **不建议使用 UPX 压缩**,虽然能进一步减小体积,但极易触发杀毒软件误报。++---++**基于 某商业级桌面应用 实战经验优化,助你打造商业级安装包!** 🚀