# 星火应用商店与 APM 应用商店技术分析报告 


## 3. 服务器路径与下载安装逻辑

### 3.1 星火应用商店 (Spark Store)
- **服务器基地址**: `https://d.spark-app.store/`
- **应用列表获取**: `{SOURCE_URL}/{ARCH}/{CATEGORY}/applist.json`
    - 例如: `https://d.spark-app.store//aarch64-store/tools/applist.json`
- **架构路径**:
    - x86: `amd64-store`
    - arm: `arm64-store`
- 分类列表：`https://d.spark-app.store/store/categories.json`
- 应用列表：`https://d.spark-app.store/store/{category}/applist.json`
- **下载机制**: **Metalink + Aria2c**
    - 第一步：从 `{BASE_URL}/{ARCH}/{CATEGORY}/{PKGNAME}/{FILENAME}.metalink` 获取 Metalink 文件。
    - 第二步：使用 `aria2c` 解析 Metalink 并下载分块内容。
- **安装逻辑**: 使用`ssinstall`。

### 3.2 APM 应用商店 (AmberPM)
- **服务器基地址**: `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**
    - 第一步：从 `{BASE_URL}/{ARCH}/{CATEGORY}/{PKGNAME}/{FILENAME}.metalink` 获取 Metalink 文件。
    - 第二步：使用 `aria2c` 解析 Metalink 并下载分块内容。
- **安装工具**: `apm` (Amber Package Manager)
    - 安装命令: `apm install -y <pkgname>`
    - 安装本地包: `apm ssaudit <deb_path>`
    - 查看已安装: `apm list --installed`
- **运行环境**: 使用 `host-spawn` 和 `apm-launcher` 在容器化兼容层中启动应用。




### 接口对接规范
- 统一使用 `/{arch}/{category}/applist.json` 获取目录。
- 详情信息需解析 `/{arch}/{category}/{pkgname}/app.json`。
- 图片资源路径: `/{arch}/{category}/{pkgname}/screen_1.png` (最多支持 5 张)。

---