From 3cea59f47b41e2ecd7fd2157b3bfe79900be33ec Mon Sep 17 00:00:00 2001
From: momen <vmomenv@gmail.com>
Date: Tue, 10 Mar 2026 17:34:35 +0800
Subject: [PATCH] =?UTF-8?q?update:=E6=9B=B4=E6=96=B0=E6=9C=8D=E5=8A=A1?=
 =?UTF-8?q?=E5=99=A8=E6=8E=A5=E5=8F=A3=E4=BF=A1=E6=81=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 analysis_report.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 analysis_report.md

diff --git a/analysis_report.md b/analysis_report.md
new file mode 100644
index 00000000..1c94cd39
--- /dev/null
+++ b/analysis_report.md
@@ -0,0 +1,63 @@
+# 星火应用商店与 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 张)。
+
+---
+
+
+