# software-update

**Repository Path**: fangjiayu/software-update

## Basic Information

- **Project Name**: software-update
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-18
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UpdateHub - 跨平台本地软件更新管理器 ⚡

<div align="center">

[![Status](https://img.shields.io/badge/Status-Archived%20%2F%20No%20Longer%20Maintained-red.svg)](https://gitee.com/fangjiayu/software-update)
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Tauri](https://img.shields.io/badge/Tauri-v2-orange.svg)](https://tauri.app/)
[![Vue](https://img.shields.io/badge/Vue-3.5-brightgreen.svg)](https://vuejs.org/)
[![Rust](https://img.shields.io/badge/Rust-2021-black.svg)](https://www.rust-lang.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-6.0-blue.svg)](https://www.typescriptlang.org/)

**一款基于 Tauri v2 + Rust + Vue 3 的极轻量跨平台软件更新与管理桌面客户端**

[简体中文](README.md) · [English](README_EN.md) · [Gitee 仓库](https://gitee.com/fangjiayu/software-update)

</div>

---

> [!CAUTION]
> ### ⚠️ 停止维护通知 (Project Archived / End of Maintenance)
> **本项目已正式停止更新与维护（Archived / No Longer Maintained）。**  
> 仓库代码完整保留，仅供开源社区学习、参考与研究使用。不再接收新的功能请求或问题修复。  
> 欢迎开发者遵循 [MIT 开源许可证](LICENSE) 自由 Fork、魔改或二次开发。  
> 仓库地址：[https://gitee.com/fangjiayu/software-update.git](https://gitee.com/fangjiayu/software-update.git)

---

## 📸 界面预览 (Screenshots)

### 主界面 - 应用更新中心
![UpdateHub 软件更新中心预览](./docs/screenshots/overview.png)

> **界面特性**：深色现代科技风设计，侧边栏集成任务队列与包管理器连接状态，主区域提供应用列表、版本对比、一键更新与详细气泡卡片。

---

## 🛠️ 所用技术栈 (Technology Stack)

UpdateHub 采用现代化前后端分离架构，前端专注流畅的交互体验，原生端利用 Rust 实现高并发检测与底层系统级命令调度：

### 1. 前端技术 (Frontend)
- **核心框架**：[Vue 3](https://vuejs.org/) (v3.5.13) - 采用 Composition API 与 `<script setup>` 响应式编程模型
- **开发语言**：[TypeScript](https://www.typescriptlang.org/) (~v6.0.3) - 全流程类型强约束，杜绝运行时类型错误
- **构建工具**：[Vite](https://vitejs.dev/) (v8.0.16) - 现代化的极速前端开发构建服务器
- **图标系统**：[Lucide Vue Next](https://lucide.dev/) (v1.0.0) - 清晰简洁的现代化矢量图标套件
- **样式与交互**：现代化原生 CSS3，支持纯粹的暗色模式、磨砂玻璃视觉微质感（Glassmorphism）、平滑过渡动效、响应式任务进度条

### 2. 桌面框架与原生核心 (Desktop & Native Backend)
- **应用壳框架**：[Tauri v2](https://tauri.app/) (`@tauri-apps/cli` v2, `@tauri-apps/api` v2) - 极简内存开销（典型仅占 30-50MB 内存，相比 Electron 节省 80%+ 资源）
- **核心语言**：[Rust](https://www.rust-lang.org/) (Edition 2021) - 内存绝对安全、极致并发性能的系统级语言
- **异步运行时**：[Tokio](https://tokio.rs/) (v1, `features = ["full"]`) - 高性能异步事件循环，驱动多数据源并行并发扫描与非阻塞执行
- **序列化与通信**：[Serde](https://serde.rs/) & `serde_json` - 高效零拷贝序列化，保障 Rust 与 Web 视图 IPC 高频通信
- **接口抽象**：`async-trait` - 规范化多包管理器适配器插件架构
- **正则与文本处理**：`regex` - 高效提取应用版本号与实时终端进度百分比
- **原生能力扩展**：`@tauri-apps/plugin-opener` - 安全调用系统浏览器打开主页及唤起本地路径

### 3. 多源包管理与更新适配层 (Package Adapters)
通过定义可插拔的 `PackageAdapter` 特性，统一抽象不同平台的软件包检测与更新协议：
- **macOS GUI 应用 (`MacAppsAdapter`)**：深度扫描 `/Applications`，解析 `.app/Contents/Info.plist`，提取版本与 Sparkle (`SUFeedURL`) 更新源
- **Homebrew (`HomebrewAdapter`)**：适配 Homebrew Cask 桌面应用与 Formulae 命令行工具包检测与增量升级
- **NPM 全局包 (`NpmGlobalAdapter`)**：检测全局 Node.js CLI 工具版本并调用 `npm install -g` 升级
- **Cargo 全局包 (`CargoGlobalAdapter`)**：查询本地 `cargo install --list`，对比 Crates.io 最新版本并执行编译更新
- **系统 CLI 工具 (`SystemCliAdapter`)**：检测常用开发者工具链（Git, Node, Rust, Python, Go, Docker 等）
- **Windows Winget (`WingetAdapter`)**：提供 Windows 平台官方包管理器检查及更新适配

---

## ✨ 核心功能特性 (Key Features)

- ⚡ **聚合更新仪表盘**：统一管理桌面应用程序、CLI 工具和全局开发包，一键扫描本机全部可更新软件。
- 🔄 **实时日志终端**：Rust 底层通过 Tokio MPSC 通道流式捕获进程的标准输出与错误流，前端实时终端弹窗展示执行细节。
- ⏸️ **任务队列与断点控制**：
  - 支持更新任务进度实时计算（下载、解压、校验、配置阶段）。
  - 支持任务单项暂停 (Pause) 与继续 (Resume)，支持批量全部暂停 / 全部继续。
  - 支持异常退出后状态持久化，再次打开自动恢复已暂停进度。
- 📜 **更新历史记录**：自动记录历史升级版本变更、时间与最终状态，支持关键字搜索、批量选中、单项删除与一键清空。
- 🛡️ **退出保护防损坏**：有正在运行的更新任务时，拦截窗口直接关闭并弹出确认弹窗，防止破坏本地安装环境。
- 🔍 **多维度筛选与排序**：支持按照应用名称、更新状态、应用类型（桌面/命令行）、版本号自由排序及实时关键字过滤。

---

## 📂 项目目录结构 (Directory Structure)

```text
software-update/
├── docs/                        # 项目文档与截图资源
│   └── screenshots/
│       └── overview.png         # 应用界面截图
├── src/                         # Vue 3 前端工程
│   ├── assets/                  # 静态资源
│   ├── App.vue                  # UpdateHub 核心交互界面与业务逻辑
│   ├── main.ts                  # 前端入口文件
│   └── vite-env.d.ts            # Vite 类型定义
├── src-tauri/                   # Tauri v2 + Rust 后端工程
│   ├── src/
│   │   ├── adapters/            # 多源包管理器适配器模块
│   │   │   ├── cargo_global.rs  # Cargo Crates 适配器
│   │   │   ├── homebrew.rs      # Homebrew 适配器
│   │   │   ├── macos_apps.rs    # macOS 本地 App 扫描适配器
│   │   │   ├── npm_global.rs    # NPM 全局包适配器
│   │   │   ├── system_cli.rs    # 系统 CLI 命令行适配器
│   │   │   └── winget.rs        # Windows Winget 适配器
│   │   ├── manager.rs           # 统一更新管理器 (UpdateManager)
│   │   ├── models.rs            # 数据模型定义与 PackageAdapter Trait
│   │   ├── lib.rs               # Tauri 命令注册与事件监听
│   │   └── main.rs              # 应用程序原生入口
│   ├── Cargo.toml               # Rust 依赖配置
│   └── tauri.conf.json          # Tauri 应用及窗口配置
├── package.json                 # 前端依赖与脚本配置
├── vite.config.ts               # Vite 构建配置
├── tsconfig.json                # TypeScript 配置文件
├── LICENSE                      # MIT 开源许可证
├── README.md                    # 中文说明文档
└── README_EN.md                 # 英文说明文档
```

---

## 🚀 本地开发与构建指南 (Getting Started)

> 注：本项目已归档，以下为历史构建指南，供开发者参考。

### 环境依赖
- [Node.js](https://nodejs.org/) (建议 v18 及以上) 与 npm
- [Rust](https://www.rust-lang.org/) (建议最新稳定版，使用 rustup 安装)
- 各平台 Tauri 前置依赖环境（详情参考 [Tauri 官方先决条件指南](https://tauri.app/start/prerequisites/)）

### 1. 克隆代码仓库
```bash
git clone https://gitee.com/fangjiayu/software-update.git
cd software-update
```

### 2. 安装前端依赖
```bash
npm install
```

### 3. 运行开发环境
```bash
npm run tauri dev
```

### 4. 编译打包生成可执行文件
```bash
npm run tauri build
```
打包生成的文件将位于 `src-tauri/target/release/bundle/` 目录下。

---

## 📄 开源许可证 (License)

本项目采用 [MIT License](LICENSE) 许可证发布。代码版权归属于原作者所有。
你可以自由地阅读、学习、修改、分发该项目的代码，但须保留原许可信息与免责声明。