# Nuitka 构建工具

**Repository Path**: deepboat/nuitka---build-tool

## Basic Information

- **Project Name**: Nuitka 构建工具
- **Description**: 作者风行者出品 | Python Nuitka可视化构建工具 | 用Flutter重新定义Python编译体验 | AI分析+美观界面+一键操作 | 让复杂的事情变简单

- **Primary Language**: Dart
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 13
- **Created**: 2025-09-01
- **Last Updated**: 2025-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python Nuitka 构建工具

<div align="center">

![Python Nuitka Builder](images/cover.svg)

[![Flutter](https://img.shields.io/badge/Flutter-3.35.1-blue.svg)](https://flutter.dev/)
[![Nuitka](https://img.shields.io/badge/Nuitka-2.7.12-green.svg)](https://nuitka.net/)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/Platform-Windows-lightgrey.svg)](https://www.microsoft.com/windows)

**一个基于Flutter开发的Python Nuitka可视化构建工具，让Python编译变得简单高效！**

[📖 使用文档](#使用指南) | [🚀 快速开始](#快速开始) | [💡 功能特色](#功能特色) | [🤝 贡献指南](#贡献指南)

</div>

## ✨ 功能特色

### 🎯 核心功能
- **🤖 AI智能分析**：自动检测Python代码特征，智能推荐构建参数
- **🎨 可视化配置**：告别复杂命令行，图形化界面轻松配置
- **📊 实时监控**：构建过程可视化，日志实时显示
- **📋 一键复制**：生成的命令可直接复制到终端执行
- **🎪 美观界面**：Material Design 3设计，支持深色/浅色主题

### 🛠️ 技术特色
- **跨平台**：基于Flutter开发，原生Windows性能
- **智能检测**：自动识别GUI框架（tkinter、PyQt、wxPython等）
- **参数验证**：确保所有参数与Nuitka 2.7.12兼容
- **配置管理**：支持配置导入/导出，便于项目管理

## 🚀 快速开始

### 环境要求
- Windows 10/11
- Python 3.7+
- Nuitka 2.7.12+
- Flutter 3.35.1+（开发环境）

### 安装步骤

1. **克隆项目**
```bash
git clone https://github.com/yourusername/python-nuitka-builder.git
cd python-nuitka-builder
```

2. **安装依赖**
```bash
flutter pub get
```

3. **运行应用**
```bash
flutter run -d windows
```

### 使用指南

#### 📝 第一步：项目设置
1. 打开应用，点击"项目设置"
2. 填写项目基本信息（名称、版本、描述等）
3. 设置输出目录和图标文件

#### ⚙️ 第二步：构建配置
1. 选择要编译的Python文件
2. 配置构建参数：
   - **优化级别**：选择合适的优化程度
   - **输出模式**：单文件或目录模式
   - **插件选择**：根据代码依赖选择插件
3. 点击"AI分析"获取智能建议

#### 🔍 第三步：AI智能分析
系统会自动分析您的Python代码：
- 检测GUI框架使用情况
- 识别print语句和控制台输出
- 推荐最佳构建参数
- 提供优化建议

#### 🚀 第四步：开始构建
1. 检查生成的命令预览
2. 点击"开始构建"或复制命令到终端
3. 实时查看构建进度和日志
4. 构建完成后测试生成的exe文件

## 📸 界面预览

### 主界面
![主界面](images/final-ui.svg)

### AI智能分析
![AI分析](images/smart-analysis.svg)

### 构建监控
![构建监控](images/build-monitor.svg)

## 🔧 配置说明

### 基础配置
```yaml
项目名称: 您的项目名称
版本号: 1.0.0
输出目录: ./dist
图标文件: icon.ico (可选)
```

### 高级配置
```yaml
优化级别: 
  - 无优化 (--no-optimization)
  - 基础优化 (默认)
  - 高级优化 (--optimization-level=advanced)

输出模式:
  - 单文件模式 (--onefile)
  - 目录模式 (默认)

插件配置:
  - 自动检测常用插件
  - 支持手动添加特殊插件
```

## 🤖 AI分析功能

### 智能检测项目
- **GUI框架检测**：tkinter、PyQt5/6、wxPython、Kivy等
- **依赖分析**：numpy、pandas、requests等常用库
- **控制台输出**：print语句和日志输出检测
- **文件操作**：文件读写和路径操作分析

### 智能建议
- 根据代码特征推荐优化级别
- 自动选择合适的插件
- 建议是否禁用控制台窗口
- 提供性能优化建议

## 📚 常见问题

### Q: 构建失败怎么办？
A: 
1. 检查Python和Nuitka版本是否兼容
2. 确认所有依赖库已正确安装
3. 查看构建日志中的错误信息
4. 尝试使用不同的优化级别

### Q: 生成的exe文件很大？
A: 
1. 使用`--onefile`模式
2. 启用高级优化
3. 排除不必要的模块
4. 使用UPX压缩（需额外安装）

### Q: 如何添加自定义插件？
A: 
1. 在构建配置页面找到"插件配置"
2. 点击"添加自定义插件"
3. 输入插件名称（如：tk-inter、numpy等）

## 🤝 贡献指南

我们欢迎所有形式的贡献！

### 如何贡献
1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

### 开发环境设置
```bash
# 克隆项目
git clone https://github.com/yourusername/python-nuitka-builder.git

# 安装依赖
flutter pub get

# 运行测试
flutter test

# 构建应用
flutter build windows
```

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 💖 赞助支持

如果这个工具对您有帮助，欢迎赞助支持项目的持续开发：

**👉 [赞助链接](http://122.152.227.49/startpage/)** (支持微信/支付宝)
![输入图片说明](wxzj.jpg)

查看详细的赞助信息：[SPONSOR.md](SPONSOR.md)

## 👨‍💻 作者信息

- **作者**：风行者
- **QQ**：45561810
- **公众号**：Auto编程
- **技术交流群**：951416878

## 🙏 致谢

感谢以下开源项目：
- [Flutter](https://flutter.dev/) - 跨平台UI框架
- [Nuitka](https://nuitka.net/) - Python编译器
- [Material Design](https://material.io/) - 设计系统

## 📈 项目统计

![GitHub stars](https://img.shields.io/github/stars/yourusername/python-nuitka-builder?style=social)
![GitHub forks](https://img.shields.io/github/forks/yourusername/python-nuitka-builder?style=social)
![GitHub issues](https://img.shields.io/github/issues/yourusername/python-nuitka-builder)
![GitHub pull requests](https://img.shields.io/github/issues-pr/yourusername/python-nuitka-builder)

---

<div align="center">

**如果这个项目对您有帮助，请给个 ⭐ Star 支持一下！**

**💖 [点击赞助项目](http://122.152.227.49/startpage/) | 让开源更有动力！**

[🏠 返回顶部](#python-nuitka-构建工具)

</div>