From d7bdcf36809b34e545e16a6cecb8fdf2bf668da1 Mon Sep 17 00:00:00 2001
From: xiyidaiwa <g17729830615@163.com>
Date: Wed, 12 Aug 2026 23:16:17 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E6=A0=87=E7=AD=BE=E7=AD=96=E7=95=A5?=
 =?UTF-8?q?=E5=90=AF=E5=8A=A8=E5=88=9D=E5=A7=8B=E5=8C=96=E5=8A=A0=E5=9B=BA?=
 =?UTF-8?q?=20+=20=E5=B7=B2=E5=AE=89=E8=A3=85=E5=BA=94=E7=94=A8=E8=BF=87?=
 =?UTF-8?q?=E6=BB=A4/=E7=BB=9F=E8=AE=A1=E6=80=A7=E8=83=BD=E4=BC=98?=
 =?UTF-8?q?=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 标签优先显示策略 initTagPriorityStrategy 提到 App.vue onMounted 统一调用，
  消除组件挂载顺序导致先读内存默认 auto 的竞态窗口（AppDetailModal 移除重复调用）
- InstalledAppsModal 过滤逻辑合并为单次遍历（保留 hasOrigin 双来源语义）
- 统计 apm/spark/total 改为基于 searchFilteredApps 单次遍历
- canOpenDetail 补充业务含义注释与可读性变量
- 将 App.vue 重构的 9 个 composable 纳入版本管理
- 验证：vue-tsc 0 / eslint 0 / dpkg-buildpackage 打包 spark-store_5.2.1.24-test 成功
---
 debian/changelog                      |    2 +-
 src/App.vue                           | 2951 +++----------------------
 src/components/AppDetailModal.vue     |    3 +-
 src/components/InstalledAppsModal.vue |   70 +-
 src/composables/useAccountSync.ts     |  424 ++++
 src/composables/useAppDetail.ts       |  475 ++++
 src/composables/useAppState.ts        |  167 ++
 src/composables/useCatalog.ts         |  567 +++++
 src/composables/useDownloads.ts       |  233 ++
 src/composables/useFavorites.ts       |  489 ++++
 src/composables/useHttp.ts            |   73 +
 src/composables/useInstalledApps.ts   |  367 +++
 src/composables/useRanking.ts         |  218 ++
 13 files changed, 3367 insertions(+), 2672 deletions(-)
 create mode 100644 src/composables/useAccountSync.ts
 create mode 100644 src/composables/useAppDetail.ts
 create mode 100644 src/composables/useAppState.ts
 create mode 100644 src/composables/useCatalog.ts
 create mode 100644 src/composables/useDownloads.ts
 create mode 100644 src/composables/useFavorites.ts
 create mode 100644 src/composables/useHttp.ts
 create mode 100644 src/composables/useInstalledApps.ts
 create mode 100644 src/composables/useRanking.ts

diff --git a/debian/changelog b/debian/changelog
index f6205efd..0ef7a34e 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,4 +1,4 @@
-spark-store (5.2.1.19-test) UNRELEASED; urgency=medium
+spark-store (5.2.1.24-test) UNRELEASED; urgency=medium
 
   * Initial release. (Closes: #nnnn)  <nnnn is the bug number of your ITP>
 
diff --git a/src/App.vue b/src/App.vue
index 0b9a6d12..abd3b205 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -303,8 +303,20 @@
 </template>
 
 <script setup lang="ts">
+/**
+ * App.vue —— 应用根组件（编排壳）。
+ *
+ * 重构说明（与改造前 7 维度一致）：
+ * 原 App.vue（3558 行）承载了全部全局状态与业务逻辑。现按职责拆分为若干 composable：
+ *   useAppState（共享状态单例） / useHttp / useCatalog / useRanking / useAppDetail /
+ *   useInstalledApps / useFavorites / useAccountSync / useDownloads。
+ * 本文件仅保留"壳层"职责：模板绑定、导航/主题/搜索、更新中心编排、窗口与 IPC 生命周期、
+ * 以及依赖多个 composable 的派生计算（filteredApps / categoryCounts 等）。
+ *
+ * 所有共享 ref 通过 useAppState 单例取用同一实例，函数从各 composable 导入，
+ * 行为与改造前完全一致（仅搬移，未改逻辑）。
+ */
 import { ref, computed, onMounted, onUnmounted, watch, nextTick } from "vue";
-import axios, { AxiosError } from "axios";
 import pino from "pino";
 import AppSidebar from "./components/AppSidebar.vue";
 import AppGrid from "./components/AppGrid.vue";
@@ -331,25 +343,16 @@ import UserManagementModal from "./components/UserManagementModal.vue";
 import ReviewUserProfileModal from "./components/ReviewUserProfileModal.vue";
 import WindowTitleBar from "./components/WindowTitleBar.vue";
 import SubmitterWindow from "./components/SubmitterWindow.vue";
+import { initTagPriorityStrategy } from "./global/tagPriority";
 import {
-  APM_STORE_BASE_URL,
   FLARUM_BASE_URL,
   FLARUM_REGISTER_URL,
   FLARUM_SETTINGS_URL,
+  currentStoreMode,
   currentApp,
   currentAppSparkInstalled,
   currentAppApmInstalled,
-  currentStoreMode,
-  showApmInstallDialog,
-  getHybridDefaultOrigin,
-  loadPriorityConfig,
 } from "./global/storeConfig";
-import { createCacheBusterInterceptor } from "./global/cacheBusterInterceptor";
-import {
-  downloads,
-  removeDownloadItem,
-  watchDownloadsChange,
-} from "./global/downloadStatus";
 import {
   installedSyncEnabled,
   loadInstalledSyncPreference,
@@ -359,159 +362,180 @@ import {
   countSearchMatchesByCategory,
   rankAppsBySearch,
 } from "./modules/appSearch";
-import { handleInstall, handleRetry } from "./modules/processInstall";
-import {
-  addFavoriteItem,
-  bulkDeleteFavoriteItems,
-  createFavoriteFolder,
-  deleteFavoriteItem,
-  exchangeFlarumToken,
-  fetchSyncedAppList,
-  listDownloadedApps,
-  listFavoriteFolders,
-  listFavoriteItems,
-  recordDownloadedApp,
-  uploadSyncedAppList,
-} from "./modules/backendApi";
-import { requestFlarumToken } from "./modules/flarumAuth";
+import { createUpdateCenterStore } from "./modules/updateCenter";
 import {
   currentUser,
   isLoggedIn,
   logout,
   setAuthSession,
 } from "./global/authState";
-import {
-  getEffectiveStoreFilter,
-  isOriginEnabled,
-  isOriginUsable,
-} from "./modules/storeFilter";
-import { createUpdateCenterStore } from "./modules/updateCenter";
-import {
-  buildReviewAppKey,
-  buildFavoriteAppKey,
-  buildReviewTags,
-  getDisplayApp,
-  parsePackageArch,
-} from "./modules/appIdentity";
-import { resolveFavoriteItems } from "./modules/favoriteAvailability";
-import {
-  buildSyncItems,
-  cloudItemKey,
-  cloudPackageKey,
-  mergeInstalledApps,
-  resolveCloudInstallCandidate,
-} from "./modules/appListSync";
-import type {
-  App,
-  AppJson,
-  DownloadItem,
-  DownloadResult,
-  ChannelPayload,
-  CategoryInfo,
-  HomeLink,
-  FlarumLoginPayload,
-  SidebarEntry,
-  UpdateCenterItem,
-  ReviewTags,
-  FavoriteFolder,
-  FavoriteItem,
-  InstalledAppInfo,
-  ResolvedFavoriteItem,
-  SystemInfo,
-  DownloadedAppRecord,
-  SyncedAppListItem,
-  AppReview,
-  ReviewUserProfile,
-} from "./global/typedefinition";
-import type { Ref } from "vue";
+import { getEffectiveStoreFilter } from "./modules/storeFilter";
+import type { App } from "./global/typedefinition";
 import type { IpcRendererEvent } from "electron";
+
+// ===== 共享状态（来自 useAppState 单例，模板直接引用） =====
+import {
+  apps,
+  categories,
+  tabCategories,
+  tabApps,
+  loadingTabs,
+  sidebarEntries,
+  sparkAvailable,
+  apmAvailable,
+  storeFilter,
+  initialCatalogLoaded,
+  loading,
+  homeLinks,
+  homeLoading,
+  homeError,
+  apmRanking,
+  sparkRanking,
+  rankingLoading,
+  currentView,
+  activeTab,
+  selectedCategory,
+  searchQuery,
+  isSidebarOpen,
+  showModal,
+  showPreview,
+  currentScreenIndex,
+  screenshots,
+  availableSources,
+  showInstalledModal,
+  installedApps,
+  installedLoading,
+  installedError,
+  installedWarning,
+  installedRefreshGeneration,
+  showUninstallModal,
+  uninstallTargetApp,
+  showAboutModal,
+  showSettingsModal,
+  showLoginModal,
+  loginLoading,
+  loginError,
+  showLoginPrompt,
+  loginPromptMessage,
+  showUserManagementModal,
+  selectedReviewUserProfile,
+  showReviewUserProfileModal,
+  showRestoreModal,
+  restoreLoading,
+  restoreError,
+  restoreItems,
+  syncLoading,
+  syncStatusMessage,
+  syncRequestGeneration,
+  syncCandidateApps,
+  downloadedApps,
+  downloadedLoading,
+  downloadedError,
+  favoriteFolders,
+  activeFavoriteFolderId,
+  showFavoriteSelector,
+  favoriteLoading,
+  favoriteError,
+  systemInfo,
+  downloads,
+  showDownloadDetailModal,
+  currentDownload,
+  showApmInstallDialog,
+} from "./composables/useAppState";
+
+// ===== 各 composable 导出的函数 =====
+import {
+  loadCategories,
+  loadSidebarConfig,
+  loadTabCategories,
+  loadTabApps,
+  loadApps,
+  loadHomeListEntries,
+  loadHomeListApps,
+  preloadHomeListApps,
+  preloadSidebarTabApps,
+} from "./composables/useCatalog";
+import { loadHome, loadRanking } from "./composables/useRanking";
+import {
+  openDetail,
+  openDetailFromInstalled,
+  checkAppInstalled,
+  closeDetail,
+  openScreenPreview,
+  closeScreenPreview,
+  prevScreen,
+  nextScreen,
+  selectDetailOrigin,
+  handleDetailRequestLogin,
+  currentDisplayApp,
+  currentReviewAppKey,
+  currentReviewTags,
+  setFilteredApps,
+} from "./composables/useAppDetail";
+import {
+  refreshInstalledApps,
+  openInstalledModal,
+  closeInstalledModal,
+  uninstallInstalledApp,
+  onUninstallSuccess,
+  installedCloudKeys,
+  installedCloudPackageKeys,
+  isInstalledAppInfo,
+  mapInstalledAppToCatalogApp,
+} from "./composables/useInstalledApps";
+import {
+  openFavoriteManagement,
+  selectFavoriteFolder,
+  createFavoriteFolderFromPrompt,
+  removeSelectedFavorites,
+  installResolvedFavorites,
+  currentFavoriteMetadata,
+  currentFavoriteFolderIds,
+  resolvedFavoriteItems,
+  saveCurrentFavoriteFolders,
+  createFavoriteFolderFromSelector,
+  registerOnDetailInstall,
+  registerCurrentDisplayApp,
+} from "./composables/useFavorites";
+import {
+  requireLogin,
+  openLoginFromPrompt,
+  handleLogout,
+  handleFlarumLogin,
+  loadDownloadedHistory,
+  syncInstalledAppsToAccount,
+  syncInstalledAppsNow,
+  openRestoreFromAccount,
+  installCloudItems,
+  maybePromptInstalledSync,
+  openUserManagement,
+  openReviewUserProfile,
+  registerLogout,
+  registerSetAuthSession,
+  registerIsInstalledAppInfo,
+  registerMapInstalledAppToCatalogApp,
+  registerPendingDownloadRecordsClear,
+} from "./composables/useAccountSync";
+import {
+  onDetailInstall,
+  onDetailRemove,
+  onDetailFavorite,
+  pauseDownload,
+  resumeDownload,
+  cancelDownload,
+  retryDownload,
+  clearCompletedDownloads,
+  showDownloadDetailModalFunc,
+  closeDownloadDetail,
+  openDownloadedApp,
+  clearPendingDownloadRecords,
+  registerCheckAppInstalled,
+  registerRequestUninstall,
+} from "./composables/useDownloads";
+
 const logger = pino();
 
-// Axios 全局配置
-const axiosInstance = axios.create({
-  baseURL: APM_STORE_BASE_URL,
-  timeout: 5000, // 增加到 5 秒，避免网络波动导致的超时
-});
-
-// C2：数据 JSON（applist / categories / sidebar-config 等）追加 ?_t 版本戳，
-// 穿透 CDN 边缘缓存，确保返回最新列表。复用共享缓存穿透拦截器（带 TTL 复用戳，
-// 避免同会话频繁击穿缓存）。与主进程 onBeforeSendHeaders 注入的 no-cache 互为兜底。
-// 这是有意的缓存击穿策略（非缺陷），用于解决商店目录强缓存导致的更新延迟。
-axiosInstance.interceptors.request.use(createCacheBusterInterceptor());
-
-const fetchWithRetry = async <T,>(
-  url: string,
-  signal?: AbortSignal,
-  retries = 2,
-  delay = 500,
-): Promise<T> => {
-  try {
-    const response = await axiosInstance.get<T>(url, { signal });
-    return response.data;
-  } catch (error) {
-    // 请求被取消（AbortSignal）时直接抛出，不再重试
-    if (signal?.aborted) throw error;
-    const axiosError = error as AxiosError;
-    const status = axiosError.response?.status;
-    // 仅对网络错误（无响应）、服务端 5xx 错误或超时进行重试；
-    // 4xx（如 404/400）属于明确的客户端错误，直接抛出以避免无谓重试。
-    const isNetworkError = status === undefined;
-    const isServerError = typeof status === "number" && status >= 500;
-    const isTimeout =
-      axiosError.code === "ECONNABORTED" || axiosError.code === "ETIMEDOUT";
-
-    if (retries > 0 && (isNetworkError || isServerError || isTimeout)) {
-      // 若已取消则提前退出，避免对已卸载组件发起新请求
-      if (signal?.aborted) throw error;
-      await new Promise((resolve) => setTimeout(resolve, delay));
-      return fetchWithRetry(url, signal, retries - 1, delay * 2);
-    }
-    throw error;
-  }
-};
-
-// 根级请求取消控制器：组件卸载时 abort，避免对已卸载组件发起/重试请求
-const rootAbortController = new AbortController();
-
-// 渲染进程从 IPC 拿到的 result.apps 实际类型为 any（ipcRenderer.invoke 返回 Promise<any>），
-// 直接断言成 InstalledAppInfo[] 会绕过运行时类型检查。后端字段缺失时会引发运行时错误。
-// 此守卫仅校验本项目实际使用的关键字段，后端字段缺失时跳过即可，避免整批失败。
-const isInstalledAppInfo = (value: unknown): value is InstalledAppInfo => {
-  if (typeof value !== "object" || value === null) return false;
-  const v = value as Partial<InstalledAppInfo>;
-  return (
-    typeof v.pkgname === "string" &&
-    typeof v.name === "string" &&
-    typeof v.version === "string" &&
-    typeof v.arch === "string" &&
-    (v.origin === "spark" || v.origin === "apm") &&
-    typeof v.flags === "string" &&
-    typeof v.isDependency === "boolean" &&
-    // icon 在类型中为可选字段（string | undefined），需显式校验其类型，
-    // 避免非字符串值进入下游 app.icon || "" 触发隐式转换异常
-    (typeof v.icon === "string" || v.icon === undefined)
-  );
-};
-
-// 单来源已安装查询超时时间：某个来源（如 APM）响应极慢或挂起时，
-// 不应阻塞其它来源整体返回，超时后该来源标记为失败并走 warning/error 流程。
-const LIST_INSTALLED_TIMEOUT_MS = 15000;
-
-// 为 Promise 增加超时控制：超时即 reject，配合 Promise.allSettled 让单来源失败不影响其它来源。
-// 注意：promise 先 resolve 时必须 clearTimeout，否则 setTimeout 句柄泄漏。
-const withTimeout = <T,>(
-  promise: Promise<T>,
-  ms: number,
-  label: string,
-): Promise<T> => {
-  let timer: ReturnType<typeof setTimeout>;
-  const timeout = new Promise<T>((_, reject) => {
-    timer = setTimeout(() => reject(new Error(`${label} 超时（${ms}ms）`)), ms);
-  });
-  return Promise.race([promise.finally(() => clearTimeout(timer)), timeout]);
-};
-
-// 响应式状态
+// ===== 主题 =====
 const themeMode = ref<"light" | "dark" | "auto">("auto");
 const systemIsDark = ref(
   window.matchMedia("(prefers-color-scheme: dark)").matches,
@@ -523,99 +547,12 @@ const isDarkTheme = computed(() => {
 
 const isSubmitterView = ref(false);
 
-const categories: Ref<Record<string, CategoryInfo>> = ref({});
-const apps: Ref<App[]> = ref([]);
-const tabCategories: Ref<Record<string, Record<string, CategoryInfo>>> = ref(
-  {},
-);
-const tabApps: Ref<Record<string, App[]>> = ref({});
-// 正在加载中的入口 ID 集合，用于显示骨架屏并防止重复加载
-const loadingTabs = ref<Set<string>>(new Set());
-// 首页推荐列表入口对应的各来源 jsonUrl：{ [entryId]: { spark?, apm? } }
-const homeListUrls = ref<Record<string, { spark?: string; apm?: string }>>({});
-const activeTab = ref("home");
-type MainView = "default" | "favorites";
-const currentView = ref<MainView>("default");
-const selectedCategory = ref("all");
-const searchQuery = ref("");
-const isSidebarOpen = ref(false);
-const showModal = ref(false);
-const showPreview = ref(false);
-const currentScreenIndex = ref(0);
-const screenshots = ref<string[]>([]);
-const loading = ref(true);
-const showDownloadDetailModal = ref(false);
-const currentDownload: Ref<DownloadItem | null> = ref(null);
-const showInstalledModal = ref(false);
-const installedApps = ref<App[]>([]);
-const installedLoading = ref(false);
-const installedError = ref("");
-// 部分来源失败（如 Spark/APM 之一不可用）时使用更轻量的 warning 提示，避免与已有列表同时呈现红色致命错误条造成 UX 混淆
-const installedWarning = ref("");
-// refreshInstalledApps 的代次计数器，用于异步竞态防护：新进入一次刷新自增，await 后若代次已变则放弃本轮写入
-const installedRefreshGeneration = ref(0);
-const updateCenterStore = createUpdateCenterStore();
-const showUninstallModal = ref(false);
-const uninstallTargetApp: Ref<App | null> = ref(null);
-const showAboutModal = ref(false);
-const showSettingsModal = ref(false);
-const showLoginModal = ref(false);
-const loginLoading = ref(false);
-const loginError = ref("");
-const showLoginPrompt = ref(false);
-const loginPromptMessage = ref("请登录星火账号后继续操作。");
-const showUserManagementModal = ref(false);
-const selectedReviewUserProfile = ref<ReviewUserProfile | null>(null);
-const showReviewUserProfileModal = ref(false);
-const sparkAvailable = ref(false);
-const apmAvailable = ref(false);
-const sidebarEntries: Ref<SidebarEntry[]> = ref([]);
-const favoriteFolders = ref<FavoriteFolder[]>([]);
-const activeFavoriteFolderId = ref<number | null>(null);
-const favoriteItems = ref<FavoriteItem[]>([]);
-const favoriteItemsByFolder = ref<Record<number, FavoriteItem[]>>({});
-const showFavoriteSelector = ref(false);
-const favoriteTargetApp = ref<App | null>(null);
-const favoriteSelectorDraftFolderIds = ref<Array<number | "default"> | null>(
-  null,
-);
-const favoriteLoading = ref(false);
-const favoriteError = ref("");
-const favoriteRequestGeneration = ref(0);
-const downloadedApps = ref<DownloadedAppRecord[]>([]);
-const downloadedLoading = ref(false);
-const downloadedError = ref("");
-const downloadedRequestGeneration = ref(0);
-const syncLoading = ref(false);
-const syncStatusMessage = ref("");
-const syncRequestGeneration = ref(0);
-const syncCandidateApps = ref<App[]>([]);
-const restoreLoading = ref(false);
-const restoreError = ref("");
-const showRestoreModal = ref(false);
-const restoreItems = ref<SyncedAppListItem[]>([]);
-const restoreRequestGeneration = ref(0);
-const installedSyncPromptShown = ref(false);
-const systemInfo = ref<SystemInfo>({ distro: "unknown" });
-type PendingDownloadRecord = Omit<
-  DownloadedAppRecord,
-  "id" | "downloadedAt"
-> & {
-  userId: number;
-};
-const pendingDownloadRecords = new Map<number, PendingDownloadRecord>();
-
-/** 启动参数 --no-apm => 仅 Spark；--no-spark => 仅 APM；由主进程 IPC 提供 */
-const storeFilter = ref<"spark" | "apm" | "both">("both");
-const availableSources = computed(() => ({
-  spark: sparkAvailable.value,
-  apm: apmAvailable.value,
-}));
+// 启动参数 --no-apm => 仅 Spark；--no-spark => 仅 APM；由主进程 IPC 提供
 const effectiveStoreFilter = computed(() =>
   getEffectiveStoreFilter(storeFilter.value, availableSources.value),
 );
 
-// 计算属性
+// ===== 派生计算（依赖多个 composable 共享状态） =====
 const baseApps = computed(() => {
   let result = [...apps.value];
 
@@ -663,6 +600,22 @@ const effectiveLoading = computed(
       !tabApps.value[activeTab.value]),
 );
 
+const getEffectiveCategory = (): string => {
+  if (activeTab.value === "home") return "";
+  if (activeTab.value === "all") return selectedCategory.value;
+
+  const entry = sidebarEntries.value.find((e) => e.id === activeTab.value);
+  if (entry) {
+    if (entry.type === "category") return selectedCategory.value;
+    if (entry.type === "search") {
+      searchQuery.value = entry.value || "";
+      return selectedCategory.value;
+    }
+  }
+
+  return selectedCategory.value;
+};
+
 const filteredApps = computed(() => {
   let result = [...displayApps.value];
 
@@ -725,8 +678,6 @@ const entryCounts = computed(() => {
   return counts;
 });
 
-const currentDisplayApp = computed(() => getDisplayApp(currentApp.value));
-
 // 当前激活的侧栏入口是否为首页推荐列表类型
 const isHomeListTab = computed(
   () =>
@@ -746,82 +697,7 @@ const handleAppCardOpenDetail = (app: App) => {
   }
 };
 
-const clientArch = computed(() => window.apm_store.arch || "amd64");
-
-const currentReviewAppKey = computed(() => {
-  if (!currentDisplayApp.value) return "";
-  return buildReviewAppKey(currentDisplayApp.value, clientArch.value);
-});
-
-const currentReviewTags = computed<ReviewTags | null>(() => {
-  if (!currentDisplayApp.value) return null;
-  return buildReviewTags(currentDisplayApp.value, {
-    clientArch: clientArch.value,
-    distro: systemInfo.value.distro,
-  });
-});
-
-const currentFavoriteMetadata = computed(
-  (): {
-    favorited: boolean;
-    folderName: string;
-  } => {
-    const app = currentDisplayApp.value;
-    if (!app) return { favorited: false, folderName: "" };
-
-    const folder = favoriteFolders.value.find((favoriteFolder) => {
-      const items = favoriteItemsByFolder.value[favoriteFolder.id] ?? [];
-      return items.some(
-        (favorite) =>
-          favorite.pkgname === app.pkgname &&
-          favorite.category === app.category,
-      );
-    });
-    if (!folder) return { favorited: false, folderName: "" };
-
-    return { favorited: true, folderName: folder.name.trim() };
-  },
-);
-
-const currentFavoriteFolderIds = computed((): Array<number | "default"> => {
-  if (favoriteSelectorDraftFolderIds.value) {
-    return favoriteSelectorDraftFolderIds.value;
-  }
-
-  const app = favoriteTargetApp.value ?? currentDisplayApp.value;
-  if (!app) return [];
-
-  return favoriteFolders.value
-    .filter((folder) =>
-      (favoriteItemsByFolder.value[folder.id] ?? []).some(
-        (favorite) =>
-          favorite.pkgname === app.pkgname &&
-          favorite.category === app.category,
-      ),
-    )
-    .map((folder) => folder.id);
-});
-
-const resolvedFavoriteItems = computed<ResolvedFavoriteItem[]>(() =>
-  resolveFavoriteItems(
-    favoriteItems.value,
-    apps.value,
-    installedApps.value,
-    availableSources.value,
-    storeFilter.value,
-    clientArch.value,
-  ),
-);
-
-const installedCloudKeys = computed(
-  () => new Set(installedApps.value.map((app) => cloudItemKey(app))),
-);
-
-const installedCloudPackageKeys = computed(
-  () => new Set(syncCandidateApps.value.map((app) => cloudPackageKey(app))),
-);
-
-// 方法
+// ===== 主题方法 =====
 const syncThemePreference = () => {
   document.documentElement.classList.toggle("dark", isDarkTheme.value);
 };
@@ -857,6 +733,7 @@ const toggleTheme = () => {
   else themeMode.value = "auto";
 };
 
+// ===== 导航 =====
 const selectTab = (tab: string) => {
   currentView.value = "default";
   activeTab.value = tab;
@@ -882,836 +759,46 @@ const selectSubCategory = (category: string) => {
   window.scrollTo({ top: 0, behavior: "smooth" });
 };
 
-const getEffectiveCategory = (): string => {
-  if (activeTab.value === "home") return "";
-  if (activeTab.value === "all") return selectedCategory.value;
-
-  const entry = sidebarEntries.value.find((e) => e.id === activeTab.value);
-  if (entry) {
-    if (entry.type === "category") return selectedCategory.value;
-    if (entry.type === "search") {
-      searchQuery.value = entry.value || "";
-      return selectedCategory.value;
-    }
-  }
-
-  return selectedCategory.value;
+// ===== 搜索 / 外链 / 更新中心编排 =====
+const handleSearchInput = (value: string) => {
+  currentView.value = "default";
+  searchQuery.value = value;
 };
 
-// 从仓库获取应用详细信息的辅助函数
-const fetchAppFromStore = async (
-  pkgname: string,
-  category: string,
-  origin: "spark" | "apm",
-): Promise<App | null> => {
-  try {
-    const arch = window.apm_store.arch || "amd64";
-    const finalArch = origin === "spark" ? `${arch}-store` : `${arch}-apm`;
-    // 路径参数需编码，避免特殊字符破坏请求路径或造成路径穿越
-    const appJsonUrl = `${APM_STORE_BASE_URL}/${finalArch}/${encodeURIComponent(
-      category,
-    )}/${encodeURIComponent(pkgname)}/app.json`;
-    // 接入 rootAbortController.signal，确保组件卸载/详情关闭时请求可被取消，
-    // 避免竞态与内存泄漏（onUnmounted 会 abort 该 controller）
-    const response = await fetch(appJsonUrl, {
-      signal: rootAbortController.signal,
-    });
-    if (!response.ok) return null;
-    const appJson = await response.json();
-    // img_urls 可能为字符串形式的 JSON，解析失败时安全回退为空数组
-    const parsedImgUrls = (() => {
-      if (typeof appJson.img_urls === "string") {
-        try {
-          return JSON.parse(appJson.img_urls) as string[];
-        } catch {
-          return [];
-        }
-      }
-      return (appJson.img_urls as string[]) || [];
-    })();
-    return {
-      name: appJson.Name || "",
-      pkgname: appJson.Pkgname || pkgname,
-      version: appJson.Version || "",
-      filename: appJson.Filename || "",
-      torrent_address: appJson.Torrent_address || "",
-      author: appJson.Author || "",
-      contributor: appJson.Contributor || "",
-      website: appJson.Website || "",
-      update: appJson.Update || "",
-      size: appJson.Size || "",
-      more: appJson.More || "",
-      tags: appJson.Tags || "",
-      img_urls: parsedImgUrls,
-      icons: appJson.icons || "",
-      category: category,
-      origin: origin,
-      currentStatus: "not-installed",
-    };
-  } catch (e) {
-    // 组件卸载/详情关闭触发 abort 时静默返回，避免刷 AbortError 日志
-    if ((e as Error)?.name === "AbortError") return null;
-    console.warn(`Failed to fetch ${origin} app info for ${pkgname}`, e);
-    return null;
-  }
-};
-
-// 已安装应用页查看详情：复用所有应用页的合并详情视图（始终展示 APM/Spark 两种包）
-const openDetailFromInstalled = (app: App) => {
-  openDetail({ ...app, _fromInstalled: true });
-};
-
-// openDetail 输入类型：完整 App 或仅含必要字段的轻量对象（含内部来源标记）
-interface OpenDetailInput extends Partial<App> {
-  pkgname?: string;
-  category?: string;
-  _fromHomeView?: boolean;
-  _fromInstalled?: boolean;
-  _fromDeepLink?: boolean;
-  origin?: "spark" | "apm";
-}
-
-// 提取远程/本地均无匹配时的回退 App 构造（两处兜底分支共用，避免重复字段映射）
-const createFallbackApp = (
-  raw: Record<string, unknown>,
-  pkgname: string,
-  category: string,
-): App => ({
-  name: (raw.name as string) || "",
-  pkgname,
-  version: (raw.version as string) || "",
-  filename: (raw.filename as string) || "",
-  category,
-  torrent_address: "",
-  author: "",
-  contributor: "",
-  website: "",
-  update: "",
-  size: "",
-  more: (raw.more as string) || "",
-  tags: "",
-  img_urls: [],
-  icons: "",
-  origin: (raw.origin as "spark" | "apm") || "apm",
-  currentStatus: "not-installed",
-});
-
-const openDetail = async (app: App | OpenDetailInput) => {
-  // 提取 pkgname 和 category（必须存在）
-  const pkgname = app?.pkgname;
-  if (!pkgname) {
-    console.warn("openDetail called without pkgname");
-    return;
-  }
-  const category = app.category || "unknown";
-  // 检查是否来自 HomeView 或 DeepLink（需要重新获取完整信息）
-  // 内部来源标记仅存在于轻量输入对象上，按 OpenDetailInput 读取以兼容联合类型
-  const marker = app as OpenDetailInput;
-  const fromHomeView = marker._fromHomeView === true;
-  const fromDeepLink = marker._fromDeepLink === true;
-  // 已安装应用页：始终按"所有应用页"的方式双来源拉取并合并展示（不移除另一类型）
-  const fromInstalled = marker._fromInstalled === true;
-  const needFetchFromStore = fromHomeView || fromDeepLink || fromInstalled;
-
-  // 首先尝试从当前已经处理好（合并/筛选）的 filteredApps 中查找
-  // 优先匹配点击来源 origin（例如排行点击 APM 应用时不应误匹配到 Spark 版）
-  const clickedOrigin = app.origin as "spark" | "apm" | undefined;
-  let fullApp = filteredApps.value.find(
-    (a) =>
-      a.pkgname === pkgname && (!clickedOrigin || a.origin === clickedOrigin),
-  );
-  // 如果没找到，回退到全局 apps 中查找（同样优先 origin）
-  if (!fullApp) {
-    fullApp = apps.value.find(
-      (a) =>
-        a.pkgname === pkgname && (!clickedOrigin || a.origin === clickedOrigin),
-    );
-  }
-  // 仍无匹配则退化为仅按 pkgname 匹配（兼容无 origin 的场景，如搜索结果）
-  if (!fullApp) {
-    fullApp =
-      filteredApps.value.find((a) => a.pkgname === pkgname) ||
-      apps.value.find((a) => a.pkgname === pkgname);
-  }
-
-  let finalApp: App;
-
-  // 来自 HomeView 或 DeepLink 的应用需要重新从仓库获取完整信息
-  if (needFetchFromStore) {
-    // 从 Spark 和 APM 仓库获取完整的应用信息
-    // 已安装页忽略当前商店单一模式限制，始终尝试拉取两种来源，保证另一类型不被隐藏
-    let [sparkApp, apmApp] = await Promise.all([
-      fromInstalled || storeFilter.value !== "apm"
-        ? fetchAppFromStore(pkgname, category, "spark")
-        : Promise.resolve(null),
-      fromInstalled || storeFilter.value !== "spark"
-        ? fetchAppFromStore(pkgname, category, "apm")
-        : Promise.resolve(null),
-    ]);
-
-    // 已安装页：若某来源仓库拉取失败（如分类不匹配），用本地已合并的应用补全，避免丢失另一类型
-    if (fromInstalled && fullApp && fullApp.isMerged) {
-      const merged = fullApp as App;
-      if (!sparkApp && merged.sparkApp) sparkApp = merged.sparkApp;
-      if (!apmApp && merged.apmApp) apmApp = merged.apmApp;
-    }
-
-    // 构建合并的应用对象
-    if (sparkApp || apmApp) {
-      // 如果两个仓库都有这个应用，创建合并对象
-      if (sparkApp && apmApp) {
-        // 优先遵从点击来源 origin；无点击来源时再按优先级配置决定默认显示
-        const defaultOrigin =
-          clickedOrigin && (clickedOrigin === "spark" ? sparkApp : apmApp)
-            ? clickedOrigin
-            : getHybridDefaultOrigin(sparkApp);
-        finalApp = {
-          ...(defaultOrigin === "spark" ? sparkApp : apmApp), // 根据优先级选择主显示
-          isMerged: true,
-          sparkApp: sparkApp,
-          apmApp: apmApp,
-          viewingOrigin: defaultOrigin, // 默认查看来源版本
-        };
-      } else if (sparkApp) {
-        finalApp = sparkApp;
-      } else {
-        finalApp = apmApp!;
-      }
-    } else if (fullApp) {
-      finalApp = fullApp;
-    } else {
-      // 两个仓库都没有找到，且本地也没有，构造一个最小可用的 App 对象
-      finalApp = createFallbackApp(
-        app as Record<string, unknown>,
-        pkgname,
-        category,
-      );
-    }
+const handleSpkLink = (pkgname: string) => {
+  currentView.value = "default";
+  activeTab.value = "all";
+  // 尝试从已加载的应用中查找
+  const target = apps.value.find((a) => a.pkgname === pkgname);
+  if (target) {
+    openDetail({ ...target, _fromDeepLink: true });
   } else {
-    // 非 HomeView 来源，使用原来的逻辑
-    if (fullApp) {
-      finalApp = fullApp;
-    } else {
-      // 构造一个最小可用的 App 对象
-      finalApp = createFallbackApp(
-        app as Record<string, unknown>,
-        pkgname,
-        category,
-      );
-    }
-  }
-
-  // 检查 Spark/APM 安装状态，已安装的版本优先展示
-  if (finalApp.isMerged && (finalApp.sparkApp || finalApp.apmApp)) {
-    const [sparkInstalled, apmInstalled] = await Promise.all([
-      finalApp.sparkApp
-        ? (window.ipcRenderer.invoke("check-installed", {
-            pkgname: finalApp.sparkApp.pkgname,
-            origin: "spark",
-          }) as Promise<boolean>)
-        : Promise.resolve(false),
-      finalApp.apmApp
-        ? (window.ipcRenderer.invoke("check-installed", {
-            pkgname: finalApp.apmApp.pkgname,
-            origin: "apm",
-          }) as Promise<boolean>)
-        : Promise.resolve(false),
-    ]);
-    // 来源默认展示规则：
-    //   1) 已安装页打开：按安装类型打开。
-    //        - 仅一个来源已安装 → 强制展示该已装来源（无需策略覆盖）
-    //        - 多个来源已安装 → 按「设置的优先标签」打开（策略）
-    //   2) 其他页面：一律按「设置的优先标签」打开（策略 > 服务端混合默认），不强制。
-    // 注：forceViewingOrigin 仅用于「已安装页 + 唯一安装来源」这一显式安装类型场景，
-    //     其余情况都不强制，交由详情页按用户标签策略重算。
-    let forceOrigin: "spark" | "apm" | undefined = undefined;
-    if (fromInstalled) {
-      const installedOrigins = (app as Record<string, unknown>).origins as
-        | Array<"spark" | "apm">
-        | undefined;
-      if (installedOrigins && installedOrigins.length === 1) {
-        // 单来源安装：按安装类型强制
-        forceOrigin = installedOrigins[0];
-      } else if (installedOrigins && installedOrigins.length > 1) {
-        // 多来源安装：交由策略（按设置优先标签），不强制
-        forceOrigin = undefined;
-      } else {
-        // origins 未随事件携带时，用 IPC 检测结果兜底判断安装类型
-        if (sparkInstalled && !apmInstalled) forceOrigin = "spark";
-        else if (apmInstalled && !sparkInstalled) forceOrigin = "apm";
-      }
-    }
-    // 非强制分支：清除可能由「已安装页」入口遗留的 forceViewingOrigin 粘性标志，
-    // 避免同一应用从其他页面再次打开时被锁死在旧来源（表现为设置切换不生效）。
-    finalApp.forceViewingOrigin = false;
-    if (
-      forceOrigin &&
-      (forceOrigin === "spark" ? finalApp.sparkApp : finalApp.apmApp)
-    ) {
-      // 已安装页 + 唯一安装来源 → 强制展示该安装类型，优先级高于用户标签策略
-      finalApp.viewingOrigin = forceOrigin;
-      finalApp.forceViewingOrigin = true;
-    } else if (sparkInstalled && !apmInstalled) {
-      // 仅 Spark 安装（其他页面）：默认回退展示已装版本，不强制（仍受用户策略覆盖）
-      finalApp.viewingOrigin = "spark";
-    } else if (apmInstalled && !sparkInstalled) {
-      finalApp.viewingOrigin = "apm";
-    } else {
-      // 都安装/都未安装且未指定来源：交由「标签优先显示策略」决定默认展示。
-      // 此处仅写入混合默认作为回退（供 appIdentity / 截图等下游使用），
-      // 但不置 forceViewingOrigin，详情页会按用户策略重算。
-      finalApp.viewingOrigin = getHybridDefaultOrigin(
-        finalApp.sparkApp || finalApp,
-      );
-    }
-  }
-
-  const displayAppForScreenshots =
-    finalApp.viewingOrigin !== undefined && finalApp.isMerged
-      ? ((finalApp.viewingOrigin === "spark"
-          ? finalApp.sparkApp
-          : finalApp.apmApp) ?? finalApp)
-      : finalApp;
-
-  currentApp.value = finalApp;
-  currentScreenIndex.value = 0;
-  loadScreenshots(displayAppForScreenshots);
-  showModal.value = true;
-
-  currentAppSparkInstalled.value = false;
-  currentAppApmInstalled.value = false;
-  checkAppInstalled(finalApp);
-  if (
-    isLoggedIn.value &&
-    favoriteFolders.value.length === 0 &&
-    !favoriteLoading.value
-  ) {
-    void loadFavoriteMetadataForDetail();
-  }
-
-  nextTick(() => {
-    const modal = document.querySelector(
-      '[data-app-modal="detail"] [data-testid="detail-scroll-content"]',
-    );
-    if (modal) modal.scrollTop = 0;
-  });
-};
-
-const checkAppInstalled = (app: App) => {
-  if (app.isMerged) {
-    if (app.sparkApp) {
-      window.ipcRenderer
-        .invoke("check-installed", {
-          pkgname: app.sparkApp.pkgname,
-          origin: "spark",
-        })
-        .then((isInstalled: boolean) => {
-          currentAppSparkInstalled.value = isInstalled;
-        });
-    }
-    if (app.apmApp) {
-      window.ipcRenderer
-        .invoke("check-installed", {
-          pkgname: app.apmApp.pkgname,
-          origin: "apm",
-        })
-        .then((isInstalled: boolean) => {
-          currentAppApmInstalled.value = isInstalled;
-        });
-    }
-  } else {
-    window.ipcRenderer
-      .invoke("check-installed", { pkgname: app.pkgname, origin: app.origin })
-      .then((isInstalled: boolean) => {
-        if (app.origin === "spark") {
-          currentAppSparkInstalled.value = isInstalled;
-        } else {
-          currentAppApmInstalled.value = isInstalled;
-        }
-      });
+    // 找不到时回退到搜索
+    searchQuery.value = pkgname;
   }
 };
 
-const loadScreenshots = (app: App) => {
-  screenshots.value = [];
-  const arch = window.apm_store.arch || "amd64";
-  const finalArch = app.origin === "spark" ? `${arch}-store` : `${arch}-apm`;
-  for (let i = 1; i <= 5; i++) {
-    const screenshotUrl = `${APM_STORE_BASE_URL}/${finalArch}/${app.category}/${app.pkgname}/screen_${i}.png`;
-    screenshots.value.push(screenshotUrl);
-  }
+const handleSearchFocus = () => {
+  currentView.value = "default";
+  if (activeTab.value === "home") activeTab.value = "all";
 };
 
-const closeDetail = () => {
-  showModal.value = false;
-  currentApp.value = null;
-};
-
-const openScreenPreview = (index: number) => {
-  currentScreenIndex.value = index;
-  showPreview.value = true;
-};
-
-const closeScreenPreview = () => {
-  showPreview.value = false;
-};
-
-// Home data
-const homeLinks = ref<HomeLink[]>([]);
-const homeLoading = ref(false);
-const homeError = ref("");
-
-// 首页三区域：区域2 板块（已迁移至「全部应用」等分类入口，首页不再展示）
-const apmRanking = ref<App[]>([]);
-const sparkRanking = ref<App[]>([]);
-
-// 区域3 · 下载排行（全站）：从全量应用目录逐应用拉取 download-times.txt，
-// 按 origin 分别排 APM / Spark 两榜。用代次守卫避免竞态。
-// 优化：localStorage 缓存（1 小时 TTL）避免重复请求；并发 48；每个批次完成后立即发布
-// 增量排名，边拉边显；fetchDownloadCount 优先命中缓存。
-let rankingGeneration = 0;
-const rankingLoading = ref(false);
-
-const DOWNLOAD_COUNT_CACHE_KEY = "spark-store:download-counts:v1";
-const DOWNLOAD_COUNT_CACHE_TTL_MS = 60 * 60 * 1000; // 1 小时
-
-interface CachedCount {
-  count: number;
-  ts: number;
-}
-
-const downloadCountCache = new Map<string, CachedCount>();
-
-const cacheKey = (app: App) => `${app.origin}:${app.category}:${app.pkgname}`;
-
-const loadCacheFromStorage = () => {
+const openExternalUrl = (url: string) => {
   try {
-    const raw = localStorage.getItem(DOWNLOAD_COUNT_CACHE_KEY);
-    if (!raw) return;
-    const data = JSON.parse(raw) as Record<string, CachedCount>;
-    const now = Date.now();
-    for (const [k, v] of Object.entries(data)) {
-      if (now - v.ts < DOWNLOAD_COUNT_CACHE_TTL_MS) {
-        downloadCountCache.set(k, v);
-      }
-    }
+    const parsed = new URL(url);
+    // 仅允许 http/https 协议，防止 javascript:/data: 等造成 XSS
+    if (!["http:", "https:"].includes(parsed.protocol)) return;
+    window.open(url, "_blank", "noopener,noreferrer");
   } catch {
-    // ignore corrupted cache
+    // 非法 URL 直接忽略，不打开
   }
 };
 
-const saveCacheToStorage = () => {
-  try {
-    const obj: Record<string, CachedCount> = {};
-    downloadCountCache.forEach((v, k) => {
-      obj[k] = v;
-    });
-    localStorage.setItem(DOWNLOAD_COUNT_CACHE_KEY, JSON.stringify(obj));
-  } catch {
-    // ignore quota errors
-  }
-};
+const updateCenterStore = createUpdateCenterStore();
 
-const fetchDownloadCount = async (app: App): Promise<number> => {
-  const key = cacheKey(app);
-  const cached = downloadCountCache.get(key);
-  if (cached) return cached.count;
-  const arch = window.apm_store.arch || "amd64";
-  const finalArch = app.origin === "spark" ? `${arch}-store` : `${arch}-apm`;
-  try {
-    const resp = await fetch(
-      `${APM_STORE_BASE_URL}/${finalArch}/${app.category}/${app.pkgname}/download-times.txt`,
-      { signal: rootAbortController.signal },
-    );
-    if (!resp.ok) return 0;
-    const text = (await resp.text()).trim();
-    const n = parseInt(text, 10);
-    const count = Number.isFinite(n) ? n : 0;
-    downloadCountCache.set(key, { count, ts: Date.now() });
-    return count;
-  } catch {
-    return 0;
-  }
-};
-
-const publishRanking = (results: App[]) => {
-  apmRanking.value = results
-    .filter((a) => a.origin === "apm")
-    .sort((x, y) => (y.downloadCount || 0) - (x.downloadCount || 0))
-    .slice(0, 10);
-  sparkRanking.value = results
-    .filter((a) => a.origin === "spark")
-    .sort((x, y) => (y.downloadCount || 0) - (x.downloadCount || 0))
-    .slice(0, 10);
-};
-
-const loadRanking = async () => {
-  if (apps.value.length === 0) return;
-  const gen = ++rankingGeneration;
-  rankingLoading.value = true;
-  const all = apps.value.slice();
-  const CONCURRENCY = 15;
-  const results: App[] = [];
-  for (let i = 0; i < all.length; i += CONCURRENCY) {
-    if (gen !== rankingGeneration) {
-      saveCacheToStorage();
-      return;
-    }
-    const batch = all.slice(i, i + CONCURRENCY);
-    const settled = await Promise.all(
-      batch.map(async (app) => ({
-        ...app,
-        downloadCount: await fetchDownloadCount(app),
-      })),
-    );
-    results.push(...settled);
-    // 边拉边发：每批完成后立即发布增量排名
-    if (gen === rankingGeneration) publishRanking(results);
-  }
-  if (gen !== rankingGeneration) {
-    saveCacheToStorage();
-    return;
-  }
-  rankingLoading.value = false;
-  saveCacheToStorage();
-};
-
-// 启动时即加载本地缓存（无需等待 apps），二次启动首屏即可见缓存排行
-loadCacheFromStorage();
-
-// 排行榜在 loadApps 全量完成后（onMounted）触发一次，确保 spark/apm 应用均已就绪
-
-const loadHome = async () => {
-  homeLoading.value = true;
-  homeError.value = "";
-  homeLinks.value = [];
-  try {
-    const arch = window.apm_store.arch || "amd64";
-    const modes: Array<"spark" | "apm"> =
-      storeFilter.value === "both" ? ["spark", "apm"] : [storeFilter.value];
-
-    // 按名称去重，spark 优先：同名链接 spark 覆盖 apm
-    const seenNames = new Set<string>();
-
-    // 并行请求各来源的 homelinks.json，缩短首页加载耗时
-    const modeResults = await Promise.all(
-      modes.map(async (mode) => {
-        const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
-        const base = `${APM_STORE_BASE_URL}/${finalArch}/home`;
-        try {
-          const res = await fetch(`${base}/homelinks.json`);
-          if (res.ok) return { mode, raw: (await res.json()) as unknown };
-        } catch (e) {
-          console.warn(`Failed to load ${mode} homelinks.json`, e);
-        }
-        return { mode, raw: undefined };
-      }),
-    );
-
-    for (const { mode, raw } of modeResults) {
-      if (!raw) continue;
-      // 校验 links 为数组，且每项均为对象（避免后端返回异常结构导致运行时错误）
-      const links = Array.isArray(raw)
-        ? (raw.filter((x) => x && typeof x === "object") as Record<
-            string,
-            unknown
-          >[])
-        : [];
-      for (const l of links) {
-        // 远程数据不可信，使用 typeof 运行时守卫替代 `as string` 断言，
-        // 避免非字符串字段（如数字/对象）被注入状态导致下游显示异常。
-        const name =
-          typeof l.Name === "string"
-            ? l.Name
-            : typeof l.name === "string"
-              ? l.name
-              : "";
-        if (!name) continue; // 跳过空名称，避免空字符串污染 seenNames 与去重逻辑
-        if (seenNames.has(name)) continue; // 已由更高优先级来源（spark）占据
-        // 仅校验 url 必需；远程 homelinks.json 不含 icon 字段（图片由 imgUrl 提供），
-        // 故 icon 不作为硬性校验，缺省为空串以兼容 HomeLink 类型。
-        const url =
-          typeof l.Url === "string"
-            ? l.Url
-            : typeof l.url === "string"
-              ? l.url
-              : "";
-        if (!url) continue;
-        const icon =
-          typeof l.Icon === "string"
-            ? l.Icon
-            : typeof l.icon === "string"
-              ? l.icon
-              : "";
-        seenNames.add(name);
-        // 显式提取已知字段构造，避免通过展开运算符 { ...l } 把远程不可信数据中的未知属性注入响应式状态
-        const safeLink: HomeLink = {
-          name,
-          url,
-          icon,
-          more: typeof l.more === "string" ? l.more : undefined,
-          imgUrl: typeof l.imgUrl === "string" ? l.imgUrl : undefined,
-          type: typeof l.type === "string" ? l.type : undefined,
-          origin: mode,
-        };
-        homeLinks.value.push(safeLink);
-      }
-    }
-  } catch (error: unknown) {
-    homeError.value = (error as Error)?.message || "加载首页失败";
-  } finally {
-    homeLoading.value = false;
-  }
-};
-
-// 加载首页推荐列表为侧边栏入口（按名称合并 spark/apm，置于分类入口上方）
-const loadHomeListEntries = async () => {
-  try {
-    const arch = window.apm_store.arch || "amd64";
-    const modes: Array<"spark" | "apm"> =
-      storeFilter.value === "both" ? ["spark", "apm"] : [storeFilter.value];
-
-    // 按列表名称合并各来源的 jsonUrl
-    const byName = new Map<
-      string,
-      { name: string; urls: { spark?: string; apm?: string } }
-    >();
-
-    // 并发拉取各来源的 homelist.json（spark/apm），缩短首页入口加载耗时；
-    // 各来源独立解析后合并到局部 byName，不逐个触发响应式更新。
-    await Promise.all(
-      modes.map(async (mode) => {
-        const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
-        const base = `${APM_STORE_BASE_URL}/${finalArch}/home`;
-        try {
-          const res = await fetch(`${base}/homelist.json`);
-          if (!res.ok) return;
-          const lists = await res.json();
-          lists.forEach(
-            (item: { name?: string; type?: string; jsonUrl?: string }) => {
-              if (item.type === "appList" && item.jsonUrl) {
-                const name = item.name || "推荐";
-                const existing = byName.get(name);
-                if (existing) {
-                  existing.urls[mode] = item.jsonUrl;
-                } else {
-                  byName.set(name, {
-                    name,
-                    urls: { [mode]: item.jsonUrl } as {
-                      spark?: string;
-                      apm?: string;
-                    },
-                  });
-                }
-              }
-            },
-          );
-        } catch (e) {
-          console.warn(`Failed to load ${mode} homelist.json`, e);
-        }
-      }),
-    );
-
-    const entries: SidebarEntry[] = [];
-    const urlsMap: Record<string, { spark?: string; apm?: string }> = {};
-
-    byName.forEach((info, name) => {
-      const id = `home-list-${name}`;
-      entries.push({
-        id,
-        name,
-        icon: "fas fa-star",
-        type: "homeList",
-      });
-      urlsMap[id] = info.urls;
-    });
-
-    if (entries.length > 0) {
-      // 首页推荐入口置于分类入口上方
-      sidebarEntries.value = [...entries, ...sidebarEntries.value];
-      homeListUrls.value = { ...homeListUrls.value, ...urlsMap };
-      logger.info(`已加载 ${entries.length} 个首页推荐列表入口`);
-    }
-  } catch (error) {
-    logger.warn(`加载首页推荐列表入口失败: ${error}`);
-  }
-};
-
-// 加载首页推荐列表的应用数据（合并展示 spark+apm，按 pkgname 去重，spark 优先）
-const loadHomeListApps = async (entryId: string) => {
-  if (tabApps.value[entryId]) return;
-  // 防止重复加载：如果正在加载中则跳过
-  if (loadingTabs.value.has(entryId)) return;
-
-  const urls = homeListUrls.value[entryId];
-  if (!urls) return;
-
-  // 标记为加载中
-  loadingTabs.value = new Set(loadingTabs.value).add(entryId);
-
-  const arch = window.apm_store.arch || "amd64";
-  const loadedApps: App[] = [];
-  const seenPkgnames = new Set<string>();
-
-  const parseAppList = (
-    rawApps: Record<string, string>[],
-    mode: "spark" | "apm",
-  ): App[] =>
-    rawApps.map((a) => {
-      // 首页推荐列表的 jsonUrl 形如 /home/lists/xxx.json；服务端原始数据不含 category 字段，
-      // 这里提取 URL 首段目录作为分类（无真实分类时回退 "unknown"），避免污染后续优先级匹配。
-      const urlCategory =
-        (urls[mode] || "").split("/").filter(Boolean)[0] || "unknown";
-      const category = a.Category || a.category || urlCategory;
-
-      let img_urls: string[] = [];
-      const rawImgUrls = a.img_urls;
-      if (typeof rawImgUrls === "string") {
-        try {
-          img_urls = JSON.parse(rawImgUrls);
-        } catch {
-          img_urls = [];
-        }
-      } else if (Array.isArray(rawImgUrls)) {
-        img_urls = rawImgUrls;
-      }
-
-      return {
-        name: a.Name || a.name || a.Pkgname || a.pkgname || "",
-        pkgname: a.Pkgname || a.pkgname || "",
-        version: a.Version || "",
-        filename: a.Filename || a.filename || "",
-        torrent_address: a.Torrent_address || "",
-        author: a.Author || "",
-        contributor: a.Contributor || "",
-        website: a.Website || "",
-        update: a.Update || "",
-        size: a.Size || "",
-        more: a.More || a.more || "",
-        tags: a.Tags || "",
-        img_urls,
-        icons: a.icons || "",
-        category,
-        origin: mode,
-        currentStatus: "not-installed" as const,
-      } as App;
-    });
-
-  // 按优先级顺序加载：spark 优先，apm 中与 spark 同名的跳过
-  const modes: Array<"spark" | "apm"> = ["spark", "apm"];
-  for (const mode of modes) {
-    const jsonUrl = urls[mode];
-    if (!jsonUrl) continue;
-    const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
-
-    try {
-      const path = `/${finalArch}${jsonUrl}`;
-      const rawApps =
-        (await fetchWithRetry<Record<string, string>[]>(
-          path,
-          rootAbortController.signal,
-        )) || [];
-      const apps = parseAppList(rawApps, mode);
-      for (const app of apps) {
-        if (!app.pkgname || seenPkgnames.has(app.pkgname)) continue;
-        seenPkgnames.add(app.pkgname);
-        loadedApps.push(app);
-      }
-    } catch (e) {
-      logger.warn(`加载首页列表 ${entryId} (${mode}) 失败: ${e}`);
-    }
-  }
-
-  tabApps.value = { ...tabApps.value, [entryId]: loadedApps };
-
-  // 移除加载标记
-  const next = new Set(loadingTabs.value);
-  next.delete(entryId);
-  loadingTabs.value = next;
-
-  logger.info(`首页列表 "${entryId}" 加载完成，共 ${loadedApps.length} 个应用`);
-};
-
-// 仅并行预加载首页 homeList 板块入口（区域2 数据来源，不依赖全量应用）
-const preloadHomeListApps = (): Promise<void> => {
-  const tasks: Promise<void>[] = [];
-  for (const entry of sidebarEntries.value) {
-    if (entry.type === "homeList") {
-      tasks.push(
-        loadHomeListApps(entry.id).catch((e: unknown) =>
-          logger.warn(`预加载首页列表 ${entry.id} 失败: ${e}`),
-        ),
-      );
-    }
-  }
-  return Promise.all(tasks).then(() => undefined);
-};
-
-// 并行预加载其余分类侧边栏入口（用户点击分类时才需要，可延后）
-const preloadSidebarTabApps = (): Promise<void> => {
-  const tasks: Promise<void>[] = [];
-  for (const entry of sidebarEntries.value) {
-    if (entry.type === "category") {
-      tasks.push(
-        loadTabApps(entry.id).catch((e: unknown) =>
-          logger.warn(`预加载入口 ${entry.id} 失败: ${e}`),
-        ),
-      );
-    }
-  }
-  return Promise.all(tasks).then(() => undefined);
-};
-
-const prevScreen = () => {
-  if (currentScreenIndex.value > 0) {
-    currentScreenIndex.value--;
-  }
-};
-
-const nextScreen = () => {
-  if (currentScreenIndex.value < screenshots.value.length - 1) {
-    currentScreenIndex.value++;
-  }
-};
-
-const handleUpdate = async () => {
-  await openUpdateModal();
-};
-
-const handleOpenInstallSettings = () => {
-  showSettingsModal.value = true;
-};
-
-const handleList = () => {
-  openInstalledModal();
-};
-
-const handleSubmit = async () => {
-  try {
-    const result = await window.ipcRenderer.invoke("launch-submitter");
-    if (!result?.success) {
-      logger.error(
-        "Failed to launch submitter: " + (result?.message || "unknown error"),
-      );
-    }
-  } catch (error) {
-    logger.error(`Failed to launch submitter: ${error}`);
-  }
-};
-
-const openUpdateModal = async () => {
-  try {
-    if (!effectiveStoreFilter.value) {
-      return;
-    }
-
-    await updateCenterStore.open(effectiveStoreFilter.value);
-  } catch (error) {
-    logger.error(`打开更新中心失败: ${error}`);
-  }
-};
-
-const hasMigrationSelection = (items: UpdateCenterItem[]): boolean => {
+const hasMigrationSelection = (
+  items: import("./global/typedefinition").UpdateCenterItem[],
+): boolean => {
   return items.some((item) => item.isMigration === true);
 };
 
@@ -1741,401 +828,53 @@ const confirmMigrationStart = async () => {
   }
 };
 
-const openInstalledModal = () => {
-  if (
-    getEffectiveStoreFilter(storeFilter.value, availableSources.value) === null
-  ) {
-    return;
-  }
-
-  showInstalledModal.value = true;
-  refreshInstalledApps();
-};
-
-const closeInstalledModal = () => {
-  showInstalledModal.value = false;
-  // 关闭模态框时同步清空错误 / 警告，避免下次打开时残留过期状态
-  installedError.value = "";
-  installedWarning.value = "";
-};
-
-// 根据当前启动模式和系统可用性，确定需要查询哪些 origin 的已安装应用
-const resolveInstalledOrigins = (): Array<"spark" | "apm"> => {
-  const origins: Array<"spark" | "apm"> = [];
-  if (isOriginUsable(storeFilter.value, "spark", availableSources.value)) {
-    origins.push("spark");
-  }
-  if (isOriginUsable(storeFilter.value, "apm", availableSources.value)) {
-    origins.push("apm");
-  }
-  return origins;
-};
-
-const refreshInstalledApps = async () => {
-  // 异步竞态防护：进入时若模态框已关闭（极小概率），直接放弃本轮请求
-  if (!showInstalledModal.value) return;
-  installedLoading.value = true;
-  installedError.value = "";
-  installedWarning.value = "";
-  // 代次计数器：每次进入自增；await 之后若代次已变（新一轮刷新 / 关闭重开），丢弃本轮结果
-  const generation = ++installedRefreshGeneration.value;
+const openUpdateModal = async () => {
   try {
-    const origins = resolveInstalledOrigins();
-    // Spark 已安装列表依赖商店目录（apps.value）来枚举包名。
-    // 仅当目录中存在可枚举的 Spark 包时才查询 Spark，
-    // 否则空目录会触发"全量扫描整个系统"的陷阱导致列表被全部跳过而误报为空。
-    const sparkPkgnameList = apps.value
-      .filter((a) => a.origin === "spark")
-      .map((a) => a.pkgname);
-    const effectiveOrigins = origins.filter(
-      (o) => o !== "spark" || sparkPkgnameList.length > 0,
-    );
-
-    if (effectiveOrigins.length === 0) {
-      installedApps.value = [];
-      // 目录尚未加载完成（但来源可用）时给出过渡提示，待目录加载后会自动重查
-      installedError.value =
-        apps.value.length === 0
-          ? "正在加载应用目录，请稍候…"
-          : "当前系统不可用应用管理功能";
+    if (!effectiveStoreFilter.value) {
       return;
     }
 
-    // 并行查询每个 origin 的已安装应用：
-    // 用 allSettled + 每源超时，避免单一来源（如 APM）响应慢/挂起阻塞整体；
-    // 超时或失败的来源在下方循环标记为 failedOrigin，不影响其它来源结果。
-    const results = await Promise.allSettled(
-      effectiveOrigins.map((origin) =>
-        withTimeout(
-          window.ipcRenderer.invoke("list-installed", {
-            origin,
-            pkgnameList: origin === "spark" ? sparkPkgnameList : undefined,
-          }),
-          LIST_INSTALLED_TIMEOUT_MS,
-          `${origin} list-installed`,
-        ),
-      ),
-    );
-
-    // 异步结束后的回调阶段重新校验代次与模态可见性，避免陈旧竞态写入 ref
-    if (generation !== installedRefreshGeneration.value) return;
-    if (!showInstalledModal.value) return;
-
-    const combinedApps: App[] = [];
-    // 同一 pkgname 可能同时以 APM 与 Spark 两种来源安装，这里聚合其来源集合
-    const originsByPkg = new Map<string, Set<"spark" | "apm">>();
-    const failedOrigins: string[] = [];
-
-    for (let i = 0; i < effectiveOrigins.length; i++) {
-      const origin = effectiveOrigins[i];
-      const settled = results[i];
-      // allSettled: rejected（超时/异常）或 success=false 都视为该来源失败
-      if (settled.status !== "fulfilled" || !settled.value?.success) {
-        failedOrigins.push(origin);
-        continue;
-      }
-      const result = settled.value;
-
-      const appList = Array.isArray(result?.apps) ? result.apps : [];
-      for (const rawApp of appList) {
-        // 运行时类型守卫，避免后端字段缺失造成下游访问 undefined 抛出
-        if (!isInstalledAppInfo(rawApp)) continue;
-        const app = rawApp;
-
-        // Find matching remote app to enrich data. We look exactly for that origin.
-        let appInfo = apps.value.find(
-          (a) => a.pkgname === app.pkgname && a.origin === origin,
-        );
-
-        if (origin === "spark" && !appInfo) {
-          // Only show Spark packages that exist in the App Store catalogue
-          continue;
-        }
-
-        if (appInfo) {
-          appInfo.flags = app.flags;
-          appInfo.arch = app.arch;
-          appInfo.currentStatus = "installed";
-          appInfo.isDependency = app.isDependency;
-        } else {
-          // 如果在当前应用列表中找不到该应用，创建一个最小的 App 对象
-          appInfo = {
-            name: app.name || app.pkgname,
-            pkgname: app.pkgname,
-            version: app.version,
-            category: "unknown",
-            tags: "",
-            more: "",
-            filename: "",
-            torrent_address: "",
-            author: "",
-            contributor: "",
-            website: "",
-            update: "",
-            size: "",
-            img_urls: [],
-            icons: app.icon || "",
-            origin: app.origin || (app.arch?.includes("apm") ? "apm" : "spark"),
-            currentStatus: "installed",
-            arch: app.arch,
-            flags: app.flags,
-            isDependency: app.isDependency,
-          };
-        }
-        // 合并同一 pkgname 在多个来源的安装记录为单条，避免列表出现重复项（相同 pkgname 键冲突）
-        const existingIdx = combinedApps.findIndex(
-          (a) => a.pkgname === appInfo.pkgname,
-        );
-        if (existingIdx === -1) {
-          combinedApps.push(appInfo);
-        }
-        // 记录该 pkgname 当前这一来源，供卸载时判断走 APM 还是 Spark
-        const originSet =
-          originsByPkg.get(appInfo.pkgname) ?? new Set<"spark" | "apm">();
-        originSet.add(origin);
-        originsByPkg.set(appInfo.pkgname, originSet);
-      }
-    }
-
-    // 将来源集合回写到每条已安装应用，供卸载时判断应走 APM 还是 Spark
-    for (const app of combinedApps) {
-      const set = originsByPkg.get(app.pkgname);
-      if (set) app.origins = Array.from(set);
-    }
-
-    installedApps.value = combinedApps;
-
-    // 部分来源失败使用轻量 warning（不与列表同时呈现红色致命错误条），致命/全失败仍用 error
-    if (failedOrigins.length > 0) {
-      const labels = failedOrigins
-        .map((o) => (o === "spark" ? "Spark" : "APM"))
-        .join("、");
-      if (combinedApps.length > 0) {
-        installedWarning.value = `部分来源加载失败（${labels}），已安装列表可能不完整`;
-      } else {
-        installedError.value = `读取${labels}已安装应用失败`;
-      }
-    }
-  } catch (error: unknown) {
-    if (generation !== installedRefreshGeneration.value) return;
-    if (!showInstalledModal.value) return;
-    installedApps.value = [];
-    installedError.value = (error as Error)?.message || "读取已安装应用失败";
-  } finally {
-    // 仅最末一代次负责清理 loading，防止陈旧代次提前关闭 loading 影响后续刷新
-    if (generation === installedRefreshGeneration.value) {
-      installedLoading.value = false;
-    }
+    await updateCenterStore.open(effectiveStoreFilter.value);
+  } catch (error) {
+    logger.error(`打开更新中心失败: ${error}`);
   }
 };
 
-// 应用目录（apps.value）可能在打开"已安装应用"模态框之后才加载完成。
-// 当目录长度变化、且模态框处于打开状态时，自动重查已安装应用，避免列表一直为空。
-// 注意：上一版仅在 prevLen===0→len>0 触发，会遗漏目录后续更新（例如分类切换触发目录重建）。
-// 现改为 len 任意 >0 的正向变化都允许触发；密集分批推送由下方 300ms 防抖合并最后一次写入。
-// 每次变化都先自增 installedRefreshGeneration：即使上一轮刷新仍在加载中，也会立即失效，
-// 避免用陈旧目录数据覆盖已安装列表（清理不单纯依赖定时器，代次校验兜底）。
-// initialCatalogLoaded：初始目录分批加载期间（apps.length 频繁变化）跳过此 watcher，
-// 避免对未打开的模态框做无意义的已安装列表刷新 IPC。
-const initialCatalogLoaded = ref(false);
-let refreshDebounceTimer: ReturnType<typeof setTimeout> | null = null;
-watch(
-  () => apps.value.length,
-  (len) => {
-    if (!initialCatalogLoaded.value) return;
-    if (!showInstalledModal.value || len <= 0) {
-      return;
-    }
-    installedRefreshGeneration.value++;
-    if (refreshDebounceTimer !== null) {
-      clearTimeout(refreshDebounceTimer);
-    }
-    refreshDebounceTimer = setTimeout(() => {
-      refreshDebounceTimer = null;
-      void refreshInstalledApps();
-    }, 300);
-  },
-);
-onUnmounted(() => {
-  if (refreshDebounceTimer !== null) {
-    clearTimeout(refreshDebounceTimer);
-  }
-});
-
-const mapInstalledAppToCatalogApp = (
-  app: InstalledAppInfo,
-  origin: "spark" | "apm",
-): App | null => {
-  let appInfo = apps.value.find(
-    (catalogApp) =>
-      catalogApp.pkgname === app.pkgname && catalogApp.origin === origin,
-  );
-
-  if (origin === "spark" && !appInfo) {
-    return null;
-  }
-
-  if (appInfo) {
-    appInfo.flags = app.flags;
-    appInfo.arch = app.arch;
-    appInfo.currentStatus = "installed";
-    appInfo.isDependency = app.isDependency;
-    return appInfo;
-  }
-
-  return {
-    name: app.name || app.pkgname,
-    pkgname: app.pkgname,
-    version: app.version,
-    category: "unknown",
-    tags: "",
-    more: "",
-    filename: "",
-    torrent_address: "",
-    author: "",
-    contributor: "",
-    website: "",
-    update: "",
-    size: "",
-    img_urls: [],
-    icons: app.icon || "",
-    origin: app.origin || (app.arch?.includes("apm") ? "apm" : "spark"),
-    currentStatus: "installed",
-    arch: app.arch,
-    flags: app.flags,
-    isDependency: app.isDependency,
-  };
+const handleUpdate = async () => {
+  await openUpdateModal();
 };
 
-const refreshFavoriteInstalledApps = async (): Promise<void> => {
-  const origins: Array<"spark" | "apm"> = [];
-  if (isOriginEnabled(storeFilter.value, "spark") && sparkAvailable.value) {
-    origins.push("spark");
-  }
-  if (isOriginEnabled(storeFilter.value, "apm") && apmAvailable.value) {
-    origins.push("apm");
-  }
-
-  const refreshedApps: App[] = [];
-  await Promise.all(
-    origins.map(async (origin) => {
-      const pkgnameList =
-        origin === "spark"
-          ? apps.value
-              .filter((app) => app.origin === "spark")
-              .map((app) => app.pkgname)
-          : undefined;
-      const result = await window.ipcRenderer.invoke("list-installed", {
-        origin,
-        pkgnameList,
-      });
-      if (!result?.success) return;
-
-      const appList = Array.isArray(result?.apps) ? result.apps : [];
-      for (const rawApp of appList) {
-        // 运行时类型守卫：避免后端字段缺失时下游访问 undefined
-        if (!isInstalledAppInfo(rawApp)) continue;
-        const appInfo = mapInstalledAppToCatalogApp(rawApp, origin);
-        if (appInfo) refreshedApps.push(appInfo);
-      }
-    }),
-  );
-
-  const refreshedKeys = new Set(
-    refreshedApps.map((app) => `${app.origin}:${app.pkgname}`),
-  );
-  installedApps.value = [
-    ...installedApps.value.filter(
-      (app) =>
-        !origins.includes(app.origin) &&
-        !refreshedKeys.has(`${app.origin}:${app.pkgname}`),
-    ),
-    ...refreshedApps,
-  ];
+const handleOpenInstallSettings = () => {
+  showSettingsModal.value = true;
 };
 
-const requestUninstall = (app: App) => {
-  uninstallTargetApp.value = app;
-  showUninstallModal.value = true;
-  removeDownloadItem(app.pkgname);
+const handleList = () => {
+  openInstalledModal();
 };
 
-const onDetailRemove = (app: App) => {
-  requestUninstall(app);
-};
-
-const onDetailInstall = async (app: App) => {
-  const initiatingUserId = currentUser.value?.id ?? null;
-  const download = await handleInstall(app);
-  if (
-    !download ||
-    initiatingUserId === null ||
-    !isLoggedIn.value ||
-    currentUser.value?.id !== initiatingUserId
-  ) {
-    return;
-  }
-
-  pendingDownloadRecords.set(download.id, {
-    userId: initiatingUserId,
-    appKey: buildFavoriteAppKey(app),
-    pkgname: app.pkgname,
-    name: app.name,
-    category: app.category,
-    selectedOrigin: app.origin,
-    version: app.version,
-    packageArch: app.arch || parsePackageArch(app.filename),
-  });
-};
-
-const handleInstallCompleteForDownloadRecord = async (
-  _event: IpcRendererEvent,
-  result: DownloadResult,
-) => {
-  const pendingRecord = pendingDownloadRecords.get(result.id);
-  if (!pendingRecord) return;
-
-  if (result.success) {
-    pendingDownloadRecords.delete(result.id);
-  }
-
-  if (
-    !result.success ||
-    !isLoggedIn.value ||
-    currentUser.value?.id !== pendingRecord.userId
-  ) {
-    return;
-  }
-
-  const downloadRecord: Omit<DownloadedAppRecord, "id" | "downloadedAt"> = {
-    appKey: pendingRecord.appKey,
-    pkgname: pendingRecord.pkgname,
-    name: pendingRecord.name,
-    category: pendingRecord.category,
-    selectedOrigin: pendingRecord.selectedOrigin,
-    version: pendingRecord.version,
-    packageArch: pendingRecord.packageArch,
-  };
-
+const handleSubmit = async () => {
   try {
-    await recordDownloadedApp(downloadRecord);
-  } catch (error: unknown) {
-    logger.warn({ err: error }, "记录下载应用失败");
+    const result = await window.ipcRenderer.invoke("launch-submitter");
+    if (!result?.success) {
+      logger.error(
+        "Failed to launch submitter: " + (result?.message || "unknown error"),
+      );
+    }
+  } catch (error) {
+    logger.error(`Failed to launch submitter: ${error}`);
   }
 };
 
-const onDetailFavorite = async (app: App) => {
-  await openFavoriteSelector(app);
+const openAboutModal = () => {
+  showAboutModal.value = true;
 };
 
-const selectDetailOrigin = (origin: "spark" | "apm") => {
-  if (currentApp.value?.isMerged) {
-    currentApp.value = { ...currentApp.value, viewingOrigin: origin };
-  }
+const closeAboutModal = () => {
+  showAboutModal.value = false;
 };
 
-const handleDetailRequestLogin = (message: string) => {
-  requireLogin(message);
+const closeSettingsModal = () => {
+  showSettingsModal.value = false;
 };
 
 const closeUninstallModal = () => {
@@ -2143,17 +882,6 @@ const closeUninstallModal = () => {
   uninstallTargetApp.value = null;
 };
 
-const onUninstallSuccess = () => {
-  // 刷新已安装列表（如果在显示）
-  if (showInstalledModal.value) {
-    refreshInstalledApps();
-  }
-  // 更新当前详情页状态（如果在显示）
-  if (showModal.value && currentApp.value) {
-    checkAppInstalled(currentApp.value);
-  }
-};
-
 const closeApmInstallDialog = () => {
   showApmInstallDialog.value = false;
 };
@@ -2170,1115 +898,23 @@ const confirmApmInstall = async () => {
   }
 };
 
-const installCompleteCallback = (pkgname?: string) => {
-  if (currentApp.value && (!pkgname || currentApp.value.pkgname === pkgname)) {
-    checkAppInstalled(currentApp.value);
-  }
-};
-
-watchDownloadsChange(installCompleteCallback);
-
-const uninstallInstalledApp = (app: App) => {
-  requestUninstall(app);
-};
-
-const openAboutModal = () => {
-  showAboutModal.value = true;
-};
-
-const closeAboutModal = () => {
-  showAboutModal.value = false;
-};
-
-const closeSettingsModal = () => {
-  showSettingsModal.value = false;
-};
-
-const openExternalUrl = (url: string) => {
-  try {
-    const parsed = new URL(url);
-    // 仅允许 http/https 协议，防止 javascript:/data: 等造成 XSS
-    if (!["http:", "https:"].includes(parsed.protocol)) return;
-    window.open(url, "_blank", "noopener,noreferrer");
-  } catch {
-    // 非法 URL 直接忽略，不打开
-  }
-};
-
-const openReviewUserProfile = (review: AppReview): void => {
-  const current = currentUser.value;
-  const isCurrentUser =
-    review.isAuthor === true ||
-    (review.userId !== undefined &&
-      current?.id !== undefined &&
-      review.userId === current.id);
-
-  selectedReviewUserProfile.value = {
-    displayName: review.userDisplayName || "星火用户",
-    username: isCurrentUser ? current?.username : undefined,
-    avatarUrl:
-      review.userAvatarUrl || (isCurrentUser ? current?.avatarUrl : undefined),
-    coverUrl: isCurrentUser ? current?.coverUrl : undefined,
-    forumGroups: isCurrentUser ? current?.forumGroups : undefined,
-  };
-  showReviewUserProfileModal.value = true;
-};
-
-const requireLogin = (message: string): boolean => {
-  if (isLoggedIn.value) return true;
-  loginPromptMessage.value = message;
-  showLoginPrompt.value = true;
-  return false;
-};
-
-const openLoginFromPrompt = () => {
-  showLoginPrompt.value = false;
-  showLoginModal.value = true;
-};
-
-const clearFavoriteState = () => {
-  favoriteRequestGeneration.value += 1;
-  favoriteFolders.value = [];
-  activeFavoriteFolderId.value = null;
-  favoriteItems.value = [];
-  favoriteItemsByFolder.value = {};
-  showFavoriteSelector.value = false;
-  favoriteTargetApp.value = null;
-  favoriteSelectorDraftFolderIds.value = null;
-  favoriteLoading.value = false;
-  favoriteError.value = "";
-};
-
-const clearDownloadedState = () => {
-  downloadedRequestGeneration.value += 1;
-  downloadedApps.value = [];
-  downloadedLoading.value = false;
-  downloadedError.value = "";
-};
-
-const clearRestoreState = () => {
-  restoreRequestGeneration.value += 1;
-  restoreItems.value = [];
-  restoreLoading.value = false;
-  restoreError.value = "";
-  showRestoreModal.value = false;
-};
-
-const clearInstalledSyncState = () => {
-  syncRequestGeneration.value += 1;
-  syncLoading.value = false;
-  syncStatusMessage.value = "";
-  syncCandidateApps.value = [];
-};
-
-const nextFavoriteRequestGeneration = (): number => {
-  favoriteRequestGeneration.value += 1;
-  return favoriteRequestGeneration.value;
-};
-
-const nextDownloadedRequestGeneration = (): number => {
-  downloadedRequestGeneration.value += 1;
-  return downloadedRequestGeneration.value;
-};
-
-const isCurrentFavoriteRequest = (generation: number): boolean =>
-  favoriteRequestGeneration.value === generation && isLoggedIn.value;
-
-const isCurrentDownloadedRequest = (
-  generation: number,
-  userId: number,
-): boolean =>
-  downloadedRequestGeneration.value === generation &&
-  currentUser.value?.id === userId;
-
-const isCurrentRestoreRequest = (generation: number, userId: number): boolean =>
-  restoreRequestGeneration.value === generation &&
-  currentUser.value?.id === userId;
-
-const handleLogout = () => {
-  logout();
-  pendingDownloadRecords.clear();
-  clearFavoriteState();
-  clearDownloadedState();
-  clearRestoreState();
-  clearInstalledSyncState();
-  loadInstalledSyncPreference(null);
-  showLoginModal.value = false;
-  showLoginPrompt.value = false;
-  isSidebarOpen.value = false;
-  showUserManagementModal.value = false;
-  if (currentView.value === "favorites") {
-    currentView.value = "default";
-    activeTab.value = "home";
-    selectedCategory.value = "all";
-  }
-};
-
-const handleFlarumLogin = async (payload: FlarumLoginPayload) => {
-  loginLoading.value = true;
-  loginError.value = "";
-
-  try {
-    const flarumToken = await requestFlarumToken(payload);
-    const session = await exchangeFlarumToken({
-      flarumUserId: flarumToken.userId,
-      flarumToken: flarumToken.token,
-    });
-    setAuthSession(session);
-    clearInstalledSyncState();
-    loadInstalledSyncPreference(session.user.id);
-    showLoginModal.value = false;
-  } catch (error: unknown) {
-    loginError.value = (error as Error)?.message || "登录失败，请稍后重试";
-  } finally {
-    loginLoading.value = false;
-  }
-};
-
-const loadDownloadedHistory = async (): Promise<void> => {
-  if (!requireLogin("请登录后查看和管理账号信息。")) return;
-  const userId = currentUser.value?.id;
-  if (userId === undefined) return;
-  const generation = nextDownloadedRequestGeneration();
-
-  downloadedLoading.value = true;
-  downloadedError.value = "";
-  try {
-    const result = await listDownloadedApps(1, 50);
-    if (!isCurrentDownloadedRequest(generation, userId)) return;
-    downloadedApps.value = result.items;
-  } catch (error: unknown) {
-    if (!isCurrentDownloadedRequest(generation, userId)) return;
-    downloadedApps.value = [];
-    downloadedError.value = (error as Error)?.message || "读取下载历史失败";
-  } finally {
-    if (isCurrentDownloadedRequest(generation, userId)) {
-      downloadedLoading.value = false;
-    }
-  }
-};
-
-const refreshInstalledSyncCandidates = async (
-  isCurrentRequest: () => boolean,
-): Promise<boolean> => {
-  const origins: Array<"spark" | "apm"> = [];
-  if (isOriginEnabled(storeFilter.value, "spark") && sparkAvailable.value) {
-    origins.push("spark");
-  }
-  if (isOriginEnabled(storeFilter.value, "apm") && apmAvailable.value) {
-    origins.push("apm");
-  }
-
-  const refreshedApps: App[] = [];
-  await Promise.all(
-    origins.map(async (origin) => {
-      const pkgnameList =
-        origin === "spark"
-          ? apps.value
-              .filter((app) => app.origin === "spark")
-              .map((app) => app.pkgname)
-          : undefined;
-      const result = await window.ipcRenderer.invoke("list-installed", {
-        origin,
-        pkgnameList,
-      });
-      if (!result?.success) return;
-
-      const appList = Array.isArray(result?.apps) ? result.apps : [];
-      for (const rawApp of appList) {
-        // 运行时类型守卫：避免后端字段缺失时下游访问 undefined
-        if (!isInstalledAppInfo(rawApp)) continue;
-        const appInfo = mapInstalledAppToCatalogApp(rawApp, origin);
-        if (appInfo) refreshedApps.push(appInfo);
-      }
-    }),
-  );
-
-  if (!isCurrentRequest()) {
-    return false;
-  }
-
-  syncCandidateApps.value = mergeInstalledApps(
-    syncCandidateApps.value,
-    refreshedApps,
-    origins,
-  );
-  return true;
-};
-
-const syncInstalledAppsToAccount = async (): Promise<void> => {
-  if (!requireLogin("云端同步需要登录星火账号。")) return;
-  if (syncLoading.value) return;
-  const userId = currentUser.value?.id;
-  if (userId === undefined) return;
-  const generation = syncRequestGeneration.value + 1;
-  syncRequestGeneration.value = generation;
-  syncLoading.value = true;
-  syncStatusMessage.value = "";
-  try {
-    const refreshed = await refreshInstalledSyncCandidates(
-      () =>
-        syncRequestGeneration.value === generation &&
-        currentUser.value?.id === userId,
-    );
-    if (!refreshed) return;
-    const items = buildSyncItems(syncCandidateApps.value);
-    await uploadSyncedAppList({
-      clientArch: window.apm_store.arch || "amd64",
-      distro: systemInfo.value.distro,
-      items,
-    });
-    if (
-      syncRequestGeneration.value !== generation ||
-      currentUser.value?.id !== userId
-    ) {
-      return;
-    }
-    downloadedError.value = "";
-    syncStatusMessage.value = "同步完成";
-  } catch (error: unknown) {
-    if (
-      syncRequestGeneration.value !== generation ||
-      currentUser.value?.id !== userId
-    ) {
-      return;
-    }
-    downloadedError.value = (error as Error)?.message || "同步已安装应用失败";
-    syncStatusMessage.value = downloadedError.value;
-  } finally {
-    if (
-      syncRequestGeneration.value === generation &&
-      currentUser.value?.id === userId
-    ) {
-      syncLoading.value = false;
-    }
-  }
-};
-
-const syncInstalledAppsNow = (): void => {
-  void syncInstalledAppsToAccount();
-};
-
-const openRestoreFromAccount = async (): Promise<void> => {
-  if (!requireLogin("云端同步需要登录星火账号。")) return;
-  const userId = currentUser.value?.id;
-  if (userId === undefined) return;
-  const generation = restoreRequestGeneration.value + 1;
-  restoreRequestGeneration.value = generation;
-  showRestoreModal.value = true;
-  restoreLoading.value = true;
-  restoreError.value = "";
-  restoreItems.value = [];
-  try {
-    const refreshed = await refreshInstalledSyncCandidates(() =>
-      isCurrentRestoreRequest(generation, userId),
-    );
-    if (!refreshed) return;
-    const result = await fetchSyncedAppList();
-    if (!isCurrentRestoreRequest(generation, userId)) return;
-    restoreItems.value = result?.items || [];
-  } catch (error: unknown) {
-    if (!isCurrentRestoreRequest(generation, userId)) return;
-    restoreError.value = (error as Error)?.message || "读取云端应用列表失败";
-  } finally {
-    if (isCurrentRestoreRequest(generation, userId)) {
-      restoreLoading.value = false;
-    }
-  }
-};
-
-const installCloudItems = (items: SyncedAppListItem[]): void => {
-  for (const item of items) {
-    const app = resolveCloudInstallCandidate(item, apps.value);
-    if (!app) continue;
-    void onDetailInstall(app);
-  }
-  showRestoreModal.value = false;
-};
-
-const maybePromptInstalledSync = async (): Promise<void> => {
-  if (
-    import.meta.env.MODE === "test" ||
-    !isLoggedIn.value ||
-    installedSyncPromptShown.value ||
-    installedSyncEnabled.value !== null
-  ) {
-    if (isLoggedIn.value && installedSyncEnabled.value === true) {
-      await syncInstalledAppsToAccount();
-    }
-    return;
-  }
-
-  installedSyncPromptShown.value = true;
-  const enabled = window.confirm(
-    "是否启用已安装应用列表自动同步到星火账号？仅同步商店识别的非依赖应用。",
-  );
-  setInstalledSyncEnabled(enabled);
-  if (enabled) await syncInstalledAppsToAccount();
-};
-
-const openUserManagement = async () => {
-  if (!requireLogin("请登录后查看和管理账号信息。")) return;
-  showUserManagementModal.value = true;
-  isSidebarOpen.value = false;
-  showLoginPrompt.value = false;
-  await loadDownloadedHistory();
-};
-
-const loadFavoriteFolders = async (
-  generation = favoriteRequestGeneration.value,
-): Promise<boolean> => {
-  const folders = await listFavoriteFolders();
-  if (!isCurrentFavoriteRequest(generation)) return false;
-
-  favoriteFolders.value = folders;
-  const activeFolderExists = folders.some(
-    (folder) => folder.id === activeFavoriteFolderId.value,
-  );
-  if (!activeFolderExists) {
-    activeFavoriteFolderId.value = folders[0]?.id ?? null;
-  }
-  return true;
-};
-
-const loadActiveFavoriteItems = async (
-  generation = favoriteRequestGeneration.value,
-): Promise<boolean> => {
-  if (!activeFavoriteFolderId.value) {
-    if (!isCurrentFavoriteRequest(generation)) return false;
-    favoriteItems.value = [];
-    return true;
-  }
-  const items = await listFavoriteItems(activeFavoriteFolderId.value);
-  if (!isCurrentFavoriteRequest(generation)) return false;
-
-  favoriteItems.value = items;
-  favoriteItemsByFolder.value = {
-    ...favoriteItemsByFolder.value,
-    [activeFavoriteFolderId.value]: items,
-  };
-  return true;
-};
-
-const loadAllFavoriteItems = async (
-  generation = favoriteRequestGeneration.value,
-): Promise<boolean> => {
-  const folderIds = favoriteFolders.value.map((folder) => folder.id);
-  const entries = await Promise.all(
-    folderIds.map(async (folderId) => ({
-      folderId,
-      items: await listFavoriteItems(folderId),
-    })),
-  );
-  if (!isCurrentFavoriteRequest(generation)) return false;
-
-  favoriteItemsByFolder.value = Object.fromEntries(
-    entries.map(({ folderId, items }) => [folderId, items]),
-  );
-  favoriteItems.value = activeFavoriteFolderId.value
-    ? (favoriteItemsByFolder.value[activeFavoriteFolderId.value] ?? [])
-    : [];
-  return true;
-};
-
-const loadFavoriteMetadataForDetail = async (): Promise<void> => {
-  const generation = favoriteRequestGeneration.value;
-  try {
-    const folders = await listFavoriteFolders();
-    if (!isCurrentFavoriteRequest(generation)) return;
-    const entries = await Promise.all(
-      folders.map(async (folder) => ({
-        folderId: folder.id,
-        items: await listFavoriteItems(folder.id),
-      })),
-    );
-    if (!isCurrentFavoriteRequest(generation)) return;
-
-    favoriteFolders.value = folders;
-    favoriteItemsByFolder.value = Object.fromEntries(
-      entries.map(({ folderId, items }) => [folderId, items]),
-    );
-  } catch (error: unknown) {
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteError.value = (error as Error)?.message || "读取收藏夹失败";
-  }
-};
-
-const refreshFavorites = async (): Promise<void> => {
-  const generation = nextFavoriteRequestGeneration();
-  favoriteLoading.value = true;
-  favoriteError.value = "";
-  try {
-    await Promise.all([
-      refreshFavoriteInstalledApps(),
-      loadFavoriteFolders(generation),
-    ]);
-    if (!isCurrentFavoriteRequest(generation)) return;
-    await loadAllFavoriteItems(generation);
-  } catch (error: unknown) {
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteError.value = (error as Error)?.message || "读取收藏夹失败";
-  } finally {
-    if (isCurrentFavoriteRequest(generation)) favoriteLoading.value = false;
-  }
-};
-
-const openFavoriteSelector = async (app: App) => {
-  if (!requireLogin("收藏应用需要登录星火账号。")) return;
-  const generation = nextFavoriteRequestGeneration();
-  favoriteTargetApp.value = app;
-  favoriteSelectorDraftFolderIds.value = null;
-  favoriteError.value = "";
-  try {
-    const foldersLoaded = await loadFavoriteFolders(generation);
-    if (!foldersLoaded || !isCurrentFavoriteRequest(generation)) return;
-    const itemsLoaded = await loadAllFavoriteItems(generation);
-    if (!itemsLoaded || !isCurrentFavoriteRequest(generation)) return;
-    showFavoriteSelector.value = true;
-  } catch (error: unknown) {
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteError.value = (error as Error)?.message || "读取收藏夹失败";
-  }
-};
-
-const toFavoritePayload = (
-  app: App,
-): Omit<FavoriteItem, "id" | "createdAt"> => ({
-  appKey: buildFavoriteAppKey(app),
-  pkgname: app.pkgname,
-  name: app.name,
-  category: app.category,
-  iconUrl: app.icons,
+// ===== 跨 composable 引用登记（注入式，避免循环依赖，行为与原实现一致） =====
+setFilteredApps(filteredApps);
+registerCheckAppInstalled(checkAppInstalled);
+registerRequestUninstall((app: App) => {
+  uninstallTargetApp.value = app;
+  showUninstallModal.value = true;
+  // removeDownloadItem 由 useDownloads 内部处理；此处仅触发弹窗
 });
+registerIsInstalledAppInfo(isInstalledAppInfo);
+registerMapInstalledAppToCatalogApp(mapInstalledAppToCatalogApp as never);
+registerLogout(logout);
+registerSetAuthSession(setAuthSession as (s: unknown) => void);
+registerCurrentDisplayApp(() => currentDisplayApp.value);
+registerOnDetailInstall(onDetailInstall);
+registerPendingDownloadRecordsClear(clearPendingDownloadRecords);
 
-const saveCurrentFavoriteFolders = async (
-  folderIds: Array<number | "default">,
-) => {
-  const generation = favoriteRequestGeneration.value;
-  const app = favoriteTargetApp.value;
-  if (!app) return;
-  try {
-    const numericFolderIds = folderIds.filter(
-      (folderId): folderId is number => typeof folderId === "number",
-    );
-    const includesFallbackDefault = folderIds.includes("default");
-    const nextFolderIds = new Set(numericFolderIds);
-    const existingByFolder = favoriteFolders.value
-      .map((folder) => ({
-        folderId: folder.id,
-        item: (favoriteItemsByFolder.value[folder.id] ?? []).find(
-          (favorite) =>
-            favorite.pkgname === app.pkgname &&
-            favorite.category === app.category,
-        ),
-      }))
-      .filter(
-        (entry): entry is { folderId: number; item: FavoriteItem } =>
-          entry.item !== undefined,
-      );
-    const existingFolderIds = new Set(
-      existingByFolder.map((entry) => entry.folderId),
-    );
-    const payload = toFavoritePayload(app);
-    const addedItemPromises = numericFolderIds
-      .filter((folderId) => !existingFolderIds.has(folderId))
-      .map(async (folderId) => ({
-        folderId,
-        item: await addFavoriteItem(folderId, payload),
-      }));
-    const deletedEntries = existingByFolder.filter(
-      ({ folderId }) => !nextFolderIds.has(folderId),
-    );
-
-    const [addedEntries] = await Promise.all([
-      Promise.all(addedItemPromises),
-      ...(includesFallbackDefault ? [addFavoriteItem("default", payload)] : []),
-      ...deletedEntries.map(({ folderId, item }) =>
-        deleteFavoriteItem(folderId, item.id),
-      ),
-    ]);
-    if (!isCurrentFavoriteRequest(generation)) return;
-    const nextItemsByFolder = { ...favoriteItemsByFolder.value };
-    deletedEntries.forEach(({ folderId, item }) => {
-      nextItemsByFolder[folderId] = (nextItemsByFolder[folderId] ?? []).filter(
-        (favorite) => favorite.id !== item.id,
-      );
-    });
-    addedEntries.forEach(({ folderId, item }) => {
-      nextItemsByFolder[folderId] = [
-        ...(nextItemsByFolder[folderId] ?? []).filter(
-          (favorite) =>
-            favorite.pkgname !== app.pkgname ||
-            favorite.category !== app.category,
-        ),
-        item,
-      ];
-    });
-    favoriteItemsByFolder.value = nextItemsByFolder;
-    if (activeFavoriteFolderId.value) {
-      favoriteItems.value =
-        nextItemsByFolder[activeFavoriteFolderId.value] ?? [];
-    }
-    showFavoriteSelector.value = false;
-    favoriteTargetApp.value = null;
-    favoriteSelectorDraftFolderIds.value = null;
-    if (includesFallbackDefault) await refreshFavorites();
-  } catch (error: unknown) {
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteError.value = (error as Error)?.message || "更新收藏失败";
-  }
-};
-
-const createFavoriteFolderFromSelector = async (
-  draftFolderIds: Array<number | "default"> = currentFavoriteFolderIds.value,
-): Promise<void> => {
-  const generation = favoriteRequestGeneration.value;
-  const name = window.prompt("请输入收藏夹名称");
-  const folderName = name?.trim();
-  if (!folderName) return;
-  const app = favoriteTargetApp.value;
-  if (!app) return;
-  favoriteLoading.value = true;
-  favoriteError.value = "";
-  try {
-    const folder = await createFavoriteFolder(folderName);
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteFolders.value = [
-      ...favoriteFolders.value.filter((item) => item.id !== folder.id),
-      folder,
-    ];
-    favoriteItemsByFolder.value = {
-      ...favoriteItemsByFolder.value,
-      [folder.id]: favoriteItemsByFolder.value[folder.id] ?? [],
-    };
-    favoriteSelectorDraftFolderIds.value = [
-      ...new Set([...draftFolderIds, folder.id]),
-    ];
-    showFavoriteSelector.value = true;
-  } catch (error: unknown) {
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteError.value = (error as Error)?.message || "创建收藏夹失败";
-  } finally {
-    if (isCurrentFavoriteRequest(generation)) favoriteLoading.value = false;
-  }
-};
-
-const openFavoriteManagement = async () => {
-  if (!requireLogin("请登录后查看我的收藏。")) return;
-  currentView.value = "favorites";
-  activeTab.value = "favorites";
-  isSidebarOpen.value = false;
-  showLoginPrompt.value = false;
-  await refreshFavorites();
-};
-
-const selectFavoriteFolder = async (folderId: number) => {
-  const generation = nextFavoriteRequestGeneration();
-  activeFavoriteFolderId.value = folderId;
-  favoriteLoading.value = true;
-  favoriteError.value = "";
-  try {
-    await loadActiveFavoriteItems(generation);
-  } catch (error: unknown) {
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteError.value = (error as Error)?.message || "读取收藏应用失败";
-  } finally {
-    if (isCurrentFavoriteRequest(generation)) favoriteLoading.value = false;
-  }
-};
-
-const createFavoriteFolderFromPrompt = async () => {
-  const name = window.prompt("请输入收藏夹名称");
-  const folderName = name?.trim();
-  if (!folderName) return;
-  const generation = favoriteRequestGeneration.value;
-  favoriteLoading.value = true;
-  favoriteError.value = "";
-  try {
-    const folder = await createFavoriteFolder(folderName);
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteFolders.value = [
-      ...favoriteFolders.value.filter((item) => item.id !== folder.id),
-      folder,
-    ];
-    favoriteItemsByFolder.value = {
-      ...favoriteItemsByFolder.value,
-      [folder.id]: favoriteItemsByFolder.value[folder.id] ?? [],
-    };
-    favoriteItems.value = [];
-    activeFavoriteFolderId.value = folder.id;
-  } catch (error: unknown) {
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteError.value = (error as Error)?.message || "创建收藏夹失败";
-  } finally {
-    if (isCurrentFavoriteRequest(generation)) favoriteLoading.value = false;
-  }
-};
-
-const removeSelectedFavorites = async (ids: number[]) => {
-  if (!activeFavoriteFolderId.value || ids.length === 0) return;
-  const generation = favoriteRequestGeneration.value;
-  favoriteLoading.value = true;
-  favoriteError.value = "";
-  try {
-    await bulkDeleteFavoriteItems(activeFavoriteFolderId.value, ids);
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteItemsByFolder.value = {
-      ...favoriteItemsByFolder.value,
-      [activeFavoriteFolderId.value]: (
-        favoriteItemsByFolder.value[activeFavoriteFolderId.value] ?? []
-      ).filter((favorite) => !ids.includes(favorite.id)),
-    };
-    await refreshFavorites();
-  } catch (error: unknown) {
-    if (!isCurrentFavoriteRequest(generation)) return;
-    favoriteError.value = (error as Error)?.message || "移除收藏失败";
-  } finally {
-    if (isCurrentFavoriteRequest(generation)) favoriteLoading.value = false;
-  }
-};
-
-const installResolvedFavorites = async (items: ResolvedFavoriteItem[]) => {
-  for (const item of items) {
-    if (item.selectedApp) {
-      await onDetailInstall(item.selectedApp);
-    }
-  }
-};
-
-// TODO: 目前 APM 商店不能暂停下载
-const pauseDownload = (id: DownloadItem) => {
-  const download = downloads.value.find((d) => d.id === id.id);
-  if (download && download.status === "installing") {
-    // 'installing' matches type definition, previously 'downloading'
-    download.status = "paused";
-    download.logs.push({
-      time: Date.now(),
-      message: "下载已暂停",
-    });
-  }
-};
-
-// TODO: 同理，暂未实现
-const resumeDownload = (id: DownloadItem) => {
-  const download = downloads.value.find((d) => d.id === id.id);
-  if (download && download.status === "paused") {
-    download.status = "installing"; // previously 'downloading'
-    download.logs.push({
-      time: Date.now(),
-      message: "继续下载...",
-    });
-    // simulateDownload(download); // removed or undefined?
-  }
-};
-
-const cancelDownload = (id: DownloadItem) => {
-  const index = downloads.value.findIndex((d) => d.id === id.id);
-  if (index !== -1) {
-    const download = downloads.value[index];
-    // 发送到主进程取消
-    window.ipcRenderer.send("cancel-install", download.id);
-
-    download.status = "failed";
-    download.logs.push({
-      time: Date.now(),
-      message: "下载已取消",
-    });
-    // 保留在队列中以便用户可以重试或查看日志
-  }
-};
-
-const retryDownload = (id: DownloadItem) => {
-  const download = downloads.value.find((d) => d.id === id.id);
-  if (download && download.status === "failed") {
-    download.status = "queued";
-    download.progress = 0;
-    download.downloadedSize = 0;
-    download.logs.push({
-      time: Date.now(),
-      message: "重新开始下载...",
-    });
-    handleRetry(download);
-  }
-};
-
-const clearCompletedDownloads = () => {
-  downloads.value = downloads.value.filter((d) => d.status !== "completed");
-};
-
-const showDownloadDetailModalFunc = (download: DownloadItem) => {
-  currentDownload.value = download;
-  showDownloadDetailModal.value = true;
-};
-
-const closeDownloadDetail = () => {
-  showDownloadDetailModal.value = false;
-  currentDownload.value = null;
-};
-
-const openDownloadedApp = (pkgname: string, origin?: "spark" | "apm") => {
-  // const encodedPkg = encodeURIComponent(download.pkgname);
-  // openApmStoreUrl(`apmstore://launch?pkg=${encodedPkg}`, {
-  //   fallbackText: `打开应用: ${download.pkgname}`
-  // });
-  window.ipcRenderer
-    .invoke("launch-app", { pkgname, origin })
-    .catch((err) => logger.error("启动应用失败 (launch-app):", err));
-};
-
-const loadCategories = async () => {
-  try {
-    const arch = window.apm_store.arch || "amd64";
-    const modes: Array<"spark" | "apm"> =
-      storeFilter.value === "both" ? ["spark", "apm"] : [storeFilter.value];
-
-    const categoryData: Record<string, { zh: string; origins: string[] }> = {};
-
-    for (const mode of modes) {
-      const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
-      const path = `/${finalArch}/categories.json`;
-
-      try {
-        const response = await axiosInstance.get(path);
-        const data = response.data;
-        Object.keys(data).forEach((key) => {
-          if (categoryData[key]) {
-            if (!categoryData[key].origins.includes(mode)) {
-              categoryData[key].origins.push(mode);
-            }
-          } else {
-            categoryData[key] = {
-              zh: data[key].zh || data[key],
-              origins: [mode],
-            };
-          }
-        });
-      } catch (e) {
-        logger.error(`读取 ${mode} categories.json 失败: ${e}`);
-      }
-    }
-    categories.value = categoryData;
-
-    // 加载优先级配置（从 spark 目录）
-    await loadPriorityConfig(arch);
-  } catch (error) {
-    logger.error(`读取 categories 失败: ${error}`);
-  }
-};
-
-const loadSidebarConfig = async () => {
-  try {
-    const arch = window.apm_store.arch || "amd64";
-    const modes: Array<"spark" | "apm"> =
-      storeFilter.value === "both" ? ["spark", "apm"] : [storeFilter.value];
-
-    const entryMap = new Map<string, SidebarEntry>();
-
-    for (const mode of modes) {
-      const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
-      const path = `/${finalArch}/sidebar-config.json`;
-
-      try {
-        const response = await axiosInstance.get(path);
-        const data = response.data;
-        const entries = Array.isArray(data) ? data : data.entries || [];
-
-        for (const entry of entries) {
-          if (entry.id && entry.name) {
-            const existing = entryMap.get(entry.id);
-            if (existing) {
-              // 多仓库共有入口，合并来源
-              if (existing.origins && !existing.origins.includes(mode)) {
-                existing.origins.push(mode);
-              }
-            } else {
-              entryMap.set(entry.id, {
-                id: entry.id,
-                name: entry.name,
-                icon: entry.icon || "",
-                type: entry.type || "category",
-                value: entry.value || entry.id,
-                origins: [mode],
-              });
-            }
-          }
-        }
-      } catch (e) {
-        logger.warn(`读取 ${mode} sidebar-config.json 失败: ${e}`);
-      }
-    }
-
-    sidebarEntries.value = Array.from(entryMap.values());
-    if (sidebarEntries.value.length > 0) {
-      logger.info(`已加载 ${sidebarEntries.value.length} 个侧边栏配置入口`);
-    }
-  } catch (error) {
-    logger.warn(`读取 sidebar-config 失败: ${error}`);
-  }
-};
-
-const normalizeAppJson = (
-  appJson: AppJson,
-  category: string,
-  origin: "spark" | "apm",
-): App => ({
-  name: appJson.Name,
-  pkgname: appJson.Pkgname,
-  version: appJson.Version,
-  filename: appJson.Filename,
-  torrent_address: appJson.Torrent_address,
-  author: appJson.Author,
-  contributor: appJson.Contributor,
-  website: appJson.Website,
-  update: appJson.Update,
-  size: appJson.Size,
-  more: appJson.More,
-  tags: appJson.Tags,
-  img_urls: (() => {
-    if (typeof appJson.img_urls === "string") {
-      try {
-        return JSON.parse(appJson.img_urls) as string[];
-      } catch {
-        return [];
-      }
-    }
-    return (appJson.img_urls as string[]) || [];
-  })(),
-  icons: appJson.icons,
-  category: category,
-  origin: origin,
-  currentStatus: "not-installed" as const,
-});
-
-const loadTabCategories = async () => {
-  const arch = window.apm_store.arch || "amd64";
-  const modes: Array<"spark" | "apm"> =
-    storeFilter.value === "both" ? ["spark", "apm"] : [storeFilter.value];
-  const newTabCategories: Record<string, Record<string, CategoryInfo>> = {};
-
-  // 并行加载所有侧边栏入口的子分类，减少串行等待
-  const categoryEntries = sidebarEntries.value.filter(
-    (e) => e.type === "category",
-  );
-
-  await Promise.all(
-    categoryEntries.map(async (entry) => {
-      const folderName = entry.value || entry.id;
-      const catData: Record<string, { zh: string; origins: string[] }> = {};
-      // 只查询该入口实际存在的来源仓库，避免对不存在目录的 404 重试
-      const entryModes = entry.origins?.length
-        ? entry.origins.filter((o) => modes.includes(o))
-        : modes;
-
-      await Promise.all(
-        entryModes.map(async (mode) => {
-          const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
-          const path = `/${finalArch}/${folderName}/categories.json`;
-
-          try {
-            const response = await axiosInstance.get(path);
-            const data = response.data;
-            Object.keys(data).forEach((key) => {
-              if (catData[key]) {
-                if (!catData[key].origins.includes(mode)) {
-                  catData[key].origins.push(mode);
-                }
-              } else {
-                catData[key] = {
-                  zh: data[key].zh || data[key],
-                  origins: [mode],
-                };
-              }
-            });
-          } catch {
-            // 该入口没有子分类，静默忽略
-          }
-        }),
-      );
-
-      if (Object.keys(catData).length > 0) {
-        newTabCategories[entry.id] = catData;
-        logger.info(
-          `入口 "${entry.id}" 加载到 ${Object.keys(catData).length} 个子分类`,
-        );
-      }
-    }),
-  );
-
-  tabCategories.value = newTabCategories;
-};
-
-const loadTabApps = async (entryId: string) => {
-  if (tabApps.value[entryId]) return;
-  // 防止重复加载：如果正在加载中则跳过
-  if (loadingTabs.value.has(entryId)) return;
-
-  const entry = sidebarEntries.value.find((e) => e.id === entryId);
-  if (!entry || entry.type !== "category") return;
-
-  // 标记为加载中
-  loadingTabs.value = new Set(loadingTabs.value).add(entryId);
-
-  const arch = window.apm_store.arch || "amd64";
-  const allModes: Array<"spark" | "apm"> =
-    storeFilter.value === "both" ? ["spark", "apm"] : [storeFilter.value];
-  // 只查询该入口实际存在的来源仓库，避免对不存在目录的 404 重试
-  const modes = entry.origins?.length
-    ? entry.origins.filter((o) => allModes.includes(o))
-    : allModes;
-  const folderName = entry.value || entry.id;
-  const subCats = tabCategories.value[entryId];
-
-  // 收集所有需要发起的请求任务（mode × 子分类），然后全并发加载
-  const tasks: Promise<App[]>[] = [];
-
-  for (const mode of modes) {
-    const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
-
-    if (subCats && Object.keys(subCats).length > 0) {
-      for (const [subCat, catInfo] of Object.entries(subCats)) {
-        if (
-          catInfo.origins &&
-          catInfo.origins.length > 0 &&
-          !catInfo.origins.includes(mode)
-        )
-          continue;
-
-        const path = `/${finalArch}/${folderName}/${subCat}/applist.json`;
-        logger.info(`加载入口子分类: ${entryId}/${subCat} (来源: ${mode})`);
-        tasks.push(
-          fetchWithRetry<AppJson[]>(path, rootAbortController.signal)
-            .then((categoryApps) =>
-              (categoryApps || []).map((aj) =>
-                normalizeAppJson(aj, subCat, mode),
-              ),
-            )
-            .catch((e: unknown) => {
-              logger.warn(
-                `加载入口子分类 ${entryId}/${subCat} (${mode}) 失败: ${e}`,
-              );
-              return [] as App[];
-            }),
-        );
-      }
-    } else {
-      const path = `/${finalArch}/${folderName}/applist.json`;
-      logger.info(`加载入口目录: ${entryId} (来源: ${mode})`);
-      tasks.push(
-        fetchWithRetry<AppJson[]>(path, rootAbortController.signal)
-          .then((categoryApps) =>
-            (categoryApps || []).map((aj) =>
-              normalizeAppJson(aj, folderName, mode),
-            ),
-          )
-          .catch((e: unknown) => {
-            logger.warn(`加载入口目录 ${entryId} (${mode}) 失败: ${e}`);
-            return [] as App[];
-          }),
-      );
-    }
-  }
-
-  const results = await Promise.all(tasks);
-  const loadedApps = results.flat();
-
-  tabApps.value = { ...tabApps.value, [entryId]: loadedApps };
-
-  // 移除加载标记
-  const next = new Set(loadingTabs.value);
-  next.delete(entryId);
-  loadingTabs.value = next;
-
-  logger.info(`入口 "${entryId}" 加载完成，共 ${loadedApps.length} 个应用`);
-};
-
-const loadApps = async (onFirstBatch?: () => void) => {
-  try {
-    logger.info("开始加载应用数据（全并发带重试）...");
-
-    const categoriesList = Object.keys(categories.value || {});
-    let firstBatchCallDone = false;
-    const arch = window.apm_store.arch || "amd64";
-
-    // 并发加载所有分类，每个分类自带重试机制
-    await Promise.all(
-      categoriesList.map(async (category) => {
-        const catInfo = categories.value[category];
-        if (!catInfo) return;
-        const origins = (catInfo.origins ||
-          (catInfo.origin ? [catInfo.origin] : [])) as string[];
-
-        await Promise.all(
-          origins.map(async (mode) => {
-            try {
-              const finalArch =
-                mode === "spark" ? `${arch}-store` : `${arch}-apm`;
-
-              const path = `/${finalArch}/${category}/applist.json`;
-
-              logger.info(`加载分类: ${category} (来源: ${mode})`);
-              const categoryApps = await fetchWithRetry<AppJson[]>(
-                path,
-                rootAbortController.signal,
-              );
-
-              const normalizedApps = (categoryApps || []).map((appJson) =>
-                normalizeAppJson(appJson, category, mode as "spark" | "apm"),
-              );
-
-              // 增量式更新，让用户尽快看到部分数据
-              // 用赋值替代 push(...)，避免对响应式数组逐元素触发 re-render
-              apps.value = [...apps.value, ...normalizedApps];
-
-              // 只要有一个分类加载成功，就可以考虑关闭整体 loading（如果是首批逻辑）
-              if (!firstBatchCallDone && typeof onFirstBatch === "function") {
-                firstBatchCallDone = true;
-                onFirstBatch();
-                // 标记初始目录加载完成，使 apps.length watcher 开始在目录变更时刷新已安装列表
-                initialCatalogLoaded.value = true;
-              }
-            } catch (error) {
-              logger.warn(
-                `加载分类 ${category} 来源 ${mode} 最终失败: ${error}`,
-              );
-            }
-          }),
-        );
-      }),
-    );
-
-    // 确保即使全部失败也结束 loading
-    if (!firstBatchCallDone && typeof onFirstBatch === "function") {
-      onFirstBatch();
-    }
-  } catch (error) {
-    logger.error(`加载应用数据流程异常: ${error}`);
-  }
-};
-
-const handleSearchInput = (value: string) => {
-  currentView.value = "default";
-  searchQuery.value = value;
-};
-
-const handleSpkLink = (pkgname: string) => {
-  currentView.value = "default";
-  activeTab.value = "all";
-  // 尝试从已加载的应用中查找
-  const target = apps.value.find((a) => a.pkgname === pkgname);
-  if (target) {
-    openDetail({ ...target, _fromDeepLink: true });
-  } else {
-    // 找不到时回退到搜索
-    searchQuery.value = pkgname;
-  }
-};
-
-const handleSearchFocus = () => {
-  currentView.value = "default";
-  if (activeTab.value === "home") activeTab.value = "all";
-};
-
+// ===== 窗口尺寸变化 / 键盘 / Deep Link / IPC 生命周期 =====
 // 窗口尺寸变化（含无边框窗口鼠标拉边角）时，防抖通知主进程保存当前尺寸
 let saveBoundsTimer: number | undefined;
 const handleWindowResize = () => {
@@ -3404,16 +1040,18 @@ const handleDeepLinkSearch = (
 
 const handleRemoveComplete = (
   _event: IpcRendererEvent,
-  payload: ChannelPayload,
+  payload: import("./global/typedefinition").ChannelPayload,
 ) => {
   const pkgname = currentApp.value?.pkgname;
   if (payload.success && pkgname) {
-    removeDownloadItem(pkgname);
+    // 由 useDownloads 内部维护 pendingDownloadRecords；此处仅关闭详情态
   }
 };
 
-// 生命周期钩子
 onMounted(async () => {
+  // 应用启动即锁定标签优先显示策略的真实持久化值，避免依赖详情页挂载顺序
+  // 导致先读到内存默认值 "auto" 再懒加载的竞态窗口。
+  initTagPriorityStrategy();
   initTheme();
   updateCenterStore.bind();
 
@@ -3491,7 +1129,7 @@ onMounted(async () => {
 
   window.ipcRenderer.on(
     "install-complete",
-    handleInstallCompleteForDownloadRecord,
+    handleInstallCompleteForDownloadRecordRef,
   );
   window.ipcRenderer.on("remove-complete", handleRemoveComplete);
 
@@ -3503,8 +1141,6 @@ onMounted(async () => {
 });
 
 onUnmounted(() => {
-  rootAbortController.abort();
-  updateCenterStore.unbind();
   // 清理窗口尺寸防抖定时器，防止组件销毁后仍触发 IPC 保存调用
   if (saveBoundsTimer) clearTimeout(saveBoundsTimer);
   // 停止仍挂起的"等待 loading 完成后执行一次"的 watcher，避免泄漏
@@ -3524,12 +1160,49 @@ onUnmounted(() => {
   window.ipcRenderer.off("deep-link-search", handleDeepLinkSearch);
   window.ipcRenderer.off(
     "install-complete",
-    handleInstallCompleteForDownloadRecord,
+    handleInstallCompleteForDownloadRecordRef,
   );
   window.ipcRenderer.off("remove-complete", handleRemoveComplete);
 });
 
-// 观察器
+// install-complete 回调由 useDownloads 持有；此处通过 ref 引用注入实例
+import { handleInstallCompleteForDownloadRecord } from "./composables/useDownloads";
+const handleInstallCompleteForDownloadRecordRef =
+  handleInstallCompleteForDownloadRecord;
+
+// 应用目录（apps.value）可能在打开"已安装应用"模态框之后才加载完成。
+// 当目录长度变化、且模态框处于打开状态时，自动重查已安装应用，避免列表一直为空。
+// 注意：上一版仅在 prevLen===0→len>0 触发，会遗漏目录后续更新（例如分类切换触发目录重建）。
+// 现改为 len 任意 >0 的正向变化都允许触发；密集分批推送由下方 300ms 防抖合并最后一次写入。
+// 每次变化都先自增 installedRefreshGeneration：即使上一轮刷新仍在加载中，也会立即失效，
+// 避免用陈旧目录数据覆盖已安装列表（清理不单纯依赖定时器，代次校验兜底）。
+// initialCatalogLoaded：初始目录分批加载期间（apps.length 频繁变化）跳过此 watcher，
+// 避免对未打开的模态框做无意义的已安装列表刷新 IPC。
+let refreshDebounceTimer: ReturnType<typeof setTimeout> | null = null;
+watch(
+  () => apps.value.length,
+  (len) => {
+    if (!initialCatalogLoaded.value) return;
+    if (!showInstalledModal.value || len <= 0) {
+      return;
+    }
+    installedRefreshGeneration.value++;
+    if (refreshDebounceTimer !== null) {
+      clearTimeout(refreshDebounceTimer);
+    }
+    refreshDebounceTimer = setTimeout(() => {
+      refreshDebounceTimer = null;
+      void refreshInstalledApps();
+    }, 300);
+  },
+);
+onUnmounted(() => {
+  if (refreshDebounceTimer !== null) {
+    clearTimeout(refreshDebounceTimer);
+  }
+});
+
+// 观察者
 watch(
   () => currentUser.value?.id ?? null,
   (userId, previousUserId) => {
diff --git a/src/components/AppDetailModal.vue b/src/components/AppDetailModal.vue
index 5a011c21..d6743456 100644
--- a/src/components/AppDetailModal.vue
+++ b/src/components/AppDetailModal.vue
@@ -578,7 +578,6 @@ import {
 } from "../global/storeConfig";
 import {
   tagPriorityStrategyRef,
-  initTagPriorityStrategy,
   type TagPriorityStrategy,
 } from "../global/tagPriority";
 // 评论功能暂时关闭
@@ -690,7 +689,7 @@ const computeDefaultViewingOrigin = (
 //   - 策略变化（在设置页实时切换）→ 已打开且未手动切标签的详情页立即更新默认标签
 // 手动点标签页（selectOrigin）只是临时预览：置 manualOverride 标记，本次会话内保持，
 //   既不被策略变化强行拉回，也不跨重开持久（重开后会按设置重算）。
-initTagPriorityStrategy();
+// 注：initTagPriorityStrategy() 已在 App.vue 启动时统一调用，此处不再重复。
 const manualOverride = ref(false); // 用户是否手动切换过标签（本次会话）
 let lastPkgname: string | null = null; // 上一次计算对应的应用 pkgname，用于识别"新打开/重开"
 watch(
diff --git a/src/components/InstalledAppsModal.vue b/src/components/InstalledAppsModal.vue
index 93e62559..ae49e1c5 100644
--- a/src/components/InstalledAppsModal.vue
+++ b/src/components/InstalledAppsModal.vue
@@ -424,13 +424,19 @@ const getIconUrl = (app: App) => {
   return `${APM_STORE_BASE_URL}/${finalArch}/${app.category}/${app.pkgname}/icon.png`;
 };
 
-const canOpenDetail = (app: App) => {
+// 判断应用是否可打开详情页。满足以下任一条件即可展示"查看详情"：
+//   - 有明确分类（非 unknown）：详情页可按分类加载元数据
+//   - 有详细描述(more) / 官网(website) / 作者(author) 任一字段：详情有内容可展示
+//   - 有截图(img_urls)：详情页可渲染预览图
+// 这些字段缺失时详情页信息过空，故隐藏入口仅保留打开/卸载。
+const canOpenDetail = (app: App): boolean => {
+  const hasCategory = app.category !== "unknown";
+  const hasDescription = Boolean(app.more);
+  const hasWebsite = Boolean(app.website);
+  const hasAuthor = Boolean(app.author);
+  const hasScreenshots = (app.img_urls?.length ?? 0) > 0;
   return (
-    app.category !== "unknown" ||
-    Boolean(app.more) ||
-    Boolean(app.website) ||
-    Boolean(app.author) ||
-    (app.img_urls?.length ?? 0) > 0
+    hasCategory || hasDescription || hasWebsite || hasAuthor || hasScreenshots
   );
 };
 
@@ -461,12 +467,19 @@ const searchFilteredApps = computed(() => {
   );
 });
 
-const apmCount = computed(
-  () => searchFilteredApps.value.filter((a) => hasOrigin(a, "apm")).length,
-);
-const sparkCount = computed(
-  () => searchFilteredApps.value.filter((a) => hasOrigin(a, "spark")).length,
-);
+// 对搜索过滤后的列表做单次遍历，同时统计 APM / Spark 各自安装数。
+// 同一 pkgname 同时装两种来源时各计一次（双来源计数），避免对 props.apps 多次 filter 遍历。
+const appStats = computed(() => {
+  let apm = 0;
+  let spark = 0;
+  for (const a of searchFilteredApps.value) {
+    if (hasOrigin(a, "apm")) apm++;
+    if (hasOrigin(a, "spark")) spark++;
+  }
+  return { apm, spark };
+});
+const apmCount = computed(() => appStats.value.apm);
+const sparkCount = computed(() => appStats.value.spark);
 // 总数 = APM 包数 + Spark 包数（不同来源视为不同包，单独计数）
 const totalCount = computed(() => apmCount.value + sparkCount.value);
 
@@ -476,26 +489,23 @@ const filterOrigin = ref<"all" | "apm" | "spark">("all");
 // 搜索关键词（按名称/包名不区分大小写过滤已安装应用）
 const searchQuery = ref("");
 const filteredApps = computed(() => {
-  // 1. 先按搜索关键词过滤
+  // 单次遍历完成「搜索过滤 + 来源筛选」，避免多次 .filter() 创建中间数组。
+  // 来源判定统一用 hasOrigin（兼顾双来源 origins 数组，不能退化为 a.origin）。
   const q = searchQuery.value.trim().toLowerCase();
-  let list = props.apps;
-  if (q) {
-    list = list.filter(
-      (a) =>
-        a.name.toLowerCase().includes(q) || a.pkgname.toLowerCase().includes(q),
-    );
-  }
+  const originFilter = filterOrigin.value;
+  const matched = props.apps.filter((a) => {
+    if (originFilter === "apm" && !hasOrigin(a, "apm")) return false;
+    if (originFilter === "spark" && !hasOrigin(a, "spark")) return false;
+    if (q) {
+      const nameLower = a.name.toLowerCase();
+      const pkgLower = a.pkgname.toLowerCase();
+      if (!nameLower.includes(q) && !pkgLower.includes(q)) return false;
+    }
+    return true;
+  });
 
-  // 2. 再按来源筛选（默认 all = 不过滤）
-  if (filterOrigin.value === "apm") {
-    list = list.filter((a) => hasOrigin(a, "apm"));
-  } else if (filterOrigin.value === "spark") {
-    list = list.filter((a) => hasOrigin(a, "spark"));
-  }
-
-  // 3. 排序：APM 应用始终排在前面（默认全部视图也遵守此规则）
-  // 返回新数组，避免修改原始 props.apps
-  return [...list].sort((a, b) => {
+  // 返回新数组排序：APM 应用始终排在前面（默认全部视图也遵守此规则）
+  return [...matched].sort((a, b) => {
     const aApm = hasOrigin(a, "apm") ? 0 : 1;
     const bApm = hasOrigin(b, "apm") ? 0 : 1;
     if (aApm !== bApm) return aApm - bApm;
diff --git a/src/composables/useAccountSync.ts b/src/composables/useAccountSync.ts
new file mode 100644
index 00000000..99bf97c8
--- /dev/null
+++ b/src/composables/useAccountSync.ts
@@ -0,0 +1,424 @@
+/**
+ * useAccountSync —— 登录、下载历史、云端同步/恢复、账号态联动、登出。
+ *
+ * 从原 App.vue 原样搬移（requireLogin / openLoginFromPrompt / handleFlarumLogin /
+ * loadDownloadedHistory / refreshInstalledSyncCandidates / syncInstalledAppsToAccount /
+ * syncInstalledAppsNow / openRestoreFromAccount / installCloudItems /
+ * maybePromptInstalledSync / openUserManagement / handleLogout / openReviewUserProfile /
+ * 各代次守卫 / clear*State），逻辑零改动。
+ *
+ * 共享状态来自 useAppState；currentUser / isLoggedIn 来自 authState；
+ * clearFavoriteState 来自 useFavorites；onDetailInstall 来自 useDownloads。
+ */
+import type {
+  FlarumLoginPayload,
+  SyncedAppListItem,
+  AppReview,
+  App,
+} from "../global/typedefinition";
+import {
+  downloadedApps,
+  downloadedLoading,
+  downloadedError,
+  downloadedRequestGeneration,
+  syncLoading,
+  syncStatusMessage,
+  syncRequestGeneration,
+  syncCandidateApps,
+  restoreLoading,
+  restoreError,
+  showRestoreModal,
+  restoreItems,
+  restoreRequestGeneration,
+  installedSyncPromptShown,
+  systemInfo,
+  showUserManagementModal,
+  isSidebarOpen,
+  showLoginPrompt,
+  showLoginModal,
+  currentView,
+  activeTab,
+  selectedCategory,
+  selectedReviewUserProfile,
+  showReviewUserProfileModal,
+  sparkAvailable,
+  apmAvailable,
+  storeFilter,
+  apps,
+  showLoginPromptMessage,
+  loginLoading,
+  loginError,
+} from "./useAppState";
+import { isLoggedIn, currentUser } from "../global/authState";
+import {
+  setInstalledSyncEnabled,
+  loadInstalledSyncPreference,
+  installedSyncEnabled,
+} from "../global/accountSyncState";
+import {
+  exchangeFlarumToken,
+  listDownloadedApps,
+  uploadSyncedAppList,
+  fetchSyncedAppList,
+} from "../modules/backendApi";
+import { requestFlarumToken } from "../modules/flarumAuth";
+import {
+  buildSyncItems,
+  mergeInstalledApps,
+  resolveCloudInstallCandidate,
+} from "../modules/appListSync";
+import { isOriginEnabled } from "../modules/storeFilter";
+import { clearFavoriteState } from "./useFavorites";
+import { onDetailInstall } from "./useDownloads";
+import { registerRequireLogin } from "./useAppDetail";
+import { registerRequireLogin as registerRequireLoginFav } from "./useFavorites";
+
+// requireLogin 供 useAppDetail / useFavorites / 本模块内部使用；登记到其它 composable
+export const requireLogin = (message: string): boolean => {
+  if (isLoggedIn.value) return true;
+  showLoginPromptMessage.value = message;
+  showLoginPrompt.value = true;
+  return false;
+};
+registerRequireLogin(requireLogin);
+registerRequireLoginFav(requireLogin);
+
+const openLoginFromPrompt = () => {
+  showLoginPrompt.value = false;
+  showLoginModal.value = true;
+};
+
+const clearDownloadedState = () => {
+  downloadedRequestGeneration.value += 1;
+  downloadedApps.value = [];
+  downloadedLoading.value = false;
+  downloadedError.value = "";
+};
+
+const clearRestoreState = () => {
+  restoreRequestGeneration.value += 1;
+  restoreItems.value = [];
+  restoreLoading.value = false;
+  restoreError.value = "";
+  showRestoreModal.value = false;
+};
+
+const clearInstalledSyncState = () => {
+  syncRequestGeneration.value += 1;
+  syncLoading.value = false;
+  syncStatusMessage.value = "";
+  syncCandidateApps.value = [];
+};
+
+const nextDownloadedRequestGeneration = (): number => {
+  downloadedRequestGeneration.value += 1;
+  return downloadedRequestGeneration.value;
+};
+
+const isCurrentDownloadedRequest = (
+  generation: number,
+  userId: number,
+): boolean =>
+  downloadedRequestGeneration.value === generation &&
+  currentUser.value?.id === userId;
+
+const isCurrentRestoreRequest = (generation: number, userId: number): boolean =>
+  restoreRequestGeneration.value === generation &&
+  currentUser.value?.id === userId;
+
+const handleLogout = () => {
+  // 调用 authState 的 logout（此处通过注入，保持 authState 为唯一会话源）
+  logoutRef();
+  pendingDownloadRecordsClear();
+  clearFavoriteState();
+  clearDownloadedState();
+  clearRestoreState();
+  clearInstalledSyncState();
+  loadInstalledSyncPreference(null);
+  showLoginModal.value = false;
+  showLoginPrompt.value = false;
+  isSidebarOpen.value = false;
+  showUserManagementModal.value = false;
+  if (currentView.value === "favorites") {
+    currentView.value = "default";
+    activeTab.value = "home";
+    selectedCategory.value = "all";
+  }
+};
+
+const handleFlarumLogin = async (payload: FlarumLoginPayload) => {
+  loginLoading.value = true;
+  loginError.value = "";
+
+  try {
+    const flarumToken = await requestFlarumToken(payload);
+    const session = await exchangeFlarumToken({
+      flarumUserId: flarumToken.userId,
+      flarumToken: flarumToken.token,
+    });
+    setAuthSessionRef(session);
+    clearInstalledSyncState();
+    loadInstalledSyncPreference(session.user.id);
+    showLoginModal.value = false;
+  } catch (error: unknown) {
+    loginError.value = (error as Error)?.message || "登录失败，请稍后重试";
+  } finally {
+    loginLoading.value = false;
+  }
+};
+
+const loadDownloadedHistory = async (): Promise<void> => {
+  if (!requireLogin("请登录后查看和管理账号信息。")) return;
+  const userId = currentUser.value?.id;
+  if (userId === undefined) return;
+  const generation = nextDownloadedRequestGeneration();
+
+  downloadedLoading.value = true;
+  downloadedError.value = "";
+  try {
+    const result = await listDownloadedApps(1, 50);
+    if (!isCurrentDownloadedRequest(generation, userId)) return;
+    downloadedApps.value = result.items;
+  } catch (error: unknown) {
+    if (!isCurrentDownloadedRequest(generation, userId)) return;
+    downloadedApps.value = [];
+    downloadedError.value = (error as Error)?.message || "读取下载历史失败";
+  } finally {
+    if (isCurrentDownloadedRequest(generation, userId)) {
+      downloadedLoading.value = false;
+    }
+  }
+};
+
+const refreshInstalledSyncCandidates = async (
+  isCurrentRequest: () => boolean,
+): Promise<boolean> => {
+  const origins: Array<"spark" | "apm"> = [];
+  if (isOriginEnabled(storeFilter.value, "spark") && sparkAvailable.value) {
+    origins.push("spark");
+  }
+  if (isOriginEnabled(storeFilter.value, "apm") && apmAvailable.value) {
+    origins.push("apm");
+  }
+
+  const refreshedApps: App[] = [];
+  await Promise.all(
+    origins.map(async (origin) => {
+      const pkgnameList =
+        origin === "spark"
+          ? apps.value
+              .filter((app) => app.origin === "spark")
+              .map((app) => app.pkgname)
+          : undefined;
+      const result = await window.ipcRenderer.invoke("list-installed", {
+        origin,
+        pkgnameList,
+      });
+      if (!result?.success) return;
+
+      const appList = Array.isArray(result?.apps) ? result.apps : [];
+      for (const rawApp of appList) {
+        // 运行时类型守卫：避免后端字段缺失时下游访问 undefined
+        if (!isInstalledAppInfoRef(rawApp)) continue;
+        const appInfo = mapInstalledAppToCatalogAppRef(rawApp, origin);
+        if (appInfo) refreshedApps.push(appInfo);
+      }
+    }),
+  );
+
+  if (!isCurrentRequest()) {
+    return false;
+  }
+
+  syncCandidateApps.value = mergeInstalledApps(
+    syncCandidateApps.value,
+    refreshedApps,
+    origins,
+  );
+  return true;
+};
+
+const syncInstalledAppsToAccount = async (): Promise<void> => {
+  if (!requireLogin("云端同步需要登录星火账号。")) return;
+  if (syncLoading.value) return;
+  const userId = currentUser.value?.id;
+  if (userId === undefined) return;
+  const generation = syncRequestGeneration.value + 1;
+  syncRequestGeneration.value = generation;
+  syncLoading.value = true;
+  syncStatusMessage.value = "";
+  try {
+    const refreshed = await refreshInstalledSyncCandidates(
+      () =>
+        syncRequestGeneration.value === generation &&
+        currentUser.value?.id === userId,
+    );
+    if (!refreshed) return;
+    const items = buildSyncItems(syncCandidateApps.value);
+    await uploadSyncedAppList({
+      clientArch: window.apm_store.arch || "amd64",
+      distro: systemInfo.value.distro,
+      items,
+    });
+    if (
+      syncRequestGeneration.value !== generation ||
+      currentUser.value?.id !== userId
+    ) {
+      return;
+    }
+    downloadedError.value = "";
+    syncStatusMessage.value = "同步完成";
+  } catch (error: unknown) {
+    if (
+      syncRequestGeneration.value !== generation ||
+      currentUser.value?.id !== userId
+    ) {
+      return;
+    }
+    downloadedError.value = (error as Error)?.message || "同步已安装应用失败";
+    syncStatusMessage.value = downloadedError.value;
+  } finally {
+    if (
+      syncRequestGeneration.value === generation &&
+      currentUser.value?.id === userId
+    ) {
+      syncLoading.value = false;
+    }
+  }
+};
+
+const syncInstalledAppsNow = (): void => {
+  void syncInstalledAppsToAccount();
+};
+
+const openRestoreFromAccount = async (): Promise<void> => {
+  if (!requireLogin("云端同步需要登录星火账号。")) return;
+  const userId = currentUser.value?.id;
+  if (userId === undefined) return;
+  const generation = restoreRequestGeneration.value + 1;
+  restoreRequestGeneration.value = generation;
+  showRestoreModal.value = true;
+  restoreLoading.value = true;
+  restoreError.value = "";
+  restoreItems.value = [];
+  try {
+    const refreshed = await refreshInstalledSyncCandidates(() =>
+      isCurrentRestoreRequest(generation, userId),
+    );
+    if (!refreshed) return;
+    const result = await fetchSyncedAppList();
+    if (!isCurrentRestoreRequest(generation, userId)) return;
+    restoreItems.value = result?.items || [];
+  } catch (error: unknown) {
+    if (!isCurrentRestoreRequest(generation, userId)) return;
+    restoreError.value = (error as Error)?.message || "读取云端应用列表失败";
+  } finally {
+    if (isCurrentRestoreRequest(generation, userId)) {
+      restoreLoading.value = false;
+    }
+  }
+};
+
+const installCloudItems = (items: SyncedAppListItem[]): void => {
+  for (const item of items) {
+    const app = resolveCloudInstallCandidate(item, apps.value);
+    if (!app) continue;
+    void onDetailInstall(app);
+  }
+  showRestoreModal.value = false;
+};
+
+const maybePromptInstalledSync = async (): Promise<void> => {
+  if (
+    import.meta.env.MODE === "test" ||
+    !isLoggedIn.value ||
+    installedSyncPromptShown.value ||
+    installedSyncEnabled.value !== null
+  ) {
+    if (isLoggedIn.value && installedSyncEnabled.value === true) {
+      await syncInstalledAppsToAccount();
+    }
+    return;
+  }
+
+  installedSyncPromptShown.value = true;
+  const enabled = window.confirm(
+    "是否启用已安装应用列表自动同步到星火账号？仅同步商店识别的非依赖应用。",
+  );
+  setInstalledSyncEnabled(enabled);
+  if (enabled) await syncInstalledAppsToAccount();
+};
+
+const openUserManagement = async () => {
+  if (!requireLogin("请登录后查看和管理账号信息。")) return;
+  showUserManagementModal.value = true;
+  isSidebarOpen.value = false;
+  showLoginPrompt.value = false;
+  await loadDownloadedHistory();
+};
+
+const openReviewUserProfile = (review: AppReview): void => {
+  const current = currentUser.value;
+  const isCurrentUser =
+    review.isAuthor === true ||
+    (review.userId !== undefined &&
+      current?.id !== undefined &&
+      review.userId === current.id);
+
+  selectedReviewUserProfile.value = {
+    displayName: review.userDisplayName || "星火用户",
+    username: isCurrentUser ? current?.username : undefined,
+    avatarUrl:
+      review.userAvatarUrl || (isCurrentUser ? current?.avatarUrl : undefined),
+    coverUrl: isCurrentUser ? current?.coverUrl : undefined,
+    forumGroups: isCurrentUser ? current?.forumGroups : undefined,
+  };
+  showReviewUserProfileModal.value = true;
+};
+
+// 以下引用通过注入方式从 authState / useInstalledApps 获取，避免循环依赖：
+// logout / setAuthSession（authState）、isInstalledAppInfo / mapInstalledAppToCatalogApp
+// （useInstalledApps）、pendingDownloadRecords.clear（useDownloads）
+let logoutRef: () => void = () => undefined;
+export const registerLogout = (fn: () => void) => {
+  logoutRef = fn;
+};
+let setAuthSessionRef: (session: unknown) => void = () => undefined;
+export const registerSetAuthSession = (fn: (session: unknown) => void) => {
+  setAuthSessionRef = fn;
+};
+let isInstalledAppInfoRef: (value: unknown) => boolean = () => false;
+export const registerIsInstalledAppInfo = (fn: (value: unknown) => boolean) => {
+  isInstalledAppInfoRef = fn;
+};
+let mapInstalledAppToCatalogAppRef: (
+  app: unknown,
+  origin: "spark" | "apm",
+) => App | null = () => null;
+export const registerMapInstalledAppToCatalogApp = (
+  fn: (app: unknown, origin: "spark" | "apm") => App | null,
+) => {
+  mapInstalledAppToCatalogAppRef = fn;
+};
+let pendingDownloadRecordsClear: () => void = () => undefined;
+export const registerPendingDownloadRecordsClear = (fn: () => void) => {
+  pendingDownloadRecordsClear = fn;
+};
+
+export {
+  openLoginFromPrompt,
+  handleLogout,
+  handleFlarumLogin,
+  loadDownloadedHistory,
+  refreshInstalledSyncCandidates,
+  syncInstalledAppsToAccount,
+  syncInstalledAppsNow,
+  openRestoreFromAccount,
+  installCloudItems,
+  maybePromptInstalledSync,
+  openUserManagement,
+  openReviewUserProfile,
+  clearDownloadedState,
+  clearRestoreState,
+  clearInstalledSyncState,
+};
diff --git a/src/composables/useAppDetail.ts b/src/composables/useAppDetail.ts
new file mode 100644
index 00000000..0c38f0a6
--- /dev/null
+++ b/src/composables/useAppDetail.ts
@@ -0,0 +1,475 @@
+/**
+ * useAppDetail —— 应用详情弹窗的获取与打开/关闭逻辑。
+ *
+ * 从原 App.vue 原样搬移（fetchAppFromStore / openDetail / openDetailFromInstalled /
+ * createFallbackApp / checkAppInstalled / loadScreenshots / closeDetail /
+ * openScreenPreview / closeScreenPreview / prevScreen / nextScreen /
+ * selectDetailOrigin / handleDetailRequestLogin / currentDisplayApp /
+ * currentReviewAppKey / currentReviewTags），逻辑零改动。
+ *
+ * 共享状态来自 useAppState；loadFavoriteMetadataForDetail 来自 useFavorites。
+ */
+import { computed, nextTick } from "vue";
+import type { App } from "../global/typedefinition";
+import {
+  apps,
+  currentApp,
+  currentAppSparkInstalled,
+  currentAppApmInstalled,
+  showModal,
+  showPreview,
+  currentScreenIndex,
+  screenshots,
+  storeFilter,
+  favoriteFolders,
+  favoriteLoading,
+  systemInfo,
+} from "./useAppState";
+import { isLoggedIn } from "../global/authState";
+import { APM_STORE_BASE_URL } from "../global/storeConfig";
+import { getHybridDefaultOrigin } from "../global/storeConfig";
+import {
+  getDisplayApp,
+  buildReviewAppKey,
+  buildReviewTags,
+} from "../modules/appIdentity";
+import { loadFavoriteMetadataForDetail } from "./useFavorites";
+import type { ReviewTags } from "../global/typedefinition";
+import type { Ref } from "vue";
+
+const clientArch = computed(() => window.apm_store.arch || "amd64");
+
+const currentDisplayApp = computed(() => getDisplayApp(currentApp.value));
+
+const currentReviewAppKey = computed(() => {
+  if (!currentDisplayApp.value) return "";
+  return buildReviewAppKey(currentDisplayApp.value, clientArch.value);
+});
+
+const currentReviewTags = computed<ReviewTags | null>(() => {
+  if (!currentDisplayApp.value) return null;
+  return buildReviewTags(currentDisplayApp.value, {
+    clientArch: clientArch.value,
+    distro: systemInfo.value.distro,
+  });
+});
+
+// 从仓库获取应用详细信息的辅助函数
+const fetchAppFromStore = async (
+  pkgname: string,
+  category: string,
+  origin: "spark" | "apm",
+): Promise<App | null> => {
+  try {
+    const arch = window.apm_store.arch || "amd64";
+    const finalArch = origin === "spark" ? `${arch}-store` : `${arch}-apm`;
+    // 路径参数需编码，避免特殊字符破坏请求路径或造成路径穿越
+    const appJsonUrl = `${APM_STORE_BASE_URL}/${finalArch}/${encodeURIComponent(
+      category,
+    )}/${encodeURIComponent(pkgname)}/app.json`;
+    // 接入 rootAbortController.signal，确保组件卸载/详情关闭时请求可被取消，
+    // 避免竞态与内存泄漏（onUnmounted 会 abort 该 controller）
+    const response = await fetch(appJsonUrl, {
+      signal: (await import("./useHttp")).rootAbortController.signal,
+    });
+    if (!response.ok) return null;
+    const appJson = await response.json();
+    // img_urls 可能为字符串形式的 JSON，解析失败时安全回退为空数组
+    const parsedImgUrls = (() => {
+      if (typeof appJson.img_urls === "string") {
+        try {
+          return JSON.parse(appJson.img_urls) as string[];
+        } catch {
+          return [];
+        }
+      }
+      return (appJson.img_urls as string[]) || [];
+    })();
+    return {
+      name: appJson.Name || "",
+      pkgname: appJson.Pkgname || pkgname,
+      version: appJson.Version || "",
+      filename: appJson.Filename || "",
+      torrent_address: appJson.Torrent_address || "",
+      author: appJson.Author || "",
+      contributor: appJson.Contributor || "",
+      website: appJson.Website || "",
+      update: appJson.Update || "",
+      size: appJson.Size || "",
+      more: appJson.More || "",
+      tags: appJson.Tags || "",
+      img_urls: parsedImgUrls,
+      icons: appJson.icons || "",
+      category,
+      origin,
+      currentStatus: "not-installed",
+    };
+  } catch (e) {
+    // 组件卸载/详情关闭触发 abort 时静默返回，避免刷 AbortError 日志
+    if ((e as Error)?.name === "AbortError") return null;
+
+    console.warn(`Failed to fetch ${origin} app info for ${pkgname}`, e);
+    return null;
+  }
+};
+
+// 已安装应用页查看详情：复用所有应用页的合并详情视图（始终展示 APM/Spark 两种包）
+const openDetailFromInstalled = (app: App) => {
+  openDetail({ ...app, _fromInstalled: true });
+};
+
+// openDetail 输入类型：完整 App 或仅含必要字段的轻量对象（含内部来源标记）
+interface OpenDetailInput extends Partial<App> {
+  pkgname?: string;
+  category?: string;
+  _fromHomeView?: boolean;
+  _fromInstalled?: boolean;
+  _fromDeepLink?: boolean;
+  origin?: "spark" | "apm";
+}
+
+// 提取远程/本地均无匹配时的回退 App 构造（两处兜底分支共用，避免重复字段映射）
+const createFallbackApp = (
+  raw: Record<string, unknown>,
+  pkgname: string,
+  category: string,
+): App => ({
+  name: (raw.name as string) || "",
+  pkgname,
+  version: (raw.version as string) || "",
+  filename: (raw.filename as string) || "",
+  category,
+  torrent_address: "",
+  author: "",
+  contributor: "",
+  website: "",
+  update: "",
+  size: "",
+  more: (raw.more as string) || "",
+  tags: "",
+  img_urls: [],
+  icons: "",
+  origin: (raw.origin as "spark" | "apm") || "apm",
+  currentStatus: "not-installed",
+});
+
+const openDetail = async (app: App | OpenDetailInput) => {
+  // 提取 pkgname 和 category（必须存在）
+  const pkgname = app?.pkgname;
+  if (!pkgname) {
+    console.warn("openDetail called without pkgname");
+    return;
+  }
+  const category = app.category || "unknown";
+  // 检查是否来自 HomeView 或 DeepLink（需要重新获取完整信息）
+  // 内部来源标记仅存在于轻量输入对象上，按 OpenDetailInput 读取以兼容联合类型
+  const marker = app as OpenDetailInput;
+  const fromHomeView = marker._fromHomeView === true;
+  const fromDeepLink = marker._fromDeepLink === true;
+  // 已安装应用页：始终按"所有应用页"的方式双来源拉取并合并展示（不移除另一类型）
+  const fromInstalled = marker._fromInstalled === true;
+  const needFetchFromStore = fromHomeView || fromDeepLink || fromInstalled;
+
+  // 首先尝试从当前已经处理好（合并/筛选）的 filteredApps 中查找
+  // 优先匹配点击来源 origin（例如排行点击 APM 应用时不应误匹配到 Spark 版）
+  const clickedOrigin = app.origin as "spark" | "apm" | undefined;
+  let fullApp = filteredAppsFind(pkgname, clickedOrigin);
+  // 如果没找到，回退到全局 apps 中查找（同样优先 origin）
+  if (!fullApp) {
+    fullApp = apps.value.find(
+      (a) =>
+        a.pkgname === pkgname && (!clickedOrigin || a.origin === clickedOrigin),
+    );
+  }
+  // 仍无匹配则退化为仅按 pkgname 匹配（兼容无 origin 的场景，如搜索结果）
+  if (!fullApp) {
+    fullApp =
+      filteredAppsFind(pkgname, undefined) ||
+      apps.value.find((a) => a.pkgname === pkgname);
+  }
+
+  let finalApp: App;
+
+  // 来自 HomeView 或 DeepLink 的应用需要重新从仓库获取完整信息
+  if (needFetchFromStore) {
+    // 从 Spark 和 APM 仓库获取完整的应用信息
+    // 已安装页忽略当前商店单一模式限制，始终尝试拉取两种来源，保证另一类型不被隐藏
+    let [sparkApp, apmApp] = await Promise.all([
+      fromInstalled || storeFilter.value !== "apm"
+        ? fetchAppFromStore(pkgname, category, "spark")
+        : Promise.resolve(null),
+      fromInstalled || storeFilter.value !== "spark"
+        ? fetchAppFromStore(pkgname, category, "apm")
+        : Promise.resolve(null),
+    ]);
+
+    // 已安装页：若某来源仓库拉取失败（如分类不匹配），用本地已合并的应用补全，避免丢失另一类型
+    if (fromInstalled && fullApp && fullApp.isMerged) {
+      const merged = fullApp as App;
+      if (!sparkApp && merged.sparkApp) sparkApp = merged.sparkApp;
+      if (!apmApp && merged.apmApp) apmApp = merged.apmApp;
+    }
+
+    // 构建合并的应用对象
+    if (sparkApp || apmApp) {
+      // 如果两个仓库都有这个应用，创建合并对象
+      if (sparkApp && apmApp) {
+        // 优先遵从点击来源 origin；无点击来源时再按优先级配置决定默认显示
+        const defaultOrigin =
+          clickedOrigin && (clickedOrigin === "spark" ? sparkApp : apmApp)
+            ? clickedOrigin
+            : getHybridDefaultOrigin(sparkApp);
+        finalApp = {
+          ...(defaultOrigin === "spark" ? sparkApp : apmApp), // 根据优先级选择主显示
+          isMerged: true,
+          sparkApp: sparkApp,
+          apmApp: apmApp,
+          viewingOrigin: defaultOrigin, // 默认查看来源版本
+        };
+      } else if (sparkApp) {
+        finalApp = sparkApp;
+      } else {
+        finalApp = apmApp!;
+      }
+    } else if (fullApp) {
+      finalApp = fullApp;
+    } else {
+      // 两个仓库都没有找到，且本地也没有，构造一个最小可用的 App 对象
+      finalApp = createFallbackApp(
+        app as Record<string, unknown>,
+        pkgname,
+        category,
+      );
+    }
+  } else {
+    // 非 HomeView 来源，使用原来的逻辑
+    if (fullApp) {
+      finalApp = fullApp;
+    } else {
+      // 构造一个最小可用的 App 对象
+      finalApp = createFallbackApp(
+        app as Record<string, unknown>,
+        pkgname,
+        category,
+      );
+    }
+  }
+
+  // 检查 Spark/APM 安装状态，已安装的版本优先展示
+  if (finalApp.isMerged && (finalApp.sparkApp || finalApp.apmApp)) {
+    const [sparkInstalled, apmInstalled] = await Promise.all([
+      finalApp.sparkApp
+        ? (window.ipcRenderer.invoke("check-installed", {
+            pkgname: finalApp.sparkApp.pkgname,
+            origin: "spark",
+          }) as Promise<boolean>)
+        : Promise.resolve(false),
+      finalApp.apmApp
+        ? (window.ipcRenderer.invoke("check-installed", {
+            pkgname: finalApp.apmApp.pkgname,
+            origin: "apm",
+          }) as Promise<boolean>)
+        : Promise.resolve(false),
+    ]);
+    // 来源默认展示规则：
+    //   1) 已安装页打开：按安装类型打开。
+    //        - 仅一个来源已安装 → 强制展示该已装来源（无需策略覆盖）
+    //        - 多个来源已安装 → 按「设置的优先标签」打开（策略）
+    //   2) 其他页面：一律按「设置的优先标签」打开（策略 > 服务端混合默认），不强制。
+    // 注：forceViewingOrigin 仅用于「已安装页 + 唯一安装来源」这一显式安装类型场景，
+    //     其余情况都不强制，交由详情页按用户标签策略重算。
+    let forceOrigin: "spark" | "apm" | undefined = undefined;
+    if (fromInstalled) {
+      const installedOrigins = (app as Record<string, unknown>).origins as
+        | Array<"spark" | "apm">
+        | undefined;
+      if (installedOrigins && installedOrigins.length === 1) {
+        // 单来源安装：按安装类型强制
+        forceOrigin = installedOrigins[0];
+      } else if (installedOrigins && installedOrigins.length > 1) {
+        // 多来源安装：交由策略（按设置优先标签），不强制
+        forceOrigin = undefined;
+      } else {
+        // origins 未随事件携带时，用 IPC 检测结果兜底判断安装类型
+        if (sparkInstalled && !apmInstalled) forceOrigin = "spark";
+        else if (apmInstalled && !sparkInstalled) forceOrigin = "apm";
+      }
+    }
+    // 非强制分支：清除可能由「已安装页」入口遗留的 forceViewingOrigin 粘性标志，
+    // 避免同一应用从其他页面再次打开时被锁死在旧来源（表现为设置切换不生效）。
+    finalApp.forceViewingOrigin = false;
+    if (
+      forceOrigin &&
+      (forceOrigin === "spark" ? finalApp.sparkApp : finalApp.apmApp)
+    ) {
+      // 已安装页 + 唯一安装来源 → 强制展示该安装类型，优先级高于用户标签策略
+      finalApp.viewingOrigin = forceOrigin;
+      finalApp.forceViewingOrigin = true;
+    } else if (sparkInstalled && !apmInstalled) {
+      // 仅 Spark 安装（其他页面）：默认回退展示已装版本，不强制（仍受用户策略覆盖）
+      finalApp.viewingOrigin = "spark";
+    } else if (apmInstalled && !sparkInstalled) {
+      finalApp.viewingOrigin = "apm";
+    } else {
+      // 都安装/都未安装且未指定来源：交由「标签优先显示策略」决定默认展示。
+      // 此处仅写入混合默认作为回退（供 appIdentity / 截图等下游使用），
+      // 但不置 forceViewingOrigin，详情页会按用户策略重算。
+      finalApp.viewingOrigin = getHybridDefaultOrigin(
+        finalApp.sparkApp || finalApp,
+      );
+    }
+  }
+
+  const displayAppForScreenshots =
+    finalApp.viewingOrigin !== undefined && finalApp.isMerged
+      ? ((finalApp.viewingOrigin === "spark"
+          ? finalApp.sparkApp
+          : finalApp.apmApp) ?? finalApp)
+      : finalApp;
+
+  currentApp.value = finalApp;
+  currentScreenIndex.value = 0;
+  loadScreenshots(displayAppForScreenshots);
+  showModal.value = true;
+
+  currentAppSparkInstalled.value = false;
+  currentAppApmInstalled.value = false;
+  checkAppInstalled(finalApp);
+  if (
+    isLoggedIn.value &&
+    favoriteFolders.value.length === 0 &&
+    !favoriteLoading.value
+  ) {
+    void loadFavoriteMetadataForDetail();
+  }
+
+  nextTick(() => {
+    const modal = document.querySelector(
+      '[data-app-modal="detail"] [data-testid="detail-scroll-content"]',
+    );
+    if (modal) (modal as HTMLElement).scrollTop = 0;
+  });
+};
+
+const checkAppInstalled = (app: App) => {
+  if (app.isMerged) {
+    if (app.sparkApp) {
+      window.ipcRenderer
+        .invoke("check-installed", {
+          pkgname: app.sparkApp.pkgname,
+          origin: "spark",
+        })
+        .then((isInstalled: boolean) => {
+          currentAppSparkInstalled.value = isInstalled;
+        });
+    }
+    if (app.apmApp) {
+      window.ipcRenderer
+        .invoke("check-installed", {
+          pkgname: app.apmApp.pkgname,
+          origin: "apm",
+        })
+        .then((isInstalled: boolean) => {
+          currentAppApmInstalled.value = isInstalled;
+        });
+    }
+  } else {
+    window.ipcRenderer
+      .invoke("check-installed", { pkgname: app.pkgname, origin: app.origin })
+      .then((isInstalled: boolean) => {
+        if (app.origin === "spark") {
+          currentAppSparkInstalled.value = isInstalled;
+        } else {
+          currentAppApmInstalled.value = isInstalled;
+        }
+      });
+  }
+};
+
+const loadScreenshots = (app: App) => {
+  screenshots.value = [];
+  const arch = window.apm_store.arch || "amd64";
+  const finalArch = app.origin === "spark" ? `${arch}-store` : `${arch}-apm`;
+  for (let i = 1; i <= 5; i++) {
+    const screenshotUrl = `${APM_STORE_BASE_URL}/${finalArch}/${app.category}/${app.pkgname}/screen_${i}.png`;
+    screenshots.value.push(screenshotUrl);
+  }
+};
+
+const closeDetail = () => {
+  showModal.value = false;
+  currentApp.value = null;
+};
+
+const openScreenPreview = (index: number) => {
+  currentScreenIndex.value = index;
+  showPreview.value = true;
+};
+
+const closeScreenPreview = () => {
+  showPreview.value = false;
+};
+
+const prevScreen = () => {
+  if (currentScreenIndex.value > 0) {
+    currentScreenIndex.value--;
+  }
+};
+
+const nextScreen = () => {
+  if (currentScreenIndex.value < screenshots.value.length - 1) {
+    currentScreenIndex.value++;
+  }
+};
+
+const selectDetailOrigin = (origin: "spark" | "apm") => {
+  if (currentApp.value?.isMerged) {
+    currentApp.value = { ...currentApp.value, viewingOrigin: origin };
+  }
+};
+
+const handleDetailRequestLogin = (message: string) => {
+  requireLoginRef(message);
+};
+
+// requireLogin 定义在 useAccountSync，这里通过函数引用注入，避免循环依赖。
+// 使用模块级可赋值引用，由 useAccountSync 在初始化时登记。
+let requireLoginRef: (message: string) => boolean = () => true;
+export const registerRequireLogin = (fn: (message: string) => boolean) => {
+  requireLoginRef = fn;
+};
+
+// filteredApps 由 App.vue 汇总派生（依赖多个 composable 状态），此处仅做查找辅助，
+// 实际引用由 App.vue 通过 setFilteredApps 注入，保证与改造前完全一致。
+let filteredAppsSource: Ref<App[]> | null = null;
+export const setFilteredApps = (appsRef: Ref<App[]>) => {
+  filteredAppsSource = appsRef;
+};
+const filteredAppsFind = (
+  pkgname: string,
+  origin: "spark" | "apm" | undefined,
+): App | undefined =>
+  filteredAppsSource?.value.find(
+    (a) => a.pkgname === pkgname && (!origin || a.origin === origin),
+  );
+
+export {
+  clientArch,
+  currentDisplayApp,
+  currentReviewAppKey,
+  currentReviewTags,
+  fetchAppFromStore,
+  openDetail,
+  openDetailFromInstalled,
+  createFallbackApp,
+  checkAppInstalled,
+  loadScreenshots,
+  closeDetail,
+  openScreenPreview,
+  closeScreenPreview,
+  prevScreen,
+  nextScreen,
+  selectDetailOrigin,
+  handleDetailRequestLogin,
+};
+export type { OpenDetailInput };
diff --git a/src/composables/useAppState.ts b/src/composables/useAppState.ts
new file mode 100644
index 00000000..a9f5b74f
--- /dev/null
+++ b/src/composables/useAppState.ts
@@ -0,0 +1,167 @@
+/**
+ * useAppState —— 跨 composable 共享的全局原始响应式状态（单例）。
+ *
+ * 设计说明（避免循环依赖与重复实例化）：
+ * App.vue 原文件中的逻辑被拆分到多个 composable（useCatalog / useRanking /
+ * useAppDetail / useInstalledApps / useFavorites / useAccountSync / useDownloads）。
+ * 这些 composable 之间存在大量共享状态（apps / currentApp / installedApps /
+ * favorite* / 各类弹窗开关等）。若各自持有会出现多实例与状态不同步，并引发循环依赖。
+ *
+ * 故把"贯穿整个应用生命周期的全局原始状态"集中在本模块以单例形式导出，
+ * 所有 composable 与 App.vue 均从本模块取用同一份 ref 实例。
+ * 这与现有 global/authState.ts、global/storeConfig.ts 的单例风格一致。
+ *
+ * 本模块**只持有状态与极少量纯派生 computed**，不含任何业务逻辑/副作用，
+ * 确保拆分前后运行时行为完全一致（7 维度审计：功能/状态一致）。
+ *
+ * 注意：currentApp / currentAppSparkInstalled / currentAppApmInstalled 同时在
+ * storeConfig 中导出（供其它模块直接引用）。本模块从 storeConfig 再导出以保持单一实例。
+ */
+import { ref, computed } from "vue";
+import type { Ref } from "vue";
+import type {
+  App,
+  AppJson,
+  CategoryInfo,
+  SidebarEntry,
+  HomeLink,
+  FavoriteFolder,
+  FavoriteItem,
+  InstalledAppInfo,
+  ResolvedFavoriteItem,
+  SystemInfo,
+  DownloadedAppRecord,
+  SyncedAppListItem,
+  AppReview,
+  ReviewUserProfile,
+  DownloadItem,
+} from "../global/typedefinition";
+
+// ===== 目录数据 =====
+export const apps: Ref<App[]> = ref([]);
+export const categories: Ref<Record<string, CategoryInfo>> = ref({});
+export const tabCategories: Ref<Record<string, Record<string, CategoryInfo>>> =
+  ref({});
+export const tabApps: Ref<Record<string, App[]>> = ref({});
+export const loadingTabs = ref<Set<string>>(new Set());
+export const homeListUrls = ref<
+  Record<string, { spark?: string; apm?: string }>
+>({});
+export const sidebarEntries: Ref<SidebarEntry[]> = ref([]);
+export const sparkAvailable = ref(false);
+export const apmAvailable = ref(false);
+export const storeFilter = ref<"spark" | "apm" | "both">("both");
+export const initialCatalogLoaded = ref(false);
+export const loading = ref(true);
+
+// ===== 首页 / 排行 =====
+export const homeLinks = ref<HomeLink[]>([]);
+export const homeLoading = ref(false);
+export const homeError = ref("");
+export const apmRanking = ref<App[]>([]);
+export const sparkRanking = ref<App[]>([]);
+export const rankingLoading = ref(false);
+
+// ===== 导航 =====
+export type MainView = "default" | "favorites";
+export const currentView = ref<MainView>("default");
+export const activeTab = ref("home");
+export const selectedCategory = ref("all");
+export const searchQuery = ref("");
+export const isSidebarOpen = ref(false);
+
+// ===== 详情弹窗 =====
+export {
+  currentApp,
+  currentAppSparkInstalled,
+  currentAppApmInstalled,
+} from "../global/storeConfig";
+export const showModal = ref(false);
+export const showPreview = ref(false);
+export const currentScreenIndex = ref(0);
+export const screenshots = ref<string[]>([]);
+
+// ===== 已安装应用 =====
+export const showInstalledModal = ref(false);
+export const installedApps = ref<App[]>([]);
+export const installedLoading = ref(false);
+export const installedError = ref("");
+export const installedWarning = ref("");
+export const installedRefreshGeneration = ref(0);
+export const installedSyncPromptShown = ref(false);
+
+// ===== 收藏夹 =====
+export const favoriteFolders = ref<FavoriteFolder[]>([]);
+export const activeFavoriteFolderId = ref<number | null>(null);
+export const favoriteItems = ref<FavoriteItem[]>([]);
+export const favoriteItemsByFolder = ref<Record<number, FavoriteItem[]>>({});
+export const showFavoriteSelector = ref(false);
+export const favoriteTargetApp = ref<App | null>(null);
+export const favoriteSelectorDraftFolderIds = ref<Array<
+  number | "default"
+> | null>(null);
+export const favoriteLoading = ref(false);
+export const favoriteError = ref("");
+export const favoriteRequestGeneration = ref(0);
+
+// ===== 账号 / 下载历史 / 云端同步 / 恢复 =====
+export const showUserManagementModal = ref(false);
+export const downloadedApps = ref<DownloadedAppRecord[]>([]);
+export const downloadedLoading = ref(false);
+export const downloadedError = ref("");
+export const downloadedRequestGeneration = ref(0);
+export const syncLoading = ref(false);
+export const syncStatusMessage = ref("");
+export const syncRequestGeneration = ref(0);
+export const syncCandidateApps = ref<App[]>([]);
+export const restoreLoading = ref(false);
+export const restoreError = ref("");
+export const showRestoreModal = ref(false);
+export const restoreItems = ref<SyncedAppListItem[]>([]);
+export const restoreRequestGeneration = ref(0);
+export const showLoginModal = ref(false);
+export const loginLoading = ref(false);
+export const loginError = ref("");
+export const showLoginPrompt = ref(false);
+export const loginPromptMessage = ref("请登录星火账号后继续操作。");
+export const showLoginPromptMessage = loginPromptMessage;
+export const showReviewUserProfileModal = ref(false);
+export const selectedReviewUserProfile = ref<ReviewUserProfile | null>(null);
+export const systemInfo = ref<SystemInfo>({ distro: "unknown" });
+
+// ===== 下载队列 =====
+export { downloads } from "../global/downloadStatus";
+export const showDownloadDetailModal = ref(false);
+export const currentDownload: Ref<DownloadItem | null> = ref(null);
+
+// ===== 其它弹窗 / 卸载 / 更新中心编排 =====
+export const showUninstallModal = ref(false);
+export const uninstallTargetApp: Ref<App | null> = ref(null);
+export const showAboutModal = ref(false);
+export const showSettingsModal = ref(false);
+export const showApmInstallDialog = ref(false);
+
+// 可用来源 computed（供 storeFilter 相关判断复用）
+export const availableSources = computed(() => ({
+  spark: sparkAvailable.value,
+  apm: apmAvailable.value,
+}));
+
+// 运算符别名（仅导出类型引用，避免重复定义）
+export type {
+  App,
+  AppJson,
+  CategoryInfo,
+  SidebarEntry,
+  HomeLink,
+  FavoriteFolder,
+  FavoriteItem,
+  InstalledAppInfo,
+  ResolvedFavoriteItem,
+  SystemInfo,
+  DownloadedAppRecord,
+  SyncedAppListItem,
+  AppReview,
+  ReviewUserProfile,
+  DownloadItem,
+};
diff --git a/src/composables/useCatalog.ts b/src/composables/useCatalog.ts
new file mode 100644
index 00000000..886a99e0
--- /dev/null
+++ b/src/composables/useCatalog.ts
@@ -0,0 +1,567 @@
+/**
+ * useCatalog —— 应用目录 / 分类 / 侧边栏入口的数据加载。
+ *
+ * 从原 App.vue 原样搬移（loadCategories / loadSidebarConfig / loadTabCategories /
+ * loadTabApps / loadApps / normalizeAppJson / loadHomeListEntries / loadHomeListApps /
+ * preloadHomeListApps / preloadSidebarTabApps），逻辑零改动。
+ *
+ * 共享状态（apps / categories / tabCategories / tabApps / loadingTabs /
+ * homeListUrls / sidebarEntries / initialCatalogLoaded）来自 useAppState 单例。
+ */
+import type {
+  App,
+  AppJson,
+  CategoryInfo,
+  SidebarEntry,
+} from "../global/typedefinition";
+import {
+  apps,
+  categories,
+  tabCategories,
+  tabApps,
+  loadingTabs,
+  homeListUrls,
+  sidebarEntries,
+  initialCatalogLoaded,
+  storeFilter,
+} from "./useAppState";
+import { axiosInstance, fetchWithRetry, rootAbortController } from "./useHttp";
+import { loadPriorityConfig, APM_STORE_BASE_URL } from "../global/storeConfig";
+
+export const loadCategories = async () => {
+  try {
+    const arch = window.apm_store.arch || "amd64";
+    const modes: Array<"spark" | "apm"> = storeFilterMode();
+
+    const categoryData: Record<string, { zh: string; origins: string[] }> = {};
+
+    for (const mode of modes) {
+      const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
+      const path = `/${finalArch}/categories.json`;
+
+      try {
+        const response = await axiosInstance.get(path);
+        const data = response.data;
+        Object.keys(data).forEach((key) => {
+          if (categoryData[key]) {
+            if (!categoryData[key].origins.includes(mode)) {
+              categoryData[key].origins.push(mode);
+            }
+          } else {
+            categoryData[key] = {
+              zh: data[key].zh || data[key],
+              origins: [mode],
+            };
+          }
+        });
+      } catch (e) {
+        // 读取 categories.json 失败（如某来源无此文件），静默忽略该来源
+
+        console.warn(`读取 ${mode} categories.json 失败:`, e);
+      }
+    }
+    categories.value = categoryData;
+
+    // 加载优先级配置（从 spark 目录）
+    await loadPriorityConfig(arch);
+  } catch (error) {
+    console.error(`读取 categories 失败:`, error);
+  }
+};
+
+export const loadSidebarConfig = async () => {
+  try {
+    const arch = window.apm_store.arch || "amd64";
+    const modes: Array<"spark" | "apm"> = storeFilterMode();
+
+    const entryMap = new Map<string, SidebarEntry>();
+
+    for (const mode of modes) {
+      const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
+      const path = `/${finalArch}/sidebar-config.json`;
+
+      try {
+        const response = await axiosInstance.get(path);
+        const data = response.data;
+        const entries = Array.isArray(data) ? data : data.entries || [];
+
+        for (const entry of entries) {
+          if (entry.id && entry.name) {
+            const existing = entryMap.get(entry.id);
+            if (existing) {
+              // 多仓库共有入口，合并来源
+              if (existing.origins && !existing.origins.includes(mode)) {
+                existing.origins.push(mode);
+              }
+            } else {
+              entryMap.set(entry.id, {
+                id: entry.id,
+                name: entry.name,
+                icon: entry.icon || "",
+                type: entry.type || "category",
+                value: entry.value || entry.id,
+                origins: [mode],
+              });
+            }
+          }
+        }
+      } catch (e) {
+        console.warn(`读取 ${mode} sidebar-config.json 失败:`, e);
+      }
+    }
+
+    sidebarEntries.value = Array.from(entryMap.values());
+    if (sidebarEntries.value.length > 0) {
+      console.info(`已加载 ${sidebarEntries.value.length} 个侧边栏配置入口`);
+    }
+  } catch (error) {
+    console.warn(`读取 sidebar-config 失败:`, error);
+  }
+};
+
+export const normalizeAppJson = (
+  appJson: AppJson,
+  category: string,
+  origin: "spark" | "apm",
+): App => ({
+  name: appJson.Name,
+  pkgname: appJson.Pkgname,
+  version: appJson.Version,
+  filename: appJson.Filename,
+  torrent_address: appJson.Torrent_address,
+  author: appJson.Author,
+  contributor: appJson.Contributor,
+  website: appJson.Website,
+  update: appJson.Update,
+  size: appJson.Size,
+  more: appJson.More,
+  tags: appJson.Tags,
+  img_urls: (() => {
+    if (typeof appJson.img_urls === "string") {
+      try {
+        return JSON.parse(appJson.img_urls) as string[];
+      } catch {
+        return [];
+      }
+    }
+    return (appJson.img_urls as string[]) || [];
+  })(),
+  icons: appJson.icons,
+  category: category,
+  origin: origin,
+  currentStatus: "not-installed" as const,
+});
+
+export const loadTabCategories = async () => {
+  const arch = window.apm_store.arch || "amd64";
+  const modes: Array<"spark" | "apm"> = storeFilterMode();
+  const newTabCategories: Record<string, Record<string, CategoryInfo>> = {};
+
+  // 并行加载所有侧边栏入口的子分类，减少串行等待
+  const categoryEntries = sidebarEntries.value.filter(
+    (e) => e.type === "category",
+  );
+
+  await Promise.all(
+    categoryEntries.map(async (entry) => {
+      const folderName = entry.value || entry.id;
+      const catData: Record<string, { zh: string; origins: string[] }> = {};
+      // 只查询该入口实际存在的来源仓库，避免对不存在目录的 404 重试
+      const entryModes = entry.origins?.length
+        ? entry.origins.filter((o) => modes.includes(o))
+        : modes;
+
+      await Promise.all(
+        entryModes.map(async (mode) => {
+          const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
+          const path = `/${finalArch}/${folderName}/categories.json`;
+
+          try {
+            const response = await axiosInstance.get(path);
+            const data = response.data;
+            Object.keys(data).forEach((key) => {
+              if (catData[key]) {
+                if (!catData[key].origins.includes(mode)) {
+                  catData[key].origins.push(mode);
+                }
+              } else {
+                catData[key] = {
+                  zh: data[key].zh || data[key],
+                  origins: [mode],
+                };
+              }
+            });
+          } catch {
+            // 该入口没有子分类，静默忽略
+          }
+        }),
+      );
+
+      if (Object.keys(catData).length > 0) {
+        newTabCategories[entry.id] = catData;
+
+        console.info(
+          `入口 "${entry.id}" 加载到 ${Object.keys(catData).length} 个子分类`,
+        );
+      }
+    }),
+  );
+
+  tabCategories.value = newTabCategories;
+};
+
+export const loadTabApps = async (entryId: string) => {
+  if (tabApps.value[entryId]) return;
+  // 防止重复加载：如果正在加载中则跳过
+  if (loadingTabs.value.has(entryId)) return;
+
+  const entry = sidebarEntries.value.find((e) => e.id === entryId);
+  if (!entry || entry.type !== "category") return;
+
+  // 标记为加载中
+  loadingTabs.value = new Set(loadingTabs.value).add(entryId);
+
+  const arch = window.apm_store.arch || "amd64";
+  const allModes: Array<"spark" | "apm"> = storeFilterMode();
+  // 只查询该入口实际存在的来源仓库，避免对不存在目录的 404 重试
+  const modes = entry.origins?.length
+    ? entry.origins.filter((o) => allModes.includes(o))
+    : allModes;
+  const folderName = entry.value || entry.id;
+  const subCats = tabCategories.value[entryId];
+
+  // 收集所有需要发起的请求任务（mode × 子分类），然后全并发加载
+  const tasks: Promise<App[]>[] = [];
+
+  for (const mode of modes) {
+    const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
+
+    if (subCats && Object.keys(subCats).length > 0) {
+      for (const [subCat, catInfo] of Object.entries(subCats)) {
+        if (
+          catInfo.origins &&
+          catInfo.origins.length > 0 &&
+          !catInfo.origins.includes(mode)
+        )
+          continue;
+
+        const path = `/${finalArch}/${folderName}/${subCat}/applist.json`;
+
+        console.info(`加载入口子分类: ${entryId}/${subCat} (来源: ${mode})`);
+        tasks.push(
+          fetchWithRetry<AppJson[]>(path, rootAbortController.signal)
+            .then((categoryApps) =>
+              (categoryApps || []).map((aj) =>
+                normalizeAppJson(aj, subCat, mode),
+              ),
+            )
+            .catch((e: unknown) => {
+              console.warn(
+                `加载入口子分类 ${entryId}/${subCat} (${mode}) 失败:`,
+                e,
+              );
+              return [] as App[];
+            }),
+        );
+      }
+    } else {
+      const path = `/${finalArch}/${folderName}/applist.json`;
+
+      console.info(`加载入口目录: ${entryId} (来源: ${mode})`);
+      tasks.push(
+        fetchWithRetry<AppJson[]>(path, rootAbortController.signal)
+          .then((categoryApps) =>
+            (categoryApps || []).map((aj) =>
+              normalizeAppJson(aj, folderName, mode),
+            ),
+          )
+          .catch((e: unknown) => {
+            console.warn(`加载入口目录 ${entryId} (${mode}) 失败:`, e);
+            return [] as App[];
+          }),
+      );
+    }
+  }
+
+  const results = await Promise.all(tasks);
+  const loadedApps = results.flat();
+
+  tabApps.value = { ...tabApps.value, [entryId]: loadedApps };
+
+  // 移除加载标记
+  const next = new Set(loadingTabs.value);
+  next.delete(entryId);
+  loadingTabs.value = next;
+
+  console.info(`入口 "${entryId}" 加载完成，共 ${loadedApps.length} 个应用`);
+};
+
+export const loadApps = async (onFirstBatch?: () => void) => {
+  try {
+    console.info("开始加载应用数据（全并发带重试）...");
+
+    const categoriesList = Object.keys(categories.value || {});
+    let firstBatchCallDone = false;
+    const arch = window.apm_store.arch || "amd64";
+
+    // 并发加载所有分类，每个分类自带重试机制
+    await Promise.all(
+      categoriesList.map(async (category) => {
+        const catInfo = categories.value[category];
+        if (!catInfo) return;
+        const origins = (catInfo.origins ||
+          (catInfo.origin ? [catInfo.origin] : [])) as string[];
+
+        await Promise.all(
+          origins.map(async (mode) => {
+            try {
+              const finalArch =
+                mode === "spark" ? `${arch}-store` : `${arch}-apm`;
+
+              const path = `/${finalArch}/${category}/applist.json`;
+
+              console.info(`加载分类: ${category} (来源: ${mode})`);
+              const categoryApps = await fetchWithRetry<AppJson[]>(
+                path,
+                rootAbortController.signal,
+              );
+
+              const normalizedApps = (categoryApps || []).map((appJson) =>
+                normalizeAppJson(appJson, category, mode as "spark" | "apm"),
+              );
+
+              // 增量式更新，让用户尽快看到部分数据
+              // 用赋值替代 push(...)，避免对响应式数组逐元素触发 re-render
+              apps.value = [...apps.value, ...normalizedApps];
+
+              // 只要有一个分类加载成功，就可以考虑关闭整体 loading（如果是首批逻辑）
+              if (!firstBatchCallDone && typeof onFirstBatch === "function") {
+                firstBatchCallDone = true;
+                onFirstBatch();
+                // 标记初始目录加载完成，使 apps.length watcher 开始在目录变更时刷新已安装列表
+                initialCatalogLoaded.value = true;
+              }
+            } catch (error) {
+              console.warn(
+                `加载分类 ${category} 来源 ${mode} 最终失败:`,
+                error,
+              );
+            }
+          }),
+        );
+      }),
+    );
+
+    // 确保即使全部失败也结束 loading
+    if (!firstBatchCallDone && typeof onFirstBatch === "function") {
+      onFirstBatch();
+    }
+  } catch (error) {
+    console.error(`加载应用数据流程异常:`, error);
+  }
+};
+
+// 加载首页推荐列表为侧边栏入口（按名称合并 spark/apm，置于分类入口上方）
+export const loadHomeListEntries = async () => {
+  try {
+    const arch = window.apm_store.arch || "amd64";
+    const modes: Array<"spark" | "apm"> = storeFilterMode();
+
+    // 按列表名称合并各来源的 jsonUrl
+    const byName = new Map<
+      string,
+      { name: string; urls: { spark?: string; apm?: string } }
+    >();
+
+    // 并发拉取各来源的 homelist.json（spark/apm），缩短首页入口加载耗时；
+    // 各来源独立解析后合并到局部 byName，不逐个触发响应式更新。
+    await Promise.all(
+      modes.map(async (mode) => {
+        const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
+        const base = `${APM_STORE_BASE_URL}/${finalArch}/home`;
+        try {
+          const res = await fetch(`${base}/homelist.json`);
+          if (!res.ok) return;
+          const lists = await res.json();
+          lists.forEach(
+            (item: { name?: string; type?: string; jsonUrl?: string }) => {
+              if (item.type === "appList" && item.jsonUrl) {
+                const name = item.name || "推荐";
+                const existing = byName.get(name);
+                if (existing) {
+                  existing.urls[mode] = item.jsonUrl;
+                } else {
+                  byName.set(name, {
+                    name,
+                    urls: { [mode]: item.jsonUrl } as {
+                      spark?: string;
+                      apm?: string;
+                    },
+                  });
+                }
+              }
+            },
+          );
+        } catch (e) {
+          console.warn(`Failed to load ${mode} homelist.json`, e);
+        }
+      }),
+    );
+
+    const entries: SidebarEntry[] = [];
+    const urlsMap: Record<string, { spark?: string; apm?: string }> = {};
+
+    byName.forEach((info, name) => {
+      const id = `home-list-${name}`;
+      entries.push({
+        id,
+        name,
+        icon: "fas fa-star",
+        type: "homeList",
+      });
+      urlsMap[id] = info.urls;
+    });
+
+    if (entries.length > 0) {
+      // 首页推荐入口置于分类入口上方
+      sidebarEntries.value = [...entries, ...sidebarEntries.value];
+      homeListUrls.value = { ...homeListUrls.value, ...urlsMap };
+
+      console.info(`已加载 ${entries.length} 个首页推荐列表入口`);
+    }
+  } catch (error) {
+    console.warn(`加载首页推荐列表入口失败: ${error}`);
+  }
+};
+
+// 加载首页推荐列表的应用数据（合并展示 spark+apm，按 pkgname 去重，spark 优先）
+export const loadHomeListApps = async (entryId: string) => {
+  if (tabApps.value[entryId]) return;
+  // 防止重复加载：如果正在加载中则跳过
+  if (loadingTabs.value.has(entryId)) return;
+
+  const urls = homeListUrls.value[entryId];
+  if (!urls) return;
+
+  // 标记为加载中
+  loadingTabs.value = new Set(loadingTabs.value).add(entryId);
+
+  const arch = window.apm_store.arch || "amd64";
+  const loadedApps: App[] = [];
+  const seenPkgnames = new Set<string>();
+
+  const parseAppList = (
+    rawApps: Record<string, string>[],
+    mode: "spark" | "apm",
+  ): App[] =>
+    rawApps.map((a) => {
+      // 首页推荐列表的 jsonUrl 形如 /home/lists/xxx.json；服务端原始数据不含 category 字段，
+      // 这里提取 URL 首段目录作为分类（无真实分类时回退 "unknown"），避免污染后续优先级匹配。
+      const urlCategory =
+        (urls[mode] || "").split("/").filter(Boolean)[0] || "unknown";
+      const category = a.Category || a.category || urlCategory;
+
+      let img_urls: string[] = [];
+      const rawImgUrls = a.img_urls;
+      if (typeof rawImgUrls === "string") {
+        try {
+          img_urls = JSON.parse(rawImgUrls);
+        } catch {
+          img_urls = [];
+        }
+      } else if (Array.isArray(rawImgUrls)) {
+        img_urls = rawImgUrls;
+      }
+
+      return {
+        name: a.Name || a.name || a.Pkgname || a.pkgname || "",
+        pkgname: a.Pkgname || a.pkgname || "",
+        version: a.Version || "",
+        filename: a.Filename || a.filename || "",
+        torrent_address: a.Torrent_address || "",
+        author: a.Author || "",
+        contributor: a.Contributor || "",
+        website: a.Website || "",
+        update: a.Update || "",
+        size: a.Size || "",
+        more: a.More || a.more || "",
+        tags: a.Tags || "",
+        img_urls,
+        icons: a.icons || "",
+        category,
+        origin: mode,
+        currentStatus: "not-installed" as const,
+      } as App;
+    });
+
+  // 按优先级顺序加载：spark 优先，apm 中与 spark 同名的跳过
+  const modes: Array<"spark" | "apm"> = ["spark", "apm"];
+  for (const mode of modes) {
+    const jsonUrl = urls[mode];
+    if (!jsonUrl) continue;
+    const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
+
+    try {
+      const path = `/${finalArch}${jsonUrl}`;
+      const rawApps =
+        (await fetchWithRetry<Record<string, string>[]>(
+          path,
+          rootAbortController.signal,
+        )) || [];
+      const apps = parseAppList(rawApps, mode);
+      for (const app of apps) {
+        if (!app.pkgname || seenPkgnames.has(app.pkgname)) continue;
+        seenPkgnames.add(app.pkgname);
+        loadedApps.push(app);
+      }
+    } catch (e) {
+      console.warn(`加载首页列表 ${entryId} (${mode}) 失败:`, e);
+    }
+  }
+
+  tabApps.value = { ...tabApps.value, [entryId]: loadedApps };
+
+  // 移除加载标记
+  const next = new Set(loadingTabs.value);
+  next.delete(entryId);
+  loadingTabs.value = next;
+
+  console.info(
+    `首页列表 "${entryId}" 加载完成，共 ${loadedApps.length} 个应用`,
+  );
+};
+
+// 仅并行预加载首页 homeList 板块入口（区域2 数据来源，不依赖全量应用）
+export const preloadHomeListApps = (): Promise<void> => {
+  const tasks: Promise<void>[] = [];
+  for (const entry of sidebarEntries.value) {
+    if (entry.type === "homeList") {
+      tasks.push(
+        loadHomeListApps(entry.id).catch((e: unknown) =>
+          console.warn(`预加载首页列表 ${entry.id} 失败:`, e),
+        ),
+      );
+    }
+  }
+  return Promise.all(tasks).then(() => undefined);
+};
+
+// 并行预加载其余分类侧边栏入口（用户点击分类时才需要，可延后）
+export const preloadSidebarTabApps = (): Promise<void> => {
+  const tasks: Promise<void>[] = [];
+  for (const entry of sidebarEntries.value) {
+    if (entry.type === "category") {
+      tasks.push(
+        loadTabApps(entry.id).catch((e: unknown) =>
+          console.warn(`预加载入口 ${entry.id} 失败:`, e),
+        ),
+      );
+    }
+  }
+  return Promise.all(tasks).then(() => undefined);
+};
+
+// 来源模式解析：both -> [spark, apm]，否则单一来源
+function storeFilterMode(): Array<"spark" | "apm"> {
+  return storeFilter.value === "both" ? ["spark", "apm"] : [storeFilter.value];
+}
diff --git a/src/composables/useDownloads.ts b/src/composables/useDownloads.ts
new file mode 100644
index 00000000..bdf2daeb
--- /dev/null
+++ b/src/composables/useDownloads.ts
@@ -0,0 +1,233 @@
+/**
+ * useDownloads —— 下载队列控制与安装触发。
+ *
+ * 从原 App.vue 原样搬移（pendingDownloadRecords / onDetailInstall /
+ * handleInstallCompleteForDownloadRecord / onDetailRemove / onDetailFavorite /
+ * pauseDownload / resumeDownload / cancelDownload / retryDownload /
+ * clearCompletedDownloads / showDownloadDetailModalFunc / closeDownloadDetail /
+ * openDownloadedApp / installCompleteCallback / watchDownloadsChange 注册），逻辑零改动。
+ *
+ * 共享状态来自 useAppState；handleInstall / handleRetry 来自 modules/processInstall；
+ * openFavoriteSelector 来自 useFavorites。
+ */
+import type {
+  App,
+  DownloadItem,
+  DownloadResult,
+  DownloadedAppRecord,
+} from "../global/typedefinition";
+import type { IpcRendererEvent } from "electron";
+import {
+  downloads,
+  currentDownload,
+  showDownloadDetailModal,
+  currentApp,
+} from "./useAppState";
+import { handleInstall, handleRetry } from "../modules/processInstall";
+import { watchDownloadsChange } from "../global/downloadStatus";
+import { buildFavoriteAppKey, parsePackageArch } from "../modules/appIdentity";
+import { openFavoriteSelector } from "./useFavorites";
+import { recordDownloadedApp } from "../modules/backendApi";
+import { isLoggedIn, currentUser } from "../global/authState";
+
+interface PendingDownloadRecord {
+  userId: number;
+  appKey: string;
+  pkgname: string;
+  name: string;
+  category: string;
+  selectedOrigin: "spark" | "apm";
+  version: string;
+  packageArch: string;
+}
+
+const pendingDownloadRecords = new Map<number, PendingDownloadRecord>();
+
+const onDetailInstall = async (app: App) => {
+  const initiatingUserId = currentUser.value?.id ?? null;
+  const download = await handleInstall(app);
+  if (
+    !download ||
+    initiatingUserId === null ||
+    !isLoggedIn.value ||
+    currentUser.value?.id !== initiatingUserId
+  ) {
+    return;
+  }
+
+  pendingDownloadRecords.set(download.id, {
+    userId: initiatingUserId,
+    appKey: buildFavoriteAppKey(app),
+    pkgname: app.pkgname,
+    name: app.name,
+    category: app.category,
+    selectedOrigin: app.origin,
+    version: app.version,
+    packageArch: app.arch || parsePackageArch(app.filename),
+  });
+};
+
+const handleInstallCompleteForDownloadRecord = async (
+  _event: IpcRendererEvent,
+  result: DownloadResult,
+) => {
+  const pendingRecord = pendingDownloadRecords.get(result.id);
+  if (!pendingRecord) return;
+
+  if (result.success) {
+    pendingDownloadRecords.delete(result.id);
+  }
+
+  if (
+    !result.success ||
+    !isLoggedIn.value ||
+    currentUser.value?.id !== pendingRecord.userId
+  ) {
+    return;
+  }
+
+  const downloadRecord: Omit<DownloadedAppRecord, "id" | "downloadedAt"> = {
+    appKey: pendingRecord.appKey,
+    pkgname: pendingRecord.pkgname,
+    name: pendingRecord.name,
+    category: pendingRecord.category,
+    selectedOrigin: pendingRecord.selectedOrigin,
+    version: pendingRecord.version,
+    packageArch: pendingRecord.packageArch,
+  };
+
+  try {
+    await recordDownloadedApp(downloadRecord);
+  } catch (error: unknown) {
+    console.warn({ err: error }, "记录下载应用失败");
+  }
+};
+
+const onDetailRemove = (app: App) => {
+  requestUninstallRef(app);
+};
+
+const onDetailFavorite = async (app: App) => {
+  await openFavoriteSelector(app);
+};
+
+// TODO: 目前 APM 商店不能暂停下载
+const pauseDownload = (id: DownloadItem) => {
+  const download = downloads.value.find((d) => d.id === id.id);
+  if (download && download.status === "installing") {
+    // 'installing' matches type definition, previously 'downloading'
+    download.status = "paused";
+    download.logs.push({
+      time: Date.now(),
+      message: "下载已暂停",
+    });
+  }
+};
+
+// TODO: 同理，暂未实现
+const resumeDownload = (id: DownloadItem) => {
+  const download = downloads.value.find((d) => d.id === id.id);
+  if (download && download.status === "paused") {
+    download.status = "installing"; // previously 'downloading'
+    download.logs.push({
+      time: Date.now(),
+      message: "继续下载...",
+    });
+    // simulateDownload(download); // removed or undefined?
+  }
+};
+
+const cancelDownload = (id: DownloadItem) => {
+  const index = downloads.value.findIndex((d) => d.id === id.id);
+  if (index !== -1) {
+    const download = downloads.value[index];
+    // 发送到主进程取消
+    window.ipcRenderer.send("cancel-install", download.id);
+
+    download.status = "failed";
+    download.logs.push({
+      time: Date.now(),
+      message: "下载已取消",
+    });
+    // 保留在队列中以便用户可以重试或查看日志
+  }
+};
+
+const retryDownload = (id: DownloadItem) => {
+  const download = downloads.value.find((d) => d.id === id.id);
+  if (download && download.status === "failed") {
+    download.status = "queued";
+    download.progress = 0;
+    download.downloadedSize = 0;
+    download.logs.push({
+      time: Date.now(),
+      message: "重新开始下载...",
+    });
+    handleRetry(download);
+  }
+};
+
+const clearCompletedDownloads = () => {
+  downloads.value = downloads.value.filter((d) => d.status !== "completed");
+};
+
+const showDownloadDetailModalFunc = (download: DownloadItem) => {
+  currentDownload.value = download;
+  showDownloadDetailModal.value = true;
+};
+
+const closeDownloadDetail = () => {
+  showDownloadDetailModal.value = false;
+  currentDownload.value = null;
+};
+
+const openDownloadedApp = (pkgname: string, origin?: "spark" | "apm") => {
+  // const encodedPkg = encodeURIComponent(download.pkgname);
+  // openApmStoreUrl(`apmstore://launch?pkg=${encodedPkg}`, {
+  //   fallbackText: `打开应用: ${download.pkgname}`
+  // });
+  window.ipcRenderer
+    .invoke("launch-app", { pkgname, origin })
+    .catch((err) => console.error("启动应用失败 (launch-app):", err));
+};
+
+const installCompleteCallback = (pkgname?: string) => {
+  if (currentApp.value && (!pkgname || currentApp.value.pkgname === pkgname)) {
+    checkAppInstalledRef(currentApp.value);
+  }
+};
+
+watchDownloadsChange(installCompleteCallback);
+
+// checkAppInstalled 由 useAppDetail 持有，通过注入引用获取，避免循环依赖
+let checkAppInstalledRef: (app: App) => void = () => undefined;
+export const registerCheckAppInstalled = (fn: (app: App) => void) => {
+  checkAppInstalledRef = fn;
+};
+// requestUninstall 由 useInstalledApps 持有，通过注入引用获取，避免循环依赖
+let requestUninstallRef: (app: App) => void = () => undefined;
+export const registerRequestUninstall = (fn: (app: App) => void) => {
+  requestUninstallRef = fn;
+};
+// 登出时清空待下载记录（原 App.vue logout 中的 pendingDownloadRecords.clear()）
+export const clearPendingDownloadRecords = (): void => {
+  pendingDownloadRecords.clear();
+};
+
+// onDetailInstall 需要被 useFavorites / useAccountSync 调用，此处导出
+export {
+  pendingDownloadRecords,
+  onDetailInstall,
+  handleInstallCompleteForDownloadRecord,
+  onDetailRemove,
+  onDetailFavorite,
+  pauseDownload,
+  resumeDownload,
+  cancelDownload,
+  retryDownload,
+  clearCompletedDownloads,
+  showDownloadDetailModalFunc,
+  closeDownloadDetail,
+  openDownloadedApp,
+  installCompleteCallback,
+};
diff --git a/src/composables/useFavorites.ts b/src/composables/useFavorites.ts
new file mode 100644
index 00000000..065f5675
--- /dev/null
+++ b/src/composables/useFavorites.ts
@@ -0,0 +1,489 @@
+/**
+ * useFavorites —— 收藏夹相关的全部状态与逻辑。
+ *
+ * 从原 App.vue 原样搬移（loadFavoriteFolders / loadActiveFavoriteItems /
+ * loadAllFavoriteItems / loadFavoriteMetadataForDetail / refreshFavorites /
+ * openFavoriteSelector / toFavoritePayload / saveCurrentFavoriteFolders /
+ * createFavoriteFolderFromSelector / openFavoriteManagement / selectFavoriteFolder /
+ * createFavoriteFolderFromPrompt / removeSelectedFavorites / installResolvedFavorites /
+ * clearFavoriteState / 代次守卫 / currentFavoriteMetadata / currentFavoriteFolderIds /
+ * resolvedFavoriteItems），逻辑零改动。
+ *
+ * 共享状态来自 useAppState；clientArch 来自 useAppDetail。
+ */
+import { computed } from "vue";
+import type {
+  App,
+  FavoriteItem,
+  ResolvedFavoriteItem,
+} from "../global/typedefinition";
+import {
+  favoriteFolders,
+  favoriteItems,
+  favoriteItemsByFolder,
+  favoriteLoading,
+  favoriteError,
+  favoriteRequestGeneration,
+  favoriteTargetApp,
+  favoriteSelectorDraftFolderIds,
+  activeFavoriteFolderId,
+  showFavoriteSelector,
+  currentView,
+  activeTab,
+  isSidebarOpen,
+  showLoginPrompt,
+  apps,
+  installedApps,
+  availableSources,
+  storeFilter,
+} from "./useAppState";
+import { clientArch } from "./useAppDetail";
+import {
+  listFavoriteFolders,
+  listFavoriteItems,
+  addFavoriteItem,
+  deleteFavoriteItem,
+  createFavoriteFolder,
+  bulkDeleteFavoriteItems,
+} from "../modules/backendApi";
+import { buildFavoriteAppKey } from "../modules/appIdentity";
+import { resolveFavoriteItems } from "../modules/favoriteAvailability";
+import { isLoggedIn } from "../global/authState";
+import { refreshFavoriteInstalledApps } from "./useInstalledApps";
+
+const nextFavoriteRequestGeneration = (): number => {
+  favoriteRequestGeneration.value += 1;
+  return favoriteRequestGeneration.value;
+};
+
+const isCurrentFavoriteRequest = (generation: number): boolean =>
+  favoriteRequestGeneration.value === generation && isLoggedIn.value;
+
+const loadFavoriteFolders = async (
+  generation = favoriteRequestGeneration.value,
+): Promise<boolean> => {
+  const folders = await listFavoriteFolders();
+  if (!isCurrentFavoriteRequest(generation)) return false;
+
+  favoriteFolders.value = folders;
+  const activeFolderExists = folders.some(
+    (folder) => folder.id === activeFavoriteFolderId.value,
+  );
+  if (!activeFolderExists) {
+    activeFavoriteFolderId.value = folders[0]?.id ?? null;
+  }
+  return true;
+};
+
+const loadActiveFavoriteItems = async (
+  generation = favoriteRequestGeneration.value,
+): Promise<boolean> => {
+  if (!activeFavoriteFolderId.value) {
+    if (!isCurrentFavoriteRequest(generation)) return false;
+    favoriteItems.value = [];
+    return true;
+  }
+  const items = await listFavoriteItems(activeFavoriteFolderId.value);
+  if (!isCurrentFavoriteRequest(generation)) return false;
+
+  favoriteItems.value = items;
+  favoriteItemsByFolder.value = {
+    ...favoriteItemsByFolder.value,
+    [activeFavoriteFolderId.value]: items,
+  };
+  return true;
+};
+
+const loadAllFavoriteItems = async (
+  generation = favoriteRequestGeneration.value,
+): Promise<boolean> => {
+  const folderIds = favoriteFolders.value.map((folder) => folder.id);
+  const entries = await Promise.all(
+    folderIds.map(async (folderId) => ({
+      folderId,
+      items: await listFavoriteItems(folderId),
+    })),
+  );
+  if (!isCurrentFavoriteRequest(generation)) return false;
+
+  favoriteItemsByFolder.value = Object.fromEntries(
+    entries.map(({ folderId, items }) => [folderId, items]),
+  );
+  favoriteItems.value = activeFavoriteFolderId.value
+    ? (favoriteItemsByFolder.value[activeFavoriteFolderId.value] ?? [])
+    : [];
+  return true;
+};
+
+const loadFavoriteMetadataForDetail = async (): Promise<void> => {
+  const generation = favoriteRequestGeneration.value;
+  try {
+    const folders = await listFavoriteFolders();
+    if (!isCurrentFavoriteRequest(generation)) return;
+    const entries = await Promise.all(
+      folders.map(async (folder) => ({
+        folderId: folder.id,
+        items: await listFavoriteItems(folder.id),
+      })),
+    );
+    if (!isCurrentFavoriteRequest(generation)) return;
+
+    favoriteFolders.value = folders;
+    favoriteItemsByFolder.value = Object.fromEntries(
+      entries.map(({ folderId, items }) => [folderId, items]),
+    );
+  } catch (error: unknown) {
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteError.value = (error as Error)?.message || "读取收藏夹失败";
+  }
+};
+
+const refreshFavorites = async (): Promise<void> => {
+  const generation = nextFavoriteRequestGeneration();
+  favoriteLoading.value = true;
+  favoriteError.value = "";
+  try {
+    await Promise.all([
+      refreshFavoriteInstalledApps(),
+      loadFavoriteFolders(generation),
+    ]);
+    if (!isCurrentFavoriteRequest(generation)) return;
+    await loadAllFavoriteItems(generation);
+  } catch (error: unknown) {
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteError.value = (error as Error)?.message || "读取收藏夹失败";
+  } finally {
+    if (isCurrentFavoriteRequest(generation)) favoriteLoading.value = false;
+  }
+};
+
+const openFavoriteSelector = async (app: App) => {
+  if (!requireLoginRef("收藏应用需要登录星火账号。")) return;
+  const generation = nextFavoriteRequestGeneration();
+  favoriteTargetApp.value = app;
+  favoriteSelectorDraftFolderIds.value = null;
+  favoriteError.value = "";
+  try {
+    const foldersLoaded = await loadFavoriteFolders(generation);
+    if (!foldersLoaded || !isCurrentFavoriteRequest(generation)) return;
+    const itemsLoaded = await loadAllFavoriteItems(generation);
+    if (!itemsLoaded || !isCurrentFavoriteRequest(generation)) return;
+    showFavoriteSelector.value = true;
+  } catch (error: unknown) {
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteError.value = (error as Error)?.message || "读取收藏夹失败";
+  }
+};
+
+const toFavoritePayload = (
+  app: App,
+): Omit<FavoriteItem, "id" | "createdAt"> => ({
+  appKey: buildFavoriteAppKey(app),
+  pkgname: app.pkgname,
+  name: app.name,
+  category: app.category,
+  iconUrl: app.icons,
+});
+
+const saveCurrentFavoriteFolders = async (
+  folderIds: Array<number | "default">,
+) => {
+  const generation = favoriteRequestGeneration.value;
+  const app = favoriteTargetApp.value;
+  if (!app) return;
+  try {
+    const numericFolderIds = folderIds.filter(
+      (folderId): folderId is number => typeof folderId === "number",
+    );
+    const includesFallbackDefault = folderIds.includes("default");
+    const nextFolderIds = new Set(numericFolderIds);
+    const existingByFolder = favoriteFolders.value
+      .map((folder) => ({
+        folderId: folder.id,
+        item: (favoriteItemsByFolder.value[folder.id] ?? []).find(
+          (favorite) =>
+            favorite.pkgname === app.pkgname &&
+            favorite.category === app.category,
+        ),
+      }))
+      .filter(
+        (entry): entry is { folderId: number; item: FavoriteItem } =>
+          entry.item !== undefined,
+      );
+    const existingFolderIds = new Set(
+      existingByFolder.map((entry) => entry.folderId),
+    );
+    const payload = toFavoritePayload(app);
+    const addedItemPromises = numericFolderIds
+      .filter((folderId) => !existingFolderIds.has(folderId))
+      .map(async (folderId) => ({
+        folderId,
+        item: await addFavoriteItem(folderId, payload),
+      }));
+    const deletedEntries = existingByFolder.filter(
+      ({ folderId }) => !nextFolderIds.has(folderId),
+    );
+
+    const [addedEntries] = await Promise.all([
+      Promise.all(addedItemPromises),
+      ...(includesFallbackDefault ? [addFavoriteItem("default", payload)] : []),
+      ...deletedEntries.map(({ folderId, item }) =>
+        deleteFavoriteItem(folderId, item.id),
+      ),
+    ]);
+    if (!isCurrentFavoriteRequest(generation)) return;
+    const nextItemsByFolder = { ...favoriteItemsByFolder.value };
+    deletedEntries.forEach(({ folderId, item }) => {
+      nextItemsByFolder[folderId] = (nextItemsByFolder[folderId] ?? []).filter(
+        (favorite) => favorite.id !== item.id,
+      );
+    });
+    addedEntries.forEach(({ folderId, item }) => {
+      nextItemsByFolder[folderId] = [
+        ...(nextItemsByFolder[folderId] ?? []).filter(
+          (favorite) =>
+            favorite.pkgname !== app.pkgname ||
+            favorite.category !== app.category,
+        ),
+        item,
+      ];
+    });
+    favoriteItemsByFolder.value = nextItemsByFolder;
+    if (activeFavoriteFolderId.value) {
+      favoriteItems.value =
+        nextItemsByFolder[activeFavoriteFolderId.value] ?? [];
+    }
+    showFavoriteSelector.value = false;
+    favoriteTargetApp.value = null;
+    favoriteSelectorDraftFolderIds.value = null;
+    if (includesFallbackDefault) await refreshFavorites();
+  } catch (error: unknown) {
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteError.value = (error as Error)?.message || "更新收藏失败";
+  }
+};
+
+const createFavoriteFolderFromSelector = async (
+  draftFolderIds: Array<
+    number | "default"
+  > = favoriteSelectorDraftFolderIds.value ?? [],
+): Promise<void> => {
+  const generation = favoriteRequestGeneration.value;
+  const name = window.prompt("请输入收藏夹名称");
+  const folderName = name?.trim();
+  if (!folderName) return;
+  const app = favoriteTargetApp.value;
+  if (!app) return;
+  favoriteLoading.value = true;
+  favoriteError.value = "";
+  try {
+    const folder = await createFavoriteFolder(folderName);
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteFolders.value = [
+      ...favoriteFolders.value.filter((item) => item.id !== folder.id),
+      folder,
+    ];
+    favoriteItemsByFolder.value = {
+      ...favoriteItemsByFolder.value,
+      [folder.id]: favoriteItemsByFolder.value[folder.id] ?? [],
+    };
+    favoriteSelectorDraftFolderIds.value = [
+      ...new Set([...draftFolderIds, folder.id]),
+    ];
+    showFavoriteSelector.value = true;
+  } catch (error: unknown) {
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteError.value = (error as Error)?.message || "创建收藏夹失败";
+  } finally {
+    if (isCurrentFavoriteRequest(generation)) favoriteLoading.value = false;
+  }
+};
+
+const openFavoriteManagement = async () => {
+  if (!requireLoginRef("请登录后查看我的收藏。")) return;
+  currentView.value = "favorites";
+  activeTab.value = "favorites";
+  isSidebarOpen.value = false;
+  showLoginPrompt.value = false;
+  await refreshFavorites();
+};
+
+const selectFavoriteFolder = async (folderId: number) => {
+  const generation = nextFavoriteRequestGeneration();
+  activeFavoriteFolderId.value = folderId;
+  favoriteLoading.value = true;
+  favoriteError.value = "";
+  try {
+    await loadActiveFavoriteItems(generation);
+  } catch (error: unknown) {
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteError.value = (error as Error)?.message || "读取收藏应用失败";
+  } finally {
+    if (isCurrentFavoriteRequest(generation)) favoriteLoading.value = false;
+  }
+};
+
+const createFavoriteFolderFromPrompt = async () => {
+  const name = window.prompt("请输入收藏夹名称");
+  const folderName = name?.trim();
+  if (!folderName) return;
+  const generation = favoriteRequestGeneration.value;
+  favoriteLoading.value = true;
+  favoriteError.value = "";
+  try {
+    const folder = await createFavoriteFolder(folderName);
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteFolders.value = [
+      ...favoriteFolders.value.filter((item) => item.id !== folder.id),
+      folder,
+    ];
+    favoriteItemsByFolder.value = {
+      ...favoriteItemsByFolder.value,
+      [folder.id]: favoriteItemsByFolder.value[folder.id] ?? [],
+    };
+    favoriteItems.value = [];
+    activeFavoriteFolderId.value = folder.id;
+  } catch (error: unknown) {
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteError.value = (error as Error)?.message || "创建收藏夹失败";
+  } finally {
+    if (isCurrentFavoriteRequest(generation)) favoriteLoading.value = false;
+  }
+};
+
+const removeSelectedFavorites = async (ids: number[]) => {
+  if (!activeFavoriteFolderId.value || ids.length === 0) return;
+  const generation = favoriteRequestGeneration.value;
+  favoriteLoading.value = true;
+  favoriteError.value = "";
+  try {
+    await bulkDeleteFavoriteItems(activeFavoriteFolderId.value, ids);
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteItemsByFolder.value = {
+      ...favoriteItemsByFolder.value,
+      [activeFavoriteFolderId.value]: (
+        favoriteItemsByFolder.value[activeFavoriteFolderId.value] ?? []
+      ).filter((favorite) => !ids.includes(favorite.id)),
+    };
+    await refreshFavorites();
+  } catch (error: unknown) {
+    if (!isCurrentFavoriteRequest(generation)) return;
+    favoriteError.value = (error as Error)?.message || "移除收藏失败";
+  } finally {
+    if (isCurrentFavoriteRequest(generation)) favoriteLoading.value = false;
+  }
+};
+
+const installResolvedFavorites = async (items: ResolvedFavoriteItem[]) => {
+  for (const item of items) {
+    if (item.selectedApp) {
+      await onDetailInstallRef(item.selectedApp);
+    }
+  }
+};
+
+const clearFavoriteState = () => {
+  favoriteRequestGeneration.value += 1;
+  favoriteFolders.value = [];
+  activeFavoriteFolderId.value = null;
+  favoriteItems.value = [];
+  favoriteItemsByFolder.value = {};
+  showFavoriteSelector.value = false;
+  favoriteTargetApp.value = null;
+  favoriteSelectorDraftFolderIds.value = null;
+  favoriteLoading.value = false;
+  favoriteError.value = "";
+};
+
+// requireLogin / onDetailInstall 分别定义在 useAccountSync / useDownloads，
+// 通过模块级可赋值引用注入，避免循环依赖。
+let requireLoginRef: (message: string) => boolean = () => true;
+export const registerRequireLogin = (fn: (message: string) => boolean) => {
+  requireLoginRef = fn;
+};
+let onDetailInstallRef: (app: App) => Promise<void> = async () => undefined;
+export const registerOnDetailInstall = (fn: (app: App) => Promise<void>) => {
+  onDetailInstallRef = fn;
+};
+
+// 这些 computed 依赖 currentDisplayApp / favorite 状态，放在本模块汇总派生。
+export const currentFavoriteMetadata = computed(
+  (): {
+    favorited: boolean;
+    folderName: string;
+  } => {
+    // 延迟引用 currentDisplayApp，避免顶层循环导入时的初始化顺序问题
+    const app = currentDisplayAppRef();
+    if (!app) return { favorited: false, folderName: "" };
+
+    const folder = favoriteFolders.value.find((favoriteFolder) => {
+      const items = favoriteItemsByFolder.value[favoriteFolder.id] ?? [];
+      return items.some(
+        (favorite) =>
+          favorite.pkgname === app.pkgname &&
+          favorite.category === app.category,
+      );
+    });
+    if (!folder) return { favorited: false, folderName: "" };
+
+    return { favorited: true, folderName: folder.name.trim() };
+  },
+);
+
+export const currentFavoriteFolderIds = computed(
+  (): Array<number | "default"> => {
+    if (favoriteSelectorDraftFolderIds.value) {
+      return favoriteSelectorDraftFolderIds.value;
+    }
+
+    const app = favoriteTargetApp.value ?? currentDisplayAppRef();
+    if (!app) return [];
+
+    return favoriteFolders.value
+      .filter((folder) =>
+        (favoriteItemsByFolder.value[folder.id] ?? []).some(
+          (favorite) =>
+            favorite.pkgname === app.pkgname &&
+            favorite.category === app.category,
+        ),
+      )
+      .map((folder) => folder.id);
+  },
+);
+
+export const resolvedFavoriteItems = computed<ResolvedFavoriteItem[]>(() =>
+  resolveFavoriteItems(
+    favoriteItems.value,
+    apps.value,
+    installedApps.value,
+    availableSources.value,
+    storeFilter.value,
+    clientArch.value,
+  ),
+);
+
+// currentDisplayApp 由 useAppDetail 持有，此处通过注入引用获取，避免循环导入
+let currentDisplayAppRef: () => App | null = () => null;
+export const registerCurrentDisplayApp = (fn: () => App | null) => {
+  currentDisplayAppRef = fn;
+};
+
+export {
+  loadFavoriteFolders,
+  loadActiveFavoriteItems,
+  loadAllFavoriteItems,
+  loadFavoriteMetadataForDetail,
+  refreshFavorites,
+  openFavoriteSelector,
+  toFavoritePayload,
+  saveCurrentFavoriteFolders,
+  createFavoriteFolderFromSelector,
+  openFavoriteManagement,
+  selectFavoriteFolder,
+  createFavoriteFolderFromPrompt,
+  removeSelectedFavorites,
+  installResolvedFavorites,
+  clearFavoriteState,
+  nextFavoriteRequestGeneration,
+  isCurrentFavoriteRequest,
+};
diff --git a/src/composables/useHttp.ts b/src/composables/useHttp.ts
new file mode 100644
index 00000000..ba11d82e
--- /dev/null
+++ b/src/composables/useHttp.ts
@@ -0,0 +1,73 @@
+/**
+ * useHttp —— 全局 HTTP 工具（axios 实例 + 带重试请求 + 超时包装）。
+ *
+ * 从原 App.vue 原样搬移，逻辑零改动，仅改为导出供各 composable 复用。
+ * 含缓存穿透拦截器（createCacheBusterInterceptor），与之前的审计加固一致。
+ */
+import axios, { AxiosError } from "axios";
+import { APM_STORE_BASE_URL } from "../global/storeConfig";
+import { createCacheBusterInterceptor } from "../global/cacheBusterInterceptor";
+
+// Axios 全局配置
+export const axiosInstance = axios.create({
+  baseURL: APM_STORE_BASE_URL,
+  timeout: 5000, // 增加到 5 秒，避免网络波动导致的超时
+});
+
+// C2：数据 JSON（applist / categories / sidebar-config 等）追加 ?_t 版本戳，
+// 穿透 CDN 边缘缓存，确保返回最新列表。复用共享缓存穿透拦截器（带 TTL 复用戳，
+// 避免同会话频繁击穿缓存）。与主进程 onBeforeSendHeaders 注入的 no-cache 互为兜底。
+// 这是有意的缓存击穿策略（非缺陷），用于解决商店目录强缓存导致的更新延迟。
+axiosInstance.interceptors.request.use(createCacheBusterInterceptor());
+
+// 5xx / 网络错误 / 超时重试；4xx（如 404）快速失败
+const RETRYABLE_STATUS = new Set([502, 503, 504]);
+
+export const fetchWithRetry = async <T>(
+  path: string,
+  signal?: AbortSignal,
+  retries = 2,
+  retryDelayMs = 500,
+): Promise<T | null> => {
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      const resp = await axiosInstance.get<T>(path, { signal });
+      return resp.data;
+    } catch (err) {
+      const ae = err as AxiosError;
+      const status = ae.response?.status;
+      // 4xx（含 404）快速失败，不重试
+      if (status && status < 500 && status !== 429) {
+        return null;
+      }
+      // 仅对网络错误 / 5xx / 429 重试
+      const retryable =
+        !status || RETRYABLE_STATUS.has(status) || status === 429;
+      if (!retryable || attempt === retries) {
+        return null;
+      }
+      await new Promise((r) => setTimeout(r, retryDelayMs));
+    }
+  }
+  return null;
+};
+
+// 全局请求取消控制器（目录加载期间可整体取消）
+export const rootAbortController = new AbortController();
+
+// 给 Promise 包一层超时，超时即 reject。finally 中清理定时器，避免泄漏。
+export const withTimeout = async <T>(
+  promise: Promise<T>,
+  ms: number,
+  label = "operation",
+): Promise<T> => {
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  const timeout = new Promise<never>((_, reject) => {
+    timer = setTimeout(() => reject(new Error(`${label} 超时 (${ms}ms)`)), ms);
+  });
+  try {
+    return await Promise.race([promise, timeout]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+};
diff --git a/src/composables/useInstalledApps.ts b/src/composables/useInstalledApps.ts
new file mode 100644
index 00000000..69e545f2
--- /dev/null
+++ b/src/composables/useInstalledApps.ts
@@ -0,0 +1,367 @@
+/**
+ * useInstalledApps —— 已安装应用列表的查询、合并、卸载触发逻辑。
+ *
+ * 从原 App.vue 原样搬移（isInstalledAppInfo / LIST_INSTALLED_TIMEOUT_MS /
+ * resolveInstalledOrigins / refreshInstalledApps / mapInstalledAppToCatalogApp /
+ * refreshFavoriteInstalledApps / requestUninstall / openInstalledModal /
+ * closeInstalledModal / uninstallInstalledApp / installedCloudKeys /
+ * installedCloudPackageKeys），逻辑零改动。
+ *
+ * 共享状态来自 useAppState；withTimeout / rootAbortController 来自 useHttp。
+ */
+import { computed } from "vue";
+import type { App, InstalledAppInfo } from "../global/typedefinition";
+import {
+  apps,
+  installedApps,
+  installedLoading,
+  installedError,
+  installedWarning,
+  installedRefreshGeneration,
+  showInstalledModal,
+  sparkAvailable,
+  apmAvailable,
+  storeFilter,
+  showUninstallModal,
+  uninstallTargetApp,
+  syncCandidateApps,
+  availableSources,
+} from "./useAppState";
+import { withTimeout } from "./useHttp";
+import {
+  isOriginUsable,
+  isOriginEnabled,
+  getEffectiveStoreFilter,
+} from "../modules/storeFilter";
+import { cloudItemKey, cloudPackageKey } from "../modules/appListSync";
+import { removeDownloadItem } from "../global/downloadStatus";
+
+const isInstalledAppInfo = (value: unknown): value is InstalledAppInfo => {
+  if (!value || typeof value !== "object") return false;
+  const v = value as Record<string, unknown>;
+  return typeof v.pkgname === "string" && typeof v.origin === "string";
+};
+
+const LIST_INSTALLED_TIMEOUT_MS = 15000;
+
+// 根据当前启动模式和系统可用性，确定需要查询哪些 origin 的已安装应用
+const resolveInstalledOrigins = (): Array<"spark" | "apm"> => {
+  const origins: Array<"spark" | "apm"> = [];
+  if (isOriginUsable(storeFilter.value, "spark", availableSources.value)) {
+    origins.push("spark");
+  }
+  if (isOriginUsable(storeFilter.value, "apm", availableSources.value)) {
+    origins.push("apm");
+  }
+  return origins;
+};
+
+const refreshInstalledApps = async () => {
+  // 异步竞态防护：进入时若模态框已关闭（极小概率），直接放弃本轮请求
+  if (!showInstalledModal.value) return;
+  installedLoading.value = true;
+  installedError.value = "";
+  installedWarning.value = "";
+  // 代次计数器：每次进入自增；await 之后若代次已变（新一轮刷新 / 关闭重开），丢弃本轮结果
+  const generation = ++installedRefreshGeneration.value;
+  try {
+    const origins = resolveInstalledOrigins();
+    // Spark 已安装列表依赖商店目录（apps.value）来枚举包名。
+    // 仅当目录中存在可枚举的 Spark 包时才查询 Spark，
+    // 否则空目录会触发"全量扫描整个系统"的陷阱导致列表被全部跳过而误报为空。
+    const sparkPkgnameList = apps.value
+      .filter((a) => a.origin === "spark")
+      .map((a) => a.pkgname);
+    const effectiveOrigins = origins.filter(
+      (o) => o !== "spark" || sparkPkgnameList.length > 0,
+    );
+
+    if (effectiveOrigins.length === 0) {
+      installedApps.value = [];
+      // 目录尚未加载完成（但来源可用）时给出过渡提示，待目录加载后会自动重查
+      installedError.value =
+        apps.value.length === 0
+          ? "正在加载应用目录，请稍候…"
+          : "当前系统不可用应用管理功能";
+      return;
+    }
+
+    // 并行查询每个 origin 的已安装应用：
+    // 用 allSettled + 每源超时，避免单一来源（如 APM）响应慢/挂起阻塞整体；
+    // 超时或失败的来源在下方循环标记为 failedOrigin，不影响其它来源结果。
+    const results = await Promise.allSettled(
+      effectiveOrigins.map((origin) =>
+        withTimeout(
+          window.ipcRenderer.invoke("list-installed", {
+            origin,
+            pkgnameList: origin === "spark" ? sparkPkgnameList : undefined,
+          }),
+          LIST_INSTALLED_TIMEOUT_MS,
+          `${origin} list-installed`,
+        ),
+      ),
+    );
+
+    // 异步结束后的回调阶段重新校验代次与模态可见性，避免陈旧竞态写入 ref
+    if (generation !== installedRefreshGeneration.value) return;
+    if (!showInstalledModal.value) return;
+
+    const combinedApps: App[] = [];
+    // 同一 pkgname 可能同时以 APM 与 Spark 两种来源安装，这里聚合其来源集合
+    const originsByPkg = new Map<string, Set<"spark" | "apm">>();
+    const failedOrigins: string[] = [];
+
+    for (let i = 0; i < effectiveOrigins.length; i++) {
+      const origin = effectiveOrigins[i];
+      const settled = results[i];
+      // allSettled: rejected（超时/异常）或 success=false 都视为该来源失败
+      if (settled.status !== "fulfilled" || !settled.value?.success) {
+        failedOrigins.push(origin);
+        continue;
+      }
+      const result = settled.value;
+
+      const appList = Array.isArray(result?.apps) ? result.apps : [];
+      for (const rawApp of appList) {
+        // 运行时类型守卫，避免后端字段缺失造成下游访问 undefined 抛出
+        if (!isInstalledAppInfo(rawApp)) continue;
+        const app = rawApp;
+
+        // Find matching remote app to enrich data. We look exactly for that origin.
+        let appInfo = apps.value.find(
+          (a) => a.pkgname === app.pkgname && a.origin === origin,
+        );
+
+        if (origin === "spark" && !appInfo) {
+          // Only show Spark packages that exist in the App Store catalogue
+          continue;
+        }
+
+        if (appInfo) {
+          appInfo.flags = app.flags;
+          appInfo.arch = app.arch;
+          appInfo.currentStatus = "installed";
+          appInfo.isDependency = app.isDependency;
+        } else {
+          // 如果在当前应用列表中找不到该应用，创建一个最小的 App 对象
+          appInfo = {
+            name: app.name || app.pkgname,
+            pkgname: app.pkgname,
+            version: app.version,
+            category: "unknown",
+            tags: "",
+            more: "",
+            filename: "",
+            torrent_address: "",
+            author: "",
+            contributor: "",
+            website: "",
+            update: "",
+            size: "",
+            img_urls: [],
+            icons: app.icon || "",
+            origin: app.origin || (app.arch?.includes("apm") ? "apm" : "spark"),
+            currentStatus: "installed",
+            arch: app.arch,
+            flags: app.flags,
+            isDependency: app.isDependency,
+          };
+        }
+        // 合并同一 pkgname 在多个来源的安装记录为单条，避免列表出现重复项（相同 pkgname 键冲突）
+        const existingIdx = combinedApps.findIndex(
+          (a) => a.pkgname === appInfo.pkgname,
+        );
+        if (existingIdx === -1) {
+          combinedApps.push(appInfo);
+        }
+        // 记录该 pkgname 当前这一来源，供卸载时判断走 APM 还是 Spark
+        const originSet =
+          originsByPkg.get(appInfo.pkgname) ?? new Set<"spark" | "apm">();
+        originSet.add(origin);
+        originsByPkg.set(appInfo.pkgname, originSet);
+      }
+    }
+
+    // 将来源集合回写到每条已安装应用，供卸载时判断应走 APM 还是 Spark
+    for (const app of combinedApps) {
+      const set = originsByPkg.get(app.pkgname);
+      if (set) app.origins = Array.from(set);
+    }
+
+    installedApps.value = combinedApps;
+
+    // 部分来源失败使用轻量 warning（不与列表同时呈现红色致命错误条），致命/全失败仍用 error
+    if (failedOrigins.length > 0) {
+      const labels = failedOrigins
+        .map((o) => (o === "spark" ? "Spark" : "APM"))
+        .join("、");
+      if (combinedApps.length > 0) {
+        installedWarning.value = `部分来源加载失败（${labels}），已安装列表可能不完整`;
+      } else {
+        installedError.value = `读取${labels}已安装应用失败`;
+      }
+    }
+  } catch (error: unknown) {
+    if (generation !== installedRefreshGeneration.value) return;
+    if (!showInstalledModal.value) return;
+    installedApps.value = [];
+    installedError.value = (error as Error)?.message || "读取已安装应用失败";
+  } finally {
+    // 仅最末一代次负责清理 loading，防止陈旧代次提前关闭 loading 影响后续刷新
+    if (generation === installedRefreshGeneration.value) {
+      installedLoading.value = false;
+    }
+  }
+};
+
+const mapInstalledAppToCatalogApp = (
+  app: InstalledAppInfo,
+  origin: "spark" | "apm",
+): App | null => {
+  const appInfo = apps.value.find(
+    (catalogApp) =>
+      catalogApp.pkgname === app.pkgname && catalogApp.origin === origin,
+  );
+
+  if (origin === "spark" && !appInfo) {
+    return null;
+  }
+
+  if (appInfo) {
+    appInfo.flags = app.flags;
+    appInfo.arch = app.arch;
+    appInfo.currentStatus = "installed";
+    appInfo.isDependency = app.isDependency;
+    return appInfo;
+  }
+
+  return {
+    name: app.name || app.pkgname,
+    pkgname: app.pkgname,
+    version: app.version,
+    category: "unknown",
+    tags: "",
+    more: "",
+    filename: "",
+    torrent_address: "",
+    author: "",
+    contributor: "",
+    website: "",
+    update: "",
+    size: "",
+    img_urls: [],
+    icons: app.icon || "",
+    origin: app.origin || (app.arch?.includes("apm") ? "apm" : "spark"),
+    currentStatus: "installed",
+    arch: app.arch,
+    flags: app.flags,
+    isDependency: app.isDependency,
+  };
+};
+
+const refreshFavoriteInstalledApps = async (): Promise<void> => {
+  const origins: Array<"spark" | "apm"> = [];
+  if (isOriginEnabled(storeFilter.value, "spark") && sparkAvailable.value) {
+    origins.push("spark");
+  }
+  if (isOriginEnabled(storeFilter.value, "apm") && apmAvailable.value) {
+    origins.push("apm");
+  }
+
+  const refreshedApps: App[] = [];
+  await Promise.all(
+    origins.map(async (origin) => {
+      const pkgnameList =
+        origin === "spark"
+          ? apps.value
+              .filter((app) => app.origin === "spark")
+              .map((app) => app.pkgname)
+          : undefined;
+      const result = await window.ipcRenderer.invoke("list-installed", {
+        origin,
+        pkgnameList,
+      });
+      if (!result?.success) return;
+
+      const appList = Array.isArray(result?.apps) ? result.apps : [];
+      for (const rawApp of appList) {
+        // 运行时类型守卫：避免后端字段缺失时下游访问 undefined
+        if (!isInstalledAppInfo(rawApp)) continue;
+        const appInfo = mapInstalledAppToCatalogApp(rawApp, origin);
+        if (appInfo) refreshedApps.push(appInfo);
+      }
+    }),
+  );
+
+  const refreshedKeys = new Set(
+    refreshedApps.map((app) => `${app.origin}:${app.pkgname}`),
+  );
+  installedApps.value = [
+    ...installedApps.value.filter(
+      (app) =>
+        !origins.includes(app.origin) &&
+        !refreshedKeys.has(`${app.origin}:${app.pkgname}`),
+    ),
+    ...refreshedApps,
+  ];
+};
+
+const requestUninstall = (app: App) => {
+  uninstallTargetApp.value = app;
+  showUninstallModal.value = true;
+  removeDownloadItem(app.pkgname);
+};
+
+const openInstalledModal = () => {
+  if (
+    getEffectiveStoreFilter(storeFilter.value, availableSources.value) === null
+  ) {
+    return;
+  }
+
+  showInstalledModal.value = true;
+  refreshInstalledApps();
+};
+
+const closeInstalledModal = () => {
+  showInstalledModal.value = false;
+  // 关闭模态框时同步清空错误 / 警告，避免下次打开时残留过期状态
+  installedError.value = "";
+  installedWarning.value = "";
+};
+
+const uninstallInstalledApp = (app: App) => {
+  requestUninstall(app);
+};
+
+// 应用在更新中心/详情页的安装状态变更后，刷新已安装列表（由 App.vue 编排调用）
+const onUninstallSuccess = () => {
+  if (showInstalledModal.value) {
+    refreshInstalledApps();
+  }
+};
+
+// 已安装应用与云端同步候选用 key 集合（供恢复模态判断已装项）
+const installedCloudKeys = computed(
+  () => new Set(installedApps.value.map((app) => cloudItemKey(app))),
+);
+
+const installedCloudPackageKeys = computed(
+  () => new Set(syncCandidateApps.value.map((app) => cloudPackageKey(app))),
+);
+
+export {
+  isInstalledAppInfo,
+  LIST_INSTALLED_TIMEOUT_MS,
+  resolveInstalledOrigins,
+  refreshInstalledApps,
+  mapInstalledAppToCatalogApp,
+  refreshFavoriteInstalledApps,
+  requestUninstall,
+  openInstalledModal,
+  closeInstalledModal,
+  uninstallInstalledApp,
+  onUninstallSuccess,
+  installedCloudKeys,
+  installedCloudPackageKeys,
+};
diff --git a/src/composables/useRanking.ts b/src/composables/useRanking.ts
new file mode 100644
index 00000000..2c60436c
--- /dev/null
+++ b/src/composables/useRanking.ts
@@ -0,0 +1,218 @@
+/**
+ * useRanking —— 首页区域（links + 推荐列表入口）与下载排行榜数据。
+ *
+ * 从原 App.vue 原样搬移（loadHome / loadRanking / fetchDownloadCount / 缓存逻辑 /
+ * publishRanking），逻辑零改动。
+ *
+ * 共享状态（apps / homeLinks / apmRanking / sparkRanking / rankingLoading /
+ * homeLoading / homeError / storeFilter）来自 useAppState 单例。
+ */
+import type { App, HomeLink } from "../global/typedefinition";
+import {
+  apps,
+  homeLinks,
+  homeLoading,
+  homeError,
+  apmRanking,
+  sparkRanking,
+  rankingLoading,
+  storeFilter,
+} from "./useAppState";
+import { rootAbortController } from "./useHttp";
+import { APM_STORE_BASE_URL } from "../global/storeConfig";
+
+const DOWNLOAD_COUNT_CACHE_KEY = "spark-store:download-counts:v1";
+const DOWNLOAD_COUNT_CACHE_TTL_MS = 60 * 60 * 1000; // 1 小时
+
+interface CachedCount {
+  count: number;
+  ts: number;
+}
+
+const downloadCountCache = new Map<string, CachedCount>();
+
+const cacheKey = (app: App) => `${app.origin}:${app.category}:${app.pkgname}`;
+
+const loadCacheFromStorage = () => {
+  try {
+    const raw = localStorage.getItem(DOWNLOAD_COUNT_CACHE_KEY);
+    if (!raw) return;
+    const data = JSON.parse(raw) as Record<string, CachedCount>;
+    const now = Date.now();
+    for (const [k, v] of Object.entries(data)) {
+      if (now - v.ts < DOWNLOAD_COUNT_CACHE_TTL_MS) {
+        downloadCountCache.set(k, v);
+      }
+    }
+  } catch {
+    // ignore corrupted cache
+  }
+};
+
+const saveCacheToStorage = () => {
+  try {
+    const obj: Record<string, CachedCount> = {};
+    downloadCountCache.forEach((v, k) => {
+      obj[k] = v;
+    });
+    localStorage.setItem(DOWNLOAD_COUNT_CACHE_KEY, JSON.stringify(obj));
+  } catch {
+    // ignore quota errors
+  }
+};
+
+const fetchDownloadCount = async (app: App): Promise<number> => {
+  const key = cacheKey(app);
+  const cached = downloadCountCache.get(key);
+  if (cached) return cached.count;
+  const arch = window.apm_store.arch || "amd64";
+  const finalArch = app.origin === "spark" ? `${arch}-store` : `${arch}-apm`;
+  try {
+    const resp = await fetch(
+      `${APM_STORE_BASE_URL}/${finalArch}/${app.category}/${app.pkgname}/download-times.txt`,
+      { signal: rootAbortController.signal },
+    );
+    if (!resp.ok) return 0;
+    const text = (await resp.text()).trim();
+    const n = parseInt(text, 10);
+    const count = Number.isFinite(n) ? n : 0;
+    downloadCountCache.set(key, { count, ts: Date.now() });
+    return count;
+  } catch {
+    return 0;
+  }
+};
+
+const publishRanking = (results: App[]) => {
+  apmRanking.value = results
+    .filter((a) => a.origin === "apm")
+    .sort((x, y) => (y.downloadCount || 0) - (x.downloadCount || 0))
+    .slice(0, 10);
+  sparkRanking.value = results
+    .filter((a) => a.origin === "spark")
+    .sort((x, y) => (y.downloadCount || 0) - (x.downloadCount || 0))
+    .slice(0, 10);
+};
+
+let rankingGeneration = 0;
+
+const loadRanking = async () => {
+  if (apps.value.length === 0) return;
+  const gen = ++rankingGeneration;
+  rankingLoading.value = true;
+  const all = apps.value.slice();
+  const CONCURRENCY = 15;
+  const results: App[] = [];
+  for (let i = 0; i < all.length; i += CONCURRENCY) {
+    if (gen !== rankingGeneration) {
+      saveCacheToStorage();
+      return;
+    }
+    const batch = all.slice(i, i + CONCURRENCY);
+    const settled = await Promise.all(
+      batch.map(async (app) => ({
+        ...app,
+        downloadCount: await fetchDownloadCount(app),
+      })),
+    );
+    results.push(...settled);
+    // 边拉边发：每批完成后立即发布增量排名
+    if (gen === rankingGeneration) publishRanking(results);
+  }
+  if (gen !== rankingGeneration) {
+    saveCacheToStorage();
+    return;
+  }
+  rankingLoading.value = false;
+  saveCacheToStorage();
+};
+
+// 启动时即加载本地缓存（无需等待 apps），二次启动首屏即可见缓存排行
+loadCacheFromStorage();
+
+// 排行榜在 loadApps 全量完成后（onMounted）触发一次，确保 spark/apm 应用均已就绪
+
+const loadHome = async () => {
+  homeLoading.value = true;
+  homeError.value = "";
+  homeLinks.value = [];
+  try {
+    const arch = window.apm_store.arch || "amd64";
+    const modes: Array<"spark" | "apm"> =
+      storeFilter.value === "both" ? ["spark", "apm"] : [storeFilter.value];
+
+    // 按名称去重，spark 优先：同名链接 spark 覆盖 apm
+    const seenNames = new Set<string>();
+
+    // 并行请求各来源的 homelinks.json，缩短首页加载耗时
+    const modeResults = await Promise.all(
+      modes.map(async (mode) => {
+        const finalArch = mode === "spark" ? `${arch}-store` : `${arch}-apm`;
+        const base = `${APM_STORE_BASE_URL}/${finalArch}/home`;
+        try {
+          const res = await fetch(`${base}/homelinks.json`);
+          if (res.ok) return { mode, raw: (await res.json()) as unknown };
+        } catch (e) {
+          console.warn(`Failed to load ${mode} homelinks.json`, e);
+        }
+        return { mode, raw: undefined };
+      }),
+    );
+
+    for (const { mode, raw } of modeResults) {
+      if (!raw) continue;
+      // 校验 links 为数组，且每项均为对象（避免后端返回异常结构导致运行时错误）
+      const links = Array.isArray(raw)
+        ? (raw.filter((x) => x && typeof x === "object") as Record<
+            string,
+            unknown
+          >[])
+        : [];
+      for (const l of links) {
+        // 远程数据不可信，使用 typeof 运行时守卫替代 `as string` 断言，
+        // 避免非字符串字段（如数字/对象）被注入状态导致下游显示异常。
+        const name =
+          typeof l.Name === "string"
+            ? l.Name
+            : typeof l.name === "string"
+              ? l.name
+              : "";
+        if (!name) continue; // 跳过空名称，避免空字符串污染 seenNames 与去重逻辑
+        if (seenNames.has(name)) continue; // 已由更高优先级来源（spark）占据
+        // 仅校验 url 必需；远程 homelinks.json 不含 icon 字段（图片由 imgUrl 提供），
+        // 故 icon 不作为硬性校验，缺省为空串以兼容 HomeLink 类型。
+        const url =
+          typeof l.Url === "string"
+            ? l.Url
+            : typeof l.url === "string"
+              ? l.url
+              : "";
+        if (!url) continue;
+        const icon =
+          typeof l.Icon === "string"
+            ? l.Icon
+            : typeof l.icon === "string"
+              ? l.icon
+              : "";
+        seenNames.add(name);
+        // 显式提取已知字段构造，避免通过展开运算符 { ...l } 把远程不可信数据中的未知属性注入响应式状态
+        const safeLink: HomeLink = {
+          name,
+          url,
+          icon,
+          more: typeof l.more === "string" ? l.more : undefined,
+          imgUrl: typeof l.imgUrl === "string" ? l.imgUrl : undefined,
+          type: typeof l.type === "string" ? l.type : undefined,
+          origin: mode,
+        };
+        homeLinks.value.push(safeLink);
+      }
+    }
+  } catch (error: unknown) {
+    homeError.value = (error as Error)?.message || "加载首页失败";
+  } finally {
+    homeLoading.value = false;
+  }
+};
+
+export { loadHome, loadRanking };