spark-store/服务器接口规范.md

星火应用商店与 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 张)。

---