mirror of
https://gitee.com/spark-store-project/spark-store
synced 2026-04-26 01:10:16 +08:00
docs: 更新项目文档以反映从APM到星火应用商店的变更
更新项目名称、仓库地址、技术栈和目录结构,新增配套工具Spark Update Tool的详细说明
This commit is contained in:
71
AGENTS.md
71
AGENTS.md
@@ -1,8 +1,8 @@
|
|||||||
# APM 应用商店 - AI 编码指南
|
# 星火应用商店 - AI 编码指南
|
||||||
|
|
||||||
**仓库:** elysia-best/apm-app-store
|
**仓库:** spark-store-project/spark-store
|
||||||
**项目类型:** Electron + Vue 3 + Vite 桌面应用
|
**项目类型:** Electron + Vue 3 + Vite + Qt 桌面应用
|
||||||
**用途:** APM (AmberPM) 包管理器的桌面应用商店客户端
|
**用途:** 星火应用商店的桌面应用商店客户端
|
||||||
**许可证:** GPL-3.0
|
**许可证:** GPL-3.0
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -14,7 +14,7 @@
|
|||||||
### 技术栈
|
### 技术栈
|
||||||
|
|
||||||
- **前端框架:** Vue 3 with Composition API (`<script setup>`)
|
- **前端框架:** Vue 3 with Composition API (`<script setup>`)
|
||||||
- **构建工具:** Vite 6.4.1
|
- **构建工具:** Vite 6.4.1 + Qt5
|
||||||
- **桌面框架:** Electron 40.0.0
|
- **桌面框架:** Electron 40.0.0
|
||||||
- **UI 框架:** Tailwind CSS 4.1.18
|
- **UI 框架:** Tailwind CSS 4.1.18
|
||||||
- **语言:** TypeScript (严格模式已启用)
|
- **语言:** TypeScript (严格模式已启用)
|
||||||
@@ -25,7 +25,7 @@
|
|||||||
### 目录结构
|
### 目录结构
|
||||||
|
|
||||||
```
|
```
|
||||||
apm-app-store/
|
spark-store/
|
||||||
├── electron/ # Electron 主进程
|
├── electron/ # Electron 主进程
|
||||||
│ ├── main/
|
│ ├── main/
|
||||||
│ │ ├── backend/ # 后端逻辑 (如安装管理器)
|
│ │ ├── backend/ # 后端逻辑 (如安装管理器)
|
||||||
@@ -47,6 +47,17 @@ apm-app-store/
|
|||||||
│ ├── assets/ # CSS/图片
|
│ ├── assets/ # CSS/图片
|
||||||
│ ├── App.vue # 根组件
|
│ ├── App.vue # 根组件
|
||||||
│ └── main.ts # 渲染进程入口
|
│ └── main.ts # 渲染进程入口
|
||||||
|
├── spark-update-tool/ # Qt 软件更新工具
|
||||||
|
│ ├── src/ # C++ 源代码
|
||||||
|
│ │ ├── mainwindow.cpp/h/ui # 主窗口
|
||||||
|
│ │ ├── applistmodel.cpp/h # 应用列表模型
|
||||||
|
│ │ ├── appdelegate.cpp/h # 应用列表委托
|
||||||
|
│ │ ├── downloadmanager.cpp/h # 下载管理器
|
||||||
|
│ │ ├── aptssupdater.cpp/h # APTSS 更新器
|
||||||
|
│ │ └── ignoreconfig.cpp/h # 忽略配置管理
|
||||||
|
│ ├── resources/ # 图标和资源文件
|
||||||
|
│ ├── debian/ # Debian 打包文件
|
||||||
|
│ └── CMakeLists.txt # CMake 构建配置
|
||||||
├── extras/ # Shell 脚本和策略文件
|
├── extras/ # Shell 脚本和策略文件
|
||||||
├── icons/ # 应用图标
|
├── icons/ # 应用图标
|
||||||
├── scripts/ # 维护脚本
|
├── scripts/ # 维护脚本
|
||||||
@@ -60,6 +71,54 @@ apm-app-store/
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## 🔧 配套工具
|
||||||
|
|
||||||
|
### Spark Update Tool (spark-update-tool/)
|
||||||
|
|
||||||
|
**技术栈:** Qt6 + C++
|
||||||
|
|
||||||
|
**用途:** 独立的软件更新工具,用于检查和安装系统软件更新。
|
||||||
|
|
||||||
|
**主要组件:**
|
||||||
|
|
||||||
|
| 文件 | 用途 |
|
||||||
|
|------|------|
|
||||||
|
| `mainwindow.cpp/h/ui` | 主窗口界面,包含应用列表视图、搜索框、更新按钮 |
|
||||||
|
| `applistmodel.cpp/h` | 应用列表数据模型,管理可更新应用的数据 |
|
||||||
|
| `appdelegate.cpp/h` | 应用列表视图委托,负责绘制每个应用项的UI(图标、进度条、复选框等) |
|
||||||
|
| `downloadmanager.cpp/h` | 下载管理器,基于 aria2c 实现多线程下载 |
|
||||||
|
| `aptssupdater.cpp/h` | APTSS 更新器,调用 `aptss` 命令获取更新列表 |
|
||||||
|
| `ignoreconfig.cpp/h` | 忽略配置管理,管理用户选择忽略更新的应用 |
|
||||||
|
|
||||||
|
**核心功能:**
|
||||||
|
|
||||||
|
1. **获取更新列表:** 调用 `aptss list --upgradable` 获取可更新应用
|
||||||
|
2. **应用名识别:** 基于 `ss-do-upgrade.sh` 部分代码实现
|
||||||
|
3. **包大小识别:** 通过 dpkg 获取包大小信息
|
||||||
|
4. **多线程下载:** 基于 aptss 方案,使用 aria2c 进行多线程下载
|
||||||
|
5. **忽略更新:** 用户可以忽略特定应用的更新
|
||||||
|
6. **批量更新:** 支持选择多个应用进行批量更新
|
||||||
|
|
||||||
|
**构建方式:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd spark-update-tool
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake ..
|
||||||
|
make
|
||||||
|
```
|
||||||
|
|
||||||
|
**支持的发行版:**
|
||||||
|
- GXDE OS
|
||||||
|
- Ubuntu
|
||||||
|
- deepin
|
||||||
|
- Debian 10+
|
||||||
|
- UOS
|
||||||
|
- 银河麒麟
|
||||||
|
- Arch Linux
|
||||||
|
- Fedora
|
||||||
|
---
|
||||||
|
|
||||||
## 🎯 核心概念
|
## 🎯 核心概念
|
||||||
|
|
||||||
### 1. APM 包管理器集成
|
### 1. APM 包管理器集成
|
||||||
|
|||||||
Reference in New Issue
Block a user