chore(release): bump version to 5.3.1

fix(ui): 放大首页标题与启动提示，放开外部链接域名限制
!418 fix(store): 修复应用截图加载逻辑
2026-09-20 21:50:11 +08:00 · 2026-08-19 22:06:10 +08:00 · 2026-08-19 22:06:10 +08:00 · 2026-08-18 08:26:40 +00:00 · 2026-08-18 15:04:08 +08:00 · 2026-08-18 05:50:37 +00:00
198 changed files with 31440 additions and 6655 deletions
@@ -1,3 +1,4 @@
 VITE_APM_STORE_LOCAL_MODE=true
 VITE_APM_STORE_BASE_URL=/local_amd64-store
 VITE_APM_STORE_STATS_BASE_URL=/local_stats
 VITE_SPARK_BACKEND_BASE_URL=http://127.0.0.1:8000
@@ -1,2 +1,3 @@
-VITE_APM_STORE_BASE_URL=https://erotica.spark-app.store
+VITE_APM_STORE_BASE_URL=https://d.spark-app.store
 VITE_APM_STORE_STATS_BASE_URL=https://feedback.spark-app.store
 VITE_SPARK_BACKEND_BASE_URL=https://account.spark-app.store
@@ -1,143 +0,0 @@
 name: Build
 on:
  push:
    branches: [main]
    tags:
      - "*"
    paths-ignore:
      - "**.md"
      - "**.spec.js"
      - ".idea"
      - ".vscode"
      - ".dockerignore"
      - "Dockerfile"
      - ".gitignore"
      - ".github/**"
      - "!.github/workflows/build.yml"
      - "!.github/workflows/test.yml"
  pull_request:
    branches: [main]
    paths-ignore:
      - "**.md"
      - "**.spec.js"
      - ".idea"
      - ".vscode"
      - ".dockerignore"
      - "Dockerfile"
      - ".gitignore"
      - ".github/**"
      - "!.github/workflows/build.yml"
 permissions:
  contents: write
 jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v6
      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: 20
      - name: Install dependencies
        run: npm install
      - name: Run tests
        run: npm run test
      - name: Run lint
        run: npm run lint
  build:
    needs: test
    runs-on: ${{ matrix.os }}
    container: ${{ matrix.docker_image }}
    strategy:
      matrix:
        os: [ubuntu-latest]
        package: [deb, rpm]
        architecture: [x64, arm64]
        include:
          - package: deb
            docker_image: "debian:12"
          - package: rpm
            docker_image: "almalinux:8"
    steps:
      - name: Install Build Dependencies
        if: matrix.package == 'deb'
        run: |
          apt-get update
          apt-get install -y curl git wget devscripts fakeroot equivs lintian python3
          apt-get install -y build-essential
      - name: Install Build Dependencies
        if: matrix.package == 'rpm'
        run: |
          dnf install -y curl git wget rpm-build rpmdevtools rpmlint python3
          dnf group install -y "Development Tools"
      - name: Checkout Code
        uses: actions/checkout@v6
      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: 20
      - name: Install Dependencies
        run: |
          npm install
      - name: Download host-spawn
        shell: bash
        run: |
          if [ "${{ matrix.architecture }}" == "x64" ]; then
            curl -fsSL -o ./extras/host-spawn https://github.com/1player/host-spawn/releases/latest/download/host-spawn-x86_64
          elif [ "${{ matrix.architecture }}" == "arm64" ]; then
            curl -fsSL -o ./extras/host-spawn https://github.com/1player/host-spawn/releases/latest/download/host-spawn-aarch64
          fi
          chmod +x ./extras/host-spawn
      - name: Build Release Files
        shell: bash
        run: |
          if [ "${{ matrix.package }}" == "deb" ]; then
            npm run build:deb -- --${{ matrix.architecture }}
          elif [ "${{ matrix.package }}" == "rpm" ]; then
            npm run build:rpm -- --${{ matrix.architecture }}
          fi
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      - name: Upload Artifact
        uses: actions/upload-artifact@v6
        with:
          name: release_for_${{ matrix.package }}_${{ matrix.architecture }}
          path: release/**/*.${{ matrix.package }}
          retention-days: 5
  release:
    needs: build
    runs-on: ubuntu-latest
    if: startsWith(github.ref, 'refs/tags/')
    steps:
      - name: Download all artifacts
        uses: actions/download-artifact@v7
        with:
          path: artifacts
      - name: Upload to GitHub Release
        uses: softprops/action-gh-release@v2
        with:
          tag_name: ${{ github.ref_name }}
          files: |
            artifacts/**/*.deb
            artifacts/**/*.rpm
          generate_release_notes: true
@@ -1,83 +0,0 @@
 name: Test
 on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main, develop]
 jobs:
  unit-tests:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v6
      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: 20
      - name: Install dependencies
        run: npm install
      - name: Run unit tests
        run: npm run test -- --coverage
      - name: Upload coverage to Codecov
        uses: codecov/codecov-action@v4
        with:
          files: ./coverage/lcov.info
          flags: unittests
          name: codecov-umbrella
  e2e-tests:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v6
      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: 20
      - name: Install dependencies
        run: npm install
      - name: Install Playwright Browsers
        run: npx playwright install --with-deps chromium
      - name: Run E2E tests
        run: xvfb-run npm run test:e2e
      - name: Upload test results
        if: always()
        uses: actions/upload-artifact@v6
        with:
          name: playwright-report
          path: playwright-report/
          retention-days: 30
  lint:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v6
      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: 20
      - name: Install dependencies
        run: npm install
      - name: Run ESLint
        run: npm run lint
      - name: Check formatting
        run: npm run format -- --check
@@ -14,6 +14,17 @@ dist-electron
 release
 *.local
 # Nix build outputs
 /result
 /result-*
 # Local secrets and databases
 .env
 .env.*.local
 *.sqlite
 *.sqlite3
 *.db
 # Test coverage
 coverage
 .nyc_output
@@ -40,3 +51,20 @@ yarn.lock
 test-results.json
 .worktrees/
 .superpowers/
 # VSCode CMake Extension
 build/*
 # Debian build intermediates
 debian/*.log
 debian/*.substvars
 debian/*.debhelper
 debian/debhelper-build-stamp
 debian/files
 debian/tmp/
 debian/.debhelper/
 debian/spark-store/
 # AI working memory (跨会话上下文，不进入上游)
 .codebuddy/
@@ -30,6 +30,7 @@
      // },
      "runtimeArgs": [
        "--remote-debugging-port=9229",
        "--no-sandbox",
        "."
      ],
      "envFile": "${workspaceFolder}/.vscode/.debug.env",
@@ -695,6 +695,23 @@ npm run build:rpm    # 仅构建 RPM 包
 - `dist/` - 编译的渲染器资源
 - 打包的应用在项目根目录
 ### 测试打包脚本（开发过程统一使用）
 开发 / 自测阶段的打包**一律使用测试脚本 `scripts/test-build.sh`**，不要直接手敲 `dpkg-buildpackage`：
 ```bash
 ./scripts/test-build.sh
 ```
 脚本行为：
 - 自动读取 `debian/changelog` 顶部的 deb 版本号（如 `5.2.1.0`），将**最后一段数字 +1** 并追加 `-test` 修订号（如 `5.2.1.1-test`）。
 - 每次运行版本递增（`5.2.1.1-test` → `5.2.1.2-test` → …），产物形如 `spark-store_5.2.1.X-test_amd64.deb`，与正式发版版本区分。
 - 自动设置 `ELECTRON_MIRROR` 镜像（`https://registry.npmmirror.com/-/binary/electron/`）后执行 `dpkg-buildpackage -us -uc -b`。
 - 仅修改 `debian/changelog`，不改 `package.json`（electron-builder 的 dir 产物版本由 `package.json` 决定，不影响 deb 文件名）。
 > 注意：每次运行会改写 `debian/changelog`（未跟踪的工作区改动），测试完成后按需自行还原为正式版本。
 ### 构建配置
 **electron-builder.yml:**
@@ -1,3 +1,24 @@
 ## [未发布 / Unreleased] (Erotica 分支，基于 1e60a4c2 之后)
 本批改动汇总（自提交 `1e60a4c2` 起）：
 1. **已安装应用新增搜索框 + 窗口尺寸/位置持久化**：补齐已安装面板的应用搜索框；主窗口大小、位置、最大化状态写入本地 `window-state.json` 持久化，并限制最小尺寸 800×500。
 2. **已安装列表健壮性加固**：修复异步竞态、错误 UX、加载状态处理与刷新防抖（多轮 AI 审查改进），并清理对应代码缩进与对齐。
 3. **各页面滚动条贴边修复**：避免滚动栏被窗口圆角裁切。
 4. **投稿应用窗口圆角虚影修复**：消除投稿弹窗圆角处的方角残影。
 5. **已安装应用来源筛选与排序优化**：将头部 APM / Spark / 总数三段式统计徽章改为可点击，点击后按来源筛选（默认显示全部）；列表默认 APM 应用置顶；新增"暂无已安装的 APM/Spark 应用"空状态提示，避免筛选无结果时出现空引号。
 6. **AI 代码审查安全加固**：
   - `launch-app` IPC 移除 `any`，新增包名正则校验（`/^[a-zA-Z0-9._+-]+$/`），拦截非法输入防止命令注入。
   - `getIconUrl` 本地图标路径增加白名单目录校验与路径遍历（`..`）防护。
   - `fetchWithRetry` 仅对网络错误 / 5xx / 超时重试，4xx 快速失败。
   - `AppGrid` 普通网格 `v-for` 的 `:key` 由 `index` 改为 `app.pkgname`。
   - `loong64` 架构下尊重 `--no-spark` 启动参数，不再硬编码覆盖。
   - `openDownloadedApp` 的 IPC 调用补充 `.catch` 错误处理。
 7. **应用详情默认展开已安装版本**：打开应用详情时，若本地只安装了 Spark / APM 中的某一版本，则默认展开该已装来源（例如 WeChat 默认 APM，但本机只装 Spark 版时默认展开 Spark）；若两版都已安装，则按优先级/标签策略展示。
 相关提交：`1d9d25d6`、`c75938aa`、`39a358bb`、`51473cac`、`cf0e72ff`、`b0d60737`、`d3705ed4`。
 ## [1.1.1](https://github.com/elysia-best/apm-app-store/compare/v1.1.0...v1.1.1) (2026-02-17)
@@ -0,0 +1,50 @@
 .DEFAULT_GOAL := build
 clean:
 	rm -rf release/
 	rm -f lightningcss-linux-loong64-gnu.tgz
 	rm -f tailwindcss-oxide-linux-loong64-gnu.tgz
 build:
 ifeq (${DEB_HOST_ARCH},loong64)
 	# Install oxide for loongarch64
 	curl -fsSL https://github.com/loong64/tailwindcss/releases/download/v4.3.2/tailwindcss-oxide-linux-loong64-gnu.tgz -o tailwindcss-oxide-linux-loong64-gnu.tgz
 	mkdir -p $(CURDIR)/node_modules/@tailwindcss/oxide-linux-loong64-gnu
 	tar xf tailwindcss-oxide-linux-loong64-gnu.tgz -C $(CURDIR)/node_modules/@tailwindcss/oxide-linux-loong64-gnu --strip-components 1
 	rm tailwindcss-oxide-linux-loong64-gnu.tgz
 	# Install lightningcss-linux-loong64-gnu for loongarch64
 	curl -fsSL https://github.com/loong64/lightningcss/releases/download/v1.32.0/lightningcss-linux-loong64-gnu-1.32.0.tgz -o lightningcss-linux-loong64-gnu.tgz
 	mkdir -p $(CURDIR)/node_modules/lightningcss-linux-loong64-gnu
 	tar xf lightningcss-linux-loong64-gnu.tgz -C $(CURDIR)/node_modules/lightningcss-linux-loong64-gnu --strip-components 1
 	rm lightningcss-linux-loong64-gnu.tgz
 	npm run build:loong64
 else
 	npm run build
 endif
 install:
 	mkdir -p $(DESTDIR)/opt/spark-store/bin/
 	mkdir -p $(DESTDIR)/opt/spark-store/extras/
 	mkdir -p $(DESTDIR)/opt/durapps/spark-store/bin/
 	mkdir -p $(DESTDIR)/usr/share/icons/
 	mkdir -p $(DESTDIR)/usr/lib/
 	mkdir -p $(DESTDIR)/usr/bin/
 	mkdir -p $(DESTDIR)/etc/apt/
 	mkdir -p $(DESTDIR)/lib/systemd/
 	mkdir -p $(DESTDIR)/tmp/
 	cp -rv release/*/linux*-unpacked/* $(DESTDIR)/opt/spark-store/bin/
 	cp -rv release/*/linux*-unpacked/extras/* $(DESTDIR)/opt/spark-store/extras/
 	cp -rv tool/* $(DESTDIR)/opt/durapps/spark-store/bin/
 	cp -rv pkg/usr/share/fish/ $(DESTDIR)/usr/share/
 	cp -rv icons/hicolor/ $(DESTDIR)/usr/share/icons/
 	cp -rv pkg/usr/share/icons/hicolor/ $(DESTDIR)/usr/share/icons/
 	cp -rv pkg/usr/lib/systemd $(DESTDIR)/usr/lib/
 	cp -rv pkg/usr/share/applications/ $(DESTDIR)/usr/share/
 	cp -rv pkg/usr/share/polkit-1 $(DESTDIR)/usr/share/
 	cp -rv pkg/usr/share/aptss $(DESTDIR)/usr/share/
 	cp -rv pkg/usr/share/ssinstall/ $(DESTDIR)/usr/share/
 	cp -rv pkg/usr/share/ssinstall-local/ $(DESTDIR)/usr/share/
 	cp -rv pkg/usr/share/dsg/ $(DESTDIR)/usr/share/
 	cp -rv pkg/usr/share/bash-completion/ $(DESTDIR)/usr/share/
 	cp -rv tool/spark-store.asc $(DESTDIR)/opt/durapps/spark-store/bin/
 #	ln -s ../../../spark-store/extras/spark-store $(DESTDIR)/opt/durapps/spark-store/bin/spark-store
@@ -18,7 +18,7 @@ Linux 应用的数量相对有限，Wine 软件的可获取性也颇为困难。
 **当前支持的 Linux 发行版包括（但不限于）：**
- **amd64 架构：** Debian 10+ / Ubuntu 22.04+ / Arch Linux / Fedora / deepin / UOS / 银河麒麟 
+- **amd64 架构：** Debian 10+ / Ubuntu 22.04+ / Arch Linux / Fedora / deepin / UOS / 银河麒麟 / NixOS
 - **arm64 架构：** Debian 10+ / Ubuntu 22.04+ / Arch Linux / deepin / UOS / 银河麒麟 
 - **loong64 架构：** deepin 23/25
@@ -0,0 +1,84 @@
 # 侧边栏入口配置 (Sidebar Config)
 星火应用商店支持通过服务器上的 JSON 文件动态配置左侧侧边栏的入口项。
 ## 配置文件位置
 将 `sidebar-config.json` 放置在服务器应用仓库的架构目录下：
 ```
 # Spark 仓库
 {baseUrl}/{arch}-store/sidebar-config.json
 # APM 仓库  
 {baseUrl}/{arch}-apm/sidebar-config.json
 ```
 例如：
 - `https://example.com/amd64-store/sidebar-config.json`
 - `https://example.com/arm64-store/sidebar-config.json`
 ## JSON 格式
 每个入口项为一个对象，包含以下字段：
 | 字段 | 类型 | 必填 | 说明 |
 |------|------|------|------|
 | `id` | string | ✅ | 唯一标识符，对应分类名或自定义 ID |
 | `name` | string | ✅ | 侧边栏显示的入口名称 |
 | `icon` | string | ❌ | FontAwesome 图标类名，如 `fas fa-gamepad` |
 | `type` | string | ❌ | 入口类型：`category`（分类筛选）、`search`（搜索关键词）、`link`（外部链接）。默认为 `category` |
 | `value` | string | ❌ | 与 `type` 配合使用的值。`category` 类型为分类名，`search` 类型为搜索关键词。默认为 `id` 的值 |
 ## 示例配置
 ```json
 [
  {
    "id": "games",
    "name": "游戏专区",
    "icon": "fas fa-gamepad",
    "type": "category",
    "value": "games"
  },
  {
    "id": "devtools",
    "name": "开发工具",
    "icon": "fas fa-code",
    "type": "category",
    "value": "development"
  },
  {
    "id": "office",
    "name": "办公学习",
    "icon": "fas fa-book",
    "type": "category",
    "value": "office"
  },
  {
    "id": "ai-search",
    "name": "AI 应用",
    "icon": "fas fa-robot",
    "type": "search",
    "value": "AI"
  }
 ]
 ```
 ## 入口类型说明
 ### `category` 类型
 点击后在"全部应用"页面按指定分类筛选应用。`value` 字段对应 `categories.json` 中的分类键名。
 ### `search` 类型
 点击后自动使用 `value` 字段的值进行搜索。适用于快速入口，如"AI 应用"、"微信"等热门关键词。
 ### `link` 类型（预留）
 用于跳转到外部链接或内部页面。后续版本支持。
 ## 注意事项
 - 如果两个仓库（Spark 和 APM）都存在 `sidebar-config.json`，相同的 `id` 会自动去重合并
 - 配置文件不存在时，侧边栏不会显示额外的入口项，不影响正常使用
 - 入口项显示在"首页推荐"和"全部应用"之间，以分隔线区分
 - 每个入口项会显示对应分类或搜索下的应用数量
@@ -0,0 +1,5 @@
 spark-store (5.3.1) UNRELEASED; urgency=medium
  * Initial release.
 -- shenmo <shenmo@spark-app.store>  Fri, 14 Aug 2026 15:14:01 +0800
@@ -0,0 +1,39 @@
 Source: spark-store
 Section: utils
 Priority: optional
 Maintainer: shenmo <shenmo@spark-app.store>
 Rules-Requires-Root: no
 Build-Depends:
 debhelper-compat (= 13),
 make,
 Standards-Version: 4.7.2
 Homepage: https://www.spark-app.store/
 Package: spark-store
 Architecture: any
 Provides: spark-store-console-in-container
 Depends:
 ${shlibs:Depends},
 ${misc:Depends},
 libgtk-3-0,
 libnotify4, 
 libnss3, 
 libxss1, 
 libxtst6, 
 xdg-utils, 
 libatspi2.0-0, 
 libuuid1, 
 libsecret-1-0, 
 xdg-utils, 
 shared-mime-info, 
 aria2, 
 gnupg, 
 zenity, 
 policykit-1 | pkexec, 
 libnotify-bin, 
 desktop-file-utils, 
 lsb-release, 
 systemd, 
 curl
 Description: Spark Store
 A community powered app store, powered by APM.
@@ -0,0 +1,81 @@
 #!/bin/bash
 case "$1" in
 	configure)
 		case `arch` in
   			x86_64)
 				echo "Enabling i386 arch..."
 				dpkg --add-architecture i386
 			;;
        		aarch64)
        			echo "Will not enable armhf since 4271"
 			;;
            loongarch64)
 				echo "Nope we DO NOT WANT ABI1 now"
 				dpkg --remove-architecture loongarch64
 			;;
 			*)
 				echo "Unknown architecture, skip enable 32-bit arch"
 			;;
 		esac
 		mkdir -p /var/lib/aptss/lists
 		#  Remove the sources.list file
 		rm -f /etc/apt/sources.list.d/sparkstore.list
        rm -f /opt/durapps/spark-store/bin/apt-fast-conf/sources.list.d/sparkstore.list
 		# Check if /usr/local/bin existed
 		mkdir -p /usr/local/bin
 		## I hate /usr/local/bin. We will abandon them later
 		# Create symbol links for binary files
 		ln -s -f /opt/durapps/spark-store/bin/spark-store /usr/local/bin/spark-store
 		ln -s -f /opt/durapps/spark-store/bin/ssinstall /usr/local/bin/ssinstall
 		ln -s -f /opt/durapps/spark-store/bin/ssaudit /usr/local/bin/ssaudit
 		ln -s -f /opt/durapps/spark-store/bin/ssinstall /usr/bin/ssinstall
 		ln -s -f /opt/durapps/spark-store/bin/ssaudit /usr/bin/ssaudit
 		ln -s -f /opt/durapps/spark-store/bin/spark-dstore-patch /usr/local/bin/spark-dstore-patch
 		ln -s -f /opt/durapps/spark-store/bin/spark-dstore-patch /usr/bin/spark-dstore-patch
 		ln -s -f /opt/durapps/spark-store/bin/aptss /usr/local/bin/ss-apt-fast
 		ln -s -f /opt/durapps/spark-store/bin/aptss /usr/bin/aptss
 		# Install key
 		mkdir -p /tmp/spark-store-install/
 		cp -f /opt/durapps/spark-store/bin/spark-store.asc /tmp/spark-store-install/spark-store.asc
 		gpg --dearmor /tmp/spark-store-install/spark-store.asc
 		cp -f /tmp/spark-store-install/spark-store.asc.gpg /etc/apt/trusted.gpg.d/spark-store.gpg
 		# Start upgrade detect service
 		systemctl daemon-reload
 		systemctl enable spark-update-notifier
 		systemctl start spark-update-notifier
 		# like apt-daily.timer
 		systemctl enable spark-update-notifier.timer
 		systemctl start spark-update-notifier.timer
 		# Update certain caches
 cp -fv /opt/spark-store/extras/store.spark-app.spark-store.policy /usr/share/polkit-1/actions/store.spark-app.spark-store.policy
 xdg-mime default spark-store.desktop x-scheme-handler/spk
 update-mime-database /usr/share/mime || true
 		# Send email for statistics
 		#/tmp/spark-store-install/feedback.sh
 		# Remove temp dir
 		rm -rf /tmp/spark-store-install
 	;;
 	triggered)
 			spark-dstore-patch
 	;;
 esac
@@ -0,0 +1,7 @@
 #!/bin/bash
 rm -fv /usr/share/polkit-1/actions/store.spark-app.spark-store.policy
 # Update certain caches
 update-icon-caches /usr/share/icons/hicolor || true
 update-desktop-database /usr/share/applications || true
 update-mime-database /usr/share/mime || true
@@ -0,0 +1,28 @@
 #!/bin/bash
 #检测网络链接畅通
 function network-check()
 {
    #超时时间
    local timeout=15
    #目标网站
    local target=www.baidu.com
    #获取响应状态码
    local ret_code=`curl -I -s --connect-timeout ${timeout} ${target} -w %{http_code} | tail -n1`
    if [ "x$ret_code" = "x200" ]; then
        echo "Network Checked successful ! Continue..."
 	 echo "网络通畅，继续安装"
    else
        #网络不畅通
 	echo "Network failed ! Cancel the installation"
 	echo "网络不畅，终止安装"
 	exit -1
    fi
 }
 #network-check
 echo "不再检测网络"
@@ -0,0 +1,64 @@
 #!/bin/bash
 function notify-send()
 {
    # Detect the user using such display
    local user=$(who | awk '{print $1}' | head -n 1)
    # Detect the id of the user
    local uid=$(id -u $user)
    sudo -u $user DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/$uid/bus notify-send "$@"
 }
 if [ "$1" = "remove" -o "$1" = "purge" ] ; then
 	echo "$1"
 	echo "卸载操作，进行配置清理"
 	# Remove residual symbol links
 	unlink /usr/local/bin/spark-store
 	unlink /usr/local/bin/ssinstall
 	unlink /usr/local/bin/ssaudit
 	unlink /usr/bin/ssinstall
 	unlink /usr/bin/ssaudit
 	unlink /usr/local/bin/spark-dstore-patch
 	unlink /usr/bin/spark-dstore-patch
 	unlink /usr/local/bin/ss-apt-fast
 	unlink /usr/bin/aptss
 	rm -rf /etc/aptss/
 	rm -rf /var/lib/aptss/
 	# Remove residual symbol links to stop upgrade detect
 	rm -f /etc/xdg/autostart/spark-update-notifier.desktop
 	# Remove config files
 for username in `ls /home`      
    do
      echo /home/$username
        if [ -d /home/$username/.config/spark-union/spark-store ]
        then
        rm -rf /home/$username/.config/spark-union/spark-store
        fi
    done
 	# Shutdown services
 	systemctl stop spark-update-notifier
 	# Stop update detect service
 	systemctl disable spark-update-notifier
 	# Remove gpg key file
 	rm -f /etc/apt/trusted.gpg.d/spark-store.gpg
 	apt-key del '9D9A A859 F750 24B1 A1EC  E16E 0E41 D354 A29A 440C' || true
 else
 	if [ ! -z "`pidof spark-store`" ] ; then
 		echo "关闭已有 spark-store.."
 		notify-send "正在升级星火商店" "请在升级结束后重启星火商店" -i spark-store
 		killall spark-store
 	fi
 fi
@@ -0,0 +1,34 @@
 #!/usr/bin/make -f
 # See debhelper(7) (uncomment to enable).
 # Output every command that modifies files on the build system.
 #export DH_VERBOSE = 1
 # See FEATURE AREAS in dpkg-buildflags(1).
 #export DEB_BUILD_MAINT_OPTIONS = hardening=+all
 # See ENVIRONMENT in dpkg-buildflags(1).
 # Package maintainers to append CFLAGS.
 #export DEB_CFLAGS_MAINT_APPEND  = -Wall -pedantic
 # Package maintainers to append LDFLAGS.
 #export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed
 %:
 	dh $@
 override_dh_dwz:
 	true
 override_dh_strip:
 	true
 override_dh_shlibdeps:
 	true
 # dh_make generated override targets.
 # This is an example for Cmake (see <https://bugs.debian.org/641051>).
 #override_dh_auto_configure:
 #	dh_auto_configure -- \
 #	-DCMAKE_LIBRARY_PATH=$(DEB_HOST_MULTIARCH)
@@ -0,0 +1 @@
 3.0 (quilt)
@@ -0,0 +1,2 @@
 interest-noawait /opt/apps
@@ -0,0 +1,2 @@
 1、将标题栏变宽一点，现在加入了搜索栏，太窄了不好看
 2、在贡献排行中，点击对应的贡献用户，可以查看用户下所有的应用（可能需要模糊查询）
@@ -0,0 +1,268 @@
 # 应用列表缓存导致"新应用上架后搜不到"的根因分析与设计方案
 > App List Cache Analysis & Design (spark-store)
 > 整理日期：2026-08-11
 > 背景分支：`Erotica`
 > 文档涵盖：① 列表缓存根因与修复（C1/C2）；② 下载日志断层修复（附加）
 ---
 ## 0. 现象（用户反馈）
 - 服务端上新应用后，在商店内**搜不到**该应用。
 - 直觉认为是 `~/.cache` 下的本地缓存导致，但实测并非如此。
 - 进一步反馈：**重启应用也无效，只有"删除缓存"才行**——这指向缓存层在重启后仍返回陈旧数据。
 ---
 ## 1. 缓存层逐层排查
 | 缓存层 | 是否存在 | 证据 | 是否导致本问题 |
 |---|---|---|---|
 | **① 内存（渲染进程 `apps` 数组）** | 是 | 搜索基于内存 `baseApps`（`App.vue:665`）；`loadApps` 仅在 `onMounted` 调用一次（`App.vue:3447`） | 是（叠加因素）：运行期不刷新，新应用不在内存 |
 | **② 本地磁盘"应用列表"文件缓存** | **否** | 源码无 `writeFile(applist)`；`~/.config/spark-store/` 下无应用列表缓存文件 | 否（用户最初怀疑点，已排除） |
 | **③ Chromium 网络磁盘缓存** | **是（关键）** | 渲染进程 `axios` 走 XHR，受 Chromium 网络栈影响；`~/.config/spark-store/Cache` 目录存在 | **是**：重启后请求命中该磁盘缓存，返回旧 `applist.json` |
 | **④ CDN 边缘缓存** | **是（关键）** | 生产域名 `erotica.spark-app.store` 挂 CDN；静态 `applist.json` 被边缘缓存；代码未发 `no-cache` | **是**：即使穿透③，CDN 仍可能返回边缘陈旧副本 |
 ### 请求侧缓存控制现状（代码事实）
 - `fetchWithRetry`（`App.vue:432`）：`axiosInstance.get(url, { signal })`，**无任何 `Cache-Control` 头**。
 - `axiosInstance`（`App.vue:427`）：仅 `baseURL` + `timeout`，无 headers。
 - 主进程 `onBeforeSendHeaders`（`electron/main/index.ts:653`）：只注入 `User-Agent`，**未注入 `Cache-Control: no-cache`**。
 - `loadApps`（`App.vue:3216`）：`apps.value.push(...)` —— **append 模式、无去重、无重置**，重跑会累积重复。
 - `loadTabApps`（`App.vue:3098`）：`if (tabApps.value[entryId]) return;` —— **已加载分类强缓存，永不重拉**。
 - `loadCategories`（`App.vue:3430`）：`categories.json` 仅启动时加载一次；若为"新分类"则永不加载其 `applist.json`。
 ---
 ## 2. 根因结论（实测修正）
 > **2026-08-11 实测修正**：曾假设"CDN 边缘主动缓存"，curl 实测远程 `applist.json` 响应头为 `server: nginx` + `etag` + `last-modified`，**无任何 `Cache-Control`/`Expires`/`Age`**。因此真因是 **nginx 未发缓存控制头 → Chromium 启发式缓存（heuristic caching）**，而非 CDN 主动边缘缓存。
 **主因（解释"重启无效、删除才行"）—— Chromium 启发式缓存：**
 > 对"无 Cache-Control 头"的响应，Chromium 按 `Last-Modified` 计算启发式 TTL ≈ `(now - LM)/10`。实测当前文件 `LM` 距今约 7.6h → TTL ≈ **46 分钟**。在此窗口内：
 > - 重启应用 → 重新发请求 → Chromium 直接复用 `~/.config/spark-store/Cache` 旧副本（启发式视为"新鲜"）→ 返回**旧 JSON** → 新应用搜不到。
 > - 只有**删除 `~/.config/spark-store/Cache`** 强制失效，才可能拿到新内容。
 > 这与"重启无效、删缓存才行"的现象**精确吻合**。
 **叠加因素（解释"运行期搜不到"）：**
 > `loadApps` 仅在启动时加载一次、且 `loadTabApps` 对已加载分类强缓存，运行期内存数据不会自动更新。即便请求能穿透缓存，也需重启/手动触发才进入内存。
 **次要因素（条件触发）：**
 > 若新应用落入 `categories.json` 尚未包含的**新分类**，`loadApps` 遍历 `categories.value` 不会请求该分类，连重启都搜不到，需等 `categories.json` 同步。
 > 说明：用户最初怀疑的"~/.cache 应用列表文件缓存"**不存在**；真因是 nginx 无 CC 头导致的 Chromium 启发式缓存（③层的精确机理），其陈旧表现与"文件缓存"一致，故被误判。
 ### 2.1 实测证据（curl / Node，2026-08-11）
 - `curl -sI` 远程 `applist.json`：`HTTP/2 200`、`server: nginx`、`etag: "6a7a764e-2f9d8"`、`last-modified: Tue, 11 Aug 2026 01:09:34 GMT`，**无 `cache-control`/`expires`/`age`**。
 - Node 计算：LM 距今 ≈ 27572s → 启发式 TTL ≈ 2757s ≈ **46 分钟**（窗口内重启命中陈旧副本）。
 - `curl -H "Cache-Control: no-cache"` 仍 `200` 正常 → 客户端带 no-cache 即不再复用陈旧副本，证明 **C1 修复方向正确**。
 - 带 `?_t=Date.now()` 的 URL 经 `new URL()` 解析合法（pathname 正确、search 为 `_t=...`）→ **C2 修复方向正确**。
 ---
 ## 3. 设计方案（最终版 · 已整合 7 维审计）
 > 设计原则：**精准根治 + 配套必补项齐全 + 不过度设计**。
 > 改动分两类——**核心（绕过缓存层，根治）** 与 **辅助（主动刷新体验）**；其中辅助项含 5 个**必补配套**，否则功能/可靠性打折（详见第 4 节审计结论）。
 ### 3.1 核心（根治"重启/删除才有效"）—— 绕过缓存层
 > 目标：列表/分类请求**永远拿最新**，不依赖删除缓存目录。
 - **C1 请求头禁用缓存**
  - `fetchWithRetry` 对数据 JSON 请求加 `headers: { 'Cache-Control': 'no-cache', Pragma: 'no-cache' }`。
  - 主进程 `electron/main/index.ts:653` 的 `onBeforeSendHeaders` 中，**仅对 `applist.json` / `categories.json` / `priority-config.json` 路径**注入 `Cache-Control: no-cache`（scope 严格过滤，绝不影响 `cdn.d.store...` 图标/截图加速）。双保险覆盖所有请求路径。
 - **C2 URL 版本 bust（穿透 CDN 边缘缓存最稳手段）**
  - 对上述数据请求 URL 追加 `?_t=${Date.now()}`，使每次 URL 不同，CDN 边缘与 Chromium 均无缓存可命中。
  - 代价：每次穿透 CDN，但列表文件小、频率低（启动/聚焦/手动），可接受。
  - **兼容性确认项**：上线前需在测试环境确认 `erotica.spark-app.store` 的 CDN 对含 query 的静态路径行为正常（极少数 CDN 有特殊规则）；若有异常，回退为仅依赖 `no-cache` 或 path 版本戳。
 ### 3.2 辅助（主动刷新体验）—— 让用户无需重启即拿最新
 > 前提：3.1 已绕过缓存层。否则刷新也拿不到新数据。
 - **A1 `loadApps` 幂等重建（必做，刷新安全前提）**
  - 将 `App.vue:3216` 的 `apps.value.push` 改为：每个分类结果收集进 `Map<pkgname, App>`（复用现有 hybrid 合并逻辑），**该分类加载完即 `apps.value = [...map.values()]`**——保留增量提交（首个分类成功即关遮罩，不回退首屏体验），同时对所有模式（含 spark-only/apm-only）去重，反而比现状更稳。
 - **A2 `refreshAppData()` 编排**
  - 提取 `await loadCategories()`（本身重建安全，`App.vue:2946`）+ 重跑改造后的 `loadApps()`。覆盖主因与次要因素（新分类一并刷新）。
 - **A3 两个刷新入口**
  - **窗口聚焦（经主进程，非渲染 window focus）**：主进程 `win.on('focus')` → `webContents.send('window-focus')` → 渲染监听调用 `refreshAppData()`（Electron 无边框窗口的渲染 `window focus` 事件不一定可靠，必须走 IPC 才稳）。
  - **手动刷新按钮**：工具栏/侧边栏加刷新图标，调用 `refreshAppData()`。
 ### 3.3 必补配套（5 项，缺一不可）
 | 编号 | 维度 | 配套项 | 解决风险 |
 |---|---|---|---|
 | **P1** | 功能正确 | A1 改造时**保留每分类增量提交** + 非 hybrid 也按 pkgname 去重 | 防首屏回退、防重复应用 |
 | **P2** | 可靠性 | `refreshAppData`/`loadApps` 加**串行化守卫**（in-flight 合并或 `isRefreshing` 标志） | 防焦点/手动/启动并发竞态覆盖（`loadApps` 当前无锁，已确认） |
 | **P3** | 可靠性 | 用**主进程 `win.on('focus')`→IPC** 而非渲染 `window focus` | 防无边框窗口 focus 事件不可靠导致刷新静默失效 |
 | **P4** | 性能 | 聚焦刷新加**防抖（~3s）+ 节流** | 防切窗口抖动堆叠请求、穿透 CDN 放大流量 |
 | **P5** | 可观测 | `refreshAppData` 入口打印 `[AppData] 触发刷新 (reason=focus\|manual)`；`applist` 加载后记录条目数变化（`1200 → 1201`） | 便于线上诊断"刷新是否真生效 / 新应用是否进内存" |
 ### 3.4 可选
 - **O1 `loadTabApps` TTL 失效**：`App.vue:3098` 强缓存改"超过 TTL（如 10min）才重拉"。因 all 搜索主路径已由 3.1+3.2 覆盖，可后置。
 ---
 ## 4. 7 维专业审计结论（改动影响预评估）
 | 维度 | 影响评估 | 关键结论 |
 |---|---|---|
 | **1. 功能正确性** | 改善明确；A1/C2 改造需连带处理增量提交与去重（P1） | 根治"陈旧列表"，但 C 改动需保增量体验 |
 | **2. 性能** | C2 每次穿透 CDN，开销小；**唯一主要负向是聚焦频繁触发** | 需 P4 防抖；否则成主要性能负向 |
 | **3. 安全性** | `no-cache`/时间戳 bust 中性；scope 必须限数据路径 | 不全局注入，不影响图标加速 |
 | **4. 可靠性** | 两处真实风险：`loadApps` 无并发锁（竞态）、渲染 focus 不可靠 | 需 P2 串行化 + P3 IPC focus |
 | **5. 兼容性** | `no-cache`/query 对所有 CDN/HTTP 通用；仅需一次 CDN 行为确认（C2） | 兼容性良好 |
 | **6. 可维护性** | `refreshAppData` 抽出后逻辑集中、易测；增量代码小 | 维护性改善 |
 | **7. 可观测/可测** | 当前刷新路径无专属日志；应补 P5 | 便于上线诊断 |
 **总体**：方案根治有效，性能/安全负向可控；**3 个必补配套（P1/P2/P3）+ 2 个强建议（P4/P5）** 须一并实现，否则功能正确性/可靠性打折。
 ---
 ## 5. 方案落地可行性验证（代码核对 · 测试，不改功能代码）
 > 本节为在动手前对方案各项做的**代码级可行性核对**（未修改任何源码），确认可实现性与需细化点。
 ### 5.1 逐项核对结论
 | 项 | 代码事实（已核对） | 可行性 | 需细化点 |
 |---|---|---|---|
 | **C1 主进程 no-cache 注入** | `onBeforeSendHeaders` 在 `electron/main/index.ts:653` 注册，可拿 `details.url`（完整 URL，含 `.../applist.json` 等）。用 `url.includes('/applist.json')\|\|includes('/categories.json')\|\|includes('/priority-config.json')` 过滤注入即可 | ✅ 可行 | scope 必须限三路径，不影响 `cdn.d.store...` 图标 |
 | **C2 URL bust** | 数据请求三入口（`loadApps` `App.vue:3203`、`loadTabApps` `3133/3151`、`loadCategories` `2925`）**均走 `fetchWithRetry`**；但 `loadPriorityConfig`（`storeConfig.ts:84`）走**独立 `priorityConfigAxios`，不经过 `fetchWithRetry`** | ✅ 可行 | **bust 须覆盖两个 axios 实例**；否则 `priority-config.json` 仍可能陈旧（影响 auto 策略，非搜索主路径但同源） |
 | **A1 loadApps Map 幂等重建** | 当前 `App.vue:3216` `apps.value.push`，在 `Promise.all`(`3190`) 的 `category→origins` 异步循环内。改：函数内声明跨分类 `Map<pkgname,App>`，每分类 `origins` 完成后 `apps.value = [...map.values()]` | ✅ 可行 | 增量提交须保留在每个**分类**处理末尾（非等全部完成），否则首屏回退；Map 按 pkgname 作 key 天然覆盖 spark-only/apm-only 去重 |
 | **A2 refreshAppData 编排** | 新函数 = `await loadCategories()` + 重跑改造后 `loadApps()`；与 `loadApps` 同作用域即可 | ✅ 可行 | 建议 `onMounted` 也改调 `refreshAppData` 而非裸 `loadApps`，统一入口 |
 | **A3 + P3 主进程 focus→IPC** | 主进程 `win` 为模块级 `let win`(`electron/main/index.ts:122`)，`createWindow` 内 `mainWindow`(`418`)。`mainWindow.on('focus', () => mainWindow.webContents.send('appdata-window-focus'))` 可靠（主进程事件，不受无边框影响） | ✅ 可行 | 渲染侧 `window.ipcRenderer.on('appdata-window-focus', ...)` 调用 `refreshAppData`；**preload 无需改动**（通用 `on` 通道已暴露） |
 | **P2 串行化守卫** | `loadApps` 当前**无并发锁**（`loading.value` 仅遮罩），已确认 | ✅ 可行 | `refreshAppData` 内加 `refreshInFlight` Promise 合并：`if (inFlight) return inFlight; inFlight=(async()=>{...})().finally(()=>inFlight=null)` |
 | **P4 防抖** | focus 抖动会快速多次触发 | ✅ 可行 | P2 的 in-flight 合并已天然防抖首跑；再叠加 time-based 节流（如 10s 内仅一次）更稳 |
 | **P5 刷新日志** | 既有 Pino `logger`（如 `App.vue:3205` `logger.info('加载分类...')`） | ✅ 可行 | `refreshAppData` 入口 `[AppData] 触发刷新 reason=...`；`loadApps` 完成 `[AppData] 应用数 X → Y`（Y=map.size） |
 ### 5.2 关键发现（影响方案完整性）
 1. **C1 主进程注入是 C2 的兜底**：主进程 `onBeforeSendHeaders` 注入 `no-cache` 对**所有**经 Chromium 的请求（含 `priorityConfigAxios` 的 XHR）生效；即便 C2 漏给 `priorityConfigAxios` 加 bust，C1 也能保证其不读缓存。**建议 C1 为主、C2 为辅**，两者互补而非二选一。
 2. **C2 必须显式覆盖 `priorityConfigAxios`**：因其独立于 `fetchWithRetry`，要在 `storeConfig.ts:84` 的 `priorityConfigAxios.get(configPath)` 处单独加 bust（或在 `priorityConfigAxios` 实例层加请求拦截器统一加 `?_t`）。否则 auto 策略配置可能陈旧。
 3. **loadApps 异步嵌套**：当前 `categoriesList.map(async category => origins.map(async mode => ...))` 嵌套异步；A1 改造时，需把内层改为 `await Promise.all(origins.map(...))` 后在分类回调末尾提交 `apps.value`，确保"每分类增量提交"。
 4. **下游无回归**：`apps.value` 整体替换会触发 Vue 响应式，`baseApps`/`filteredApps`/排行均依赖它，赋值即刷新，无兼容问题。
 5. **preload 零改动**：新 IPC 通道 `appdata-window-focus` 直接 `send`/`on`，复用已暴露的通用 `ipcRenderer`，不需改 `contextBridge`。
 ### 5.3 测试结论
 - **全部 8 个方案项（C1/C2/A1/A2/A3 + P1~P5）均可实现，无不可落地项。**
 - 落地前须落实 5 个细化点（5.1 表"需细化点" + 5.2 关键发现），其中 **C2 双 axios 覆盖** 与 **C1 兜底关系** 是最易被遗漏、却影响完整性的两点。
 - 风险等级：均为低~中，无高危阻塞；P2（竞态）与 A3 的 IPC 可靠性属"不做则功能打折"的必补项，已在方案中标明。
 ### 5.4 实际效果验证（2026-08-11，本机可执行部分已实测）
 > 用户要求验证"实际效果"。区分两类验证：
 > - **(a) 机理实证（本机已完成）**：用 curl/Node 验证根因与修复方向正确性，无需 GUI/服务端改动。
 > - **(b) 端到端实证（需真机+服务端上架新应用，本机无法完成）**：见第 7 节，须由用户在真实环境执行。
 **(a) 已完成的本机实证：**
 1. `curl -sI` 远程 `applist.json`：**无 `cache-control` 头、`server: nginx`** → 证实 Chromium 启发式缓存为真因（非 CDN 主动缓存）。
 2. Node 计算启发式 TTL ≈ 46 分钟 → 量化"重启仍陈旧"的窗口。
 3. `?_t=Date.now()` URL 经 `new URL()` 解析合法 → C2 方向正确。
 4. `curl -H "Cache-Control: no-cache"` 仍 200 → 客户端带 no-cache 即绕过陈旧副本，C1 方向正确。
 5. 串行化守卫 / Map 幂等去重 / focus→IPC 逻辑已在 5.1 核对，均为纯逻辑可单测（实现后补单测即闭环）。
 **(b) 尚待真机验证（非本机能力范围）：**
 - 需在**服务端上架一个真实新应用**（最好落入已存在分类，隔离"新分类"变量）。
 - 安装修复包后，**不删缓存、不重启** → 聚焦/刷新 → 搜到新应用（验证 C1/C2 绕过启发式缓存）。
 - 重启不清缓存 → 首屏即显示（验证重启不再拿旧数据）。
 - 对照旧包同样操作需删 `Cache` 才有效 → 根因闭合。
 - 说明：本机为无显示环境（headless Linux），且无法操作远端商店后台上架，故 (b) 必须用户在真实环境执行；**但根因机理已由 (a) 实证闭合，修复方向确凿**。
 ---
 ## 6. 明确不做（避免过度设计）
 - ❌ **定时轮询**（后台常驻网络/CPU 开销，用户未要求实时）。
 - ❌ **本地磁盘离线缓存**（问题不在离线，反而引入陈旧风险）。
 - ❌ **ETag / 304 协商缓存**（axios 不过系统缓存层，且已有 no-cache + bust 更稳；除非确认代理忽略请求头才需要）。
 - ❌ **全局 `Cache-Control` 注入到所有请求**（仅对数据 JSON 路径注入，避免影响图标/截图等静态资源加速）。
 ---
 ## 6. 验证方法
 > **验证分工**：步骤 1（单测）随实现完成；步骤 2–5（端到端）需服务端上架新应用 + 真实 GUI 环境，**由用户在真机执行**（本机 headless 无法完成）。
 1. **单元/逻辑**：`loadApps` 幂等化后补测——重跑两次 `apps.value` 长度不变、无重复 pkgname；`refreshAppData` 串行化 + 防抖单测。
 2. **集成（根因闭合）**：服务端上架新应用（落入已存在分类，隔离"新分类"变量）。
 3. 安装修复包，**不删缓存、不重启** → 聚焦窗口 / 点刷新 → 应搜到新应用（证明缓存已绕过，P5 日志应显示条目数 +1）。
 4. 重启应用（不清缓存）→ 首屏即显示新应用（证明 no-cache + bust 生效，重启不再拿旧数据）。
 5. **对照旧包**：同样操作需"删除 `~/.config/spark-store/Cache` 才有效"——确认根因闭合、修复生效。
 > 注：机理层面已由第 5.4 节本机 curl/Node 实证闭合（nginx 无 CC 头 → Chromium 启发式缓存 ≈46min；C1/C2 方向正确），故修复方向确凿，端到端仅作最终确认。
 ---
 ## 附：历次分析演进
 - **第一轮**：怀疑 `~/.cache` 本地应用列表文件缓存 → 核查排除（无磁盘列表缓存，搜索基于内存）。
 - **第二轮**：深入确认"运行期不刷新"为主因（`loadApps` 仅启动一次、append 无去重、`loadTabApps` 强缓存、categories 启动一次）。
 - **第三轮**：结合"重启无效、删除才行"反馈，定位为 **Chromium 磁盘缓存 + CDN 边缘缓存**双重陈旧，且代码零缓存失效机制；修正上轮结论——重启无效的根因是缓存层喂旧数据，而非单纯内存不刷新。
 - **第四轮（方案验证）**：按用户要求"先测试不改代码"，对最终方案的 8 项（C1/C2/A1/A2/A3 + P1~P5）做代码级可行性核对，确认全部可落地；补充 5 个细化点（C2 须覆盖 `priorityConfigAxios` 独立实例、C1 主进程注入为兜底、loadApps 异步嵌套改造、下游无回归、preload 零改动），写入第 5 节。方案待用户审核后决定是否实现。
 ---
 ## 8. 附加修复：下载日志断层（下载卡在"正在获取 Metalink"突兀退出）
 ### 8.1 现象（用户反馈）
 下载应用时日志停在：
 ```
 [13:57:09] 开始下载...
 [13:57:09] 正在获取 Metalink 文件: amd64-store/office/com.qianwen.otohime/com.qianwen.otohime_3.7.5.145_amd64.deb.metalink
 ```
 随后界面无过渡直接结束（状态变 failed / 任务消失），中间无任何失败原因，体验突兀。
 ### 8.2 根因
 下载流程在 `electron/main/backend/install-manager.ts` 的 `runDownloadPhase`：
 1. **Metalink 下载请求失败无前端日志**：`await axios.get(...)` 抛错时，原代码未 `sendLog`，错误只在主进程 `logger.error` 静默记录；错误向上抛到外层 catch → 直接发 `install-complete {success:false}`，渲染端日志面板永远停在"正在获取 Metalink"。
 2. **aria2c 拉起失败也无日志**：`child.on("error")` 仅 `reject(err)`，渲染端同样看不到原因。
 3. **渲染端 `install-complete` 失败分支不写 logs**：`src/modules/processInstall.ts` 收到失败时只改 `status="failed"`，未把 `log.message` 的失败原因写入 `downloadObj.logs`，导致日志卡在最后一条中间状态。
 三者叠加：任一环节失败，UI 都在"正在获取 Metalink"后突兀结束且无原因。
 ### 8.3 修复（已提交）
 - **F1（主进程 Metalink 失败日志）**：`axios.get` 用 try/catch 包裹，失败时 `sendLog("获取 Metalink 失败: <reason>")` 并 `throw`，保证渲染端能显示原因。Metalink 写入 `finish` 回调补 `sendLog("Metalink 文件下载完成")`。
 - **F2（aria2c 拉起失败日志）**：`child.on("error")` 补 `sendLog("aria2c 启动失败: <msg>")`。
 - **F3（渲染端失败原因入日志）**：`install-complete` 的 `else` 分支解析 `log.message` 中的 `message` 字段，push 一条 `下载失败: <reason>` 到 `downloadObj.logs`；成功分支补 `下载完成`。
 改动文件：
 - `electron/main/backend/install-manager.ts`（F1、F2）
 - `src/modules/processInstall.ts`（F3）
 > 注：本修复仅改善"失败可见性"，不改变下载/重试/安装逻辑本身；UI 不再突兀卡在中间日志。
 ### 8.4 验证边界
 本机 headless 无法真实触发 aria2c 下载与 GUI 日志面板；已通过 `vue-tsc` 类型检查与 `read_lints` 0 错误。真实失败场景（如 Metalink 404、网络中断）下的日志连贯性需用户在真机验证。
 ---
 ## 9. 附加修复：更新中心点击"更新"后卡"开始更新..."
 ### 9.1 现象（用户反馈）
 在软件更新中心选择 Visual Studio Code: 点击更新后，下载详情弹窗日志停在：
 ```
 [09:23:41] 开始更新...
 ```
 状态为 `queued`，后续无进展、无错误，界面卡死。
 ### 9.2 根因
 更新中心 `electron/main/backend/update-center/service.ts` 的 `start()` 方法，把任务通过 `webContents.send("queue-install", JSON.stringify(installTaskData))` 发送给主下载队列。
 **但 `webContents.send` 是从主进程向渲染进程发消息，渲染进程的 `ipcRenderer.on("queue-install")` 能收到，而主进程的 `ipcMain.on("queue-install") 监听的是渲染进程 `ipcRenderer.send` 的消息，监听不到自己 `webContents.send` 的消息。**
 结果：任务根本没有进入 `install-manager.ts` 的下载队列，`processNextDownload()` 永远不会执行，UI 自然卡在"开始更新...」。
 ### 9.3 修复（已提交）
 - **I1（抽离可复用的入队函数）**：在 `electron/main/backend/install-manager.ts` 新增导出 `addInstallTask(payload, sender)`，把原来 `ipcMain.on("queue-install")` 里的解析、校验、去重、APM 检查、命令构建、入队逻辑全部抽到该函数。`ipcMain.on` 本身只做 JSON 解析并调用 `addInstallTask`。
 - **I2（更新中心直接调用入队）**：`electron/main/backend/update-center/service.ts` 的 `start()` 不再 `webContents.send("queue-install")`，而是直接 `await addInstallTask(installTaskData, webContents)`，使任务真正进入主下载队列。
 - **I3（类型安全）**：新增 `QueueInstallPayload` 接口，避免 `any`。
 改动文件：
 - `electron/main/backend/install-manager.ts`（I1、I3）
 - `electron/main/backend/update-center/service.ts`（I2）
 ### 9.4 验证边界
 本机 headless 无法启动 GUI 触发真实更新下载；已通过 `vue-tsc` 与 `read_lints` 0 错误。真机需在软件更新中心勾选一项更新并点击"更新"，确认日志从"开始更新..."推进到"正在获取 Metalink 文件"、下载进度增加，最终进入安装或明确失败。
@@ -0,0 +1,162 @@
 # 排行榜与星火荣耀榜 · 项目规划文档
 > 状态：**草图设计已确认，待实现**
 > 分支：`Erotica`
 > 日期：2026-07-30
 > 关联预览原型：`ranking-preview.html`（仓库根目录，仅用于设计预览，不入库）
 ---
 ## 1. 项目背景与目标
 在「已安装应用」模块重构（来源标签化、统计徽章、搜索、来源筛选、APM 置顶）完成后，本次规划聚焦于**首页与发现页的内容重组**：
 - 将原本散落在「首页推荐」中的**下载排行**独立为「排行榜」一级页面，并补充**应用更新排行**；
 - 新增**「星火荣耀榜」**页面，表彰应用贡献者与近期更新贡献者；
 - 精简「首页推荐」页：移除精选板块（区域2）与下载排行（区域3），仅保留精选链接（区域1），并在区域1 顶部加入致谢说明。
 **预期成果**：形成「首页推荐（轻量入口）— 排行榜（下载/更新）— 荣耀榜（贡献者荣誉）」三层递进的发现体系，强化社区贡献者认同感。
 ---
 ## 2. 数据可行性核查（代码已确认）
 | 字段 | 来源 | 结论 |
 |------|------|------|
 | `app.downloadCount` | 现有 `apmRanking` / `sparkRanking`（`App.vue` 1164–1250，异步逐应用拉 `download-times.txt`） | ✅ 直接复用，无需新增请求 |
 | `app.update` | `App.vue:886` 由 `appJson.Update` 映射，格式 `"2026-01-26 17:34:15"`，同格式可直接 `localeCompare` 倒序 | ✅ 列表已含，可直接排序 |
 | `app.contributor` | `App.vue:884` 由 `appJson.Contributor` 映射 | ✅ 列表已含，无需详情请求 |
 > 结论：**荣耀榜/更新榜所需字段均已在列表加载阶段填充**，聚合逻辑可基于已加载的 `apps` 实时计算，不引入额外网络请求。
 ---
 ## 3. 任务总览（优先级 + 阶段）
 | 任务ID | 名称 | 类型 | 优先级 | 阶段 | 关联模块 |
 |--------|------|------|--------|------|----------|
 | F1 | 排行榜页（RankingView） | 新功能 | P0 | 待实现 | App.vue, AppSidebar, HomeView(移除区域3) |
 | F1.1 | 应用下载排行（Spark/APM 双榜） | 新功能 | P0 | 待实现 | 复用 apmRanking/sparkRanking |
 | F1.2 | 应用更新排行（Spark/APM 双榜） | 新功能 | P0 | 待实现 | apps（update 字段） |
 | F2 | 星火荣耀榜页（HonorView） | 新功能 | P0 | 待实现 | App.vue, AppSidebar |
 | F2.1 | 贡献荣耀榜（按来源聚合 contributor） | 新功能 | P0 | 待实现 | apps（contributor 字段） |
 | F2.2 | 更新荣耀榜（最近更新应用 contributor 聚合） | 新功能 | P0 | 待实现 | apps（update+contributor） |
 | F2.3 | 致谢说明卡片 | 新功能 | P1 | 待实现 | HonorView / HomeView 复用 |
 | F3 | 侧边栏导航入口 | 新功能 | P0 | 待实现 | AppSidebar.vue, App.vue |
 | M1 | 首页推荐页改造（去区域2/3，区域1加致谢） | 修改现有 | P0 | 待实现 | HomeView.vue |
 | M2 | App.vue 视图路由与数据编排 | 修改现有 | P0 | 待实现 | App.vue |
 | M3 | 榜单聚合工具函数 | 重构/提取 | P1 | 待优化 | 新增 util 或 App.vue 内 computed |
 | O1 | 边加载边更新体验优化 | 优化 | P2 | 待优化 | HonorView（computed + watch） |
 | O2 | 榜单条数/来源可配置 | 优化 | P2 | 待优化 | RankingView/HonorView props |
 | O3 | 空状态与加载失败兜底 | 优化 | P1 | 待优化 | RankingView/HonorView |
 | R1 | 类型安全与 lint 修复 | 修复 | P1 | 待修复 | 全部新增组件 |
 | R2 | 与现有列表加载/更新逻辑的一致性校验 | 修复 | P1 | 待修复 | App.vue, install-manager |
 ---
 ## 4. 详细任务分解
 ### 4.1 新功能模块
 #### F1 · 排行榜页（RankingView.vue）
 **F1.1 应用下载排行**
 - **改动描述**：新增 `RankingView` 组件，区块一展示「应用下载排行」，内部按来源分为 Spark 下载榜 / APM 下载榜两栏，各取下载量前 10 名。复用现有 `apmRanking` / `sparkRanking` 数据（由 `App.vue` 传入），列表项沿用 `AppCard` 的 `compact` 样式，并在左侧加排名序号（前 3 名用金/银/铜配色）。
 - **预期目标**：与现有首页下载排行视觉一致，且独立成页后信息更聚焦。
 - **关联模块**：`App.vue`（传入 `apmRanking`/`sparkRanking`）、`AppCard.vue`、`AppSidebar.vue`（入口）。
 - **备注**：当前首页区域3 的展示可直接迁移，避免重复实现。
 **F1.2 应用更新排行**
 - **改动描述**：区块二展示「应用更新排行」，按来源分为 Spark 更新榜 / APM 更新榜两栏，各取 `app.update` 倒序前 10 名；列表项复用 `AppCard` compact 样式，副信息显示版本与更新时间（替换下载量徽章）。
 - **预期目标**：让用户快速了解近期活跃更新的应用。
 - **关联模块**：`App.vue`（`apps` 全量数据）、`AppCard.vue`。
 - **备注**：排序用 `update.localeCompare` 倒序（格式统一可行）。
 #### F2 · 星火荣耀榜页（HonorView.vue）
 **F2.1 贡献荣耀榜**
 - **改动描述**：区块一展示「贡献荣耀榜」，按来源分为 Spark / APM 两栏，各取 `app.contributor` 出现次数前 10 名（聚合基于已加载 `apps`，实时计算）。列表项显示排名、贡献者名（去除 `<email>` 后缀）、上榜应用数徽章。
 - **预期目标**：表彰对星火生态贡献最多的开发者/维护者。
 - **关联模块**：`App.vue`（`apps`）、`HonorView.vue`。
 **F2.2 更新荣耀榜**
 - **改动描述**：区块二展示「更新荣耀榜」，按来源分为 Spark / APM 两栏；取最近更新（按 `update` 倒序）的前 30 个应用，聚合其 `contributor` 出现次数，取前 10 名展示。
 - **预期目标**：突出近期持续维护应用的贡献者。
 - **关联模块**：`App.vue`（`apps`）、`HonorView.vue`。
 - **备注**：与 F1.2 同源（最近更新应用列表），可共享计算。
 **F2.3 致谢说明卡片**
 - **改动描述**：在荣耀榜页顶部加入美化后的致谢卡片（渐变琥珀背景 + 图标 + 文案「致每一位星火贡献者…🎉」）；同一卡片样式也用于首页推荐区域1（见 M1）。
 - **预期目标**：强化社区归属感，视觉与整体风格统一。
 - **关联模块**：`HonorView.vue`、`HomeView.vue`（复用同一段模板/组件）。
 #### F3 · 侧边栏导航入口
 - **改动描述**：在 `AppSidebar.vue` 新增「排行榜」「荣耀榜」两个一级入口，点击分别 `selectTab('ranking')` / `selectTab('honor')`，激活态沿用 `.sidebar-tab-active` 样式。
 - **预期目标**：用户可从侧边栏直达新页面。
 - **关联模块**：`AppSidebar.vue`、`App.vue`（`activeTab` 状态）。
 ### 4.2 需要修改的现有模块
 #### M1 · 首页推荐页改造（HomeView.vue）
 - **改动描述**：移除模板中的**区域2·精选板块**（`recommendSections` 应用列表区块）与**区域3·下载排行**（`apmRanking`/`sparkRanking` 区块）及其对应 props（`recommendSections`、`apmRanking`、`sparkRanking`、`rankingLoading`）；在区域1（精选链接 `homelinks` 网格）顶部插入致谢说明卡片（F2.3 同款）。
 - **预期目标**：首页回归轻量入口定位，下载排行/精选板块职责移交排行榜页与「全部应用」。
 - **关联模块**：`HomeView.vue`、`App.vue`（停止向 HomeView 传 ranking/recommend 数据，或保留 recommend 供「全部应用」使用——需确认 recommendSections 是否仍被其他入口复用）。
 - **备注**：⚠️ 需确认 `recommendSections` 是否仅首页使用；若「全部应用」等也依赖，则不能简单删除数据加载。
 #### M2 · App.vue 视图路由与数据编排
 - **改动描述**：主内容区新增 `v-else-if="activeTab === 'ranking'"` → `<RankingView>`、`v-else-if="activeTab === 'honor'"` → `<HonorView>`；将现有 `apmRanking`/`sparkRanking` 改传 `RankingView`；荣耀榜所需的全量 `apps` 以 `computed` 形式实时传入 `HonorView`（支撑"边加载边更新"）。
 - **预期目标**：打通新页面路由与数据流。
 - **关联模块**：`App.vue`、`RankingView.vue`、`HonorView.vue`。
 #### M3 · 榜单聚合工具函数（待优化阶段）
 - **改动描述**：将"按来源取 Top N""聚合 contributor 次数"等逻辑提取为独立 `util` 函数（如 `src/modules/ranking.ts`），供 RankingView/HonorView 复用，避免组件中重复实现。
 - **预期目标**：提升可维护性、便于单元测试。
 - **关联模块**：新增 `src/modules/ranking.ts`。
 ---
 ## 5. 阶段划分与执行顺序
 ### 阶段一 · 待实现（P0，核心交付）
 1. **M2** App.vue 路由骨架 + **F3** 侧边栏入口（打通页面切换）
 2. **F1** RankingView（F1.1 下载榜 → F1.2 更新榜）
 3. **F2** HonorView（F2.1 贡献榜 → F2.2 更新榜 → F2.3 致谢）
 4. **M1** HomeView 首页改造（去区域2/3 + 区域1 致谢）
 ### 阶段二 · 待优化（P1–P2，体验打磨）
 - **O3** 空状态/加载失败兜底（榜单为空、apps 未加载时友好提示）
 - **M3 / O2** 聚合工具提取、榜单条数可配置（当前固定 10）
 - **O1** 边加载边更新：用 `computed` + `watch(apps)` 实时刷新，进入荣耀榜即开始聚合，无需手动定时器
 ### 阶段三 · 待修复（P1，质量保障）
 - **R1** 全部新增组件通过 `vue-tsc` 类型检查与 ESLint（严格模式，禁用 `any`）
 - **R2** 校验与现有列表加载（`loadCategories`/`refreshInstalledApps`）、更新逻辑的一致性，避免重复遍历导致的性能问题（全量 `apps` 聚合建议在 `computed` 中记忆化）
 ---
 ## 6. 风险与待确认项
 1. **推荐数据归属**：`recommendSections` 是否仅首页使用？若「全部应用」等入口复用，M1 删除区域2 时需保留数据加载逻辑，仅移除模板渲染。
 2. **荣耀榜数据范围**：确认基于"已加载 `apps`"即可满足需求（用户已确认"只基于已加载应用"），无需分页/全量后端接口。
 3. **榜单条数**：当前统一为 10 条（用户确认），后续是否需要在 UI 上可切换（O2）。
 4. **贡献者字段格式**：`contributor` 形如 `name<email>`，聚合与展示时需统一去除 `<...>` 取显示名；多个贡献者是否以 `;` 分隔需抽样确认。
 5. **storeFilter 影响**：下载榜已按 Spark/APM 分榜；更新榜/荣耀榜按来源分布已实现。若 `storeFilter==='spark'` 仅显示 Spark 榜，需在主内容区做来源过滤。
 ---
 ## 7. 验收标准
 - [ ] 侧边栏出现「排行榜」「荣耀榜」入口，点击正确切换页面
 - [ ] 排行榜页：下载榜（Spark/APM）与更新榜（Spark/APM）各显示 Top 10，视觉与现有 AppCard 一致
 - [ ] 荣耀榜页：贡献荣耀榜、更新荣耀榜各按来源 Top 10，且随 `apps` 加载实时更新；顶部致谢卡片正确显示
 - [ ] 首页推荐：仅保留区域1（精选链接）+ 致谢卡片，区域2/3 已移除
 - [ ] 全部新增/修改通过 `npm run lint` 与 `vue-tsc` 类型检查
 - [ ] 打包（`dpkg-buildpackage`）成功，功能在 GUI 环境自测通过
 ---
 *本文档基于 `ranking-preview.html` 设计原型与代码核查结论编写，作为后续开发与迭代的执行依据。*
@@ -0,0 +1,150 @@
 # App Detail Fixed Sidebar Scroll Implementation Plan
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 **Goal:** Keep the app detail modal's left action/meta column fixed on desktop while the right detail/review column scrolls independently.
 **Architecture:** Reuse the existing `AppDetailModal.vue` popup and change only its internal layout classes/markers. The modal panel becomes a bounded, non-scrolling shell on desktop, while the right column becomes the desktop scroll container; mobile keeps the single-column scroll behavior.
 **Tech Stack:** Vue 3 SFC, Tailwind CSS utilities, Vitest, Testing Library Vue.
 ---
 ## File Structure
 - Modify: `src/components/AppDetailModal.vue` - adjust modal shell, left column, right scroll column, and scroll reset target.
 - Modify: `src/__tests__/unit/AppDetailModal.test.ts` - assert modal shell and scroll column contract.
 ## Task 1: Add Layout Contract Test
 **Files:**
 - Modify: `src/__tests__/unit/AppDetailModal.test.ts`
 - [ ] **Step 1: Add assertions to the popup modal test**
 In `src/__tests__/unit/AppDetailModal.test.ts`, update `renders detail content inside a popup-style modal overlay` so the body after the `.modal-panel` assertion is:
 ```ts
    const panel = overlay?.querySelector(".modal-panel");
    expect(panel).toBeTruthy();
    expect(panel?.className).toContain("overflow-hidden");
    expect(panel?.className).toContain("lg:max-h-[85vh]");
    expect(panel?.querySelector('[data-testid="detail-fixed-sidebar"]')).toBeTruthy();
    expect(panel?.querySelector('[data-testid="detail-scroll-content"]')).toBeTruthy();
    expect(
      panel?.querySelector('[data-testid="detail-scroll-content"]')?.className,
    ).toContain("lg:overflow-y-auto");
 ```
 - [ ] **Step 2: Run test to verify failure**
 Run: `npm run test -- --run src/__tests__/unit/AppDetailModal.test.ts`
 Expected: FAIL because `data-testid="detail-fixed-sidebar"`, `data-testid="detail-scroll-content"`, and the new modal classes are not present.
 ## Task 2: Implement Fixed Sidebar Layout
 **Files:**
 - Modify: `src/components/AppDetailModal.vue`
 - Modify: `src/__tests__/unit/AppDetailModal.test.ts`
 - [ ] **Step 1: Update modal shell classes**
 In `src/components/AppDetailModal.vue`, change the `.modal-panel` class from:
 ```vue
 class="modal-panel relative w-full max-w-5xl max-h-[85vh] overflow-y-auto overscroll-contain scrollbar-nowidth rounded-3xl border border-white/10 bg-white/95 px-6 pb-6 shadow-2xl dark:border-slate-800 dark:bg-slate-900"
 ```
 to:
 ```vue
 class="modal-panel relative flex w-full max-w-5xl max-h-[85vh] overflow-y-auto overscroll-contain scrollbar-nowidth rounded-3xl border border-white/10 bg-white/95 px-6 pb-6 shadow-2xl dark:border-slate-800 dark:bg-slate-900 lg:max-h-[85vh] lg:overflow-hidden lg:pb-0"
 ```
 - [ ] **Step 2: Move the return button into the fixed sidebar**
 In `src/components/AppDetailModal.vue`, replace the top-level return button and main layout start with:
 ```vue
        <!-- 主布局：左侧信息 + 右侧内容 -->
        <div class="flex w-full flex-col gap-6 lg:min-h-0 lg:flex-row">
          <!-- 左侧：图标、版本、来源、按钮、元信息 -->
          <div
            data-testid="detail-fixed-sidebar"
            class="w-full flex-shrink-0 space-y-5 lg:w-72 lg:self-start lg:py-4"
          >
            <button
              type="button"
              class="inline-flex items-center gap-2 rounded-full border border-slate-200/70 bg-white/90 px-4 py-2 text-sm font-medium text-slate-600 shadow-lg backdrop-blur-sm transition hover:bg-slate-50 hover:text-slate-900 dark:border-slate-700 dark:bg-slate-800/90 dark:text-slate-400 dark:hover:bg-slate-700 dark:hover:text-slate-200"
              @click="closeModal"
              aria-label="返回"
            >
              <i class="fas fa-arrow-left"></i>
              <span>返回</span>
            </button>
 ```
 Remove the old sticky top-level return button and the old left column opening:
 ```vue
        <!-- 返回按钮 - sticky定位在模态框内部左上角，滚动时始终可见 -->
        <button ...>...</button>
        <!-- 主布局：左侧信息 + 右侧内容 -->
        <div class="flex flex-col lg:flex-row gap-6">
          <!-- 左侧：图标、版本、来源、按钮、元信息 -->
          <div class="w-full lg:w-72 flex-shrink-0 space-y-5">
 ```
 - [ ] **Step 3: Make the right column the desktop scroll container**
 In `src/components/AppDetailModal.vue`, change the right column opening from:
 ```vue
          <div class="flex-1 min-w-0 space-y-5">
 ```
 to:
 ```vue
          <div
            data-testid="detail-scroll-content"
            class="min-w-0 flex-1 space-y-5 lg:max-h-[85vh] lg:overflow-y-auto lg:overscroll-contain lg:py-4 lg:pr-2"
          >
 ```
 - [ ] **Step 4: Update scroll reset target if needed**
 In `src/App.vue`, keep the existing modal scroll reset selector if it still points at `.modal-panel`. If the right column needs reset instead, change the query to:
 ```ts
 const modal = document.querySelector(
  '[data-app-modal="detail"] [data-testid="detail-scroll-content"]',
 );
 ```
 Use `modal.scrollTop = 0` as it does today.
 - [ ] **Step 5: Run focused test**
 Run: `npm run test -- --run src/__tests__/unit/AppDetailModal.test.ts`
 Expected: PASS.
 - [ ] **Step 6: Run build verification**
 Run: `npm run build:vite`
 Expected: PASS.
 - [ ] **Step 7: Commit implementation**
 Run:
 ```bash
 git add src/components/AppDetailModal.vue src/App.vue src/__tests__/unit/AppDetailModal.test.ts
 git commit -m "fix(ui): pin detail modal sidebar"
 ```
 Expected: commit succeeds.
@@ -0,0 +1,141 @@
 # Review Avatar Display Implementation Plan
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 **Goal:** Show cached backend user avatar URLs beside comments in the app review list.
 **Architecture:** Use the existing `AppReview.userAvatarUrl` field returned by the backend. `ReviewsPanel.vue` renders an avatar image when present and a stable fallback when missing or failed; tests cover the rendered avatar contract.
 **Tech Stack:** Vue 3 SFC, Tailwind CSS utilities, Vitest, Testing Library Vue.
 ---
 ## File Structure
 - Modify: `src/components/ReviewsPanel.vue` - render reviewer avatar/fallback in each review card and handle broken avatar images.
 - Modify: `src/__tests__/unit/ReviewsPanel.test.ts` - add test coverage for avatar display.
 ## Task 1: Add Avatar Rendering Test
 **Files:**
 - Modify: `src/__tests__/unit/ReviewsPanel.test.ts`
 - [ ] **Step 1: Add review with avatar test**
 Append this test inside `describe("ReviewsPanel", () => { ... })` before the final closing brace:
 ```ts
  it("shows reviewer avatars when available", async () => {
    vi.mocked(fetchRatingSummary).mockResolvedValue({
      averageRating: 5,
      reviewCount: 1,
      starCounts: { 5: 1 },
    });
    vi.mocked(fetchReviews).mockResolvedValue([
      {
        id: 3,
        rating: 5,
        content: "头像正常显示",
        version: tags.version,
        packageArch: tags.packageArch,
        clientArch: tags.clientArch,
        distro: tags.distro,
        origin: tags.origin,
        category: tags.category,
        createdAt: "2026-05-19T00:00:00Z",
        updatedAt: "2026-05-19T00:00:00Z",
        userDisplayName: "Avatar User",
        userAvatarUrl: "https://bbs.spark-app.store/avatar.png",
      },
    ]);
    render(ReviewsPanel, {
      props: { appKey: "apm:amd64-apm:office:wps", tags, loggedIn: true },
    });
    const avatar = await screen.findByAltText("Avatar User 的头像");
    expect(avatar).toHaveAttribute("src", "https://bbs.spark-app.store/avatar.png");
  });
 ```
 - [ ] **Step 2: Run test to verify failure**
 Run: `npm run test -- --run src/__tests__/unit/ReviewsPanel.test.ts`
 Expected: FAIL because no avatar image with alt text is rendered.
 ## Task 2: Render Review Avatars
 **Files:**
 - Modify: `src/components/ReviewsPanel.vue`
 - Modify: `src/__tests__/unit/ReviewsPanel.test.ts`
 - [ ] **Step 1: Update review article layout**
 In `src/components/ReviewsPanel.vue`, replace the review `<article>` body with this structure:
 ```vue
        <div class="flex gap-3">
          <img
            v-if="review.userAvatarUrl"
            :src="review.userAvatarUrl"
            :alt="`${review.userDisplayName || '星火用户'} 的头像`"
            class="h-9 w-9 flex-shrink-0 rounded-full bg-slate-100 object-cover dark:bg-slate-800"
            loading="lazy"
            referrerpolicy="no-referrer"
            @error="hideAvatar"
          />
          <div
            v-else
            class="flex h-9 w-9 flex-shrink-0 items-center justify-center rounded-full bg-slate-200 text-xs font-semibold text-slate-500 dark:bg-slate-800 dark:text-slate-300"
            aria-hidden="true"
          >
            {{ review.userDisplayName?.slice(0, 1) || "星" }}
          </div>
          <div class="min-w-0 flex-1">
            <div class="flex items-center justify-between gap-3">
              <strong class="truncate text-slate-700 dark:text-slate-200">
                {{ review.userDisplayName || "星火用户" }}
              </strong>
              <span class="flex-shrink-0 text-xs text-slate-400">{{ review.rating }} 星</span>
            </div>
            <p class="mt-2 whitespace-pre-wrap text-slate-600 dark:text-slate-300">
              {{ review.content || "暂无评论内容" }}
            </p>
          </div>
        </div>
 ```
 - [ ] **Step 2: Add avatar error handler**
 In the `<script setup>` block of `src/components/ReviewsPanel.vue`, add:
 ```ts
 const hideAvatar = (event: Event) => {
  (event.target as HTMLElement).style.display = "none";
 };
 ```
 - [ ] **Step 3: Run focused test**
 Run: `npm run test -- --run src/__tests__/unit/ReviewsPanel.test.ts`
 Expected: PASS.
 - [ ] **Step 4: Run build verification**
 Run: `npm run build:vite`
 Expected: PASS.
 - [ ] **Step 5: Commit and push**
 Run:
 ```bash
 git add docs/superpowers/plans/2026-05-19-review-avatar-display.md src/components/ReviewsPanel.vue src/__tests__/unit/ReviewsPanel.test.ts
 git commit -m "feat(reviews): show reviewer avatars"
 git push origin Erotica
 ```
 Expected: commit and push succeed.
@@ -0,0 +1,284 @@
 # Client UI Polish Implementation Plan
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 **Goal:** Fix the client-side account, favorites, reviews, sync, restore, and shell UI issues reported in QA.
 **Architecture:** Preserve existing Vue component boundaries. Add thin wrappers/helpers for modal account management, custom titlebar, review star controls, and sync restore candidate resolution. Backend-dependent review actions are client-side affordances only until backend endpoints exist.
 **Tech Stack:** Vue 3 Composition API, TypeScript strict mode, Electron IPC, Tailwind CSS, Vitest, Testing Library Vue.
 ---
 ## File Structure
 - Create `src/components/UserManagementModal.vue` to present `UserManagementView` as a global overlay.
 - Create `src/components/WindowTitleBar.vue` for frameless titlebar UI and window controls.
 - Modify `src/App.vue` to mount the new account modal, pass sync feedback to installed apps modal, pass favorite status to detail modal, and use restore candidate helper.
 - Modify `src/components/AppSidebar.vue` and `src/components/AccountQuickMenu.vue` for overflow-safe labels and menu closing coverage.
 - Modify `src/components/UserManagementView.vue` for cover-image rendering and modal-friendly layout.
 - Modify `src/components/InstalledAppsModal.vue` to show sync feedback locally.
 - Modify `src/components/FavoriteFolderSelector.vue` for normalized default-folder de-dupe and favorited-state text/actions.
 - Modify `src/components/FavoriteFolderManager.vue` so the entire row content opens detail while checkbox stays isolated.
 - Modify `src/components/AppDetailModal.vue` and `src/components/AppDetailPage.vue` to show `已收藏` state.
 - Modify `src/components/ReviewsPanel.vue` for star rating, filters, user detail affordance, and disabled backend-dependent actions.
 - Modify `src/modules/appListSync.ts` for `resolveCloudInstallCandidate()`.
 - Modify `electron/main/index.ts`, `electron/preload/index.ts`, and `src/vite-env.d.ts` for frameless window controls.
 - Add/update unit tests under `src/__tests__/unit/`.
 ---
 ### Task 1: Account Menu And User Management Modal
 **Files:**
 - Create: `src/components/UserManagementModal.vue`
 - Modify: `src/App.vue`
 - Modify: `src/components/AppSidebar.vue`
 - Modify: `src/components/AccountQuickMenu.vue`
 - Modify: `src/components/UserManagementView.vue`
 - Modify: `src/global/typedefinition.ts`
 - Modify: `src/modules/backendApi.ts`
 - Modify: `src/global/authState.ts`
 - Test: `src/__tests__/unit/AppSidebar.account.test.ts`
 - Test: `src/__tests__/unit/UserManagementView.test.ts`
 - Test: `src/__tests__/unit/App.account-placeholders.test.ts`
 - Test: `src/__tests__/unit/accountTypes.test.ts`
 - Test: `src/__tests__/unit/authState.test.ts`
 - [ ] **Step 1: Write failing sidebar tests**
 Add tests to `src/__tests__/unit/AppSidebar.account.test.ts` that verify each quick-menu action closes the menu, and that a user with empty `displayName` and long `username` still gets truncate/min-width classes.
 - [ ] **Step 2: Run sidebar tests red**
 Run: `npm run test -- --run src/__tests__/unit/AppSidebar.account.test.ts`
 Expected: FAIL for missing fallback username coverage or quick-menu item truncation coverage.
 - [ ] **Step 3: Implement sidebar overflow and close safety**
 Update account label wrappers and quick-menu item labels with `min-w-0`, `truncate`, and explicit close-before-emit behavior already used by the parent.
 - [ ] **Step 4: Write failing user management modal tests**
 Update `src/__tests__/unit/App.account-placeholders.test.ts` so opening “用户管理” asserts a `role="dialog"` overlay exists and the main app grid/favorites frame is not replaced by `currentView === 'account'`.
 - [ ] **Step 5: Write failing cover field tests**
 Update `src/__tests__/unit/accountTypes.test.ts`, `authState.test.ts`, and `UserManagementView.test.ts` for optional `coverUrl` on `SparkUser` and visible cover rendering.
 - [ ] **Step 6: Implement modal and cover rendering**
 Add `UserManagementModal.vue`, add `showUserManagementModal` state in `App.vue`, keep `currentView` unchanged when opening user management, and pass through `close`, `open-forum`, `edit-profile`, `toggle-sync`, `sync-now`, and `refresh-downloads` events.
 - [ ] **Step 7: Run account tests green**
 Run: `npm run test -- --run src/__tests__/unit/AppSidebar.account.test.ts src/__tests__/unit/UserManagementView.test.ts src/__tests__/unit/App.account-placeholders.test.ts src/__tests__/unit/accountTypes.test.ts src/__tests__/unit/authState.test.ts`
 Expected: PASS.
 ---
 ### Task 2: Favorites State And Interaction Polish
 **Files:**
 - Modify: `src/App.vue`
 - Modify: `src/components/FavoriteFolderSelector.vue`
 - Modify: `src/components/FavoriteFolderManager.vue`
 - Modify: `src/components/AppDetailModal.vue`
 - Modify: `src/components/AppDetailPage.vue`
 - Modify: `src/modules/backendApi.ts`
 - Test: `src/__tests__/unit/FavoriteFolderSelector.test.ts`
 - Test: `src/__tests__/unit/FavoriteFolderManager.test.ts`
 - Test: `src/__tests__/unit/AppDetailModal.test.ts`
 - Test: `src/__tests__/unit/App.account-placeholders.test.ts`
 - [ ] **Step 1: Write failing selector de-dupe tests**
 Add a test where backend returns folder name ` 默认收藏夹 ` and assert only one default folder button appears.
 - [ ] **Step 2: Run selector test red**
 Run: `npm run test -- --run src/__tests__/unit/FavoriteFolderSelector.test.ts`
 Expected: FAIL because current de-dupe compares exact name only.
 - [ ] **Step 3: Normalize default folder names**
 Trim folder names before default-folder comparison.
 - [ ] **Step 4: Write failing detail favorite-state tests**
 Add tests asserting a favorited app renders `已收藏` in `AppDetailModal` and emits the favorite action when clicked.
 - [ ] **Step 5: Implement favorite state props**
 Add `favorited`/`favoriteFolderName` props to detail components and compute current favorite metadata in `App.vue` from loaded folders/items.
 - [ ] **Step 6: Write failing row click test**
 Add a test that clicking the favorite row text/image area opens detail while clicking the checkbox only selects.
 - [ ] **Step 7: Implement row-click behavior**
 Make the favorite row content area larger/clickable and keep checkbox event isolated.
 - [ ] **Step 8: Run favorites tests green**
 Run: `npm run test -- --run src/__tests__/unit/FavoriteFolderSelector.test.ts src/__tests__/unit/FavoriteFolderManager.test.ts src/__tests__/unit/AppDetailModal.test.ts src/__tests__/unit/App.account-placeholders.test.ts`
 Expected: PASS.
 ---
 ### Task 3: Review Panel Client UX
 **Files:**
 - Modify: `src/components/ReviewsPanel.vue`
 - Modify: `src/global/typedefinition.ts`
 - Modify: `src/modules/backendApi.ts`
 - Test: `src/__tests__/unit/ReviewsPanel.test.ts`
 - [ ] **Step 1: Write failing star rating test**
 Add a test that clicks the “3 星” star button and verifies `submitReview` receives `rating: 3`.
 - [ ] **Step 2: Write failing filter test**
 Add reviews with different `packageArch` and `distro`; assert selecting an architecture or OS filter hides non-matching reviews.
 - [ ] **Step 3: Write failing review action/user tests**
 Add a test that reviewer avatar/name are buttons emitting/showing user detail affordance, and that like/reply/delete controls render with delete disabled unless local permission allows it.
 - [ ] **Step 4: Run review tests red**
 Run: `npm run test -- --run src/__tests__/unit/ReviewsPanel.test.ts`
 Expected: FAIL because current UI uses select rating and lacks filters/actions.
 - [ ] **Step 5: Implement star rating and filters**
 Replace the native rating select with five star buttons and add local filter controls for package architecture and distro.
 - [ ] **Step 6: Implement client-only review actions**
 Render like/reply/delete buttons. Like/reply show a local “后端接口接入后可用” message. Delete is visible only for author/admin-compatible client data; otherwise omit or disable it.
 - [ ] **Step 7: Run review tests green**
 Run: `npm run test -- --run src/__tests__/unit/ReviewsPanel.test.ts`
 Expected: PASS.
 ---
 ### Task 4: Sync Feedback And Cross-Origin Restore
 **Files:**
 - Modify: `src/App.vue`
 - Modify: `src/components/InstalledAppsModal.vue`
 - Modify: `src/modules/appListSync.ts`
 - Test: `src/__tests__/unit/appListSync.test.ts`
 - Test: `src/__tests__/unit/App.account-placeholders.test.ts`
 - [ ] **Step 1: Write failing restore helper tests**
 Add `resolveCloudInstallCandidate()` tests for exact origin/category match, same package fallback across origin, and no candidate.
 - [ ] **Step 2: Run sync helper tests red**
 Run: `npm run test -- --run src/__tests__/unit/appListSync.test.ts`
 Expected: FAIL because helper is missing.
 - [ ] **Step 3: Implement restore helper**
 Export `resolveCloudInstallCandidate(item, apps)` from `appListSync.ts` and use it in `App.vue` `installCloudItems()`.
 - [ ] **Step 4: Write failing sync feedback test**
 Update `App.account-placeholders.test.ts` or `InstalledAppsModal.test.ts` to assert clicking sync in the installed-apps modal shows `同步完成` or an error message in that modal.
 - [ ] **Step 5: Implement modal sync feedback prop**
 Add `syncMessage` prop to `InstalledAppsModal.vue` and pass `syncStatusMessage` from `App.vue`.
 - [ ] **Step 6: Run sync tests green**
 Run: `npm run test -- --run src/__tests__/unit/appListSync.test.ts src/__tests__/unit/App.account-placeholders.test.ts src/__tests__/unit/InstalledAppsModal.test.ts`
 Expected: PASS.
 ---
 ### Task 5: Frameless Window And Shell Polish
 **Files:**
 - Create: `src/components/WindowTitleBar.vue`
 - Modify: `src/App.vue`
 - Modify: `electron/main/index.ts`
 - Modify: `electron/preload/index.ts`
 - Modify: `src/vite-env.d.ts`
 - Test: add or update appropriate unit tests for titlebar component and source config.
 - [ ] **Step 1: Write failing titlebar component test**
 Create a unit test that renders `WindowTitleBar.vue`, clicks minimize/maximize/close, and verifies IPC messages are sent.
 - [ ] **Step 2: Write failing Electron config test or static check**
 Add a lightweight test/static assertion that `BrowserWindow` is created with `frame: false`.
 - [ ] **Step 3: Implement IPC handlers and titlebar**
 Set `frame: false` in `BrowserWindow`; add IPC listeners for window minimize, toggle maximize, and close using existing close guard; add `WindowTitleBar.vue` with drag/no-drag regions.
 - [ ] **Step 4: Mount titlebar in App.vue**
 Place the titlebar at the top of the root layout and adjust sticky header offsets as needed.
 - [ ] **Step 5: Verify category capsule color**
 Run existing `CategoryBar.test.ts`; no code change needed if it already asserts `#2b7fff`.
 Run: `npm run test -- --run src/__tests__/unit/CategoryBar.test.ts`
 Expected: PASS.
 ---
 ### Task 6: Final Verification
 **Files:**
 - All files touched by previous tasks.
 - [ ] **Step 1: Run targeted unit tests**
 Run the union of tests touched by this plan:
 ```bash
 npm run test -- --run src/__tests__/unit/AppSidebar.account.test.ts src/__tests__/unit/UserManagementView.test.ts src/__tests__/unit/App.account-placeholders.test.ts src/__tests__/unit/accountTypes.test.ts src/__tests__/unit/authState.test.ts src/__tests__/unit/FavoriteFolderSelector.test.ts src/__tests__/unit/FavoriteFolderManager.test.ts src/__tests__/unit/AppDetailModal.test.ts src/__tests__/unit/ReviewsPanel.test.ts src/__tests__/unit/appListSync.test.ts src/__tests__/unit/InstalledAppsModal.test.ts src/__tests__/unit/CategoryBar.test.ts
 ```
 Expected: PASS.
 - [ ] **Step 2: Run production build**
 Run: `npm run build:vite`
 Expected: PASS.
 - [ ] **Step 3: Check diff whitespace**
 Run: `git diff --check`
 Expected: no output.
 - [ ] **Step 4: Commit client changes**
 Commit message: `fix(ui): polish account favorites reviews and shell`
 - [ ] **Step 5: Push feature branch**
 Push `fix/client-ui-account-favorites` for review or merge.
@@ -0,0 +1,315 @@
 # Spark Account Collections Client Design
 ## Goal
 Extend the Spark Store account experience across the backend and Electron/Vue client so users can log in or register through the forum identity flow, see account management data, use comments and favorites when logged in, sync store-recognized installed apps, and batch install apps from cloud favorites without breaking anonymous browsing, installation, removal, or update features.
 ## Scope
 ### Included
 1. Clone or prepare a clean working copy of `https://gitee.com/erotica-rbqs/spark-store` for client implementation.
 2. Extend the existing FastAPI backend at `https://gitee.com/erotica-rbqs/spark-unionid-server` with account data APIs for favorite folders, favorite items, downloaded records, and richer user profile data.
 3. Keep login identity based on the Flarum forum. The client posts credentials directly to Flarum, then sends only the Flarum token and user id to the backend.
 4. The login modal provides a register action by opening the forum registration page in the system browser.
 5. Replace the upper-left SparkStore title area with an account entry while preserving the logo. After login, replace the logo with the user's avatar and show the username.
 6. Add a logged-in account quick menu with user management, favorites, forum home, edit forum profile, and logout actions.
 7. Keep anonymous base usage intact: browsing, searching, detail viewing, software install, software uninstall, update center, and installed-app viewing must work without login.
 8. Gate account-only features: comments, favorites, cloud favorite management, downloaded record history, and cloud sync require login and show a login/register prompt when used anonymously.
 9. Convert app details from modal overlay to a main-content detail page that fills the current app-list area, with a back button returning to the previous list state.
 10. Add favorite actions from the detail page. Users can select a favorite folder; if none exists, the backend creates a default folder.
 11. Store favorites as application-level identities, not a fixed Spark/APM variant. Batch install selects the currently preferred available variant according to the active priority configuration.
 12. Record logged-in user downloads to the cloud when the user clicks download. Downloads made while anonymous are not backfilled after login.
 13. On each client start, refresh installed package lists in the background. For logged-in users, ask once before enabling automatic cloud sync; remember the choice.
 14. Build the sync list only from store-recognized listed applications, including Spark and APM apps, excluding unknown packages and dependencies.
 15. User management shows avatar, nickname, Flarum user level, forum home link, and forum profile edit link.
 16. Users can manage multiple favorite folders with custom names, remove invalid/downlisted apps, select all apps in a folder, and send selected installable apps to the existing download/install queue.
 17. Favorite folder entries that are not available on the current platform or architecture remain visible with status labels. Downlisted entries remain visible and can be batch removed.
 ### Excluded
 1. Client-side Flarum account creation forms. Registration is a browser link to the forum registration page.
 2. Forum profile editing inside the client. The client opens the forum profile page externally.
 3. Offline-first conflict resolution for favorites. Backend state is authoritative; client caches may improve UX but do not merge conflicting edits.
 4. Automatic install on startup. Users must explicitly send favorites or restore items to the download queue.
 5. Admin moderation, report handling, or anti-spam systems.
 ## Existing Context
 The current client is an Electron + Vue 3 + TypeScript application. The target repository is `https://gitee.com/erotica-rbqs/spark-store`.
 Important existing integration points:
 1. `src/App.vue` coordinates tabs, app loading, install queue integration, detail opening, installed-app modal, and update center.
 2. `src/components/AppHeader.vue` owns the top search/settings/about area.
 3. `src/components/AppSidebar.vue` owns the current upper-left logo/title area and category navigation.
 4. `src/components/AppDetailModal.vue` currently renders app details as an overlay modal. It already handles Spark/APM merged apps and source switching.
 5. `src/components/InstalledAppsModal.vue` renders installed apps and origin switching.
 6. `src/modules/processInstall.ts` creates download queue items and sends `queue-install` IPC messages.
 7. `src/global/storeConfig.ts` owns store URLs and hybrid priority rules through `getHybridDefaultOrigin`.
 8. `electron/main/backend/install-manager.ts` exposes install, remove, `check-installed`, `list-installed`, and availability IPC handlers.
 9. `list-installed` already supports optimized Spark checks with a `pkgnameList`, and full APM listing marks dependencies by desktop-entry availability. Sync filtering should reuse these facts rather than scanning arbitrary system packages.
 The Spark developer manual identifies this repository as the current Electron GUI store (`apm-app-store` behavior), while `amber-pm` owns package-management semantics after commands leave the GUI.
 ## Backend Design
 ### User Profile Extension
 The existing backend auth flow remains unchanged at the boundary: `POST /auth/flarum` receives `flarum_user_id` and `flarum_token`, validates the token owner, upserts the local user, and returns a Spark Store JWT.
 The Flarum validation service should also extract user group data from the authenticated actor when available. The backend stores a compact `forum_level` string and optional `forum_groups` JSON/text summary. If Flarum does not expose groups, `forum_level` falls back to `论坛用户`.
 `GET /me` should return existing profile fields plus the forum level fields needed by the client. Existing clients remain compatible because new fields are additive.
 ### Favorite Folders
 Add backend tables:
 1. `favorite_folders`: id, user_id, name, created_at, updated_at. Folder names are user-scoped and unique per user. A folder named `默认收藏夹` is created on first favorite action if the user has no folders.
 2. `favorite_items`: id, folder_id, app_key, pkgname, name, category, icon_url, created_at. Items are unique per folder and `app_key`.
 Favorites are stored as app-level identities. The canonical app key for favorites should be stable across Spark/APM variants when the same user-facing app exists in both sources:
 ```text
 favorite_app_key = app:{category}:{pkgname}
 ```
 The item keeps `pkgname`, display `name`, `category`, and optional `icon_url`. It does not permanently bind to Spark or APM. During install, the client resolves the current catalog entry and chooses Spark/APM according to current availability and priority rules.
 Backend endpoints:
 1. `GET /me/favorite-folders`: list folders with item counts.
 2. `POST /me/favorite-folders`: create folder with custom name.
 3. `PATCH /me/favorite-folders/{folder_id}`: rename folder.
 4. `DELETE /me/favorite-folders/{folder_id}`: delete folder and its items.
 5. `GET /me/favorite-folders/{folder_id}/items`: list items.
 6. `POST /me/favorite-folders/{folder_id}/items`: add or idempotently keep an app favorite.
 7. `DELETE /me/favorite-folders/{folder_id}/items/{item_id}`: remove one item.
 8. `POST /me/favorite-folders/{folder_id}/items/bulk-delete`: remove selected items, including invalid/downlisted entries.
 All endpoints require JWT.
 ### Downloaded Records
 Add `downloaded_apps`: id, user_id, app_key, pkgname, name, category, selected_origin, version, package_arch, downloaded_at.
 Client behavior:
 1. If the user is logged in when clicking download, the client posts a downloaded record after queuing the install task.
 2. If the user is anonymous, the download proceeds normally and no cloud record is written.
 3. Logging in later does not backfill anonymous downloads.
 Backend endpoints:
 1. `GET /me/downloaded-apps`: list newest downloaded records with pagination.
 2. `POST /me/downloaded-apps`: upsert or append a downloaded record. MVP can append history; duplicate suppression by `user_id`, `app_key`, and `selected_origin` is acceptable if tests define it.
 ### Installed Sync List
 The existing `GET /me/app-list` and `PUT /me/app-list` endpoints remain the default cloud installed-app list.
 Client sync payload contains only store-recognized listed apps:
 1. App must exist in the current loaded Spark/APM catalog.
 2. `category !== "unknown"`.
 3. `isDependency !== true`.
 4. App has usable `pkgname` and `origin`.
 Unknown system packages, dependencies, and packages not in the store catalog are excluded.
 ## Client Design
 ### Account Entry And Login
 Move the account entry into the upper-left logo/title area currently owned by the sidebar. The logo remains visible while anonymous. The title text becomes `登录 / 注册` with helper text `星火账号`.
 After login:
 1. The logo image is replaced by the user's avatar when available.
 2. The main text is the user's display name or username.
 3. Clicking the account entry opens a quick menu.
 4. The quick menu includes: `用户管理`, `我的收藏`, `论坛首页`, `修改论坛资料`, and `退出登录`.
 Login modal:
 1. Contains forum account and password inputs.
 2. Posts credentials directly to Flarum `/api/token`.
 3. Sends the returned Flarum token and user id to the backend.
 4. Provides `注册账号` button that opens the Flarum registration page externally.
 5. Never logs or stores the forum password.
 ### Anonymous Behavior
 Anonymous users can still:
 1. Browse homepage and categories.
 2. Search.
 3. View app details.
 4. Download/install apps.
 5. Remove installed apps.
 6. Use update center.
 7. View installed apps.
 When anonymous users use account-only actions, show a login/register prompt instead of blocking the whole page. Account-only actions are comments, submit review, favorite, cloud favorites, downloaded history, and cloud sync.
 ### Detail Page
 Replace the overlay detail modal with a main-content detail page inside the same area currently used by `AppGrid` and `HomeView`.
 State model:
 1. `currentView` or equivalent distinguishes `list`, `home`, and `detail`.
 2. Opening an app stores the previous list context and selected app.
 3. Back returns to the prior list/search/category state.
 4. Screen preview can remain an overlay because it is secondary media UI.
 The detail page keeps existing detail capabilities:
 1. Spark/APM merged app source switch.
 2. Install/open/remove actions.
 3. Metadata and screenshots.
 4. Download count.
 New detail capabilities:
 1. Favorite button.
 2. Favorite folder selector.
 3. Comments/reviews panel with login prompt for anonymous users.
 4. Download click writes a cloud downloaded record only when logged in.
 ### Favorites Management
 The user management area includes favorite folder management.
 Users can:
 1. List favorite folders.
 2. Create folders with custom names.
 3. Rename folders.
 4. Delete folders.
 5. View folder items.
 6. Remove selected items.
 7. Batch remove invalid/downlisted items.
 8. Select all available items and send them to the download queue.
 Availability resolution is client-side because it depends on the current catalog, architecture, Spark/APM availability, store filter, and priority rules.
 Favorite item states:
 1. `installable`: found in catalog and current source/architecture can install a preferred variant.
 2. `installed`: already installed locally.
 3. `platform-unavailable`: item exists but neither Spark nor APM variant is usable under current store filter/capability.
 4. `arch-unavailable`: item exists in catalog metadata but not for the current architecture.
 5. `downlisted`: item no longer exists in the loaded catalog.
 Batch install uses current preference:
 1. If only one usable variant exists, use it.
 2. If both Spark and APM variants exist, use `getHybridDefaultOrigin` and the current store filter/availability to choose.
 3. If the preferred variant is unavailable, use the other usable variant.
 4. If no usable variant exists, do not queue it and show the reason.
 ### Downloaded Records
 When a logged-in user clicks download/install from detail, favorites, restore, or installed sync restore flows, the client records the selected app to the backend after the queue item is created.
 Downloaded records are visible in user management. They are informational and do not alter the install queue automatically.
 ### Startup Installed Sync
 On startup, the client refreshes installed packages in the background after the catalog is loaded enough to provide package lists.
 Flow:
 1. Load Spark/APM catalog as normal.
 2. Call existing `list-installed` IPC for enabled origins. Use optimized package-name checks where possible for Spark and full APM listing where needed, following the current installed modal/update-center patterns.
 3. Merge results with catalog metadata.
 4. Filter to store-recognized non-dependency apps.
 5. If logged in and the user has not made a cloud sync decision, ask once whether to enable automatic installed-list sync.
 6. If enabled, upload the default app list via `PUT /me/app-list`.
 7. If disabled or anonymous, keep the refreshed list local only.
 The confirmation preference is stored locally. A user can later change it from user management.
 ## Data Flow
 ### Login
 1. User opens login modal from the upper-left account entry.
 2. Client posts credentials to Flarum `/api/token`.
 3. Flarum returns token and user id.
 4. Client posts token and user id to backend `/auth/flarum`.
 5. Backend validates token owner, stores profile and forum level, and returns Spark JWT.
 6. Client stores Spark JWT and profile in local auth state.
 ### Favorite Add
 1. Logged-in user clicks favorite on detail page.
 2. Client fetches or creates favorite folders if needed.
 3. User selects a folder.
 4. Client posts app-level identity to backend favorite item endpoint.
 5. UI updates folder item count and favorite state.
 ### Batch Install From Favorites
 1. User opens a favorite folder.
 2. Client resolves each favorite item against current catalog and install facts.
 3. UI shows installable, installed, unavailable, arch-unavailable, and downlisted states.
 4. User selects installable items or clicks select all installable.
 5. Client maps each item to the chosen Spark/APM `App` object based on current priority rules.
 6. Client calls existing `handleInstall(app)` for each selected item.
 7. If logged in, client records downloaded apps to backend after queueing.
 ## Error Handling
 1. Login failure from Flarum or backend shows a local error in the login modal and clears partial auth state.
 2. Expired backend JWT logs the user out or prompts re-login when an account endpoint returns `401`.
 3. Favorites and downloaded-record failures do not block base install; show a non-fatal account sync error.
 4. Startup sync failure does not block app startup; it shows a user-management warning and can be retried manually.
 5. Batch install skips unavailable/downlisted items and reports counts per state.
 6. Backend rejects extra fields and invalid lengths with `422`.
 ## Testing And Verification
 Backend tests:
 1. Favorite folder creation, default folder creation, rename, delete, and user isolation.
 2. Favorite item add/remove/idempotency and folder scoping.
 3. Downloaded record create/list and user isolation.
 4. Forum level extraction fallback.
 5. Existing auth/reviews/app-list tests remain passing.
 6. Alembic migration upgrade succeeds.
 Client tests:
 1. Account entry anonymous/logged-in rendering and quick menu actions.
 2. Login modal emits login and opens register URL.
 3. Auth state persistence and backend token handling.
 4. Detail page replaces the list area and back returns to list state.
 5. Favorite folder selector login gating and folder selection.
 6. Favorite availability resolver for installable, installed, platform-unavailable, arch-unavailable, and downlisted states.
 7. Batch install selects Spark/APM variant according to current priority rules.
 8. Startup sync filtering includes only store-listed non-dependency Spark/APM apps.
 9. User management renders profile, forum level, forum links, favorite folders, downloaded records, and sync preference.
 10. Existing install, update center, installed apps, search, and grid tests remain passing.
 Final client verification:
 1. `npm run test`
 2. `npm run lint`
 3. `npm run build:vite`
 Final backend verification:
 1. `.venv/bin/pytest -v`
 2. `DATABASE_URL=<fresh test url> .venv/bin/alembic upgrade head`
 ## Implementation Notes
 1. Use a clean client worktree or fresh clone from `https://gitee.com/erotica-rbqs/spark-store` before implementing. Do not mix previous untracked planning artifacts into code commits.
 2. Keep backend and client commits separate.
 3. Add `.superpowers/` to `.gitignore` so visual companion artifacts remain local.
 4. Preserve existing IPC contracts for install and update flows.
 5. Do not change `amber-pm` package-management behavior; only reuse GUI-side install queue paths.
 6. Keep UI components focused: account entry/menu, login modal, detail page, favorite selector, user management, and favorite folder manager should be separate components rather than expanding `App.vue` further.
@@ -0,0 +1,374 @@
 # Spark Account Reviews Sync Design
 ## Goal
 Add a first-version account feature to Spark Store that uses the existing Flarum forum at `https://bbs.spark-app.store/` as the identity provider, while storing Spark Store-specific data in a new Python + MySQL backend.
 The MVP covers:
 1. Login with a Flarum account.
 2. Show the logged-in user's avatar and display name in the client.
 3. Show and submit app detail page comments with 1-5 star ratings.
 4. Attach immutable automatic local tags to reviews and support review filtering by those tags.
 5. Sync the user's local store-recognized app list so a new device can quickly reinstall old apps.
 6. Create a new backend Git repository named `spark-store-backend`.
 ## Scope
 ### Included In MVP
 1. Client-side Flarum token login.
 2. Backend validation of Flarum tokens and backend JWT issuance.
 3. User profile display in the Spark Store client.
 4. Review list, rating summary, review creation, and editing the current user's own review.
 5. Review filtering by automatic tags: app version, package architecture, client architecture, distro, origin, and category.
 6. A default per-user cloud app list that is overwritten on each sync.
 7. Restore UI that lets users choose cloud-list apps and add them to the existing install queue.
 ### Excluded From MVP
 1. Admin moderation UI.
 2. Review reports, bans, anti-spam scoring, or manual approval workflows.
 3. Synchronizing reviews into Flarum discussions.
 4. Multiple named app-list snapshots or historical list versions.
 5. Syncing unknown system packages, dependencies, or every package from `dpkg`/APM.
 6. Automatic unattended install on a new device.
 ## Existing Client Context
 The current Spark Store client in this repository is an Electron + Vue 3 + TypeScript app.
 Important existing integration points:
 1. `src/components/AppDetailModal.vue` owns the app detail modal. It already renders app metadata, screenshots, install/open/remove actions, and download counts.
 2. `src/components/InstalledAppsModal.vue` owns the installed-app list UI.
 3. `src/App.vue` coordinates modal state, installed-app loading, detail opening, and existing install queue calls.
 4. `electron/main/backend/install-manager.ts` already exposes `check-installed` and `list-installed` IPC handlers.
 5. Existing install queue behavior should be reused for restore installs rather than creating a second install system.
 ## Architecture
 Use the lightweight new-backend architecture confirmed during brainstorming.
 Components:
 1. Spark Store client: Vue/Electron UI, local app metadata, local package detection, and install queue integration.
 2. Flarum forum: authoritative identity provider for forum username, display name, and avatar.
 3. New Python backend: FastAPI service that verifies Flarum tokens, signs Spark Store JWTs, and owns reviews, ratings, and app-list sync data.
 4. MySQL database: persistent storage for local user mappings, app keys, reviews, rating aggregates, and synced app-list items.
 The new backend must not receive the user's forum password in the selected MVP flow.
 ## Authentication Flow
 1. The client shows a login form for the Flarum username/email and password.
 2. The client posts credentials directly to Flarum's token API.
 3. Flarum returns an access token and user id.
 4. The client sends the Flarum token and user id to the new backend `POST /auth/flarum`.
 5. The backend calls Flarum API with that token to verify it and retrieve the user profile.
 6. The backend upserts a local user row keyed by `flarum_user_id`.
 7. The backend returns a Spark Store JWT plus public profile fields: display name, username, avatar URL, and Flarum user id.
 8. The client stores the Spark Store JWT for backend calls and displays the avatar/name in the header or account area.
 Logout clears local Spark Store auth state. MVP logout does not need to revoke the Flarum token remotely.
 ## Review And Rating Design
 ### App Identity
 Reviews are keyed by a stable app key derived from store metadata:
 ```text
 app_key = {origin}:{store_arch}:{category}:{pkgname}
 ```
 Examples:
 ```text
 spark:amd64-store:tools:spark-store
 apm:amd64-apm:office:wps
 ```
 This separates Spark and APM apps when they share a package name, while still allowing the UI to show each source independently in the existing hybrid detail modal.
 ### Automatic Review Tags
 When a logged-in user writes a review, the client sends automatic tags derived from the currently viewed app and local system. The user can preview these tags but cannot edit them.
 Required tags:
 1. `origin`: `spark` or `apm`.
 2. `category`: current store category.
 3. `pkgname`: current package name.
 4. `version`: current app/package version shown in the detail page.
 5. `package_arch`: package architecture if known from installed-app data or store filename metadata.
 6. `client_arch`: `window.apm_store.arch` such as `amd64`, `arm64`, or `loong64`.
 7. `distro`: local Linux distribution id/version when available from the Electron main process.
 If `package_arch` or `distro` cannot be detected, the client sends an empty string or `unknown`; the backend stores the value exactly as submitted after validation.
 ### Review UI
 Add a `ReviewsPanel`-style component inside `AppDetailModal.vue`, below the existing app description and screenshot sections.
 Behavior:
 1. Anonymous users can read reviews and rating summary.
 2. Anonymous users see a login prompt instead of the review composer.
 3. Logged-in users can select a 1-5 rating and submit text content.
 4. The composer displays the automatic tags as read-only pills.
 5. The list supports filters for current version, current architecture, current distro, origin, category, and rating.
 6. Users can switch filters to view comments under other versions or architectures.
 7. The review list uses pagination or cursor-based loading to avoid loading all reviews at once.
 ### Review Rules
 MVP review rules:
 1. Rating must be an integer from 1 to 5.
 2. Content must be non-empty after trimming and have a backend-enforced maximum length.
 3. A user can have one active review per `app_key` plus exact automatic-tag tuple.
 4. Submitting again for the same `app_key` and tag tuple updates the existing review.
 5. Backend timestamps use UTC.
 ## App List Sync Design
 ### Upload Source
 The client uses the existing installed-app flow as the source of local software state.
 For MVP, upload only apps that satisfy all conditions:
 1. App exists in the Spark/APM store catalog loaded by the client.
 2. `category !== "unknown"`.
 3. `isDependency !== true`.
 4. The app has a usable `pkgname` and `origin`.
 This intentionally excludes unknown system packages, dependencies, and packages that the store cannot reinstall safely.
 ### Sync UI
 Extend `InstalledAppsModal.vue` with account-aware actions:
 1. `同步到账号`: uploads the filtered installed app list as the user's default cloud list.
 2. `从账号恢复`: fetches the default cloud list and opens a restore selection view.
 The restore view shows each cloud item with one of these states:
 1. Already installed locally.
 2. Available to install on this client.
 3. Not available for the current architecture/source.
 The user explicitly selects items and starts restore. Restore uses the existing `handleInstall` and install queue path in the client.
 ### Cloud List Semantics
 MVP maintains one default cloud app list per user.
 Each successful sync replaces the previous default list. This avoids list merge conflicts in the first version.
 ## Backend Repository
 Create a new sibling repository:
 ```text
 /home/spark/Desktop/shenmo-spark-store/spark-store-backend
 ```
 Initialize it as a new Git repository and set origin to:
 ```text
 https://gitee.com/momen_official/spark-store-backend.git
 ```
 The initial repository should include a `README.md`. Feature implementation can then add backend code, migrations, tests, and configuration templates.
 ## Backend Technology
 Use:
 1. FastAPI for HTTP APIs.
 2. SQLAlchemy for ORM models.
 3. Alembic for database migrations.
 4. PyMySQL or mysqlclient for MySQL connectivity.
 5. Pydantic settings for environment configuration.
 6. Pytest for backend tests.
 Configuration should come from environment variables, with `.env.example` committed and real `.env` ignored.
 ## Backend API
 ### Auth
 `POST /auth/flarum`
 Request:
 ```json
 {
  "flarum_user_id": "123",
  "flarum_token": "..."
 }
 ```
 Response:
 ```json
 {
  "access_token": "spark-store-jwt",
  "token_type": "bearer",
  "user": {
    "id": 1,
    "flarum_user_id": "123",
    "username": "shenmo",
    "display_name": "shenmo",
    "avatar_url": "https://..."
  }
 }
 ```
 `GET /me`
 Returns the current backend user profile from the Spark Store JWT.
 ### Reviews
 `GET /apps/{app_key}/rating-summary`
 Returns average rating, review count, and per-star counts.
 `GET /apps/{app_key}/reviews`
 Query parameters:
 1. `version`
 2. `package_arch`
 3. `client_arch`
 4. `distro`
 5. `origin`
 6. `category`
 7. `rating`
 8. `page` and `page_size`
 `POST /apps/{app_key}/reviews`
 Requires JWT. Creates or updates the current user's review for the same app and automatic-tag tuple.
 Request:
 ```json
 {
  "rating": 5,
  "content": "Works well on my machine.",
  "tags": {
    "origin": "apm",
    "category": "office",
    "pkgname": "wps",
    "version": "1.0.0",
    "package_arch": "amd64",
    "client_arch": "amd64",
    "distro": "deepin 25"
  }
 }
 ```
 ### App List Sync
 `GET /me/app-list`
 Requires JWT. Returns the current user's default cloud app list.
 `PUT /me/app-list`
 Requires JWT. Replaces the current user's default cloud app list.
 Request:
 ```json
 {
  "client_arch": "amd64",
  "distro": "deepin 25",
  "items": [
    {
      "pkgname": "spark-store",
      "origin": "spark",
      "category": "tools",
      "version": "5.1.1",
      "package_arch": "amd64",
      "app_name": "Spark Store",
      "icon_url": "https://..."
    }
  ]
 }
 ```
 `POST /me/app-list/install-plan`
 Requires JWT. Accepts current client catalog/install facts and returns a normalized plan with installed, installable, and unavailable items. The client may also compute this locally, but the endpoint gives the backend a stable contract for future clients.
 ## Database Model
 Tables:
 1. `users`: local user id, Flarum user id, username, display name, avatar URL, timestamps.
 2. `apps`: app key, pkgname, origin, store arch, category, latest seen version, timestamps.
 3. `reviews`: app id, user id, rating, content, automatic tag columns, timestamps.
 4. `user_app_lists`: user id, snapshot name, client arch, distro, timestamps.
 5. `user_app_list_items`: list id, pkgname, origin, category, version, package arch, app name, icon URL, timestamps.
 Indexes:
 1. Unique `users.flarum_user_id`.
 2. Unique `apps.app_key`.
 3. Index `reviews.app_id` plus tag filter columns.
 4. Unique review key for user, app, version, package arch, client arch, distro, origin, and category.
 5. Unique default app list per user.
 ## Error Handling
 Client behavior:
 1. If Flarum login fails, show a login error without contacting the backend.
 2. If backend token exchange fails, show a backend login error and clear partial auth state.
 3. If review loading fails, keep the app detail page usable and show a retry affordance in the review panel.
 4. If app-list sync fails, keep the local installed-app modal usable and show the failure message near the sync action.
 5. If restore install queuing fails for one item, keep the remaining selected items visible and report which item failed.
 Backend behavior:
 1. Invalid Flarum token returns `401`.
 2. Invalid JWT returns `401`.
 3. Invalid app key, rating, or tag payload returns `422`.
 4. Database errors return `500` with safe generic messages and structured server logs.
 ## Security Notes
 1. The new backend never receives forum passwords in the selected MVP architecture.
 2. Real secrets, JWT keys, database URLs, and Flarum tokens must not be committed.
 3. The Electron client must avoid logging Flarum tokens and backend JWTs.
 4. Backend JWT expiry should be finite; refresh can be handled by reauth in MVP.
 5. CORS should be restricted to expected client origins in production.
 ## Testing And Verification
 Client verification:
 1. Unit tests for review tag construction.
 2. Unit tests for installed-app sync filtering.
 3. Component tests for review panel anonymous/logged-in states.
 4. Component tests for sync and restore UI states.
 5. Existing `npm run lint` and `npm run build:vite` after implementation.
 Backend verification:
 1. Unit/API tests for `/auth/flarum` with mocked Flarum responses.
 2. API tests for review creation, update, listing, filtering, and rating summary.
 3. API tests for app-list upload and retrieval.
 4. Migration verification against MySQL or a compatible test database.
 ## Open Implementation Notes
 1. Detecting `distro` should be done through Electron main process IPC, preferably by reading `/etc/os-release` and exposing a small safe object to the renderer.
 2. Package architecture can come from installed-app data when available; otherwise parse from filename only if reliable, falling back to `unknown`.
 3. The existing `AppDetailModal.vue` is already large, so review UI should be isolated into a new child component rather than expanding all logic inline.
 4. Restore installation should reuse existing app lookup and `handleInstall` code to preserve Spark/APM origin behavior.
@@ -0,0 +1,43 @@
 # App Detail Fixed Sidebar Scroll Design
 ## Goal
 In the app detail popup, keep the left app action/meta area fixed on desktop while only the right content area scrolls. Preserve the existing modal/popup visual style and mobile behavior.
 ## Scope
 This change only affects `src/components/AppDetailModal.vue` and its unit tests. It does not change app identity, review behavior, install behavior, or the surrounding `App.vue` modal flow.
 ## Desktop Layout
 For `lg` and wider screens:
 1. The modal overlay remains a centered popup with the existing dim background.
 2. `.modal-panel` keeps the rounded card style but stops being the scroll container.
 3. `.modal-panel` uses a bounded height and `overflow-hidden` so the popup itself stays fixed.
 4. The modal body is split into two columns.
 5. The left column contains the return button, app icon/name, source selector, install/open/remove/favorite buttons, and metadata. This column does not scroll with wheel movement over the right side.
 6. The right column contains app details, screenshots, and reviews. This column is the independent vertical scroll container.
 ## Mobile Layout
 Below `lg`, keep the existing stacked modal behavior. The modal remains scrollable as a single column so small screens can still access all controls and content.
 ## Scroll Behavior
 Wheel scrolling over normal modal content should scroll the right content column on desktop. The overlay wheel guard remains in place so the background page does not scroll through the modal.
 ## Testing
 Update `AppDetailModal.test.ts` to assert:
 1. The popup still renders as a fixed modal overlay with `.modal-panel`.
 2. `.modal-panel` uses `overflow-hidden` instead of being the primary vertical scroll container on desktop.
 3. The left fixed column and right scroll column have stable test selectors.
 ## Acceptance Criteria
 1. Desktop: left A column remains visually fixed while right B column scrolls.
 2. Mobile: stacked layout remains usable.
 3. Existing detail modal behavior remains intact.
 4. Unit tests and Vite build pass.
@@ -0,0 +1,59 @@
 # Client UI Polish Design
 ## Goal
 Fix the client-side account, favorites, review, sync, and shell UI issues reported during QA without changing backend contracts in this pass.
 ## Scope
 This pass is client-only. It can change Vue components, renderer state, Electron window chrome, tests, and docs. It must not invent successful backend behavior for review likes, replies, or deletes until backend endpoints exist.
 ## User-Visible Requirements
 - Long account names must not overflow the sidebar account entry or account quick menu.
 - Account quick-menu actions must close the menu immediately after selection.
 - User management must open as a global modal/popup overlay instead of replacing only the right content frame.
 - User management should render a profile-cover hero when a user has a background/cover URL, with a safe fallback when absent.
 - Favorites should not show duplicate default-folder entries.
 - The favorite selector must expose a visible new-folder action.
 - Clicking a favorite item row should open app detail; the checkbox should remain only for bulk selection.
 - The detail favorite button should show favorited state as `已收藏`, and opening it should allow switching folder or cancelling the favorite when client data can identify the existing item.
 - Review rating input should use clickable/star UI instead of a native select.
 - Reviews should expose architecture and OS/distro filters.
 - Review cards should expose user detail entry points from avatar/name and show client-side action affordances for like/reply/delete. Delete must be visibly limited to the author/admin; persistence is deferred until backend APIs exist.
 - The system title bar should be replaced by a frameless Electron window with an app-rendered title bar and window controls.
 - Selected category capsule color must remain `#2B7FFF`.
 - Manual sync must show visible feedback where the user clicked it.
 - Restore-from-account should resolve cloud items by same origin first, then fall back to same package across Spark/APM when the exact origin is not loaded.
 ## Architecture
 Keep existing component boundaries and make small additions:
 - `App.vue` remains the state coordinator for account modals, favorites, sync, and restore.
 - Add a small reusable `UserManagementModal.vue` wrapper around existing `UserManagementView.vue` instead of restructuring the view.
 - Add a `WindowTitleBar.vue` component and Electron IPC handlers for minimize/maximize/close, preserving the existing close-to-tray guard.
 - Keep review API calls in `backendApi.ts`; client-only review actions emit UI feedback until backend endpoints are added.
 - Add pure helper functions for sync restore candidate resolution so cross-source matching can be unit-tested without mounting the full app.
 ## Data Flow
 - Account menu emits actions to `App.vue`; `App.vue` toggles modal state and loads downloaded history before showing user management.
 - Favorites are loaded from existing folder/item endpoints. `App.vue` computes current detail favorite metadata from loaded folders/items and passes status to detail components.
 - Review filters are local to `ReviewsPanel.vue`; they filter loaded review records by package architecture and distro string.
 - Sync feedback is stored in existing `syncStatusMessage` and passed to both `UserManagementView` and `InstalledAppsModal`.
 - Restore resolution uses `resolveCloudInstallCandidate(item, apps)` with exact origin/category preference and package-name fallback.
 ## Deferred Backend Work
 The following need backend API work later:
 - Persistent review likes.
 - Review replies and reply listing.
 - Server-authorized review deletion.
 - Fetching arbitrary forum user profile details and cover images. This client pass supports cover URLs when present in `SparkUser`; it does not scrape forum HTML.
 ## Testing
 - Add/update unit tests for account modal behavior, quick-menu closing, user cover rendering, favorites selector normalization, star rating, review filters/actions, restore candidate resolution, and titlebar IPC/config.
 - Run targeted Vitest files and `npm run build:vite` before completion.
@@ -0,0 +1,178 @@
 # 测试记录文档（Testing Records）
 > 用途：每次**修改代码后打包测试**都要在此追加一条记录，避免再次出现「改了 URL/逻辑后更新功能异常」这类回归问题。
 > 维护约定（用户 2026-08-13 明确要求）：
 > 1. **每次修改代码都必须打包测试**（开发/自测统一用 `./scripts/test-build.sh`，产物带 `-test` 标签）。
 > 2. 打包前先在此文档新增一条记录：填写修改功能、建议测试方式、预期结果。
 > 3. 打包完成（真机或构建通过后）**回填测试结果**（通过 / 失败 + 现象 + 修复动作）。
 > 4. 涉及更新中心 / 下载 / 安装 / metalink / 网络 URL 等改动时，必须包含「更新中心实际勾选升级一个应用，观察日志是否推进到下载与安装」这一回归项。
 ---
 ## 记录格式（复制此模板填写）
 ```
 ### [版本号] 日期 — 一句话主题
 - 修改功能：
 - 涉及文件：
 - 建议测试方式：
 - 预期结果：
 - 构建验证：vue-tsc / 打包（PASS / FAIL）
 - 测试结果：（待回填）
  - 真机现象：
  - 结论：通过 / 失败
  - 失败修复：
 ```
 ---
 ## 历史记录
 ### [5.2.1.31-test] 2026-08-13 — 更新中心 hold 锁定标签 + 强制安装 + 修复安装失败误报"下载完成"
 - 修改功能：
  1. 更新中心识别 `apt-mark hold` 锁定的包：默认不可选中，显示「已锁定」标签；提供「强制安装」开关，开启后 spark 源 ssinstall 追加 `--allow-change-held-packages`。
  2. 修复安装失败误报：ssinstall 放弃安装时仍以退出码 0 结束，原逻辑误判成功导致 UI 显示「下载完成」；现检测 `放弃安装`/`dry-run测试仍然失败` 等标志判失败，并按任务来源显示「更新完成/更新失败」或「安装完成/安装失败」。
 - 涉及文件：
  - 后端：`update-center/types.ts`、`update-center/index.ts`、`update-center/service.ts`、`install-manager.ts`
  - 前端：`typedefinition.ts`、`modules/updateCenter.ts`、`modules/processInstall.ts`、`components/update-center/UpdateCenterItem.vue`、`components/update-center/UpdateCenterList.vue`、`components/UpdateCenterModal.vue`
 - 建议测试方式：
  1. 更新中心打开，确认被 hold 的包（如 `code`）显示「已锁定」、复选框禁用、顶部提示条出现。
  2. 勾选其它普通更新项 → 开始更新 → 观察日志推进到「正在获取 Metalink」→ 下载进度 → 安装完成（不是「下载完成」）。
  3. 打开 `code` 的「强制安装」开关 → 复选框可用、标签变「将强制」→ 勾选并升级 → 观察是否正常升级（需本机 `code` 被 hold 才能验证）。
  4. 回归：用「更新中心实际升级一个普通应用」验证 metalink/下载/安装全链路未被本次改动破坏（此前 28-test 因 metalinkUrl 域名误杀出过同类问题）。
 - 预期结果：hold 项默认不可选；强制开关可单独升级 hold 包；安装失败时明确显示「安装失败」而非「下载完成」；普通更新链路正常。
 - 构建验证：vue-tsc 通过（exit 0）；`scripts/test-build.sh` 打包成功，产物 `spark-store_5.2.1.31-test_amd64.deb`。
 - 测试结果：真机验证发现"失效"现象（见下方 32-test 修复说明）。
  - 真机现象：用户装 31-test 后从更新中心点更新，日志仅 `[14:28:23] 开始更新...` 一行后无进展。
  - 结论：非代码 bug，是 31 新增的 hold 拦截**正确行为**——用户测试的包（code）被 `apt-mark hold` 锁定，31 默认拦截它；但用户未开启该行的「强制安装」开关就点开始更新，后端 `start()` 把它过滤掉后**静默 return**，前端无任何提示，造成"只有一行日志"的观感。
  - 失败修复：32-test 修复后端 `start()` 静默拦截问题——对被 hold 且未强制的选中项，明确向前端发送 `install-complete` 失败通知（提示"已在更新中心默认跳过，请开启强制安装后重试"），不再静默卡住。
 ### [5.2.1.32-test] 2026-08-13 — 修复被 hold 包未强制时更新中心"静默卡开始更新"
 - 修改功能：后端 `update-center/service.ts` 的 `start()` 不再对"被锁定(hold)且未开启强制安装"的选中项静默跳过。改为：先分离可启动项与被锁拦截项；对被锁拦截项向前端发送明确的 `install-complete` 失败通知（携带提示文案）；仅对真正可启动的项调用 `addInstallTask`。前端 `processInstall.ts` 的 install-complete handler 会将失败解析为「更新失败：...」，用户能看到原因而非停在「开始更新...」。
 - 涉及文件：`update-center/service.ts`（仅后端；前端复用已有的 install-complete 失败显示逻辑，无需改）。
 - 建议测试方式：
  1. 更新中心勾选一个**普通（未 hold）**的更新项 → 开始更新 → 日志应推进到「正在获取 Metalink」→ 下载进度 → 更新完成（确认 31 的 hold 改动未破坏普通更新链路）。
  2. 勾选一个**被 hold** 的包（如 `code`）且**不开**其「强制安装」开关 → 开始更新 → 日志应显示「更新失败：...被系统锁定(hold)...请开启强制安装后重试」，而非只有「开始更新...」。
  3. 开启该 hold 包的「强制安装」开关 → 勾选并升级 → 应正常进入下载/安装（验证强制路径）。
 - 预期结果：普通更新正常；hold 未强制时给出明确失败提示而非静默卡住；hold 强制后可正常升级。
 - 构建验证：vue-tsc 通过（exit 0）；`scripts/test-build.sh` 打包成功，产物 `spark-store_5.2.1.32-test_amd64.deb`。
 - 测试结果：失败。
  - 真机现象：用户装 32-test 后，对 `code` 开启「强制安装」开关再点「更新选中」，日志仍只有 `[14:59:28] 开始更新...` 一行后无进展；同时「更新选中」后该包从更新中心列表消失，未保留。
  - 失败原因：
    1. `service.ts` 的 `start()` 中 `taskIdByKey` 只存储了 `task.id`（数字），后续读取 `taskIdByKey.get(taskKey)?.forceHeld` 永远为 `undefined`，导致「强制安装」开关状态丢失；被 hold 包即使开启强制仍被当作未强制拦截。
    2. held 阻断通知代码里 `webContents` 在通知循环之后才获取，导致通知实际未发出（但 32 中因原因 1 已把强制项也拦截，所以主要表现为卡住）。
    3. `start()` 启动任务后主动从 `currentItems` 过滤掉已启动项，导致用户点击「更新选中」后包立刻从更新中心消失。
  - 失败修复：见 33-test 记录。
 ### [5.2.1.33-test] 2026-08-13 — 修复强制安装开关失效 + 更新选中后列表消失 + 工具栏布局优化
 - 修改功能：
  1. 修复 `update-center/service.ts` 中 `taskIdByKey` 仅保存 `id` 导致 `forceHeld` 丢失的 bug：改为保存完整 `UpdateCenterStartTask` 对象，确保「强制安装」开关状态能正确传递到 `addInstallTask`。
  2. 提前获取 `webContents` 到 held 阻断通知之前，确保被 hold 且未强制的项能向前端发送明确的 `install-complete` 失败通知。
  3. 移除 `start()` 中启动后从更新中心 `items` 删除已选包的逻辑，保持列表不变，等待用户刷新或任务完成后再消失。
  4. 优化 `UpdateCenterToolbar.vue`：将「全选」复选框和已选计数移到「更新选中」按钮同一行，缩短选择-执行操作路径。
 - 涉及文件：
  - 后端：`electron/main/backend/update-center/service.ts`
  - 前端：`src/components/update-center/UpdateCenterToolbar.vue`
 - 建议测试方式：
  1. 更新中心勾选普通未 hold 包 → 开始更新 → 日志推进到「正在获取 Metalink」→ 下载/安装完成（非「下载完成」、非卡死）。
  2. 被 hold 包（如 `code`）不开「强制安装」→ 开始更新 → 明确提示「更新失败：...被系统锁定(hold)...请开启强制安装后重试」，不只有「开始更新...」。
  3. 被 hold 包开启「强制安装」→ 勾选并升级 → 应正常进入下载/安装流程（ssinstall 命令带 `--allow-change-held-packages`）。
  4. 点击「更新选中」后，已选包仍保留在更新中心列表中，不会立即消失。
  5. 观察更新中心工具栏：「全选」复选框、已选计数、「更新选中」按钮在同一行右侧，操作便捷。
 - 预期结果：强制安装真正生效；hold 未强制有明确失败提示；普通更新链路正常；更新选中后列表保留；工具栏操作更紧凑。
 - 构建验证：vue-tsc 通过（exit 0）；`scripts/test-build.sh` 打包成功，产物 `spark-store_5.2.1.33-test_amd64.deb`。
 - 测试结果：通过（用户确认优化与更新处理正确）。
  - 真机现象：用户装 33-test 后确认强制安装开关生效、hold 未强制有明确失败提示、普通更新链路正常。
  - 结论：通过
  - 遗留反馈：选中执行更新后，包进入下载列表却仍显示在更新中心（33-test 误删了"从列表移除已启动项"逻辑）；且全选按钮在无可选项时仍可点、无提示。两处已在 34-test 修复。
 ### [5.2.1.34-test] 2026-08-13 — 恢复更新后从列表移除 + 无可选项时全选禁用提示
 - 修改功能：
  1. 恢复 33-test 误删的逻辑：更新中心「更新选中」启动任务后，已启动项从更新中心 `items` 移除（被 hold 未强制拦截的项不在此列，仍保留供用户开强制重试）。更新中心只展示待更新项，避免与下载队列重复显示。
  2. `modules/updateCenter.ts` 新增 `selectableCount` computed（可选项数 = 未被忽略且非"held 未强制"的项数）。
  3. `UpdateCenterToolbar.vue`：当 `selectableCount === 0`（全是 hold 未强制、全是忽略项、或完全没有可更新软件）时，全选复选框 `:disabled` 且整体置灰，右侧文案改为「无可更新项」并带提示 title。
 - 涉及文件：
  - 后端：`electron/main/backend/update-center/service.ts`
  - 前端：`src/modules/updateCenter.ts`、`src/components/UpdateCenterModal.vue`、`src/components/update-center/UpdateCenterToolbar.vue`
 - 建议测试方式：
  1. 勾选若干普通更新项 → 更新选中 → 这些包应从更新中心列表消失，仅出现在下载队列（之前 33-test 会残留，现恢复）。
  2. 当列表里所有项都是 hold 未强制 / 已忽略，或列表为空时：全选复选框应禁用置灰、文案显示「无可更新项」，点击无反应；「更新选中」按钮也因无选中而禁用。
 - 预期结果：更新选中后不在更新中心残留；无可选项时全选禁用并提示。
 - 构建验证：vue-tsc 通过（exit 0）；`scripts/test-build.sh` 打包成功，产物 `spark-store_5.2.1.34-test_amd64.deb`。
 - 测试结果：待真机回填（本机无 GUI）。34-test 用户已确认更新后从列表移除、全选禁用提示均生效；但反馈开启强制后 code 仍更新失败（见 35-test 根因）。
  - 真机现象：
  - 结论：通过 / 失败
  - 失败修复：
 ### [5.2.1.35-test] 2026-08-13 — 修复强制安装在 ssinstall 本地文件模式误加 apt 标志
 - 修改功能：`install-manager.ts` 中 spark 源的 ssinstall 命令构建逻辑。此前对**本地 .deb 文件模式**（`metalinkUrl && filename`）也追加了 `--allow-change-held-packages`，但该选项不是 ssinstall 支持的参数（ssinstall 用法 `ssinstall [选项] <deb路径>`，选项仅自身专用），会被其透传给内部 `dirname`/`basename` 导致参数解析失败、包名丢失，进而 `E: 无法定位软件包` / `Package manager quit with exit code` 失败。
  - 本地 .deb 文件模式：改走 `dpkg` 直接安装，dpkg 安装本地文件**不受 apt `hold` 限制**（hold 仅拦截 `apt install <包名>` 从仓库升级），故**不再追加**该标志。
  - 仓库模式（`ssinstall pkgname`）：从 apt 仓库拉取，hold 会拦截，保留 `forceHeld` 时追加 `--allow-change-held-packages`。
 - 涉及文件：`electron/main/backend/install-manager.ts`（仅后端）。
 - 建议测试方式：开启 `code`（被 hold）的「强制安装」开关 → 勾选升级 → 日志应正常进入 ssinstall 本地 .deb 安装，不再出现 `dirname/basename 未识别的选项` 与 `无法定位软件包`，最终「更新完成」。
 - 预期结果：强制安装本地 .deb 不再因误加 apt 标志而失败；普通（未 hold）与仓库模式行为不变。
 - 构建验证：vue-tsc 通过（exit 0）；`scripts/test-build.sh` 打包成功，产物 `spark-store_5.2.1.35-test_amd64.deb`。
 - 测试结果：失败（用户 15:55 日志）。
  - 真机现象：开 code 强制 → 更新 → `E: 在更改保留软件包的同时使用了 -y 选项，但没有搭配 --allow-change-held-packages.` → `dry-run测试仍然失败，放弃安装` → 更新失败。
  - 根因：实测证实 ssinstall 本地 .deb 模式在 `dpkg -i` 失败后兜底 `aptss install <deb> -yfq`，aptss/apt 对 held 包用 `-y` 强制要求 `--allow-change-held-packages`；而 ssinstall 不识别该参数（透传给 dirname/basename 崩溃），故 35-test 去掉标志后仍被 apt 拒绝。35-test 方案（依赖 dpkg 不拦 hold）不成立。
  - 失败修复：见 36-test（改用 unhold/hold 包裹策略）。
 ### [5.2.1.36-test] 2026-08-13 — 强制安装改用 apt-mark unhold/hold 包裹（绕开 ssinstall 不支持该标志）
 - 修改功能：`install-manager.ts` 的强制安装（forceHeld）策略从"传 `--allow-change-held-packages` 给 ssinstall"改为"安装前 `pkexec apt-mark unhold`、安装后（finally）`pkexec apt-mark hold` 恢复锁定"。
  - 新增模块函数 `runAptMark(action, pkgname)`：`checkSuperUserCommand()` 取 pkexec，直接用 `pkexec apt-mark <hold|unhold> pkgname`（**不经过 shell-caller.sh**，因其白名单仅放行 apm/aptss/ssinstall，否则报"拒绝执行"）。
  - `runInstallPhase`：`try` 开头若 `task.forceHeld && task.origin==='spark'` 先 `runAptMark("unhold")`，`finally` 中无论成败都 `runAptMark("hold")` 恢复原锁定状态。
  - 移除 spark 源 ssinstall 命令中任何 `--allow-change-held-packages`（ssinstall 不识别）。
 - 涉及文件：`electron/main/backend/install-manager.ts`（仅后端；forceHeld 字段链路 service.ts→QueueInstallPayload→task 已就绪）。
 - 建议测试方式：开启 `code`（被 hold）的「强制安装」开关 → 勾选升级 → 日志应出现「正在解除系统锁定（hold）...」→ ssinstall 本地安装成功 → 最终「更新完成」；另查 `apt-mark showhold` 确认安装后 code 仍被锁定（状态恢复）。
 - 预期结果：强制安装 held 包成功；安装后 hold 状态自动恢复，不破坏用户原本的锁定。
 - 构建验证：vue-tsc 通过（exit 0）；`scripts/test-build.sh` 打包成功，产物 `spark-store_5.2.1.36-test_amd64.deb`。
 - 测试结果：未真机验证即发现更优方案（见 37-test）。36-test 的 `runAptMark` 用 `pkexec apt-mark` 会弹额外权限框，且 apt-mark 不在 policykit 免密 exec.path 内可能直接失败。
  - 失败修复：见 37-test（合并进商店已有免密 pkexec）。
 ### [5.2.1.37-test] 2026-08-13 — 强制安装合并进免密 pkexec（不重复请求权限）
 - 修改功能：用户指出"商店已有提权配置，unhold/hold 不必再请求权限"。调查确认 policykit 规则（`extras/store.spark-app.spark-store.policy`、`pkg/.../ssinstall.policy`）仅对 `exec.path=/opt/spark-store/extras/shell-caller.sh` 与 `/usr/local/bin/ssinstall` 设 `allow_any=yes`（免密）。`pkexec apt-mark` 不在任何 policy 的 exec.path → 弹额外密码框且可能失败。
  - `extras/shell-caller.sh` 新增 `force-ssinstall` 分支：在一次已提权的 pkexec 会话内执行 `apt-mark unhold <pkg>` → `ssinstall <deb> [额外参数] --native` → `apt-mark hold <pkg>`；unhold 失败仅警告不阻断，hold 无论成败都恢复；参数用双引号防注入、空参校验。
  - `install-manager.ts`：`forceHeld && origin==='spark' && 本地 .deb` 时，构造命令走 `shell-caller force-ssinstall <pkg> <deb> --delete-after-install --no-create-desktop-entry`（即复用 ssinstall 那条免密 pkexec，仅一次权限请求）；移除 36-test 的 `runAptMark` helper 及 runInstallPhase 的 try/finally 单独 pkexec apt-mark 调用。
 - 涉及文件：`extras/shell-caller.sh`、`electron/main/backend/install-manager.ts`。
 - 建议测试方式：开启 `code`（被 hold）「强制安装」→ 勾选升级 → 应**仅弹一次**权限框（与平时 ssinstall 一致）→ 日志 ssinstall 本地安装成功 → 更新完成；装后 `apt-mark showhold` 确认 code 仍锁定（已自动恢复）。
 - 预期结果：强制安装成功且只请求一次权限；hold 状态自动恢复。
 - 构建验证：vue-tsc 通过（exit 0）；`bash -n shell-caller.sh` 语法 OK；`scripts/test-build.sh` 打包成功，产物 `spark-store_5.2.1.37-test_amd64.deb`。
 - 测试结果：待真机回填（本机无 GUI）。
  - 真机现象：
  - 结论：通过 / 失败
  - 失败修复：
 ### [5.2.1.29-test / 5.2.1.30-test] 2026-08-13 — 修复更新中心卡"开始更新..." + metalinkUrl 域名误杀清理
 - 修改功能：
  1. 29-test 修复 metalinkUrl 校验写死 `erotica.spark-app.store` 误杀真实 CDN 域 `d.spark-app.store`：放宽为 `*.spark-app.store` 全子域 + https + path.posix.normalize 折叠 `./` + 拒绝 `..` 越界。
  2. 30-test 清理调试期噪声（[debug] 日志、FILENAME_PATTERN 拆分、stream error 监听、processInstall 自监听），保留真正修复。
 - 涉及文件：`install-manager.ts`、`processInstall.ts`
 - 建议测试方式：更新中心勾选并升级 `trae-cn` 等普通应用，观察日志推进到「正在获取 Metalink 文件」→ 下载进度。
 - 预期结果：更新中心更新功能恢复正常，不再卡「开始更新...」或「下载失败: Metalink URL 不合法」。
 - 构建验证：vue-tsc 通过；打包成功（29/30-test）。
 - 测试结果：用户确认 29-test 修复有效。
  - 真机现象：29-test 更新中心升级 trae-cn 正常推进到下载阶段。
  - 结论：通过
 ### [5.2.1.26-test ~ 5.2.1.28-test] 2026-08-13 — 更新中心"更新"卡死的多次排查
 - 修改功能：
  1. 26-test：抽离 `addInstallTask(payload, sender)`，`service.ts` 的 `start()` 直接调用（修复 `webContents.send("queue-install")` 主进程自环 bug，任务从未入队）；并加 FILENAME_PATTERN、各 return 分支补 install-complete 通知、metalink 流错误监听、[debug] 日志（部分属调试噪声，后续 30-test 回退）。
  2. 28-test：暴露真正根因 metalinkUrl 域名校验误杀 `d.spark-app.store`（见 29-test 修复）。
 - 涉及文件：`install-manager.ts`、`update-center/service.ts`
 - 建议测试方式：更新中心实际升级应用 + 普通安装对照。
 - 预期结果：更新中心任务能真正进入下载队列并推进。
 - 构建验证：vue-tsc 通过；打包成功。
 - 测试结果：
  - 28-test 日志首次暴露 metalinkUrl 域名误杀（见上方 29-test 修复）。
  - 结论：根因定位完成，29-test 修复通过
 ---
 ## 回归测试 checklist（每次打包必做核心项）
 - [ ] `vue-tsc --noEmit` 通过，`scripts/test-build.sh` 打包成功
 - [ ] **更新中心**：勾选并升级一个普通应用，日志推进 开始更新 → 正在获取 Metalink → 下载进度 → 安装完成（确认不是「下载完成」且非「开始更新...」卡死）
 - [ ] **普通安装**：应用详情页安装一个应用，确认链路正常
 - [ ] **忽略功能**：更新中心忽略/取消忽略一项，确认沉底与不可选
 - [ ] **hold/强制**（若改动更新中心）：被 hold 包默认不可选、强制开关可单独升级
 - [ ] 安装失败时 UI 明确显示「安装失败」而非「下载完成」
@@ -26,6 +26,7 @@ linux:
      Categories: "System;"
  mimeTypes:
    - "x-scheme-handler/spk"
    - "x-scheme-handler/apt"
  target:
    - "AppImage"
    - "deb"
@@ -8,6 +8,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import axios from "axios";
 import pino from "pino";
 import { findExecutable, SUPER_USER_COMMAND_CANDIDATES } from "./superuser";
 const logger = pino({ name: "shared-installer" });
@@ -105,8 +106,10 @@ export const downloadPackage = async ({
  onStatus?.("downloading");
-  // 下载重试逻辑：共10次，5次3秒，3次5秒，2次10秒
+  // 下载重试逻辑：共10次，指数退避，首次3秒，末次1分钟
-  const timeoutList = [3000, 3000, 3000, 3000, 3000, 5000, 5000, 5000, 10000, 10000];
+  const timeoutList = [
    3000, 4500, 6500, 9000, 13000, 18000, 26000, 36000, 50000, 60000,
  ];
  let retryCount = 0;
  let downloadSuccess = false;
@@ -343,21 +346,16 @@ export const checkApmAvailable = async (): Promise<boolean> => {
 * 检查提权命令
 */
 export const checkSuperUserCommand = async (): Promise<string> => {
-  return new Promise((resolve) => {
+  if (process.getuid?.() === 0) return "";
-    const child = spawn("which", ["/usr/bin/pkexec"]);
+
-    let stdout = "";
+  for (const command of SUPER_USER_COMMAND_CANDIDATES) {
-    child.stdout?.on("data", (data) => {
+    const superUserCmd = await findExecutable(command);
-      stdout += data.toString();
+    if (superUserCmd.length > 0) {
-    });
+      logger.info(`找到提升权限命令: ${superUserCmd}`);
-    child.on("close", (code) => {
+      return superUserCmd;
-      if (code === 0) {
+    }
-        resolve(stdout.trim());
+  }
-      } else {
+
-        resolve("");
+  logger.error("没有找到提升权限的命令 pkexec!");
-      }
+  return "";
    });
    child.on("error", () => {
      resolve("");
    });
  });
 };
@@ -0,0 +1,49 @@
 import { spawn } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 export const SUPER_USER_COMMAND_CANDIDATES = [
  "/usr/bin/pkexec",
  "/run/wrappers/bin/pkexec",
 ];
 const WHICH_TIMEOUT_MS = 5000;
 export const findExecutable = async (command: string): Promise<string> => {
  if (path.isAbsolute(command)) {
    try {
      await fs.promises.access(command, fs.constants.X_OK);
      return command;
    } catch {
      return "";
    }
  }
  return await new Promise<string>((resolve) => {
    const child = spawn("which", [command]);
    let stdout = "";
    let settled = false;
    const timer = setTimeout(() => {
      child.kill();
      finish("");
    }, WHICH_TIMEOUT_MS);
    function finish(result: string) {
      if (settled) return;
      settled = true;
      clearTimeout(timer);
      resolve(result);
    }
    child.stdout?.on("data", (data) => {
      stdout += data.toString();
    });
    child.on("close", (code) => {
      finish(code === 0 ? stdout.trim() : "");
    });
    child.on("error", () => {
      finish("");
    });
  });
 };
@@ -1,7 +1,12 @@
 import { spawn } from "node:child_process";
 import pino from "pino";
 import { BrowserWindow, ipcMain } from "electron";
 const logger = pino({ name: "updateCenter" });
 import { SHELL_CALLER_PATH } from "../shared-installer";
 import { findExecutable, SUPER_USER_COMMAND_CANDIDATES } from "../superuser";
 import {
  buildInstalledSourceMap,
  mergeUpdateSources,
@@ -163,9 +168,9 @@ const loadAptssItemMetadata = async (
  | { item: UpdateCenterItem; warning?: undefined }
  | { item: null; warning: string }
 > => {
-  console.log(`[DEBUG] Loading APTSS metadata for ${item.pkgname}`);
+  logger.debug(`[DEBUG] Loading APTSS metadata for ${item.pkgname}`);
  const printUrisCommand = getAptssPrintUrisCommand(item.pkgname);
-  console.log(
+  logger.debug(
    `[DEBUG] APTSS command: ${printUrisCommand.command} ${printUrisCommand.args.join(" ")}`,
  );
@@ -173,11 +178,11 @@ const loadAptssItemMetadata = async (
    printUrisCommand.command,
    printUrisCommand.args,
  );
-  console.log(`[DEBUG] APTSS metadata result code: ${metadataResult.code}`);
+  logger.debug(`[DEBUG] APTSS metadata result code: ${metadataResult.code}`);
-  console.log(
+  logger.debug(
    `[DEBUG] APTSS metadata stdout: ${metadataResult.stdout.substring(0, 500)}`,
  );
-  console.log(
+  logger.debug(
    `[DEBUG] APTSS metadata stderr: ${metadataResult.stderr.substring(0, 500)}`,
  );
@@ -186,18 +191,18 @@ const loadAptssItemMetadata = async (
    metadataResult,
  );
  if (commandError) {
-    console.log(`[DEBUG] APTSS metadata error: ${commandError}`);
+    logger.debug(`[DEBUG] APTSS metadata error: ${commandError}`);
    return { item: null, warning: commandError };
  }
  const metadata = parsePrintUrisOutput(metadataResult.stdout);
  if (metadata) {
-    console.log(`[DEBUG] APTSS parsed metadata:`, {
+    logger.debug(`[DEBUG] APTSS parsed metadata:`, {
      ...metadata,
      downloadUrl: `${metadata.downloadUrl}.metalink`,
    });
  } else {
-    console.log(`[DEBUG] APTSS parsed metadata:`, metadata);
+    logger.debug(`[DEBUG] APTSS parsed metadata:`, metadata);
  }
  if (!metadata) {
@@ -376,7 +381,7 @@ export const loadUpdateCenterItems = async (
  storeFilter: StoreFilter = "both",
  runCommand: UpdateCenterCommandRunner = runCommandCapture,
 ): Promise<UpdateCenterLoadItemsResult> => {
-  console.log(
+  logger.debug(
    `[UpdateCenter] loadUpdateCenterItems called with storeFilter=${storeFilter}`,
  );
  const [sparkEnabled, apmEnabled] = await Promise.all([
@@ -387,7 +392,7 @@ export const loadUpdateCenterItems = async (
      ? isCommandAvailable(runCommand, "apm")
      : Promise.resolve(false),
  ]);
-  console.log(
+  logger.debug(
    `[UpdateCenter] sparkEnabled=${sparkEnabled}, apmEnabled=${apmEnabled}`,
  );
@@ -413,16 +418,16 @@ export const loadUpdateCenterItems = async (
        : Promise.resolve({ code: 0, stdout: "", stderr: "" }),
    ]);
-  console.log(
+  logger.debug(
    `[UpdateCenter] aptssResult: code=${aptssResult.code}, stdout=${aptssResult.stdout.substring(0, 500)}, stderr=${aptssResult.stderr.substring(0, 500)}`,
  );
-  console.log(
+  logger.debug(
    `[UpdateCenter] apmResult: code=${apmResult.code}, stdout=${apmResult.stdout.substring(0, 500)}, stderr=${apmResult.stderr.substring(0, 500)}`,
  );
-  console.log(
+  logger.debug(
    `[UpdateCenter] aptssInstalledResult: code=${aptssInstalledResult.code}, stdout=${aptssInstalledResult.stdout.substring(0, 500)}`,
  );
-  console.log(
+  logger.debug(
    `[UpdateCenter] apmInstalledResult: code=${apmInstalledResult.code}, stdout=${apmInstalledResult.stdout.substring(0, 500)}`,
  );
@@ -450,11 +455,11 @@ export const loadUpdateCenterItems = async (
    apmEnabled && apmResult.code === 0
      ? parseApmUpgradableOutput(apmResult.stdout)
      : [];
-  console.log(
+  logger.debug(
    `[UpdateCenter] parsed aptssItems count=${aptssItems.length}`,
    aptssItems.map((i) => `${i.pkgname} ${i.currentVersion}->${i.nextVersion}`),
  );
-  console.log(
+  logger.debug(
    `[UpdateCenter] parsed apmItems count=${apmItems.length}`,
    apmItems.map((i) => `${i.pkgname} ${i.currentVersion}->${i.nextVersion}`),
  );
@@ -465,7 +470,7 @@ export const loadUpdateCenterItems = async (
      : "",
    apmInstalledResult.code === 0 ? apmInstalledResult.stdout : "",
  );
-  console.log(`[UpdateCenter] installedSources size=${installedSources.size}`);
+  logger.debug(`[UpdateCenter] installedSources size=${installedSources.size}`);
  const [categorizedAptssItems, categorizedApmItems] = await Promise.all([
    aptssAvailable ? enrichItemCategories(aptssItems) : Promise.resolve([]),
@@ -479,11 +484,11 @@ export const loadUpdateCenterItems = async (
      ? enrichApmItems(categorizedApmItems, runCommand)
      : Promise.resolve({ items: [], warnings: [] }),
  ]);
-  console.log(
+  logger.debug(
    `[UpdateCenter] enrichedAptssItems: count=${enrichedAptssItems.items.length}, warnings=${enrichedAptssItems.warnings.length}`,
    enrichedAptssItems.warnings,
  );
-  console.log(
+  logger.debug(
    `[UpdateCenter] enrichedApmItems: count=${enrichedApmItems.items.length}, warnings=${enrichedApmItems.warnings.length}`,
    enrichedApmItems.warnings,
  );
@@ -493,15 +498,19 @@ export const loadUpdateCenterItems = async (
    enrichItemIcons(enrichedApmItems.items),
    installedSources,
  );
-  console.log(
+  logger.debug(
    `[UpdateCenter] mergedItems count=${mergedItems.length}`,
    mergedItems.map(
      (i) => `${i.pkgname} (${i.source}) ${i.currentVersion}->${i.nextVersion}`,
    ),
  );
  // 标记被系统锁定（apt-mark hold）的包：这类包被 apt 拒绝升级（除非 --allow-change-held-packages）。
  // 更新中心据此默认禁用其勾选，并提示用户单独开启「强制安装」。
  const heldItems = await markHeldPackages(mergedItems, runCommand);
  return {
-    items: mergedItems,
+    items: heldItems,
    warnings: [
      ...warnings,
      ...enrichedAptssItems.warnings,
@@ -510,6 +519,167 @@ export const loadUpdateCenterItems = async (
  };
 };
 // 通过 `apt-mark showhold` 获取系统锁定的包集合，给可升级项中匹配者打 held 标记。
 // 仅 spark（aptss/deb）源受 apt hold 影响；apm 源不经过 apt，无需标记。
 const markHeldPackages = async (
  items: UpdateCenterItem[],
  runCommand: UpdateCenterCommandRunner,
 ): Promise<UpdateCenterItem[]> => {
  const sparkItems = items.filter((item) => item.source === "aptss");
  if (sparkItems.length === 0) {
    return items;
  }
  const result = await runCommand("apt-mark", ["showhold"]);
  if (result.code !== 0) {
    // 查询失败不阻断更新列表，仅跳过 hold 标记
    console.warn(`[UpdateCenter] apt-mark showhold failed: ${result.stderr}`);
    return items;
  }
  const heldSet = new Set(
    result.stdout
      .split("\n")
      .map((line) => line.trim())
      .filter((line) => line.length > 0),
  );
  if (heldSet.size === 0) {
    return items;
  }
  return items.map((item) =>
    item.source === "aptss" && heldSet.has(item.pkgname)
      ? { ...item, held: true }
      : item,
  );
 };
 // 子进程超时（毫秒）：网络慢/镜像源卡死时，避免命令永久挂起
 const SYSTEM_UPDATE_COMMAND_TIMEOUT_MS = 90_000;
 // 带超时保护的命令执行：超时杀掉子进程并 resolve，防止调用方永久冻结
 const runCommandWithTimeout = (
  command: string,
  args: string[],
 ): Promise<{ code: number; stdout: string; stderr: string }> =>
  new Promise((resolve) => {
    const child = spawn(command, args, { shell: false, env: process.env });
    let stdout = "";
    let stderr = "";
    let settled = false;
    const timer = setTimeout(() => {
      if (settled) return;
      settled = true;
      try {
        child.kill("SIGKILL");
      } catch {
        // 忽略杀进程异常
      }
      resolve({
        code: -1,
        stdout,
        stderr: `${stderr}\n[timeout] command exceeded ${SYSTEM_UPDATE_COMMAND_TIMEOUT_MS}ms`,
      });
    }, SYSTEM_UPDATE_COMMAND_TIMEOUT_MS);
    const finish = (result: {
      code: number;
      stdout: string;
      stderr: string;
    }): void => {
      if (settled) return;
      settled = true;
      clearTimeout(timer);
      resolve(result);
    };
    child.stdout?.on("data", (data) => {
      stdout += data.toString();
    });
    child.stderr?.on("data", (data) => {
      stderr += data.toString();
    });
    child.on("error", (err) =>
      finish({ code: -1, stdout, stderr: err.message }),
    );
    child.on("close", (code) => finish({ code: code ?? -1, stdout, stderr }));
  });
 // 刷新软件源（aptss ssupdate + apm update），提权执行。
 // 供更新中心 IPC 与“启动后空闲预刷新”复用，单一逻辑来源。
 export const runSystemUpdateSources = async (
  storeFilter: StoreFilter = "both",
 ): Promise<{ aptss?: string; apm?: string }> => {
  logger.debug(
    `[UpdateCenter] runSystemUpdateSources called with storeFilter=${storeFilter}`,
  );
  const results: { aptss?: string; apm?: string } = {};
  const isSourceEnabled = (
    filter: StoreFilter,
    source: "spark" | "apm",
  ): boolean => filter === "both" || filter === source;
  if (isSourceEnabled(storeFilter, "spark")) {
    const whichResult = await runCommandWithTimeout("which", ["aptss"]);
    const aptssAvailable =
      whichResult.code === 0 && whichResult.stdout.trim().length > 0;
    if (aptssAvailable) {
      logger.debug("[UpdateCenter] Running: pkexec shell-caller aptss ssupdate");
      const superUserCmd = await findExecutable(
        SUPER_USER_COMMAND_CANDIDATES[0],
      );
      if (superUserCmd) {
        const result = await runCommandWithTimeout(superUserCmd, [
          SHELL_CALLER_PATH,
          "aptss",
          "ssupdate",
        ]);
        results.aptss =
          result.code === 0
            ? "ok"
            : `failed: ${result.stderr.substring(0, 200)}`;
        logger.debug("[UpdateCenter] aptss ssupdate result:", results.aptss);
      } else {
        results.aptss = "failed: pkexec not found";
        console.warn("[UpdateCenter] pkexec not found, skipping aptss update");
      }
    } else {
      results.aptss = "skipped: aptss not installed";
    }
  }
  if (isSourceEnabled(storeFilter, "apm")) {
    const whichResult = await runCommandWithTimeout("which", ["apm"]);
    const apmAvailable =
      whichResult.code === 0 && whichResult.stdout.trim().length > 0;
    if (apmAvailable) {
      logger.debug("[UpdateCenter] Running: pkexec shell-caller apm update");
      const superUserCmd = await findExecutable(
        SUPER_USER_COMMAND_CANDIDATES[0],
      );
      if (superUserCmd) {
        const result = await runCommandWithTimeout(superUserCmd, [
          SHELL_CALLER_PATH,
          "apm",
          "update",
        ]);
        results.apm =
          result.code === 0
            ? "ok"
            : `failed: ${result.stderr.substring(0, 200)}`;
        logger.debug("[UpdateCenter] apm update result:", results.apm);
      } else {
        results.apm = "failed: pkexec not found";
        console.warn("[UpdateCenter] pkexec not found, skipping apm update");
      }
    } else {
      results.apm = "skipped: apm not installed";
    }
  }
  return results;
 };
 export const registerUpdateCenterIpc = (
  ipc: Pick<typeof ipcMain, "handle">,
  service: Pick<
@@ -524,6 +694,12 @@ export const registerUpdateCenterIpc = (
    | "subscribe"
  >,
 ): void => {
  ipc.handle(
    "update-center-run-system-update",
    async (_event, storeFilter: StoreFilter = "both") =>
      runSystemUpdateSources(storeFilter),
  );
  ipc.handle(
    "update-center-open",
    (_event, storeFilter: StoreFilter = "both") => service.open(storeFilter),
@@ -1,11 +1,16 @@
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { runAria2Download, type Aria2DownloadResult } from "./download";
 import { installPackage } from "../shared-installer";
 import type { UpdateCenterQueue, UpdateCenterTask } from "./queue";
 import type { UpdateCenterItem } from "./types";
-const DEFAULT_DOWNLOAD_ROOT = "/tmp/spark-store/update-center";
+const DEFAULT_DOWNLOAD_ROOT = join(
  tmpdir(),
  `spark-store-${process.pid}`,
  "update-center",
 );
 export interface InstallUpdateItemOptions {
  item: UpdateCenterItem;
@@ -210,7 +210,11 @@ const parseUpgradableOutput = (
    const arch = tokens[2] ?? "";
    const currentVersion =
      trimmed.match(CURRENT_VERSION_PATTERN)?.[1] ?? tokens[5] ?? "";
-    if (!pkgname || nextVersion === currentVersion) {
+    // 仅当包名缺失或当前版本解析失败时才跳过。
    // 注意：不再因 nextVersion === currentVersion 而跳过——aptss 已判定该项为
    // upgradable，应信任上游判断；否则当仓库元数据出现"同版本重新发布"等情况时，
    // 真实的更新项会被无声隐藏，导致"软件更新"列表空白。
    if (!pkgname || !currentVersion) {
      continue;
    }
@@ -1,4 +1,8 @@
 import { BrowserWindow } from "electron";
 import {
  addInstallTask,
  type QueueInstallPayload,
 } from "../install-manager";
 import {
  IGNORE_CONFIG_PATH,
  applyIgnoredEntries,
@@ -67,6 +71,8 @@ export interface UpdateCenterIgnorePayload {
 export interface UpdateCenterStartTask {
  taskKey: string;
  id: number;
  // 强制安装被系统锁定（apt-mark hold）的包
  forceHeld?: boolean;
 }
 export interface UpdateCenterService {
@@ -115,6 +121,7 @@ const toState = (
    migrationSource: item.migrationSource,
    migrationTarget: item.migrationTarget,
    aptssVersion: item.aptssVersion,
    held: item.held,
  })),
  tasks: [], // 不再展示任务日志
  warnings: [...snapshot.warnings],
@@ -217,15 +224,10 @@ export const createUpdateCenterService = (
    },
    async start(tasks) {
      const snapshot = queue.getSnapshot();
-      const taskIdByKey = new Map(tasks.map((task) => [task.taskKey, task.id]));
+      const taskByKey = new Map(
-      const selectedItems = snapshot.items.filter(
+        tasks.map((task) => [task.taskKey, task] as const),
        (item) => taskIdByKey.has(getTaskKey(item)) && !item.ignored,
      );
      if (selectedItems.length === 0) {
        return;
      }
      // 获取主窗口的 webContents
      const mainWindow = BrowserWindow.getAllWindows()[0];
      const webContents = mainWindow?.webContents;
@@ -235,22 +237,63 @@ export const createUpdateCenterService = (
        return;
      }
-      // 获取当前 items
+      // 分类：可启动项 vs 被锁定（held）且未开启强制安装的项。
-      let currentItems = snapshot.items;
+      // 被锁定的项需用户单独开启「强制安装」才能升级，否则明确告知失败，避免静默卡在「开始更新」。
      const startableItems: typeof snapshot.items = [];
      const heldBlocked: Array<{
        item: (typeof snapshot.items)[number];
        id: number;
      }> = [];
-      for (const item of selectedItems) {
+      for (const item of snapshot.items) {
-        const updateTaskId = taskIdByKey.get(getTaskKey(item));
+        const updateTask = taskByKey.get(getTaskKey(item));
-        if (!updateTaskId) {
+        if (!updateTask || item.ignored) continue;
        if (item.held === true && !updateTask.forceHeld) {
          heldBlocked.push({ item, id: updateTask.id });
          continue;
        }
        startableItems.push(item);
      }
      // 对「被锁定未强制」的选中项，向前端发送明确失败通知（而非静默跳过）
      for (const blocked of heldBlocked) {
        webContents.send("install-complete", {
          id: blocked.id,
          success: false,
          time: Date.now(),
          exitCode: -1,
          message: JSON.stringify({
            message: `软件包 ${blocked.item.pkgname} 被系统锁定（hold），已在更新中心默认跳过。如需升级，请在该软件行开启「强制安装」开关后重试。`,
            stdout: "",
            stderr: "",
          }),
        });
      }
      if (startableItems.length === 0) {
        return;
      }
      // 获取当前 items 的副本，启动成功后从更新中心列表移除已交出的项，
      // 避免同一包同时出现在更新中心与下载队列（更新中心只展示待更新的项）。
      let currentItems = snapshot.items;
      for (const item of startableItems) {
        const updateTask = taskByKey.get(getTaskKey(item));
        if (!updateTask) {
          continue;
        }
        const { id: updateTaskId, forceHeld } = updateTask;
        // 构建 metalink URL
        const metalinkUrl = item.downloadUrl
          ? `${item.downloadUrl}.metalink`
          : undefined;
-        // 发送到主下载队列
+        // 直接加入主下载队列（之前用 webContents.send("queue-install") 只会发给渲染端，
-        const installTaskData = {
+        // 主进程 ipcMain 监听不到自己发出的 send，导致任务实际未启动而卡死）。
        const installTaskData: QueueInstallPayload = {
          id: updateTaskId,
          pkgname: item.pkgname,
          metalinkUrl,
@@ -258,20 +301,18 @@ export const createUpdateCenterService = (
          upgradeOnly: true,
          origin: item.source === "apm" ? "apm" : "spark",
          retry: false,
          forceHeld: item.held === true ? forceHeld : false,
        };
-        // 通过 IPC 发送到主下载队列
+        await addInstallTask(installTaskData, webContents);
        webContents.send("queue-install", JSON.stringify(installTaskData));
-        // 从更新中心的 items 中移除该应用（不再显示在更新列表中）
+        // 启动成功后从更新中心列表移除该项（被 hold 未强制拦截的项不会进入此处，仍保留）。
        currentItems = currentItems.filter(
          (i) => getTaskKey(i) !== getTaskKey(item),
        );
      }
      // 更新队列中的 items
      queue.setItems(currentItems);
      emit();
    },
    async cancel(taskKey) {
@@ -24,4 +24,8 @@ export interface UpdateCenterItem {
  migrationSource?: UpdateSource;
  migrationTarget?: UpdateSource;
  aptssVersion?: string;
  // 更新发布时间（毫秒时间戳）；由上游解析填充，暂无则缺省
  updateTime?: number;
  // 是否被系统锁定（apt-mark hold）。被锁定的包默认不可批量选中，需用户单独开启「强制安装」
  held?: boolean;
 }
@@ -45,7 +45,7 @@ class ListenersMap {
  }
 }
-const protocols = ["spk"];
+const protocols = ["spk", "apt"];
 const listeners = new ListenersMap();
 export const deepLink = {
@@ -81,6 +81,23 @@ export function handleCommandLine(commandLine: string[]) {
  try {
    const url = new URL(target);
    // Handle apt:// protocol: convert to spk://search/pkgname
    if (url.protocol === "apt:") {
      // Format: apt://pkgname
      const pkgname =
        url.hostname || url.pathname.split("/").filter(Boolean)[0];
      if (pkgname) {
        const query: Query = { pkgname };
        logger.info(`Deep link: apt protocol converted to search: ${pkgname}`);
        listeners.emit("search", query);
      } else {
        logger.warn(
          `Deep link: invalid apt format, expected //pkgname, got ${target}`,
        );
      }
      return;
    }
    const action = url.hostname; // 'search'
    logger.info(`Deep link: action found: ${action}`);
@@ -4,9 +4,11 @@ import {
  ipcMain,
  Menu,
  nativeImage,
  net,
  shell,
  Tray,
  nativeTheme,
  screen,
  session,
 } from "electron";
 import { fileURLToPath } from "node:url";
@@ -18,11 +20,15 @@ import { handleCommandLine } from "./deeplink.js";
 import { isLoaded } from "../global.js";
 import { tasks } from "./backend/install-manager.js";
 import { sendTelemetryOnce } from "./backend/telemetry.js";
-import { initializeUpdateCenter } from "./backend/update-center/index.js";
+import {
  initializeUpdateCenter,
  runSystemUpdateSources,
 } from "./backend/update-center/index.js";
 import {
  getMainWindowCloseAction,
  type MainWindowCloseGuardState,
 } from "./window-close-guard.js";
 import { registerSubmitterHandlers } from "./backend/submitter.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 process.env.APP_ROOT = path.join(__dirname, "../..");
@@ -40,6 +46,23 @@ function getAppVersion(): string {
  }
 }
 function getSystemInfo(): { distro: string } {
  try {
    const raw = fs.readFileSync("/etc/os-release", "utf8");
    const fields = Object.fromEntries(
      raw
        .split("\n")
        .map((line) => line.match(/^([A-Z_]+)=(.*)$/))
        .filter((match): match is RegExpMatchArray => match !== null)
        .map((match) => [match[1], match[2].replace(/^"|"$/g, "")]),
    );
    const distro = fields.PRETTY_NAME || fields.NAME || "unknown";
    return { distro };
  } catch {
    return { distro: "unknown" };
  }
 }
 // 处理 --version 参数（在单实例检查之前）
 if (process.argv.includes("--version") || process.argv.includes("-v")) {
  console.log(getAppVersion());
@@ -54,7 +77,15 @@ if (!app.requestSingleInstanceLock()) {
 import "./backend/install-manager.js";
 import "./handle-url-scheme.js";
 // 关闭 Linux 的覆盖式（overlay）滚动条，强制使用经典滚动条，
 // 否则 GTK overlay 滚动条会忽略渲染进程的 ::-webkit-scrollbar 颜色，
 // 导致暗色模式下滚动条始终是原生灰色。必须在 app ready 前设置。
 if (process.platform === "linux") {
  app.commandLine.appendSwitch("disable-features", "OverlayScrollbar");
 }
 const logger = pino({ name: "index.ts" });
 const FLARUM_TOKEN_URL = "https://bbs.spark-app.store/api/token";
 // The built directory structure
 //
@@ -70,6 +101,10 @@ export const MAIN_DIST = path.join(process.env.APP_ROOT, "dist-electron");
 export const RENDERER_DIST = path.join(process.env.APP_ROOT, "dist");
 export const VITE_DEV_SERVER_URL = process.env.VITE_DEV_SERVER_URL;
 // 进程专属临时目录，避免多实例/残留进程互相影响
 // 退出时由 will-quit 统一清理
 export const TEMP_BASE = path.join(os.tmpdir(), `spark-store-${process.pid}`);
 process.env.VITE_PUBLIC = VITE_DEV_SERVER_URL
  ? path.join(process.env.APP_ROOT, "public")
  : RENDERER_DIST;
@@ -94,12 +129,25 @@ const getUserAgent = (): string => {
  return `Spark-Store/${getAppVersion()}`;
 };
 let submitterWin: BrowserWindow | null = null;
 registerSubmitterHandlers(
  preload,
  indexHtml,
  VITE_DEV_SERVER_URL,
  () => submitterWin,
  (w) => {
    submitterWin = w;
  },
 );
 logger.info("User Agent: " + getUserAgent());
 /** 根据启动参数 --no-apm / --no-spark 决定只展示的来源 */
 function getStoreFilterFromArgv(): "spark" | "apm" | "both" {
  if (process.arch === "loong64") {
-    // Currently loong64 only have spark support
+    // Currently loong64 only have spark support,
    // 但用户显式传入 --no-spark 时应允许回退到 apm
    if (process.argv.includes("--no-spark")) return "apm";
    return "spark";
  } else {
    const argv = process.argv;
@@ -116,7 +164,95 @@ ipcMain.handle("get-store-filter", (): "spark" | "apm" | "both" =>
  getStoreFilterFromArgv(),
 );
 // 渲染端在窗口尺寸变化时（包括无边框窗口鼠标拉边角）经此保存当前窗口尺寸
 ipcMain.handle("save-window-bounds", (): boolean => {
  if (win && !win.isDestroyed()) scheduleSaveBounds(win);
  return true;
 });
 // 渲染端（设置页）切换界面整体缩放系数，经此实时应用到主窗口。
 // factor 限定在 0.5~3 之间，避免极端值导致界面不可用。
 ipcMain.handle("set-zoom-factor", (_event, factor: unknown): boolean => {
  if (typeof factor !== "number" || !Number.isFinite(factor)) return false;
  const clamped = Math.min(3, Math.max(0.5, factor));
  if (win && !win.isDestroyed()) {
    win.webContents.setZoomFactor(clamped);
    return true;
  }
  return false;
 });
 ipcMain.handle("get-app-version", (): string => getAppVersion());
 ipcMain.handle("get-system-info", (): { distro: string } => getSystemInfo());
 ipcMain.handle("request-flarum-token", async (_event, payload: unknown) => {
  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
    throw new Error("登录信息格式不正确，请重新输入。");
  }
  const credentials = payload as Record<string, unknown>;
  if (
    typeof credentials.identification !== "string" ||
    typeof credentials.password !== "string"
  ) {
    throw new Error("登录信息格式不正确，请重新输入。");
  }
  logger.info({ endpoint: FLARUM_TOKEN_URL }, "Requesting Flarum login token");
  let response: Response;
  try {
    response = await fetch(FLARUM_TOKEN_URL, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Accept: "application/json",
        "User-Agent": getUserAgent(),
      },
      body: JSON.stringify({
        identification: credentials.identification,
        password: credentials.password,
      }),
    });
  } catch (err) {
    logger.error(
      { err, endpoint: FLARUM_TOKEN_URL },
      "Flarum token request failed before response",
    );
    throw new Error("无法连接星火论坛，请检查网络后重试。");
  }
  if (!response.ok) {
    logger.warn(
      { endpoint: FLARUM_TOKEN_URL, status: response.status },
      "Flarum rejected login token request",
    );
    throw new Error("论坛登录失败，请检查账号和密码。");
  }
  const data = (await response.json()) as Record<string, unknown>;
  const userId = data.userId ?? data.user_id;
  if (
    typeof data.token !== "string" ||
    userId === undefined ||
    userId === null
  ) {
    logger.warn(
      {
        endpoint: FLARUM_TOKEN_URL,
        hasToken: typeof data.token === "string" && data.token.length > 0,
        hasUserId: userId !== undefined && userId !== null,
      },
      "Flarum token response missing required fields",
    );
    throw new Error("论坛登录响应异常，请稍后重试。");
  }
  return {
    token: data.token,
    userId: String(userId),
  };
 });
 const getMainWindowCloseGuardState = (): MainWindowCloseGuardState => ({
  installTaskCount: tasks.size,
@@ -156,11 +292,160 @@ const requestApplicationExit = (): void => {
  app.quit();
 };
 const showAndFocusMainWindow = async (): Promise<void> => {
  if (!win || win.isDestroyed()) {
    // 等待窗口创建完成，创建失败时调用方可通过异常感知
    await createWindow();
    return;
  }
  if (win.isMinimized()) {
    win.restore();
  }
  win.show();
  win.setSkipTaskbar(false);
  win.focus();
 };
 // 窗口尺寸持久化：保存/恢复上一次调整后的窗口大小，避免每次打开都使用默认尺寸
 const DEFAULT_WINDOW_SIZE = { width: 1366, height: 768 };
 const MIN_WINDOW_SIZE = { width: 800, height: 500 };
 // 超过该尺寸的窗口（通常为全屏/最大化状态）在恢复时回退到默认尺寸，避免「启动即全屏、还原按钮失效」
 const OVERSIZED_WINDOW_THRESHOLD = { width: 1600, height: 900 };
 interface WindowState {
  width?: number;
  height?: number;
  x?: number;
  y?: number;
  maximized?: boolean;
  /** 界面整体缩放系数（Electron webContents.setZoomFactor），默认 1 */
  zoomFactor?: number;
 }
 function getWindowStatePath(): string {
  // 延迟到调用时再取 userData，避免在 app ready 之前调用 app.getPath 出错
  return path.join(app.getPath("userData"), "window-state.json");
 }
 // 校验保存的窗口位置是否至少部分落在某个显示器可见区域内，避免窗口跑到屏幕外
 function isVisible(bounds: WindowState): boolean {
  // 解构为局部常量后，控制流收窄（const 不可变）可穿透到下方嵌套闭包，
  // 消除 x/y/width/height 的 “可能为未定义” 告警
  const { x, y, width, height } = bounds;
  if (
    x === undefined ||
    y === undefined ||
    width === undefined ||
    height === undefined
  ) {
    return false;
  }
  const displays = screen.getAllDisplays();
  return displays.some((display) => {
    const w = display.workArea;
    const horizontally = x < w.x + w.width && x + width > w.x;
    const vertically = y < w.y + w.height && y + height > w.y;
    return horizontally && vertically;
  });
 }
 function loadWindowState(): WindowState {
  try {
    const file = getWindowStatePath();
    if (fs.existsSync(file)) {
      const parsed = JSON.parse(fs.readFileSync(file, "utf-8")) as WindowState;
      if (
        parsed.width !== undefined &&
        parsed.height !== undefined &&
        parsed.width >= MIN_WINDOW_SIZE.width &&
        parsed.height >= MIN_WINDOW_SIZE.height &&
        isVisible(parsed)
      ) {
        return parsed;
      }
      logger.warn({ parsed }, "已保存的窗口状态无效，使用默认尺寸");
    }
  } catch (err) {
    logger.warn({ err }, "读取窗口状态失败，使用默认尺寸");
  }
  return {};
 }
 function saveWindowState(state: WindowState): void {
  try {
    fs.writeFileSync(getWindowStatePath(), JSON.stringify(state));
    logger.info({ state }, "已保存窗口状态");
  } catch (err) {
    logger.warn({ err }, "保存窗口状态失败");
  }
 }
 let saveBoundsTimer: NodeJS.Timeout | null = null;
 function flushSaveBounds(): void {
  if (saveBoundsTimer) {
    clearTimeout(saveBoundsTimer);
    saveBoundsTimer = null;
  }
  if (win && !win.isDestroyed()) {
    const { width, height, x, y } = win.getBounds();
    saveWindowState({
      width,
      height,
      x,
      y,
      maximized: win.isMaximized(),
      zoomFactor: win.webContents.getZoomFactor(),
    });
  }
 }
 function scheduleSaveBounds(winInstance: BrowserWindow): void {
  if (saveBoundsTimer) clearTimeout(saveBoundsTimer);
  saveBoundsTimer = setTimeout(() => {
    if (winInstance.isDestroyed()) return;
    const { width, height, x, y } = winInstance.getBounds();
    saveWindowState({
      width,
      height,
      x,
      y,
      maximized: winInstance.isMaximized(),
      zoomFactor: winInstance.webContents.getZoomFactor(),
    });
  }, 400);
 }
 // 应用退出前立即持久化（防抖 400ms 可能在快速关闭时丢失最后一次状态）
 app.on("before-quit", () => {
  flushSaveBounds();
 });
 async function createWindow() {
-  win = new BrowserWindow({
+  const saved = loadWindowState();
  // 恢复时：若上次窗口过大（>1600x900，通常为全屏/最大化），回退到默认尺寸并居中，
  // 避免「启动即全屏、还原按钮失效」；其余情况保留上次记录的实际尺寸（并居中）。
  // 放大/还原仍交由标题栏按钮控制。
  const oversized =
    (saved.width ?? 0) > OVERSIZED_WINDOW_THRESHOLD.width ||
    (saved.height ?? 0) > OVERSIZED_WINDOW_THRESHOLD.height;
  const restoredWidth = oversized
    ? DEFAULT_WINDOW_SIZE.width
    : Math.max(saved.width ?? DEFAULT_WINDOW_SIZE.width, MIN_WINDOW_SIZE.width);
  const restoredHeight = oversized
    ? DEFAULT_WINDOW_SIZE.height
    : Math.max(
        saved.height ?? DEFAULT_WINDOW_SIZE.height,
        MIN_WINDOW_SIZE.height,
      );
  const mainWindow = new BrowserWindow({
    title: "星火应用商店",
-    width: 1366,
+    width: restoredWidth,
-    height: 768,
+    height: restoredHeight,
    center: true,
    minWidth: MIN_WINDOW_SIZE.width,
    minHeight: MIN_WINDOW_SIZE.height,
    frame: false,
    autoHideMenuBar: true,
    icon: path.join(process.env.VITE_PUBLIC, "favicon.ico"),
    webPreferences: {
@@ -173,31 +458,89 @@ async function createWindow() {
      // contextIsolation: false,
    },
  });
  win = mainWindow;
  // 启动即应用持久化的界面缩放系数（默认 1 = 100%）。
  // 必须在 loadURL/loadFile 前设置，使首帧即按目标缩放渲染，避免闪烁。
  const savedZoom =
    typeof saved.zoomFactor === "number" &&
    saved.zoomFactor >= 0.5 &&
    saved.zoomFactor <= 3
      ? saved.zoomFactor
      : 1;
  mainWindow.webContents.setZoomFactor(savedZoom);
  logger.info({ zoomFactor: savedZoom }, "已应用界面缩放系数");
  // 设计意图（非缺陷，勿改为自动恢复 maximized）：
  // 启动时不自动恢复最大化状态。原因——最大化窗口在多数屏幕上 bounds 会超过
  // OVERSIZED_WINDOW_THRESHOLD(1600x900)，若强行恢复最大化会导致「启动即全屏、
  // 还原按钮失效」的体验问题；故最大化/全屏状态在关闭后统一回退为默认尺寸并居中，
  // 放大/还原交由标题栏按钮由用户主动控制。WindowState 仍保存 maximized 字段
  // （供需要该信息的场景读取），但恢复阶段有意不调用 win.maximize()。
  logger.info(
    { saved, restoredWidth, restoredHeight, oversized },
    "已恢复窗口状态（过大窗口回退默认尺寸并居中；最大化状态有意不自动恢复）",
  );
  // 窗口大小/位置/最大化变化后防抖保存，下次启动时恢复
  // 位置/最大化变化由主进程事件保存；尺寸变化由渲染端 DOM resize 经 IPC 兜底保存
  mainWindow.on("moved", () => scheduleSaveBounds(mainWindow));
  mainWindow.on("maximize", () => scheduleSaveBounds(mainWindow));
  mainWindow.on("unmaximize", () => scheduleSaveBounds(mainWindow));
  if (VITE_DEV_SERVER_URL) {
    // #298
-    win.loadURL(VITE_DEV_SERVER_URL);
+    mainWindow.loadURL(VITE_DEV_SERVER_URL);
    // Open devTool if the app is not packaged
-    win.webContents.openDevTools({ mode: "detach" });
+    mainWindow.webContents.openDevTools({ mode: "detach" });
  } else {
-    win.loadFile(indexHtml);
+    mainWindow.loadFile(indexHtml);
  }
  // Test actively push message to the Electron-Renderer
-  win.webContents.on("did-finish-load", () => {
+  mainWindow.webContents.on("did-finish-load", () => {
-    win?.webContents.send("main-process-message", new Date().toLocaleString());
+    mainWindow.webContents.send(
      "main-process-message",
      new Date().toLocaleString(),
    );
    logger.info("Renderer process is ready.");
  });
-  // Make all links open with the browser, not with the application
+  // 外部链接统一交给系统默认浏览器打开。
-  win.webContents.setWindowOpenHandler(({ url }) => {
+  // 仅限制协议为 http/https，避免 file:/javascript: 等危险协议被打开；
-    if (url.startsWith("https:")) shell.openExternal(url);
+  // 不再限制域名，保证应用官网与首页推荐的任意链接均可正常访问。
  mainWindow.webContents.setWindowOpenHandler(({ url }) => {
    try {
      const parsed = new URL(url);
      if (parsed.protocol === "http:" || parsed.protocol === "https:") {
        shell.openExternal(url);
      }
    } catch {
      // 无效 URL，拒绝打开
    }
    return { action: "deny" };
  });
  // win.webContents.on('will-navigate', (event, url) => { }) #344
-  win.on("close", (event) => {
+  mainWindow.on("closed", () => {
    if (win === mainWindow) {
      win = null;
    }
  });
  mainWindow.on("close", (event) => {
    if (allowAppExit) {
      // 真正退出前同步保存最终窗口尺寸（防抖可能尚未触发）
      // 先清除尚未触发的防抖定时器，避免旧定时器随后覆盖本次同步写入
      if (saveBoundsTimer) clearTimeout(saveBoundsTimer);
      const { width, height, x, y } = mainWindow.getBounds();
      saveWindowState({
        width,
        height,
        x,
        y,
        maximized: mainWindow.isMaximized(),
      });
      return;
    }
@@ -219,6 +562,27 @@ ipcMain.on("set-theme-source", (event, theme: "system" | "light" | "dark") => {
  nativeTheme.themeSource = theme;
 });
 ipcMain.on("window-control-minimize", () => {
  win?.minimize();
 });
 ipcMain.on("window-control-toggle-maximize", () => {
  if (!win) {
    return;
  }
  if (win.isMaximized()) {
    win.unmaximize();
    return;
  }
  win.maximize();
 });
 ipcMain.on("window-control-close", () => {
  win?.close();
 });
 // 配置文件路径
 const SPARK_CONFIG_DIR = path.join(
  os.homedir(),
@@ -318,10 +682,35 @@ ipcMain.handle("check-for-updates", async () => {
  }
 });
 // 启动投稿器窗口
 // Register custom protocol handlers
 if (process.defaultApp) {
  if (process.argv.length >= 2) {
    app.setAsDefaultProtocolClient("spk", process.execPath, [
      path.resolve(process.argv[1]),
    ]);
    app.setAsDefaultProtocolClient("apt", process.execPath, [
      path.resolve(process.argv[1]),
    ]);
  }
 } else {
  app.setAsDefaultProtocolClient("spk");
  app.setAsDefaultProtocolClient("apt");
 }
 app.whenReady().then(() => {
  // Set User-Agent for client
  session.defaultSession.webRequest.onBeforeSendHeaders((details, callback) => {
    details.requestHeaders["User-Agent"] = getUserAgent();
    // 数据 JSON（applist / categories / priority-config / sidebar-config 等）禁用客户端缓存。
    // nginx 默认不发 Cache-Control，Chromium 会按启发式 TTL（≈(now-LastModified)/10）复用陈旧副本，
    // 导致服务端上新应用后商店内仍搜不到、且重启无效（仅删 Cache 目录才生效）。
    // 注意：C2 会给 URL 追加 ?_t=... 版本戳，故需按 query 前的 pathname 判断，而非 endsWith(".json")。
    const dataUrlPath = details.url.split("?")[0];
    if (dataUrlPath.endsWith(".json")) {
      details.requestHeaders["Cache-Control"] = "no-cache";
      details.requestHeaders["Pragma"] = "no-cache";
    }
    callback({ cancel: false, requestHeaders: details.requestHeaders });
  });
  createWindow();
@@ -329,8 +718,68 @@ app.whenReady().then(() => {
  initializeUpdateCenter();
  // 启动后执行一次遥测（仅 Linux，不阻塞）
  sendTelemetryOnce(getAppVersion());
  // 注册“渲染进程首页加载完成”信号：收到后立即开始后台刷新软件源，
  // 趁系统负载不高时提前刷新 aptss/apm 源，用户稍后打开“软件更新”即可秒出。
  // 同时保留一个兜底定时器，防止渲染进程未发信号时完全不刷新。
  ipcMain.on("update-center-trigger-prefetch", () => {
    startSourcePreRefreshOnce();
  });
  setTimeout(startSourcePreRefreshOnce, PRE_REFRESH_FALLBACK_MS);
 });
 // 启动后空闲预刷新软件源（带重试），不阻塞启动流程
 // 与 src/modules/updateCenter.ts 的 backgroundRefresh 重试为【对称设计】，非代码遗漏：
 // 主进程负责“启动预热”，前端负责“打开兜底”，
 // 两者进程/守卫/调用目标不同，故各自保留一份，勿抽共享。
 const PRE_REFRESH_BACKOFF_MS = [2000, 4000, 8000];
 const PRE_REFRESH_MAX_RETRIES = 3;
 const PRE_REFRESH_FALLBACK_MS = 15_000; // 渲染信号未到达时的兜底，15s 后也跑
 const PRE_REFRESH_TIMEOUT_MS = 60_000; // 单次预刷新整体超时，避免 pkexec 卡死挂起
 let preRefreshStarted = false;
 // 按重试次数取退避毫秒（越界时回退到最大间隔）
 const getPreRefreshBackoffDelay = (attempt: number): number =>
  PRE_REFRESH_BACKOFF_MS[attempt - 1] ??
  PRE_REFRESH_BACKOFF_MS[PRE_REFRESH_BACKOFF_MS.length - 1];
 // 确保预刷新只触发一次（渲染信号或兜底定时器 whichever first）。
 // 设计意图：单次会话仅预热一次（preRefreshStarted 置 true 后不再重置），
 // 避免用户在更新中心 Tab 间快速切换时重复触发 pkexec 弹窗造成困惑。
 const startSourcePreRefreshOnce = (attempt = 1): void => {
  if (preRefreshStarted) return;
  preRefreshStarted = true;
  const run = (): void => {
    // 网络可用性前置检查：离线时不发起提权刷新（pkexec 弹窗无意义且困惑）
    if (!net.isOnline()) {
      logger.info("[UpdateCenter] 预刷新跳过：当前离线");
      return;
    }
    const timeoutPromise = new Promise<never>((_, reject) =>
      setTimeout(
        () => reject(new Error("pre-refresh timeout")),
        PRE_REFRESH_TIMEOUT_MS,
      ),
    );
    Promise.race([runSystemUpdateSources("both"), timeoutPromise])
      .then((results) => {
        console.log("[UpdateCenter] pre-refresh done:", results);
      })
      .catch((error) => {
        console.warn("[UpdateCenter] pre-refresh failed:", error);
        if (attempt < PRE_REFRESH_MAX_RETRIES) {
          const delay = getPreRefreshBackoffDelay(attempt);
          setTimeout(() => startSourcePreRefreshOnce(attempt + 1), delay);
        }
      });
  };
  run();
 };
 app.on("window-all-closed", () => {
  win = null;
  allowAppExit = false;
@@ -338,26 +787,17 @@ app.on("window-all-closed", () => {
 });
 app.on("second-instance", () => {
-  if (win) {
+  void showAndFocusMainWindow();
    // Focus on the main window if the user tried to open another
    if (win.isMinimized()) win.restore();
    win.focus();
  }
 });
 app.on("activate", () => {
-  const allWindows = BrowserWindow.getAllWindows();
+  void showAndFocusMainWindow();
  if (allWindows.length) {
    allWindows[0].focus();
  } else {
    createWindow();
  }
 });
 app.on("will-quit", () => {
-  // Clean up temp dir
+  // 清理本进程专属临时目录（PID 隔离，不影响其他实例）
  logger.info("Cleaning up temp dir");
-  fs.rmSync("/tmp/spark-store/", { recursive: true, force: true });
+  fs.rmSync(TEMP_BASE, { recursive: true, force: true });
  logger.info("Done, exiting");
 });
@@ -404,7 +844,7 @@ app.whenReady().then(() => {
    {
      label: "显示主界面",
      click: () => {
-        win.show();
+        void showAndFocusMainWindow();
      },
    },
    {
@@ -419,16 +859,23 @@ app.whenReady().then(() => {
  // 双击触发
  tray.on("click", () => {
    // 双击通知区图标实现应用的显示或隐藏
-    if (win.isVisible()) {
+    if (win && !win.isDestroyed() && win.isVisible()) {
      win.hide();
      win.setSkipTaskbar(true);
    } else {
-      win.show();
+      void showAndFocusMainWindow();
      win.setSkipTaskbar(false);
    }
  });
 });
 ipcMain.handle('window:state', () => {
  const win = BrowserWindow.getFocusedWindow()
  if (!win) return 'normal'
  if (win.isMaximized()) return 'maximized'
  if (win.isMinimized()) return 'minimized'
  return 'normal'
 })
 // New window example arg: new windows url
 // ipcMain.handle('open-win', (_, arg) => {
 //   const childWindow = new BrowserWindow({
@@ -1,4 +1,9 @@
-import { ipcRenderer, contextBridge, type IpcRendererEvent } from "electron";
+import {
  ipcRenderer,
  contextBridge,
  webUtils,
  type IpcRendererEvent,
 } from "electron";
 type StoreFilter = "spark" | "apm" | "both";
@@ -42,6 +47,13 @@ type IpcRendererFacade = {
  invoke: typeof ipcRenderer.invoke;
 };
 type WindowControlBridge = {
  minimize: () => void;
  toggleMaximize: () => void;
  close: () => void;
  state: () => Promise<| 'normal' | 'maximized' | 'minimized'>;
 };
 type UpdateCenterStateListener = (snapshot: UpdateCenterSnapshot) => void;
 type UpdateCenterStartTask = {
  taskKey: string;
@@ -91,6 +103,17 @@ contextBridge.exposeInMainWorld("apm_store", {
  })(),
 });
 contextBridge.exposeInMainWorld("electronUtils", {
  getPathForFile: (file: File): string => webUtils.getPathForFile(file),
 });
 contextBridge.exposeInMainWorld("windowControls", {
  minimize: () => ipcRenderer.send("window-control-minimize"),
  toggleMaximize: () => ipcRenderer.send("window-control-toggle-maximize"),
  close: () => ipcRenderer.send("window-control-close"),
  state: () => ipcRenderer.invoke("window:state"),
 } satisfies WindowControlBridge);
 contextBridge.exposeInMainWorld("updateCenter", {
  open: (storeFilter: StoreFilter = "both"): Promise<UpdateCenterSnapshot> =>
    ipcRenderer.invoke("update-center-open", storeFilter),
@@ -85,6 +85,32 @@ case "$command_type" in
        fi
        ;;
    "force-ssinstall")
        # 强制安装被系统锁定（apt-mark hold）的包：在一次已提权的 pkexec 会话内
        # 完成「解除锁定 → ssinstall 本地 .deb → 恢复锁定」，避免单独 pkexec apt-mark
        # 触发额外权限框（apt-mark 不在 policykit 免密 exec.path 内）。
        # 用法：force-ssinstall <pkgname> <deb路径> [ssinstall 额外参数...]
        pkg="$2"
        deb="$3"
        shift 3
        # 仅放行单包名（与前端 PKGNAME_PATTERN 一致，双引号防注入）
        if [[ -z "$pkg" || -z "$deb" ]]; then
            echo "错误：force-ssinstall 缺少包名或 deb 路径参数。"
            exit 1
        fi
        # 安装前解除系统锁定（失败仅警告，不阻断）
        apt-mark unhold "$pkg" 2>&1 || echo "警告：解除系统锁定 $pkg 失败，将继续尝试安装"
        # 安装本地 .deb（--native 由本分支统一追加）
        /usr/bin/ssinstall "$deb" "$@" --native 2>&1
        exit_code=$?
        # 安装后无论如何恢复系统锁定，保持用户原本的 hold 状态
        apt-mark hold "$pkg" 2>&1 || echo "警告：恢复系统锁定 $pkg 失败，请手动检查"
        if [[ "$exit_code" != "0" ]]; then
            echo "安装失败，可尝试安装对应的 APM 版本应用；若无对应的 APM 版本应用，可提交用户反馈"
        fi
        exit $exit_code
        ;;
    "aptss")
        # 针对 aptss 的特殊逻辑：如果是 remove 子命令，需要图形化确认
        if [[ "$2" == "remove" ]]; then
@@ -155,7 +181,10 @@ case "$command_type" in
                echo "操作已取消"
                exit 0
            fi
-
+        elif [[ "$2" == "ssupdate" ]]; then
                /usr/bin/aptss "${@:2}" -y 2>&1
                exit_code=$?
                exit $exit_code
        else
            # 非 remove/install 命令，拒绝执行
            echo "拒绝执行 aptss 白名单外的指令"
@@ -0,0 +1,158 @@
 {
  lib,
  buildNpmPackage,
  importNpmLock,
  electron,
  makeWrapper,
  aria2,
  apm,
  coreutils,
  gnugrep,
  which,
  xdg-utils,
  bash,
 }:
 buildNpmPackage rec {
  pname = "spark-store";
  version = "5.1.1";
  src = lib.cleanSourceWith {
    src = ../.;
    filter =
      path: type:
      let
        baseName = baseNameOf path;
      in
      !(lib.elem baseName [
        ".git"
        "dist"
        "dist-electron"
        "node_modules"
        "release"
        "result"
      ]);
  };
  npmDeps = importNpmLock {
    npmRoot = ../.;
  };
  npmConfigHook = importNpmLock.npmConfigHook;
  nativeBuildInputs = [
    makeWrapper
  ];
  env = {
    ELECTRON_SKIP_BINARY_DOWNLOAD = "1";
    PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD = "1";
  };
  buildPhase = ''
    runHook preBuild
    npm run build:vite
    runHook postBuild
  '';
  installPhase = ''
    runHook preInstall
    appDir="$out/share/spark-store"
    npm prune --omit=dev --ignore-scripts
    substituteInPlace extras/shell-caller.sh \
      --replace-fail "/usr/bin/apm" "${lib.getExe' apm "apm"}"
    mkdir -p "$appDir" "$out/bin"
    cp -r dist dist-electron package.json node_modules extras icons "$appDir"/
    chmod -R u+w "$appDir"
    find "$appDir/extras" -type f -exec chmod +x {} \;
    substituteInPlace "$appDir/dist-electron/main/index.js" \
      --replace-fail "/opt/spark-store/extras/shell-caller.sh" "$appDir/extras/shell-caller.sh" \
      --replace-fail "/opt/spark-store/extras/app-launcher" "$appDir/extras/app-launcher"
    install -Dm644 pkg/usr/share/applications/spark-store.desktop \
      "$out/share/applications/spark-store.desktop"
    install -Dm644 icons/spark-store.svg \
      "$out/share/icons/hicolor/scalable/apps/spark-store.svg"
    install -Dm644 icons/spark-store.png \
      "$out/share/icons/hicolor/512x512/apps/spark-store.png"
    install -Dm644 extras/store.spark-app.spark-store.policy \
      "$out/share/polkit-1/actions/store.spark-app.spark-store.policy"
    substituteInPlace "$out/share/polkit-1/actions/store.spark-app.spark-store.policy" \
      --replace-fail "/opt/spark-store/extras/shell-caller.sh" "$appDir/extras/shell-caller.sh"
    cat > "$out/bin/spark-store" <<EOF
 #!${bash}/bin/bash
 export PATH="${lib.makeBinPath [
  aria2
  coreutils
  gnugrep
  which
  xdg-utils
 ]}:\$PATH"
 electron_args=(--no-sandbox)
 app_args=()
 root_path="\$(${coreutils}/bin/readlink -f /proc/self/root)"
 if [ "\$root_path" != "/" ]; then
  app_args+=(--no-apm)
 fi
 if [ "\''${IS_ACE_ENV:-}" = "1" ]; then
  app_args+=(--no-apm)
 fi
 if ! command -v apt >/dev/null 2>&1; then
  app_args+=(--no-spark)
 fi
 if [ -r /etc/os-release ] && ${gnugrep}/bin/grep -q "ID=aosc" /etc/os-release; then
  app_args+=(--no-spark)
 fi
 exec ${electron}/bin/electron "\''${electron_args[@]}" "$appDir" "\''${app_args[@]}" "\$@"
 EOF
    chmod +x "$out/bin/spark-store"
    patchShebangs "$appDir/extras"
    runHook postInstall
  '';
  postFixup = ''
    appDir="$out/share/spark-store"
    wrapProgram "$appDir/extras/shell-caller.sh" \
      --prefix PATH : ${
        lib.makeBinPath [
          aria2
          bash
          coreutils
          which
          xdg-utils
        ]
      }
    substituteInPlace "$appDir/extras/.shell-caller.sh-wrapped" \
      --replace-fail "#!/bin/bash" "#!${bash}/bin/bash"
  '';
  meta = {
    description = "Client for Spark App Store";
    homepage = "https://spark-app.store";
    license = lib.licenses.gpl3Only;
    mainProgram = "spark-store";
    platforms = lib.platforms.linux;
  };
 }
@@ -1,12 +1,12 @@
 {
  "name": "spark-store",
-  "version": "5.0.0",
+  "version": "5.3.1",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "spark-store",
-      "version": "5.0.0",
+      "version": "5.3.1",
      "license": "GPL-3.0",
      "dependencies": {
        "@tailwindcss/vite": "^4.1.18",
@@ -28,7 +28,7 @@
        "@vue/test-utils": "^2.4.3",
        "conventional-changelog": "^7.1.1",
        "conventional-changelog-angular": "^8.1.0",
-        "electron": "^39.2.7",
+        "electron": "^37.2.5",
        "eslint": "^9.39.2",
        "eslint-config-prettier": "^10.1.8",
        "eslint-plugin-prettier": "^5.5.5",
@@ -45,7 +45,7 @@
        "vite-plugin-electron-renderer": "^0.14.5",
        "vitest": "^4.1.4",
        "vue": "^3.4.21",
-        "vue-tsc": "^3.2.4"
+        "vue-tsc": "^3.3.5"
      },
      "engines": {
        "node": ">=22.12.0"
@@ -3348,18 +3348,18 @@
      }
    },
    "node_modules/@vue/language-core": {
-      "version": "3.2.5",
+      "version": "3.3.5",
-      "resolved": "https://registry.npmjs.org/@vue/language-core/-/language-core-3.2.5.tgz",
+      "resolved": "https://registry.npmmirror.com/@vue/language-core/-/language-core-3.3.5.tgz",
-      "integrity": "sha512-d3OIxN/+KRedeM5wQ6H6NIpwS3P5gC9nmyaHgBk+rO6dIsjY+tOh4UlPpiZbAh3YtLdCGEX4M16RmsBqPmJV+g==",
+      "integrity": "sha512-UkKu5nhX89fg4VhlG/FOeI10G3cj/7radKT/cy9BT4Q9qJmJlSTAc/dP63Xqs29aypN4f39xUV6PsLNk/dcD6g==",
      "dev": true,
      "dependencies": {
        "@volar/language-core": "2.4.28",
        "@vue/compiler-dom": "^3.5.0",
        "@vue/shared": "^3.5.0",
-        "alien-signals": "^3.0.0",
+        "alien-signals": "^3.2.0",
        "muggle-string": "^0.4.1",
        "path-browserify": "^1.0.1",
-        "picomatch": "^4.0.2"
+        "picomatch": "^4.0.4"
      }
    },
    "node_modules/@vue/reactivity": {
@@ -3494,9 +3494,9 @@
      }
    },
    "node_modules/alien-signals": {
-      "version": "3.1.2",
+      "version": "3.2.1",
-      "resolved": "https://registry.npmjs.org/alien-signals/-/alien-signals-3.1.2.tgz",
+      "resolved": "https://registry.npmmirror.com/alien-signals/-/alien-signals-3.2.1.tgz",
-      "integrity": "sha512-d9dYqZTS90WLiU0I5c6DHj/HcKkF8ZyGN3G5x8wSbslulz70KOxaqCT0hQCo9KOyhVqzqGojvNdJXoTumZOtcw==",
+      "integrity": "sha512-I8FjmltrfnDFoZedi5CG8DghVYNhzb/Ijluz7tCSJH0xpd0484Kowhbb1XDYOxfJpU1p5wnM2X54dA+IfGyD1g==",
      "dev": true
    },
    "node_modules/ansi-colors": {
@@ -4870,9 +4870,9 @@
      }
    },
    "node_modules/electron": {
-      "version": "39.2.7",
+      "version": "37.2.5",
-      "resolved": "https://registry.npmjs.org/electron/-/electron-39.2.7.tgz",
+      "resolved": "https://registry.npmjs.org/electron/-/electron-37.2.5.tgz",
-      "integrity": "sha512-KU0uFS6LSTh4aOIC3miolcbizOFP7N1M46VTYVfqIgFiuA2ilfNaOHLDS9tCMvwwHRowAsvqBrh9NgMXcTOHCQ==",
+      "integrity": "sha512-719ZqEp43rj6xDJMICm4CIXl8keFFgvVNO9Ix6OtjNjrh9HtYlP/1WiYeRohnXj06aLyGx5NCzrHbG7j3BxO9w==",
      "dev": true,
      "hasInstallScript": true,
      "license": "MIT",
@@ -7636,7 +7636,7 @@
    },
    "node_modules/muggle-string": {
      "version": "0.4.1",
-      "resolved": "https://registry.npmjs.org/muggle-string/-/muggle-string-0.4.1.tgz",
+      "resolved": "https://registry.npmmirror.com/muggle-string/-/muggle-string-0.4.1.tgz",
      "integrity": "sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==",
      "dev": true
    },
@@ -10088,13 +10088,13 @@
      }
    },
    "node_modules/vue-tsc": {
-      "version": "3.2.5",
+      "version": "3.3.5",
-      "resolved": "https://registry.npmjs.org/vue-tsc/-/vue-tsc-3.2.5.tgz",
+      "resolved": "https://registry.npmmirror.com/vue-tsc/-/vue-tsc-3.3.5.tgz",
-      "integrity": "sha512-/htfTCMluQ+P2FISGAooul8kO4JMheOTCbCy4M6dYnYYjqLe3BExZudAua6MSIKSFYQtFOYAll7XobYwcpokGA==",
+      "integrity": "sha512-Rzh/G2MmNlMSAMTiQEjDrsb4dgB/jbtEM47rVN2NtidF1dfb/q4w4QvpQBtW5+y3y5H27Hjh7deVwk+YB02fNg==",
      "dev": true,
      "dependencies": {
        "@volar/typescript": "2.4.28",
-        "@vue/language-core": "3.2.5"
+        "@vue/language-core": "3.3.5"
      },
      "bin": {
        "vue-tsc": "bin/vue-tsc.js"
@@ -1,6 +1,6 @@
 {
  "name": "spark-store",
-  "version": "5.1.1",
+  "version": "5.3.1",
  "main": "dist-electron/main/index.js",
  "description": "Client for Spark App Store",
  "author": "elysia-best <elysia-best@simplelinux.cn.eu.org>",
@@ -26,11 +26,11 @@
  "type": "module",
  "scripts": {
    "dev": "vite --mode debug | pino-pretty",
-    "build": "vue-tsc --noEmit && vite build --mode production && electron-builder --config electron-builder.yml",
+    "build": "vue-tsc --noEmit && vite build --mode production && electron-builder --config electron-builder.yml --linux dir",
    "build:vite": "vue-tsc --noEmit && vite build --mode production",
    "build:rpm": "vue-tsc --noEmit && vite build --mode production && electron-builder --config electron-builder.yml --linux rpm",
    "build:deb": "vue-tsc --noEmit && vite build --mode production && electron-builder --config electron-builder.yml --linux deb",
-    "build:deb-loong64": "vue-tsc --noEmit && vite build --mode production && env ELECTRON_MIRROR=https://github.com/darkyzhou/electron-loong64/releases/download/ electron_use_remote_checksums=1 electron-builder --config electron-builder.yml --loong64 --linux deb",
+    "build:loong64": "vue-tsc --noEmit && vite build --mode production && env ELECTRON_MIRROR=https://github.com/darkyzhou/electron-loong64/releases/download/ electron_use_remote_checksums=1 electron-builder --config electron-builder.yml --loong64 --linux dir",
    "preview": "vite preview --mode debug",
    "lint": "eslint --ext .ts,.vue src electron",
    "lint:fix": "eslint --ext .ts,.vue src electron --fix",
@@ -57,7 +57,7 @@
    "@vue/test-utils": "^2.4.3",
    "conventional-changelog": "^7.1.1",
    "conventional-changelog-angular": "^8.1.0",
-    "electron": "^39.2.7",
+    "electron": "^37.2.5",
    "eslint": "^9.39.2",
    "eslint-config-prettier": "^10.1.8",
    "eslint-plugin-prettier": "^5.5.5",
@@ -74,7 +74,7 @@
    "vite-plugin-electron-renderer": "^0.14.5",
    "vitest": "^4.1.4",
    "vue": "^3.4.21",
-    "vue-tsc": "^3.2.4"
+    "vue-tsc": "^3.3.5"
  },
  "dependencies": {
    "@tailwindcss/vite": "^4.1.18",
@@ -1,3 +0,0 @@
 Package: *
 Pin: origin *.deepinos.org.cn
 Pin-Priority: 400
@@ -1 +0,0 @@
 deb [by-hash=force] https://d.store.deepinos.org.cn / 
@@ -1,11 +0,0 @@
 [Unit]  
 Description=Timer for Spark Update Notifier  
 [Timer]  
 # 开机后第一次执行  
 OnBootSec=1min  
 # 每天执行一次  
 OnUnitActiveSec=1d  
 [Install]  
 WantedBy=timers.target
@@ -1,9 +0,0 @@
 #!/bin/sh
 echo "From:sparkstorefeedback@163.com
 To:sparkstorefeedback@163.com
 Subject: spark-store_3.0.2: $(lsb_release -a | grep "Description" | sed -e "s#\t#@#" | cut -d "@" -f 2)
 $(uname -a)" | tee /tmp/spark-store-install/feedback.txt > /dev/null
 curl -s --url "smtp://smtp.163.com" --mail-from "${MAIL_FEEDBACK}" --mail-rcpt "${MAIL_FEEDBACK}" --upload-file /tmp/spark-store-install/feedback.txt --user "${MAIL_FEEDBACK}:${M}AIL_AUTH"
@@ -1,15 +1,17 @@
 [Unit]
 Description=Spark Store update notifier
 After=apt-daily.service network.target network-online.target systemd-networkd.service NetworkManager.service connman.service
 # 设置为 1 小时的时间窗口
 StartLimitIntervalSec=1h
 # 最大允许失败次数为 3 次
 StartLimitBurst=3
 [Service]
 Type=simple
 RemainAfterExit=yes
 ExecStart=/opt/durapps/spark-store/bin/update-upgrade/ss-update-notifier.sh
 Restart=on-failure
-RestartSec=15  # 可以设置为更长的重试间隔，比如 15 秒或 30 秒
+# 可以设置为更长的重试间隔，比如 15 秒或 30 秒
-StartLimitIntervalSec=1h  # 设置为 1 小时的时间窗口
+RestartSec=15
 StartLimitBurst=3  # 最大允许失败次数为 3 次
 [Install]
 WantedBy=multi-user.target
@@ -0,0 +1,10 @@
 [Unit]
 Description=Spark Store update notifier
 [Timer]
 OnCalendar=*-*-* 6,12,18:00
 RandomizedDelaySec=30m
 Persistent=true
 [Install]
 WantedBy=timers.target
@@ -10,4 +10,4 @@ Keywords=appstore;
 Terminal=false
 StartupNotify=true
 StartupWMClass=spark-store
-MimeType=x-scheme-handler/spk
+MimeType=x-scheme-handler/spk;x-scheme-handler/apt
@@ -0,0 +1,5 @@
 #!/bin/bash
 TRANSHELL_CONTENT_RUNNING_IN_NOT_ROOT_USER="Informação: Iniciando em modo sem privilégios root! Se ocorrerem problemas, tente executar o comando com privilégios de root."
 TRANSHELL_CONTENT_INFO_SOURCES_LIST_D_IS_EMPTY="Informação: A pasta sources.list.d está vazia. Nenhuma sincronização será tentada."
 TRANSHELL_CONTENT_GETTING_SERVER_CONFIG_AND_MIRROR_LIST="Obtendo configuração do servidor e lista de espelhos..."
 TRANSHELL_CONTENT_PLEASE_USE_APTSS_INSTEAD_OF_APT="Aviso: Embora a mensagem de erro sugira usar apt (ex.: apt install --fix-broken) para corrigir o problema, ao depurar o erro, utilize aptss no lugar (no exemplo, use aptss install --fix-broken)."
@@ -0,0 +1,108 @@
 #!/usr/bin/env bash
 #
 # 测试打包脚本
 #
 # 用途：本地测试打包时，自动将 deb 版本号（位于 debian/changelog 顶部）的
 #       最后一段数字 +1，并追加 "-test" 标签，随后执行 dpkg-buildpackage。
 #
 # 示例：
 #   当前 debian/changelog 顶部版本为 5.2.1.0
 #   运行一次 -> 5.2.1.1-test（产物 spark-store_5.2.1.1-test_amd64.deb）
 #   再运行一次 -> 5.2.1.2-test
 #
 # 注意：
 #   - 此脚本仅用于本地测试，不会修改 package.json（其 version 为 semver 格式，
 #     而 deb 测试版本如 5.3.0.8-test 会被 electron-builder 拒绝）。
 #   - 为保证打包后「关于」页面显示版本与 deb 版本一致，脚本会临时向
 #     electron-builder.yml 追加 extraMetadata.version（electron-builder 会将其写入
 #     app.asar 内的 package.json，Electron 的 app.getVersion() 即从中读取），
 #     打包完成后自动恢复，异常退出时由 trap 兜底恢复。
 #   - 每次运行都会改写 debian/changelog，属于未跟踪的工作区改动，按需自行还原。
 #   - 如需恢复正式版本，将 debian/changelog 顶部版本改回即可。
 set -euo pipefail
 # 定位仓库根目录（脚本位于 scripts/ 下）
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 cd "$ROOT"
 CHANGELOG="debian/changelog"
 if [ ! -f "$CHANGELOG" ]; then
  echo "错误：未找到 $CHANGELOG" >&2
  exit 1
 fi
 # 读取 changelog 首行并解析版本号，形如：
 #   spark-store (5.2.1.0) UNRELEASED; urgency=medium
 #   spark-store (5.2.1.1-test) UNRELEASED; urgency=medium
 top_line="$(head -n1 "$CHANGELOG")"
 # 提取括号内的版本号，避免使用 [[ =~ ]] 处理字面括号引发的语法问题
 old_ver="$(printf '%s' "$top_line" | sed -E 's/^[^ ]+ \(([^)]+)\).*/\1/')"
 if [[ -z "$old_ver" || "$old_ver" == "$top_line" ]]; then
  echo "错误：无法从 $CHANGELOG 首行解析版本号: $top_line" >&2
  exit 1
 fi
 # 分离上游版本与 Debian 修订号：
 #   Debian 版本格式为 "上游版本-修订号"，修订号以最后一个 '-' 分隔。
 #   上游版本只允许点号（如 5.2.1.0），'-test' 这类标签属于修订号，每次测试覆盖为固定 "test"。
 if [[ "$old_ver" == *-* ]]; then
  upstream="${old_ver%-*}"
 else
  upstream="$old_ver"
 fi
 # 上游版本形如 X.Y.Z.W，将最后一个点号分隔的数字段 +1
 if [[ "$upstream" =~ ^(.*)\.([0-9]+)$ ]]; then
  prefix="${BASH_REMATCH[1]}"
  last="${BASH_REMATCH[2]}"
  # 10# 强制按十进制解析，避免以 0 开头的段被当作八进制
  new_last=$((10#$last + 1))
  new_upstream="${prefix}.${new_last}"
 else
  echo "错误：上游版本号不符合 X.Y.Z.W 格式: $upstream" >&2
  exit 1
 fi
 new_ver="${new_upstream}-test"
 echo "版本号: ${old_ver} -> ${new_ver}"
 # 仅替换首行括号内的版本号（转义点号，避免被正则当作任意字符）
 old_ver_esc="${old_ver//./\\.}"
 sed -i -E "1s/\\(${old_ver_esc}\\)/(${new_ver})/" "$CHANGELOG"
 # Electron 二进制下载镜像（本机到 GitHub 不通，使用 npmmirror 镜像）
 export ELECTRON_MIRROR="${ELECTRON_MIRROR:-https://registry.npmmirror.com/-/binary/electron/}"
 # 同步应用内版本号：临时向 electron-builder.yml 追加 extraMetadata.version。
 # electron-builder 会把它合并进 app.asar 内的 package.json，
 # 「关于」页面经 IPC 调用的 app.getVersion() 即读取该值。
 EB_YML="electron-builder.yml"
 EB_YML_BAK="${EB_YML}.bak-test-build"
 # 清理上次异常中断可能残留的 extraMetadata 块（追加内容始终位于文件末尾）
 if grep -q "^extraMetadata:" "$EB_YML"; then
  echo "清理 $EB_YML 中残留的 extraMetadata 块"
  sed -i '/^extraMetadata:/,$d' "$EB_YML"
 fi
 cp "$EB_YML" "$EB_YML_BAK"
 restore_eb_yml() {
  mv -f "$EB_YML_BAK" "$EB_YML" 2>/dev/null || true
 }
 trap restore_eb_yml EXIT
 printf 'extraMetadata:\n  version: "%s"\n' "$new_ver" >> "$EB_YML"
 # 清理旧的 electron-builder 产物，避免 release/ 下多个版本目录被 make install
 # 的 release/*/linux*-unpacked/* 通配一并拷入 deb，造成内容污染
 rm -rf release/
 echo "开始测试打包（版本 ${new_ver}）..."
 dpkg-buildpackage -us -uc -b
 # 打包成功，立即恢复 electron-builder.yml 并解除 trap
 restore_eb_yml
 trap - EXIT
 echo "完成。产物: ../spark-store_${new_ver}_amd64.deb"
@@ -1,62 +0,0 @@
 build
 .vscode
 .cache
 CMakeLists.txt.user
 CMakeLists.txt.user.*
 obj-x86_64-linux-gnu
 # C++ objects and libs
 *.slo
 *.lo
 *.o
 *.a
 *.la
 *.lai
 *.so
 *.dll
 *.dylib
 # Qt-es
 object_script.*.Release
 object_script.*.Debug
 *_plugin_import.cpp
 /.qmake.cache
 /.qmake.stash
 *.pro.user
 *.pro.user.*
 *.qbs.user
 *.qbs.user.*
 *.moc
 moc_*.cpp
 moc_*.h
 qrc_*.cpp
 ui_*.h
 *.qmlc
 *.jsc
 Makefile*
 *build-*
 # Qt unit tests
 target_wrapper.*
 # Qt qm files
 translations/*.qm
 # QtCreator
 *.autosave
 # QtCreator Qml
 *.qmlproject.user
 *.qmlproject.user.*
 # QtCreator CMake
 CMakeLists.txt.user*
 build
 # Debian dpkg-buildpackage
 debian/*.debhelper*
 debian/files
 debian/*.substvars
 debian/spark-update-tool
 .vscode/*
 src/spark-update-tool
@@ -1,99 +0,0 @@
 cmake_minimum_required(VERSION 3.16)
 project(spark-update-tool VERSION 0.1 LANGUAGES CXX)
 set(CMAKE_AUTOUIC ON)
 set(CMAKE_AUTOMOC ON)
 set(CMAKE_AUTORCC ON)
 set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
 find_package(QT NAMES Qt6 Qt5 REQUIRED COMPONENTS Widgets Network Concurrent)
 find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS Widgets Network Concurrent)
 set(PROJECT_SOURCES
        src/main.cpp
        src/mainwindow.cpp
        src/mainwindow.h
        src/mainwindow.ui
        src/aptssupdater.h
        src/aptssupdater.cpp
        src/icons.qrc
        src/appdelegate.h
        src/appdelegate.cpp
        src/applistmodel.h
        src/applistmodel.cpp
        src/downloadmanager.h
        src/downloadmanager.cpp
        src/ignoreconfig.h
        src/ignoreconfig.cpp
 )
 if(${QT_VERSION_MAJOR} GREATER_EQUAL 6)
    qt_add_executable(spark-update-tool
        MANUAL_FINALIZATION
        ${PROJECT_SOURCES}
    )
 # Define target properties for Android with Qt 6 as:
 #    set_property(TARGET spark-update-tool APPEND PROPERTY QT_ANDROID_PACKAGE_SOURCE_DIR
 #                 ${CMAKE_CURRENT_SOURCE_DIR}/android)
 # For more information, see https://doc.qt.io/qt-6/qt-add-executable.html#target-creation
 else()
    if(ANDROID)
        add_library(spark-update-tool SHARED
            ${PROJECT_SOURCES}
        )
 # Define properties for Android with Qt 5 after find_package() calls as:
 #    set(ANDROID_PACKAGE_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/android")
    else()
        add_executable(spark-update-tool
            ${PROJECT_SOURCES}
        )
    endif()
 endif()
 target_link_libraries(spark-update-tool PRIVATE Qt${QT_VERSION_MAJOR}::Widgets Qt${QT_VERSION_MAJOR}::Network Qt${QT_VERSION_MAJOR}::Concurrent)
 # Qt for iOS sets MACOSX_BUNDLE_GUI_IDENTIFIER automatically since Qt 6.1.
 # If you are developing for iOS or macOS you should consider setting an
 # explicit, fixed bundle identifier manually though.
 if(${QT_VERSION} VERSION_LESS 6.1.0)
  set(BUNDLE_ID_OPTION MACOSX_BUNDLE_GUI_IDENTIFIER com.example.spark-update-tool)
 endif()
 set_target_properties(spark-update-tool PROPERTIES
    ${BUNDLE_ID_OPTION}
    MACOSX_BUNDLE_BUNDLE_VERSION ${PROJECT_VERSION}
    MACOSX_BUNDLE_SHORT_VERSION_STRING ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}
    MACOSX_BUNDLE TRUE
    WIN32_EXECUTABLE TRUE
 )
 # 安装配置
 # 对于Linux，安装到/usr/bin目录
 if(UNIX AND NOT APPLE)
    # 直接指定安装路径为 /usr/bin
    install(TARGETS spark-update-tool
        RUNTIME DESTINATION /usr/bin
    )
    # 可选：安装桌面文件和应用图标
    # install(FILES ${CMAKE_CURRENT_SOURCE_DIR}/spark-update-tool.desktop
    #     DESTINATION /usr/share/applications
    # )
    # install(FILES ${CMAKE_CURRENT_SOURCE_DIR}/icons/spark-update-tool.png
    #     DESTINATION /usr/share/icons/hicolor/256x256/apps
    # )
 else()
    # 对于其他系统，使用GNU标准安装路径
    include(GNUInstallDirs)
    install(TARGETS spark-update-tool
        BUNDLE DESTINATION .
        LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
        RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
    )
 endif()
 if(QT_VERSION_MAJOR EQUAL 6)
    qt_finalize_executable(spark-update-tool)
 endif()
@@ -1,674 +0,0 @@
                    GNU GENERAL PUBLIC LICENSE
                       Version 3, 29 June 2007
 Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
 Everyone is permitted to copy and distribute verbatim copies
 of this license document, but changing it is not allowed.
                            Preamble
  The GNU General Public License is a free, copyleft license for
 software and other kinds of works.
  The licenses for most software and other practical works are designed
 to take away your freedom to share and change the works.  By contrast,
 the GNU General Public License is intended to guarantee your freedom to
 share and change all versions of a program--to make sure it remains free
 software for all its users.  We, the Free Software Foundation, use the
 GNU General Public License for most of our software; it applies also to
 any other work released this way by its authors.  You can apply it to
 your programs, too.
  When we speak of free software, we are referring to freedom, not
 price.  Our General Public Licenses are designed to make sure that you
 have the freedom to distribute copies of free software (and charge for
 them if you wish), that you receive source code or can get it if you
 want it, that you can change the software or use pieces of it in new
 free programs, and that you know you can do these things.
  To protect your rights, we need to prevent others from denying you
 these rights or asking you to surrender the rights.  Therefore, you have
 certain responsibilities if you distribute copies of the software, or if
 you modify it: responsibilities to respect the freedom of others.
  For example, if you distribute copies of such a program, whether
 gratis or for a fee, you must pass on to the recipients the same
 freedoms that you received.  You must make sure that they, too, receive
 or can get the source code.  And you must show them these terms so they
 know their rights.
  Developers that use the GNU GPL protect your rights with two steps:
 (1) assert copyright on the software, and (2) offer you this License
 giving you legal permission to copy, distribute and/or modify it.
  For the developers' and authors' protection, the GPL clearly explains
 that there is no warranty for this free software.  For both users' and
 authors' sake, the GPL requires that modified versions be marked as
 changed, so that their problems will not be attributed erroneously to
 authors of previous versions.
  Some devices are designed to deny users access to install or run
 modified versions of the software inside them, although the manufacturer
 can do so.  This is fundamentally incompatible with the aim of
 protecting users' freedom to change the software.  The systematic
 pattern of such abuse occurs in the area of products for individuals to
 use, which is precisely where it is most unacceptable.  Therefore, we
 have designed this version of the GPL to prohibit the practice for those
 products.  If such problems arise substantially in other domains, we
 stand ready to extend this provision to those domains in future versions
 of the GPL, as needed to protect the freedom of users.
  Finally, every program is threatened constantly by software patents.
 States should not allow patents to restrict development and use of
 software on general-purpose computers, but in those that do, we wish to
 avoid the special danger that patents applied to a free program could
 make it effectively proprietary.  To prevent this, the GPL assures that
 patents cannot be used to render the program non-free.
  The precise terms and conditions for copying, distribution and
 modification follow.
                       TERMS AND CONDITIONS
  0. Definitions.
  "This License" refers to version 3 of the GNU General Public License.
  "Copyright" also means copyright-like laws that apply to other kinds of
 works, such as semiconductor masks.
  "The Program" refers to any copyrightable work licensed under this
 License.  Each licensee is addressed as "you".  "Licensees" and
 "recipients" may be individuals or organizations.
  To "modify" a work means to copy from or adapt all or part of the work
 in a fashion requiring copyright permission, other than the making of an
 exact copy.  The resulting work is called a "modified version" of the
 earlier work or a work "based on" the earlier work.
  A "covered work" means either the unmodified Program or a work based
 on the Program.
  To "propagate" a work means to do anything with it that, without
 permission, would make you directly or secondarily liable for
 infringement under applicable copyright law, except executing it on a
 computer or modifying a private copy.  Propagation includes copying,
 distribution (with or without modification), making available to the
 public, and in some countries other activities as well.
  To "convey" a work means any kind of propagation that enables other
 parties to make or receive copies.  Mere interaction with a user through
 a computer network, with no transfer of a copy, is not conveying.
  An interactive user interface displays "Appropriate Legal Notices"
 to the extent that it includes a convenient and prominently visible
 feature that (1) displays an appropriate copyright notice, and (2)
 tells the user that there is no warranty for the work (except to the
 extent that warranties are provided), that licensees may convey the
 work under this License, and how to view a copy of this License.  If
 the interface presents a list of user commands or options, such as a
 menu, a prominent item in the list meets this criterion.
  1. Source Code.
  The "source code" for a work means the preferred form of the work
 for making modifications to it.  "Object code" means any non-source
 form of a work.
  A "Standard Interface" means an interface that either is an official
 standard defined by a recognized standards body, or, in the case of
 interfaces specified for a particular programming language, one that
 is widely used among developers working in that language.
  The "System Libraries" of an executable work include anything, other
 than the work as a whole, that (a) is included in the normal form of
 packaging a Major Component, but which is not part of that Major
 Component, and (b) serves only to enable use of the work with that
 Major Component, or to implement a Standard Interface for which an
 implementation is available to the public in source code form.  A
 "Major Component", in this context, means a major essential component
 (kernel, window system, and so on) of the specific operating system
 (if any) on which the executable work runs, or a compiler used to
 produce the work, or an object code interpreter used to run it.
  The "Corresponding Source" for a work in object code form means all
 the source code needed to generate, install, and (for an executable
 work) run the object code and to modify the work, including scripts to
 control those activities.  However, it does not include the work's
 System Libraries, or general-purpose tools or generally available free
 programs which are used unmodified in performing those activities but
 which are not part of the work.  For example, Corresponding Source
 includes interface definition files associated with source files for
 the work, and the source code for shared libraries and dynamically
 linked subprograms that the work is specifically designed to require,
 such as by intimate data communication or control flow between those
 subprograms and other parts of the work.
  The Corresponding Source need not include anything that users
 can regenerate automatically from other parts of the Corresponding
 Source.
  The Corresponding Source for a work in source code form is that
 same work.
  2. Basic Permissions.
  All rights granted under this License are granted for the term of
 copyright on the Program, and are irrevocable provided the stated
 conditions are met.  This License explicitly affirms your unlimited
 permission to run the unmodified Program.  The output from running a
 covered work is covered by this License only if the output, given its
 content, constitutes a covered work.  This License acknowledges your
 rights of fair use or other equivalent, as provided by copyright law.
  You may make, run and propagate covered works that you do not
 convey, without conditions so long as your license otherwise remains
 in force.  You may convey covered works to others for the sole purpose
 of having them make modifications exclusively for you, or provide you
 with facilities for running those works, provided that you comply with
 the terms of this License in conveying all material for which you do
 not control copyright.  Those thus making or running the covered works
 for you must do so exclusively on your behalf, under your direction
 and control, on terms that prohibit them from making any copies of
 your copyrighted material outside their relationship with you.
  Conveying under any other circumstances is permitted solely under
 the conditions stated below.  Sublicensing is not allowed; section 10
 makes it unnecessary.
  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
  No covered work shall be deemed part of an effective technological
 measure under any applicable law fulfilling obligations under article
 11 of the WIPO copyright treaty adopted on 20 December 1996, or
 similar laws prohibiting or restricting circumvention of such
 measures.
  When you convey a covered work, you waive any legal power to forbid
 circumvention of technological measures to the extent such circumvention
 is effected by exercising rights under this License with respect to
 the covered work, and you disclaim any intention to limit operation or
 modification of the work as a means of enforcing, against the work's
 users, your or third parties' legal rights to forbid circumvention of
 technological measures.
  4. Conveying Verbatim Copies.
  You may convey verbatim copies of the Program's source code as you
 receive it, in any medium, provided that you conspicuously and
 appropriately publish on each copy an appropriate copyright notice;
 keep intact all notices stating that this License and any
 non-permissive terms added in accord with section 7 apply to the code;
 keep intact all notices of the absence of any warranty; and give all
 recipients a copy of this License along with the Program.
  You may charge any price or no price for each copy that you convey,
 and you may offer support or warranty protection for a fee.
  5. Conveying Modified Source Versions.
  You may convey a work based on the Program, or the modifications to
 produce it from the Program, in the form of source code under the
 terms of section 4, provided that you also meet all of these conditions:
    a) The work must carry prominent notices stating that you modified
    it, and giving a relevant date.
    b) The work must carry prominent notices stating that it is
    released under this License and any conditions added under section
    7.  This requirement modifies the requirement in section 4 to
    "keep intact all notices".
    c) You must license the entire work, as a whole, under this
    License to anyone who comes into possession of a copy.  This
    License will therefore apply, along with any applicable section 7
    additional terms, to the whole of the work, and all its parts,
    regardless of how they are packaged.  This License gives no
    permission to license the work in any other way, but it does not
    invalidate such permission if you have separately received it.
    d) If the work has interactive user interfaces, each must display
    Appropriate Legal Notices; however, if the Program has interactive
    interfaces that do not display Appropriate Legal Notices, your
    work need not make them do so.
  A compilation of a covered work with other separate and independent
 works, which are not by their nature extensions of the covered work,
 and which are not combined with it such as to form a larger program,
 in or on a volume of a storage or distribution medium, is called an
 "aggregate" if the compilation and its resulting copyright are not
 used to limit the access or legal rights of the compilation's users
 beyond what the individual works permit.  Inclusion of a covered work
 in an aggregate does not cause this License to apply to the other
 parts of the aggregate.
  6. Conveying Non-Source Forms.
  You may convey a covered work in object code form under the terms
 of sections 4 and 5, provided that you also convey the
 machine-readable Corresponding Source under the terms of this License,
 in one of these ways:
    a) Convey the object code in, or embodied in, a physical product
    (including a physical distribution medium), accompanied by the
    Corresponding Source fixed on a durable physical medium
    customarily used for software interchange.
    b) Convey the object code in, or embodied in, a physical product
    (including a physical distribution medium), accompanied by a
    written offer, valid for at least three years and valid for as
    long as you offer spare parts or customer support for that product
    model, to give anyone who possesses the object code either (1) a
    copy of the Corresponding Source for all the software in the
    product that is covered by this License, on a durable physical
    medium customarily used for software interchange, for a price no
    more than your reasonable cost of physically performing this
    conveying of source, or (2) access to copy the
    Corresponding Source from a network server at no charge.
    c) Convey individual copies of the object code with a copy of the
    written offer to provide the Corresponding Source.  This
    alternative is allowed only occasionally and noncommercially, and
    only if you received the object code with such an offer, in accord
    with subsection 6b.
    d) Convey the object code by offering access from a designated
    place (gratis or for a charge), and offer equivalent access to the
    Corresponding Source in the same way through the same place at no
    further charge.  You need not require recipients to copy the
    Corresponding Source along with the object code.  If the place to
    copy the object code is a network server, the Corresponding Source
    may be on a different server (operated by you or a third party)
    that supports equivalent copying facilities, provided you maintain
    clear directions next to the object code saying where to find the
    Corresponding Source.  Regardless of what server hosts the
    Corresponding Source, you remain obligated to ensure that it is
    available for as long as needed to satisfy these requirements.
    e) Convey the object code using peer-to-peer transmission, provided
    you inform other peers where the object code and Corresponding
    Source of the work are being offered to the general public at no
    charge under subsection 6d.
  A separable portion of the object code, whose source code is excluded
 from the Corresponding Source as a System Library, need not be
 included in conveying the object code work.
  A "User Product" is either (1) a "consumer product", which means any
 tangible personal property which is normally used for personal, family,
 or household purposes, or (2) anything designed or sold for incorporation
 into a dwelling.  In determining whether a product is a consumer product,
 doubtful cases shall be resolved in favor of coverage.  For a particular
 product received by a particular user, "normally used" refers to a
 typical or common use of that class of product, regardless of the status
 of the particular user or of the way in which the particular user
 actually uses, or expects or is expected to use, the product.  A product
 is a consumer product regardless of whether the product has substantial
 commercial, industrial or non-consumer uses, unless such uses represent
 the only significant mode of use of the product.
  "Installation Information" for a User Product means any methods,
 procedures, authorization keys, or other information required to install
 and execute modified versions of a covered work in that User Product from
 a modified version of its Corresponding Source.  The information must
 suffice to ensure that the continued functioning of the modified object
 code is in no case prevented or interfered with solely because
 modification has been made.
  If you convey an object code work under this section in, or with, or
 specifically for use in, a User Product, and the conveying occurs as
 part of a transaction in which the right of possession and use of the
 User Product is transferred to the recipient in perpetuity or for a
 fixed term (regardless of how the transaction is characterized), the
 Corresponding Source conveyed under this section must be accompanied
 by the Installation Information.  But this requirement does not apply
 if neither you nor any third party retains the ability to install
 modified object code on the User Product (for example, the work has
 been installed in ROM).
  The requirement to provide Installation Information does not include a
 requirement to continue to provide support service, warranty, or updates
 for a work that has been modified or installed by the recipient, or for
 the User Product in which it has been modified or installed.  Access to a
 network may be denied when the modification itself materially and
 adversely affects the operation of the network or violates the rules and
 protocols for communication across the network.
  Corresponding Source conveyed, and Installation Information provided,
 in accord with this section must be in a format that is publicly
 documented (and with an implementation available to the public in
 source code form), and must require no special password or key for
 unpacking, reading or copying.
  7. Additional Terms.
  "Additional permissions" are terms that supplement the terms of this
 License by making exceptions from one or more of its conditions.
 Additional permissions that are applicable to the entire Program shall
 be treated as though they were included in this License, to the extent
 that they are valid under applicable law.  If additional permissions
 apply only to part of the Program, that part may be used separately
 under those permissions, but the entire Program remains governed by
 this License without regard to the additional permissions.
  When you convey a copy of a covered work, you may at your option
 remove any additional permissions from that copy, or from any part of
 it.  (Additional permissions may be written to require their own
 removal in certain cases when you modify the work.)  You may place
 additional permissions on material, added by you to a covered work,
 for which you have or can give appropriate copyright permission.
  Notwithstanding any other provision of this License, for material you
 add to a covered work, you may (if authorized by the copyright holders of
 that material) supplement the terms of this License with terms:
    a) Disclaiming warranty or limiting liability differently from the
    terms of sections 15 and 16 of this License; or
    b) Requiring preservation of specified reasonable legal notices or
    author attributions in that material or in the Appropriate Legal
    Notices displayed by works containing it; or
    c) Prohibiting misrepresentation of the origin of that material, or
    requiring that modified versions of such material be marked in
    reasonable ways as different from the original version; or
    d) Limiting the use for publicity purposes of names of licensors or
    authors of the material; or
    e) Declining to grant rights under trademark law for use of some
    trade names, trademarks, or service marks; or
    f) Requiring indemnification of licensors and authors of that
    material by anyone who conveys the material (or modified versions of
    it) with contractual assumptions of liability to the recipient, for
    any liability that these contractual assumptions directly impose on
    those licensors and authors.
  All other non-permissive additional terms are considered "further
 restrictions" within the meaning of section 10.  If the Program as you
 received it, or any part of it, contains a notice stating that it is
 governed by this License along with a term that is a further
 restriction, you may remove that term.  If a license document contains
 a further restriction but permits relicensing or conveying under this
 License, you may add to a covered work material governed by the terms
 of that license document, provided that the further restriction does
 not survive such relicensing or conveying.
  If you add terms to a covered work in accord with this section, you
 must place, in the relevant source files, a statement of the
 additional terms that apply to those files, or a notice indicating
 where to find the applicable terms.
  Additional terms, permissive or non-permissive, may be stated in the
 form of a separately written license, or stated as exceptions;
 the above requirements apply either way.
  8. Termination.
  You may not propagate or modify a covered work except as expressly
 provided under this License.  Any attempt otherwise to propagate or
 modify it is void, and will automatically terminate your rights under
 this License (including any patent licenses granted under the third
 paragraph of section 11).
  However, if you cease all violation of this License, then your
 license from a particular copyright holder is reinstated (a)
 provisionally, unless and until the copyright holder explicitly and
 finally terminates your license, and (b) permanently, if the copyright
 holder fails to notify you of the violation by some reasonable means
 prior to 60 days after the cessation.
  Moreover, your license from a particular copyright holder is
 reinstated permanently if the copyright holder notifies you of the
 violation by some reasonable means, this is the first time you have
 received notice of violation of this License (for any work) from that
 copyright holder, and you cure the violation prior to 30 days after
 your receipt of the notice.
  Termination of your rights under this section does not terminate the
 licenses of parties who have received copies or rights from you under
 this License.  If your rights have been terminated and not permanently
 reinstated, you do not qualify to receive new licenses for the same
 material under section 10.
  9. Acceptance Not Required for Having Copies.
  You are not required to accept this License in order to receive or
 run a copy of the Program.  Ancillary propagation of a covered work
 occurring solely as a consequence of using peer-to-peer transmission
 to receive a copy likewise does not require acceptance.  However,
 nothing other than this License grants you permission to propagate or
 modify any covered work.  These actions infringe copyright if you do
 not accept this License.  Therefore, by modifying or propagating a
 covered work, you indicate your acceptance of this License to do so.
  10. Automatic Licensing of Downstream Recipients.
  Each time you convey a covered work, the recipient automatically
 receives a license from the original licensors, to run, modify and
 propagate that work, subject to this License.  You are not responsible
 for enforcing compliance by third parties with this License.
  An "entity transaction" is a transaction transferring control of an
 organization, or substantially all assets of one, or subdividing an
 organization, or merging organizations.  If propagation of a covered
 work results from an entity transaction, each party to that
 transaction who receives a copy of the work also receives whatever
 licenses to the work the party's predecessor in interest had or could
 give under the previous paragraph, plus a right to possession of the
 Corresponding Source of the work from the predecessor in interest, if
 the predecessor has it or can get it with reasonable efforts.
  You may not impose any further restrictions on the exercise of the
 rights granted or affirmed under this License.  For example, you may
 not impose a license fee, royalty, or other charge for exercise of
 rights granted under this License, and you may not initiate litigation
 (including a cross-claim or counterclaim in a lawsuit) alleging that
 any patent claim is infringed by making, using, selling, offering for
 sale, or importing the Program or any portion of it.
  11. Patents.
  A "contributor" is a copyright holder who authorizes use under this
 License of the Program or a work on which the Program is based.  The
 work thus licensed is called the contributor's "contributor version".
  A contributor's "essential patent claims" are all patent claims
 owned or controlled by the contributor, whether already acquired or
 hereafter acquired, that would be infringed by some manner, permitted
 by this License, of making, using, or selling its contributor version,
 but do not include claims that would be infringed only as a
 consequence of further modification of the contributor version.  For
 purposes of this definition, "control" includes the right to grant
 patent sublicenses in a manner consistent with the requirements of
 this License.
  Each contributor grants you a non-exclusive, worldwide, royalty-free
 patent license under the contributor's essential patent claims, to
 make, use, sell, offer for sale, import and otherwise run, modify and
 propagate the contents of its contributor version.
  In the following three paragraphs, a "patent license" is any express
 agreement or commitment, however denominated, not to enforce a patent
 (such as an express permission to practice a patent or covenant not to
 sue for patent infringement).  To "grant" such a patent license to a
 party means to make such an agreement or commitment not to enforce a
 patent against the party.
  If you convey a covered work, knowingly relying on a patent license,
 and the Corresponding Source of the work is not available for anyone
 to copy, free of charge and under the terms of this License, through a
 publicly available network server or other readily accessible means,
 then you must either (1) cause the Corresponding Source to be so
 available, or (2) arrange to deprive yourself of the benefit of the
 patent license for this particular work, or (3) arrange, in a manner
 consistent with the requirements of this License, to extend the patent
 license to downstream recipients.  "Knowingly relying" means you have
 actual knowledge that, but for the patent license, your conveying the
 covered work in a country, or your recipient's use of the covered work
 in a country, would infringe one or more identifiable patents in that
 country that you have reason to believe are valid.
  If, pursuant to or in connection with a single transaction or
 arrangement, you convey, or propagate by procuring conveyance of, a
 covered work, and grant a patent license to some of the parties
 receiving the covered work authorizing them to use, propagate, modify
 or convey a specific copy of the covered work, then the patent license
 you grant is automatically extended to all recipients of the covered
 work and works based on it.
  A patent license is "discriminatory" if it does not include within
 the scope of its coverage, prohibits the exercise of, or is
 conditioned on the non-exercise of one or more of the rights that are
 specifically granted under this License.  You may not convey a covered
 work if you are a party to an arrangement with a third party that is
 in the business of distributing software, under which you make payment
 to the third party based on the extent of your activity of conveying
 the work, and under which the third party grants, to any of the
 parties who would receive the covered work from you, a discriminatory
 patent license (a) in connection with copies of the covered work
 conveyed by you (or copies made from those copies), or (b) primarily
 for and in connection with specific products or compilations that
 contain the covered work, unless you entered into that arrangement,
 or that patent license was granted, prior to 28 March 2007.
  Nothing in this License shall be construed as excluding or limiting
 any implied license or other defenses to infringement that may
 otherwise be available to you under applicable patent law.
  12. No Surrender of Others' Freedom.
  If conditions are imposed on you (whether by court order, agreement or
 otherwise) that contradict the conditions of this License, they do not
 excuse you from the conditions of this License.  If you cannot convey a
 covered work so as to satisfy simultaneously your obligations under this
 License and any other pertinent obligations, then as a consequence you may
 not convey it at all.  For example, if you agree to terms that obligate you
 to collect a royalty for further conveying from those to whom you convey
 the Program, the only way you could satisfy both those terms and this
 License would be to refrain entirely from conveying the Program.
  13. Use with the GNU Affero General Public License.
  Notwithstanding any other provision of this License, you have
 permission to link or combine any covered work with a work licensed
 under version 3 of the GNU Affero General Public License into a single
 combined work, and to convey the resulting work.  The terms of this
 License will continue to apply to the part which is the covered work,
 but the special requirements of the GNU Affero General Public License,
 section 13, concerning interaction through a network will apply to the
 combination as such.
  14. Revised Versions of this License.
  The Free Software Foundation may publish revised and/or new versions of
 the GNU General Public License from time to time.  Such new versions will
 be similar in spirit to the present version, but may differ in detail to
 address new problems or concerns.
  Each version is given a distinguishing version number.  If the
 Program specifies that a certain numbered version of the GNU General
 Public License "or any later version" applies to it, you have the
 option of following the terms and conditions either of that numbered
 version or of any later version published by the Free Software
 Foundation.  If the Program does not specify a version number of the
 GNU General Public License, you may choose any version ever published
 by the Free Software Foundation.
  If the Program specifies that a proxy can decide which future
 versions of the GNU General Public License can be used, that proxy's
 public statement of acceptance of a version permanently authorizes you
 to choose that version for the Program.
  Later license versions may give you additional or different
 permissions.  However, no additional obligations are imposed on any
 author or copyright holder as a result of your choosing to follow a
 later version.
  15. Disclaimer of Warranty.
  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
 APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
 HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
 OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
 THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
 IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
 ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  16. Limitation of Liability.
  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
 WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
 THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
 GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
 USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
 DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
 PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
 EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
 SUCH DAMAGES.
  17. Interpretation of Sections 15 and 16.
  If the disclaimer of warranty and limitation of liability provided
 above cannot be given local legal effect according to their terms,
 reviewing courts shall apply local law that most closely approximates
 an absolute waiver of all civil liability in connection with the
 Program, unless a warranty or assumption of liability accompanies a
 copy of the Program in return for a fee.
                     END OF TERMS AND CONDITIONS
            How to Apply These Terms to Your New Programs
  If you develop a new program, and you want it to be of the greatest
 possible use to the public, the best way to achieve this is to make it
 free software which everyone can redistribute and change under these terms.
  To do so, attach the following notices to the program.  It is safest
 to attach them to the start of each source file to most effectively
 state the exclusion of warranty; and each file should have at least
 the "copyright" line and a pointer to where the full notice is found.
    <one line to give the program's name and a brief idea of what it does.>
    Copyright (C) <year>  <name of author>
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.
 Also add information on how to contact you by electronic and paper mail.
  If the program does terminal interaction, make it output a short
 notice like this when it starts in an interactive mode:
    <program>  Copyright (C) <year>  <name of author>
    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
    This is free software, and you are welcome to redistribute it
    under certain conditions; type `show c' for details.
 The hypothetical commands `show w' and `show c' should show the appropriate
 parts of the General Public License.  Of course, your program's commands
 might be different; for a GUI interface, you would use an "about box".
  You should also get your employer (if you work as a programmer) or school,
 if any, to sign a "copyright disclaimer" for the program, if necessary.
 For more information on this, and how to apply and follow the GNU GPL, see
 <https://www.gnu.org/licenses/>.
  The GNU General Public License does not permit incorporating your program
 into proprietary programs.  If your program is a subroutine library, you
 may consider it more useful to permit linking proprietary applications with
 the library.  If this is what you want to do, use the GNU Lesser General
 Public License instead of this License.  But first, please read
 <https://www.gnu.org/licenses/why-not-lgpl.html>.
@@ -1,15 +0,0 @@
 ### Spark Update Tool
 #### Introduction
 Welcome to Spark Software Updater. Use this tool to update applications on your Linux system.
 This version is specifically designed for Linux distributions with Qt6 support.
 Please run under root privileges (recommended: use `sudo`).
 #### Currently Supported Linux Distributions
 - [x] GXDE OS
 - [x] Ubuntu
 - [x] deepin
 - [ ] Kylin
 #### Contact & Feedback
 momen@momen.world
@@ -1,25 +0,0 @@
 ### 星火软件更新器
 #### 简介
 欢迎使用星火软件更新器，您可以使用此更新器更新位于您 Linux 计算机的程序。
 此版本专为有qt6的Linux发行版所使用。
 请在root环境下运行。
 #### 当前支持的 Linux 发行版
 - [x] GXDE OS
 - [x] Ubuntu
 - [x] deepin
 - [ ] Kylin
 #### 功能清单
 | 功能模块         | 描述                                 |
 |------------------|--------------------------------------|
 | 应用名识别       | 基于 `ss-do-upgrade.sh` 部分代码实现 |
 | 应用包大小识别   | 通过 dpkg 获取包大小信息             |
 | 获取应用图标     | 利用 QDesktopServices 实现           |
 | 支持 ACE 兼容环境|                                      |
 | 多线程下载       | 基于 aptss 方案                      |
 如您已安装星火应用商店，则会附带本程序。
 #### 联系与反馈
 momen@momen.world
@@ -1,27 +0,0 @@
 spark-update-tool (1.0.4) unstable; urgency=low
  * 修复点击更新全部按钮后，会更新被忽略应用的问题。
 spark-update-tool (1.0.3) unstable; urgency=low
  * 修复默认图标加载失败的问题
  * 修复更新器在安装阶段强制关闭窗口后再次更新无法安装软件包的问题。
 -- momen <vmomenv@gmail.com>  Fri, 17 Oct 2025 00:00:00 +0000
 spark-update-tool (1.0.2) unstable; urgency=low
  * 添加复选框，选择多个包更新
  * 修复缩放问题
  * 添加忽略应用功能
 -- momen <vmomenv@gmail.com>  Mon, 29 Sep 2025 00:00:00 +0000
 spark-update-tool (1.0.1) unstable; urgency=low
  * 修复窗口调整大小时的错误
 -- momen <vmomenv@gmail.com>  Wed, 18 Jun 2025 00:00:00 +0000
 spark-update-tool (1.0.0) unstable; urgency=low
  * Initial release.
 -- momen <vmomenv@gmail.com>  Wed, 18 Jun 2025 00:00:00 +0000
@@ -1 +0,0 @@
 13
@@ -1,13 +0,0 @@
 Source: spark-update-tool
 Section: utils
 Priority: optional
 Maintainer: momen <vmomenv@gmail.com>
 Build-Depends: debhelper (>= 9)
 Standards-Version: 3.9.6
 Homepage: https://gitee.com/spark-store-project/Spark-Update-Tool
 Package: spark-update-tool
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Description: Spark Update Tool
 星火应用商店更新组件。This package provides the Spark Update Tool. It includes features for checking for updates, downloading, and applying them seamlessly.
@@ -1,7 +0,0 @@
 Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 Upstream-Name: spark-update-tool
 Source: https://gitee.com/spark-store-project/Spark-Update-Tool
 Files: *
 Copyright: 2025, momen <vmomenv@gmail.com>
 License: GPL-3.0+
@@ -1,3 +0,0 @@
 build/spark-update-tool /usr/bin/
 debian/spark-update-tool.desktop /usr/share/applications
 resources/128*128/spark-update-tool.png /usr/share/icons/hicolor/128x128/apps
@@ -1,11 +0,0 @@
 #!/bin/sh
 set -e
 case "$1" in
    purge)
        rm -rf /usr/share/spark-update-tool
        ;;
 esac
 exit 0
@@ -1,27 +0,0 @@
 #!/usr/bin/make -f
 # 声明兼容性级别
 export DH_VERBOSE=1
 %:
 	dh $@ --buildsystem=cmake
 # 确保使用CMake进行配置
 override_dh_auto_configure:
 	dh_auto_configure -- -DCMAKE_INSTALL_PREFIX=/usr
 # 确保使用CMake进行构建
 override_dh_auto_build:
 	dh_auto_build
 # 确保使用CMake进行安装
 override_dh_auto_install:
 	dh_auto_install
 # 确保使用CMake进行清理
 override_dh_auto_clean:
 	dh_auto_clean
 # 确保使用CMake进行依赖解析
 override_dh_shlibdeps:
 	dh_shlibdeps --dpkg-shlibdeps-params=--ignore-missing-info
@@ -1 +0,0 @@
 3.0 (native)
@@ -1,9 +0,0 @@
 [Desktop Entry]
 Version=1.0
 Name=Spark Update Tool
 Comment=A Qt-based application for managing and updating software
 Exec=spark-update-tool
 Icon=spark-update-tool
 Terminal=false
 Type=Application
 Categories=Utility;
@@ -1 +0,0 @@
 <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1" width="12" height="16" viewBox="0 0 12 16"><defs><clipPath id="master_svg0_1_074"><rect x="0.75" y="2" width="10.5" height="12" rx="0"/></clipPath></defs><g><rect x="0" y="0" width="12" height="16" rx="0" fill="#000000" fill-opacity="0" style="mix-blend-mode:passthrough"/><g clip-path="url(#master_svg0_1_074)"><g transform="matrix(1,0,0,-1,0,24.015625)"><g><path d="M4.71094,12.2187505Q4.94531,12.0078125,5.25,12.0078125Q5.55469,12.0078125,5.78906,12.2187505L10.2891,16.7187525Q10.5,16.9531225,10.5,17.2578125Q10.5,17.5625025,10.2891,17.7968725Q10.0547,18.0078125,9.75,18.0078125Q9.44531,18.0078125,9.21094,17.7968725L5.25,13.8125025L1.28906,17.7968725Q1.05469,18.0078125,0.75,18.0078125Q0.445312,18.0078125,0.210938,17.7968725Q0,17.5625025,0,17.2578125Q0,16.9531225,0.210938,16.7187525L4.71094,12.2187505Z" fill="#4B5563" fill-opacity="1" style="mix-blend-mode:passthrough"/></g></g></g></g></svg>
@@ -1,54 +0,0 @@
 QT += core gui widgets network concurrent
 TARGET = spark-update-tool
 TEMPLATE = app
 # Set C++ standard to C++17
 CONFIG += c++17
 # Enable auto features (uic, moc, rcc)
 CONFIG += qt warn_on release
 # Version info
 VERSION = 0.1.0
 DEFINES += APP_VERSION=\\\"$$VERSION\\\"
 # Source files
 SOURCES += \
    src/main.cpp \
    src/mainwindow.cpp \
    src/aptssupdater.cpp \
    src/appdelegate.cpp \
    src/applistmodel.cpp \
    src/downloadmanager.cpp \
    src/ignoreconfig.cpp
 HEADERS += \
    src/mainwindow.h \
    src/aptssupdater.h \
    src/appdelegate.h \
    src/applistmodel.h \
    src/downloadmanager.h \
    src/ignoreconfig.h
 FORMS += \
    src/mainwindow.ui
 RESOURCES += \
    src/icons.qrc
 # Linux-specific settings
 unix:!macx {
    # 安装到 /usr/bin 目录
    target.path = /usr/bin
    INSTALLS += target
    # 如果需要安装其他文件（如桌面文件、图标等），可以添加
    # desktop.path = /usr/share/applications
    # desktop.files = spark-update-tool.desktop
    # INSTALLS += desktop
    # Additional Linux specific configurations if needed
    QMAKE_CXXFLAGS += -Wall -Wextra
 }
 # Remove Windows and macOS specific sections since we're focusing on Linux
@@ -1,75 +0,0 @@
 #pragma once
 #include <QStyledItemDelegate>
 #include <QHash>
 #include <QQueue>
 #include <QProcess>
 #include <QElapsedTimer>
 #include <QTimer>
 #include <QSet>
 #include "downloadmanager.h"
 struct DownloadInfo {
    int progress = 0;
    bool isDownloading = false;
    bool isInstalled = false;
    bool isInstalling = false;
 };
 class AppDelegate : public QStyledItemDelegate {
    Q_OBJECT
 public:
    explicit AppDelegate(QObject *parent = nullptr);
    ~AppDelegate();
    void setModel(QAbstractItemModel *model);
    void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override;
    QSize sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const override;
    bool editorEvent(QEvent *event, QAbstractItemModel *model,
                     const QStyleOptionViewItem &option, const QModelIndex &index) override;
    void startDownloadForAll();
    void startDownloadForSelected();
    // 复选框相关方法
    void setSelectedPackages(const QSet<QString> &selected);
    QSet<QString> getSelectedPackages() const;
    void clearSelection();
    // 获取下载状态信息
    const QHash<QString, DownloadInfo>& getDownloads() const;
 signals:
    void updateDisplay(const QString &packageName);
    void updateFinished(bool success); //传递是否完成更新
    void ignoreApp(const QString &packageName, const QString &version); // 新增：忽略应用信号
    void unignoreApp(const QString &packageName, const QString &version); // 新增：取消忽略应用信号
 private slots:
    void updateSpinner(); // 新增槽函数
 private:
    DownloadManager *m_downloadManager;
    QHash<QString, DownloadInfo> m_downloads;
    QAbstractItemModel *m_model = nullptr;
    // 复选框相关成员变量
    QSet<QString> m_selectedPackages;
    // 迁移包集合（用户确认要迁移的包）
    QSet<QString> m_migrationPackages;
    QQueue<QString> m_installQueue;
    bool m_isInstalling = false;
    QProcess *m_installProcess = nullptr;
    QString m_installingPackage;
    QElapsedTimer m_spinnerTimer;
    QTimer m_spinnerUpdateTimer; // 新增定时器
    int m_spinnerAngle = 0; // 新增角度变量
    void enqueueInstall(const QString &packageName);
    void startNextInstall();
 };
@@ -1,86 +0,0 @@
 #include "applistmodel.h"
 AppListModel::AppListModel(QObject *parent) : QAbstractListModel(parent) {}
 int AppListModel::rowCount(const QModelIndex &parent) const
 {
    if (parent.isValid())
        return 0;
    return m_data.size();
 }
 QVariant AppListModel::data(const QModelIndex &index, int role) const
 {
    if (!index.isValid() || index.row() >= m_data.size())
        return QVariant();
    const QVariantMap &map = m_data.at(index.row()); // 直接访问 QVariantMap
    switch (role) {
    case Qt::DisplayRole:
        return map.value("name");
    case Qt::UserRole + 1: // 包名
        return map.value("package");
    case Qt::UserRole + 2: // 当前版本
        return map.value("current_version");
    case Qt::UserRole + 3: // 新版本
        return map.value("new_version");
    case Qt::UserRole + 4: // 图标路径
        return map.value("icon");
    case Qt::UserRole + 5: // 文件大小
        return map.value("size");
    case Qt::UserRole + 6: // 描述
        return map.value("description");
    case Qt::UserRole + 7: // 下载 URL
        return map.value("download_url"); // 返回下载 URL
    case Qt::UserRole + 8: // 忽略状态
        return map.value("ignored");
    case Qt::UserRole + 9: // 包来源
        return map.value("source");
    case Qt::UserRole + 10: // 是否为迁移项
        return map.value("is_migration");
    case Qt::UserRole + 11: // 迁移源
        return map.value("migration_source");
    case Qt::UserRole + 12: // 迁移目标
        return map.value("migration_target");
    default:
        return QVariant();
    }
 }
 void AppListModel::setUpdateData(const QJsonArray &updateInfo)
 {
    beginResetModel();
    m_data.clear(); // 清空 QList<QVariantMap>
    for (const auto &item : updateInfo) {
        QJsonObject obj = item.toObject();
        QVariantMap map;
        map["package"] = obj["package"].toString();
        map["name"] = obj["name"].toString();
        map["current_version"] = obj["current_version"].toString();
        map["new_version"] = obj["new_version"].toString();
        map["icon"] = obj["icon"].toString();
        map["size"] = obj["size"].toString();
        map["download_url"] = obj["download_url"].toString(); // 确保设置下载 URL
        map["ignored"] = obj["ignored"].toBool(); // 设置忽略状态
        map["source"] = obj["source"].toString(); // 设置包来源
        map["is_migration"] = obj["is_migration"].toBool(); // 设置是否为迁移项
        map["migration_source"] = obj["migration_source"].toString(); // 设置迁移源
        map["migration_target"] = obj["migration_target"].toString(); // 设置迁移目标
        m_data.append(map); // 添加到 QList<QVariantMap>
        qDebug() << "设置到模型的包名:" << map["package"].toString() << "忽略状态:" << map["ignored"].toBool() << "来源:" << map["source"].toString();
        qDebug() << "设置到模型的下载 URL:" << map["download_url"].toString(); // 检查设置的数据
    }
    endResetModel();
 }
 bool AppListModel::isAppIgnored(const QModelIndex &index) const
 {
    if (!index.isValid() || index.row() >= m_data.size())
        return false;
    const QVariantMap &map = m_data.at(index.row());
    return map.value("ignored").toBool();
 }
@@ -1,29 +0,0 @@
 #ifndef APPLISTMODEL_H
 #define APPLISTMODEL_H
 #include <QAbstractListModel>
 #include <QJsonArray>
 // 添加 QJsonObject 头文件
 #include <QJsonObject>
 #include <QDebug>
 class AppListModel : public QAbstractListModel
 {
    Q_OBJECT
 public:
    explicit AppListModel(QObject *parent = nullptr);
    // 重写方法
    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
    // 设置更新数据
    void setUpdateData(const QJsonArray &data);
    // 获取忽略状态
    bool isAppIgnored(const QModelIndex &index) const;
 private:
    QList<QVariantMap> m_data; // 修改类型为 QList<QVariantMap>
 };
 #endif // APPLISTMODEL_H
@@ -1,709 +0,0 @@
 #include "aptssupdater.h"
 #include <QProcess>
 #include <QTextStream>
 #include <QRegularExpression>
 #include <QFile>
 #include <QDir>
 #include <qdebug.h>
 aptssUpdater::aptssUpdater(QWidget *parent)
    : QWidget(parent)
 {
    packageName = getUpdateablePackages();
    apmPackageName = getApmUpdateablePackages();
 }
 QStringList aptssUpdater::getUpdateablePackages()
 {
    QStringList packageDetails;
    // 检查aptss命令是否存在
    QProcess checkProcess;
    checkProcess.start("which", QStringList() << "aptss");
    if (!checkProcess.waitForFinished(5000) || checkProcess.exitCode() != 0) {
        qDebug() << "aptss命令不存在，跳过Spark更新检查";
        return packageDetails;
    }
    QProcess process;
    QString command = R"(env LANGUAGE=en_US /usr/bin/apt -c /opt/durapps/spark-store/bin/apt-fast-conf/aptss-apt.conf list --upgradable -o Dir::Etc::sourcelist="/opt/durapps/spark-store/bin/apt-fast-conf/sources.list.d/aptss.list" -o Dir::Etc::sourceparts="/dev/null" -o APT::Get::List-Cleanup="0" | awk 'NR>1')";
    process.start("bash", QStringList() << "-c" << command);
    if (!process.waitForFinished(30000)) { // 30秒超时
        qWarning() << "Process failed to finish within 30 seconds.";
        process.kill();
        return packageDetails;
    }
    QString output = process.readAllStandardOutput();
 #if QT_VERSION >= QT_VERSION_CHECK(5, 14, 0)
        QStringList lines = output.split('\n', Qt::SkipEmptyParts);
 #else
        QStringList lines = output.split('\n', QString::SkipEmptyParts);
 #endif
    // 创建临时文件
    QTemporaryFile tempFile;
    tempFile.setAutoRemove(false);
    if (tempFile.open()) {
        QTextStream stream(&tempFile);
        for (const QString &line : lines) {
            QRegularExpression regex(R"(([\w\-\+\.]+)/\S+\s+([^\s]+)\s+\S+\s+\[upgradable from: ([^\]]+)\])");
            QRegularExpressionMatch match = regex.match(line);
            if (match.hasMatch()) {
                QString name = match.captured(1);
                QString newVersion = match.captured(2);
                QString oldVersion = match.captured(3);
                // 检查版本是否相同，相同则跳过
                if (newVersion == oldVersion) {
                    qDebug() << "跳过版本相同的包:" << name << "(" << oldVersion << "→" << newVersion << ")";
                    continue;
                }
                // 写入内存列表
                packageDetails << QString("%1: %2 → %3").arg(name, oldVersion, newVersion);
                // 写入临时文件（原始数据）
                stream << name << "|" << oldVersion << "|" << newVersion << "\n";
            }
        }
        tempFile.close();
        m_tempFilePath = tempFile.fileName();
        qDebug()<< "临时文件路径：" << m_tempFilePath;
    } else {
        qWarning() << "无法创建临时文件";
    }
    return packageDetails;
 }
 QStringList aptssUpdater::getPackageSizes()
 {
    QStringList packageDetails;
    // 获取可更新包名列表
    QStringList updateablePackages;
    for (const QString &pkgInfo : packageName) {
        updateablePackages << pkgInfo.section(":", 0, 0).trimmed();
    }
    foreach (const QString &packageName, updateablePackages) {
        QProcess process;  // 在循环内部创建新的QProcess实例
        // 构建新命令（包含包名参数）
        QString command = QString("/usr/bin/apt download %1 --print-uris -c /opt/durapps/spark-store/bin/apt-fast-conf/aptss-apt.conf "
                                  "-o Dir::Etc::sourcelist=\"/opt/durapps/spark-store/bin/apt-fast-conf/sources.list.d/aptss.list\" "
                                  "-o Dir::Etc::sourceparts=\"/dev/null\"").arg(packageName);
        process.start("bash", QStringList() << "-c" << command);
        if (!process.waitForFinished(30000)) { // 30秒超时
            qWarning() << "获取包信息失败：" << packageName << "（超时）";
            process.kill();
            continue;
        }
        QString output = process.readAllStandardOutput();
        // 使用正则匹配所有信息
        // 调整正则表达式匹配分组
        QRegularExpression regex(R"('([^']+)'\s+(\S+)\s+(\d+)\s+SHA512:([^\s]+))");  // 分组1:URL 分组2:文件名 分组3:大小 分组4:SHA512
        QRegularExpressionMatch match = regex.match(output);
        if (match.hasMatch()) {
            QString url = match.captured(1);
            QString fileName = match.captured(2);
            QString size = match.captured(3);
            QString sha512 = match.captured(4);
            // 调整字段顺序：包名 | 大小 | URL | SHA512
            packageDetails << QString("%1: %2|%3|%4").arg(packageName, size, url, sha512);
        }
    }
    qDebug() << "完整包信息：" << packageDetails;
    return packageDetails;
 }
 QStringList aptssUpdater::getDesktopAppNames()
 {
    QStringList appNames;
    // 获取当前系统语言环境
    QString lang = QLocale().name().replace("_", "-");
    // 遍历所有可更新包（复用已有的临时文件数据）
    QStringList packages = packageName;
    foreach (const QString &package, packages) {
        QProcess dpkgProcess;  // 在循环内部创建新的QProcess实例
        QString packageName = package.split(":")[0];
        QString finalName = packageName; // 默认使用包名
        // 获取包文件列表
        dpkgProcess.start("dpkg", QStringList() << "-L" << packageName);
        if (!dpkgProcess.waitForFinished(30000)) { // 30秒超时
            qWarning() << "获取包文件列表失败：" << packageName << "（超时）";
            dpkgProcess.kill();
            continue;
        }
        // 修复：添加这行代码来获取进程输出
        QString output = dpkgProcess.readAllStandardOutput();
 #if QT_VERSION >= QT_VERSION_CHECK(5, 14, 0)
        QStringList files = output.split('\n', Qt::SkipEmptyParts);
 #else
        QStringList files = output.split('\n', QString::SkipEmptyParts);
 #endif
        // 先检查常规应用目录
        QStringList regularDesktopFiles = files.filter("/usr/share/applications/");
        QString regularAppName;
        if (!regularDesktopFiles.isEmpty()) {
            checkDesktopFiles(regularDesktopFiles, regularAppName, lang, packageName);
        }
        // 如果常规目录没有找到，再检查特殊目录
        if (regularAppName.isEmpty()) {
            QStringList specialDesktopFiles = files.filter(QRegularExpression(QString("/opt/apps/%1/entries/applications").arg(packageName)));
            QString specialAppName;
            if (!specialDesktopFiles.isEmpty()) {
                checkDesktopFiles(specialDesktopFiles, specialAppName, lang, packageName);
                if (!specialAppName.isEmpty()) {
                    finalName = specialAppName;
                }
            }
        } else {
            finalName = regularAppName;
        }
        // 输出格式为[软件名|包名]
        appNames << QString("[%1|%2]").arg(finalName, packageName);
    }
    qDebug()<< "应用名称列表：" << appNames;
    return appNames;
 }
 bool aptssUpdater::checkDesktopFiles(const QStringList &desktopFiles, QString &appName, const QString &lang, const QString &packageName)
 {
    QString lastValidName; 
    QRegularExpression noDisplayRe("^NoDisplay=(true|True)");
    QRegularExpression nameRe("^Name\\[?" + lang + "?\\]?=(.*)");
    QRegularExpression nameOrigRe("^Name=(.*)");
    foreach (const QString &filePath, desktopFiles) {
        if (!filePath.endsWith(".desktop")) continue;
        QFile file(filePath);
        if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) continue;
        bool skip = false;
        QString currentName;
        QTextStream in(&file);
        while (!in.atEnd()) {
            QString line = in.readLine().trimmed();
            // 检查NoDisplay属性
            if (line.startsWith("NoDisplay=")) {
                if (noDisplayRe.match(line).hasMatch()) {
                    skip = true;
                    break;
                }
            }
            // 优先匹配本地化名称
            if (currentName.isEmpty()) {
                QRegularExpressionMatch match = nameRe.match(line);
                if (match.hasMatch()) {
                    currentName = match.captured(1);
                    continue;
                }
                // 匹配原始名称
                match = nameOrigRe.match(line);
                if (match.hasMatch()) {
                    currentName = match.captured(1);
                }
            }
        }
        if (!skip && !currentName.isEmpty()) {
            lastValidName = currentName;
        }
    }
    // 处理最终的有效名称
    if (!lastValidName.isEmpty()) {
        appName = lastValidName;  // 直接赋值而不是使用<<
        return true;
    }
    // 回退到包名
    appName = packageName;
    return false;
 }
 QStringList aptssUpdater::getPackageIcons()
 {
    QStringList packageIcons;
    // 遍历所有可更新包
    QStringList packages = packageName;
    foreach (const QString &package, packages) {
        QProcess dpkgProcess;  // 在循环内部创建新的QProcess实例
        QString packageName = package.split(":")[0];
        QString iconPath = ":/resources/default_icon.png"; // 默认图标
        // 获取包文件列表
        dpkgProcess.start("dpkg", QStringList() << "-L" << packageName);
        if (!dpkgProcess.waitForFinished(30000)) { // 30秒超时
            qWarning() << "获取包文件列表失败：" << packageName << "（超时）";
            dpkgProcess.kill();
            packageIcons << QString("%1: %2").arg(packageName, iconPath);
            continue;
        }
 #if QT_VERSION >= QT_VERSION_CHECK(5, 14, 0)
        QStringList files = QString(dpkgProcess.readAllStandardOutput()).split('\n', Qt::SkipEmptyParts);
 #else
        QStringList files = QString(dpkgProcess.readAllStandardOutput()).split('\n', QString::SkipEmptyParts);
 #endif
        // 查找.desktop文件
        QStringList desktopFiles = files.filter(QRegularExpression("/(usr/share|opt/apps)/.*\\.desktop$"));
        // 从.desktop文件中提取图标
        foreach (const QString &desktopFile, desktopFiles) {
            QFile file(desktopFile);
            if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
                QTextStream in(&file);
                while (!in.atEnd()) {
                    QString line = in.readLine().trimmed();
                    if (line.startsWith("Icon=")) {
                        QString iconName = line.mid(5).trimmed();
                        // 处理相对图标名（如Icon=vscode）
                        if (!iconName.contains('/')) {
                            // 查找标准图标路径
                            QStringList iconPaths = {
                                QString("/usr/share/pixmaps/%1.png").arg(iconName),
                                QString("/usr/share/icons/hicolor/48x48/apps/%1.png").arg(iconName),
                                QString("/usr/share/icons/hicolor/scalable/apps/%1.svg").arg(iconName),
                                QString("/opt/apps/%1/entries/icons/hicolor/48x48/apps/%2.png").arg(packageName, iconName)
                            };
                            foreach (const QString &path, iconPaths) {
                                if (QFile::exists(path)) {
                                    iconPath = path;
                                    qDebug() << "找到图标文件:" << path;
                                    break;
                                }
                            }
                        } else {
                            // 已经是绝对路径
                            if (QFile::exists(iconName)) {
                                iconPath = iconName;
                                qDebug() << "使用绝对路径图标文件:" << iconName;
                            }
                        }
                        break;
                    }
                }
                file.close();
            }
        }
        // 如果.desktop中没有找到图标，尝试直接查找包中的图标文件
        if (iconPath == ":/resources/default_icon.png") {
            qDebug() << "未在.desktop文件中找到图标，尝试直接查找包中的图标文件";
            QStringList iconFiles = files.filter(QRegularExpression("/(usr/share/pixmaps|usr/share/icons|opt/apps/.*/entries/icons)/.*\\.(png|svg)$"));
            if (!iconFiles.isEmpty()) {
                iconPath = iconFiles.first();
                qDebug() << "从包中找到图标文件:" << iconPath;
            } else {
                qDebug() << "未在包中找到图标文件，使用默认图标";
            }
        }
        qDebug() << "包名:" << packageName << "图标路径:" << iconPath;
        packageIcons << QString("%1: %2").arg(packageName, iconPath);
    }
    return packageIcons;
 }
 QJsonArray aptssUpdater::getUpdateInfoAsJson()
 {
    QJsonArray jsonArray;
    // 获取所有需要的信息
    QStringList sizes = getPackageSizes();
    QStringList names = getDesktopAppNames();
    QStringList icons = getPackageIcons();
    // 创建包名到各种信息的映射
    QHash<QString, QHash<QString, QString>> packageInfo;
    // 解析包版本信息
    for (const QString &pkg : packageName) {
        QStringList parts = pkg.split(": ");
        if (parts.size() >= 2) {
            QString packageName = parts[0];
            QStringList versions = parts[1].split(" → ");
            if (versions.size() == 2) {
                packageInfo[packageName]["current_version"] = versions[0];
                packageInfo[packageName]["new_version"] = versions[1];
            }
        }
    }
    // 解析包详细信息（新增部分）
    for (const QString &sizeInfo : sizes) {
        QStringList parts = sizeInfo.split(": ");
        if (parts.size() == 2) {
            QString packageName = parts[0];
            QStringList details = parts[1].split("|");
            if (details.size() == 3) {  // 现在包含大小|URL|SHA512
                packageInfo[packageName]["size"] = details[0];
                packageInfo[packageName]["url"] = details[1];
                packageInfo[packageName]["sha512"] = details[2];
            }
        }
    }
    // 解析应用名称信息
    for (const QString &nameInfo : names) {
        if (nameInfo.startsWith("[") && nameInfo.endsWith("]")) {
            QString content = nameInfo.mid(1, nameInfo.length() - 2);
            QStringList parts = content.split("|");
            if (parts.size() == 2) {
                QString displayName = parts[0];
                QString packageName = parts[1];
                packageInfo[packageName]["display_name"] = displayName;
            }
        }
    }
    // 解析图标信息
    for (const QString &iconInfo : icons) {
        QStringList parts = iconInfo.split(": ");
        if (parts.size() == 2) {
            QString packageName = parts[0];
            packageInfo[packageName]["icon"] = parts[1].trimmed();
        }
    }
    // 构建JSON数组
    for (const QString &packageName : packageInfo.keys()) {
        QJsonObject jsonObj;
        jsonObj["package"] = packageName;
        // 使用显示名称(如果有)，否则使用包名
        if (packageInfo[packageName].contains("display_name")) {
            jsonObj["name"] = packageInfo[packageName]["display_name"];
        } else {
            jsonObj["name"] = packageName;
        }
        jsonObj["current_version"] = packageInfo[packageName]["current_version"];
        jsonObj["new_version"] = packageInfo[packageName]["new_version"];
        jsonObj["icon"] = packageInfo[packageName]["icon"];
        jsonObj["ignored"] = false; // 默认不忽略
        // 如果有大小信息也加入
        if (packageInfo[packageName].contains("size")) {
            jsonObj["size"] = packageInfo[packageName]["size"];
        }
        // 在构建JSON对象时添加新字段（在jsonObj中添加）：
        if (packageInfo[packageName].contains("url")) {
            jsonObj["download_url"] = packageInfo[packageName]["url"];
            qDebug() << "生成的下载 URL:" << packageInfo[packageName]["url"]; // 检查生成的 URL
        } else {
            qWarning() << "未找到下载 URL，包名:" << packageName;
            jsonObj["download_url"] = ""; // 设置为空字符串以避免崩溃
        }
        jsonObj["sha512"] = packageInfo[packageName]["sha512"];
        jsonArray.append(jsonObj);
    }
    qDebug()<<jsonArray;
    return jsonArray;
 }
 QStringList aptssUpdater::getApmUpdateablePackages()
 {
    QStringList packageDetails;
    // 检查apm命令是否存在
    QProcess checkProcess;
    checkProcess.start("which", QStringList() << "apm");
    if (!checkProcess.waitForFinished(5000) || checkProcess.exitCode() != 0) {
        qDebug() << "apm命令不存在，跳过APM更新检查";
        return packageDetails;
    }
    QProcess process;
    QString command = R"(env LANGUAGE=en_US /usr/bin/apm list --upgradable | awk 'NR>1')";
    process.start("bash", QStringList() << "-c" << command);
    if (!process.waitForFinished(30000)) { // 30秒超时
        qWarning() << "APM process failed to finish within 30 seconds.";
        process.kill();
        return packageDetails;
    }
    QString output = process.readAllStandardOutput();
 #if QT_VERSION >= QT_VERSION_CHECK(5, 14, 0)
        QStringList lines = output.split('\n', Qt::SkipEmptyParts);
 #else
        QStringList lines = output.split('\n', QString::SkipEmptyParts);
 #endif
    for (const QString &line : lines) {
        QRegularExpression regex(R"(([\w\-\+\.]+)/\S+\s+([^\s]+)\s+\S+\s+\[upgradable from: ([^\]]+)\])");
        QRegularExpressionMatch match = regex.match(line);
        if (match.hasMatch()) {
            QString name = match.captured(1);
            QString newVersion = match.captured(2);
            QString oldVersion = match.captured(3);
            // 检查版本是否相同，相同则跳过
            if (newVersion == oldVersion) {
                qDebug() << "跳过版本相同的APM包:" << name << "(" << oldVersion << "→" << newVersion << ")";
                continue;
            }
            // 写入内存列表
            packageDetails << QString("%1: %2 → %3").arg(name, oldVersion, newVersion);
        }
    }
    return packageDetails;
 }
 QJsonArray aptssUpdater::getApmUpdateInfoAsJson()
 {
    QJsonArray jsonArray;
    // 解析APM包版本信息
    QHash<QString, QHash<QString, QString>> packageInfo;
    for (const QString &pkg : apmPackageName) {
        QStringList parts = pkg.split(": ");
        if (parts.size() >= 2) {
            QString packageName = parts[0];
            QStringList versions = parts[1].split(" → ");
            if (versions.size() == 2) {
                packageInfo[packageName]["current_version"] = versions[0];
                packageInfo[packageName]["new_version"] = versions[1];
                packageInfo[packageName]["source"] = "apm";
            }
        }
    }
    // 构建JSON数组
    for (const QString &packageName : packageInfo.keys()) {
        QJsonObject jsonObj;
        jsonObj["package"] = packageName;
        // 从APM桌面文件中解析应用名称和图标
        QString displayName = packageName; // 默认使用包名
        QString iconPath = ":/resources/default_icon.png"; // 默认图标
        // APM应用的desktop文件路径
        QString apmDesktopPath = QString("/var/lib/apm/apm/files/ace-env/var/lib/apm/%1/entries/applications").arg(packageName);
        QDir desktopDir(apmDesktopPath);
        if (desktopDir.exists()) {
            // 查找desktop文件
            QStringList desktopFiles = desktopDir.entryList(QStringList() << "*.desktop", QDir::Files);
            if (!desktopFiles.isEmpty()) {
                QString desktopFile = desktopDir.absoluteFilePath(desktopFiles.first());
                QFile file(desktopFile);
                if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
                    QTextStream in(&file);
                    while (!in.atEnd()) {
                        QString line = in.readLine().trimmed();
                        if (line.startsWith("Name=")) {
                            displayName = line.mid(5).trimmed();
                        } else if (line.startsWith("Icon=")) {
                            QString iconName = line.mid(5).trimmed();
                            // 处理图标路径
                            if (!iconName.contains('/')) {
                                // 查找APM包中的图标
                                QString apmIconPath = QString("/var/lib/apm/apm/files/ace-env/var/lib/apm/%1/entries/icons/hicolor/48x48/apps/%2.png").arg(packageName, iconName);
                                if (QFile::exists(apmIconPath)) {
                                    iconPath = apmIconPath;
                                }
                            } else {
                                // 已经是绝对路径
                                if (QFile::exists(iconName)) {
                                    iconPath = iconName;
                                }
                            }
                        }
                    }
                    file.close();
                }
            }
        }
        // 获取APM包大小和下载信息
        QString size = "0";
        QString url = "";
        QString sha512 = "";
        QProcess process;
        QString command = QString("amber-pm-debug /usr/bin/apt -c /opt/durapps/spark-store/bin/apt-fast-conf/aptss-apt.conf download %1 --print-uris").arg(packageName);
        process.start("bash", QStringList() << "-c" << command);
        if (process.waitForFinished(30000)) { // 30秒超时
            QString output = process.readAllStandardOutput();
            // 解析输出格式：'URL' 文件名 大小 SHA512:哈希值
            QRegularExpression regex(R"('([^']+)'\s+\S+\s+(\d+)\s+SHA512:([^\s]+))");
            QRegularExpressionMatch match = regex.match(output);
            if (match.hasMatch()) {
                url = match.captured(1);
                size = match.captured(2);
                sha512 = match.captured(3);
            }
        }
        jsonObj["name"] = displayName;
        jsonObj["current_version"] = packageInfo[packageName]["current_version"];
        jsonObj["new_version"] = packageInfo[packageName]["new_version"];
        jsonObj["icon"] = iconPath;
        jsonObj["ignored"] = false; // 默认不忽略
        jsonObj["source"] = "apm";
        jsonObj["size"] = size;
        jsonObj["download_url"] = url;
        jsonObj["sha512"] = sha512;
        jsonArray.append(jsonObj);
    }
    qDebug()<<"APM更新信息:"<<jsonArray;
    return jsonArray;
 }
 QJsonArray aptssUpdater::mergeUpdateInfo()
 {
    QJsonArray aptssInfo = getUpdateInfoAsJson();
    QJsonArray apmInfo = getApmUpdateInfoAsJson();
    // 创建包名到更新信息的映射
    QHash<QString, QJsonObject> aptssMap;
    for (const QJsonValue &value : aptssInfo) {
        QJsonObject obj = value.toObject();
        QString packageName = obj["package"].toString();
        obj["source"] = "aptss";
        aptssMap[packageName] = obj;
    }
    QHash<QString, QJsonObject> apmMap;
    for (const QJsonValue &value : apmInfo) {
        QJsonObject obj = value.toObject();
        QString packageName = obj["package"].toString();
        obj["source"] = "apm";
        apmMap[packageName] = obj;
    }
    QJsonArray mergedArray;
    // 处理只在aptss中存在的包
    for (const QString &packageName : aptssMap.keys()) {
        if (!apmMap.contains(packageName)) {
            mergedArray.append(aptssMap[packageName]);
        }
    }
    // 处理只在apm中存在的包
    for (const QString &packageName : apmMap.keys()) {
        if (!aptssMap.contains(packageName)) {
            mergedArray.append(apmMap[packageName]);
        }
    }
    // 处理在两者中都存在的包
    for (const QString &packageName : aptssMap.keys()) {
        if (apmMap.contains(packageName)) {
            QJsonObject aptssObj = aptssMap[packageName];
            QJsonObject apmObj = apmMap[packageName];
            // 比较版本
            QString aptssVersion = aptssObj["new_version"].toString();
            QString apmVersion = apmObj["new_version"].toString();
            // 检查包在两个源中的安装状态
            bool installedInAptss = isPackageInstalledInAptss(packageName);
            bool installedInApm = isPackageInstalledInApm(packageName);
            // 判断是否为迁移场景：
            // 1. 只在 aptss 中安装了包（不在 apm 中安装）
            // 2. APM 版本更新
            if (installedInAptss && !installedInApm && apmVersion > aptssVersion) {
                // 迁移场景：Spark -> APM
                QJsonObject migrationObj = apmObj;
                migrationObj["is_migration"] = true;
                migrationObj["migration_source"] = "aptss";
                migrationObj["migration_target"] = "apm";
                migrationObj["aptss_version"] = aptssVersion;
                mergedArray.append(migrationObj);
                // 同时保留aptss的更新项（如果aptss也有更新）
                mergedArray.append(aptssObj);
            } else {
                // 非迁移场景（共存场景）：同时展示两个来源的更新
                // 包括以下情况：
                // 1. 同时在 aptss 和 apm 中都安装了包
                // 2. 只在 apm 中安装了包
                // 3. APM 版本不更新
                mergedArray.append(aptssObj);
                mergedArray.append(apmObj);
            }
        }
    }
    qDebug()<<"合并后的更新信息:"<<mergedArray;
    return mergedArray;
 }
 bool aptssUpdater::isPackageInstalledInAptss(const QString &packageName)
 {
    QProcess process;
    QString command = QString("dpkg -s '%1' 2>/dev/null | grep -q 'Status: install ok installed'").arg(packageName);
    process.start("bash", QStringList() << "-c" << command);
    if (!process.waitForFinished(5000)) {
        process.kill();
        return false;
    }
    return process.exitCode() == 0;
 }
 bool aptssUpdater::isPackageInstalledInApm(const QString &packageName)
 {
    QProcess process;
    process.start("apm", QStringList() << "list" << "--installed");
    if (!process.waitForFinished(30000)) {
        process.kill();
        return false;
    }
    QString output = process.readAllStandardOutput();
    // 解析格式: pkgname/repo,section version arch [flags]
    // 或: pkgname/repo version arch [flags]
    QRegularExpression regex(QString("^%1/\\S+(?:,\\S+)?\\s+\\S+\\s+\\S+\\s+\\[").arg(QRegularExpression::escape(packageName)));
    return regex.match(output).hasMatch();
 }
@@ -1,39 +0,0 @@
 #ifndef APTSSUPDATER_H
 #define APTSSUPDATER_H
 #include <QWidget>
 #include <QStringList>
 #include <QTemporaryFile>
 #include <QLocale>
 #include <QJsonObject>
 #include <QJsonArray>
 class aptssUpdater : public QWidget
 {
    Q_OBJECT
 public:
    explicit aptssUpdater(QWidget *parent = nullptr);
    QStringList getUpdateablePackages(); // 查询可更新包列表及更新内容
    QStringList getPackageSizes();       // 获取每个包的大小
    QStringList getDesktopAppNames();  // 获取桌面应用名称列表
    QStringList getPackageIcons();    // 获取包图标列表
    QJsonArray getUpdateInfoAsJson(); // 获取更新信息的 JSON 格式
    QString m_tempFilePath;
    // APM 相关方法
    QStringList getApmUpdateablePackages(); // 查询 APM 可更新包列表及更新内容
    QJsonArray getApmUpdateInfoAsJson(); // 获取 APM 更新信息的 JSON 格式
    QJsonArray mergeUpdateInfo(); // 合并 APTSS 和 APM 的更新信息
 signals:
 private:
    bool checkDesktopFiles(const QStringList &desktopFiles, QString &appName, const QString &lang, const QString &packageName);
    QStringList packageName;
    QStringList apmPackageName; // APM 包列表
    // 检查包安装状态的方法
    bool isPackageInstalledInAptss(const QString &packageName); // 检查包是否在 aptss 中已安装
    bool isPackageInstalledInApm(const QString &packageName);   // 检查包是否在 apm 中已安装
 };
 #endif // APTSSUPDATER_H
@@ -1,134 +0,0 @@
 #include "downloadmanager.h"
 #include <QFileInfo>
 #include <QDir>
 #include <QFile>
 #include <QRegularExpression>
 #include <QDebug>
 DownloadManager::DownloadManager(QObject *parent) : QObject(parent)
 {
    cleanupTempFiles();
 }
 DownloadManager::~DownloadManager()
 {
    // 终止并清理所有正在运行的下载进程
    for (auto it = m_processes.begin(); it != m_processes.end(); ) {
        QProcess *process = it.value();
        if (process->state() != QProcess::NotRunning) {
            process->kill(); // 立即终止进程
            process->waitForFinished(3000); // 最多等待3秒
        }
        process->deleteLater();
        it = m_processes.erase(it);
    }
 }
 void DownloadManager::startDownload(const QString &packageName, const QString &url, const QString &outputPath)
 {
    if (m_processes.contains(packageName)) {
        qWarning() << packageName << " is already downloading.";
        return;
    }
    QString metalinkUrl = url + ".metalink";
    QFileInfo fileInfo(outputPath);
    QStringList arguments = {
        "--enable-rpc=false",
        "--console-log-level=warn",
        "--async-dns=false",
        "--summary-interval=1",
        "--allow-overwrite=true",
        "--connect-timeout=30",
        "--max-tries=3",
        "--dir=" + fileInfo.absolutePath(),
        "--out=" + fileInfo.fileName(),
        metalinkUrl
    };
    QProcess *process = new QProcess(this);
    m_processes.insert(packageName, process);
    // 新增：准备日志文件
    QString logPath = QString("/tmp/%1_download.log").arg(packageName);
    QFile *logFile = new QFile(logPath, process);
    if (logFile->open(QIODevice::Append | QIODevice::Text)) {
        // 设置权限为777
        QFile::setPermissions(logPath, QFile::ReadOwner | QFile::WriteOwner | QFile::ExeOwner |
                                         QFile::ReadGroup | QFile::WriteGroup | QFile::ExeGroup |
                                         QFile::ReadOther | QFile::WriteOther | QFile::ExeOther);
        connect(process, &QProcess::readyReadStandardOutput, this, [this, packageName, process, logFile]() {
            while (process->canReadLine()) {
                QString line = QString::fromUtf8(process->readLine()).trimmed();
                // 写入日志
                logFile->write(line.toUtf8() + '\n');
                logFile->flush();
                QRegularExpression regex(R"(\((\d+)%\))");
                QRegularExpressionMatch match = regex.match(line);
                if (match.hasMatch()) {
                    int progress = match.captured(1).toInt();
                    emit downloadProgress(packageName, progress);
                }
            }
        });
        connect(process, &QProcess::readyReadStandardError, this, [process, logFile]() {
            QByteArray err = process->readAllStandardError();
            logFile->write(err);
            logFile->flush();
        });
    }
    connect(process, QOverload<int, QProcess::ExitStatus>::of(&QProcess::finished),
            this, [this, packageName, outputPath, logFile](int exitCode, QProcess::ExitStatus status) {
        bool success = (exitCode == 0 && status == QProcess::NormalExit);
        if (!success) {
            qWarning() << "Download failed for" << packageName << "exit code:" << exitCode;
        }
        removeAria2Files(outputPath); // 清理残留 .aria2
        emit downloadFinished(packageName, success);
        if (logFile) logFile->close();
        QProcess *proc = m_processes.take(packageName);
        if (proc) proc->deleteLater();
    });
    process->start("aria2c", arguments);
 }
 void DownloadManager::cancelDownload(const QString &packageName)
 {
    if (!m_processes.contains(packageName)) return;
    QProcess *process = m_processes.take(packageName);
    if (process) {
        process->kill(); // 立即终止
        process->waitForFinished(3000); // 最多等待3秒
        process->deleteLater();
    }
    emit downloadFinished(packageName, false); // 显式通知取消
 }
 void DownloadManager::removeAria2Files(const QString &filePath)
 {
    QString ariaFile = filePath + ".aria2";
    QFile::remove(ariaFile);
 }
 bool DownloadManager::isDownloading(const QString &packageName) const
 {
    return m_processes.contains(packageName);
 }
 void DownloadManager::cleanupTempFiles()
 {
    QDir tempDir(QDir::tempPath());
    QStringList leftovers = tempDir.entryList(QStringList() << "*.aria2", QDir::Files);
    for (const QString &f : leftovers) {
        tempDir.remove(f);
    }
 }
@@ -1,29 +0,0 @@
 #ifndef DOWNLOADMANAGER_H
 #define DOWNLOADMANAGER_H
 #include <QObject>
 #include <QMap>
 #include <QProcess>
 class DownloadManager : public QObject
 {
    Q_OBJECT
 public:
    explicit DownloadManager(QObject *parent = nullptr);
    ~DownloadManager();
    void startDownload(const QString &packageName, const QString &url, const QString &outputPath);
    void cancelDownload(const QString &packageName);
    bool isDownloading(const QString &packageName) const;
 signals:
    void downloadProgress(const QString &packageName, int progress);
    void downloadFinished(const QString &packageName, bool success);
 private:
    void cleanupTempFiles();
    void removeAria2Files(const QString &filePath);
    QMap<QString, QProcess*> m_processes;
 };
 #endif // DOWNLOADMANAGER_H
@@ -1,9 +0,0 @@
 <RCC>
    <qresource prefix="/">
        <file>../resources/down_arrow.svg</file>
        <file>../resources/default_icon.svg</file>
        <file>../resources/spark-update-tool.svg</file>
        <file>../resources/128*128/spark-update-tool.png</file>
        <file>../resources/default_icon.png</file>
    </qresource>
 </RCC>
@@ -1,119 +0,0 @@
 #include "ignoreconfig.h"
 #include <QStandardPaths>
 #include <QDir>
 #include <QFile>
 #include <QTextStream>
 #include <QDebug>
 IgnoreConfig::IgnoreConfig(QObject *parent)
    : QObject(parent)
 {
    QString configDir;
    QByteArray sudoUserHomeEnv = qgetenv("SUDO_USER_HOME");
    if (!sudoUserHomeEnv.isEmpty()) {
        configDir = QString::fromLocal8Bit(sudoUserHomeEnv) + "/.config";
    } else {
        configDir = QStandardPaths::writableLocation(QStandardPaths::ConfigLocation);
    }
    QDir dir(configDir);
    if (!dir.exists()) {
        dir.mkpath(".");
    }
    m_configFilePath = dir.filePath("spark-store/ignored_apps.conf");
    // 确保目录存在
    QFileInfo fileInfo(m_configFilePath);
    QDir configDirPath = fileInfo.dir();
    if (!configDirPath.exists()) {
        configDirPath.mkpath(".");
    }
    // 加载现有配置
    loadConfig();
    // 输出忽略列表到 qDebug
    printIgnoredApps();
 }
 void IgnoreConfig::addIgnoredApp(const QString &packageName, const QString &version)
 {
    m_ignoredApps.insert(qMakePair(packageName, version));
    saveConfig();
 }
 void IgnoreConfig::removeIgnoredApp(const QString &packageName, const QString &version)
 {
    m_ignoredApps.remove(qMakePair(packageName, version));
    saveConfig();
 }
 bool IgnoreConfig::isAppIgnored(const QString &packageName, const QString &version) const
 {
    return m_ignoredApps.contains(qMakePair(packageName, version));
 }
 QSet<QPair<QString, QString>> IgnoreConfig::getIgnoredApps() const
 {
    return m_ignoredApps;
 }
 void IgnoreConfig::printIgnoredApps() const
 {
    qDebug() << "=== 忽略的应用列表 ===";
    qDebug() << "配置文件路径:" << m_configFilePath;
    if (m_ignoredApps.isEmpty()) {
        qDebug() << "没有忽略的应用";
    } else {
        for (const auto &app : m_ignoredApps) {
            qDebug() << "忽略的应用:" << app.first << "版本:" << app.second;
        }
    }
    qDebug() << "====================";
 }
 bool IgnoreConfig::saveConfig()
 {
    QFile file(m_configFilePath);
    if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        qDebug() << "无法打开配置文件进行写入:" << m_configFilePath;
        return false;
    }
    QTextStream out(&file);
    for (const auto &app : m_ignoredApps) {
        out << app.first << "|" << app.second << "\n";
    }
    file.close();
    return true;
 }
 bool IgnoreConfig::loadConfig()
 {
    QFile file(m_configFilePath);
    if (!file.exists()) {
        // 配置文件不存在，这是正常的，返回true表示没有错误
        return true;
    }
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        qDebug() << "无法打开配置文件进行读取:" << m_configFilePath;
        return false;
    }
    m_ignoredApps.clear();
    QTextStream in(&file);
    while (!in.atEnd()) {
        QString line = in.readLine().trimmed();
        if (!line.isEmpty()) {
            QStringList parts = line.split('|');
            if (parts.size() == 2) {
                m_ignoredApps.insert(qMakePair(parts[0], parts[1]));
            }
        }
    }
    file.close();
    return true;
 }
@@ -1,42 +0,0 @@
 #ifndef IGNORECONFIG_H
 #define IGNORECONFIG_H
 #include <QObject>
 #include <QSet>
 #include <QString>
 #include <QPair>
 class IgnoreConfig : public QObject
 {
    Q_OBJECT
 public:
    explicit IgnoreConfig(QObject *parent = nullptr);
    // 添加忽略的应用（包名和版本号）
    void addIgnoredApp(const QString &packageName, const QString &version);
    // 移除忽略的应用
    void removeIgnoredApp(const QString &packageName, const QString &version);
    // 检查应用是否被忽略
    bool isAppIgnored(const QString &packageName, const QString &version) const;
    // 获取所有被忽略的应用
    QSet<QPair<QString, QString>> getIgnoredApps() const;
    // 输出所有被忽略的应用到 qDebug
    void printIgnoredApps() const;
    // 保存配置到文件
    bool saveConfig();
    // 从文件加载配置
    bool loadConfig();
 private:
    QSet<QPair<QString, QString>> m_ignoredApps;
    QString m_configFilePath;
 };
 #endif // IGNORECONFIG_H
@@ -1,88 +0,0 @@
 #include "mainwindow.h"
 #include <QApplication>
 #include <QProcess>
 #include <QMessageBox>
 #include <unistd.h>     // for geteuid
 #include <cstdlib>      // for getenv
 #include <QDebug>       // For debugging output
 bool isRoot() {
    return geteuid() == 0;
 }
 bool elevateToRoot() {
    QString program = QCoreApplication::applicationFilePath();
    qDebug() << "Current application path:" << program;
    QByteArray display = qgetenv("DISPLAY");
    QByteArray xauthority = qgetenv("XAUTHORITY");
    QByteArray home = qgetenv("HOME");  // 获取原始用户的 HOME 目境变量
    QStringList args;
    args << "env"
         << "DISPLAY=" + display
         << "XAUTHORITY=" + xauthority
         << "SUDO_USER_HOME=" + home  // 传递原始用户的 HOME 路径
         << program;
    QProcess process;
    process.setProgram("pkexec");
    process.setArguments(args);
    qDebug() << "Attempting to elevate using pkexec with arguments:" << args;
    process.start();
    if (!process.waitForStarted(5000)) {
        qDebug() << "Failed to start pkexec.";
        return false;
    }
    // 阻塞等待提权进程退出（比如主程序窗口关闭）
    if (!process.waitForFinished(-1)) {  // 等待直到新进程退出
        qDebug() << "pkexec process waitForFinished failed.";
        return false;
    }
    int exitCode = process.exitCode();
    QProcess::ExitStatus exitStatus = process.exitStatus();
    qDebug() << "pkexec exit code:" << exitCode;
    qDebug() << "pkexec exit status:" << exitStatus;
    qDebug() << "pkexec stderr:" << process.readAllStandardError();
    return (exitStatus == QProcess::NormalExit && exitCode == 0);
 }
 int main(int argc, char *argv[])
 {
    // 必须在 QGuiApplication 实例创建之前调用
    // QGuiApplication::setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy::PassThrough);
    QApplication a(argc, argv);
    a.setWindowIcon(QIcon(":/resources/128*128/spark-update-tool.png"));
    if (!isRoot()) {
        qDebug() << "Not running as root. Attempting to elevate...";
        if (!elevateToRoot()) {
            qDebug() << "Elevation failed or pkexec command was not executed successfully.";
            QMessageBox::critical(nullptr,
                                  "权限不足",
                                  "提权失败！\n\n您的系统可能不支持 `pkexec` 或 `polkit` 配置不正确，"
                                  "或者您取消了授权。\n\n请尝试使用 `sudo` 命令运行此程序："
                                  "\n\n在终端中输入：\n`sudo " + QCoreApplication::applicationName() + "`");
            return 0; // 提权失败，退出程序
        } else {
            // 如果 elevateToRoot 返回 true，说明 pkexec 命令本身执行成功
            // 但这并不意味着原始程序以 root 权限启动了
            // 因为 elevateToRoot 启动的是一个新的进程，当前进程应该退出
            // 否则会并行运行两个程序实例
            qDebug() << "pkexec command executed successfully (new process likely started). Exiting current process.";
            return 0; // 当前非root进程退出
        }
    } else {
        qDebug() << "Running as root.";
    }
    MainWindow w;
    w.show();
    return a.exec();
 }
@@ -1,488 +0,0 @@
 #include "mainwindow.h"
 #include "./ui_mainwindow.h"
 #include <QProcess>
 #include <QMessageBox>
 #include <QProgressDialog>
 #include <QtConcurrent> // 新增
 #include <QFutureWatcher> // 新增
 #include <QIcon>
 #include <qicon.h>
 #include <unistd.h>     // for geteuid
 MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
    , m_model(new AppListModel(this))
    , m_delegate(new AppDelegate(this))
    , m_ignoreConfig(new IgnoreConfig(this))
 {
    QIcon icon(":/resources/128*128/spark-update-tool.png");
    setWindowIcon(icon);
    QProgressDialog *progressDialog = new QProgressDialog("正在与服务器通信，获取更新信息中...", QString(), 0, 0, this);
    progressDialog->setWindowModality(Qt::ApplicationModal);
    progressDialog->setCancelButton(nullptr);
    progressDialog->setWindowTitle("请稍候");
    progressDialog->setMinimumDuration(0);
    progressDialog->setWindowFlags(progressDialog->windowFlags() & ~Qt::WindowCloseButtonHint); // 禁用关闭按钮
    progressDialog->show();
    //异步执行runAptssUpgrade
    QFutureWatcher<void> *watcher = new QFutureWatcher<void>(this);
    connect(watcher, &QFutureWatcher<void>::finished, this, [=]() {
        progressDialog->close();
        progressDialog->deleteLater();
        watcher->deleteLater();
        ui->setupUi(this);
        QIcon icon(":/resources/128*128/spark-update-tool.png");
        setWindowIcon(icon);
        // 创建 QListView 并设置父控件为 ui->appWidget
        listView = new QListView(ui->appWidget);
        listView->setModel(m_model);
        listView->setItemDelegate(m_delegate);
        // 新增：确保 delegate 拥有 model 指针
        m_delegate->setModel(m_model);
        // 设置 QListView 填充 ui->appWidget
        QVBoxLayout *layout = new QVBoxLayout(ui->appWidget);
        layout->addWidget(listView);
        layout->setContentsMargins(0, 0, 0, 0);
        connect(m_delegate, &AppDelegate::updateDisplay, this, [=](const QString &packageName) {
            for (int i = 0; i < m_model->rowCount(); ++i) {
                QModelIndex index = m_model->index(i);
                if (index.data(Qt::UserRole + 1).toString() == packageName) {
                    m_model->dataChanged(index, index); // 刷新该行
                    break;
                }
            }
        });
        // 连接应用委托的信号
    connect(m_delegate, &AppDelegate::ignoreApp, this, &MainWindow::onIgnoreApp);
    connect(m_delegate, &AppDelegate::unignoreApp, this, &MainWindow::onUnignoreApp);
        // 新增：点击“更新全部”按钮批量下载
        connect(ui->updatePushButton, &QPushButton::clicked, this, [=](){
            qDebug()<<"更新按钮被点击";
            if (m_delegate->getSelectedPackages().isEmpty()) {
                // 没有选中任何应用，更新全部
                m_delegate->startDownloadForAll();
            } else {
                // 有选中应用，更新选中
                m_delegate->startDownloadForSelected();
                m_delegate->clearSelection();
                updateButtonText();
            }
        });
        // 新增：监听选择变化
        connect(m_delegate, &AppDelegate::updateDisplay, this, &MainWindow::handleSelectionChanged);
        checkUpdates();
        // 新增：监听搜索框文本变化
        connect(ui->searchPlainTextEdit, &QPlainTextEdit::textChanged, this, [=]() {
            QString keyword = ui->searchPlainTextEdit->toPlainText();
            filterAppsByKeyword(keyword);
        });
        initStyle();
        // 确保搜索框内容为空，placeholder 能显示
        ui->searchPlainTextEdit->clear();
    });
    // 启动异步任务
    watcher->setFuture(QtConcurrent::run([this](){
        runAptssUpgrade();
    }));
    QScreen *screen = QGuiApplication::screenAt(QCursor::pos());
    if (!screen) screen = QGuiApplication::primaryScreen();
    QRect screenGeometry = screen->geometry();
    int x = screenGeometry.x() + (screenGeometry.width() - this->width()) / 2;
    int y = screenGeometry.y() + (screenGeometry.height() - this->height()) / 2;
    this->move(x, y);
 }
 //初始化控件样式
 void MainWindow::initStyle()
 {
    //设置窗口标题
    this->setWindowTitle("软件更新中心");
    //查询框样式
    ui->searchPlainTextEdit->setStyleSheet(R"(
        QPlainTextEdit {
            background-color: #FFFFFF;
            border: 1px solid #E5E7EB;
            border-radius: 4px;
            padding-top: 8px;
            padding-bottom: 8px;
            font-size: 9px;
            line-height: 1.4;
            color: #9CA3AF;
        }
        QPlainTextEdit[placeholderText]:empty {
            color: #9CA3AF;
        }
    )");
    ui->searchPlainTextEdit->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
    ui->searchPlainTextEdit->setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
    //筛选框样式
    ui->FilterComboBox->setStyleSheet(R"(
        QComboBox {
            background-color: #FFFFFF;
            border: 1px solid #E5E7EB;
            border-radius: 4px;
            color: #4B5563;
            padding: 4px 8px;
        }
        QComboBox::drop-down {
            border: none;
            width: 20px;
        }
        QComboBox::down-arrow {
            image: url(:/resources/down_arrow.svg);
            width: 12px;
            height: 16px;
        }
        QComboBox QAbstractItemView {
            background-color: #FFFFFF;
            border: 1px solid #E5E7EB;
            color: #4B5563;
            selection-background-color: #F3F4F6;
            selection-color: #111827;
        }
    )");
    //更新软件按钮样式
    ui->updatePushButton->setStyleSheet(R"(
        QPushButton {
            background-color: #2563EB;
            color: #FFFFFF;
            border: none;
            border-radius: 4px;
            font-size: 14px;
            padding: 6px 12px;
            text-align: center;
        }
        QPushButton:hover {
            background-color: #1D4ED8; /* 深一点的 hover 效果，可选 */
        }
        QPushButton:pressed {
            background-color: #1E40AF; /* 按下效果，可选 */
        }
        QPushButton:disabled {
            background-color: #A5B4FC;
            color: #F9FAFB;
        }
    )");
    //设置背景填充颜色
    ui->backgroundWidget->setStyleSheet(R"(
        QWidget {
            background-color: #FFFFFF;
            border-radius: 12px;
        }
    )");
    //设置主背景颜色
    this->setStyleSheet("background-color: #F8FAFC;");
    // 添加滚动条样式
    this->setStyleSheet(R"(
        QScrollBar:vertical {
            background: #F3F4F6;
            width: 8px;
            margin: 0px;
        }
        QScrollBar::handle:vertical {
            background: #D1D5DB;
            border-radius: 4px;
            min-height: 30px;
        }
        QScrollBar::handle:vertical:hover {
            background: #9CA3AF;
        }
        QScrollBar::add-line:vertical, QScrollBar::sub-line:vertical {
            background: none;
            height: 0px;
        }
        QScrollBar:horizontal {
            background: #F3F4F6;
            height: 8px;
            margin: 0px;
        }
        QScrollBar::handle:horizontal {
            background: #D1D5DB;
            border-radius: 4px;
            min-width: 30px;
        }
        QScrollBar::handle:horizontal:hover {
            background: #9CA3AF;
        }
    )");
 }
 void MainWindow::checkUpdates()
 {
    aptssUpdater updater;
    QJsonArray updateInfo = updater.mergeUpdateInfo();
    // 分离正常应用和忽略应用
    QJsonArray normalApps;
    QJsonArray ignoredApps;
    for (const auto &item : updateInfo) {
        QJsonObject obj = item.toObject();
        QString packageName = obj["package"].toString();
        QString newVersion = obj["new_version"].toString();
        // 检查应用是否被忽略
        if (m_ignoreConfig->isAppIgnored(packageName, newVersion)) {
            // 标记为忽略状态
            obj["ignored"] = true;
            ignoredApps.append(obj);
        } else {
            obj["ignored"] = false;
            normalApps.append(obj);
        }
    }
    // 合并数组：正常应用在前，忽略应用在后
    QJsonArray finalApps;
    for (const auto &item : normalApps) {
        finalApps.append(item);
    }
    for (const auto &item : ignoredApps) {
        finalApps.append(item);
    }
    m_allApps = finalApps; // 保存所有应用数据
    m_model->setUpdateData(finalApps);
    for (const auto &item : finalApps) {
        QJsonObject obj = item.toObject();
        qDebug() << "模型设置的包名:" << obj["package"].toString() << "忽略状态:" << obj["ignored"].toBool() << "来源:" << obj["source"].toString();
        qDebug() << "模型设置的下载 URL:" << obj["download_url"].toString(); // 检查模型数据
    }
 }
 // 新增：根据关键字过滤应用
 void MainWindow::filterAppsByKeyword(const QString &keyword)
 {
    if (keyword.trimmed().isEmpty()) {
        m_model->setUpdateData(m_allApps);
        return;
    }
    // 分离正常应用和忽略应用
    QJsonArray normalApps;
    QJsonArray ignoredApps;
    for (const auto &item : m_allApps) {
        QJsonObject obj = item.toObject();
        // 可根据需要匹配更多字段
        QString name = obj.value("name").toString();
        QString package = obj.value("package").toString();
        if (name.contains(keyword, Qt::CaseInsensitive) ||
            package.contains(keyword, Qt::CaseInsensitive)) {
            // 检查是否为忽略状态
            if (obj.value("ignored").toBool()) {
                ignoredApps.append(item);
            } else {
                normalApps.append(item);
            }
        }
    }
    // 合并数组：正常应用在前，忽略应用在后
    QJsonArray filtered;
    for (const auto &item : normalApps) {
        filtered.append(item);
    }
    for (const auto &item : ignoredApps) {
        filtered.append(item);
    }
    m_model->setUpdateData(filtered);
 }
 void MainWindow::runAptssUpgrade()
 {
    // 检查aptss命令是否存在
    QProcess checkProcess;
    checkProcess.start("which", QStringList() << "aptss");
    if (checkProcess.waitForFinished(5000) && checkProcess.exitCode() == 0) {
        // aptss存在，执行aptss ssupdate
        QProcess process;
        // 检查是否已经是root用户，如果是则直接执行命令，否则使用sudo
        if (geteuid() == 0) {
            // root用户直接执行
            process.start("aptss", QStringList() << "ssupdate");
        } else {
            // 非root用户使用sudo
            process.start("sudo", QStringList() << "aptss" << "ssupdate");
        }
        if (!process.waitForStarted(5000)) {
            qDebug() << "无法启动 aptss ssupdate";
            return;
        }
        process.write("n\n");
        process.closeWriteChannel();
        // 设置超时时间，避免无限等待
        if (!process.waitForFinished(30000)) { // 30秒超时
            qDebug() << "aptss ssupdate 执行超时";
            process.kill(); // 强制终止进程
            return;
        }
        if (process.exitCode() != 0) {
            qDebug() << "执行 aptss ssupdate 失败，请检查系统环境或稍后再试。";
        }
    } else {
        qDebug() << "aptss命令不存在，跳过aptss ssupdate";
    }
    // 检查apm命令是否存在，如果存在则执行apm update
    QProcess checkApmProcess;
    checkApmProcess.start("which", QStringList() << "apm");
    if (checkApmProcess.waitForFinished(5000) && checkApmProcess.exitCode() == 0) {
        qDebug() << "apm命令存在，执行apm update";
        QProcess apmProcess;
        // 检查是否已经是root用户，如果是则直接执行命令，否则使用sudo
        if (geteuid() == 0) {
            // root用户直接执行
            apmProcess.start("apm", QStringList() << "update");
        } else {
            // 非root用户使用sudo
            apmProcess.start("sudo", QStringList() << "apm" << "update");
        }
        if (!apmProcess.waitForStarted(5000)) {
            qDebug() << "无法启动 apm update";
            return;
        }
        // 设置超时时间，避免无限等待
        if (!apmProcess.waitForFinished(30000)) { // 30秒超时
            qDebug() << "apm update 执行超时";
            apmProcess.kill(); // 强制终止进程
            return;
        }
        if (apmProcess.exitCode() != 0) {
            qDebug() << "执行 apm update 失败";
        }
    } else {
        qDebug() << "apm命令不存在，跳过apm update";
    }
 }
 void MainWindow::closeEvent(QCloseEvent *event)
 {
    // 检查是否正在进行更新
    bool isUpdating = false;
    // 通过AppDelegate检查是否有正在下载或安装的应用
    const QHash<QString, DownloadInfo>& downloads = m_delegate->getDownloads();
    for (auto it = downloads.constBegin(); it != downloads.constEnd(); ++it) {
        if (it.value().isDownloading || it.value().isInstalling) {
            isUpdating = true;
            break;
        }
    }
    // 如果正在更新，才显示确认对话框
    if (isUpdating) {
        QMessageBox::StandardButton reply = QMessageBox::question(this, "确认关闭", "正在更新，是否确认关闭窗口？", QMessageBox::Yes | QMessageBox::No);
        if (reply == QMessageBox::Yes) {
            event->accept();
        } else {
            event->ignore();
        }
    } else {
        // 如果没有更新，直接关闭窗口
        event->accept();
    }
 }
 void MainWindow::handleUpdateFinished(bool success)
 {
    if (success) {
        // 更新成功时的处理逻辑
        QMessageBox::information(this, "更新完成", "软件更新已成功完成！");
    } else {
        // 更新失败时的处理逻辑
        QMessageBox::warning(this, "更新失败", "软件更新过程中出现错误，请稍后再试。");
    }
    // 刷新应用列表
    checkUpdates();
 }
 MainWindow::~MainWindow()
 {
    delete ui;
 }
 // 新增：更新按钮文本
 void MainWindow::updateButtonText() {
    int selectedCount = m_delegate->getSelectedPackages().size();
    if (selectedCount > 0) {
        ui->updatePushButton->setText(QString("更新选中(%1)").arg(selectedCount));
    } else {
        ui->updatePushButton->setText("更新全部");
    }
 }
 // 新增：处理选择变化
 void MainWindow::handleSelectionChanged() {
    updateButtonText();
 }
 // 新增：处理忽略应用的槽函数
 void MainWindow::onIgnoreApp(const QString &packageName, const QString &version) {
    // 将应用添加到忽略配置中
    m_ignoreConfig->addIgnoredApp(packageName, version);
    // 更新模型中应用的状态，而不是移除
    QJsonArray updatedApps;
    for (const auto &item : m_allApps) {
        QJsonObject obj = item.toObject();
        if (obj["package"].toString() == packageName) {
            obj["ignored"] = true; // 标记为忽略状态
        }
        updatedApps.append(obj);
    }
    m_allApps = updatedApps;
    // 重新排序：正常应用在前，忽略应用在后
    checkUpdates();
 }
 // 新增：处理取消忽略应用的槽函数
 void MainWindow::onUnignoreApp(const QString &packageName, const QString &version) {
    // 从忽略配置中移除应用
    m_ignoreConfig->removeIgnoredApp(packageName, version);
    // 更新模型中应用的状态
    QJsonArray updatedApps;
    for (const auto &item : m_allApps) {
        QJsonObject obj = item.toObject();
        if (obj["package"].toString() == packageName) {
            obj["ignored"] = false; // 标记为非忽略状态
        }
        updatedApps.append(obj);
    }
    m_allApps = updatedApps;
    // 重新排序：正常应用在前，忽略应用在后
    checkUpdates();
 }
@@ -1,48 +0,0 @@
 #ifndef MAINWINDOW_H
 #define MAINWINDOW_H
 #include <QMainWindow>
 #include "aptssupdater.h"
 #include "applistmodel.h"
 #include "appdelegate.h"
 #include "ignoreconfig.h"
 #include <QListView>
 #include <QJsonArray> // 添加头文件
 #include <QScreen>
 QT_BEGIN_NAMESPACE
 namespace Ui {
 class MainWindow;
 }
 QT_END_NAMESPACE
 class MainWindow : public QMainWindow
 {
    Q_OBJECT
 public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
 protected:
    void closeEvent(QCloseEvent *event) override;  
 private:
    Ui::MainWindow *ui;
    void checkUpdates();
    void initStyle();
    void runAptssUpgrade();
    AppListModel *m_model;
    AppDelegate *m_delegate;
    IgnoreConfig *m_ignoreConfig; // 新增：忽略配置管理
    QListView *listView; // 声明 QListView 指针
    QJsonArray m_allApps; // 新增：保存所有应用数据
    void filterAppsByKeyword(const QString &keyword); // 新增：搜索过滤函数声明
    void updateButtonText(); // 新增：更新按钮文本
 private slots:
    void handleUpdateFinished(bool success); // 新增：处理更新完成的槽函数
    void handleSelectionChanged(); // 新增：处理选择变化的槽函数
    void onIgnoreApp(const QString &packageName, const QString &version); // 新增：处理忽略应用的槽函数
    void onUnignoreApp(const QString &packageName, const QString &version); // 新增：处理取消忽略应用
 };
 #endif // MAINWINDOW_H
@@ -1,256 +0,0 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <ui version="4.0">
 <class>MainWindow</class>
 <widget class="QMainWindow" name="MainWindow">
  <property name="geometry">
   <rect>
    <x>0</x>
    <y>0</y>
    <width>800</width>
    <height>600</height>
   </rect>
  </property>
  <property name="windowTitle">
   <string>MainWindow</string>
  </property>
  <widget class="QWidget" name="centralwidget">
   <layout class="QGridLayout" name="gridLayout">
    <item row="0" column="0">
     <widget class="QWidget" name="titleWidget" native="true">
      <layout class="QHBoxLayout" name="horizontalLayout">
       <property name="spacing">
        <number>0</number>
       </property>
       <property name="leftMargin">
        <number>0</number>
       </property>
       <property name="topMargin">
        <number>0</number>
       </property>
       <property name="rightMargin">
        <number>0</number>
       </property>
       <property name="bottomMargin">
        <number>0</number>
       </property>
       <item>
        <widget class="QLabel" name="label">
         <property name="font">
          <font>
           <family>Noto Sans Vai</family>
           <pointsize>22</pointsize>
          </font>
         </property>
         <property name="text">
          <string>软件更新中心</string>
         </property>
        </widget>
       </item>
       <item>
        <spacer name="horizontalSpacer">
         <property name="orientation">
          <enum>Qt::Orientation::Horizontal</enum>
         </property>
         <property name="sizeHint" stdset="0">
          <size>
           <width>1245</width>
           <height>20</height>
          </size>
         </property>
        </spacer>
       </item>
      </layout>
     </widget>
    </item>
    <item row="1" column="0">
     <widget class="QWidget" name="backgroundWidget" native="true">
      <layout class="QVBoxLayout" name="verticalLayout">
       <item>
        <widget class="QWidget" name="widget_4" native="true">
         <property name="sizePolicy">
          <sizepolicy hsizetype="Preferred" vsizetype="Fixed">
           <horstretch>0</horstretch>
           <verstretch>0</verstretch>
          </sizepolicy>
         </property>
         <layout class="QHBoxLayout" name="horizontalLayout_2">
          <property name="spacing">
           <number>0</number>
          </property>
          <property name="leftMargin">
           <number>0</number>
          </property>
          <property name="topMargin">
           <number>0</number>
          </property>
          <property name="rightMargin">
           <number>0</number>
          </property>
          <property name="bottomMargin">
           <number>0</number>
          </property>
          <item>
           <widget class="QWidget" name="widget_3" native="true">
            <property name="minimumSize">
             <size>
              <width>320</width>
              <height>38</height>
             </size>
            </property>
            <property name="maximumSize">
             <size>
              <width>320</width>
              <height>38</height>
             </size>
            </property>
            <layout class="QHBoxLayout" name="horizontalLayout_3">
             <property name="spacing">
              <number>0</number>
             </property>
             <property name="leftMargin">
              <number>0</number>
             </property>
             <property name="topMargin">
              <number>0</number>
             </property>
             <property name="rightMargin">
              <number>0</number>
             </property>
             <property name="bottomMargin">
              <number>0</number>
             </property>
             <item>
              <widget class="QPlainTextEdit" name="searchPlainTextEdit">
               <property name="minimumSize">
                <size>
                 <width>200</width>
                 <height>38</height>
                </size>
               </property>
               <property name="plainText">
                <string/>
               </property>
               <property name="tabStopDistance">
                <double>81.000000000000000</double>
               </property>
               <property name="placeholderText">
                <string>搜索软件...</string>
               </property>
              </widget>
             </item>
            </layout>
           </widget>
          </item>
          <item>
           <spacer name="horizontalSpacer_2">
            <property name="orientation">
             <enum>Qt::Orientation::Horizontal</enum>
            </property>
            <property name="sizeHint" stdset="0">
             <size>
              <width>40</width>
              <height>20</height>
             </size>
            </property>
           </spacer>
          </item>
          <item>
           <widget class="QWidget" name="widget" native="true">
            <property name="minimumSize">
             <size>
              <width>214</width>
              <height>40</height>
             </size>
            </property>
            <property name="maximumSize">
             <size>
              <width>214</width>
              <height>40</height>
             </size>
            </property>
            <widget class="QComboBox" name="FilterComboBox">
             <property name="geometry">
              <rect>
               <x>0</x>
               <y>0</y>
               <width>102</width>
               <height>38</height>
              </rect>
             </property>
             <property name="minimumSize">
              <size>
               <width>102</width>
               <height>38</height>
              </size>
             </property>
             <property name="maximumSize">
              <size>
               <width>102</width>
               <height>38</height>
              </size>
             </property>
             <property name="font">
              <font/>
             </property>
             <property name="layoutDirection">
              <enum>Qt::LayoutDirection::LeftToRight</enum>
             </property>
             <property name="sizeAdjustPolicy">
              <enum>QComboBox::SizeAdjustPolicy::AdjustToContentsOnFirstShow</enum>
             </property>
             <item>
              <property name="text">
               <string>按名称</string>
              </property>
             </item>
            </widget>
            <widget class="QPushButton" name="updatePushButton">
             <property name="geometry">
              <rect>
               <x>118</x>
               <y>0</y>
               <width>96</width>
               <height>40</height>
              </rect>
             </property>
             <property name="text">
              <string>更新全部</string>
             </property>
            </widget>
           </widget>
          </item>
         </layout>
        </widget>
       </item>
       <item>
        <widget class="QWidget" name="appWidget" native="true">
         <property name="enabled">
          <bool>true</bool>
         </property>
         <property name="sizePolicy">
          <sizepolicy hsizetype="Expanding" vsizetype="Expanding">
           <horstretch>0</horstretch>
           <verstretch>0</verstretch>
          </sizepolicy>
         </property>
        </widget>
       </item>
      </layout>
     </widget>
    </item>
   </layout>
  </widget>
  <widget class="QMenuBar" name="menubar">
   <property name="geometry">
    <rect>
     <x>0</x>
     <y>0</y>
     <width>1440</width>
     <height>23</height>
    </rect>
   </property>
  </widget>
 </widget>
 <resources/>
 <connections/>
 </ui>
@@ -20,11 +20,13 @@ Object.defineProperty(window, "ipcRenderer", {
    invoke: vi.fn(),
    removeListener: vi.fn(),
  },
  writable: true,
 });
 // Mock window.apm_store
 Object.defineProperty(window, "apm_store", {
  value: {
-    arch: "amd64-store",
+    arch: "amd64",
  },
  writable: true,
 });
--- a/Show More
+++ b/Show More
		`@@ -0,0 +1,2 @@`
							`1、将标题栏变宽一点，现在加入了搜索栏，太窄了不好看`
							`2、在贡献排行中，点击对应的贡献用户，可以查看用户下所有的应用（可能需要模糊查询）`
		`@@ -1 +0,0 @@`
			`deb [by-hash=force] https://d.store.deepinos.org.cn /`
		`@@ -1 +0,0 @@`
			<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1" width="12" height="16" viewBox="0 0 12 16"><defs><clipPath id="master_svg0_1_074"><rect x="0.75" y="2" width="10.5" height="12" rx="0"/></clipPath></defs><g><rect x="0" y="0" width="12" height="16" rx="0" fill="#000000" fill-opacity="0" style="mix-blend-mode:passthrough"/><g clip-path="url(#master_svg0_1_074)"><g transform="matrix(1,0,0,-1,0,24.015625)"><g><path d="M4.71094,12.2187505Q4.94531,12.0078125,5.25,12.0078125Q5.55469,12.0078125,5.78906,12.2187505L10.2891,16.7187525Q10.5,16.9531225,10.5,17.2578125Q10.5,17.5625025,10.2891,17.7968725Q10.0547,18.0078125,9.75,18.0078125Q9.44531,18.0078125,9.21094,17.7968725L5.25,13.8125025L1.28906,17.7968725Q1.05469,18.0078125,0.75,18.0078125Q0.445312,18.0078125,0.210938,17.7968725Q0,17.5625025,0,17.2578125Q0,16.9531225,0.210938,16.7187525L4.71094,12.2187505Z" fill="#4B5563" fill-opacity="1" style="mix-blend-mode:passthrough"/></g></g></g></g></svg>