# 壹像

**Repository Path**: deepin20/oneimage

## Basic Information

- **Project Name**: 壹像
- **Description**: 壹像是一款专为 Linux 开发者设计的图形化工具，帮助你轻松创建AppImage格式的独立可执行文件。无需处理复杂的依赖关系、库路径和构建脚本，只需在友好的界面中配置项目，即可生成一个“一次构建，到处运行”的 AppImage。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-08
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🏮 壹像 (OneImage)

**图形化 AppImage 打包工坊**  
将你的应用和所有依赖一键打包成可移植的 AppImage。

[![版本](https://img.shields.io/badge/版本-0.9.0--beta-blue)](https://github.com/your-repo/oneimage/releases)
[![许可证](https://img.shields.io/badge/许可证-GPLv3-green)](LICENSE)
[![Python](https://img.shields.io/badge/Python-3.10+-blue)](https://www.python.org/)

---

## 📖 简介

**壹像** 是一款专为 Linux 开发者设计的图形化工具，帮助你轻松创建 **AppImage** 格式的独立可执行文件。无需处理复杂的依赖关系、库路径和构建脚本，只需在友好的界面中配置项目，即可生成一个“一次构建，到处运行”的 AppImage。

无论你是独立开发者、开源项目维护者，还是企业软件打包团队，壹像都能显著简化你的打包流程，让你专注于应用本身。

---

## ✨ 主要特性

- **🖥️ 图形化界面** – 基于 PyQt6 构建，直观易用，无需记忆命令行参数。
- **📁 项目化管理** – 创建、保存、打开项目文件 (`.oneimage`)，支持最近项目快速访问。
- **🔨 构建步骤编辑** – 可视化添加、删除、排序构建命令（如 `make`, `cmake`），支持工作目录和环境变量。
- **🧊 智能依赖分析** – 自动扫描可执行文件的依赖库（基于 `ldd`），高亮系统库与用户库，可选择性打包。
- **📦 一键打包** – 自动生成 `AppRun`、`.desktop` 文件，支持多种压缩级别（高/低/无），可选 GPG 签名。
- **🧪 内置测试** – 打包完成后可直接运行测试，验证 AppImage 是否可正常启动。
- **🧹 缓存清理** – 一键清理构建缓存、日志和临时文件，释放磁盘空间。
- **🌐 跨平台（即将支持）** – 目前已在 Deepin 25 上稳定运行，计划支持 Ubuntu、Fedora 等主流发行版。

---

## 🖼️ 截图

> 🚧 截图占位，请访问 [项目主页](https://github.com/your-repo/oneimage) 查看最新截图。

---

## 📋 系统要求

- **操作系统**：Linux（Deepin 25 / Ubuntu 20.04+ / Debian 11+ / Fedora 34+）
- **Python**：3.10 或更高版本
- **Qt 依赖**：PyQt6（自动安装）
- **系统工具**（可选但推荐）：
  - `ldd` – 依赖分析（通常已安装）
  - `mksquashfs` – AppImage 打包（需安装 `squashfs-tools`）
  - `zsync` – 增量更新支持（可选）

---

## 📦 安装

### 方法一：Debian 包（推荐）

下载最新的 `.deb` 包并安装：

```bash
sudo dpkg -i oneimage_0.9.0-beta_amd64.deb
sudo apt-get install -f   # 解决依赖
```

安装后，可在应用菜单中找到「壹像」，或在终端运行：

```bash
oneimage
```

### 方法二：从源码运行

```bash
# 克隆仓库
git clone https://github.com/your-repo/oneimage-project.git
cd oneimage-project

# 创建虚拟环境（可选）
python3 -m venv venv
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 运行
./run.sh
```

---

## 🚀 快速使用指南

1. **新建项目** – 点击“文件 → 新建项目”，填写基本信息（名称、版本、架构）。
2. **设置路径** – 指定源码目录、编译后的可执行文件、输出目录。
3. **添加构建步骤**（可选）– 在“源码构建”页面添加编译命令（如 `make -j4`）。
4. **分析依赖** – 在“依赖分析”页面扫描可执行文件，勾选需要打包的库。
5. **填写元数据** – 在“桌面元数据”页面设置应用显示名称、图标、分类等。
6. **打包** – 在“打包流水线”页面配置输出文件名和压缩级别，点击“开始打包”。
7. **测试** – 打包完成后点击“测试”验证 AppImage 是否可正常运行。

---

## 🧪 开发状态

当前版本为 **0.9.0 Beta**，核心功能已稳定，但仍处于积极开发中。我们欢迎任何反馈、建议和贡献。

- **路线图**：
  - ✅ 项目管理系统
  - ✅ 依赖分析
  - ✅ AppDir 构建
  - ✅ 打包流水线
  - 🔄 多语言支持（i18n）
  - 🔄 自动化测试
  - 🔄 插件系统（计划）

---

## 🤝 贡献

我们非常欢迎社区参与！无论是报告 Bug、提交功能请求，还是贡献代码，都是对项目的巨大支持。

1. Fork 仓库
2. 创建你的功能分支 (`git checkout -b feature/amazing-feature`)
3. 提交你的更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 打开一个 Pull Request

请确保你的代码符合 PEP 8 规范，并添加必要的测试。

---

## 📄 许可证

本项目使用 **GNU General Public License v3.0** 开源协议。详情请见 [LICENSE](LICENSE) 文件。

---

## 🙏 致谢

- [PyQt6](https://www.riverbankcomputing.com/software/pyqt/) – 强大的 GUI 框架
- [appimagetool](https://github.com/AppImage/AppImageKit) – AppImage 打包工具
- [AppImage 社区](https://appimage.org/) – 提供 AppImage 规范和工具链

---

**壹像** —— 让打包变得简单。