spark-store/analysis_report.md

星火应用商店与 APM 应用商店技术分析报告 (2026-03-10)

1. 项目背景

本项目包含两个主要仓库：

1. 星火应用商店 (Spark Store): 原始的 Qt/C++ 实现，定位于 Deepin/UOS 等操作系统的应用商店。
2. 星火 APM 应用商店 (AmberPM): 基于 Electron + Vue 3 的现代实现，作为 apm-app-store 上游的 fork。它通过 fuse-overlayfs 和 AmberCE 提供容器化的应用兼容层。

---

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: store 或 amd64-store
  • arm: aarch64-store
• 下载服务器: https://d.spark-app.store/
• 下载工具: 自带 aptss (基于 wget/aria2c)。
• 安装逻辑: 要脚本位于 tool/aptss 和 tool/ssinstall。

3.2 APM 应用商店 (AmberPM)

• 服务器基地址: https://d.spark-app.store/
• 下载机制: 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 在容器化兼容层中启动应用。

---

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}/{pkgname}/app.json。
• 图片资源路径: /{arch}/{category}/{pkgname}/screen_1.png (最多支持 5 张)。

---