update:更新服务器接口规范

This commit is contained in:
2026-03-11 08:04:43 +08:00
parent 876a3715bf
commit 8f2c758bf5

View File

@@ -1,14 +1,5 @@
# 星火应用商店与 APM 应用商店技术分析报告 (2026-03-10) # 星火应用商店与 APM 应用商店技术分析报告
## 1. 项目背景
本项目包含两个主要仓库:
1. **星火应用商店 (Spark Store)**: 原始的 Qt/C++ 实现,定位于 Deepin/UOS 等操作系统的应用商店。
2. **星火 APM 应用商店 (AmberPM)**: 基于 Electron + Vue 3 的现代实现,作为 `apm-app-store` 上游的 fork。它通过 `fuse-overlayfs``AmberCE` 提供容器化的应用兼容层。
---
## 3. 服务器路径与下载安装逻辑 ## 3. 服务器路径与下载安装逻辑
@@ -17,14 +8,22 @@
- **应用列表获取**: `{SOURCE_URL}/{ARCH}/{CATEGORY}/applist.json` - **应用列表获取**: `{SOURCE_URL}/{ARCH}/{CATEGORY}/applist.json`
- 例如: `https://d.spark-app.store//aarch64-store/tools/applist.json` - 例如: `https://d.spark-app.store//aarch64-store/tools/applist.json`
- **架构路径**: - **架构路径**:
- x86: `store``amd64-store` - x86: `amd64-store`
- arm: `aarch64-store` - arm: `arm64-store`
- **下载服务器**: `https://d.spark-app.store/` - 分类列表:`https://d.spark-app.store/store/categories.json`
- **下载工具**: 自带 `aptss` (基于 `wget/aria2c`)。 - 应用列表:`https://d.spark-app.store/store/{category}/applist.json`
- **安装逻辑**: 要脚本位于 `tool/aptss``tool/ssinstall` - **下载机制**: **Metalink + Aria2c**
- 第一步:从 `{BASE_URL}/{ARCH}/{CATEGORY}/{PKGNAME}/{FILENAME}.metalink` 获取 Metalink 文件。
- 第二步:使用 `aria2c` 解析 Metalink 并下载分块内容。
- **安装逻辑**: 使用`ssinstall`
### 3.2 APM 应用商店 (AmberPM) ### 3.2 APM 应用商店 (AmberPM)
- **服务器基地址**: `https://d.spark-app.store/` - **服务器基地址**: `https://d.spark-app.store/`
- 分类列表:`https://d.spark-app.store/amd64-apm/categories.json`
- 应用列表:`https://d.spark-app.store/amd64-apm/{category}/applist.json`
- **架构路径**:
- x86: `amd64-apm`
- arm: `arm64-apm`
- **下载机制**: **Metalink + Aria2c** - **下载机制**: **Metalink + Aria2c**
- 第一步:从 `{BASE_URL}/{ARCH}/{CATEGORY}/{PKGNAME}/{FILENAME}.metalink` 获取 Metalink 文件。 - 第一步:从 `{BASE_URL}/{ARCH}/{CATEGORY}/{PKGNAME}/{FILENAME}.metalink` 获取 Metalink 文件。
- 第二步:使用 `aria2c` 解析 Metalink 并下载分块内容。 - 第二步:使用 `aria2c` 解析 Metalink 并下载分块内容。
@@ -36,21 +35,6 @@
---
## 4. 程序员开发指南
## API 端点
### Spark Store
- 分类列表:`https://d.spark-app.store/store/categories.json`
- 应用列表:`https://d.spark-app.store/store/{category}/applist.json`
### APM (AmberPM)
- 分类列表:`https://d.spark-app.store/amd64-apm/categories.json`
- 应用列表:`https://d.spark-app.store/amd64-apm/{category}/applist.json`
### 接口对接规范 ### 接口对接规范
- 统一使用 `/{arch}/{category}/applist.json` 获取目录。 - 统一使用 `/{arch}/{category}/applist.json` 获取目录。