# 派铸

**Repository Path**: deepin20/PyForge

## Basic Information

- **Project Name**: 派铸
- **Description**: PyForge（派铸）是一款基于 PySide6 的 PyInstaller 图形化前端工具，旨在降低 Python 应用打包的门槛。通过简洁直观的图形界面，您可以轻松配置 PyInstaller 参数，一键生成可执行文件，无需记忆复杂的命令行选项。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-18
- **Last Updated**: 2026-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PyForge 派铸

[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![PySide6](https://img.shields.io/badge/PySide6-6.6+-green.svg)](https://doc.qt.io/qtforpython/)
[![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)

**PyForge（派铸）** 是一款基于 PySide6 的 **PyInstaller 图形化前端工具**，旨在降低 Python 应用打包的门槛。通过简洁直观的图形界面，您可以轻松配置 PyInstaller 参数，一键生成可执行文件，无需记忆复杂的命令行选项。

---

## ✨ 特性

- 🖥️ **图形化配置** – 无需命令行，所有打包选项一目了然。
- 📦 **双模式打包** – 支持 `--onefile`（单文件）和 `--onedir`（单目录）模式。
- 🔧 **丰富的选项** – 隐藏控制台、UPX 压缩、优化级别、自定义图标等。
- 📂 **数据与二进制文件** – 轻松添加额外数据文件或动态库，支持拖拽和目录递归。
- 🧩 **隐藏导入管理** – 解决 PyInstaller 自动扫描遗漏的模块。
- ⚙️ **高级选项** – 额外路径、排除模块、加密密钥、运行时钩子、版本文件等。
- 📋 **命令预览** – 查看即将执行的完整 PyInstaller 命令，便于调试。
- 🌓 **主题切换** – 支持浅色/暗色主题，保护视力。
- 🌐 **多语言支持** – 内置中英文界面，随语言切换。
- 💾 **配置持久化** – 保存/加载配置 JSON 文件，方便复用。
- 🚦 **实时日志** – 打包过程日志实时显示，支持复制和保存。
- ⌨️ **快捷键** – 常用操作（新建、打开、保存、打包等）均有快捷键。

---

## 📸 界面预览

> 由于本项目处于开发中，暂无正式截图。您可自行运行体验。

---

## 🖥️ 系统要求

- **操作系统**：Linux（Deepin/Ubuntu 等）、macOS 或 Windows（需支持 PySide6 的 Qt 平台插件）
- **Python**：3.8 及以上版本
- **依赖库**：PySide6 ≥ 6.6.0，PyInstaller ≥ 6.0.0

---

## 🚀 快速开始

### 1. 克隆项目
```bash
git clone https://github.com/your-repo/PyForge.git
cd PyForge
```

### 2. 运行启动脚本（推荐）
```bash
chmod +x run.sh
./run.sh
```
脚本会自动创建虚拟环境、安装依赖，并启动 PyForge。

### 3. 手动安装（可选）
```bash
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python src/pyinstaller_gui/main.py
```

---

## 📖 使用指南

1. **选择主脚本** – 点击“浏览”选择待打包的 `.py` 入口文件。
2. **设置打包模式** – 选择“单文件”或“单目录”。
3. **配置选项** – 根据需求勾选隐藏控制台、禁用 UPX、优化级别。
4. **输出设置** – 自定义应用名称、输出目录，并可选择图标（Windows `.ico` / macOS `.icns`）。
5. **依赖管理** – 在“数据文件”和“二进制文件”标签页中添加额外文件；在“隐藏导入”列表中添加遗漏的模块。
6. **高级选项**（可选） – 展开“高级选项”面板，添加额外路径、排除模块、加密密钥等。
7. **执行操作** – 点击“开始锻造”开始打包，或“仅生成 Spec”生成 `.spec` 文件。您也可以点击“预览命令”查看完整命令行。
8. **查看日志** – 右侧日志面板实时显示打包输出，支持清空、复制和保存到文件。
9. **配置持久化** – 使用“保存配置”和“加载配置”管理不同项目的设置。

---

## ⌨️ 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+N` | 新建配置 |
| `Ctrl+O` | 打开配置 |
| `Ctrl+S` | 保存配置 |
| `Ctrl+Shift+S` | 另存为 |
| `Ctrl+Q` | 退出 |
| `Ctrl+B` | 开始打包 |
| `Ctrl+E` | 仅生成 Spec |

---

## 🛠 贡献指南

我们欢迎任何形式的贡献！如果您想参与开发，请遵循以下步骤：

1. Fork 本项目。
2. 创建您的特性分支：`git checkout -b feature/your-feature`
3. 提交您的改动：`git commit -m "Add some feature"`
4. 推送到分支：`git push origin feature/your-feature`
5. 提交 Pull Request。

### 开发环境准备
```bash
pip install -r requirements-dev.txt  # 包含 pytest、black 等
```

---

## 📄 许可证

本项目基于 [MIT License](LICENSE) 开源，您可以自由使用、修改和分发。

---

## 📞 联系我们

- **项目主页**：[GitHub](https://github.com/your-repo/PyForge)
- **问题反馈**：[Issues](https://github.com/your-repo/PyForge/issues)
- **邮箱**：your-email@example.com（可选）

---

## ❓ 常见问题

**Q：打包后程序无法运行？**  
A：请检查控制台日志中的错误信息。常见原因包括缺少依赖、数据文件路径错误或隐藏导入不全。可尝试在高级选项中添加相应模块或路径。

**Q：Linux 下图标无效？**  
A：PyInstaller 在 Linux 下不支持嵌入图标，这是正常现象。您可以在 .desktop 文件中指定图标。

**Q：UPX 压缩无效？**  
A：确保系统已安装 UPX 可执行文件，并在 PATH 中。或者使用高级选项指定 `--upx-dir`。

**Q：如何彻底清理虚拟环境？**  
A：删除 `venv` 目录后重新运行 `./run.sh` 即可。

---

## 📝 更新日志

- **v0.2.0**（2026-08）：增加高级选项、二进制文件支持、进度细化、主题切换、配置持久化、快捷键等。
- **v0.1.0**（初始版本）：基础打包功能、日志显示、数据文件管理。

---

感谢您使用 PyForge！希望它能成为您 Python 打包的得力助手 🚀
```

---

## 说明

- **填写占位信息**：请将 `https://github.com/your-repo/PyForge` 替换为实际仓库地址，邮箱等可选。
- **截图**：可后续添加实际运行截图。
- **更新日志**：可根据实际版本调整。