update:更新服务器接口规范

服务器接口规范.md

@@ -0,0 +1,47 @@
+# 星火应用商店与 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 张)。
+
+---
+
+
+