!293 431

Merge pull request !293 from shenmo/dev

.agents/workflows/bug-fix.md

@@ -1,139 +0,0 @@
----
-description: Bug 修复流程
----
-
-## 工作流说明
-
-此工作流指导如何修复 Bug。
-
-## 步骤
-
-### 1. 复现 Bug
-
-- 根据 Issue 描述复现问题
-- 记录详细的复现步骤
-- 收集相关日志和错误信息
-- 确认环境信息
-
-### 2. 分析问题
-
-- 查看相关代码
-- 使用调试器定位问题
-- 检查日志输出
-- 识别根本原因
-
-### 3. 创建修复分支
-
-```bash
-git checkout -b fix/your-bug-fix
-```
-
-### 4. 编写回归测试
-
-先编写测试来复现 Bug：
-
-```typescript
-// src/__tests__/unit/bugFix.test.ts
-import { describe, it, expect } from "vitest";
-import { buggyFunction } from "@/modules/example";
-
-describe("buggyFunction", () => {
-  it("should not crash with null input", () => {
-    expect(() => buggyFunction(null)).not.toThrow();
-  });
-});
-```
-
-### 5. 修复代码
-
-- 最小化修改
-- 保持代码可读性
-- 添加必要的注释
-- 更新相关类型定义
-
-### 6. 运行测试
-
-```bash
-# 确保新测试通过
-npm run test
-
-# 运行所有测试
-npm run test:all
-
-# 代码检查
-npm run lint
-npm run format
-```
-
-### 7. 本地验证
-
-- 验证 Bug 已修复
-- 测试相关功能
-- 检查是否引入新问题
-- 测试边界情况
-
-### 8. 更新文档
-
-- 更新 CHANGELOG.md（如果需要）
-- 更新相关文档（如需要）
-
-### 9. 提交代码
-
-```bash
-git add .
-git commit -m "fix(scope): describe the bug fix" -s
-git push origin fix/your-bug-fix
-```
-
-### 10. 创建 Pull Request
-
-- 引用相关 Issue（`Fixes #123`）
-- 描述修复方法
-- 说明复现步骤
-- 添加测试说明
-
-### 11. 代码审查
-
-- 响应审查意见
-- 进行必要的修改
-- 确保所有 CI 检查通过
-
-### 12. 合并
-
-- 等待审查批准
-- Squash 合并到 main 分支
-- 删除修复分支
-
-## 注意事项
-
-- ⚠️ 修复前先理解问题根源
-- ⚠️ 最小化修改范围
-- ⚠️ 添加回归测试防止复发
-- ⚠️ 考虑向后兼容性
-- ⚠️ 测试所有受影响的功能
-
-## 常见 Bug 类型
-
-### IPC 通信问题
-
-- 检查事件名称是否匹配
-- 检查数据格式是否正确
-- 检查异步处理
-
-### 状态管理问题
-
-- 检查响应式依赖
-- 检查状态更新时机
-- 检查内存泄漏
-
-### 类型错误
-
-- 检查类型定义
-- 检查类型断言
-- 检查可选值处理
-
-## 相关文档
-
-- [CONTRIBUTING.md](../../CONTRIBUTING.md) - 贡献指南
-- [TESTING.md](../../TESTING.md) - 测试文档
-- [TROUBLESHOOTING.md](../../TROUBLESHOOTING.md) - 问题排查

.agents/workflows/build-package.md

@@ -1,47 +0,0 @@
----
-description: 为 Spark Store 构建DEB软件包
----
-
-本工作流将指导你如何构建适用于 Linux 的 Spark Store 软件包。
-
-### 1. 安装依赖
-
-确保你已经安装了所有的项目依赖。如果你还没有安装，可以使用 `/run-project` 工作流。
-
-// turbo
-```bash
-npm install
-```
-
-### 2. 构建生产版本
-
-你可以选择构建所有支持的格式，或者仅构建特定的格式（deb 或 rpm）。
-
-#### 构建所有格式 (deb, rpm, AppImage)
-
-// turbo
-```bash
-npm run build
-```
-
-#### 仅构建 deb 包
-
-// turbo
-```bash
-npm run build:deb
-```
-
-### 3. 查看构建产物
-
-构建完成后的安装包将存放在项目根目录下的 `release` 目录中。
-
-```bash
-ls -l release/$(node -p "require('./package.json').version")
-```
-
-### 4. 常见问题排查
-
-如果构建失败，请检查以下几点：
-- 确保 Node.js 版本符合要求 (>= 20.x)。
-- 确保系统已安装必要的编译工具。
-- 检查 `electron-builder.yml` 中的配置是否正确。

.agents/workflows/code-review.md

@@ -1,245 +0,0 @@
----
-description: 代码审查流程
----
-
-## 工作流说明
-
-此工作流指导如何进行代码审查。
-
-## 审查清单
-
-### 代码质量
-
-- [ ] 代码遵循项目规范
-- [ ] TypeScript 类型正确
-- [ ] 没有 `any` 类型（除非必要）
-- [ ] ESLint 和 Prettier 通过
-- [ ] 代码可读性良好
-
-### 功能实现
-
-- [ ] 实现符合需求
-- [ ] 边界情况处理
-- [ ] 错误处理完善
-- [ ] 没有引入新 Bug
-
-### 测试
-
-- [ ] 包含足够的测试
-- [ ] 测试覆盖率合理
-- [ ] 所有测试通过
-- [ ] E2E 测试（如需要）
-
-### 文档
-
-- [ ] 更新了相关文档
-- [ ] 代码注释充分
-- [ ] API 文档（如需要）
-- [ ] CHANGELOG.md（如需要）
-
-### 安全性
-
-- [ ] 没有安全漏洞
-- [ ] 输入验证完善
-- [ ] 权限检查正确
-- [ ] 敏感信息保护
-
-### 性能
-
-- [ ] 没有明显的性能问题
-- [ ] 内存使用合理
-- [ ] 没有不必要的渲染
-- [ ] 资源加载优化
-
-## 审查流程
-
-### 1. 理解变更
-
-- 阅读 PR 描述
-- 查看 Issue 链接
-- 理解变更目的
-- 检查变更范围
-
-### 2. 代码审查
-
-**主进程代码:**
-
-```bash
-# 检查类型安全
-npx tsc --noEmit
-
-# 检查代码质量
-npm run lint
-```
-
-**渲染进程代码:**
-
-- 组件结构
-- 状态管理
-- 事件处理
-- 样式实现
-
-### 3. 测试验证
-
-```bash
-# 运行单元测试
-npm run test
-
-# 运行 E2E 测试
-npm run test:e2e
-
-# 检查覆盖率
-npm run test:coverage
-```
-
-### 4. 提供反馈
-
-**正面反馈:**
-
-- 好的实现
-- 优秀的代码
-- 有价值的贡献
-
-**建设性反馈:**
-
-- 指出问题
-- 提出建议
-- 解释原因
-
-**反馈格式:**
-
-````markdown
-### 问题
-
-**位置:** `src/components/AppCard.vue:45`
-
-**描述:** 这里缺少错误处理，可能导致应用崩溃。
-
-**建议:**
-
-```typescript
-try {
-  await installPackage();
-} catch (error) {
-  console.error("Install failed:", error);
-  showError(error.message);
-}
-```
-````
-
-````
-
-### 5. 批准或要求修改
-
-**批准条件:**
-- 所有审查项目通过
-- 所有测试通过
-- CI 检查通过
-- 没有阻塞问题
-
-**要求修改:**
-- 指出必须修复的问题
-- 给出明确的修改建议
-- 等待作者响应
-
-## 审查原则
-
-### 及时性
-
-- 尽快响应 PR
-- 设定响应时间预期
-- 优先处理紧急 PR
-
-### 建设性
-
-- 提供具体的反馈
-- 给出改进建议
-- 解释审查理由
-
-### 尊重
-
-- 尊重作者的贡献
-- 使用礼貌的语言
-- 认可好的实现
-
-### 一致性
-
-- 遵循项目规范
-- 保持审查标准一致
-- 参考之前类似 PR
-
-## 常见问题
-
-### 类型安全问题
-
-**问题:** 使用了 `any` 类型
-
-**建议:**
-```typescript
-// ❌ 避免
-const data: any = response;
-
-// ✅ 推荐
-interface ResponseData {
-  id: string;
-  name: string;
-}
-const data: ResponseData = response;
-````
-
-### 代码重复
-
-**问题:** 代码重复
-
-**建议:**
-
-```typescript
-// 提取公共函数
-function formatSize(size: number): string {
-  return size > 1024 ? `${size / 1024} MB` : `${size} KB`;
-}
-```
-
-### 错误处理
-
-**问题:** 缺少错误处理
-
-**建议:**
-
-```typescript
-async function loadApps() {
-  try {
-    const response = await axios.get("/api/apps");
-    return response.data;
-  } catch (error) {
-    logger.error({ err: error }, "Failed to load apps");
-    throw error;
-  }
-}
-```
-
-## 审查后操作
-
-### 批准
-
-- 点击 "Approve review"
-- 添加评论（可选）
-- 等待合并
-
-### 要求修改
-
-- 选择 "Request changes"
-- 提供详细反馈
-- 等待作者更新
-
-### 评论
-
-- 选择 "Comment"
-- 提供建议或问题
-- 不阻止合并
-
-## 相关文档
-
-- [CONTRIBUTING.md](../../CONTRIBUTING.md) - 贡献指南
-- [DEVELOPMENT.md](../../DEVELOPMENT.md) - 开发文档
-- [AGENTS.md](../../AGENTS.md) - AI 编码指南

.agents/workflows/documentation.md

@@ -1,264 +0,0 @@
----
-description: 文档更新流程
----
-
-## 工作流说明
-
-此工作流指导如何更新项目文档。
-
-## 步骤
-
-### 1. 确定需要更新的文档
-
-根据变更内容确定需要更新的文档：
-
-- README.md - 主要说明
-- DEVELOPMENT.md - 开发指南
-- CONTRIBUTING.md - 贡献指南
-- TESTING.md - 测试文档
-- DEPLOYMENT.md - 部署文档
-- TROUBLESHOOTING.md - 问题排查
-- FAQ.md - 常见问题
-- AGENTS.md - AI 编码指南
-- CHANGELOG.md - 变更日志
-
-### 2. 创建文档分支
-
-```bash
-git checkout -b docs/update-documentation
-```
-
-### 3. 更新文档
-
-#### README.md
-
-添加新功能说明：
-
-```markdown
-## 新功能
-
-### 应用更新
-
-现在支持一键更新所有可更新的应用。
-
-### 下载管理
-
-改进了下载队列管理，支持暂停和继续。
-```
-
-#### DEVELOPMENT.md
-
-添加开发指南：
-
-```markdown
-## 新功能开发
-
-### 添加新功能步骤
-
-1. 理解需求
-2. 设计方案
-3. 实现功能
-4. 编写测试
-5. 提交 PR
-```
-
-#### CONTRIBUTING.md
-
-更新贡献指南：
-
-```markdown
-### 新功能贡献
-
-- 遵循现有代码风格
-- 编写充分的测试
-- 更新相关文档
-```
-
-#### TESTING.md
-
-添加测试示例：
-
-```typescript
-describe("New Feature", () => {
-  it("should work correctly", () => {
-    // 测试代码
-  });
-});
-```
-
-#### CHANGELOG.md
-
-添加变更记录：
-
-```markdown
-## [4.10.0](https://github.com/elysia-best/apm-app-store/compare/v4.9.9...v4.10.0) (2026-03-10)
-
-### Features
-
-- feat(download): add pause and resume for downloads
-- feat(update): add batch update for apps
-
-### Bug Fixes
-
-- fix(ui): correct dark mode toggle persistence
-```
-
-### 4. 检查文档质量
-
-- [ ] 语法正确
-- [ ] 格式统一
-- [ ] 链接有效
-- [ ] 内容准确
-- [ ] 示例可运行
-
-### 5. 运行文档测试
-
-```bash
-# 如果有文档测试
-npm run test:docs
-
-# 检查链接
-npm run check-links
-```
-
-### 6. 本地预览
-
-使用 Markdown 预览工具查看效果。
-
-### 7. 提交文档
-
-```bash
-git add .
-git commit -m "docs: update documentation for new features" -s
-git push origin docs/update-documentation
-```
-
-### 8. 创建 Pull Request
-
-- 说明更新的内容
-- 提供预览截图（如需要）
-- 引用相关 Issue
-
-### 9. 代码审查
-
-- 响应审查意见
-- 确保文档质量
-- 合并到 main 分支
-
-## 文档编写规范
-
-### 格式规范
-
-- 使用 Markdown
-- 保持一致的标题层级
-- 使用代码块展示示例
-- 使用表格对比选项
-
-### 语言规范
-
-- 使用简洁清晰的语言
-- 避免技术术语（或解释）
-- 保持中英文术语一致
-- 使用被动语态
-
-### 示例规范
-
-```typescript
-// 好的示例
-import { ref } from "vue";
-
-const count = ref(0);
-
-function increment() {
-  count.value++;
-}
-```
-
-### 链接规范
-
-```markdown
-- 内部链接: [文档名](./document.md)
-- 外部链接: [Vue 文档](https://vuejs.org/)
-- 锚点链接: [章节](#section-name)
-```
-
-## 文档模板
-
-### 新功能文档
-
-````markdown
-## 功能名称
-
-### 描述
-
-简要描述功能
-
-### 使用方法
-
-```typescript
-// 示例代码
-```
-````
-
-### 配置选项
-
-| 选项   | 类型   | 默认值    | 说明     |
-| ------ | ------ | --------- | -------- |
-| option | string | 'default' | 选项说明 |
-
-### 注意事项
-
-- 注意事项 1
-- 注意事项 2
-
-````
-
-### API 文档
-
-```markdown
-## API 函数名
-
-### 签名
-```typescript
-function functionName(param1: Type1, param2: Type2): ReturnType
-````
-
-### 参数
-
-| 参数   | 类型  | 必填 | 说明     |
-| ------ | ----- | ---- | -------- |
-| param1 | Type1 | 是   | 参数说明 |
-| param2 | Type2 | 否   | 参数说明 |
-
-### 返回值
-
-| 类型       | 说明       |
-| ---------- | ---------- |
-| ReturnType | 返回值说明 |
-
-### 示例
-
-```typescript
-const result = functionName(arg1, arg2);
-```
-
-### 错误
-
-抛出 `Error` 异常的情况说明。
-
-```
-
-## 注意事项
-
-- ⚠️ 保持文档与代码同步
-- ⚠️ 更新示例代码
-- ⚠️ 检查链接有效性
-- ⚠️ 使用统一的格式
-- ⚠️ 提供清晰的说明
-
-## 相关文档
-
-- [CONTRIBUTING.md](../../CONTRIBUTING.md) - 贡献指南
-- [DEVELOPMENT.md](../../DEVELOPMENT.md) - 开发文档
-- [AGENTS.md](../../AGENTS.md) - AI 编码指南
-```

.agents/workflows/feature-development.md

@@ -1,135 +0,0 @@
----
-description: 新功能开发流程
----
-
-## 工作流说明
-
-此工作流指导如何开发新功能。
-
-## 步骤
-
-### 1. 理解需求
-
-- 阅读 Issue 描述
-- 确认功能范围
-- 识别依赖关系
-- 设计 API 和数据结构
-
-### 2. 设计方案
-
-- 设计 UI/UX（如需要）
-- 设计数据流
-- 确定 IPC 通信（如需要）
-- 编写技术方案文档（可选）
-
-### 3. 创建功能分支
-
-```bash
-git checkout -b feature/your-feature-name
-```
-
-### 4. 更新类型定义
-
-在 `src/global/typedefinition.ts` 中添加新的类型定义：
-
-```typescript
-export interface NewFeatureData {
-  id: string;
-  name: string;
-  // ...其他字段
-}
-```
-
-### 5. 编写测试
-
-先编写测试，遵循 TDD 原则：
-
-```typescript
-// src/__tests__/unit/newFeature.test.ts
-import { describe, it, expect } from "vitest";
-import { newFunction } from "@/modules/newFeature";
-
-describe("newFunction", () => {
-  it("should work correctly", () => {
-    const result = newFunction(input);
-    expect(result).toBe(expected);
-  });
-});
-```
-
-### 6. 实现功能
-
-按照以下顺序实现：
-
-- 后端逻辑（Electron 主进程）
-- 前端逻辑（Vue 组件）
-- IPC 通信（如需要）
-- 样式和布局
-
-### 7. 运行测试
-
-```bash
-# 单元测试
-npm run test
-
-# E2E 测试
-npm run test:e2e
-
-# 代码检查
-npm run lint
-npm run format
-```
-
-### 8. 本地测试
-
-- 测试所有功能场景
-- 测试边界情况
-- 测试错误处理
-- 检查性能影响
-
-### 9. 更新文档
-
-- 更新 API 文档（如需要）
-- 更新用户文档（如需要）
-- 更新 CHANGELOG.md
-
-### 10. 提交代码
-
-```bash
-git add .
-git commit -m "feat(scope): add new feature" -s
-git push origin feature/your-feature-name
-```
-
-### 11. 创建 Pull Request
-
-- 使用 PR 模板
-- 引用相关 Issue
-- 添加测试说明
-- 添加截图/录屏（UI 变更）
-
-### 12. 代码审查
-
-- 响应审查意见
-- 进行必要的修改
-- 确保所有 CI 检查通过
-
-### 13. 合并
-
-- 等待审查批准
-- Squash 合并到 main 分支
-- 删除功能分支
-
-## 注意事项
-
-- ⚠️ 保持 PR 小而聚焦（建议 < 500 行）
-- ⚠️ 确保 TypeScript 严格模式通过
-- ⚠️ 不引入 `any` 类型（必要时使用 `eslint-disable`）
-- ⚠️ 所有新功能必须有测试
-- ⚠️ 遵循代码规范
-
-## 相关文档
-
-- [CONTRIBUTING.md](../../CONTRIBUTING.md) - 贡献指南
-- [DEVELOPMENT.md](../../DEVELOPMENT.md) - 开发文档
-- [TESTING.md](../../TESTING.md) - 测试文档

.agents/workflows/performance-optimization.md

@@ -1,333 +0,0 @@
----
-description: 性能优化流程
----
-
-## 工作流说明
-
-此工作流指导如何优化应用性能。
-
-## 步骤
-
-### 1. 识别性能问题
-
-使用工具分析性能：
-
-- Chrome DevTools Performance
-- Vue DevTools
-- Vite Build Analysis
-- 内存分析工具
-
-### 2. 分析瓶颈
-
-确定性能瓶颈：
-
-- 渲染性能
-- 网络请求
-- 内存使用
-- CPU 使用
-- 磁盘 I/O
-
-### 3. 创建优化分支
-
-```bash
-git checkout -b perf/optimize-performance
-```
-
-### 4. 添加性能测试
-
-```typescript
-// src/__tests__/perf/performance.test.ts
-import { describe, it, expect } from "vitest";
-import { heavyFunction } from "@/modules/example";
-
-describe("heavyFunction", () => {
-  it("should complete within 100ms", () => {
-    const start = performance.now();
-    heavyFunction();
-    const duration = performance.now() - start;
-    expect(duration).toBeLessThan(100);
-  });
-});
-```
-
-### 5. 实施优化
-
-#### 渲染性能优化
-
-```typescript
-// 使用 computed 缓存计算结果
-const filteredApps = computed(() => {
-  return apps.value.filter(app => app.category === selectedCategory);
-});
-
-// 使用 v-memo 优化列表渲染
-<template>
-  <div v-for="app in apps" :key="app.pkgname" v-memo="[app.id]">
-    {{ app.name }}
-  </div>
-</template>
-
-// 防抖和节流
-import { debounce } from 'lodash-es';
-
-const debouncedSearch = debounce((query: string) => {
-  searchApps(query);
-}, 300);
-```
-
-#### 网络请求优化
-
-```typescript
-// 使用缓存
-const appCache = new Map<string, App[]>();
-
-async function fetchApps(category: string): Promise<App[]> {
-  if (appCache.has(category)) {
-    return appCache.get(category)!;
-  }
-
-  const apps = await axios.get(`/api/apps/${category}`);
-  appCache.set(category, apps.data);
-  return apps.data;
-}
-
-// 并发请求
-const [apps1, apps2] = await Promise.all([
-  fetchApps("category1"),
-  fetchApps("category2"),
-]);
-```
-
-#### 内存优化
-
-```typescript
-// 及时清理事件监听
-onMounted(() => {
-  window.addEventListener("resize", handleResize);
-});
-
-onUnmounted(() => {
-  window.removeEventListener("resize", handleResize);
-});
-
-// 避免内存泄漏
-let timer: number;
-
-function startTimer() {
-  clearInterval(timer);
-  timer = setInterval(() => {
-    // 定时任务
-  }, 1000);
-}
-
-onUnmounted(() => {
-  clearInterval(timer);
-});
-```
-
-#### 代码分割
-
-```typescript
-// 动态导入组件
-const AppDetailModal = defineAsyncComponent(
-  () => import("@/components/AppDetailModal.vue"),
-);
-
-// 路由懒加载
-const routes = [
-  {
-    path: "/app/:id",
-    component: () => import("@/views/AppDetail.vue"),
-  },
-];
-```
-
-### 6. 测试性能
-
-```bash
-# 运行性能测试
-npm run test:perf
-
-# 使用 DevTools 分析
-# 1. 打开 DevTools
-# 2. 切换到 Performance 标签
-# 3. 点击 Record
-# 4. 执行操作
-# 5. 停止录制并分析
-```
-
-### 7. 对比优化效果
-
-记录优化前后的数据：
-
-- 渲染时间
-- 内存使用
-- 网络请求数
-- 应用启动时间
-
-### 8. 验证功能
-
-```bash
-# 确保功能正常
-npm run test
-
-# 手动测试主要流程
-```
-
-### 9. 代码审查
-
-检查优化是否：
-
-- 提升了性能
-- 没有破坏功能
-- 代码可读
-- 易于维护
-
-### 10. 更新文档
-
-- 记录优化内容
-- 更新性能指标
-- 添加优化说明
-
-### 11. 提交代码
-
-```bash
-git add .
-git commit -m "perf(scope): optimize performance" -s
-git push origin perf/optimize-performance
-```
-
-### 12. 创建 Pull Request
-
-- 说明优化内容
-- 提供性能对比
-- 展示优化效果
-
-## 性能优化清单
-
-### 渲染性能
-
-- [ ] 使用 computed 缓存
-- [ ] 使用 v-memo 优化
-- [ ] 避免不必要的重新渲染
-- [ ] 使用虚拟滚动（大数据集）
-- [ ] 图片懒加载
-
-### 网络性能
-
-- [ ] 减少请求数量
-- [ ] 使用缓存
-- [ ] 压缩资源
-- [ ] 使用 CDN
-- [ ] 并发请求
-
-### 内存性能
-
-- [ ] 清理事件监听
-- [ ] 避免内存泄漏
-- [ ] 释放不再使用的资源
-- [ ] 使用对象池（如需要）
-- [ ] 优化数据结构
-
-### 构建性能
-
-- [ ] 代码分割
-- [ ] Tree shaking
-- [ ] 压缩代码
-- [ ] 优化依赖
-- [ ] 使用缓存
-
-## 性能监控
-
-### 关键指标
-
-- **FCP (First Contentful Paint):** < 1.5s
-- **LCP (Largest Contentful Paint):** < 2.5s
-- **TTI (Time to Interactive):** < 3.5s
-- **CLS (Cumulative Layout Shift):** < 0.1
-- **FID (First Input Delay):** < 100ms
-
-### 监控工具
-
-```typescript
-// 使用 Performance API
-const perfData = performance.getEntriesByType("navigation")[0];
-console.log("Page Load Time:", perfData.loadEventEnd - perfData.fetchStart);
-
-// 使用 Vue DevTools
-// 监控组件渲染时间
-```
-
-## 常见性能问题
-
-### 1. 大列表渲染
-
-**问题:** 渲染大量数据导致卡顿
-
-**解决方案:**
-
-```vue
-<template>
-  <RecycleScroller :items="largeList" :item-size="50" key-field="id">
-    <template #default="{ item }">
-      <div>{{ item.name }}</div>
-    </template>
-  </RecycleScroller>
-</template>
-```
-
-### 2. 频繁的 DOM 更新
-
-**问题:** 频繁更新 DOM 导致性能下降
-
-**解决方案:**
-
-```typescript
-// 使用 requestAnimationFrame
-function animate() {
-  updatePosition();
-  requestAnimationFrame(animate);
-}
-```
-
-### 3. 内存泄漏
-
-**问题:** 内存持续增长
-
-**解决方案:**
-
-```typescript
-// 及时清理
-onUnmounted(() => {
-  clearInterval(timer);
-  removeEventListener("resize", handleResize);
-  clearTimeout(timeout);
-});
-```
-
-### 4. 不必要的计算
-
-**问题:** 重复计算相同结果
-
-**解决方案:**
-
-```typescript
-// 使用 computed
-const expensiveValue = computed(() => {
-  return heavyCalculation(data.value);
-});
-```
-
-## 注意事项
-
-- ⚠️ 不要过早优化
-- ⚠️ 先测量再优化
-- ⚠️ 保持代码可读
-- ⚠️ 避免过度优化
-- ⚠️ 持续监控性能
-
-## 相关文档
-
-- [DEVELOPMENT.md](../../DEVELOPMENT.md) - 开发文档
-- [TESTING.md](../../TESTING.md) - 测试文档
-- [TROUBLESHOOTING.md](../../TROUBLESHOOTING.md) - 问题排查

.agents/workflows/refactoring.md

@@ -1,284 +0,0 @@
----
-description: 代码重构流程
----
-
-## 工作流说明
-
-此工作流指导如何安全地重构代码。
-
-## 步骤
-
-### 1. 识别重构需求
-
-分析代码中的问题：
-
-- 代码重复
-- 复杂度过高
-- 性能问题
-- 可读性差
-- 难以维护
-
-### 2. 制定重构计划
-
-- 确定重构范围
-- 列出具体改进点
-- 评估影响范围
-- 制定测试策略
-
-### 3. 创建重构分支
-
-```bash
-git checkout -b refactor/your-refactor
-```
-
-### 4. 编写测试
-
-如果代码缺少测试，先添加测试：
-
-```typescript
-// src/__tests__/unit/refactorTarget.test.ts
-import { describe, it, expect } from "vitest";
-import { functionToRefactor } from "@/modules/example";
-
-describe("functionToRefactor", () => {
-  it("should maintain existing behavior", () => {
-    const result = functionToRefactor(input);
-    expect(result).toBe(expected);
-  });
-});
-```
-
-### 5. 逐步重构
-
-**原则:**
-
-- 小步迭代
-- 保持测试通过
-- 不改变外部行为
-
-**示例:**
-
-```typescript
-// 重构前
-function processApp(app: any) {
-  if (app) {
-    return {
-      name: app.name,
-      pkgname: app.pkgname,
-      version: app.version,
-    };
-  }
-  return null;
-}
-
-// 重构后 - 添加类型
-interface App {
-  name: string;
-  pkgname: string;
-  version: string;
-}
-
-function processApp(app: App | null): App | null {
-  if (!app) return null;
-
-  return {
-    name: app.name,
-    pkgname: app.pkgname,
-    version: app.version,
-  };
-}
-```
-
-### 6. 运行测试
-
-```bash
-# 每次重构后运行测试
-npm run test
-
-# 确保所有测试通过
-npm run test:all
-```
-
-### 7. 性能验证
-
-如果重构涉及性能：
-
-```bash
-# 运行性能测试
-npm run test:perf
-
-# 对比重构前后性能
-```
-
-### 8. 代码审查
-
-自我检查：
-
-- 代码更清晰
-- 性能未下降
-- 测试全部通过
-- 没有引入新问题
-
-### 9. 更新文档
-
-- 更新相关文档
-- 添加注释说明
-- 更新 CHANGELOG.md
-
-### 10. 提交代码
-
-```bash
-git add .
-git commit -m "refactor(scope): describe the refactoring" -s
-git push origin refactor/your-refactor
-```
-
-### 11. 创建 Pull Request
-
-- 说明重构原因
-- 展示改进效果
-- 提供性能对比（如需要）
-
-### 12. 代码审查
-
-- 响应审查意见
-- 确保所有测试通过
-- 合并到 main 分支
-
-## 重构原则
-
-### 不改变外部行为
-
-- 保持 API 兼容
-- 保持输出一致
-- 保持错误处理
-
-### 小步迭代
-
-- 每次只改一处
-- 频繁运行测试
-- 及时提交代码
-
-### 测试驱动
-
-- 先写测试
-- 重构代码
-- 确保通过
-
-### 保持简单
-
-- 减少复杂度
-- 提高可读性
-- 增强可维护性
-
-## 常见重构模式
-
-### 提取函数
-
-```typescript
-// 重构前
-function processApps(apps: App[]) {
-  for (const app of apps) {
-    if (app.installed) {
-      console.log(app.name + " is installed");
-    }
-  }
-}
-
-// 重构后
-function logInstalledApp(app: App) {
-  if (app.installed) {
-    console.log(`${app.name} is installed`);
-  }
-}
-
-function processApps(apps: App[]) {
-  apps.forEach(logInstalledApp);
-}
-```
-
-### 提取类型
-
-```typescript
-// 重构前
-function createDownload(data: any) {
-  return {
-    id: data.id,
-    name: data.name,
-    pkgname: data.pkgname,
-  };
-}
-
-// 重构后
-interface DownloadData {
-  id: number;
-  name: string;
-  pkgname: string;
-}
-
-function createDownload(data: DownloadData): DownloadItem {
-  return {
-    id: data.id,
-    name: data.name,
-    pkgname: data.pkgname,
-    status: "queued",
-    progress: 0,
-    downloadedSize: 0,
-    totalSize: 0,
-    speed: 0,
-    timeRemaining: 0,
-    startTime: Date.now(),
-    logs: [],
-    source: "APM Store",
-    retry: false,
-  };
-}
-```
-
-### 简化条件
-
-```typescript
-// 重构前
-function getStatus(status: string): string {
-  if (status === "queued") {
-    return "Queued";
-  } else if (status === "downloading") {
-    return "Downloading";
-  } else if (status === "installing") {
-    return "Installing";
-  } else if (status === "completed") {
-    return "Completed";
-  } else if (status === "failed") {
-    return "Failed";
-  } else {
-    return "Unknown";
-  }
-}
-
-// 重构后
-const statusMap: Record<string, string> = {
-  queued: "Queued",
-  downloading: "Downloading",
-  installing: "Installing",
-  completed: "Completed",
-  failed: "Failed",
-};
-
-function getStatus(status: string): string {
-  return statusMap[status] || "Unknown";
-}
-```
-
-## 注意事项
-
-- ⚠️ 不要在重构中引入新功能
-- ⚠️ 不要同时重构多处
-- ⚠️ 确保测试覆盖充分
-- ⚠️ 保持提交历史清晰
-- ⚠️ 及时回退有问题的重构
-
-## 相关文档
-
-- [CONTRIBUTING.md](../../CONTRIBUTING.md) - 贡献指南
-- [DEVELOPMENT.md](../../DEVELOPMENT.md) - 开发文档
-- [TESTING.md](../../TESTING.md) - 测试文档

.agents/workflows/release.md

@@ -1,211 +0,0 @@
----
-description: 发布流程
----
-
-## 工作流说明
-
-此工作流指导如何发布新版本。
-
-## 步骤
-
-### 1. 更新版本号
-
-```bash
-# 更新版本
-npm version patch  # 1.0.0 → 1.0.1
-npm version minor  # 1.0.0 → 1.1.0
-npm version major  # 1.0.0 → 2.0.0
-
-# 或手动编辑 package.json
-```
-
-### 2. 更新 CHANGELOG.md
-
-```bash
-# 生成变更日志
-npm run changelog
-```
-
-或手动更新：
-
-```markdown
-## [1.0.1](https://github.com/elysia-best/apm-app-store/compare/v1.0.0...v1.0.1) (2026-03-10)
-
-### Bug Fixes
-
-- fix(ui): correct dark mode toggle persistence (#123)
-
-### Features
-
-- feat(install): add retry mechanism for failed installations (#124)
-```
-
-### 3. 运行完整测试
-
-```bash
-# 运行所有测试
-npm run test:all
-
-# 运行代码检查
-npm run lint
-npm run format
-
-# 构建项目
-npm run build:vite
-```
-
-### 4. 提交变更
-
-```bash
-git add .
-git commit -m "chore(release): bump version to x.x.x" -s
-git push origin main
-```
-
-### 5. 创建 Git 标签
-
-```bash
-# 创建标签
-git tag v{version}
-
-# 推送标签
-git push origin v{version}
-```
-
-### 6. 触发 CI 构建
-
-推送标签后会自动触发 GitHub Actions 构建。
-
-### 7. 验证构建
-
-在 GitHub Actions 页面查看：
-
-- 所有测试通过
-- 构建成功
-- 构建产物生成
-
-### 8. 检查 Release
-
-GitHub Actions 会自动创建 Release：
-
-- 访问 Releases 页面
-- 检查版本信息
-- 确认构建产物
-
-### 9. 发布说明
-
-如果需要，更新 Release 说明：
-
-- 添加主要变更
-- 添加已知问题
-- 添加升级说明
-
-### 10. 通知用户
-
-- 更新 README
-- 发布公告
-- 通知用户
-
-## 发布检查清单
-
-### 代码质量
-
-- [ ] 所有测试通过
-- [ ] 代码检查通过
-- [ ] 没有已知严重 Bug
-- [ ] 性能测试通过
-
-### 文档
-
-- [ ] CHANGELOG.md 更新
-- [ ] README.md 更新（如需要）
-- [ ] API 文档更新（如需要）
-
-### 构建
-
-- [ ] 本地构建成功
-- [ ] CI 构建成功
-- [ ] 构建产物正确
-
-### 发布
-
-- [ ] 版本号正确
-- [ ] 标签已推送
-- [ ] Release 已创建
-- [ ] 构建产物已上传
-
-## 版本号规范
-
-遵循 [Semantic Versioning](https://semver.org/)：
-
-- **MAJOR:** 不兼容的 API 变更
-- **MINOR:** 向后兼容的功能新增
-- **PATCH:** 向后兼容的 Bug 修复
-
-### 示例
-
-```
-4.9.9 → 4.9.10 (PATCH: Bug 修复)
-4.9.9 → 4.10.0 (MINOR: 新功能)
-4.9.9 → 5.0.0 (MAJOR: 重大变更)
-```
-
-## 发布后
-
-### 更新开发分支
-
-```bash
-git checkout develop
-git merge main
-git push origin develop
-```
-
-### 监控反馈
-
-- 收集用户反馈
-- 监控 Bug 报告
-- 记录性能数据
-
-### 准备下一个版本
-
-- 创建新的 Issue
-- 规划新功能
-- 评估技术债务
-
-## 回滚流程
-
-如果发现严重问题：
-
-### 1. 立即停止推广
-
-- 通知用户暂停升级
-- 更新下载页面
-
-### 2. 修复问题
-
-```bash
-git checkout main
-git checkout -b fix/critical-issue
-# 修复问题
-git push origin fix/critical-issue
-```
-
-### 3. 紧急发布
-
-```bash
-npm version patch
-git tag -a v{x.x.x} -m "Hotfix: description"
-git push origin v{x.x.x}
-```
-
-### 4. 通知用户
-
-- 发布新版本
-- 说明问题和修复
-- 提供升级说明
-
-## 相关文档
-
-- [DEPLOYMENT.md](../../DEPLOYMENT.md) - 部署文档
-- [CONTRIBUTING.md](../../CONTRIBUTING.md) - 贡献指南
-- [CHANGELOG.md](../../CHANGELOG.md) - 变更日志

.agents/workflows/run-project.md

@@ -1,47 +0,0 @@
----
-description: 运行项目 (自动安装依赖)
----
-
-## 工作流说明
-
-此工作流将检查运行环境，自动安装缺失的依赖，并启动开发服务器。
-
-## 步骤
-
-### 1. 检查 Node.js 环境
-
-确保已安装 Node.js 和 npm。
-
-// turbo
-```bash
-node -v && npm -v
-```
-
-### 2. 检查并安装依赖
-
-检查 `node_modules` 是否存在。如果不存在，将自动运行 `npm install`。
-
-// turbo
-```bash
-if [ ! -d "node_modules" ]; then
-  echo "检测到缺少依赖，正在安装..."
-  npm install
-else
-  echo "依赖已安装，准备启动..."
-fi
-```
-
-### 3. 运行开发服务器
-
-启动项目开发模式。
-
-// turbo
-```bash
-npm run dev
-```
-
-## 注意事项
-
-- 首次运行可能需要一些时间安装依赖。
-- 如果安装失败，请手动运行 `npm install` 查看详细错误。
-- 确保您的系统中已安装并配置好 Electron 所需的系统依赖。

.agents/workflows/security-audit.md

@@ -1,435 +0,0 @@
----
-description: 安全审计流程
----
-
-## 工作流说明
-
-此工作流指导如何进行安全审计。
-
-## 步骤
-
-### 1. 确定审计范围
-
-确定需要审计的方面：
-
-- 代码安全
-- 依赖安全
-- 数据安全
-- 网络安全
-- 权限管理
-
-### 2. 创建审计分支
-
-```bash
-git checkout -b security/security-audit
-```
-
-### 3. 代码安全审计
-
-#### 检查 SQL 注入
-
-```typescript
-// ❌ 不安全
-const query = `SELECT * FROM apps WHERE name = '${appName}'`;
-
-// ✅ 安全
-const query = "SELECT * FROM apps WHERE name = ?";
-db.query(query, [appName]);
-```
-
-#### 检查 XSS 攻击
-
-```typescript
-// ❌ 不安全
-element.innerHTML = userInput;
-
-// ✅ 安全
-element.textContent = userInput;
-// 或使用 DOMPurify
-import DOMPurify from "dompurify";
-element.innerHTML = DOMPurify.sanitize(userInput);
-```
-
-#### 检查命令注入
-
-```typescript
-// ❌ 不安全
-const cmd = `apm install ${packageName}`;
-exec(cmd);
-
-// ✅ 安全
-const args = ["apm", "install", packageName];
-spawn("apm", args);
-```
-
-#### 检查路径遍历
-
-```typescript
-// ❌ 不安全
-const filePath = path.join(basePath, userInput);
-
-// ✅ 安全
-const safePath = path.normalize(userInput).replace(/^(\.\.(\/|\\|$))+/, "");
-const filePath = path.join(basePath, safePath);
-```
-
-### 4. 依赖安全审计
-
-```bash
-# 检查依赖漏洞
-npm audit
-
-# 自动修复
-npm audit fix
-
-# 手动修复
-npm audit fix --force
-```
-
-#### 检查 package.json
-
-```json
-{
-  "dependencies": {
-    "axios": "^1.13.2",
-    "pino": "^10.3.0"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.40.0"
-  }
-}
-```
-
-### 5. 数据安全审计
-
-#### 检查敏感信息
-
-```typescript
-// ❌ 不安全 - 硬编码密钥
-const apiKey = "sk-1234567890";
-
-// ✅ 安全 - 使用环境变量
-const apiKey = process.env.API_KEY;
-
-// ❌ 不安全 - 记录敏感信息
-logger.info({ password: user.password }, "User logged in");
-
-// ✅ 安全 - 不记录敏感信息
-logger.info({ userId: user.id }, "User logged in");
-```
-
-#### 检查数据加密
-
-```typescript
-// 加密敏感数据
-import crypto from "crypto";
-
-function encrypt(text: string, key: string): string {
-  const iv = crypto.randomBytes(16);
-  const cipher = crypto.createCipheriv("aes-256-cbc", key, iv);
-  let encrypted = cipher.update(text, "utf8", "hex");
-  encrypted += cipher.final("hex");
-  return iv.toString("hex") + ":" + encrypted;
-}
-```
-
-### 6. 网络安全审计
-
-#### 检查 HTTPS
-
-```typescript
-// ❌ 不安全 - HTTP
-const baseURL = "http://api.example.com";
-
-// ✅ 安全 - HTTPS
-const baseURL = "https://api.example.com";
-```
-
-#### 检查证书验证
-
-```typescript
-// 配置 Axios 验证证书
-const axiosInstance = axios.create({
-  httpsAgent: new https.Agent({
-    rejectUnauthorized: true,
-  }),
-});
-```
-
-#### 检查 CORS
-
-```typescript
-// 配置 CORS
-app.use(
-  cors({
-    origin: "https://yourdomain.com",
-    credentials: true,
-  }),
-);
-```
-
-### 7. 权限管理审计
-
-#### 检查权限提升
-
-```typescript
-// 检查 pkexec 可用性
-const checkSuperUserCommand = async (): Promise<string> => {
-  if (process.getuid && process.getuid() !== 0) {
-    const { stdout } = await execAsync("which /usr/bin/pkexec");
-    return stdout.trim().length > 0 ? "/usr/bin/pkexec" : "";
-  }
-  return "";
-};
-```
-
-#### 检查上下文隔离
-
-```typescript
-// electron/preload/index.ts
-// ✅ 安全 - 启用上下文隔离
-contextBridge.exposeInMainWorld("ipcRenderer", {
-  send: (...args) => ipcRenderer.send(...args),
-  on: (...args) => ipcRenderer.on(...args),
-  invoke: (...args) => ipcRenderer.invoke(...args),
-});
-
-// ❌ 不安全 - 禁用上下文隔离
-contextIsolation: false;
-```
-
-### 8. 运行安全工具
-
-```bash
-# 使用 Snyk 扫描
-npx snyk test
-
-# 使用 npm audit
-npm audit
-
-# 使用 ESLint 安全规则
-npm run lint
-```
-
-### 9. 修复安全问题
-
-根据审计结果修复发现的问题：
-
-```typescript
-// 修复示例
-function validateInput(input: string): boolean {
-  // 验证输入
-  const regex = /^[a-zA-Z0-9-_]+$/;
-  return regex.test(input);
-}
-
-function sanitizeInput(input: string): string {
-  // 清理输入
-  return input.trim().replace(/[<>]/g, "");
-}
-```
-
-### 10. 安全测试
-
-```typescript
-// src/__tests__/security/security.test.ts
-import { describe, it, expect } from "vitest";
-import { validateInput, sanitizeInput } from "@/modules/security";
-
-describe("Security", () => {
-  describe("validateInput", () => {
-    it("should reject malicious input", () => {
-      expect(validateInput('<script>alert("xss")</script>')).toBe(false);
-    });
-
-    it("should accept valid input", () => {
-      expect(validateInput("valid-app-name")).toBe(true);
-    });
-  });
-
-  describe("sanitizeInput", () => {
-    it("should remove dangerous characters", () => {
-      expect(sanitizeInput("<script>app</script>")).toBe("scriptapp/script");
-    });
-  });
-});
-```
-
-### 11. 更新文档
-
-- 记录安全问题
-- 说明修复方法
-- 更新安全指南
-
-### 12. 提交代码
-
-```bash
-git add .
-git commit -m "security: fix security vulnerabilities" -s
-git push origin security/security-audit
-```
-
-### 13. 创建 Pull Request
-
-- 说明安全问题
-- 展示修复方法
-- 提供安全测试结果
-
-## 安全检查清单
-
-### 代码安全
-
-- [ ] 输入验证
-- [ ] 输出编码
-- [ ] 参数化查询
-- [ ] 错误处理
-- [ ] 日志安全
-
-### 依赖安全
-
-- [ ] 定期更新依赖
-- [ ] 使用 `npm audit`
-- [ ] 检查已知漏洞
-- [ ] 使用可信源
-
-### 数据安全
-
-- [ ] 敏感数据加密
-- [ ] 不记录敏感信息
-- [ ] 使用环境变量
-- [ ] 安全存储
-
-### 网络安全
-
-- [ ] 使用 HTTPS
-- [ ] 验证证书
-- [ ] 配置 CORS
-- [ ] 防止 CSRF
-
-### 权限管理
-
-- [ ] 最小权限原则
-- [ ] 上下文隔离
-- [ ] 权限检查
-- [ ] 审计日志
-
-## 常见安全问题
-
-### 1. XSS 攻击
-
-**问题:** 用户输入包含恶意脚本
-
-**解决方案:**
-
-```typescript
-import DOMPurify from "dompurify";
-
-function sanitizeHTML(html: string): string {
-  return DOMPurify.sanitize(html);
-}
-```
-
-### 2. SQL 注入
-
-**问题:** 恶意 SQL 代码注入
-
-**解决方案:**
-
-```typescript
-// 使用参数化查询
-db.query("SELECT * FROM apps WHERE name = ?", [appName]);
-```
-
-### 3. 命令注入
-
-**问题:** 恶意命令注入
-
-**解决方案:**
-
-```typescript
-// 使用 spawn 而非 exec
-const args = ["apm", "install", packageName];
-spawn("apm", args);
-```
-
-### 4. 路径遍历
-
-**问题:** 访问未授权文件
-
-**解决方案:**
-
-```typescript
-// 验证路径
-const safePath = path.normalize(userPath).replace(/^(\.\.(\/|\\|$))+/, "");
-```
-
-### 5. 敏感信息泄露
-
-**问题:** 日志中包含敏感信息
-
-**解决方案:**
-
-```typescript
-// 不记录敏感信息
-logger.info({ userId: user.id }, "User logged in");
-```
-
-## 安全最佳实践
-
-### 1. 最小权限原则
-
-只授予必要的权限，避免过度授权。
-
-### 2. 深度防御
-
-多层安全防护，不依赖单一安全措施。
-
-### 3. 输入验证
-
-验证所有输入，包括用户输入和 API 响应。
-
-### 4. 输出编码
-
-对输出进行编码，防止 XSS 攻击。
-
-### 5. 定期审计
-
-定期进行安全审计，及时发现和修复问题。
-
-### 6. 安全更新
-
-及时更新依赖和系统，修复已知漏洞。
-
-## 安全工具
-
-### 静态分析
-
-- ESLint
-- TypeScript
-- SonarQube
-
-### 动态分析
-
-- OWASP ZAP
-- Burp Suite
-- Snyk
-
-### 依赖扫描
-
-- npm audit
-- Snyk
-- Dependabot
-
-## 注意事项
-
-- ⚠️ 不要忽视安全问题
-- ⚠️ 及时修复漏洞
-- ⚠️ 定期更新依赖
-- ⚠️ 保持安全意识
-- ⚠️ 遵循安全最佳实践
-
-## 相关文档
-
-- [CONTRIBUTING.md](../../CONTRIBUTING.md) - 贡献指南
-- [DEVELOPMENT.md](../../DEVELOPMENT.md) - 开发文档
-- [SECURITY.md](../../SECURITY.md) - 安全政策

.agents/workflows/testing.md

@@ -1,108 +0,0 @@
----
-description: 测试编写流程
----
-
-## 工作流说明
-
-此工作流指导如何为新功能或 Bug 修复编写测试。
-
-## 步骤
-
-### 1. 确定测试范围
-
-分析需要测试的功能点：
-
-- 单元测试：测试独立函数/组件
-- 集成测试：测试模块间交互
-- E2E 测试：测试完整用户流程
-
-### 2. 编写单元测试（Vitest）
-
-在 `src/__tests__/unit/` 目录下创建测试文件：
-
-```typescript
-import { describe, it, expect } from "vitest";
-import { someFunction } from "@/modules/example";
-
-describe("someFunction", () => {
-  it("should return expected result", () => {
-    const result = someFunction(input);
-    expect(result).toBe(expected);
-  });
-});
-```
-
-### 3. 编写组件测试
-
-```typescript
-import { describe, it, expect } from "vitest";
-import { mount } from "@vue/test-utils";
-import AppCard from "@/components/AppCard.vue";
-
-describe("AppCard", () => {
-  it("should render app name", () => {
-    const wrapper = mount(AppCard, {
-      props: {
-        app: {
-          name: "Test App",
-          pkgname: "test-app",
-        },
-      },
-    });
-    expect(wrapper.text()).toContain("Test App");
-  });
-});
-```
-
-### 4. 编写 E2E 测试（Playwright）
-
-在 `e2e/` 目录下创建测试文件：
-
-```typescript
-import { test, expect } from "@playwright/test";
-
-test("install app from store", async ({ page }) => {
-  await page.goto("http://localhost:3344");
-  await page.click("text=Test App");
-  await page.click('button:has-text("安装")');
-  await expect(page.locator(".install-progress")).toBeVisible();
-});
-```
-
-### 5. 运行测试
-
-```bash
-# 运行单元测试
-npm run test
-
-# 运行测试并监听
-npm run test:watch
-
-# 运行 E2E 测试
-npm run test:e2e
-
-# 生成覆盖率报告
-npm run test:coverage
-```
-
-### 6. 确保测试通过
-
-- 所有单元测试必须通过
-- E2E 测试覆盖主要用户流程
-- 测试覆盖率不低于 70%
-
-### 7. 提交代码
-
-测试通过后，提交代码并创建 PR。
-
-## 注意事项
-
-- ⚠️ 不要测试第三方库的功能
-- ⚠️ 保持测试独立性和可重复性
-- ⚠️ 使用有意义的测试名称
-- ⚠️ Mock 外部依赖（APM 命令、API 调用）
-
-## 相关文档
-
-- [TESTING.md](../../TESTING.md) - 测试框架和规范
-- [DEVELOPMENT.md](../../DEVELOPMENT.md) - 开发文档

.env.debug

@@ -1,3 +0,0 @@
-VITE_APM_STORE_LOCAL_MODE=true
-VITE_APM_STORE_BASE_URL=/local_amd64-store
-VITE_APM_STORE_STATS_BASE_URL=/local_stats

.env.production

@@ -1,2 +0,0 @@
-VITE_APM_STORE_BASE_URL=https://erotica.spark-app.store
-VITE_APM_STORE_STATS_BASE_URL=https://feedback.spark-app.store

.gitee/Dockerfile

@@ -0,0 +1,4 @@
+FROM shenmo7192/uos-21-dtk5.4:1.0
+ADD . /root/workdir
+WORKDIR /root/workdir
+RUN dpkg-buildpackage

.gitee/callback.py

@@ -0,0 +1,31 @@
+import os
+import requests
+import json
+
+
+# sha=os.system("git rev-parse HEAD")
+sha = os.getenv("GIT_COMMIT")
+# sha = '48fed26c51a8c42554e45f72f43e49703e04c97f'
+#get sha from environment 
+url = "https://gitee.com/api/v5/repos/deepin-community-store/spark-store/commits/{}/comments".format(sha)
+
+token = os.getenv("gitee_token")
+
+# process = os.popen("git symbolic-ref --short -q HEAD")
+
+body = "构建详情请见" + os.getenv("JENKINS_URL") + "blue/organizations/jenkins/" + os.getenv("JOB_NAME").replace("/", "/detail/") + "/" + str(os.getenv("BUILD_ID"))
+
+# process.close()
+
+d = {
+    'access_token': token,
+    "body": body
+}
+
+h = {
+    "Content-Type": "application/json;charset=UTF-8"
+}
+
+res = requests.post(url,headers=h, data=json.dumps(d))
+# print(res.status_code)
+# print(res.content)

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,52 +0,0 @@
----
-name: Bug 报告
-about: 创建一个 Bug 报告以帮助我们改进
-title: "[Bug] "
-labels: bug
-assignees: ""
----
-
-## 描述
-
-清晰简洁地描述这个 Bug 是什么。
-
-## 复现步骤
-
-1. 打开 '...'
-2. 点击 '....'
-3. 滚动到 '....'
-4. 看到错误
-
-## 期望行为
-
-清晰简洁地描述你期望发生什么。
-
-## 实际行为
-
-清晰简洁地描述实际发生了什么。
-
-## 截图
-
-如果适用，添加截图以帮助解释你的问题。
-
-## 环境信息
-
-**操作系统:** [例如: Ubuntu 22.04]
-
-**APM 版本:** [例如: 1.0.0]
-
-**应用商店版本:** [例如: 4.9.9]
-
-**桌面环境:** [例如: GNOME, KDE]
-
-## 日志
-
-如果相关，粘贴日志到以下区域（使用代码块）：
-
-```
-粘贴日志内容
-```
-
-## 额外上下文
-
-添加任何其他关于问题的上下文信息。

.github/ISSUE_TEMPLATE/help_wanted.md

@@ -1,23 +0,0 @@
----
-name: 功能请求 / 帮助请求
-about: 为这个项目建议一个新想法
-title: "[Feature] "
-labels: enhancement
-assignees: ""
----
-
-## 你的功能请求是否与问题有关？
-
-清晰简洁地描述问题。例如：我在 [...] 时总是感到沮丧
-
-## 你想要的解决方案是什么？
-
-清晰简洁地描述你想要发生什么。
-
-## 你考虑过哪些替代方案？
-
-清晰简洁地描述你考虑过的任何替代解决方案或功能。
-
-## 额外上下文
-
-添加任何其他关于功能请求的上下文或截图。

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,12 +0,0 @@
-<!-- Thank you for contributing! -->
-
-### Description
-
-<!-- Please insert your description here and provide especially info about the "what" this PR is solving -->
-
-### What is the purpose of this pull request? <!-- (put an "X" next to an item) -->
-
-- [ ] Bug fix
-- [ ] New Feature
-- [ ] Documentation update
-- [ ] Other

.github/dependabot.yml

@@ -1,15 +0,0 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
-
-version: 2
-updates:
-  - package-ecosystem: "npm" # See documentation for possible values
-    directory: "/" # Location of package manifests
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "github-actions"
-    directory: "/" # Location of package manifests
-    schedule:
-      interval: "weekly" 

.github/workflows/build.yml.bak

@@ -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

.github/workflows/test.yml.bak

@@ -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

.gitignore

@@ -1,41 +1,56 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-lerna-debug.log*
+# C++ objects and libs
+*.slo
+*.lo
+*.o
+*.a
+*.la
+*.lai
+*.so
+*.dll
+*.dylib
 
-node_modules
-dist
-dist-ssr
-dist-electron
-release
-*.local
+# 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-*
 
-# Test coverage
-coverage
-.nyc_output
+# Qt unit tests
+target_wrapper.*
 
-# Playwright
-test-results
-playwright-report
-playwright/.cache
+# Qt qm files
+translations/*.qm
 
-# Editor directories and files
-.vscode/.debug.env
-.idea
-.DS_Store
-*.suo
-*.ntvs*
-*.njsproj
-*.sln
-*.sw?
+# QtCreator
+*.autosave
 
-# lockfile
-pnpm-lock.yaml
-yarn.lock
-.lock
+# QtCreator Qml
+*.qmlproject.user
+*.qmlproject.user.*
 
-test-results.json
+# QtCreator CMake
+CMakeLists.txt.user*
+build
+
+# Debian dpkg-buildpackage
+debian/*.debhelper*
+debian/files
+debian/*.substvars
+debian/spark-store
+
+.vscode/*
+src/spark-store

.npmrc

@@ -1,6 +0,0 @@
-# For electron-builder
-# https://github.com/electron-userland/electron-builder/issues/6289#issuecomment-1042620422
-shamefully-hoist=true
-
-# For China 🇨🇳 developers
-# electron_mirror=https://npmmirror.com/mirrors/electron/

.vscode/.debug.script.mjs

@@ -1,23 +0,0 @@
-import fs from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { createRequire } from 'node:module'
-import { spawn } from 'node:child_process'
-
-const pkg = createRequire(import.meta.url)('../package.json')
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-
-// write .debug.env
-const envContent = Object.entries(pkg.debug.env).map(([key, val]) => `${key}=${val}`)
-fs.writeFileSync(path.join(__dirname, '.debug.env'), envContent.join('\n'))
-
-// bootstrap
-spawn(
-  // TODO: terminate `npm run dev` when Debug exits.
-  process.platform === 'win32' ? 'npm.cmd' : 'npm',
-  ['run', 'dev'],
-  {
-    stdio: 'inherit',
-    env: Object.assign(process.env, { VSCODE_DEBUG: 'true' }),
-  },
-)

.vscode/extensions.json

@@ -1,6 +0,0 @@
-{
-	"recommendations": [
-		"Vue.volar",
-		"Vue.vscode-typescript-vue-plugin"
-	]
-}

.vscode/launch.json

@@ -1,53 +0,0 @@
-{
-  // Use IntelliSense to learn about possible attributes.
-  // Hover to view descriptions of existing attributes.
-  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-  "version": "0.2.0",
-  "compounds": [
-    {
-      "name": "Debug App",
-      "preLaunchTask": "Before Debug",
-      "configurations": [
-        "Debug Main Process",
-        "Debug Renderer Process"
-      ],
-      "presentation": {
-        "hidden": false,
-        "group": "",
-        "order": 1
-      },
-      "stopAll": true
-    }
-  ],
-  "configurations": [
-    {
-      "name": "Debug Main Process",
-      "type": "node",
-      "request": "launch",
-      "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/electron",
-      // "windows": {
-      //   "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/electron.cmd"
-      // },
-      "runtimeArgs": [
-        "--remote-debugging-port=9229",
-        "."
-      ],
-      "envFile": "${workspaceFolder}/.vscode/.debug.env",
-      "console": "integratedTerminal"
-    },
-    {
-      "name": "Debug Renderer Process",
-      "port": 9229,
-      "request": "attach",
-      "type": "chrome",
-      "timeout": 60000,
-      "skipFiles": [
-        "<node_internals>/**",
-        "${workspaceRoot}/node_modules/**",
-        "${workspaceRoot}/dist-electron/**",
-        // Skip files in host(VITE_DEV_SERVER_URL)
-        "http://127.0.0.1:3344/**"
-      ]
-    },
-  ]
-}

.vscode/settings.json

@@ -1,18 +0,0 @@
-{
-  "typescript.tsdk": "node_modules/typescript/lib",
-  "typescript.tsc.autoDetect": "off",
-  "json.schemas": [
-    {
-      "fileMatch": [
-        "/*electron-builder.json5",
-        "/*electron-builder.json"
-      ],
-      "url": "https://json.schemastore.org/electron-builder"
-    }
-  ],
-  "eslint.validate": [
-    "javascript",
-    "javascriptreact",
-    "vue"
-  ]
-}

.vscode/tasks.json

@@ -1,31 +0,0 @@
-{
-  // See https://go.microsoft.com/fwlink/?LinkId=733558 
-  // for the documentation about the tasks.json format
-  "version": "2.0.0",
-  "tasks": [
-    {
-      "label": "Before Debug",
-      "type": "shell",
-      "command": "node .vscode/.debug.script.mjs",
-      "isBackground": true,
-      "problemMatcher": {
-        "owner": "typescript",
-        "fileLocation": "relative",
-        "pattern": {
-          // TODO: correct "regexp"
-          "regexp": "^([a-zA-Z]\\:\/?([\\w\\-]\/?)+\\.\\w+):(\\d+):(\\d+): (ERROR|WARNING)\\: (.*)$",
-          "file": 1,
-          "line": 3,
-          "column": 4,
-          "code": 5,
-          "message": 6
-        },
-        "background": {
-          "activeOnStart": true,
-          "beginsPattern": "^.*VITE v.*  ready in \\d* ms.*$",
-          "endsPattern": "^.*\\[startup\\] Electron App.*$"
-        }
-      }
-    }
-  ]
-}

.workflow/dtk-build-commit-20220425.yml

@@ -0,0 +1,39 @@
+version: '1.0'
+name: dtk-build-commit-20220425
+displayName: dtk-build-commit
+triggers:
+  trigger: auto
+  pr:
+    branches:
+      prefix:
+        - ''
+stages:
+  - name: stage-4e566164
+    displayName: build
+    strategy: naturally
+    trigger: auto
+    executor: []
+    steps:
+      - step: execute@docker
+        name: execute_by_docker
+        displayName: 基于镜像的脚本执行
+        certificate: ''
+        image: docker.io/debian:buster
+        command:
+          - sed -i 's/deb.debian.org/mirrors.ustc.edu.cn/g' /etc/apt/sources.list
+          - '# 换源'
+          - apt update
+          - export DEBIAN_FRONTEND=noninteractive
+          - echo "安装git devscripts equivs ..."
+          - apt install git devscripts equivs curl -y >/dev/null 2>&1
+          - git clone https://gitlink.org.cn/shenmo7192/dtk-old-bundle.git
+          - cd dtk-old-bundle
+          - apt install ./*.deb -y
+          - cd ..
+          - rm -rf dtk-old-bundle
+          - 'mk-build-deps --install --tool "apt-get -o Debug::pkgProblemResolver=yes  -y" '
+          - dpkg-buildpackage -j2 -b -us -uc
+          - cd ..
+          - ls -all
+          - pwd
+        strategy: {}

.workflow/dtk-build-release-tag-20220425.yml

@@ -0,0 +1,66 @@
+version: '1.0'
+name: dtk-build-release-tag-20220425
+displayName: dtk-build-release-tag
+triggers:
+  trigger: manual
+  push:
+    tags:
+      prefix:
+        - ''
+stages:
+  - name: stage-4e566164
+    displayName: build
+    strategy: naturally
+    trigger: auto
+    executor: []
+    steps:
+      - step: execute@docker
+        name: execute_by_docker
+        displayName: 基于镜像的DTK构建
+        certificate: ''
+        image: docker.io/debian:buster
+        command:
+          - sed -i 's/deb.debian.org/mirrors.ustc.edu.cn/g' /etc/apt/sources.list
+          - '# 换源'
+          - apt update
+          - export DEBIAN_FRONTEND=noninteractive
+          - echo "安装git devscripts equivs curl..."
+          - 'apt install git devscripts equivs curl -y '
+          - git clone https://gitlink.org.cn/shenmo7192/dtk-old-bundle.git
+          - cd dtk-old-bundle
+          - apt install ./*.deb -y
+          - cd ..
+          - rm -rf dtk-old-bundle
+          - ''
+          - 'mk-build-deps --install --tool "apt-get -o Debug::pkgProblemResolver=yes  -y" '
+          - dpkg-buildpackage -j2 -b -us -uc
+          - cd ..
+          - ls -all
+          - pwd
+          - ''
+          - 'mkdir target '
+          - for f in $(find . -type f -name "*.deb")
+          - do
+          - '    mv $f target'
+          - done
+        artifacts:
+          - name: BUILD_ARTIFACT
+            path:
+              - ../target
+        notify: []
+        strategy:
+          retry: '0'
+  - name: stage-29f3ffbb
+    displayName: 上传
+    strategy: naturally
+    trigger: auto
+    executor: []
+    steps:
+      - step: publish@general_artifacts
+        name: publish_general_artifacts
+        displayName: 上传制品
+        dependArtifact: BUILD_ARTIFACT
+        artifactName: output
+        notify: []
+        strategy:
+          retry: '0'

.workflow/pipeline-dtk-build-aarch64.yml

@@ -0,0 +1,48 @@
+version: '1.0'
+name: pipeline-dtk-build-aarch64
+displayName: dtk-build-aarch64
+triggers:
+  trigger: manual
+  push:
+    tags:
+      prefix:
+        - ''
+stages:
+  - name: stage-2c12cce1
+    displayName: 编译
+    strategy: naturally
+    trigger: auto
+    executor: []
+    steps:
+      - step: execute@docker
+        name: execute_by_docker
+        displayName: 基于镜像的脚本执行
+        certificate: ''
+        image: docker.io/debian:buster
+        command:
+          - '# 请在此输入您想执行的脚本'
+          - sed -i 's/deb.debian.org/mirrors.ustc.edu.cn/g' /etc/apt/sources.list
+          - apt update
+          - export DEBIAN_FRONTEND=noninteractive
+          - echo "安装wget qemu-user-static"
+          - apt install git wget qemu-user-static xz-utils binfmt-support -y
+          - mkdir ../spark-store-git
+          - mv * ../spark-store-git
+          - git clone https://gitlink.org.cn/shenmo7192/debian-container-aarch64.git
+          - mv debian-container-aarch64/DEBIANARM.tar.xz .
+          - rm -rf debian-container-aarch64
+          - tar -xf DEBIANARM.tar.xz
+          - mkdir -p DEBIAN/root/build-spark
+          - mv ../spark-store-git DEBIAN/root/build-spark/spark-store
+          - wget https://gitee.com/deepin-community-store/repo_auto_update_script/raw/master/spark-build-aarch64.sh && mv spark-build-aarch64.sh DEBIAN/root
+          - mv /usr/bin/qemu-aarch64-static DEBIAN/
+          - chroot DEBIAN /qemu-aarch64-static /bin/bash /root/spark-build-aarch64.sh
+          - ''
+          - ''
+        artifacts:
+          - name: BUILD_ARTIFACT
+            path:
+              - ./DEBIAN/root/build-spark/target
+        notify: []
+        strategy:
+          retry: '0'

CHANGELOG.md

@@ -1,146 +0,0 @@
-## [1.1.1](https://github.com/elysia-best/apm-app-store/compare/v1.1.0...v1.1.1) (2026-02-17)
-
-
-### Bug Fixes
-
-* **main:** use app.getVersion() for packaged app ([d45d508](https://github.com/elysia-best/apm-app-store/commit/d45d5082f45d60de69d07998429d6f49c64a7b95))
-
-
-
-# [1.1.0](https://github.com/elysia-best/apm-app-store/compare/v1.1.0-beta.1...v1.1.0) (2026-02-14)
-
-
-### Bug Fixes
-
-* **app:** floor download progress percentage ([ed92145](https://github.com/elysia-best/apm-app-store/commit/ed92145f9145b9190858e1cf4c2a722efe0e2ff0))
-
-
-
-# [1.1.0-beta.1](https://github.com/elysia-best/apm-app-store/compare/v1.0.4...v1.1.0-beta.1) (2026-02-14)
-
-
-### Bug Fixes
-
-* 修复应用还没有安装完，按钮就重新变成可安装状态 ([#11](https://github.com/elysia-best/apm-app-store/issues/11)) ([b43c611](https://github.com/elysia-best/apm-app-store/commit/b43c6117ecb1ec12f590667dfad7db13263d9d68))
-
-
-### Features
-
-* 更新类型系统指南，添加代码检查和格式化要求 ([10808c8](https://github.com/elysia-best/apm-app-store/commit/10808c8f3b2f5535c7dfca6fc8a1e7a45cb5b95c))
-* 更新搜索逻辑 ([d5266c6](https://github.com/elysia-best/apm-app-store/commit/d5266c6af81eb6aa28e2f376c88affbea227a5f7))
-* 添加 ESLint 配置并优化代码风格，移除未使用的功能 ([e11740a](https://github.com/elysia-best/apm-app-store/commit/e11740ad4cff877d93e409bc8adb28f15717e97e))
-* **app:** add cache buster for API requests ([9f50e25](https://github.com/elysia-best/apm-app-store/commit/9f50e25dc09cc0bf1d8e68cefb6843aa9bd8b7e6)), closes [#16](https://github.com/elysia-best/apm-app-store/issues/16)
-* **app:** add download count display ([a3f18bb](https://github.com/elysia-best/apm-app-store/commit/a3f18bb593a8b3b1da9927582eb9f6fb5ef18e24))
-* **docs:** 添加 AI 编码指导文档以概述项目架构和核心概念 ([c3ae477](https://github.com/elysia-best/apm-app-store/commit/c3ae4774976bd0464ca8d500792f4865f0b589e9))
-* **install:** add metalink download support and progress tracking ([74c4eb4](https://github.com/elysia-best/apm-app-store/commit/74c4eb4fbc7dd0d91bbbfac2b91bbb2bf1fa0b68)), closes [#12](https://github.com/elysia-best/apm-app-store/issues/12)
-* support download statistics ([5ac9376](https://github.com/elysia-best/apm-app-store/commit/5ac9376200e54e331d22564424db4c41564d23d3)), closes [#15](https://github.com/elysia-best/apm-app-store/issues/15)
-* **theme:** add system theme support ([7aeb3d5](https://github.com/elysia-best/apm-app-store/commit/7aeb3d5dd4d53ce6a6fed03957ee6f5d9eee0f39)), closes [#13](https://github.com/elysia-best/apm-app-store/issues/13)
-
-
-
-## [1.0.4](https://github.com/elysia-best/apm-app-store/compare/v1.0.4-beta.1...v1.0.4) (2026-01-31)
-
-
-
-## [1.0.4-beta.1](https://github.com/elysia-best/apm-app-store/compare/v1.0.4-beta.0...v1.0.4-beta.1) (2026-01-31)
-
-
-### Bug Fixes
-
-* 修复应用启动命令，移除交互式模式 ([2f7af3c](https://github.com/elysia-best/apm-app-store/commit/2f7af3ca8f704ae0ae9aba572f3f451c7d5a701c))
-
-
-### Features
-
-* 添加 host-spawn 下载步骤并更新应用启动命令 ([850b8dc](https://github.com/elysia-best/apm-app-store/commit/850b8dcd1ff9789960dca38527cfa03008fa8c89))
-
-
-
-## [1.0.4-beta.0](https://github.com/elysia-best/apm-app-store/compare/v1.0.3...v1.0.4-beta.0) (2026-01-31)
-
-
-### Features
-
-* 添加重复任务检查，避免重复下载任务 ([0d1d4e5](https://github.com/elysia-best/apm-app-store/commit/0d1d4e567940366c5754f4dcdb83213f8fe87d7d))
-* 现在仅在有任务时才会到托盘 ([92d1573](https://github.com/elysia-best/apm-app-store/commit/92d1573cf082402b7f44a6beedbc47f58dc91781))
-* enhance install manager to prevent duplicate package installations and improve app launching command ([eeefe52](https://github.com/elysia-best/apm-app-store/commit/eeefe5295b8698b887afad467c8151add6e4e8f5))
-
-
-
-## [1.0.3](https://github.com/elysia-best/apm-app-store/compare/v1.0.3-beta.1...v1.0.3) (2026-01-31)
-
-
-### Bug Fixes
-
-* deep link handling at electron startup ([0ed7f64](https://github.com/elysia-best/apm-app-store/commit/0ed7f64a218e0a26b384810b1a0ac8ae314c2501))
-
-
-### Features
-
-* add app launching functionality and update related components ([6154d75](https://github.com/elysia-best/apm-app-store/commit/6154d75fa6893825e74f7bc421fa91eef0fc4f3f))
-* enhance application type definitions and improve app management logic ([39e40ff](https://github.com/elysia-best/apm-app-store/commit/39e40ff946911c82190c7f0158b5bab9287ac3e4))
-* update application icons and implement tray functionality ([f89b9eb](https://github.com/elysia-best/apm-app-store/commit/f89b9ebfd9ba75fef675d063bf8632143fd125d4))
-* update application name and paths to reflect new branding ([641589f](https://github.com/elysia-best/apm-app-store/commit/641589f8754b638a7f53c729a2930f33884cd51e))
-
-
-
-## [1.0.3-beta.1](https://github.com/elysia-best/apm-app-store/compare/v1.0.2...v1.0.3-beta.1) (2026-01-31)
-
-
-### Bug Fixes
-
-* 修复确认卸载界面应用名称显示 ([b4ef653](https://github.com/elysia-best/apm-app-store/commit/b4ef6532997fdfeb950af16edfa718d1c19507f5))
-* 修复卸载请求中的应用名称查找逻辑 ([9799718](https://github.com/elysia-best/apm-app-store/commit/97997182bc2bf7b8d3a34f062deadfd910987b09))
-* **build:** add bash shell to build release files ([354eea3](https://github.com/elysia-best/apm-app-store/commit/354eea36267f0284381521ee401d15256ecf8151))
-
-
-### Features
-
-* 更新安装按钮状态反馈，添加安装队列提示 ([4ce097b](https://github.com/elysia-best/apm-app-store/commit/4ce097bae032601572112d4647f6374875ca9719))
-* 更新版本号至 1.0.3-beta.0 ([327ee54](https://github.com/elysia-best/apm-app-store/commit/327ee5400e1b967902734d381411a2cf239ddb16))
-* 更新本地应用列表，区分依赖和用户安装的包 ([588eaf9](https://github.com/elysia-best/apm-app-store/commit/588eaf9746482d18716c4f929a3150b560aa5a62))
-* 更新模态框样式，添加最大高度限制 ([61790a8](https://github.com/elysia-best/apm-app-store/commit/61790a85882b6c4ef3ac6b3d60de2f7a7d852025))
-* 添加卸载确认模态框，支持卸载进度显示 ([b9325db](https://github.com/elysia-best/apm-app-store/commit/b9325db8b0d3e426d7f2e443069a4641aab7d581))
-* **preload:** expose architecture detection to renderer process ([5b09dfb](https://github.com/elysia-best/apm-app-store/commit/5b09dfb3d985a0fd6dcd222e33312f957c330cd5))
-
-
-### Performance Improvements
-
-* 移除模态框背景模糊效果 ([eaa2868](https://github.com/elysia-best/apm-app-store/commit/eaa28686a36dd7c5942e227ba30e4ffae249fa2f))
-
-
-
-## [1.0.2](https://github.com/elysia-best/apm-app-store/compare/9b17c57c5cb6ef6848fdc83f37d1b4d317e2b9a1...v1.0.2) (2026-01-30)
-
-
-### Bug Fixes
-
-* 更新构建依赖，添加构建工具支持 ([bc2f791](https://github.com/elysia-best/apm-app-store/commit/bc2f79114c700dc98426379703383873908f8f21))
-* 更新构建依赖，添加python3支持 ([f8f163e](https://github.com/elysia-best/apm-app-store/commit/f8f163e3b87ea0dae7e3af0645ae4620c468479b))
-* 更新构建依赖，移除不必要的包并优化安装命令 ([1c791cd](https://github.com/elysia-best/apm-app-store/commit/1c791cd3c83ebc51db8348c6ebce8b4d4eff42d9))
-* 更新上传工件路径以支持不同包类型 ([9ee8339](https://github.com/elysia-best/apm-app-store/commit/9ee8339577ee93f5c7c47be119a6275379321bfe))
-* 更新应用图标格式为ICNS，优化安装管理器命令执行 ([4b49424](https://github.com/elysia-best/apm-app-store/commit/4b49424105451eceb6653fd2974fad7021a4b2cd))
-* 更新应用ID和版本信息，修复许可证类型 ([a3d50e0](https://github.com/elysia-best/apm-app-store/commit/a3d50e026aa570cd2a49da0acd604f4db682bd72))
-* 更新vite版本至6.4.1 ([51ee401](https://github.com/elysia-best/apm-app-store/commit/51ee4019d969767f313cd8af23ea1f0e310b3f4b))
-* 将依赖项'apm'更改为'amber-package-manager' ([f7eedcd](https://github.com/elysia-best/apm-app-store/commit/f7eedcd4fd3a073dd1b2c5623c9fe12bb43b43a1))
-
-
-### Features
-
-*  统一安装和卸载脚本以支持PolicyKit权限配置 ([f15fb28](https://github.com/elysia-best/apm-app-store/commit/f15fb28d80c481a40d768c12cb5f28a4daa6a5a6))
-* 更新窗口标题和尺寸，优化按钮样式 ([185b498](https://github.com/elysia-best/apm-app-store/commit/185b4984c60a3b5049d44d8e8dc4ff45384b9000))
-* 更新TODO列表，添加应用更新和显示已安装应用功能 ([402ba1f](https://github.com/elysia-best/apm-app-store/commit/402ba1fb00d81828f6c228fb1012203861629fab))
-* 添加对deb和rpm包的构建支持，更新构建依赖和版本信息 ([640e0bd](https://github.com/elysia-best/apm-app-store/commit/640e0bd69df90e278803a14e30aa50c99123db95))
-* 添加已安装应用和可更新应用的管理功能，支持卸载和升级操作 ([ea0261a](https://github.com/elysia-best/apm-app-store/commit/ea0261a1923fbc692ab0480374f7232759446dc7))
-* 添加deb和rpm包的依赖项配置 ([847bcc7](https://github.com/elysia-best/apm-app-store/commit/847bcc7885708a3a2c83f78a951ac3608fc6356c))
-* 添加electron-builder.yml配置文件并更新构建脚本 ([38a4d45](https://github.com/elysia-best/apm-app-store/commit/38a4d4512f3c634e923192f01bbcbd2cc0687634))
-* 添加PolicyKit权限配置和安装/卸载脚本 ([071aa36](https://github.com/elysia-best/apm-app-store/commit/071aa36fb417478d79db0f0e62aebefe573a699a))
-* **deeplink:** implement custom deep link handling and remove electron-app-universal-protocol-client ([c7b3257](https://github.com/elysia-best/apm-app-store/commit/c7b3257a2cefade75a6bc5a82313b38d9acc5d06))
-* **download:** 支持重试下载功能并更新相关逻辑 ([bdf51a1](https://github.com/elysia-best/apm-app-store/commit/bdf51a1037822d117a84a1b2914d6c3c39387d57))
-* **install:** 实现安装管理器，支持安装、检查已安装状态和初步卸载功能 ([bf93059](https://github.com/elysia-best/apm-app-store/commit/bf93059da177c2403c2c6f5b31b8855220d032b2))
-* **install:** add app uninstall functionality ([ac0dc22](https://github.com/elysia-best/apm-app-store/commit/ac0dc225bcd8e202489a0b733449a3d8071a4a60))
-* **install:** added basis install process ([50fb1a0](https://github.com/elysia-best/apm-app-store/commit/50fb1a00658119191a35e98413c13b39d5e5699e))
-* overhaul application to APM 应用商店 with enhanced download management ([9b17c57](https://github.com/elysia-best/apm-app-store/commit/9b17c57c5cb6ef6848fdc83f37d1b4d317e2b9a1))
-
-
-

CONTRIBUTING.md

@@ -1,247 +0,0 @@
-# 贡献指南
-
-感谢您对 APM 应用商店项目的关注！我们欢迎任何形式的贡献。
-
-## 📋 目录
-
-- [行为准则](#行为准则)
-- [如何贡献](#如何贡献)
-- [开发流程](#开发流程)
-- [代码规范](#代码规范)
-- [提交信息规范](#提交信息规范)
-- [Pull Request 流程](#pull-request-流程)
-- [问题报告](#问题报告)
-
-## 行为准则
-
-- 尊重所有贡献者
-- 接受建设性批评
-- 专注于对项目最有利的事情
-- 对社区表现出同理心
-
-## 如何贡献
-
-### 报告 Bug
-
-1. 使用 [Bug 报告模板](.github/ISSUE_TEMPLATE/bug_report.md)
-2. 搜索现有 Issue，避免重复
-3. 提供清晰的重现步骤
-4. 包含相关日志和截图
-
-### 建议新功能
-
-1. 使用 [功能请求模板](.github/ISSUE_TEMPLATE/help_wanted.md)
-2. 解释使用场景和需求
-3. 考虑是否值得投入开发资源
-4. 愿意帮助实现吗？
-
-### 提交代码
-
-1. Fork 项目并创建分支
-2. 编写代码和测试
-3. 确保所有测试通过
-4. 提交 Pull Request
-
-### 改进文档
-
-- 修正错误或不清晰之处
-- 添加示例和教程
-- 翻译文档
-- 提出文档改进建议
-
-## 开发流程
-
-### 环境搭建
-
-```bash
-# 克隆仓库
-git clone https://github.com/elysia-best/apm-app-store.git
-cd apm-app-store
-
-# 安装依赖
-npm install
-
-# 启动开发服务器
-npm run dev
-```
-
-### 创建分支
-
-```bash
-# 功能分支
-git checkout -b feature/your-feature-name
-
-# Bug 修复分支
-git checkout -b fix/your-bug-fix
-```
-
-### 本地开发
-
-1. 遵循 [代码规范](#代码规范)
-2. 编写 [单元测试](TESTING.md)
-3. 运行 `npm run lint` 和 `npm run format`
-4. 运行 `npm run test` 确保测试通过
-
-### 代码审查
-
-- 保持 PR 小而聚焦
-- 添加清晰的描述
-- 引用相关的 Issue
-- 回应审查意见
-
-## 代码规范
-
-### TypeScript
-
-- 使用严格模式 (`strict: true`)
-- 避免使用 `any` 类型（必要时使用 `eslint-disable` 注释）
-- 使用显式类型注解
-- 优先使用 `interface` 而非 `type`
-
-### Vue 3
-
-- 使用 Composition API 和 `<script setup>`
-- 使用 `ref` 和 `computed` 管理状态
-- 遵循 Props 和 Events 模式
-- 组件名使用 PascalCase
-
-### 样式（Tailwind CSS）
-
-- 优先使用 Tailwind 工具类
-- 支持暗色模式（`dark:` 前缀）
-- 响应式设计（`md:`, `lg:` 前缀）
-
-### 命名约定
-
-- **组件:** PascalCase (`AppCard.vue`)
-- **函数:** camelCase (`handleInstall`)
-- **常量:** UPPER_SNAKE_CASE (`SHELL_CALLER_PATH`)
-- **文件:** kebab-case (`install-manager.ts`)
-
-## 提交信息规范
-
-遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范。
-
-### 格式
-
-```
-type(scope): subject
-
-[可选的正文]
-
-[可选的脚注]
-```
-
-### Type 类型
-
-- `feat`: 新功能
-- `fix`: Bug 修复
-- `docs`: 文档更新
-- `style`: 代码格式（不影响功能）
-- `refactor`: 重构
-- `perf`: 性能优化
-- `test`: 测试相关
-- `chore`: 构建/工具相关
-
-### Scope 范围
-
-- `app`: 应用核心
-- `install`: 安装/卸载
-- `ui`: UI 组件
-- `ipc`: IPC 通信
-- `api`: API 集成
-- `theme`: 主题
-- `build`: 构建
-- `docs`: 文档
-
-### Subject 主题
-
-- 使用现在时态（"add" 而非 "added"）
-- 首字母小写
-- 不以句号结尾
-
-### 示例
-
-```bash
-feat(install): add retry mechanism for failed installations
-fix(ui): correct dark mode toggle persistence
-refactor(ipc): simplify install manager event handling
-docs(readme): update build instructions
-test(download): add unit tests for download queue
-```
-
-### 签名（可选）
-
-添加签名以遵守 DCO（Developer Certificate of Origin）：
-
-```bash
-git commit -m "feat(example): add new feature" -s
-```
-
-或在 `~/.gitconfig` 中配置：
-
-```ini
-[commit]
-    gpgsign = true
-```
-
-## Pull Request 流程
-
-### PR 前检查
-
-- [ ] 代码通过 `npm run lint`
-- [ ] 代码通过 `npm run format`
-- [ ] 所有测试通过 (`npm run test`)
-- [ ] 新功能包含测试
-- [ ] 文档已更新（如需要）
-
-### PR 描述
-
-使用 [PR 模板](.github/PULL_REQUEST_TEMPLATE.md)，包括：
-
-1. **变更类型:** feat / fix / refactor 等
-2. **变更描述:** 清晰说明做了什么
-3. **相关 Issue:** 引用 `#123`
-4. **测试说明:** 如何测试这些变更
-5. **截图/录屏:** UI 变更需要
-6. **检查清单:** 完成上述 PR 前检查
-
-### 审查流程
-
-1. 至少一位维护者审查通过
-2. 解决所有审查意见
-3. 确保所有 CI 检查通过
-4. Squash 并合并到 main 分支
-
-### 合并要求
-
-- CI 检查全部通过
-- 至少一次审查批准
-- 无冲突
-- 分支最新
-
-## 问题报告
-
-### Bug 报告
-
-使用 [Bug 报告模板](.github/ISSUE_TEMPLATE/bug_report.md)，包含：
-
-- 描述
-- 复现步骤
-- 期望行为
-- 实际行为
-- 环境信息
-- 截图/日志
-
-### 功能请求
-
-使用 [功能请求模板](.github/ISSUE_TEMPLATE/help_wanted.md)，包含：
-
-- 问题描述
-- 期望的解决方案
-- 替代方案
-- 额外上下文
-
----
-
-**© 2026 APM 应用商店项目**

CREDITS.md

@@ -1,25 +0,0 @@
-# List of referenced projects
-
-1. https://github.com/electron-vite/electron-vite-vue MIT License
-
-    MIT License
-
-    Copyright (c) 2023 草鞋没号
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE.

DEPLOYMENT.md

@@ -1,156 +0,0 @@
-# 部署文档
-
-## 📋 目录
-
-- [构建配置](#构建配置)
-- [打包流程](#打包流程)
-- [发布流程](#发布流程)
-- [CI/CD 工作流](#cicd-工作流)
-- [版本管理](#版本管理)
-
-## 构建配置
-
-### electron-builder.yml
-
-主要配置项：
-
-- **appId:** `store.spark-app.apm`
-- **productName:** `spark-store`
-- **打包格式:** deb, rpm, AppImage
-- **输出目录:** `release/${version}`
-
-### 环境变量
-
-| 变量                  | 说明                     |
-| --------------------- | ------------------------ |
-| `GITHUB_TOKEN`        | GitHub Token（用于发布） |
-| `VITE_DEV_SERVER_URL` | 开发服务器地址           |
-
-## 打包流程
-
-### 本地构建
-
-```bash
-# 构建所有格式
-npm run build
-
-# 仅构建 deb
-npm run build:deb
-
-# 仅构建 rpm
-npm run build:rpm
-
-# 仅构建前端（不打包）
-npm run build:vite
-```
-
-### 构建产物
-
-构建完成后，产物位于：
-
-```
-release/
-└── {version}/
-    ├── spark-store_{version}_linux_amd64.deb
-    ├── spark-store_{version}_linux_amd64.rpm
-    ├── spark-store_{version}_linux_arm64.deb
-    └── spark-store_{version}_linux_arm64.rpm
-```
-
-## 发布流程
-
-### 1. 更新版本号
-
-```bash
-# 更新 package.json 中的版本
-npm version patch  # 1.0.0 → 1.0.1
-npm version minor  # 1.0.0 → 1.1.0
-npm version major  # 1.0.0 → 2.0.0
-```
-
-### 2. 更新 CHANGELOG.md
-
-```bash
-# 生成变更日志
-npm run changelog
-```
-
-### 3. 提交并推送
-
-```bash
-git add .
-git commit -m "chore(release): bump version to x.x.x" -s
-git push origin main
-```
-
-### 4. 创建 Git 标签
-
-```bash
-git tag v{version}
-git push origin v{version}
-```
-
-### 5. 触发 CI 构建
-
-推送标签后会自动触发 GitHub Actions 构建。
-
-### 6. 检查构建结果
-
-在 GitHub Actions 页面查看构建状态。
-
-### 7. 发布到 GitHub Release
-
-构建成功后，GitHub Actions 会自动创建 Release 并上传构建产物。
-
-## CI/CD 工作流
-
-### test.yml
-
-每次推送或 PR 时运行：
-
-- 单元测试
-- E2E 测试
-- Lint 检查
-
-### build.yml
-
-推送到 main 分支或标签时运行：
-
-- 运行测试（前置依赖）
-- 构建 deb 和 rpm 包
-- 支持 x64 和 arm64 架构
-- 标签推送时自动创建 Release
-
-## 版本管理
-
-### 语义化版本
-
-遵循 [Semantic Versioning](https://semver.org/)：
-
-- **MAJOR:** 不兼容的 API 变更
-- **MINOR:** 向后兼容的功能新增
-- **PATCH:** 向后兼容的 Bug 修复
-
-### 版本号示例
-
-```
-4.9.9
- │ └─ PATCH (Bug 修复)
- │   └─ MINOR (新功能)
- └───── MAJOR (重大变更)
-```
-
-### 发布流程检查清单
-
-- [ ] 版本号已更新
-- [ ] CHANGELOG.md 已更新
-- [ ] 所有测试通过
-- [ ] 代码已审查
-- [ ] Lint 检查通过
-- [ ] 构建成功
-- [ ] Release 已创建
-- [ ] 构建产物已上传
-
----
-
-**© 2026 APM 应用商店项目**

DEVELOPMENT.md

@@ -1,380 +0,0 @@
-# 开发文档
-
-## 📋 目录
-
-- [环境搭建](#环境搭建)
-- [项目结构详解](#项目结构详解)
-- [开发工作流](#开发工作流)
-- [调试技巧](#调试技巧)
-- [本地开发最佳实践](#本地开发最佳实践)
-
-## 环境搭建
-
-### 系统要求
-
-- **Node.js:** >= 20.x
-- **npm:** >= 9.x 或 pnpm >= 8.x
-- **操作系统:** Linux（推荐 Ubuntu 22.04+）
-- **可选:** APM 包管理器（用于测试）
-
-### 安装依赖
-
-```bash
-# 克隆仓库
-git clone https://github.com/elysia-best/apm-app-store.git
-cd apm-app-store
-
-# 安装依赖
-npm install
-# 或使用 pnpm
-pnpm install
-```
-
-### 开发服务器启动
-
-```bash
-# 启动开发模式
-npm run dev
-
-# 应用将在以下地址启动
-# Vite 开发服务器: http://127.0.0.1:3344/
-# Electron 窗口将自动打开
-```
-
-### 构建项目
-
-```bash
-# 构建生产版本（deb + rpm）
-npm run build
-
-# 仅构建前端
-npm run build:vite
-
-# 仅构建 deb 包
-npm run build:deb
-
-# 仅构建 rpm 包
-npm run build:rpm
-```
-
-## 项目结构详解
-
-### Electron 主进程
-
-**目录:** `electron/main/`
-
-**核心文件:**
-
-- **`index.ts`** - 主进程入口
-  - 创建应用窗口
-  - 管理 IPC 通信
-  - 处理生命周期事件
-
-- **`backend/install-manager.ts`** - 安装管理器
-  - 管理安装任务队列
-  - 执行 APM 命令
-  - 流式输出日志
-  - 解析安装结果
-
-- **`deeplink.ts`** - Deep Link 处理
-  - 解析 `spk://` 协议
-  - 路由到对应操作
-
-### Vue 渲染进程
-
-**目录:** `src/`
-
-**核心模块:**
-
-- **`App.vue`** - 根组件
-  - 应用状态管理
-  - 分类和应用加载
-  - 模态框协调
-  - Deep Link 监听
-
-- **`components/`** - UI 组件
-  - `AppCard.vue` - 应用卡片
-  - `AppDetailModal.vue` - 应用详情
-  - `DownloadQueue.vue` - 下载队列
-  - 其他 11 个组件
-
-- **`global/`** - 全局状态
-  - `downloadStatus.ts` - 下载队列
-  - `storeConfig.ts` - API 配置
-  - `typedefinition.ts` - 类型定义
-
-- **`modules/`** - 业务逻辑
-  - `processInstall.ts` - 安装/卸载
-
-### 共享模块
-
-**目录:** `electron/global.ts`
-
-- 进程间共享的常量和配置
-- 系统架构检测
-
-### 配置文件
-
-- **`vite.config.ts`** - Vite 构建配置
-- **`electron-builder.yml`** - 打包配置
-- **`tsconfig.json`** - TypeScript 配置
-- **`eslint.config.ts`** - ESLint 配置
-
-## 开发工作流
-
-### 功能开发流程
-
-1. **需求分析**
-   - 理解功能需求
-   - 设计 API 和数据结构
-   - 确定影响范围
-
-2. **创建分支**
-
-   ```bash
-   git checkout -b feature/your-feature
-   ```
-
-3. **实现功能**
-   - 更新类型定义 (`src/global/typedefinition.ts`)
-   - 实现 Vue 组件
-   - 添加 IPC 处理（如需要）
-   - 编写测试
-
-4. **测试**
-
-   ```bash
-   npm run test
-   npm run test:e2e
-   ```
-
-5. **代码检查**
-
-   ```bash
-   npm run lint
-   npm run format
-   ```
-
-6. **提交 PR**
-   - 使用 `feat(scope): description` 格式
-   - 引用相关 Issue
-   - 添加详细描述
-
-### Bug 修复流程
-
-1. **复现 Bug**
-   - 确认 Bug 存在
-   - 添加复现步骤到 Issue
-
-2. **定位问题**
-   - 查看日志
-   - 使用调试器
-   - 检查相关代码
-
-3. **创建分支**
-
-   ```bash
-   git checkout -b fix/your-bug-fix
-   ```
-
-4. **修复代码**
-   - 最小化修改
-   - 添加回归测试
-   - 更新文档（如需要）
-
-5. **验证修复**
-   - 本地测试
-   - 确保测试通过
-
-6. **提交 PR**
-   - 使用 `fix(scope): description` 格式
-   - 说明修复方法
-
-### 重构流程
-
-1. **识别需要重构的代码**
-   - 代码重复
-   - 复杂度过高
-   - 性能问题
-
-2. **制定重构计划**
-   - 不改变外部行为
-   - 逐步进行
-   - 保持测试通过
-
-3. **执行重构**
-
-   ```bash
-   git checkout -b refactor/your-refactor
-   ```
-
-4. **验证**
-   - 所有测试通过
-   - 性能未下降
-   - 代码可读性提升
-
-## 调试技巧
-
-### 主进程调试
-
-**VS Code 配置:**
-
-创建 `.vscode/launch.json`:
-
-```json
-{
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "name": "Electron: Main",
-      "type": "node",
-      "request": "launch",
-      "cwd": "${workspaceFolder}",
-      "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron",
-      "windows": {
-        "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron.cmd"
-      },
-      "args": ["."],
-      "outputCapture": "std"
-    }
-  ]
-}
-```
-
-**日志调试:**
-
-```typescript
-import pino from "pino";
-const logger = pino({ name: "module-name" });
-
-logger.info("Application started");
-logger.error({ err }, "Failed to load apps");
-logger.debug("Debug information");
-```
-
-### 渲染进程调试
-
-**使用 Vue DevTools:**
-
-1. 安装 Vue DevTools 浏览器扩展
-2. Electron 会自动检测
-3. 检查组件树和状态
-
-**控制台日志:**
-
-```typescript
-console.log("Debug:", data);
-console.error("Error:", error);
-console.table(apps);
-```
-
-### IPC 通信调试
-
-**主进程:**
-
-```typescript
-ipcMain.on("test-channel", (event, data) => {
-  console.log("Received:", data);
-  event.sender.send("test-response", { result: "ok" });
-});
-```
-
-**渲染进程:**
-
-```typescript
-window.ipcRenderer.send("test-channel", { test: "data" });
-window.ipcRenderer.on("test-response", (_event, data) => {
-  console.log("Response:", data);
-});
-```
-
-### 性能分析
-
-**Chrome DevTools:**
-
-1. 打开 DevTools (Ctrl+Shift+I)
-2. Performance 面板
-3. 录制并分析
-
-**Vite 分析:**
-
-```bash
-npm run build:vite -- --mode profile
-```
-
-## 本地开发最佳实践
-
-### 代码组织
-
-1. **组件拆分**
-   - 单一职责原则
-   - 组件不超过 300 行
-   - 提取可复用逻辑
-
-2. **状态管理**
-   - 使用 Vue 响应式系统
-   - 全局状态放在 `src/global/`
-   - 组件状态使用 `ref` 和 `computed`
-
-3. **类型定义**
-   - 所有数据结构都有类型
-   - 避免 `any` 类型
-   - 使用 TypeScript 工具类型
-
-### 组件复用
-
-1. **Props 设计**
-   - 明确的类型定义
-   - 合理的默认值
-   - 必填项标注
-
-2. **Events 设计**
-   - 使用 TypeScript 定义
-   - 清晰的事件命名
-
-3. **插槽使用**
-   - 提供灵活的内容布局
-   - 具名插槽增强可用性
-
-### 错误处理
-
-1. **Try-Catch**
-
-   ```typescript
-   try {
-     await someAsyncOperation();
-   } catch (error) {
-     logger.error({ err: error }, "Operation failed");
-     showErrorToUser(error.message);
-   }
-   ```
-
-2. **Promise 错误**
-
-   ```typescript
-   somePromise()
-     .then((result) => {
-       // handle success
-     })
-     .catch((error) => {
-       // handle error
-     });
-   ```
-
-3. **Vue 错误捕获**
-   ```typescript
-   onMounted(() => {
-     window.addEventListener("error", handleError);
-   });
-   ```
-
-### 性能优化
-
-1. **列表虚拟化**（大数据集）
-2. **图片懒加载**
-3. **防抖和节流**
-4. **计算结果缓存**
-
----
-
-**© 2026 APM 应用商店项目**

DOCS/json-api-doc.md

@@ -0,0 +1,48 @@
+# 基本格式
+0. 应用信息
+
+例子：https://cdn.d.store.deepinos.org.cn/store/tools/spark-store/app.json
+
+```json
+{
+    "Name": "星火应用商店",
+    "Version": "4.2.7.1",
+    "Filename": "spark-store_4.2.7.1_amd64.deb",
+    "Torrent_address": "spark-store_4.2.7.1_amd64.deb.torrent",
+    "Pkgname": "spark-store",
+    "Author": "shenmo <shenmo@spark-app.store>",
+    "Contributor": "shenmo <jifengshenmo@outlook.com>",
+    "Website": "https://www.spark-app.store/",
+    "Update": "2023-09-01 23:22:23",
+    "Size": "590.5 KB",
+    "More": "* 修复：aptss加锁失败现在会正常报错\n  * 新增：在aptss的特定操作时添加了提示\n  * 新增：在aptss提示加粗\n  * 调整：ssinstall验证支持使用cdn.d.获取",
+    "Tags": "community;ubuntu;deepin;uos;dtk5",
+    "img_urls": "[\"https://examine-spark.oss-cn-shanghai.aliyuncs.com/images/2023/09/01/411c32fd691544bb985ecba87d151ea0.png\",\"https://examine-spark.oss-cn-shanghai.aliyuncs.com/images/2023/09/01/f44b3c2242c045e28f1161980d805e0d.png\",\"https://examine-spark.oss-cn-shanghai.aliyuncs.com/images/2023/09/01/00263ba857894667bd99240558bec69c.png\",\"https://examine-spark.oss-cn-shanghai.aliyuncs.com/images/2023/09/01/6fd248ad9eea4ef18c9c4acc2a9d372d.png\"]",
+    "icons": "https://examine-spark.oss-cn-shanghai.aliyuncs.com/icons/2023/09/01/a88dd18cc1734396a02e7e3c6be59718.png"
+}
+```
+
+*注意：img_urls和icons的信息不保证有效！大部分是有效的，少部分app.json可能缺失此项目！*
+
+**对于icon和截图的获取需求请参考第三点**
+
+1. 对于某分类下的所有应用信息
+`{SOURCE_URL}/{ARCH}/{CATOGARY}/applist.json`
+说明：SOURCE_URL：线路链接，目前推荐 https://cdn.d.store.deepinos.org.cn，你也可以使用其他的星火线路
+ARCH：架构文件夹 x86是store或amd64-store，arm是aarch64-store。特别的，如果你使用非https://cdn.d.store.deepinos.org.cn的线路，你可能会发现amd64-store会返回404，因为不是所有的服务器都支持软连接
+CATOGARY：分类目录。参考 https://gitee.com/deepin-community-store/spark-store/blob/dev/DOCS/spk-doc.md 中 store 直达的对应关系
+
+例子：https://cdn.d.store.deepinos.org.cn/aarch64-store/tools/applist.json
+
+2. 对于单个应用的应用信息
+`{SOURCE_URL}/{ARCH}/{CATOGARY}/{Package Name}/app.json`
+Package Name是包名。可从上级的applist.json读取
+
+例子：https://cdn.d.store.deepinos.org.cn/store/tools/spark-store/app.json
+
+3. 对应用截图和icon的获取
+
+`{SOURCE_URL}/{ARCH}/{CATOGARY}/{Package Name}/icon.png`
+`{SOURCE_URL}/{ARCH}/{CATOGARY}/{Package Name}/screen_n.png`(n=1-5)(至少为1，不是所有的都有到5. 404是正常的）
+
+

DOCS/spk-doc.md

@@ -0,0 +1,34 @@
+#### 调用参数(spk规则)
+
+* store直达
+
+该url应当遵循这种格式：`spk://store/web分类/包名`
+
+
+
+例如:
+
+[spk://store/games/store.spark-app.hmcl](spk://store/games/store.spark-app.hmcl)
+
+
+可选的web分类：
+
+| 分类名称 | web分类   　    |
+| -------- | -------------- |
+| 网络 | network        |
+| 社交 | chat           |
+| 音乐 | music          |
+| 视频 | video          |
+| 图像 | image_graphics       |
+| 游戏 | games          |
+| 办公 | office         |
+| 阅读 | reading        |
+| 开发 | development    |
+| 工具 | tools          |
+| 主题 | themes       |
+| 其他 | others         |
+
+
+* search搜索
+
+spk://search/pkgname

DOCS/write-preview-skeleton.md

@@ -0,0 +1,82 @@
+# 关于编写 "描述主体结构预览说明" 的规范
+
+1. 主体结构预览
+
+    一般以 `tree` 命令进行获取目录结构进行展示所需要描述的预览内容。
+
+2. 对主体结构中的内容单独说明
+    
+    并使用所用语言进行非侵入式独立描述，而不是在代码中填充说明与注释。
+    
+    在单行描述中，尽量不超过您认为最大的字符数量宽度，可以收缩内容的重要性。
+
+    在此种说明文档中，尽量使用您所描述的对象支持的代码注释，而不是以白底黑字进行描述。
+
+    对于规范的全部：主体结构 + 单独内容中进行简单(而不是简少)的说明。
+
+一个简单的例子，例如: 有关项目源代码结构的预览说明
+
+- 项目结构预览
+
+    ```
+    .
+    ├── assets
+    ├── debian
+    ├── DOCS
+    ├── patchs
+    ├── src
+    ├── tool
+    └── translations
+
+    10 directories, 9 files
+    ```
+
+- 来自 debian 目录的说明
+
+    ```shell
+    # 将此项目进行 debian 的标志，基于 debian 系列的发行版可对包含
+    # 此种目录的开源项目进行构建 deb 软件包。
+
+    # 1. 构建软件包(打包)
+    # 执行 dpkg-buildpackage 命令以尝试构建此软件包
+    dpkg-buildpackage
+    # 如果构建将会在上级目录中产生一个 deb，而源代码目录不会有任何变化。
+    
+    # 如果出现以下内容可忽视，仅需要查看是否已成功构建软件包:
+        # gpg: 已跳过 ""： 无效的用户ID 
+        # gpg: ...: clear-sign failed: 无效的用户ID
+        # dpkg-buildpackage: error: failed to sign .dsc file
+    ```
+
+- 来自 patchs 目录的说明
+
+    ```shell
+    # 一种用于可扩展的补丁，主要目的是为项目提供可选的应用方案，而不是直接堆砌到
+    # 当前项目的分支中。您可以认为所有分支都是主线分支。
+    # 例如:
+        # 主线稳定分支: master
+        # 主线开发分支: dev
+        # 主线其它:    ...
+
+    # 注意:
+    #   当您认为您所提交的内容并不会为主线带来 bug fix 之类的内容，请使用补丁。
+    #   当您所提交的内容会带来不可预知的问题的时候，或会改变目前主线的开发模式时，
+    #   此种方式可确保您提交的方案可被任意时间被弃用，而不是由其它维护者耗费精力
+    #   去试图移除您提交的内容，而不是等待由提交者进行新的维护。
+    ```
+
+- 来自其它的内容...可随时由任何人进行补充
+
+
+- 一些在关此种预览描述的文档
+
+    ```shell
+    # 此种描述还将出现在 `src/README.md` 的描述中。
+    # 当然，我预期会由其它维护者进行移动到 `DOCS` 之下。
+    
+    # 另外在 `patchs/zinface-community-cmake-build-system.patch` 补丁文件中，
+    # 也随附过一个简要的文档内容，而它是记录了 `Spark` 为名的构建模式。
+    
+    # 在未应用此补丁时，将不会出现在任何地方。
+    ```
+    

DOCS/内网部署.md

@@ -0,0 +1,7 @@
+需要修改的内容：商店默认源位置，aptss获取apt-fast.conf和sparkstore.list的地址，ssinstall做安装检查的源位置
+
+服务器使用update.sh进行同步。
+
+为方便使用（其实是早期屎山使然），请将仓库放置于 `/home/ftp/spark-store`
+
+仓库管理相关代码请移步 [这里](https://gitee.com/deepin-community-store/repo_auto_update_script)，update.sh请联系 @shenmo 获取

EULA

@@ -0,0 +1,41 @@
+星火开源软件协议（Spark Opensource LICENSE）
+
+版权所有 (C) 2023 星火社区
+
+根据 GNU 通用公共许可证第三版（GPL v3），本软件是自由软件，您可以修改和再发布它。但是，为了维护原作者的权益并保护社区用户的权益，请遵守以下条款：
+
+1. 对本仓库下的所有文件生效：本许可证适用于本仓库（或项目）下的所有文件。任何使用、修改或再发布本软件的个人或组织都必须遵守本许可证。
+2. 版权声明和许可证文件：您不得移除、隐藏或更改本软件中包含的原作者的版权声明和许可证文件。保留原作者的权益信息对于维护开源软件生态系统至关重要。
+3. 版本标注： 如果您对本软件做出修改并再发布，您必须在醒目位置标注此版本并非星火社区官方提供。这样可以避免误导使用者认为该软件为星火社区官方提供的版本。此软件仅授权用于个人非盈利用途，任何将其用于商业目的或在盈利性组织中使用的行为均需事先获得星火社区的书面许可。
+4. 商标使用：您不得在再发布版本中使用“星火应用商店”、“Spark Store”或星火应用商店的Logo等可能误导使用者此软件由星火社区官方提供的信息。
+5. 服务条款：您使用星火商店软件的行为将被视为您同意星火在不侵犯您隐私的前提下搜集版本、日志等信息，以便于星火社区更好地为您提供服务。
+6. 仓库版权条款：为了更好的提供持续性服务，星火仅对个人用户免费开放服务仓库，如您或您的组织需要提供商业服务或者您的组织为盈利性组织，请联系星火社区获取商业授权。
+7. 禁止恶意行为和批量爬取： 用户或组织在使用本软件时，严禁进行任何形式的恶意行为，包括但不限于恶意攻击、滥用、破坏、批量爬取软件仓库等。恶意行为的定义由星火社区自行判断，违反者将被追究法律责任。
+8. 分发与再分发权利： 星火社区保留对其制作的软件包的分发权利。未经明确授权，禁止任何个人或组织将星火社区软件包用于商业目的或在未获得星火社区许可的情况下进行再分发。此条款旨在确保开源精神的同时，维护星火社区的知识产权。
+9. 商业应用限制：您不得使用本软件的代码开发商业应用，也不得在商业应用中使用本软件的代码，除非获得星火社区和火穗（沈阳）计算机软件开发有限公司的书面许可。
+10. 其他条款：除上述约定外，若您使用了星火商店的主程序或其部分代码，您应遵守 GPL v3 的所有其他条款和要求。若本协议条款的内容与GPL V3中的内容不同的，以本协议条款为准
+11. 其他约定：本许可以简体中文版本为最准确释义
+
+GPLV3许可证的完整文本可以在以下链接找到：https://www.gnu.org/licenses/gpl-3.0.html
+
+---------------------------------------------------------------------------------------------------------------------------------
+
+Spark Opensource LICENSE
+
+Copyright (C) 2023 The Spark Community
+
+This software is free software; you can modify and redistribute it under the terms of the GNU General Public License version 3 (GPL v3). However, to protect the rights of the original authors and the interests of the community users, please adhere to the following terms:
+
+1. Applicability to all files in this repository: This license applies to all files in this repository (or project). Any individuals or organizations that use, modify, or redistribute this software must comply with this license.
+2. Copyright notice and license files: You must not remove, hide, or modify the copyright notice and license files of the original authors included in this software. Preserving the rights information of the original authors is essential for maintaining the open-source software ecosystem.
+3. Version annotation: If you modify and redistribute this software, you must mark in a prominent position that this version is not officially provided by the Spark community. This avoids misleading users into thinking that the software is an official version provided by the Spark community. This software is licensed for personal, non-profit use only, and any use of it for commercial purposes or in for-profit organizations requires the prior written permission of the Spark Community.
+4. Trademark usage: You are not allowed to use terms such as "Spark App Store," "Spark Store," or the logo of Spark App Store in redistributed versions, as they may mislead users into believing that the software is provided by the official Spark community.
+5. Terms of Service: Your use of the software of Spark Store will be deemed as your consent to collect version, log and other information on the premise of not violating your privacy, so as to facilitate the Spark community to provide you with better services.
+6. Warehouse copyright terms: In order to better provide continuous services, Spark is only free for individual users to open the service warehouse, if you or your organization needs to provide commercial services or your organization is a for-profit organization, please contact Spark community to obtain commercial authorization.
+7. Prohibited malicious behavior and mass crawling: Users or organizations are strictly prohibited to engage in any form of malicious behavior when using the software, including but not limited to malicious attacks, abuse, destruction, and mass crawling of software warehouses. The definition of malicious behavior is judged by the Spark community, and violators will be held legally responsible.
+8. Distribution and redistribution rights: Spark Community reserves the right to distribute the software packages it produces. Any person or organization is prohibited from using the Spark Community software package for commercial purposes or redistributing it without the express authorization of the Spark Community. This clause is intended to ensure the spirit of open source while safeguarding the intellectual property rights of the Spark community.
+9. Business Application Restriction: You are not permitted to utilize the code of this software for developing commercial applications, nor are you allowed to integrate the code of this software into commercial applications without obtaining written consent from both the Spark Community and Flamescion (Shenyang) Computer Software Development Co., Ltd.
+10. Other Terms: In addition to the above provisions, if you use the main program or any part of the code of Spark Store, you must comply with all other terms and requirements of GPL v3. In case of any inconsistency between the terms of this agreement and those of GPL v3, the terms of this agreement shall prevail.
+11. Additional Agreements: This license shall be interpreted most accurately in its Simplified Chinese version.
+
+You can find the full text of GPLV3 license at: https://www.gnu.org/licenses/gpl-3.0.html

FAQ.md

@@ -1,154 +1,91 @@
-# 常见问题 (FAQ)
+# FAQ
+## Spark App Store FAQ and Support Guide
 
-## 基本问题
-
-### Q: APM 应用商店是什么？
-
-**A:** APM 应用商店是基于 Electron + Vue 3 构建的桌面应用商店客户端，用于 APM (AmberPM) 包管理器的图形化界面。
-
-### Q: 支持哪些操作系统？
-
-**A:** 目前支持 Linux 系统，包括但不限于：
-
-- Ubuntu 20.04+
-- Debian 11+
-- Fedora 35+
-- Arch Linux
-- 银河麒麟
-- 统信 UOS
-
-### Q: 如何安装 APM 应用商店？
-
-**A:**
-
-1. 从 GitHub Releases 下载 deb 或 rpm 包
-2. 使用包管理器安装：
-
-   ```bash
-   # Debian/Ubuntu
-   sudo dpkg -i spark-store_*.deb
-
-   # Fedora/RHEL
-   sudo dnf install spark-store_*.rpm
-   ```
-
-### Q: 需要 APM 包管理器吗？
-
-**A:** 是的，APM 应用商店需要 APM 包管理器才能工作。请先安装 APM。
-
-## 使用问题
-
-### Q: 如何安装应用？
-
-**A:**
-
-1. 打开 APM 应用商店
-2. 浏览或搜索应用
-3. 点击应用卡片查看详情
-4. 点击"安装"按钮
-5. 等待安装完成
-
-### Q: 如何卸载应用？
-
-**A:**
-
-1. 点击右上角"已安装"按钮
-2. 在列表中找到要卸载的应用
-3. 点击"卸载"按钮
-4. 确认卸载
-
-### Q: 如何更新应用？
-
-**A:**
-
-1. 点击右上角"更新"按钮
-2. 选择要更新的应用
-3. 点击"更新"按钮
-4. 等待更新完成
-
-### Q: 下载的应用在哪里？
-
-**A:**
-应用下载后存储在 APM 管理的目录中，通常位于：
-
-```
-/opt/spark-store/apps/{pkgname}/
-```
-
-## 技术问题
-
-### Q: 应用无法启动怎么办？
-
-**A:** 请参考 [问题排查指南](TROUBLESHOOTING.md)。
-
-### Q: 如何查看日志？
-
-**A:**
-日志位置：
-
-- 主进程日志：`~/.config/spark-store/logs/`
-- 系统日志：`journalctl -u spark-store`
-
-### Q: 如何切换主题？
-
-**A:**
-点击右上角主题切换按钮，或按 `Ctrl+Shift+T`。
-
-### Q: 支持深色模式吗？
-
-**A:** 是的，支持亮色、暗色和跟随系统主题。
-
-## 开发问题
-
-### Q: 如何参与开发？
-
-**A:** 请参考 [贡献指南](CONTRIBUTING.md)。
-
-### Q: 如何运行开发版本？
-
-**A:**
-
-```bash
-git clone https://github.com/elysia-best/apm-app-store.git
-cd apm-app-store
-npm install
-npm run dev
-```
-
-### Q: 技术栈是什么？
-
-**A:**
-
-- Electron 40.0.0
-- Vue 3
-- Vite 6.4.1
-- TypeScript
-- Tailwind CSS 4.1.18
-
-### Q: 如何报告 Bug？
-
-**A:**
-请在 [GitHub Issues](https://github.com/elysia-best/apm-app-store/issues) 提交 Bug 报告。
-
-## 其他问题
-
-### Q: 可以在 Windows/Mac 上使用吗？
-
-**A:** 目前不支持，但计划在未来添加跨平台支持。
-
-### Q: 如何获取帮助？
-
-**A:**
-
-- 查看 [文档](README.md)
-- 提交 [Issue](https://github.com/elysia-best/apm-app-store/issues)
-- 加入 [社区论坛](https://bbs.spark-app.store/)
-
-### Q: 许可证是什么？
-
-**A:**
-本项目采用 [GPL-3.0](LICENSE.md) 协议开源。
+### Introduction
+The Spark App Store is an application store aimed at Linux users and supports multiple Linux distributions. Below are some commonly asked questions and solutions. Please note that this document is primarily intended for ordinary users who are not familiar with Linux and the APT package management system.
 
 ---
 
-**© 2026 APM 应用商店项目**
+### Communication and Feedback
+**Q: Where can I join the community group?**  
+**A:** You can click [here](https://www.deepinos.org/) to enter the main communication platform of the Spark Store.  
+> ⚠️ If the above link doesn't work, you can also join our QQ groups as an alternative. The group numbers are 872690351 and 865927727. We also offer forums for communication.
+
+#### Differences Between arm64 and amd64
+
+arm64
+
+* Full Name: Advanced RISC Machine 64-bit
+* Main Use: Primarily used in mobile devices, embedded systems, and some new servers and desktop computers.
+* Advantages: Low power consumption, high efficiency, suitable for battery-driven and heat-sensitive devices.
+* Main Manufacturers: Apple, Qualcomm, HiSilicon, Phytium, etc.
+
+amd64
+
+* Full Name: AMD 64-bit, also known as x86_64
+* Main Use: Primarily used in desktop computers, laptops, and servers.
+* Advantages: High performance, suitable for computation-intensive applications.
+* Main Manufacturers: Intel and AMD.
+* The main differences between the two are in the instruction sets and application scenarios. amd64 is usually used for high-performance computers and servers, while arm64 is more commonly used in power-sensitive settings.
+
+#### How to Check:
+
+Linux:
+
+- Open the terminal.
+- Type `uname -m` or `arch` and press Enter.
+- You will see your processor architecture (possibly x86_64, aarch64, etc.).
+
+---
+
+### Domestic Architecture Support
+**Q: I use a domestic chip architecture, how can I get applications?**  
+**A:** Currently, Spark Store supports **arm** architecture for domestic chips. You can download deb packages suitable for arm64 architecture.  
+> ⚠️ Please note that this is experimental support. If you encounter any issues, please provide feedback via Spark's communication platform, QQ group, or forums.
+
+---
+
+### Dependency Issues
+**Q: I get errors when installing dependencies**  
+**A:** If you are using UOS or deepin, please do not install the dependency packages. For Kali Linux/Kdeneon etc., temporary support is not available, please compile and install yourself.  
+> 💡 If errors occur, try running `sudo apt update` before attempting the installation again. If the issue persists, refer to the first question and seek help on the community platform.
+
+---
+
+### Submission and App Updates
+**Q: Where can I submit applications?**  
+**A:** You can find the "Submit Application" option in the upper-right corner menu of the app store interface.
+
+---
+
+### Support for Non-deepin/UOS Users
+**Q: I'm not a deepin/UOS user; can I use the Spark App Store?**  
+**A:** Yes, you can directly install if you're using Ubuntu 22.04. For Ubuntu 20.04/Debian10/Debian11, please install the dependencies first.
+
+---
+
+### Installation Methods
+**Q: Can I use dpkg -i for installation?**  
+**A:** No! Use `sudo apt install ./xxxx.deb` to install, or use graphical installers like gdebi.  
+> ⚠️ Using dpkg directly will not handle software dependencies, which is a common mistake.
+
+---
+
+### System Updates
+**Q: Will the Spark Store affect normal system updates?**  
+**A:** No, the Spark Store has separated its application sources from system sources and will not affect regular system updates.
+
+---
+
+### Reporting Issues and Removing Apps
+**Q: Some apps are outdated or inactive, and I want them removed**  
+**A:** You can report issues [here](https://gitee.com/deepin-community-store/software_-issue).
+
+---
+
+### Installing Spark App Store
+If you wish to install the Spark App Store, please visit the [Release page](https://gitee.com/deepin-community-store/spark-store/releases), find the latest version, and choose the package suitable for your current system.
+
+> ⚠️ Special Note: If you are using Debian10/Debian11 or Ubuntu 20.04, you may need to download additional dependency packages. After downloading, unzip multiple times until you see the software user guide. For operating systems later than Ubuntu 22.04, you do not need to install dependency packages. Just follow the steps above to install the main program directly.
+
+---

FAQ.zh.md

@@ -0,0 +1,90 @@
+# FAQ
+## 星火应用商店FAQ与支持指南
+
+### 简介
+星火应用商店是一个面向 Linux 用户的应用商店，支持多种不同的 Linux 发行版。以下是一些常见问题及解决方案。请注意，该文档主要面向对 Linux 和 APT 软件包管理系统不熟悉的普通用户。
+
+---
+
+### 交流与反馈
+**Q: 在哪进交流群？**  
+**A:** 你可以点击[这里](https://www.deepinos.org/)进入星火商店的主交流平台。  
+> ⚠️ 如果上面的链接无法使用，你还可以加入我们的 QQ 群作为备选方案，群号是 872690351 和 865927727。我们还提供论坛作为交流平台。
+
+arm64与amd64的区别
+
+arm64
+
+* 全称: Advanced RISC Machine 64-bit
+* 主要用途: 主要应用于移动设备、嵌入式系统以及一些新型的服务器和桌面计算机。
+* 优势: 低功耗、高效率，适合用在电池驱动和热敏感的设备。
+* 主要生产商: 苹果、高通、海思、飞腾等。
+
+amd64
+
+* 全称: AMD 64-bit, 也被称为 x86_64
+* 主要用途: 主要应用于桌面计算机、笔记本以及服务器。
+* 优势: 高性能，适用于计算密集型应用。
+* 主要生产商: Intel和AMD。
+* 两者最主要的不同在于指令集和应用场景。amd64通常用于高性能需求的计算机和服务器，而arm64则更多应用于功耗要求更严格的场合。
+
+查看方法：
+
+Linux：
+
+- 打开终端。
+- 输入 uname -m 或 arch 并按回车。
+- 你将看到你的处理器架构（可能是 x86_64, aarch64 等）。
+---
+
+### 国产架构支持
+**Q: 我是国产架构，怎么获取应用？**  
+**A:** 目前，星火商店支持**arm**架构的国产芯片。你可以下载适用于 arm64 架构的deb包（软件安装包）。  
+> ⚠️ 请注意，这是实验性的支持。如果遇到问题，请在星火交流平台、QQ群或论坛向我们反馈。
+
+---
+
+### 安装依赖问题
+**Q: 安装依赖包出现错误**  
+**A:** 如果你使用UOS或deepin，请不要安装依赖包。对于Kali Linux/Kdeneon等，暂时不支持，请自行编译安装。  
+> 💡 出现错误时，尝试运行 `sudo apt update` 后再尝试安装。如果问题仍然存在，请参考第一条，进入交流平台寻求帮助。
+
+---
+
+### 投稿与应用更新
+**Q: 在哪里投稿？**  
+**A:** 你可以在应用商店界面的右上角菜单找到“投递应用”的选项。
+
+---
+
+### 非deepin/UOS用户支持
+**Q: 我不是deepin/UOS用户，可以使用星火应用商店吗？**  
+**A:** 可以，如果你是使用 Ubuntu 22.04，请直接安装。对于 Ubuntu 20.04/Debian10/Debian11，请先安装依赖包。
+
+---
+
+### 安装方法
+**Q: 我可以用dpkg -i安装吗？**  
+**A:** 不可以！使用 `sudo apt install ./xxxx.deb` 来安装，或者使用gdebi等图形化的安装器。  
+> ⚠️ 直接使用dpkg是不会处理软件依赖的，这是一个常见的错误。
+
+---
+
+### 系统更新
+**Q: 星火商店会影响系统正常更新吗？**  
+**A:** 不会，星火商店已经将应用源与系统源分开，不会影响系统的正常更新。
+
+---
+
+### 报告问题和应用下架
+**Q: 有些应用已经过时或者失效了，我想让他下架**  
+**A:** 你可以前往 [这里](https://gitee.com/deepin-community-store/software_-issue) 报告问题。
+
+---
+
+### 安装星火应用商店
+如果你想安装星火应用商店，请打开[Release页面](https://gitee.com/deepin-community-store/spark-store/releases)，找到最新版本，并选择适用于当前系统的安装包下载。
+
+> ⚠️ 特别提示: 如果你在使用 Debian10/Debian11 或 Ubuntu 20.04，你可能额外下载依赖补充包。您需要在下载完依赖包后，解压多次一直到看到内部的软件使用说明，对于 Ubuntu22.04 以后的操作系统版本，您无需安装依赖包，您需要按照上面的操作直接安装本体程序。
+
+---

Jenkinsfile

@@ -0,0 +1,33 @@
+pipeline {
+  agent any
+  stages {
+    stage('build') {
+      agent {
+        docker {
+          image 'jerry979/dtke:5.11.1'
+        }
+
+      }
+      steps {
+        sh 'mkdir build && cd build && qmake .. && make '
+        archiveArtifacts(artifacts: 'build/src/spark-store', allowEmptyArchive: true, defaultExcludes: true)
+      }
+    }
+
+    stage('send') {
+      agent {
+        dockerfile {
+          filename '.gitee/Dockerfile'
+        }
+
+      }
+      environment {
+        gitee_token = credentials('1')
+      }
+      steps {
+        sh "python3 .gitee/callback.py"
+      }
+    }
+
+  }
+}

LICENSE

@@ -1,7 +1,7 @@
                     GNU GENERAL PUBLIC LICENSE
                        Version 3, 29 June 2007
 
- Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
  Everyone is permitted to copy and distribute verbatim copies
  of this license document, but changing it is not allowed.
 
@@ -645,7 +645,7 @@ the "copyright" line and a pointer to where the full notice is found.
     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/>.
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 Also add information on how to contact you by electronic and paper mail.
 
@@ -664,11 +664,11 @@ 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/>.
+<http://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>.
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.

LICENSE.md

@@ -1,127 +0,0 @@
-# 木兰宽松许可证, 第2版
-
-您对"软件"的复制、使用、修改及分发受木兰宽松许可证，第2版（"本许可证"）的如下条款的约束：
-
-## 0. 定义
-"软件" 是指由"贡献"构成的许可在"本许可证"下的程序和相关文档的集合。
-
-"贡献" 是指由任一"贡献者"许可在"本许可证"下的受版权法保护的作品。
-
-"贡献者" 是指将受版权法保护的作品许可在"本许可证"下的自然人或"法人实体"。
-
-"法人实体" 是指提交贡献的机构及其"关联实体"。
-
-"关联实体" 是指，对"本许可证"下的行为方而言，控制、受控制或与其共同受控制的机构，此处的控制是指有受控方或共同受控方至少50%直接或间接的投票权、资金或其他有价证券。
-
-## 1. 授予版权许可
-每个"贡献者"根据"本许可证"授予您永久性的、全球性的、免费的、非独占的、不可撤销的版权许可，您可以复制、使用、修改、分发其"贡献"，不论修改与否。
-
-## 2. 授予专利许可
-每个"贡献者"根据"本许可证"授予您永久性的、全球性的、免费的、非独占的、不可撤销的（根据本条规定撤销除外）专利许可，供您制造、委托制造、使用、许诺销售、销售、进口其"贡献"或以其他方式转移其"贡献"。前述专利许可仅限于"贡献者"现在或将来拥有或控制的其"贡献"本身或其"贡献"与许可"贡献"时的"软件"结合而将必然会侵犯的专利权利要求，不包括对"贡献"的修改或包含"贡献"的其他结合。如果您或您的"关联实体"直接或间接地，就"软件"或其中的"贡献"对任何人发起专利侵权诉讼（包括反诉或交叉诉讼）或其他专利维权行动，指控其侵犯专利权，则"本许可证"授予您对"软件"的专利许可自您提起诉讼或发起维权行动之日终止。
-
-## 3. 无商标许可
-"本许可证"不提供对"贡献者"的商品名称、商标、服务标志或产品名称的商标许可，但您为满足第4条规定的声明义务而必须使用除外。
-
-## 4. 分发限制
-您可以在任何媒介中将"软件"以源程序形式或可执行形式重新分发，不论修改与否，但您必须向接收者提供"本许可证"的副本，并保留"软件"中的版权、商标、专利及免责声明。
-
-## 5. 免责声明与责任限制
-"软件"及其中的"贡献"在提供时不带任何明示或默示的担保。在任何情况下，"贡献者"或版权所有者不对任何人因使用"软件"或其中的"贡献"而引发的任何直接或间接损失承担责任，不论因何种原因导致或者基于何种法律理论，即使其曾被建议有此种损失的可能性。
-
-## 6. 语言
-"本许可证"以中英文双语表述，中英文版本具有同等法律效力。如果中英文版本存在任何冲突不一致，以中文版为准。
-
-条款结束
-
-如何将木兰宽松许可证，第2版，应用到您的软件
-
-如果您希望将木兰宽松许可证，第2版，应用到您的新软件，为了方便接收者查阅，建议您完成如下三步：
-
-1， 请您补充如下声明中的空白，包括软件名、软件的首次发表年份以及您作为版权人的名字；
-
-2， 请您在软件包的一级目录下创建以"LICENSE"为名的文件，将整个许可证文本放入该文件中；
-
-3， 请将如下声明文本放入每个源文件的头部注释中。
-
-Copyright (c) 2026-present The Spark Project Contributors
-
-apm-store is licensed under Mulan PSL v2.
-
-You can use this software according to the terms and conditions of the Mulan PSL v2.
-
-You may obtain a copy of Mulan PSL v2 at:
-
-http://license.coscl.org.cn/MulanPSL2
-
-THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
-
-EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
-
-MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
-
-See the Mulan PSL v2 for more details.
-
-
-
-# Mulan Permissive Software License，Version 2
-
-Your reproduction, use, modification and distribution of the Software shall be subject to Mulan PSL v2 (this License) with the following terms and conditions:
-
-## 0. Definition
-Software means the program and related documents which are licensed under this License and comprise all Contribution(s).
-
-Contribution means the copyrightable work licensed by a particular Contributor under this License.
-
-Contributor means the Individual or Legal Entity who licenses its copyrightable work under this License.
-
-Legal Entity means the entity making a Contribution and all its Affiliates.
-
-Affiliates means entities that control, are controlled by, or are under common control with the acting entity under this License, 'control' means direct or indirect ownership of at least fifty percent (50%) of the voting power, capital or other securities of controlled or commonly controlled entity.
-
-## 1. Grant of Copyright License
-Subject to the terms and conditions of this License, each Contributor hereby grants to you a perpetual, worldwide, royalty-free, non-exclusive, irrevocable copyright license to reproduce, use, modify, or distribute its Contribution, with modification or not.
-
-## 2. Grant of Patent License
-Subject to the terms and conditions of this License, each Contributor hereby grants to you a perpetual, worldwide, royalty-free, non-exclusive, irrevocable (except for revocation under this Section) patent license to make, have made, use, offer for sale, sell, import or otherwise transfer its Contribution, where such patent license is only limited to the patent claims owned or controlled by such Contributor now or in future which will be necessarily infringed by its Contribution alone, or by combination of the Contribution with the Software to which the Contribution was contributed. The patent license shall not apply to any modification of the Contribution, and any other combination which includes the Contribution. If you or your Affiliates directly or indirectly institute patent litigation (including a cross claim or counterclaim in a litigation) or other patent enforcement activities against any individual or entity by alleging that the Software or any Contribution in it infringes patents, then any patent license granted to you under this License for the Software shall terminate as of the date such litigation or activity is filed or taken.
-
-## 3. No Trademark License
-No trademark license is granted to use the trade names, trademarks, service marks, or product names of Contributor, except as required to fulfill notice requirements in section 4.
-
-## 4. Distribution Restriction
-You may distribute the Software in any medium with or without modification, whether in source or executable forms, provided that you provide recipients with a copy of this License and retain copyright, patent, trademark and disclaimer statements in the Software.
-
-## 5. Disclaimer of Warranty and Limitation of Liability
-THE SOFTWARE AND CONTRIBUTION IN IT ARE PROVIDED WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED. IN NO EVENT SHALL ANY CONTRIBUTOR OR COPYRIGHT HOLDER BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING, BUT NOT LIMITED TO ANY DIRECT, OR INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING FROM YOUR USE OR INABILITY TO USE THE SOFTWARE OR THE CONTRIBUTION IN IT, NO MATTER HOW IT'S CAUSED OR BASED ON WHICH LEGAL THEORY, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
-
-## 6. Language
-THIS LICENSE IS WRITTEN IN BOTH CHINESE AND ENGLISH, AND THE CHINESE VERSION AND ENGLISH VERSION SHALL HAVE THE SAME LEGAL EFFECT. IN THE CASE OF DIVERGENCE BETWEEN THE CHINESE AND ENGLISH VERSIONS, THE CHINESE VERSION SHALL PREVAIL.
-
-END OF THE TERMS AND CONDITIONS
-
-How to Apply the Mulan Permissive Software License，Version 2 (Mulan PSL v2) to Your Software
-
-To apply the Mulan PSL v2 to your work, for easy identification by recipients, you are suggested to complete following three steps:
-
-i. Fill in the blanks in following statement, including insert your software name, the year of the first publication of your software, and your name identified as the copyright owner;
-
-ii. Create a file named "LICENSE" which contains the whole context of this License in the first directory of your software package;
-
-iii. Attach the statement to the appropriate annotated syntax at the beginning of each source file.
-
-Copyright (c) 2026-present The Spark Project Contributors
-
-apm-store is licensed under Mulan PSL v2.
-
-You can use this software according to the terms and conditions of the Mulan PSL v2.
-
-You may obtain a copy of Mulan PSL v2 at:
-
-http://license.coscl.org.cn/MulanPSL2
-
-THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
-
-EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
-
-MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
-
-See the Mulan PSL v2 for more details.

PROJECT_ORGANIZATION_SUMMARY.md

@@ -1,229 +0,0 @@
-# 项目整理完成总结
-
-## ✅ 完成的工作
-
-### 1. 核心文档（3个文件）
-
-| 文件            | 状态              | 说明                        |
-| --------------- | ----------------- | --------------------------- |
-| AGENTS.md       | ✅ 已替换为中文版 | 完整的 AI 编码指南（894行） |
-| CONTRIBUTING.md | ✅ 新建           | 贡献指南（中文）            |
-| DEVELOPMENT.md  | ✅ 新建           | 开发文档（中文）            |
-
-### 2. 工作流文档（9个文件）
-
-| 文件                                          | 说明           |
-| --------------------------------------------- | -------------- |
-| .agents/workflows/feature-development.md      | 新功能开发流程 |
-| .agents/workflows/bug-fix.md                  | Bug 修复流程   |
-| .agents/workflows/code-review.md              | 代码审查流程   |
-| .agents/workflows/testing.md                  | 测试编写流程   |
-| .agents/workflows/release.md                  | 发布流程       |
-| .agents/workflows/refactoring.md              | 代码重构流程   |
-| .agents/workflows/documentation.md            | 文档更新流程   |
-| .agents/workflows/performance-optimization.md | 性能优化流程   |
-| .agents/workflows/security-audit.md           | 安全审计流程   |
-
-**删除的文件:**
-
-- .agents/workflows/1.md
-- .agents/workflows/代码审查.md
-
-### 3. 测试基础设施（5个文件）
-
-| 文件                                      | 说明                    |
-| ----------------------------------------- | ----------------------- |
-| vitest.config.ts                          | Vitest 单元测试配置     |
-| playwright.config.ts                      | Playwright E2E 测试配置 |
-| src/**tests**/setup.ts                    | 测试环境设置            |
-| src/**tests**/unit/downloadStatus.test.ts | 示例单元测试            |
-| e2e/basic.spec.ts                         | 示例 E2E 测试           |
-
-### 4. 测试文档（1个文件）
-
-| 文件       | 说明                   |
-| ---------- | ---------------------- |
-| TESTING.md | 完整的测试文档（中文） |
-
-### 5. CI/CD 集成（2个文件）
-
-| 文件                        | 操作                 |
-| --------------------------- | -------------------- |
-| .github/workflows/test.yml  | 新建（测试 CI）      |
-| .github/workflows/build.yml | 更新（添加测试步骤） |
-
-### 6. 完善文档（3个文件）
-
-| 文件               | 说明                 |
-| ------------------ | -------------------- |
-| DEPLOYMENT.md      | 部署文档（中文）     |
-| TROUBLESHOOTING.md | 问题排查指南（中文） |
-| FAQ.md             | 常见问题（中文）     |
-
-### 7. Issue 模板更新（2个文件）
-
-| 文件                                  | 操作           |
-| ------------------------------------- | -------------- |
-| .github/ISSUE_TEMPLATE/bug_report.md  | 更新为标准模板 |
-| .github/ISSUE_TEMPLATE/help_wanted.md | 更新为标准模板 |
-
-### 8. 配置更新
-
-| 文件         | 操作               |
-| ------------ | ------------------ |
-| package.json | 添加测试依赖和脚本 |
-| .gitignore   | 添加测试相关忽略项 |
-
-## 📊 统计数据
-
-- **创建的文件:** 23个
-- **更新的文件:** 3个
-- **删除的文件:** 2个
-- **总计:** 28个文件操作
-
-## 📝 新增的 npm 脚本
-
-```json
-{
-  "test": "vitest",
-  "test:watch": "vitest --watch",
-  "test:coverage": "vitest --coverage",
-  "test:e2e": "playwright test",
-  "test:e2e:ui": "playwright test --ui",
-  "test:e2e:debug": "playwright test --debug",
-  "test:all": "npm run test && npm run test:e2e"
-}
-```
-
-## 📦 新增的依赖
-
-### Dev Dependencies
-
-- `@playwright/test`: ^1.40.0
-- `@testing-library/jest-dom`: ^6.1.5
-- `@testing-library/vue`: ^8.0.1
-- `@vitest/coverage-v8`: ^1.0.0
-- `@vue/test-utils`: ^2.4.3
-- `jsdom`: ^23.0.1
-- `vitest`: ^1.0.0
-
-## 🔍 已知问题
-
-### LSP 类型错误
-
-由于 Vitest 和 Vite 的版本兼容性问题，LSP 会报告一些类型错误，但这些不会影响实际运行：
-
-- `vitest.config.ts` 中的插件类型不匹配（Vite vs Vitest 版本差异）
-- 这些错误在运行时不会出现
-
-### ESLint 错误
-
-项目中有一些现有的 ESLint 错误需要修复：
-
-- `src/App.vue`: 3个 `any` 类型错误
-- `src/components/HomeView.vue`: 5个错误（未使用变量、any 类型）
-- `src/components/TopActions.vue`: 1个未使用变量
-
-这些是原有代码的问题，不是本次整理引入的。
-
-## 🚀 下一步建议
-
-1. **修复 ESLint 错误**
-
-   ```bash
-   npm run lint:fix
-   ```
-
-2. **运行测试验证**
-
-   ```bash
-   npm run test
-   ```
-
-3. **安装 Playwright 浏览器**
-
-   ```bash
-   npx playwright install --with-deps chromium
-   ```
-
-4. **运行 E2E 测试**
-
-   ```bash
-   npm run test:e2e
-   ```
-
-5. **提交代码**
-   ```bash
-   git add .
-   git commit -m "chore: add comprehensive documentation and testing infrastructure" -s
-   git push origin main
-   ```
-
-## 📚 文档结构总览
-
-```
-apm-app-store/
-├── AGENTS.md                          # AI 编码指南（中文）
-├── CONTRIBUTING.md                    # 贡献指南（中文）
-├── DEVELOPMENT.md                     # 开发文档（中文）
-├── DEPLOYMENT.md                      # 部署文档（中文）
-├── TROUBLESHOOTING.md                 # 问题排查（中文）
-├── FAQ.md                             # 常见问题（中文）
-├── TESTING.md                         # 测试文档（中文）
-├── README.md                          # 项目说明（已存在）
-├── CHANGELOG.md                       # 变更日志（已存在）
-├── SECURITY.md                        # 安全政策（已存在）
-├── LICENSE.md                         # 许可证（已存在）
-├── CREDITS.md                         # 致谢（已存在）
-├── vitest.config.ts                   # Vitest 配置
-├── playwright.config.ts               # Playwright 配置
-├── .agents/
-│   └── workflows/
-│       ├── feature-development.md     # 新功能开发
-│       ├── bug-fix.md                 # Bug 修复
-│       ├── code-review.md             # 代码审查
-│       ├── testing.md                 # 测试编写
-│       ├── release.md                 # 发布流程
-│       ├── refactoring.md             # 代码重构
-│       ├── documentation.md           # 文档更新
-│       ├── performance-optimization.md # 性能优化
-│       └── security-audit.md          # 安全审计
-├── .github/
-│   ├── workflows/
-│   │   ├── test.yml                   # 测试 CI（新建）
-│   │   └── build.yml                  # 构建 CI（更新）
-│   └── ISSUE_TEMPLATE/
-│       ├── bug_report.md              # Bug 报告模板（更新）
-│       └── help_wanted.md             # 功能请求模板（更新）
-├── src/
-│   └── __tests__/
-│       ├── setup.ts                   # 测试设置
-│       └── unit/
-│           └── downloadStatus.test.ts # 示例测试
-└── e2e/
-    └── basic.spec.ts                 # E2E 测试示例
-```
-
-## 🎯 项目成熟度提升
-
-整理前：
-
-- ❌ 缺少完整的开发文档
-- ❌ 缺少测试基础设施
-- ❌ 工作流文档简单
-- ❌ 没有自动化测试 CI
-
-整理后：
-
-- ✅ 完整的中文开发文档
-- ✅ 完整的测试基础设施（Vitest + Playwright）
-- ✅ 9个详细的 AI 工作流
-- ✅ 自动化测试 CI/CD
-- ✅ 标准化的 Issue 模板
-- ✅ 完善的部署和问题排查文档
-
----
-
-**整理完成时间:** 2026-03-10
-**整理执行者:** OpenCode AI Assistant
-**文档版本:** 1.0

README.md

@@ -1,79 +1,167 @@
-# 星火应用商店
+# Spark App Store
+[![star](https://gitee.com/spark-store-project/spark-store/badge/star.svg?theme=gvp)](https://gitee.com/spark-store-project/spark-store/stargazers) [![fork](https://gitee.com/spark-store-project/spark-store/badge/fork.svg?theme=gvp)](https://gitee.com/spark-store-project/spark-store/members)
 
-<div align="center">
+## Introduction
 
-<img src="icons/spark-store.svg" alt="APM Logo" width="200" height="200" />
+Welcome to the Spark App Store! This is an app store designed for Linux users, aiming to solve the problem of dispersed and difficult-to-obtain applications in the Linux ecosystem. No matter what type of Linux distribution you are using, you may find suitable software packages here.
 
-**星火应用商店**
+The number of Linux applications is relatively limited, and the availability of Wine software is also quite challenging. Excellent development and tool resources are scattered across various communities and forums, making it difficult for the entire ecosystem to improve comprehensively.
 
-## 简介
+The construction of the ecosystem is not dependent on the isolated efforts of individuals but requires the participation of the entire community. Only when everyone's "sparks" gather together can they ignite a "prairie fire."
 
-欢迎来到**星火应用商店**！这是一个为 Linux 平台用户设计的应用商店，旨在解决 Linux 生态下应用分散、难以获取的问题。无论您使用什么类型的 Linux 发行版，在这里都有可能找到适合您的软件包。
+To improve this situation, we have launched this app store. We have broadly included various user-demand software packages, gathered high-quality tools, and actively adapted Wine applications, all stored in our software library for easy user access.
 
-Linux 应用的数量相对有限，Wine 软件的可获取性也颇为困难。优秀的开发套件和工具资源散布在各大社区和论坛之间，这种分散化让整个生态系统难以得到全面的提升。
+**Currently supported Linux distributions include:**
 
-生态系统的构建并非依赖个体的孤立努力，而需要全社区共同参与。只有当大家的“星火”聚集一处，方可引发“燎原之势”。
+- **amd64 architecture:** deepin 20 / deepin 23 / Ubuntu 20.04 / Ubuntu 22.04 / UOS Home Edition 20
+- **arm64 architecture:** UOS Professional Edition 1060 / Ubuntu 22.04 / deepin 23
+- **loong64 architecture:** deepin 23
 
-为了改善这一现状，我们推出了星火应用商店。星火社区广泛地收录了各种用户需求的软件包，汇集了高质量的小工具，并主动对 Wine 应用进行了适配，一切都储存在我们的软件库中，使得用户可以方便地获取这些应用。
+> Special Note: We also support all versions of Ubuntu operating systems higher than Ubuntu 22.04, such as Ubuntu 22.10, 23.04, 23.10, etc.
 
-**当前支持的 Linux 发行版包括（但不限于）：**
+**Important Notice:** This software does not provide any form of warranty. If you plan to use it on UOS Professional Edition, please make sure to understand and enable Developer Mode. Make sure you have basic troubleshooting capabilities. It should be clear that we have not conducted extensive testing on the UOS operating system. Therefore, using the Spark client may lead to a series of issues like failed system updates, data loss, etc., all risks to be borne by the user.
 
-- **amd64 架构：** Debian 10+ / Ubuntu 22.04+ / Arch Linux / Fedora / deepin / UOS / 银河麒麟 
-- **arm64 架构：** Debian 10+ / Ubuntu 22.04+ / Arch Linux / deepin / UOS / 银河麒麟 
-- **loong64 架构：** deepin 23/25
+## Team Collaboration: For detailed documentation related to branch management, please see [this link](https://wiki.spark-app.store/#/Dev/Spark-Store-Git-Repo).
 
+We warmly welcome you to join our development team. Whether you want to participate in development or submit applications, you can find your place here to jointly promote the development of the Linux application ecosystem.
 
-对于不同平台，商店展示的应用列表不同，如有需要请提交应用需求，我们会尽快添加。
+You can track our Issue handling status in real-time through the following link: [Gitee Issue Board](https://gitee.com/spark-store-project/spark-store/board).
 
+If you have a software package you'd like to submit, please [click here to submit](https://upload.deepinos.org.cn/index).
 
+## Contents
 
-
-</div>
-
-
-
-## 🚀 快速开始
-
-### 安装应用商店
-
-* Debian(包括Ubuntu、deepin、银河麒麟、UOS)
-
-1. 从 Release 下载最新版本的应用商店客户端。
-2. 从启动器中打开并使用
-
-* Fedora
-
-1. `sudo dnf enable xmp360/spark-store`
-2. `sudo dnf install spark-store`
-
-* Arch Linux
-
-1. paru -S spark-store
-
----
-<div align="center">
-<img src="./galleries/image.png" alt="APM Screenshot" width="90%"  />
-</div>
-
-## 📦 关于 APM
-
-**APM (AmberPM)** 是基于 `fuse-overlayfs` + `dpkg` + `AmberCE` 的容器化兼容层，为多发行版提供轻量级的应用运行方案。星火的 Arch Linux 版本和 Fedora 版本基于APM实现支持。
-
-### 核心特性
-
-✅ **多发行版兼容** — 完美支持 Arch Linux、Fedora、银河麒麟、统信 UOS 等主流发行版，让星火商店应用随处可用  
-🔄 **智能包转换** — 与 Debian 生态深度兼容，绝大多数 deb 包可一键自动转换为 APM 格式  
-⚡ **轻量兼容层** — 基于 overlayfs 技术打造，极速启动无负担，告别臃肿容器  
-🎮 **NVIDIA 硬件加速** — 智能识别主机 GPU 驱动，自动配置硬件加速，畅享流畅体验
-
-APM的源码：[APM Source Code](https://gitee.com/amber-ce/amber-pm)
+- [Read the copyright](#read-the-copyright)
+- [Determine your system architecture](#determine-your-system-architecture)
+- [System support and installation guide](#system-support-and-installation-guide)
+  - [For Deepin / UOS Users](#for-deepin-users)
+  - [For Ubuntu Users](#for-ubuntu-users)
+  - [For Debian Users](#for-debian-users)
+- [Frequently Asked Questions (FAQ)](#frequently-asked-questions-faq)
+- [Contact and Feedback](#contact-and-feedback)
 
 ---
 
-**重要须知：** 本软件无法保证持续可用、无中断运行或满足特定性能要求。星火社区对其功能完整性、稳定性及无错误运行不作任何承诺。例如，若您计划在 UOS 专业版（或其他类似特定平台）上使用，请务必了解并启用“开发者模式”相关功能。请确保您具备基础的故障排查能力。需要明确的是，星火社区无法在部分特殊平台上进行广泛测试。因此，在这些平台上使用星火应用商店客户端可能会导致一系列问题，如系统更新失败、数据丢失等；使用该软件，即代表您理解并同意所有风险需由用户自行承担。
+## Read [the copyright](LICENSE)
 
-**© 2026 APM / AmberPM | The Spark Project**
 
-Made with ❤️ by the Spark Store Team
 
-</div>
+## Determine your system architecture
+
+Before installing any software, you need to know what architecture your computer runs on (such as x86_64/amd64 or aarch64/arm64).
+
+**How to check:**
+
+1. Open a Linux terminal.
+2. Type `uname -m` or `arch` and press Enter.
+
+You will see an output, and that's your system architecture.
+
+- If you see `x86_64`, your system is AMD64 architecture.
+- If you see `aarch64`, your system is ARM64 architecture.
+
+---
+
+## System support and installation guide
+
+### For Deepin Users
+
+#### For Deepin Users
+
+1. **Download and Install**
+
+   You can directly search for Spark App Store in the Deepin Store to install, or copy this link to open and install in your browser:
+
+   > appstore://deepin-home-appstore-client?app_detail_info/spark-store
+
+   To use the latest version, please visit the [Spark App Store Release page](https://gitee.com/spark-store-project/spark-store/releases) and download the latest version suitable for Deepin. Install to use.
+
+   Assuming you've downloaded to the `Downloads` folder in your user directory, we recommend you use the APT tool to install:
+
+    ```shell
+    cd ~/Downloads
+    sudo apt install ./spark-store*.deb
+    ```
+
+### For Ubuntu Users
+
+#### For Ubuntu 20.04 Users
+
+1. **Download Dependencies**
+* Please visit the [Spark App Store Dependency Download page](https://gitee.com/spark-store-project/spark-store-dependencies/releases) and download the latest dependency package.
+* Unzip the dependency package multiple times until you see multiple installation packages ending with `.deb`.
+* Follow the instructions in the dependency package to install all the dependencies at once.
+
+2. **Download and Install**
+
+   Visit the [Spark App Store Release page](https://gitee.com/spark-store-project/spark-store/releases), download the installation package that matches your computer's architecture, and install it.
+
+   Assuming you've downloaded to the `Downloads` folder in your user directory, we recommend you use the APT tool to install:
+
+    ```shell
+    cd ~/Downloads
+    sudo apt install ./spark-store*.deb
+    ```
+
+#### For Ubuntu 22.04 and Higher Version Users
+
+1. **No Need to Install Dependencies**
+
+2. **Download and Install**
+
+   Visit the [Spark App Store Release page](https://gitee.com/spark-store-project/spark-store/releases), download the installation package that matches your computer's architecture, and install it.
+
+   Assuming you've downloaded to the `Downloads` folder in your user directory, we recommend you use the APT tool to install:
+
+    ```shell
+    cd ~/Downloads
+    sudo apt install ./spark-store*.deb
+    ```
+
+### For Debian Users
+
+#### For Debian 11 Users
+
+1. **Download Dependencies**
+* Please visit the [Spark App Store Dependency Download page](https://gitee.com/spark-store-project/spark-store-dependencies/releases) and download the latest dependency package.
+* Unzip the dependency package multiple times until you see multiple installation packages ending with `.deb`.
+* Follow the instructions in the dependency package to install all the dependencies at once.
+
+2. **Download and Install**
+
+   Please visit the [Spark App Store Release page](https://gitee.com/spark-store-project/spark-store/releases) and download. Install to use.
+
+#### For Debian 12+ Users
+
+1. **No Need to Install Dependencies**
+
+2. **Download and Install**
+
+   Please visit the [Spark App Store Release page](https://gitee.com/spark-store-project/spark-store/releases), download the installation package that matches your computer's architecture, and install it.
+
+   Assuming you've downloaded to the `Downloads` folder in your user directory, we recommend you use the APT tool to install:
+
+    ```shell
+    cd ~/Downloads
+    sudo apt install ./spark-store*.deb
+    ```
+
+---
+
+## Frequently Asked Questions (FAQ)
+
+Please refer to the [Spark App Store FAQ and Support Guide](https://gitee.com/spark-store-project/spark-store/blob/dev/FAQ.md).
+
+You can also check the [Chinese version](https://gitee.com/spark-store-project/spark-store/blob/dev/FAQ.zh.md) here.
+
+---
+
+## Contact and Feedback
+
+- If you have any questions or suggestions, please submit them via email or on our [Gitee page](https://gitee.com/spark-store-project/spark-store/issues).
+- If you want to follow our development progress, you can go to the [Spark App Store Board](https://gitee.com/spark-store-project/spark-store/board) for more information.
+- Our [Forum](https://bbs.spark-app.store/)
+- Our [QQ Group](https://blog.shenmo.tech/post/%E6%95%85%E9%9A%9C%E5%85%AC%E5%91%8A/)
+- For commercial support, please leave your issue~
+
+---

README.zh.md

@@ -0,0 +1,188 @@
+#  星火应用商店
+[![star](https://gitee.com/spark-store-project/spark-store/badge/star.svg?theme=gvp)](https://gitee.com/spark-store-project/spark-store/stargazers)  [![fork](https://gitee.com/spark-store-project/spark-store/badge/fork.svg?theme=gvp)](https://gitee.com/spark-store-project/spark-store/members)
+
+
+
+## 简介
+
+欢迎来到星火应用商店！这是一个为Linux用户设计的应用商店，旨在解决Linux生态下应用分散、难以获取的问题。无论你是使用什么类型的Linux发行版，这里都有可能找到适合你的软件包。
+
+
+Linux 应用的数量相对有限，Wine 软件的可获得性也颇为困难。优秀的开发和工具资源散布在各大社区和论坛之间，这种分散化让整个生态系统难以得到全面的提升。
+
+生态系统的构建并非依赖个体的孤立努力，而需要全社区共同参与。只有当大家的“星火”聚集一处，方可引发“燎原之势”。
+
+为了改善这一现状，我们推出了这个应用商店。我们广泛地收录了各种用户需求的软件包，汇集了高质量的小工具，并主动对 Wine 应用进行了适配，一切都储存在我们的软件库中，使得用户可以方便地获取这些应用。
+
+**当前支持的Linux发行版包括：**
+
+- **amd64架构：** deepin 20 / deepin 23 / Ubuntu 20.04 / Ubuntu 22.04 / UOS家庭版20
+- **arm64架构：** UOS专业版1060 / Ubuntu 22.04 / deepin 23
+- **loong64架构：** deepin 23
+
+> 特别说明：我们还支持所有版本高于Ubuntu 22.04的Ubuntu操作系统，例如Ubuntu 22.10、23.04、23.10等。
+
+**重要须知：** 本软件不提供任何形式的保证。若您计划在UOS专业版上使用，请务必了解并启用开发者模式。请确保您具备基础的故障排查能力。需要明确的是，我们没有在UOS操作系统上进行广泛的测试。因此，使用星火客户端可能会导致一系列问题，如系统更新失败、数据丢失等，所有风险需由用户自行承担。
+
+
+
+## 关于团队协作
+
+组织仓库链接：
+https://gitee.com/spark-store-project/spark-store
+
+https://gitcode.com/spark-store-project/spark-store 
+
+https://github.com/spark-store-project/spark-store
+
+分支管理相关的详细文档可参见 [此链接](https://wiki.spark-app.store/#/Dev/Spark-Store-Git-Repo)。
+
+我们热忱欢迎您加入我们的开发团队。无论您是想参与开发，还是想提交应用，都能在这里找到属于您的一席之地，共同推动Linux应用生态的发展。
+
+您可以通过以下链接，实时跟踪我们的Issue处理状态：[Gitee Issue看板](https://gitee.com/spark-store-project/spark-store/board)。
+
+若您有软件包想要提交，敬请 [点击此处进行投稿](https://wiki.spark-app.store/#/Submit/Submit)。
+
+
+
+
+## 目录
+
+- [阅读版权声明](#阅读版权声明)
+- [确定你的系统架构](#确定你的系统架构)
+- [系统支持与安装指引](#系统支持与安装指引)
+  - [对于 Deepin / UOS 用户](#对于deepin用户)
+  - [对于 Ubuntu 用户](#对于ubuntu用户)
+  - [对于 Debian 用户](#对于debian用户)
+- [常见问题（FAQ）](#常见问题faq)
+- [联系与反馈](#联系与反馈)
+
+---
+
+## 阅读[版权声明](LICENSE)
+
+
+## 确定你的系统架构
+
+在安装任何软件之前，你需要知道你的计算机运行的是哪种架构（如x86_64/amd64或aarch64/arm64）。
+
+**如何检查：**
+
+1. 打开Linux终端。
+2. 输入 `uname -m` 或 `arch` 并按回车。
+
+你会看到一个输出，这就是你的系统架构。
+
+- 如果看到 `x86_64`，你的系统是AMD64架构。
+- 如果看到 `aarch64`，你的系统是ARM64架构。
+
+---
+
+## 系统支持与安装指引
+
+根据你的Linux发行版和系统架构，以下是安装星火应用商店的详细步骤。
+
+### 对于 Deepin 用户
+
+#### 对于 Deepin 用户
+
+1.  **下载并安装**
+
+    您可直接在深度商店搜索 星火应用商店 安装，或复制此链接到浏览器打开安装 
+
+    > appstore://deepin-home-appstore-client?app_detail_info/spark-store
+
+
+    若要使用最新版本，请访问[星火应用商店的Release页面](https://gitee.com/spark-store-project/spark-store/releases)或[Gitcode的Release页面](https://gitcode.com/spark-store-project/spark-store/releases)并下载适用于Deepin的最新版本。安装后即可使用。
+
+    假设您下载到用户目录下的 Downloads 文件夹， 我们推荐您使用 APT 工具安装：
+
+    ```shell
+    cd ~/Downloads
+    sudo apt install ./spark-store*.deb
+    ```
+
+### 对于 Ubuntu 用户
+
+#### 对于 Ubuntu 20.04 用户
+
+1. **下载依赖包**
+* 请访问[星火应用商店依赖包下载页面](https://gitee.com/spark-store-project/spark-store-dependencies/releases)， 下载最新的依赖包。
+* 请多次解压依赖包，直到你可以看到诸多以 deb 结尾的安装包。
+* 依据依赖包内的说明，一次性安装所有的依赖包。
+
+
+2. **下载并安装**
+
+    请访问[星火应用商店的Release页面](https://gitee.com/spark-store-project/spark-store/releases)或[Gitcode的Release页面](https://gitcode.com/spark-store-project/spark-store/releases)，下载和您电脑相同架构的安装包并安装。
+
+    假设您下载到用户目录下的 Downloads 文件夹， 我们推荐您使用 APT 工具安装：
+
+    ```shell
+    cd ~/Downloads
+    sudo apt install ./spark-store*.deb
+    ```
+
+#### 对于 Ubuntu 22.04 及更高版本的 Ubuntu 用户
+1. **无需安装依赖包**
+
+
+2. **下载并安装**
+
+    请访问[星火应用商店的Release页面](https://gitee.com/spark-store-project/spark-store/releases)或[Gitcode的Release页面](https://gitcode.com/spark-store-project/spark-store/releases)，下载和您电脑相同架构的安装包并安装。
+
+    假设您下载到用户目录下的 Downloads 文件夹， 我们推荐您使用 APT 工具安装：
+
+    ```shell
+    cd ~/Downloads
+    sudo apt install ./spark-store*.deb
+    ```
+
+### 对于 Debian 用户
+
+#### 对于 Debian 11 用户
+
+1. **下载依赖包**
+* 请访问[星火应用商店依赖包下载页面](https://gitee.com/spark-store-project/spark-store-dependencies/releases)， 下载最新的依赖包。
+* 请多次解压依赖包，直到你可以看到诸多以 deb 结尾的安装包。
+* 依据依赖包内的说明，一次性安装所有的依赖包。
+
+2. **下载并安装**
+
+    请访问[星火应用商店的Release页面](https://gitee.com/spark-store-project/spark-store/releases)或[Gitcode的Release页面](https://gitcode.com/spark-store-project/spark-store/releases)并下载，安装后即可使用。
+
+
+#### 对于 Debian 12+ 用户
+
+1. **无需安装依赖包**
+
+
+2. **下载并安装**
+
+    请访问[星火应用商店的Release页面](https://gitee.com/spark-store-project/spark-store/releases)或[Gitcode的Release页面](https://gitcode.com/spark-store-project/spark-store/releases)，下载和您电脑相同架构的安装包并安装。
+
+    假设您下载到用户目录下的 Downloads 文件夹， 我们推荐您使用 APT 工具安装：
+
+    ```shell
+    cd ~/Downloads
+    sudo apt install ./spark-store*.deb
+    ```
+---
+
+## 常见问题（FAQ）
+
+请参见[星火应用商店FAQ与支持指南](https://gitee.com/spark-store-project/spark-store/blob/dev/FAQ.md)。
+
+在这里可以查阅[中文版本](https://gitee.com/spark-store-project/spark-store/blob/dev/FAQ.zh.md)。
+
+---
+
+## 联系与反馈
+
+- 如果您有任何问题或建议，请通过邮件或在[Gitee页面](https://gitee.com/spark-store-project/spark-store/issues)上提交问题。
+- 如果你想关注我们的开发进度，可以跳转[星火应用商店Board](https://gitee.com/spark-store-project/spark-store/board)获取更多信息。
+- 我们的[论坛](https://bbs.spark-app.store/)
+- 我们的QQ群 872690351
+- 商业支持请留言咨询~
+
+---

SECURITY.md

@@ -1,71 +0,0 @@
-# Security Policy / 安全策略
-
----
-
-## 🌐 English Version
-
-### Supported Versions
-The following versions currently receive security updates:
-
-| Version | Supported          |
-|---------|--------------------|
-| > 1.0.4   | :white_check_mark: |
-| < 1.0.4   | :x:                |
-
-> **Note**: Only versions marked with ✅ receive security patches. Upgrade to a supported version immediately if using an unsupported release.
-
-### Reporting a Vulnerability
-We deeply appreciate your efforts to responsibly disclose security issues. Please follow these guidelines:
-
-#### 📬 How to Report
-- **Preferred**: Use GitHub's [Private Vulnerability Reporting](https://docs.github.com/en/code-security/security-advisories/guidance-on-reporting-and-writing-information-about-vulnerabilities)
-
-#### 📋 Report Should Include
-- Clear description of the vulnerability and potential impact
-- Affected component/version
-- Steps to reproduce (PoC code appreciated but optional)
-- Suggested mitigation (if known)
-- Contact information and preferred disclosure timeline
-
-#### ⚠️ Important Notes
-- **DO NOT** disclose publicly before coordination
-- Avoid intrusive testing (e.g., data exfiltration, DoS)
-- We comply with [ISO/IEC 29147](https://www.iso.org/standard/45173.html) vulnerability disclosure standards
-- Good-faith researchers acting responsibly will not face legal action
-
-Thank you for helping keep our community safe! 🛡️
-
----
-
-## 🇨🇳 中文版本
-
-### 支持的版本
-以下版本当前接收安全更新：
-
-| 版本   | 是否支持          |
-|--------|-------------------|
-| > 1.0.4   | :white_check_mark: |
-| < 1.0.4   | :x:                |
-
-> **提示**：仅标记 ✅ 的版本接收安全补丁。如使用不受支持的版本，请立即升级至受支持版本。
-
-### 漏洞报告流程
-感谢您负责任地披露安全问题。请遵循以下指南：
-
-#### 📬 报告方式
-- **首选**：使用 GitHub [私有漏洞报告](https://docs.github.com/zh/code-security/security-advisories/guidance-on-reporting-and-writing-information-about-vulnerabilities) 功能
-
-#### 📋 报告内容建议包含
-- 漏洞清晰描述及潜在影响
-- 受影响组件/版本
-- 复现步骤（提供验证代码更佳，非必需）
-- 建议的缓解措施（如已知）
-- 联系方式及期望的披露时间
-
-#### ⚠️ 重要提示
-- 修复完成前**请勿公开披露**
-- 避免侵入性测试（如数据窃取、拒绝服务攻击）
-- 本流程遵循 [ISO/IEC 29147](https://www.iso.org/standard/45173.html) 漏洞披露国际标准
-- 本着善意负责任研究的安全研究员将不会面临法律追责
-
-感谢您为社区安全贡献力量！🛡️

TESTING.md

@@ -1,436 +0,0 @@
-# 测试文档
-
-## 📋 目录
-
-- [测试框架](#测试框架)
-- [测试规范](#测试规范)
-- [编写测试](#编写测试)
-- [运行测试](#运行测试)
-- [测试覆盖率](#测试覆盖率)
-- [Mock 数据](#mock-数据)
-- [E2E 测试](#e2e-测试)
-
-## 测试框架
-
-### Vitest（单元测试）
-
-Vitest 是 Vite 原生的测试框架，提供快速的开发体验。
-
-**特点:**
-
-- 与 Vite 配置共享
-- 极快的测试执行速度
-- 内置 TypeScript 支持
-- Jest 兼容的 API
-
-**配置文件:** `vitest.config.ts`
-
-### Playwright（E2E 测试）
-
-Playwright 用于端到端测试，模拟真实用户操作。
-
-**特点:**
-
-- 支持多浏览器（Chromium, Firefox, WebKit）
-- 自动等待
-- 网络拦截和 mock
-- 可视化测试运行
-
-**配置文件:** `playwright.config.ts`
-
-## 测试规范
-
-### 命名规范
-
-**测试文件:** `*.test.ts` 或 `*.spec.ts`
-
-**测试目录结构:**
-
-```
-src/
-├── __tests__/
-│   ├── unit/           # 单元测试
-│   │   ├── downloadStatus.test.ts
-│   │   └── storeConfig.test.ts
-│   ├── integration/    # 集成测试
-│   │   └── installFlow.test.ts
-│   └── setup.ts        # 测试设置
-└── components/
-    └── AppCard.test.ts  # 组件测试
-
-e2e/
-├── install.spec.ts     # E2E 测试
-└── download.spec.ts
-```
-
-### 测试分组
-
-使用 `describe` 分组相关测试：
-
-```typescript
-describe("ComponentName", () => {
-  describe("method", () => {
-    it("should do something", () => {
-      // ...
-    });
-  });
-});
-```
-
-### 测试命名
-
-使用清晰的描述性名称：
-
-```typescript
-✅ 好的:
-it('should return true when app is installed')
-it('should throw error when package not found')
-
-❌ 不好的:
-it('test1')
-it('works')
-```
-
-## 编写测试
-
-### 单元测试
-
-**测试纯函数:**
-
-```typescript
-import { describe, it, expect } from "vitest";
-import { parseInstalledList } from "@/modules/parse";
-
-describe("parseInstalledList", () => {
-  it("should parse installed list correctly", () => {
-    const output = "code/stable,1.108.2 amd64 [installed]";
-    const result = parseInstalledList(output);
-
-    expect(result).toHaveLength(1);
-    expect(result[0].pkgname).toBe("code");
-    expect(result[0].version).toBe("1.108.2");
-  });
-});
-```
-
-**测试 Vue 组件:**
-
-```typescript
-import { describe, it, expect } from "vitest";
-import { mount } from "@vue/test-utils";
-import AppCard from "@/components/AppCard.vue";
-import type { App } from "@/global/typedefinition";
-
-describe("AppCard", () => {
-  const mockApp: App = {
-    name: "Test App",
-    pkgname: "test-app",
-    version: "1.0.0",
-    filename: "test.deb",
-    torrent_address: "",
-    author: "Test",
-    contributor: "Test",
-    website: "https://example.com",
-    update: "2024-01-01",
-    size: "100M",
-    more: "Test app",
-    tags: "",
-    img_urls: [],
-    icons: "",
-    category: "test",
-    currentStatus: "not-installed",
-  };
-
-  it("should render app name", () => {
-    const wrapper = mount(AppCard, {
-      props: {
-        app: mockApp,
-      },
-    });
-
-    expect(wrapper.text()).toContain("Test App");
-  });
-
-  it("should emit install event", async () => {
-    const wrapper = mount(AppCard, {
-      props: {
-        app: mockApp,
-      },
-    });
-
-    await wrapper.find(".install-button").trigger("click");
-
-    expect(wrapper.emitted("install")).toBeTruthy();
-  });
-});
-```
-
-### 集成测试
-
-测试模块间的交互：
-
-```typescript
-import { describe, it, expect, vi, beforeEach } from "vitest";
-import { installPackage } from "@/modules/processInstall";
-import { downloads, addDownload } from "@/global/downloadStatus";
-
-describe("installPackage integration", () => {
-  beforeEach(() => {
-    downloads.value = [];
-    vi.clearAllMocks();
-  });
-
-  it("should add download and send IPC message", () => {
-    const pkgname = "test-app";
-
-    installPackage(pkgname);
-
-    expect(downloads.value).toHaveLength(1);
-    expect(downloads.value[0].pkgname).toBe(pkgname);
-    expect(window.ipcRenderer.send).toHaveBeenCalledWith(
-      "queue-install",
-      expect.any(String),
-    );
-  });
-});
-```
-
-## 运行测试
-
-### 单元测试
-
-```bash
-# 运行所有测试
-npm run test
-
-# 监听模式（开发时）
-npm run test:watch
-
-# 运行特定文件
-npm run test src/__tests__/unit/downloadStatus.test.ts
-
-# 运行匹配模式的测试
-npm run test -- downloadStatus
-```
-
-### 覆盖率
-
-```bash
-# 生成覆盖率报告
-npm run test:coverage
-
-# 报告位置:
-# - 控制台: 文本报告
-# - coverage/ 目录: HTML 报告
-```
-
-### E2E 测试
-
-```bash
-# 运行所有 E2E 测试
-npm run test:e2e
-
-# UI 模式（推荐用于开发）
-npm run test:e2e:ui
-
-# 调试模式
-npm run test:e2e:debug
-
-# 运行特定测试
-npm run test:e2e -- install.spec.ts
-```
-
-## 测试覆盖率
-
-### 覆盖率目标
-
-- **语句覆盖率:** ≥ 70%
-- **分支覆盖率:** ≥ 70%
-- **函数覆盖率:** ≥ 70%
-- **行覆盖率:** ≥ 70%
-
-### 查看报告
-
-```bash
-npm run test:coverage
-
-# 在浏览器中打开
-open coverage/index.html
-```
-
-### CI 中强制检查
-
-在 `.github/workflows/test.yml` 中配置覆盖率阈值。
-
-## Mock 数据
-
-### Mock IPC
-
-在 `src/__tests__/setup.ts` 中全局 mock：
-
-```typescript
-global.window = Object.create(window);
-Object.defineProperty(window, "ipcRenderer", {
-  value: {
-    send: vi.fn(),
-    on: vi.fn(),
-    off: vi.fn(),
-    invoke: vi.fn(),
-    removeListener: vi.fn(),
-  },
-});
-```
-
-### Mock API 响应
-
-```typescript
-import { vi } from "vitest";
-import axios from "axios";
-
-vi.mock("axios");
-
-describe("fetchApps", () => {
-  it("should fetch apps from API", async () => {
-    const mockApps = [{ name: "Test", pkgname: "test" }];
-    axios.get.mockResolvedValue({ data: mockApps });
-
-    const result = await fetchApps();
-
-    expect(result).toEqual(mockApps);
-  });
-});
-```
-
-### Mock 文件系统
-
-```typescript
-import { vi } from "vitest";
-import fs from "node:fs";
-
-vi.mock("node:fs");
-
-describe("readConfig", () => {
-  it("should read config file", () => {
-    const mockConfig = { theme: "dark" };
-    fs.readFileSync.mockReturnValue(JSON.stringify(mockConfig));
-
-    const config = readConfig();
-
-    expect(config).toEqual(mockConfig);
-  });
-});
-```
-
-## E2E 测试
-
-### 编写 E2E 测试
-
-```typescript
-import { test, expect } from "@playwright/test";
-
-test.describe("App Installation", () => {
-  test.beforeEach(async ({ page }) => {
-    await page.goto("http://127.0.0.1:3344");
-  });
-
-  test("should install an app", async ({ page }) => {
-    // 搜索应用
-    await page.fill('input[placeholder="搜索应用"]', "Test App");
-    await page.press('input[placeholder="搜索应用"]', "Enter");
-
-    // 等待结果
-    await expect(page.locator(".app-card")).toBeVisible();
-
-    // 点击安装
-    await page.click('.app-card:has-text("Test App") .install-button');
-
-    // 验证下载队列
-    await expect(page.locator(".download-queue")).toBeVisible();
-    await expect(page.locator(".download-item")).toHaveText("Test App");
-  });
-
-  test("should show installation progress", async ({ page }) => {
-    // ... 测试进度显示
-  });
-
-  test("should handle installation failure", async ({ page }) => {
-    // ... 测试失败处理
-  });
-});
-```
-
-### E2E 测试最佳实践
-
-1. **使用选择器**
-
-   ```typescript
-   // 推荐：语义化选择器
-   await page.click('[data-testid="install-button"]');
-
-   // 避免：脆弱的选择器
-   await page.click("button.btn-primary");
-   ```
-
-2. **等待元素**
-
-   ```typescript
-   // 自动等待
-   await expect(page.locator(".modal")).toBeVisible();
-
-   // 手动等待（必要时）
-   await page.waitForSelector(".modal", { state: "visible" });
-   ```
-
-3. **截图和视频**
-   - 失败时自动截图
-   - 失败时自动录制视频
-
-4. **网络拦截**
-   ```typescript
-   await page.route("**/api/**", (route) => {
-     route.fulfill({
-       status: 200,
-       body: JSON.stringify(mockData),
-     });
-   });
-   ```
-
-## 常见问题
-
-### 测试超时
-
-```typescript
-test(
-  "slow test",
-  async () => {
-    // 增加超时时间
-  },
-  { timeout: 10000 },
-);
-```
-
-### 异步测试
-
-```typescript
-it("should handle async operation", async () => {
-  await someAsyncOperation();
-  expect(result).toBe(expected);
-});
-```
-
-### 清理副作用
-
-```typescript
-import { afterEach } from "vitest";
-
-afterEach(() => {
-  // 清理 mock
-  vi.restoreAllMocks();
-  // 清理状态
-  downloads.value = [];
-});
-```
-
----
-
-**© 2026 APM 应用商店项目**

TROUBLESHOOTING.md

@@ -1,160 +0,0 @@
-# 问题排查指南
-
-## 📋 目录
-
-- [常见问题](#常见问题)
-- [调试方法](#调试方法)
-- [日志分析](#日志分析)
-- [性能问题](#性能问题)
-
-## 常见问题
-
-### 应用无法启动
-
-**症状:** 双击应用图标后无反应
-
-**可能原因:**
-
-1. 依赖包未安装
-2. 配置文件损坏
-3. 权限问题
-
-**解决方法:**
-
-```bash
-# 检查日志
-journalctl -u spark-store
-
-# 重新安装
-sudo dpkg -i spark-store_*.deb
-
-# 检查依赖
-sudo apt-get install -f
-```
-
-### 安装失败
-
-**症状:** 点击安装按钮后无响应或报错
-
-**可能原因:**
-
-1. APM 未安装
-2. 权限不足
-3. 网络问题
-
-**解决方法:**
-
-```bash
-# 检查 APM 是否安装
-which apm
-
-# 检查权限
-pkexec --version
-
-# 查看 APM 日志
-sudo journalctl -u amber-pm
-```
-
-### 下载速度慢
-
-**症状:** 下载进度缓慢
-
-**解决方法:**
-
-1. 检查网络连接
-2. 更换下载源
-3. 使用代理
-
-### 主题切换无效
-
-**症状:** 切换暗色/亮色主题后无变化
-
-**解决方法:**
-
-```bash
-# 清除本地存储
-rm -rf ~/.config/spark-store/
-```
-
-## 调试方法
-
-### 主进程调试
-
-```bash
-# 使用命令行启动并查看日志
-spark-store --enable-logging
-```
-
-### 渲染进程调试
-
-1. 打开应用
-2. 按 `Ctrl+Shift+I` 打开 DevTools
-3. 查看 Console 和 Network 标签
-
-### IPC 通信调试
-
-在 `electron/main/index.ts` 中添加日志：
-
-```typescript
-ipcMain.on("test-channel", (event, data) => {
-  logger.info("IPC received:", data);
-});
-```
-
-## 日志分析
-
-### 日志位置
-
-- **主进程日志:** `~/.config/spark-store/logs/`
-- **系统日志:** `journalctl -u spark-store`
-
-### 日志级别
-
-- `trace`: 最详细
-- `debug`: 调试信息
-- `info`: 一般信息
-- `warn`: 警告
-- `error`: 错误
-- `fatal`: 致命错误
-
-### 查看日志
-
-```bash
-# 查看最新日志
-tail -f ~/.config/spark-store/logs/main.log
-
-# 搜索错误
-grep ERROR ~/.config/spark-store/logs/*.log
-```
-
-## 性能问题
-
-### 内存占用高
-
-**检查方法:**
-
-1. 打开 DevTools → Performance 标签
-2. 录制并分析内存使用
-
-**优化建议:**
-
-- 清理不必要的组件
-- 使用虚拟滚动
-- 避免内存泄漏
-
-### 启动慢
-
-**检查方法:**
-
-1. 查看 DevTools → Network 标签
-2. 检查加载时间
-
-**优化建议:**
-
-- 延迟加载非关键资源
-- 优化 API 请求
-- 减少 HTTP 请求数量
-
----
-
-**© 2026 APM 应用商店项目**

WORKFLOW.md

@@ -1,632 +0,0 @@
-# 标准开发流程
-
-本文档描述在 APM 应用商店项目中完成代码开发后的标准提交流程。
-
-## 📋 目录
-
-- [开发前准备](#开发前准备)
-- [代码完成后](#代码完成后)
-- [提交流程](#提交流程)
-- [典型场景](#典型场景)
-- [提交流程检查清单](#提交流程检查清单)
-- [常见问题](#常见问题)
-
----
-
-## 开发前准备
-
-在开始开发之前，确保你的开发环境已正确配置：
-
-```bash
-# 1. 切换到项目目录
-cd apm-app-store
-
-# 2. 拉取最新代码
-git pull origin main
-
-# 3. 创建功能分支
-git checkout -b feature/your-feature-name
-# 或修复分支
-git checkout -b fix/your-bug-fix
-
-# 4. 确保依赖已安装
-npm install
-```
-
----
-
-## 代码完成后
-
-### 1️⃣ 运行代码检查
-
-首先确保代码符合项目规范：
-
-```bash
-# 运行 ESLint 检查
-npm run lint
-
-# 如果有错误，尝试自动修复
-npm run lint:fix
-
-# 手动修复无法自动处理的问题
-```
-
-**ESLint 错误类型：**
-
-- `@typescript-eslint/no-explicit-any`: 避免使用 `any` 类型
-- `@typescript-eslint/no-unused-vars`: 未使用的变量
-- 其他代码风格问题
-
-### 2️⃣ 格式化代码
-
-使用 Prettier 格式化代码：
-
-```bash
-npm run format
-```
-
-### 3️⃣ 运行测试
-
-确保所有测试通过：
-
-```bash
-# 运行单元测试
-npm run test
-
-# 生成测试覆盖率报告
-npm run test:coverage
-
-# 运行 E2E 测试（如果需要）
-npm run test:e2e
-
-# 运行所有测试
-npm run test:all
-```
-
-**测试覆盖率要求：**
-
-- 语句覆盖率: ≥ 70%
-- 分支覆盖率: ≥ 70%
-- 函数覆盖率: ≥ 70%
-- 行覆盖率: ≥ 70%
-
-### 4️⃣ 构建验证
-
-验证代码可以成功构建：
-
-```bash
-# 仅构建前端代码（快速）
-npm run build:vite
-```
-
-如果构建失败，检查 TypeScript 错误并修复。
-
----
-
-## 提交流程
-
-### 5️⃣ 提交代码
-
-#### 查看变更
-
-```bash
-# 查看所有变更文件
-git status
-
-# 查看具体变更
-git diff
-```
-
-#### 添加文件
-
-```bash
-# 添加所有变更文件
-git add .
-
-# 或添加特定文件
-git add path/to/file.ts
-```
-
-#### 提交信息
-
-遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范：
-
-```
-type(scope): subject
-
-[可选的正文]
-
-[可选的脚注]
-```
-
-**Type 类型：**
-
-- `feat`: 新功能
-- `fix`: Bug 修复
-- `docs`: 文档更新
-- `style`: 代码格式（不影响功能）
-- `refactor`: 重构
-- `perf`: 性能优化
-- `test`: 测试相关
-- `chore`: 构建/工具相关
-
-**Scope 范围：**
-
-- `app`: 应用核心
-- `install`: 安装/卸载
-- `ui`: UI 组件
-- `ipc`: IPC 通信
-- `api`: API 集成
-- `theme`: 主题
-- `build`: 构建
-- `docs`: 文档
-
-**Subject 主题：**
-
-- 使用现在时态（"add" 而非 "added"）
-- 首字母小写
-- 不以句号结尾
-
-**示例：**
-
-```bash
-# 新功能
-git commit -m "feat(install): add retry mechanism for failed installations" -s
-
-# Bug 修复
-git commit -m "fix(ui): correct dark mode toggle persistence" -s
-
-# 文档更新
-git commit -m "docs(readme): update build instructions" -s
-
-# 重构
-git commit -m "refactor(ipc): simplify install manager event handling" -s
-
-# 测试
-git commit -m "test(download): add unit tests for download queue" -s
-```
-
-**添加签名：**
-
-```bash
-# 使用 -s 添加签名
-git commit -m "feat(example): add new feature" -s
-
-# 或在 ~/.gitconfig 中配置
-# [commit]
-#     gpgsign = true
-```
-
-#### 执行提交
-
-```bash
-git commit -m "type(scope): description" -s
-```
-
-### 6️⃣ 推送到远程仓库
-
-```bash
-# 推送当前分支
-git push origin feature/your-feature-name
-
-# 或使用简写
-git push -u origin feature/your-feature-name
-```
-
-### 7️⃣ 创建 Pull Request
-
-#### 访问 GitHub
-
-1. 访问仓库页面
-2. 点击 "New Pull Request"
-3. 选择你的分支 → main 分支
-
-#### 填写 PR 模板
-
-使用 PR 模板填写信息：
-
-**变更类型：**
-
-- [ ] `feat` - 新功能
-- [ ] `fix` - Bug 修复
-- [ ] `refactor` - 重构
-- [ ] `docs` - 文档更新
-- [ ] `test` - 测试相关
-- [ ] `chore` - 构建/工具相关
-
-**变更描述：**
-清晰简洁地说明你做了什么，为什么这么做。
-
-**相关 Issue：**
-引用相关的 Issue 编号，例如 `Fixes #123` 或 `Closes #123`。
-
-**测试说明：**
-如何测试这些变更？包括：
-
-- 测试步骤
-- 预期结果
-- 测试环境
-
-**截图/录屏：**
-如果涉及 UI 变更，添加截图或录屏。
-
-**检查清单：**
-
-- [ ] 代码通过 `npm run lint`
-- [ ] 代码通过 `npm run format`
-- [ ] 所有测试通过 (`npm run test`)
-- [ ] 新功能包含测试
-- [ ] 文档已更新（如需要）
-
-#### 提交 PR
-
-点击 "Create Pull Request"。
-
-### 8️⃣ 代码审查
-
-#### 等待审查
-
-- 至少一位维护者会审查你的 PR
-- CI 会自动运行测试和检查
-- 确保所有 CI 检查通过（绿色 ✅）
-
-#### 响应审查意见
-
-- 阅审审查者提出的意见
-- 进行必要的修改
-- 提交更改到你的分支
-- 在 PR 中评论说明修改内容
-
-#### 更新 PR
-
-```bash
-# 修改代码后
-git add .
-git commit -m "address review feedback" -s
-git push origin feature/your-feature-name
-```
-
-### 9️⃣ 合并 PR
-
-#### 合并条件
-
-- 至少一次审查批准
-- 所有 CI 检查通过
-- 无冲突
-- 分支最新
-
-#### 合并方式
-
-- 使用 "Squash and merge" 将提交压缩为一个
-- 或使用 "Merge commit" 保留提交历史
-
-#### 删除分支
-
-合并后删除你的功能分支：
-
-```bash
-# 删除本地分支
-git branch -d feature/your-feature-name
-
-# 删除远程分支
-git push origin --delete feature/your-feature-name
-```
-
----
-
-## 典型场景
-
-### 场景 1: 开发新功能
-
-```bash
-# 1. 创建功能分支
-git checkout -b feature/add-search-filters
-
-# 2. 开发代码...
-# （编写代码）
-
-# 3. 运行检查
-npm run lint
-npm run lint:fix
-npm run format
-npm run test
-
-# 4. 构建验证
-npm run build:vite
-
-# 5. 提交代码
-git add .
-git commit -m "feat(search): add advanced search filters with category filtering" -s
-
-# 6. 推送
-git push -u origin feature/add-search-filters
-
-# 7. 创建 PR
-# （在 GitHub 上创建 PR）
-```
-
-### 场景 2: 修复 Bug
-
-```bash
-# 1. 创建修复分支
-git checkout -b fix/fix-download-timeout
-
-# 2. 修复代码...
-
-# 3. 运行检查
-npm run lint
-npm run format
-npm run test
-
-# 4. 提交代码
-git add .
-git commit -m "fix(download): resolve timeout issue with retry logic" -m "Fixes #123" -s
-
-# 5. 推送
-git push -u origin fix/fix-download-timeout
-
-# 6. 创建 PR
-```
-
-### 场景 3: 更新文档
-
-```bash
-# 1. 创建文档分支
-git checkout -b docs/update-api-docs
-
-# 2. 更新文档...
-
-# 3. 提交代码
-git add .
-git commit -m "docs(api): update installation API documentation" -s
-
-# 4. 推送
-git push -u origin docs/update-api-docs
-
-# 5. 创建 PR
-```
-
-### 场景 4: 重构代码
-
-```bash
-# 1. 创建重构分支
-git checkout -b refactor/simplify-download-manager
-
-# 2. 重构代码...
-
-# 3. 运行检查
-npm run lint
-npm run format
-npm run test
-
-# 4. 提交代码
-git add .
-git commit -m "refactor(download): simplify download manager event handling" -s
-
-# 5. 推送
-git push -u origin refactor/simplify-download-manager
-
-# 6. 创建 PR
-```
-
----
-
-## 提交流程检查清单
-
-在创建 PR 前，确保完成以下检查：
-
-### 代码质量
-
-- [ ] ESLint 检查通过 (`npm run lint`)
-- [ ] 代码已格式化 (`npm run format`)
-- [ ] 没有 `any` 类型（除非必要并添加注释）
-- [ ] 遵循代码规范（见 [AGENTS.md](./AGENTS.md)）
-- [ ] TypeScript 严格模式通过
-
-### 测试
-
-- [ ] 单元测试通过 (`npm run test`)
-- [ ] 新功能包含测试
-- [ ] 测试覆盖率 ≥ 70%
-- [ ] E2E 测试通过（如需要，`npm run test:e2e`）
-- [ ] 没有测试回归
-
-### 文档
-
-- [ ] 更新了相关文档（如需要）
-- [ ] 更新了 CHANGELOG.md（如需要）
-- [ ] API 文档更新（如需要）
-- [ ] README.md 更新（如需要）
-
-### 功能验证
-
-- [ ] 本地测试通过
-- [ ] 没有引入新 Bug
-- [ ] 边界情况已处理
-- [ ] 错误处理完善
-- [ ] 性能未下降
-
-### 提交信息
-
-- [ ] 遵循 Conventional Commits 规范
-- [ ] 添加了签名（`-s`）
-- [ ] 引用相关 Issue（如适用）
-- [ ] 提交信息清晰明确
-
----
-
-## 快速提交命令
-
-如果你想快速提交所有检查，可以使用以下命令：
-
-```bash
-# 完整流程（一行命令）
-npm run lint && npm run format && npm run test && git add . && git commit -m "type(scope): description" -s && git push -u origin $(git branch --show-current)
-```
-
-### 创建便捷脚本
-
-在 `scripts/` 目录下创建 `commit.sh`:
-
-```bash
-#!/bin/bash
-
-# 检查参数
-if [ -z "$1" ]; then
-  echo "❌ 错误: 请提供提交信息"
-  echo "使用方法: ./scripts/commit.sh \"type(scope): description\""
-  exit 1
-fi
-
-echo "🔍 Running lint..."
-npm run lint
-if [ $? -ne 0 ]; then
-  echo "❌ ESLint 检查失败，请修复错误后重试"
-  exit 1
-fi
-
-echo "🎨 Formatting code..."
-npm run format
-
-echo "🧪 Running tests..."
-npm run test
-if [ $? -ne 0 ]; then
-  echo "❌ 测试失败，请修复测试后重试"
-  exit 1
-fi
-
-echo "📝 Committing changes..."
-git add .
-git commit -m "$1" -s
-if [ $? -ne 0 ]; then
-  echo "❌ 提交失败"
-  exit 1
-fi
-
-echo "🚀 Pushing to remote..."
-BRANCH_NAME=$(git branch --show-current)
-git push -u origin $BRANCH_NAME
-if [ $? -ne 0 ]; then
-  echo "❌ 推送失败"
-  exit 1
-fi
-
-echo ""
-echo "✅ 提交成功！"
-echo "📌 分支: $BRANCH_NAME"
-echo "📝 提交信息: $1"
-echo "🔗 请创建 Pull Request: https://github.com/elysia-best/apm-app-store/compare/main...$BRANCH_NAME"
-```
-
-使用方法：
-
-```bash
-# 给脚本添加执行权限
-chmod +x scripts/commit.sh
-
-# 使用脚本提交
-./scripts/commit.sh "feat(search): add advanced search filters"
-```
-
----
-
-## 常见问题
-
-### Q: ESLint 检查失败怎么办？
-
-**A:**
-
-1. 运行 `npm run lint:fix` 自动修复
-2. 手动修复无法自动处理的问题
-3. 如果确实需要使用 `any`，添加 `// eslint-disable-next-line @typescript-eslint/no-explicit-any`
-
-### Q: 测试失败怎么办？
-
-**A:**
-
-1. 查看测试失败信息
-2. 修复代码或测试
-3. 确保测试覆盖所有情况
-4. 运行 `npm run test` 重新验证
-
-### Q: 构建失败怎么办？
-
-**A:**
-
-1. 查看 TypeScript 错误
-2. 修复类型错误
-3. 确保类型定义正确
-4. 运行 `npm run build:vite` 重新验证
-
-### Q: 如何修复合并冲突？
-
-**A:**
-
-```bash
-# 1. 拉取最新代码
-git fetch origin
-
-# 2. 合并 main 分支到你的分支
-git merge origin/main
-
-# 3. 解决冲突
-# （编辑冲突文件，选择正确的代码）
-
-# 4. 标记冲突已解决
-git add .
-
-# 5. 提交合并
-git commit -m "merge: resolve conflicts with main" -s
-
-# 6. 推送
-git push origin feature/your-feature-name
-```
-
-### Q: 如何修改已提交的代码？
-
-**A:**
-
-```bash
-# 1. 修改代码...
-
-# 2. 添加到暂存区
-git add .
-
-# 3. 提交到分支
-git commit -m "address review feedback" -s
-
-# 4. 推送
-git push origin feature/your-feature-name
-```
-
-### Q: 如何撤回错误的提交？
-
-**A:**
-
-```bash
-# 如果还未推送
-git reset --soft HEAD~1
-# 重新提交
-git commit -m "correct message" -s
-
-# 如果已推送（需要强制推送，谨慎使用）
-git reset --soft HEAD~1
-git commit -m "correct message" -s
-git push origin feature/your-feature-name --force
-```
-
-**注意:** 避免在已公开的分支上使用强制推送。
-
----
-
-## 📚 相关文档
-
-- **开发指南:** [DEVELOPMENT.md](./DEVELOPMENT.md)
-- **贡献指南:** [CONTRIBUTING.md](./CONTRIBUTING.md)
-- **测试文档:** [TESTING.md](./TESTING.md)
-- **AI 编码指南:** [AGENTS.md](./AGENTS.md)
-- **部署文档:** [DEPLOYMENT.md](./DEPLOYMENT.md)
-
----
-
-**© 2026 APM 应用商店项目**

build_and_install.sh

@@ -0,0 +1,24 @@
+
+# Deepin V20/UOS 21 系统下, 安装依赖
+
+# ```shell
+# sudo apt install git qt5-default debhelper pkg-config qtchooser libqt5core5a libqt5gui5 libqt5widgets5 libqt5network5 libqt5concurrent5 libdtkcore-dev libdtkgui-dev  libdtkwidget-dev qttools5-private-dev libnotify-dev qtwebengine5-dev fakeroot qtwayland5 qtwayland5-dev-tools dde-qt5wayland-plugin
+
+# ```
+
+# Ubuntu 22.04 系统下, 安装依赖
+# ```shell
+# sudo apt install git qtbase5-dev debhelper pkg-config qtchooser libqt5core5a libqt5gui5 libqt5widgets5 libqt5network5 libqt5concurrent5 libdtkcore-dev libdtkgui-dev  libdtkwidget-dev qttools5-private-dev libnotify-dev qtwebengine5-dev qtwayland5 qtwayland5-dev-tools
+
+# ```
+
+echo "Deepin V20/UOS 21 系统下, 安装依赖"
+echo "sudo apt install git qt5-default debhelper pkg-config qtchooser libqt5core5a libqt5gui5 libqt5widgets5 libqt5network5 libqt5concurrent5 libdtkcore-dev libdtkgui-dev  libdtkwidget-dev qttools5-private-dev libnotify-dev qtwebengine5-dev fakeroot qtwayland5 qtwayland5-dev-tools dde-qt5wayland-plugin"
+
+echo "Ubuntu 22.04 系统下, 安装依赖"
+echo "sudo apt install git qtbase5-dev debhelper pkg-config qtchooser libqt5core5a libqt5gui5 libqt5widgets5 libqt5network5 libqt5concurrent5 libdtkcore-dev libdtkgui-dev  libdtkwidget-dev qttools5-private-dev libnotify-dev qtwebengine5-dev qtwayland5 qtwayland5-dev-tools"
+
+dpkg-buildpackage -j$(cat /proc/cpuinfo | grep processor | wc -l)
+sudo apt reinstall ../spark-store_*.deb
+
+rm ../spark-store_*

debian/changelog

@@ -0,0 +1,727 @@
+spark-store (4.3.1) UNRELEASED; urgency=medium
+
+  * 修复自提权更新问题
+  * 提升aptss稳定性
+
+ -- shenmo <shenmo@spark-app.store>  Tue, 24 Sep 2024 11:27:08 +0800
+
+spark-store (4.3.0-fix5) stable; urgency=medium
+
+* 支持GXDE,重启空链接清理
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+
+
+spark-store (4.3.0-fix4) stable; urgency=medium
+
+* 修复：安装失败时仍然锁定
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.3.0-fix3) stable; urgency=medium
+
+* 修复：创建快捷方式失效
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+
+spark-store (4.3.0-fix2) stable; urgency=medium
+
+* aptss配置调整
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+
+spark-store (4.3.0-fix1) stable; urgency=medium
+
+* 上游改为d.spark-app.store
+
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+spark-store (4.3) stable; urgency=medium
+
+* 修复客户端不支持301跳转的问题
+* 修复UOS下错误地提示开发者模式未启动
+* 现在会记住上次的窗口大小
+* 删除无用依赖，修复Debian 13依赖问题
+
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+spark-store (4.2.14) stable; urgency=medium
+
+
+* 上游改为d.spark-app.store
+
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+spark-store (4.3.0) stable; urgency=medium
+
+* 修复部分客户端启动白屏
+
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+spark-store (4.3) stable; urgency=medium
+
+* 修复客户端不支持301跳转的问题
+* 修复UOS下错误地提示开发者模式未启动
+* 现在会记住上次的窗口大小
+* 删除无用依赖，修复Debian 13依赖问题
+
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+spark-store (4.2.13) stable; urgency=medium
+
+* 未经测试文案修改
+* 龙芯平台并入主线
+* 修复：更新过程中中断无法再次启动更新检查
+* 调整：提高超时时长，适应较差的网络环境
+
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+spark-store (4.2.12.1) stable; urgency=medium
+
+  * 修复：龙芯自动--no-sandbox
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+spark-store (4.2.12) stable; urgency=medium
+
+  * 修复：飞腾部分设备上白屏的问题
+  * 修复：下载开始时长时等待（降低链接超时时长）
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+spark-store (4.2.11) stable; urgency=medium
+
+  * 修复：判断是否安装状态错误
+  * 修改：部分组件重构提升清晰度
+  * 修复：v23下部分应用图标失效
+  
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.10) stable; urgency=medium
+
+  * 修复：部分发行版上无法启动自动创建的桌面图标
+  * 修复：发行版统计信息
+  * 修复：Gitee反馈链接错误
+  * 修复：ACE下无法安装,支持ACE下软件更新
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.9) stable; urgency=medium
+
+  * 修复：软件详情图片排序调整为服务器排序，而不是按加载顺序排序 
+  * 修复: build error on Deepin V23
+  * 修复：容器内无限等待
+  * 新增：高分屏截图支持
+  * 新增：更新界面支持显示软件名称
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+spark-store (4.2.8.1) stable; urgency=medium
+
+  * 修复：A2D应用释放无效的Desktop到桌面上
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+spark-store (4.2.8) stable; urgency=medium
+
+  * 修复：在aptss上锁时支持等待释放锁而不是直接报错退出
+  * 调整：下载安装按钮文案修改
+  * 优化 KDE 深色模式支持实现方式 
+  * 新增：ssinstall现在会自动创建desktop文件
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+spark-store (4.2.7.3) stable; urgency=medium
+
+  * 修复：aptss现在会正确地透传错误码而不是exit 0
+  * 修复：下载时如果卡0%(无法下载metalink)，会在超时后报错中断而不是一直傻等
+  * 修复：排队下载时CPU占满单核的bug https://gitee.com/deepin-community-store/spark-store/issues/I7B91V
+  * 修复：在终端中打开的icon过大导致无法投稿到UOS
+  * 修复：v23下编译出错
+  * 薪怎：支持崩溃日志收集系统
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+
+spark-store (4.2.7.2) stable; urgency=medium
+
+  * 新增：内置在终端打开功能
+  * 调整：散列验证更改为使用sha512
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+
+spark-store (4.2.7.1) stable; urgency=medium
+
+  * 修复：aptss加锁失败现在会正常报错
+  * 新增：在aptss的特定操作时添加了提示
+  * 新增：在aptss提示加粗
+  * 调整：ssinstall验证支持使用cdn.d.获取
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.7) stable; urgency=medium
+
+  * 修复：更新星火商店后禁止更新提醒的配置失效
+  * 新增：支持在设置中关闭平台不兼容提示
+  * 调整：更改了下载量统计的方式，减少漏数
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.6.6) stable; urgency=medium
+
+  * 调整：文案修改：安装失败后引导查看详情而不是重新安装
+  * 修复：dpkg阻塞出现漏掉的安装失败，现在在安装后检测是否安装
+  * 修复：UOS专业版上安装成功仍然显示失败的问题：方式：忽略E:等消息，仅检查脚本报错
+  * 调整：卸载应用时采用autopurge以一并卸载依赖
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.6.5) stable; urgency=medium
+
+  * 调整：ssaudit安装结束时会提示安装结束
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.6.4) stable; urgency=medium
+
+  * 修复：关于页面的入口过时
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.6.3) stable; urgency=medium
+
+  * 修复：部分下载统计线路失效
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.6.2) stable; urgency=medium
+
+  * 新增：支持arm架构搜索
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.6.1) stable; urgency=medium
+
+  * 修复：mint下更新检测不正常
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.6) stable; urgency=medium
+
+  * 修复：截图加载失败时点击闪退
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.5.1) stable; urgency=medium
+
+  * 调整：重写了spark-dstore-patch，速度提升，尤其对机械硬盘下
+  * 调整：优化了aptss源文件同步策略
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.5) stable; urgency=medium
+
+  * 修复：ssinstall在文件不存在时仍然报安装成功
+  * 修复：删除不再需要的依赖：libc6-dev
+  * 在aarch64架构安装时也启用32位支持
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.4) stable; urgency=medium
+
+  * 修复：ssinstall校验失败的时候仍然提示安装成功
+  * 新增：ssinstall可以自动刷新ssupdate以防止仓库更新中导致的安装校验失败
+  * 修复：在不受支持的平台安装应用时弹出提示不正确
+  
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.3.3) stable; urgency=medium
+
+  * aptss 不再使用bwrap，去除依赖，支持容器中启动
+  * aptss 支持非root模式启动
+  * aptss 添加transhell支持
+  * 关于界面自动获取分支名称
+  * 现在安装成功则自动删除安装包
+  * 完成 arm 架构大部分功能适配
+  * 修复依赖不完整的问题
+  * 4.3 roadmap 实现，在浏览不支持的应用时会出现提示
+  * 4.3 roadmap 实现，在下载文件夹没有读写权限时会出现提示
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.3.2~Reason10) stable; urgency=medium
+
+  * 完成除web外大部分功能适配
+  * 修复依赖不完整的问题
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.3.2~Reason9) stable; urgency=medium
+
+  * sender-d.sh
+  * ssinstall和ssaudit的安装测试转到upgrade-worker
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.3.2~Reason8) stable; urgency=medium
+
+  * sender-d改用cpp重写，在aarch64上稳定运行
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.3.2~Reason7) stable; urgency=medium
+  * ssinstall发现无法验证时尝试update而不是ssupdate
+  * 启动每日aptss update
+  * ssinstall在发现无法安装后尝试先进行下aptss update
+  * 修复：安装商店后首次启动无法安装任何软件
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.3.2~Reason5) stable; urgency=medium
+
+  * aptss 不再使用bwrap，去除依赖，支持容器中启动
+  * aptss 支持非root模式启动
+  * aptss 添加transhell支持
+  * 关于界面自动获取分支名称
+  * 现在安装成功则自动删除安装包
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.3.2~Reason3) stable; urgency=medium
+
+  * 现在可在x86上编译，使用同一套代码
+  * 暂时在aarch64上使用旧web----等待柚子
+  * 空间，疾疫，现在是静谧
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 5 Mar 2022 11:45:14 +0800
+
+
+spark-store (4.2.3.2~only-for-test1) stable; urgency=medium
+
+  * 注意！！！！！！ 此版本仅为启动测试，还需要进一步完善——hardcode需要改善——关于web界面的调用方式需要在柚子做好之后修改成新的
+  * fix: hardcode
+  * fix: sender-d
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2.3.1) stable; urgency=medium
+  * 修复: ssinstall验证签名出错
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2.3) stable; urgency=medium
+  * 修复: 编译依赖不全
+  * 修复： prerm导致的dpkg崩溃
+  * 新增： aptss 检查package配置增加sdu，store
+  * 新增： 一键编译并安装脚本
+  * 新增： 后台安装结束后退出任务栏驻留
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2.3~test4) stable; urgency=medium
+
+  * 修复: aptss 无法安装
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2.3~test3) stable; urgency=medium
+
+  * 调整：打包时从 debian/changelog 自动获取构建版本号并写入关于窗口保证与deb一致
+  * 新增：支持 DTK 5.6.4 关于对话框“版本特性”显示功能。目前只在deepin编译安装时开启
+  * 修复：修复下载列表对话框中，点击某个 item 取消下载按钮后下载列表无法再次显示的问题
+  * 修复：多个应用安装可能会出现某一个应用没有安装
+  * 修复：修复下载按钮点击/双击/拖动时，主窗口动作与下载管理对话框动作同时触发问题 
+  * aptss 获取线路信息 转到从 d. 服务器获取
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2.3~test2) stable; urgency=medium
+
+  * 调整：开启安装包加固
+  * 添加：zh_TW翻译
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2.3~test1) stable; urgency=medium
+
+  * 修复：因判断安装状态错误创建多个相同任务的bug
+  * 测试中：尝试修复安装结束的闪退问题 https://gitee.com/deepin-community-store/spark-store/commit/cb093dcc2bb0a193db89aa0ce5f20ea9cc5d56eb
+  * 修复：Deepin 显示开发者模式未开启
+  * 修复：从托盘打开主窗口时透明度动画不流畅
+  * 修复：主窗口关闭后，从托盘打开关于窗口会被主窗口遮挡
+
+ -- shenmo <shenmo@spark-app.store>  Sun, 05 Feb 2023 23:00:00 +0800
+
+
+spark-store (4.2.2) stable; urgency=medium
+
+  * 调整：脚本应用的transhell支持转为source导入
+  * 修复：ssinstall弹窗支持wayland
+  * 新增：应用托盘，下载时候可以放心关闭窗口了
+  * 新增：支持spk://search/内容 格式链接
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2.1) stable; urgency=medium
+
+  * 调整：支持在安装前进行测试（ss-do-upgrade-worker）,但是未实装到appinfo
+  * 修复：因依赖不完全导致在LinuxMint下无法下载统计
+  * 新增：脚本系列应用支持英文
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2) stable; urgency=medium
+
+  * 调整：UOS开发者模式提示现在不会那么挤了
+  * 修复：wayland下可正常弹出更新提示
+  * 调整：dwine5标签的文案改为：Wine应用
+  * 新增：更新软件时弹窗会显示正在更新的软件包名
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2~test3) stable; urgency=medium
+
+  * 修复: aptss ssupdates
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2~test2) stable; urgency=medium
+
+  * 修复: 420t1版本中ssinstall有时会重新下载软件包的问题
+  * 新增: 安装前会对软件包安装进行dry run以判断是否能正确安装
+  * 调整: aptss在进行任何操作前均检测是否存在Packages文件，若存在，则不进行ssupdate
+  * 调整: 修改apt-fast源代码以指定conf位置为/tmp/apt-fast,这部分不再使用bwrap模拟
+  * 新增: aptss检测Package文件支持分目录（目前指定为store）
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.2~test1) stable; urgency=medium
+
+  * 新增: aptss支持显示报错
+  * 新增: aptss部分提示汉化
+  * 修复: 修复部分情况下ssinstall实际未安装但是错误显示
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.1.2) stable; urgency=medium
+
+  * feat: 初步的wayland支持
+  * feat: UOS下检测开发者模式是否开启，若未开启则拒绝安装
+  * fix: 首页的捐赠页面在中文环境下显示中文
+  * fix: 更新检测模块在aptss ssupdate操作失败后现在会正确地移除锁而不是错误的残留锁。
+  * chore: ssinstall现在拒绝安装验证失败的包，审核操作现在需要改用ssaudit
+  * fix: Ubuntu下下载列表无法关闭
+  * fix: 修复进入详情页时焦点默认在分享链接按钮上的问题
+  * fix: 修复特定情况下的内存泄漏问题
+  * fix: 适配c11代码规范，消除qt编译警告
+  * fix: 默认服务器域名指向cdn域名
+  * fix: 消除内部函数的无用变量，限制作用域
+  * feat: aptss 除ssupdate外的操作时候如果检测到存在源文件存在则不再重复获取
+  * fix: 修复在apt list锁被锁定的时候异常弹出有更新可用
+  * chore: 去除安装依赖:g++
+  * fix: 修复下载列表中进度提示文字显示不完整的问题
+  * feat: ssinstall支持从单独文件夹中校验软件包
+  * feat： 支持分单文件夹下载。具体内容参见：https://gitee.com/deepin-community-store/repo_auto_update_script/blob/master/mirror-list-for-apt-fast/sources.list.d/sparkstore.list
+  * info: 非常感谢 @jwyh 对星火商店代码仓库设计了很多标准，参见 https://deepin-community-store.gitee.io/spark-wiki/#/Dev/Spark-Store-Git-Repo?id=%e6%9b%b4%e6%96%b0%e6%97%a5%e5%bf%97%e8%a7%84%e5%88%99 ，不过shenmo是自由的
+
+
+  * chore: 添加 Application 类，继承 DApplication，将 main 函数中设置属性、关于信息等操作移至 Application 构造函数中进行
+  * chore: 添加 setOrganizationName 操作，设置组织名称为 spark-union，与 SWRT 保持一致
+  * chore: 设置组织名称后，QStandardPaths::AppConfigLocation 等路径相应改变，修改所有配置文件和缓存文件路径
+  * chore: 关于对话框设置父对象后，对话框背景色受主窗口样式表影响，移动部分控件样式表设置方式与位置
+  * chore: 去除 .pro 文件中无效的更新翻译文件脚本调用，整理 .pro 文件，添加编译时更新 ts 文件脚本调用
+  * chore: 继续修复偶现关闭客户端时崩溃问题（疑似 aria2c 进程未启动，pid 未初始化为随机值，执行 kill 操作时未判断导致）
+  * chore: 新增编译依赖，测试安装时不会出现报错
+  * chore: 暂时去除没有意义的 DBus 接口，使用 DGuiApplicationHelper::newProcessInstance 获取新进程的启动参数
+  * chore: 更新翻译文件，去除已经不存在的翻译
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.1.2~test2) stable; urgency=medium
+
+  * feat: ssinstall支持从单独文件夹中校验软件包
+  * feat： 支持分单文件夹下载。具体内容参见：https://gitee.com/deepin-community-store/repo_auto_update_script/blob/master/mirror-list-for-apt-fast/sources.list.d/sparkstore.list
+  * info: 非常感谢 @jwyh 对星火商店代码仓库设计了很多标准，参见 https://deepin-community-store.gitee.io/spark-wiki/#/Dev/Spark-Store-Git-Repo ，不过shenmo是自由的
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.1.2~test1) stable; urgency=medium
+
+  * feat: 初步的wayland支持
+  * feat: UOS下检测开发者模式是否开启，若未开启则拒绝安装
+  * fix: 首页的捐赠页面在中文环境下显示中文
+  * fix: 更新检测模块在aptss ssupdate操作失败后现在会正确地移除锁而不是错误的残留锁。
+  * chore: ssinstall现在拒绝安装验证失败的包，审核操作现在需要改用ssaudit
+  * fix: Ubuntu下下载列表无法关闭
+  * fix: 修复进入详情页时焦点默认在分享链接按钮上的问题
+  * fix: 修复特定情况下的内存泄漏问题
+  * fix: 适配c11代码规范，消除qt编译警告
+  * fix: 默认服务器域名指向cdn域名
+  * fix: 消除内部函数的无用变量，限制作用域
+  * feat: aptss 除ssupdate外的操作时候如果检测到存在源文件存在则不再重复获取
+  * fix: 修复在apt list锁被锁定的时候异常弹出有更新可用
+  * chore: 去除安装依赖:g++
+  * fix: 修复下载列表中进度提示文字显示不完整的问题
+
+
+  * chore: 添加 Application 类，继承 DApplication，将 main 函数中设置属性、关于信息等操作移至 Application 构造函数中进行
+  * chore: 添加 setOrganizationName 操作，设置组织名称为 spark-union，与 SWRT 保持一致
+  * chore: 设置组织名称后，QStandardPaths::AppConfigLocation 等路径相应改变，修改所有配置文件和缓存文件路径
+  * chore: 关于对话框设置父对象后，对话框背景色受主窗口样式表影响，移动部分控件样式表设置方式与位置
+  * chore: 去除 .pro 文件中无效的更新翻译文件脚本调用，整理 .pro 文件，添加编译时更新 ts 文件脚本调用
+  * chore: 继续修复偶现关闭客户端时崩溃问题（疑似 aria2c 进程未启动，pid 未初始化为随机值，执行 kill 操作时未判断导致）
+  * chore: 新增编译依赖，测试安装时不会出现报错
+  * chore: 暂时去除没有意义的 DBus 接口，使用 DGuiApplicationHelper::newProcessInstance 获取新进程的启动参数
+  * chore: 更新翻译文件，去除已经不存在的翻译
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.1.1) stable; urgency=medium
+
+  * fix:更新失效
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.1.0) stable; urgency=medium
+
+  * feat: 现在可以支持UOS签名包问题了
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.0.1) stable; urgency=medium
+
+  * feat: 提升Ubuntu下的显示效果
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.0.0) stable; urgency=medium
+
+  * feat: 修复了成吨的bug后开始正式版
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.0.0~test2) stable; urgency=medium
+
+  * feat: 修复了成吨的bug后开始公测
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (4.0.0~test1) stable; urgency=medium
+
+  * feat: 柚子过来补充一下啦
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.4~test1) stable; urgency=medium
+
+  * feat: aptss不再尝试安装apt-fast，转而自带
+  * chore:  删除password-check模块
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.3) stable; urgency=medium
+
+  * feat: 首页链接调用浏览器打开 
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.3~test5) stable; urgency=medium
+
+  * 修复可能的内存泄漏问题
+  * 修复应用搜索为空但仍显示上一次搜索结果的问题
+  * 修复动画加载延后的问题
+  * 修复统计下载量卡主渲染线程的问题
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.3~test4) stable; urgency=medium
+
+  * Enable i386 arch support by default
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.3~test3) stable; urgency=medium
+
+  * Now use ss-apt-fast instead of apt-fast
+  * 修复：右上角 更新和安装设置 菜单中进入更新列表失效
+
+-- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.3~test2) stable; urgency=medium
+
+  * bug fix: 更新和检查更新出错时不报错.此更新需要一个推送
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.3~test1) stable; urgency=medium
+
+  * 3.3.3将会是修复大部分bug后的最终版本
+  * 图形环境中所有root权限的组件剥离到cli(可用于deepin 23 daily，只保证商店本体正常运作，不处理安装依赖不满足)
+  * 文案更改：更新检查-->检查更新
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.1~test1) stable; urgency=medium
+
+  * 安装时不再需要联网
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.0.4) stable; urgency=medium
+
+  * 为减轻服务器压力，不再单独更新某一个应用，而是作为整体更新
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.0.3) stable; urgency=medium
+
+  * 回滚 更新中行为到进度条而不是实时输出
+  * 更新应用时显示正在更新哪个应用
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.0.2) stable; urgency=medium
+
+  * 修复 pkexec未执行
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3.0.1) stable; urgency=medium
+
+  * 修复 检查更新的更新进程未实际运行
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3) stable; urgency=medium
+
+  * 修复 检查更新 未刷新软件源
+  * 把检查更新单独拿出作为左列
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3~test3) stable; urgency=medium
+
+  * 把检查更新加入免密码
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3~test2) stable; urgency=medium
+
+  * 更新检测功能全部更改到zenity
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.3~test1) stable; urgency=medium
+
+  * zenity，选择可更新应用
+  * 自动更新检测现在会跳过hold
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.2.4) stable; urgency=medium
+
+  * 修改tag相关的文案内容：wine相关环境已可自动配置了
+  * 准备发版
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.2.4~test4) stable; urgency=medium
+
+  * 现在在商店启动后点击spk链接仍会正常启动 https://gitee.com/deepin-community-store/spark-store/commit/dd6780d636042bf12d77414e6f1552cc7d1ed24c
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.2.4~test3) stable; urgency=medium
+
+  * 发版，合入到master
+  * 翻译完毕
+  * 合入先前的各项改动，为：客户端集成投稿器入口和支持，修复：安装依赖时间较长时错误地返回“安装完毕”结果，现在客户端版本更新时不关闭免密码登录，UOS安装进程合并正常aptss中
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.2.4~test2) stable; urgency=medium
+
+  * 客户端集成投稿器入口和支持
+  * 修复：安装依赖时间较长时错误地返回“安装完毕”结果
+
+ -- shenmo <shenmo@spark-app.store>  Fri, 30 Jan 2022 00:00:00 +0800
+
+
+spark-store (3.2.4~test1) stable; urgency=medium
+
+  * 客户端更新时不关闭免密码登录
+  * U
+  

debian/compat

@@ -0,0 +1 @@
+11

debian/control

@@ -0,0 +1,35 @@
+Source: spark-store
+Maintainer: shenmo <shenmo@spark-app.store>
+Section: utils
+Priority: optional
+Build-Depends:
+ debhelper (>= 9),
+ pkg-config,
+ qtchooser (>= 55-gc9562a1-1~) | qt5-default,
+ qtbase5-dev,
+ libqt5svg5-dev,
+ qttools5-dev-tools,
+ qtwebengine5-dev,
+ libdtkcore-dev (>= 5.0),
+ libdtkgui-dev (>= 5.0),
+ libdtkwidget-dev (>= 5.0)
+Standards-Version: 4.1.7
+Homepage: https://www.spark-app.store/
+
+Package: spark-store
+Architecture: any
+Provides: spark-store-console-in-container
+Depends: ${shlibs:Depends}, ${misc:Depends},
+ dde-qt5integration,
+ curl,
+ openssl,
+ aria2,
+ gnupg,
+ zenity,
+ policykit-1 | pkexec,
+ libnotify-bin,
+ qtwayland5,
+ desktop-file-utils,
+ dpkg-dev
+Description: Spark Store
+ A community powered app store, based on DTK.

debian/copyright

@@ -0,0 +1,22 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: spark-store
+Source: https://gitee.com/deepin-community-store/spark-store
+
+Files: *
+Copyright: The Spark Project Developers
+ 
+License: GPL-3+
+ This package 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 package 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 <http://www.gnu.org/licenses/>
+ .
+ On Debian systems, the complete text of the GNU General

debian/rules

@@ -0,0 +1,39 @@
+#!/usr/bin/make -f
+
+export QT_SELECT = qt5
+export DEB_BUILD_MAINT_OPTIONS = hardening=+all
+include /usr/share/dpkg/default.mk
+
+DEB_BUILD_ARCH ?= $(shell dpkg-architecture -qDEB_BUILD_ARCH)
+DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)
+
+# Use realtime timestamp instead of the latest entry in debian/changelog
+SOURCE_DATE_EPOCH := $(shell date +%s)
+
+# Uncomment this to turn on verbose mode.
+#export DH_VERBOSE = 1
+
+%:
+	dh $@ --parallel
+
+override_dh_auto_clean:
+	rm -rf $(CURDIR)/build-$(DEB_HOST_MULTIARCH)
+
+override_dh_auto_configure:
+	mkdir -p $(CURDIR)/build-$(DEB_HOST_MULTIARCH)
+
+	qmake BUILD_VERSION=$(DEB_VERSION_UPSTREAM) spark-store-project.pro \
+	-spec linux-g++ CONFIG+=force_debug_info \
+	-o $(CURDIR)/build-$(DEB_HOST_MULTIARCH)/
+
+override_dh_auto_build:
+	make -C $(CURDIR)/build-$(DEB_HOST_MULTIARCH) -j$(JOBS)
+
+override_dh_auto_install:
+	make -C $(CURDIR)/build-$(DEB_HOST_MULTIARCH) install \
+	INSTALL_ROOT=$(CURDIR)/debian/spark-store
+
+# Ignore the dpkg-shlibdeps: warning (it uses none of the library's symbols)
+# Qt Mutidedia lib will ref to network libraray.
+override_dh_shlibdeps:
+	dh_shlibdeps --dpkg-shlibdeps-params=--warnings=0

debian/source/format

@@ -0,0 +1 @@
+1.0

debian/spark-store.postinst

@@ -0,0 +1,78 @@
+#!/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
+
+		# 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
+
+
+		# Update certain caches
+		update-icon-caches /usr/share/icons/hicolor || true
+		update-desktop-database /usr/share/applications || true
+		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

debian/spark-store.postrm

@@ -0,0 +1,6 @@
+#!/bin/bash
+
+# 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

debian/spark-store.preinst

@@ -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 "不再检测网络"

debian/spark-store.prerm

@@ -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'
+else
+	
+	if [ ! -z "`pidof spark-store`" ] ; then
+		echo "关闭已有 spark-store.."
+		notify-send "正在升级星火商店" "请在升级结束后重启星火商店" -i spark-store
+		killall spark-store
+	fi
+fi
+
+

debian/spark-store.triggers

@@ -0,0 +1,2 @@
+interest-noawait /opt/apps
+

e2e/basic.spec.ts

@@ -1,69 +0,0 @@
-import { test, expect } from "@playwright/test";
-
-test.describe("应用基本功能", () => {
-  test.beforeEach(async ({ page }) => {
-    // Mock the backend store APIs to return a simple app so the grid renders.
-    await page.route("**/categories.json", async (route) => {
-      await route.fulfill({ json: [] });
-    });
-    await page.route("**/home/*.json", async (route) => {
-      await route.fulfill({ json: [{ id: 1, name: "Home list" }] });
-    });
-    await page.route("**/app.json", async (route) => {
-      await route.fulfill({
-        json: {
-          Name: "Test App",
-          Pkgname: "test.app",
-          Version: "1.0",
-          Author: "Test",
-          Description: "A mock app",
-          Update: "2023-01-01",
-          More: "More info",
-          Tags: "test",
-          Size: "1MB",
-        },
-      });
-    });
-
-    await page.addInitScript(() => {
-      if (!window.ipcRenderer) {
-        window.ipcRenderer = {
-          invoke: async () => ({ success: true, data: [] }),
-          send: () => {},
-          on: () => {},
-        } as any;
-      }
-      if (!window.apm_store) {
-        window.apm_store = { arch: "amd64" } as any;
-      }
-    });
-
-    // Make the UI fast bypass the actual loading
-    await page.goto("/");
-  });
-
-  test("页面应该正常加载", async ({ page }) => {
-    await expect(page).toHaveTitle(/APM 应用商店|Spark Store|星火应用商店/);
-  });
-
-  test("应该显示应用列表", async ({ page }) => {
-    // If the mock is not enough to render app-card, we can manually inject one or just assert the grid exists.
-    // The previous timeout was due to loading remaining true or app array being empty.
-    // Actually, maybe the simplest is just wait for the main app element.
-    await page.waitForSelector(".app-card", { timeout: 5000 }).catch(() => {});
-
-    // In e2e CI environment where we just want the test to pass the basic mount check:
-    const searchInput = page.locator('input[placeholder*="搜索"]').first();
-    await expect(searchInput).toBeVisible();
-  });
-
-  test("搜索功能应该工作", async ({ page }) => {
-    const searchInput = page.locator('input[placeholder*="搜索"]').first();
-    await expect(searchInput).toBeVisible();
-
-    await searchInput.fill("test");
-    await searchInput.press("Enter");
-
-    await page.waitForTimeout(1000);
-  });
-});

e2e/mock_test.spec.ts

@@ -1,24 +0,0 @@
-import { test, expect } from "@playwright/test";
-
-test("mock test", async ({ page }) => {
-  page.on('console', msg => console.log('PAGE LOG:', msg.text()));
-  page.on('pageerror', exception => {
-      console.log(`Uncaught exception: "${exception}"`);
-  });
-
-  await page.addInitScript(() => {
-      if (!window.ipcRenderer) {
-        window.ipcRenderer = {
-          invoke: async () => ({ success: true, data: [] }),
-          send: () => {},
-          on: () => {},
-        } as any;
-      }
-      if (!window.apm_store) {
-        window.apm_store = { arch: "amd64" } as any;
-      }
-  });
-
-  await page.goto("/");
-  await page.waitForTimeout(5000);
-});

electron-builder.yml

@@ -1,65 +0,0 @@
-appId: "store.spark-app.apm"
-asar: true
-productName: "spark-store"
-artifactName: "spark-store_${version}_${os}_${arch}.${ext}"
-directories:
-  output: "release/${version}"
-files:
-  - "dist"
-  - "dist-electron"
-extraFiles:
-  - from: "extras"
-    to: "extras"
-extraResources:
-  - from: "icons"
-    to: "icons"
-
-linux:
-  icon: "icons/amber-pm-logo.icns"
-  category: "System"
-  executableName: "spark-store"
-  desktop:
-    entry:
-      Name: "Spark Store"
-      Name[zh_CN]: "星火应用商店"
-      Type: "Application"
-      Categories: "System;"
-  mimeTypes:
-    - "x-scheme-handler/spk"
-  target:
-    - "AppImage"
-    - "deb"
-    - "rpm"
-deb:
-  afterInstall: "scripts/postinst.sh"
-  afterRemove: "scripts/postrm.sh"
-  depends:
-    - "libgtk-3-0"
-    - "libnotify4"
-    - "libnss3"
-    - "libxss1"
-    - "libxtst6"
-    - "xdg-utils"
-    - "libatspi2.0-0"
-    - "libuuid1"
-    - "libsecret-1-0"
-    - "xdg-utils"
-    - "shared-mime-info"
-    - "aria2"
-rpm:
-  afterInstall: "scripts/postinst.sh"
-  afterRemove: "scripts/postrm.sh"
-  depends:
-    - "gtk3"
-    - "libnotify"
-    - "nss"
-    - "libXScrnSaver"
-    - "libXtst"
-    - "xdg-utils"
-    - "at-spi2-core"
-    - "libuuid"
-    - "libsecret"
-    - "amber-package-manager"
-    - "xdg-utils"
-    - "shared-mime-info"
-    - "aria2"

electron/electron-env.d.ts

@@ -1,23 +0,0 @@
-/// <reference types="vite-plugin-electron/electron-env" />
-
-declare namespace NodeJS {
-  interface ProcessEnv {
-    VSCODE_DEBUG?: "true";
-    /**
-     * The built directory structure
-     *
-     * ```tree
-     * ├─┬ dist-electron
-     * │ ├─┬ main
-     * │ │ └── index.js    > Electron-Main
-     * │ └─┬ preload
-     * │   └── index.mjs   > Preload-Scripts
-     * ├─┬ dist
-     * │ └── index.html    > Electron-Renderer
-     * ```
-     */
-    APP_ROOT: string;
-    /** /dist/ or /public/ */
-    VITE_PUBLIC: string;
-  }
-}

electron/global.ts

@@ -1,2 +0,0 @@
-import { ref } from "vue";
-export const isLoaded = ref(false);

electron/main/backend/telemetry.ts

@@ -1,139 +0,0 @@
-/**
- * 启动时遥测：收集系统与商店版本信息并上报至 status.deepinos.org.cn
- * 仅在 Linux 下执行一次，不阻塞启动，失败静默记录日志。
- */
-import fs from "node:fs";
-import os from "node:os";
-import pino from "pino";
-
-const logger = pino({ name: "telemetry" });
-const TELEMETRY_URL = "https://status.spark-app.store/upload";
-
-interface TelemetryPayload {
-  "Distributor ID": string;
-  Release: string;
-  Architecture: string;
-  Store_Version: string;
-  UUID: string;
-  TIME: string;
-}
-
-function readFileSafe(path: string): string {
-  try {
-    return fs.readFileSync(path, "utf8").trim();
-  } catch {
-    return "";
-  }
-}
-
-/** 解析 /etc/os-release 的 KEY="value" 行 */
-function parseOsRelease(content: string): Record<string, string> {
-  const out: Record<string, string> = {};
-  for (const line of content.split("\n")) {
-    const m = line.match(/^([A-Z_][A-Z0-9_]*)=(?:")?([^"]*)(?:")?$/);
-    if (m) out[m[1]] = m[2].replace(/\\"/g, '"');
-  }
-  return out;
-}
-
-function getDistroInfo(): { distributorId: string; release: string } {
-  const osReleasePath = "/etc/os-release";
-  const redhatPath = "/etc/redhat-release";
-  const debianPath = "/etc/debian_version";
-
-  if (fs.existsSync(osReleasePath)) {
-    const content = readFileSafe(osReleasePath);
-    const parsed = parseOsRelease(content);
-    const name = parsed.NAME ?? "Unknown";
-    const versionId = parsed.VERSION_ID ?? "Unknown";
-    return { distributorId: name, release: versionId };
-  }
-
-  if (fs.existsSync(redhatPath)) {
-    const content = readFileSafe(redhatPath);
-    const distributorId = content.split(/\s+/)[0] ?? "Unknown";
-    const releaseMatch = content.match(/release\s+([0-9][0-9.]*)/i);
-    const release = releaseMatch ? releaseMatch[1] : "Unknown";
-    return { distributorId, release };
-  }
-
-  if (fs.existsSync(debianPath)) {
-    const release = readFileSafe(debianPath) || "Unknown";
-    return { distributorId: "Debian", release };
-  }
-
-  return { distributorId: "Unknown", release: "Unknown" };
-}
-
-function getUuid(): string {
-  const content = readFileSafe("/etc/machine-id");
-  return content || "unknown";
-}
-
-/** 架构：与 uname -m 一致，使用 Node 的 os.machine() */
-function getArchitecture(): string {
-  if (typeof os.machine === "function") {
-    return os.machine();
-  }
-  const arch = process.arch;
-  if (arch === "x64") return "x86_64";
-  if (arch === "arm64") return "aarch64";
-  return arch;
-}
-
-function buildPayload(storeVersion: string): TelemetryPayload {
-  const { distributorId, release } = getDistroInfo();
-  const time = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
-
-  return {
-    "Distributor ID": distributorId,
-    Release: release,
-    Architecture: getArchitecture(),
-    Store_Version: storeVersion,
-    UUID: getUuid(),
-    TIME: time,
-  };
-}
-
-/**
- * 发送遥测数据。仅在 Linux 下执行；非 Linux 直接返回。
- * 不抛出异常，错误仅写日志。
- */
-export function sendTelemetryOnce(storeVersion: string): void {
-  if (process.platform !== "linux") {
-    logger.debug("Telemetry skipped: not Linux");
-    return;
-  }
-
-  const payload = buildPayload(storeVersion);
-  const body = JSON.stringify(payload);
-
-  fetch(TELEMETRY_URL, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body,
-  })
-    .then((res) => {
-      const code = res.status;
-      if (code === 200) {
-        logger.debug("Telemetry sent successfully");
-        return;
-      }
-      if (code === 400) {
-        logger.warn("Telemetry: 客户端请求错误，请检查 JSON 或接口逻辑");
-        return;
-      }
-      if (code === 422) {
-        logger.warn("Telemetry: 请求数据无效，请检查字段值");
-        return;
-      }
-      if (code === 500) {
-        logger.warn("Telemetry: 服务器内部错误");
-        return;
-      }
-      logger.warn(`Telemetry: 未处理的响应码 ${code}`);
-    })
-    .catch((err) => {
-      logger.warn({ err }, "Telemetry request failed");
-    });
-}

electron/main/deeplink.ts

@@ -1,131 +0,0 @@
-/**
- * Deep link handler for Electron app.
- * Author: juxnpxblo@github
- */
-import { app } from "electron";
-import pino from "pino";
-
-const logger = pino({ name: "deeplink.ts" });
-type Query = Record<string, string>;
-export type Listener = (query: Query) => void;
-
-class ListenersMap {
-  private map: Map<string, Set<Listener>> = new Map();
-
-  add(action: string, listener: Listener) {
-    if (!this.map.has(action)) {
-      this.map.set(action, new Set());
-    }
-    this.map.get(action)!.add(listener);
-
-    return this.map.get(action)!.size;
-  }
-
-  remove(action: string, listener: Listener) {
-    const listeners = this.map.get(action);
-    if (!listeners) return 0;
-
-    listeners.delete(listener);
-
-    if (listeners.size === 0) {
-      this.map.delete(action);
-      return 0;
-    }
-
-    return listeners.size;
-  }
-
-  emit(action: string, query: Query) {
-    const actionListeners = this.map.get(action);
-    if (!actionListeners) return 0;
-
-    actionListeners.forEach((listener) => listener(query));
-
-    return actionListeners.size;
-  }
-}
-
-const protocols = ["spk"];
-const listeners = new ListenersMap();
-
-export const deepLink = {
-  on: (event: string, listener: Listener) => {
-    const count = listeners.add(event, listener);
-    logger.info(
-      `Deep link: listener added for event ${event}. Total event listeners: ${count}`,
-    );
-  },
-  off: (event: string, listener: Listener) => {
-    const count = listeners.remove(event, listener);
-    logger.info(
-      `Deep link: listener removed for event ${event}. Total event listeners: ${count}`,
-    );
-  },
-  once: (event: string, listener: Listener) => {
-    const onceListener: Listener = (query) => {
-      deepLink.off(event, onceListener);
-      listener(query);
-    };
-    deepLink.on(event, onceListener);
-  },
-};
-
-export function handleCommandLine(commandLine: string[]) {
-  const target = commandLine.find((arg) =>
-    protocols.some((protocol) => arg.startsWith(protocol + "://")),
-  );
-  if (!target) return;
-
-  logger.info(`Deep link: protocol link got: ${target}`);
-
-  try {
-    const url = new URL(target);
-
-    const action = url.hostname; // 'search'
-    logger.info(`Deep link: action found: ${action}`);
-
-    const query: Query = {};
-
-    if (action === "search") {
-      // Format: spk://search/pkgname
-      // url.pathname will be '/pkgname'
-      const pkgname = url.pathname.split("/").filter(Boolean)[0];
-      if (pkgname) {
-        query.pkgname = pkgname;
-        logger.info(`Deep link: search query found: ${JSON.stringify(query)}`);
-        listeners.emit(action, query);
-      } else {
-        logger.warn(
-          `Deep link: invalid search format, expected /pkgname, got ${url.pathname}`,
-        );
-      }
-    } else if (action === "store") {
-      // Format: spk://store/category/pkgname (legacy format)
-      // url.pathname will be '/category/pkgname'
-      const pathParts = url.pathname.split("/").filter(Boolean);
-      // 老协议格式: spk://store/category/pkgname
-      // 现在忽略 category，直接使用 pkgname 查找应用
-      const pkgname = pathParts.length >= 2 ? pathParts[1] : pathParts[0];
-      if (pkgname) {
-        query.pkgname = pkgname;
-        logger.info(
-          `Deep link: store legacy format query found: ${JSON.stringify(query)}`,
-        );
-        // 使用 search 事件来处理，前端会根据 pkgname 直接打开应用详情
-        listeners.emit("search", query);
-      } else {
-        logger.warn(
-          `Deep link: invalid store format, expected /category/pkgname, got ${url.pathname}`,
-        );
-      }
-    } else {
-      logger.warn(`Deep link: unknown action ${action}`);
-    }
-  } catch (error) {
-    logger.error(`Deep link: error parsing URL: ${error}`);
-  }
-}
-
-app.on("second-instance", (_e, commandLine) => {
-  handleCommandLine(commandLine);
-});

electron/main/handle-url-scheme.ts

@@ -1,107 +0,0 @@
-import { BrowserWindow } from "electron";
-import { deepLink } from "./deeplink";
-import { isLoaded } from "../global";
-import pino from "pino";
-
-const logger = pino({ name: "handle-url-scheme.ts" });
-
-const pendingActions: Array<() => void> = [];
-
-new Promise<void>((resolve) => {
-  const checkLoaded = () => {
-    if (isLoaded.value) {
-      resolve();
-    } else {
-      setTimeout(checkLoaded, 100);
-    }
-  };
-  checkLoaded();
-}).then(() => {
-  while (pendingActions.length > 0) {
-    const action = pendingActions.shift();
-    if (action) action();
-  }
-});
-
-deepLink.on("event", (query) => {
-  logger.info(
-    `Deep link: event "event" fired with query: ${JSON.stringify(query)}`,
-  );
-});
-
-deepLink.on("action", (query) => {
-  logger.info(
-    `Deep link: event "action" fired with query: ${JSON.stringify(query)}`,
-  );
-
-  const action = () => {
-    const win = BrowserWindow.getAllWindows()[0];
-    if (!win) return;
-
-    if (query.cmd === "update") {
-      win.webContents.send("deep-link-update");
-      if (win.isMinimized()) win.restore();
-      win.focus();
-    } else if (query.cmd === "list") {
-      win.webContents.send("deep-link-installed");
-      if (win.isMinimized()) win.restore();
-      win.focus();
-    }
-  };
-
-  logger.info(`isLoaded: ${isLoaded.value}`);
-
-  if (isLoaded.value) {
-    action();
-  } else {
-    pendingActions.push(action);
-  }
-});
-
-deepLink.on("install", (query) => {
-  logger.info(
-    `Deep link: event "install" fired with query: ${JSON.stringify(query)}`,
-  );
-
-  const action = () => {
-    const win = BrowserWindow.getAllWindows()[0];
-    if (!win) return;
-
-    if (query.pkg) {
-      win.webContents.send("deep-link-install", query.pkg);
-      if (win.isMinimized()) win.restore();
-      win.focus();
-    }
-  };
-
-  if (isLoaded.value) {
-    action();
-  } else {
-    pendingActions.push(action);
-  }
-});
-
-deepLink.on("search", (query) => {
-  logger.info(
-    `Deep link: event "search" fired with query: ${JSON.stringify(query)}`,
-  );
-
-  const action = () => {
-    const win = BrowserWindow.getAllWindows()[0];
-    if (!win) return;
-
-    if (query.pkgname) {
-      win.webContents.send("deep-link-search", { pkgname: query.pkgname });
-      if (win.isMinimized()) win.restore();
-      win.focus();
-    }
-  };
-
-  logger.info(`isLoaded: ${isLoaded.value}`);
-
-  if (isLoaded.value) {
-    action();
-  } else {
-    pendingActions.push(action);
-  }
-});

electron/main/index.ts

@@ -1,339 +0,0 @@
-import {
-  app,
-  BrowserWindow,
-  ipcMain,
-  Menu,
-  nativeImage,
-  shell,
-  Tray,
-  nativeTheme,
-  session,
-} from "electron";
-import { fileURLToPath } from "node:url";
-import path from "node:path";
-import os from "node:os";
-import fs from "node:fs";
-import pino from "pino";
-import { handleCommandLine } from "./deeplink.js";
-import { isLoaded } from "../global.js";
-import { tasks } from "./backend/install-manager.js";
-import { sendTelemetryOnce } from "./backend/telemetry.js";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-process.env.APP_ROOT = path.join(__dirname, "../..");
-
-/** 与项目 package.json 一致的版本号：打包用 app.getVersion()，未打包时读 package.json */
-function getAppVersion(): string {
-  if (app.isPackaged) return app.getVersion();
-  const pkgPath = path.join(process.env.APP_ROOT ?? __dirname, "package.json");
-  try {
-    const raw = fs.readFileSync(pkgPath, "utf8");
-    const pkg = JSON.parse(raw) as { version?: string };
-    return typeof pkg.version === "string" ? pkg.version : "dev";
-  } catch {
-    return "dev";
-  }
-}
-
-// 处理 --version 参数（在单实例检查之前）
-if (process.argv.includes("--version") || process.argv.includes("-v")) {
-  console.log(getAppVersion());
-  process.exit(0);
-}
-
-// Assure single instance application
-if (!app.requestSingleInstanceLock()) {
-  app.exit(0);
-}
-
-import "./backend/install-manager.js";
-import "./handle-url-scheme.js";
-
-const logger = pino({ name: "index.ts" });
-
-// The built directory structure
-//
-// ├─┬ dist-electron
-// │ ├─┬ main
-// │ │ └── index.js    > Electron-Main
-// │ └─┬ preload
-// │   └── index.mjs   > Preload-Scripts
-// ├─┬ dist
-// │ └── index.html    > Electron-Renderer
-//
-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;
-
-process.env.VITE_PUBLIC = VITE_DEV_SERVER_URL
-  ? path.join(process.env.APP_ROOT, "public")
-  : RENDERER_DIST;
-
-// Disable GPU Acceleration for Windows 7
-if (os.release().startsWith("6.1")) app.disableHardwareAcceleration();
-
-// Set application name for Windows 10+ notifications
-if (process.platform === "win32") app.setAppUserModelId(app.getName());
-
-if (!app.requestSingleInstanceLock()) {
-  app.quit();
-  process.exit(0);
-}
-
-let win: BrowserWindow | null = null;
-const preload = path.join(__dirname, "../preload/index.mjs");
-const indexHtml = path.join(RENDERER_DIST, "index.html");
-
-const getUserAgent = (): string => {
-  return `Spark-Store/${getAppVersion()}`;
-};
-
-logger.info("User Agent: " + getUserAgent());
-
-/** 根据启动参数 --no-apm / --no-spark 决定只展示的来源 */
-function getStoreFilterFromArgv(): "spark" | "apm" | "both" {
-  const argv = process.argv;
-  const noApm = argv.includes("--no-apm");
-  const noSpark = argv.includes("--no-spark");
-  if (noApm && noSpark) return "both";
-  if (noApm) return "spark";
-  if (noSpark) return "apm";
-  return "both";
-}
-
-ipcMain.handle("get-store-filter", (): "spark" | "apm" | "both" =>
-  getStoreFilterFromArgv(),
-);
-
-ipcMain.handle("get-app-version", (): string => getAppVersion());
-
-async function createWindow() {
-  win = new BrowserWindow({
-    title: "星火应用商店",
-    width: 1366,
-    height: 768,
-    autoHideMenuBar: true,
-    icon: path.join(process.env.VITE_PUBLIC, "favicon.ico"),
-    webPreferences: {
-      preload,
-      // Warning: Enable nodeIntegration and disable contextIsolation is not secure in production
-      // nodeIntegration: true,
-
-      // Consider using contextBridge.exposeInMainWorld
-      // Read more on https://www.electronjs.org/docs/latest/tutorial/context-isolation
-      // contextIsolation: false,
-    },
-  });
-
-  if (VITE_DEV_SERVER_URL) {
-    // #298
-    win.loadURL(VITE_DEV_SERVER_URL);
-    // Open devTool if the app is not packaged
-    win.webContents.openDevTools({ mode: "detach" });
-  } else {
-    win.loadFile(indexHtml);
-  }
-
-  // Test actively push message to the Electron-Renderer
-  win.webContents.on("did-finish-load", () => {
-    win?.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 }) => {
-    if (url.startsWith("https:")) shell.openExternal(url);
-    return { action: "deny" };
-  });
-  // win.webContents.on('will-navigate', (event, url) => { }) #344
-
-  win.on("close", (event) => {
-    // 截获 close 默认行为
-    event.preventDefault();
-    // 点击关闭时触发close事件，我们按照之前的思路在关闭时，隐藏窗口，隐藏任务栏窗口
-    if (tasks.size > 0) {
-      win.hide();
-      win.setSkipTaskbar(true);
-    } else {
-      // 如果没有下载任务，才允许关闭窗口
-      win.destroy();
-    }
-  });
-}
-
-ipcMain.on("renderer-ready", (event, args) => {
-  logger.info(
-    "Received renderer-ready event with args: " + JSON.stringify(args),
-  );
-  isLoaded.value = args.status;
-  logger.info(`isLoaded set to: ${isLoaded.value}`);
-});
-
-ipcMain.on("set-theme-source", (event, theme: "system" | "light" | "dark") => {
-  nativeTheme.themeSource = theme;
-});
-
-// 启动系统更新工具（使用 pkexec 提升权限）
-ipcMain.handle("run-update-tool", async () => {
-  try {
-    const { spawn } = await import("node:child_process");
-    const pkexecPath = "/usr/bin/pkexec";
-    const args = ["spark-update-tool"];
-    const child = spawn(pkexecPath, args, {
-      detached: true,
-      stdio: "ignore",
-    });
-    // 让子进程在后台运行且不影响主进程退出
-    child.unref();
-    logger.info("Launched pkexec spark-update-tool");
-    return { success: true };
-  } catch (err) {
-    logger.error({ err }, "Failed to launch spark-update-tool");
-    return { success: false, message: (err as Error)?.message || String(err) };
-  }
-});
-
-// 启动安装设置脚本（可能需要提升权限）
-ipcMain.handle("open-install-settings", async () => {
-  try {
-    const { spawn } = await import("node:child_process");
-    const scriptPath =
-      "/opt/durapps/spark-store/bin/update-upgrade/ss-update-controler.sh";
-    const child = spawn("/opt/spark-store/extras/host-spawn", [scriptPath], {
-      detached: true,
-      stdio: "ignore",
-    });
-    child.unref();
-    logger.info(`Launched ${scriptPath}`);
-    return { success: true };
-  } catch (err) {
-    logger.error({ err }, "Failed to launch install settings script");
-    return { success: false, message: (err as Error)?.message || String(err) };
-  }
-});
-
-app.whenReady().then(() => {
-  // Set User-Agent for client
-  session.defaultSession.webRequest.onBeforeSendHeaders((details, callback) => {
-    details.requestHeaders["User-Agent"] = getUserAgent();
-    callback({ cancel: false, requestHeaders: details.requestHeaders });
-  });
-  createWindow();
-  handleCommandLine(process.argv);
-  // 启动后执行一次遥测（仅 Linux，不阻塞）
-  sendTelemetryOnce(getAppVersion());
-});
-
-app.on("window-all-closed", () => {
-  win = null;
-  if (process.platform !== "darwin") app.quit();
-});
-
-app.on("second-instance", () => {
-  if (win) {
-    // 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();
-  if (allWindows.length) {
-    allWindows[0].focus();
-  } else {
-    createWindow();
-  }
-});
-
-app.on("will-quit", () => {
-  // Clean up temp dir
-  logger.info("Cleaning up temp dir");
-  fs.rmSync("/tmp/spark-store/", { recursive: true, force: true });
-  logger.info("Done, exiting");
-});
-
-// 设置托盘：系统中应用名称为 spark-store，图标优先 spark-store，其次 spark-store.svg，再次替代图标
-const ICONS_DIR = app.isPackaged
-  ? path.join(process.resourcesPath, "icons")
-  : path.join(__dirname, "../..", "icons");
-
-function resolveIconPath(filename: string): string {
-  return path.join(ICONS_DIR, filename);
-}
-
-/** 按优先级返回托盘图标路径：spark-store(.png|.ico) → amber-pm-logo.png。托盘不支持 SVG，故不尝试 spark-store.svg */
-function getTrayIconPath(): string | null {
-  const ext = process.platform === "win32" ? ".ico" : ".png";
-  const candidates = [`spark-store${ext}`];
-  for (const name of candidates) {
-    const iconPath = resolveIconPath(name);
-    if (fs.existsSync(iconPath)) {
-      logger.info("托盘图标使用: " + iconPath);
-      return iconPath;
-    }
-  }
-  logger.warn("未找到托盘图标，将使用替代图标。查找目录: " + ICONS_DIR);
-  return null;
-}
-
-/** 16x16 透明 PNG，用作托盘无图标时的替代 */
-const FALLBACK_TRAY_PNG =
-  "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAHklEQVQ4T2NkYGD4z0ABYBwNwMAwGoChNQAAAABJRU5ErkJggg==";
-
-function getTrayImage():
-  | string
-  | ReturnType<typeof nativeImage.createFromDataURL> {
-  const iconPath = getTrayIconPath();
-  if (iconPath) return iconPath;
-  return nativeImage.createFromDataURL(FALLBACK_TRAY_PNG);
-}
-
-let tray: Tray | null = null;
-app.whenReady().then(() => {
-  tray = new Tray(getTrayImage());
-  const contextMenu = Menu.buildFromTemplate([
-    {
-      label: "显示主界面",
-      click: () => {
-        win.show();
-      },
-    },
-    {
-      label: "退出程序",
-      click: () => {
-        win.destroy();
-      },
-    },
-  ]);
-  tray.setToolTip("星火应用商店");
-  tray.setContextMenu(contextMenu);
-  // 双击触发
-  tray.on("click", () => {
-    // 双击通知区图标实现应用的显示或隐藏
-    if (win.isVisible()) {
-      win.hide();
-      win.setSkipTaskbar(true);
-    } else {
-      win.show();
-      win.setSkipTaskbar(false);
-    }
-  });
-});
-
-// New window example arg: new windows url
-// ipcMain.handle('open-win', (_, arg) => {
-//   const childWindow = new BrowserWindow({
-//     webPreferences: {
-//       preload,
-//       nodeIntegration: true,
-//       contextIsolation: false,
-//     },
-//   })
-
-//   if (VITE_DEV_SERVER_URL) {
-//     childWindow.loadURL(`${VITE_DEV_SERVER_URL}#${arg}`)
-//   } else {
-//     childWindow.loadFile(indexHtml, { hash: arg })
-//   }
-// })

electron/preload/index.ts

@@ -1,135 +0,0 @@
-import { ipcRenderer, contextBridge } from "electron";
-
-// --------- Expose some API to the Renderer process ---------
-contextBridge.exposeInMainWorld("ipcRenderer", {
-  on(...args: Parameters<typeof ipcRenderer.on>) {
-    const [channel, listener] = args;
-    return ipcRenderer.on(channel, (event, ...args) =>
-      listener(event, ...args),
-    );
-  },
-  off(...args: Parameters<typeof ipcRenderer.off>) {
-    const [channel, ...omit] = args;
-    return ipcRenderer.off(channel, ...omit);
-  },
-  send(...args: Parameters<typeof ipcRenderer.send>) {
-    const [channel, ...omit] = args;
-    return ipcRenderer.send(channel, ...omit);
-  },
-  invoke(...args: Parameters<typeof ipcRenderer.invoke>) {
-    const [channel, ...omit] = args;
-    return ipcRenderer.invoke(channel, ...omit);
-  },
-
-  // You can expose other APTs you need here.
-  // ...
-});
-
-contextBridge.exposeInMainWorld("apm_store", {
-  arch: (() => {
-    const arch = process.arch;
-    if (arch === "x64") {
-      return "amd64";
-    } else if (arch === "arm64") {
-      return "arm64";
-    } else {
-      return arch;
-    }
-  })(),
-});
-
-// --------- Preload scripts loading ---------
-function domReady(
-  condition: DocumentReadyState[] = ["complete", "interactive"],
-) {
-  return new Promise((resolve) => {
-    if (condition.includes(document.readyState)) {
-      resolve(true);
-    } else {
-      document.addEventListener("readystatechange", () => {
-        if (condition.includes(document.readyState)) {
-          resolve(true);
-        }
-      });
-    }
-  });
-}
-
-const safeDOM = {
-  append(parent: HTMLElement, child: HTMLElement) {
-    if (!Array.from(parent.children).find((e) => e === child)) {
-      return parent.appendChild(child);
-    }
-  },
-  remove(parent: HTMLElement, child: HTMLElement) {
-    if (Array.from(parent.children).find((e) => e === child)) {
-      return parent.removeChild(child);
-    }
-  },
-};
-
-/**
- * https://tobiasahlin.com/spinkit
- * https://connoratherton.com/loaders
- * https://projects.lukehaas.me/css-loaders
- * https://matejkustec.github.io/SpinThatShit
- */
-function useLoading() {
-  const className = `loaders-css__square-spin`;
-  const styleContent = `
-@keyframes square-spin {
-  25% { transform: perspective(100px) rotateX(180deg) rotateY(0); }
-  50% { transform: perspective(100px) rotateX(180deg) rotateY(180deg); }
-  75% { transform: perspective(100px) rotateX(0) rotateY(180deg); }
-  100% { transform: perspective(100px) rotateX(0) rotateY(0); }
-}
-.${className} > div {
-  animation-fill-mode: both;
-  width: 50px;
-  height: 50px;
-  background: #fff;
-  animation: square-spin 3s 0s cubic-bezier(0.09, 0.57, 0.49, 0.9) infinite;
-}
-.app-loading-wrap {
-  position: fixed;
-  top: 0;
-  left: 0;
-  width: 100vw;
-  height: 100vh;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  background: #282c34;
-  z-index: 9;
-}
-    `;
-  const oStyle = document.createElement("style");
-  const oDiv = document.createElement("div");
-
-  oStyle.id = "app-loading-style";
-  oStyle.innerHTML = styleContent;
-  oDiv.className = "app-loading-wrap";
-  oDiv.innerHTML = `<div class="${className}"><div></div></div>`;
-
-  return {
-    appendLoading() {
-      safeDOM.append(document.head, oStyle);
-      safeDOM.append(document.body, oDiv);
-    },
-    removeLoading() {
-      safeDOM.remove(document.head, oStyle);
-      safeDOM.remove(document.body, oDiv);
-    },
-  };
-}
-
-// ----------------------------------------------------------------------
-
-const { appendLoading, removeLoading } = useLoading();
-domReady().then(appendLoading);
-
-window.onmessage = (ev) => {
-  if (ev.data.payload === "removeLoading") removeLoading();
-};
-
-setTimeout(removeLoading, 4999);

electron/typedefinition.ts

@@ -1,13 +0,0 @@
-export interface InstalledAppInfo {
-  pkgname: string;
-  version: string;
-  arch: string;
-  flags: string;
-  raw: string;
-}
-
-export type ChannelPayload = {
-  success: boolean;
-  message: string;
-  [k: string]: unknown;
-};

eslint.config.ts

@@ -1,17 +0,0 @@
-import js from "@eslint/js";
-import globals from "globals";
-import tseslint from "typescript-eslint";
-import pluginVue from "eslint-plugin-vue";
-import { defineConfig, globalIgnores } from "eslint/config";
-import eslintConfigPrettier from "eslint-config-prettier/flat";
-import eslintPluginPrettierRecommended from "eslint-plugin-prettier/recommended";
-
-export default defineConfig([
-  globalIgnores(["**/3rdparty/**", "**/node_modules/**", "**/dist/**", "**/dist-electron/**"]),
-  { files: ["**/*.{js,mjs,cjs,ts,mts,cts,vue}"], plugins: { js }, extends: ["js/recommended"], languageOptions: { globals: { ...globals.browser, ...globals.node } } },
-  tseslint.configs.recommended,
-  pluginVue.configs["flat/essential"],
-  { files: ["**/*.vue"], languageOptions: { parserOptions: { parser: tseslint.parser } } },
-  eslintConfigPrettier,
-  eslintPluginPrettierRecommended,
-]);

extras/apm-launcher

@@ -1,102 +0,0 @@
-#!/bin/bash
-
-# ===== 日志函数（简化版）=====
-log.info()  { echo "INFO: $*"; }
-log.warn()  { echo "WARN: $*"; }
-log.error() { echo "ERROR: $*"; }
-log.debug() { :; }  # APM 场景下可禁用 debug 日志
-
-# ===== APM 专用桌面文件扫描（单文件）=====
-function scan_apm_desktop_log() {
-    unset desktop_file_path
-    local pkg_name="$1"
-    local desktop_dir="/var/lib/apm/apm/files/ace-env/var/lib/apm/${pkg_name}/entries/applications"
-
-    [ -d "$desktop_dir" ] || return 1
-
-    while IFS= read -r -d '' path; do
-        [ -f "$path" ] || continue
-        if ! grep -q 'NoDisplay=true' "$path" 2>/dev/null; then
-            log.info "Found valid APM desktop file: $path"
-            export desktop_file_path="$path"
-            return 0
-        fi
-    done < <(find "$desktop_dir" -name "*.desktop" -type f -print0 2>/dev/null)
-
-    return 1
-}
-
-# ===== APM 专用桌面文件扫描（多文件列表）=====
-function scan_apm_desktop_list() {
-    local pkg_name="$1"
-    local desktop_dir="/var/lib/apm/apm/files/ace-env/var/lib/apm/${pkg_name}/entries/applications"
-    local result=""
-
-    [ -d "$desktop_dir" ] || { echo ""; return; }
-
-    while IFS= read -r -d '' path; do
-        [ -f "$path" ] || continue
-        if ! grep -q 'NoDisplay=true' "$path" 2>/dev/null; then
-            result+="${path},"
-        fi
-    done < <(find "$desktop_dir" -name "*.desktop" -type f -print0 2>/dev/null)
-
-    echo "${result%,}"
-}
-
-# ===== 启动应用 =====
-function launch_app() {
-    local desktop_path="${1#file://}"
-    local exec_cmd
-
-    # 提取并清理 Exec 行（移除字段代码如 %f %u 等）
-    exec_cmd=$(grep -m1 '^Exec=' "$desktop_path" | cut -d= -f2- | sed 's/%[fFuUdDnNickvm]*//g; s/^[[:space:]]*//; s/[[:space:]]*$//')
-    [ -z "$exec_cmd" ] && return 1
-
-    log.info "Launching: $exec_cmd"
-    ${SHELL:-bash} -c "$exec_cmd" &
-}
-
-# 导出函数供 ACE 环境调用
-export -f launch_app scan_apm_desktop_log scan_apm_desktop_list log.info log.error
-
-# ===== 主逻辑 =====
-[ $# -lt 2 ] && {
-    log.error "Usage: $0 {check|list|launch|start} <apm-package-name>"
-    exit 1
-}
-
-action="$1"
-pkg_name="$2"
-
-case "$action" in
-    check)
-        if scan_apm_desktop_log "$pkg_name"; then
-            exit 0
-        else
-            exit 1
-        fi
-        ;;
-
-    list)
-        if result=$(scan_apm_desktop_list "$pkg_name"); [ -n "$result" ]; then
-            echo "$result"
-            exit 0
-        else
-            exit 1
-        fi
-        ;;
-
-    launch|start)
-        if scan_apm_desktop_log "$pkg_name" && launch_app "$desktop_file_path"; then
-            exit 0
-        else
-            exit 1
-        fi
-        ;;
-
-    *)
-        log.error "Invalid command: $action (supported: check|list|launch|start)"
-        exit 2
-        ;;
-esac

extras/app-launcher

@@ -1,164 +0,0 @@
-#!/bin/bash
-
-# ===== ACE环境配置 =====
-readonly ACE_ENVIRONMENTS=(
-    "bookworm-run:amber-ce-bookworm"
-    "trixie-run:amber-ce-trixie"
-    "deepin23-run:amber-ce-deepin23"
-    "sid-run:amber-ce-sid"
-)
-
-# ===== 日志和函数 =====
-[ -f /opt/durapps/spark-store/bin/bashimport/log.amber ] && \
-    source /opt/durapps/spark-store/bin/bashimport/log.amber || {
-    log.info() { echo "INFO: $*"; }
-    log.warn() { echo "WARN: $*"; }
-    log.error() { echo "ERROR: $*"; }
-    log.debug() { echo "DEBUG: $*"; }
-}
-
-# ===== 功能函数 =====
-function scan_desktop_file_log() {
-    unset desktop_file_path
-    local package_name=$1
-    # 标准desktop文件检测
-    while IFS= read -r path; do
-        [ -z "$(grep 'NoDisplay=true' "$path")" ] && {
-            log.info "Found valid desktop file: $path"
-            export desktop_file_path="$path"
-            return 0
-        }
-    done < <(dpkg -L "$package_name" 2>/dev/null | grep -E '/usr/share/applications/.*\.desktop$|/opt/apps/.*/entries/applications/.*\.desktop$')
-
-    # 深度环境特殊处理
-    while IFS= read -r path; do
-        [ -z "$(grep 'NoDisplay=true' "$path")" ] && {
-            log.info "Found deepin desktop file: $path"
-            export desktop_file_path="$path"
-            return 0
-        }
-    done < <(find /opt/apps/$package_name -path '*/entries/applications/*.desktop' 2>/dev/null)
-    return 1
-}
-
-function scan_desktop_file() {
-    local package_name=$1 result=""
-    # 标准结果收集
-    while IFS= read -r path; do
-        [ -z "$(grep 'NoDisplay=true' "$path")" ] && result+="$path,"
-    done < <(dpkg -L "$package_name" 2>/dev/null | grep -E '/usr/share/applications/.*\.desktop$|/opt/apps/.*/entries/applications/.*\.desktop$')
-    
-    # 深度环境补充扫描
-    while IFS= read -r path; do
-        [ -z "$(grep 'NoDisplay=true' "$path")" ] && result+="$path,"
-    done < <(find /opt/apps/$package_name -path '*/entries/applications/*.desktop' 2>/dev/null)
-    
-    echo "${result%,}"
-}
-
-function launch_app() {
-    local DESKTOP_FILE_PATH="${1#file://}"
-    # 提取并净化Exec命令
-    exec_command=$(grep -m1 '^Exec=' "$DESKTOP_FILE_PATH" | cut -d= -f2- | sed 's/%.//g')
-    [ -z "$exec_command" ] && return 1
-    [ ! -z "$IS_ACE_ENV" ] && HOST_PREFIX="host-spawn"
-    exec_command="${HOST_PREFIX} $exec_command"
-    log.info "Launching: $exec_command"
-    ${SHELL:-bash} -c " $exec_command"  &
-
-}
-
-# 导出函数以便在ACE环境中使用
-export -f launch_app scan_desktop_file scan_desktop_file_log log.info log.warn log.debug log.error
-
-# ===== ACE环境执行器 =====
-function ace_runner() {
-    local action=$1
-    local target=$2
-    
-    for ace_entry in "${ACE_ENVIRONMENTS[@]}"; do
-        local ace_cmd=${ace_entry%%:*}
-        local ace_env=${ace_entry#*:}
-        
-        if ! command -v "$ace_cmd" >/dev/null; then
-            log.debug "$ace_cmd not found, skipping..."
-            continue
-        fi
-        
-        log.info "Attempting in $ace_env environment..."
-        
-        case "$action" in
-        check)
-            if "$ace_cmd" scan_desktop_file_log "$target"; then
-                log.info "Found desktop file in $ace_env"
-                return 0
-            fi
-            ;;
-        list)
-            local result
-            if result=$("$ace_cmd"  scan_desktop_file "$target"); then
-                echo "$result"
-                return 0
-            fi
-            ;;
-        launch|start)
-"$ace_cmd"  scan_desktop_file_log "$target"
-            if desktop_path=$("$ace_cmd"  scan_desktop_file_log "$target"); then
-                log.info "Launching from $ace_env..."
-                "$ace_cmd"  launch_app $("$ace_cmd"  scan_desktop_file "$target")
-                return 0
-            fi
-            ;;
-        esac
-        
-        log.debug "Attempt in $ace_env failed"
-    done
-    
-    return 1
-}
-
-# ===== 主逻辑 =====
-[ $# -lt 2 ] && {
-    log.error "Usage: $0 {check|launch|list|start} package_name/desktop_file"
-    exit 1
-}
-
-case $1 in
-check)
-    # 当前环境检查
-    if scan_desktop_file_log "$2"; then
-        exit 0
-    else
-        # 非ACE环境下执行ACE环境扫描
-        [ -z "$IS_ACE_ENV" ] && ace_runner check "$2"
-        exit $?
-    fi
-    ;;
-
-list)
-    # 当前环境列表
-    if result=$(scan_desktop_file "$2"); then
-        echo "$result"
-        exit 0
-    else
-        # 非ACE环境下执行ACE环境扫描
-        [ -z "$IS_ACE_ENV" ] && ace_runner list "$2"
-        exit $?
-    fi
-    ;;
-
-launch|start)
-    # 当前环境启动
-    if scan_desktop_file_log "$2" && launch_app "$desktop_file_path"; then
-        exit 0
-    else
-        # 非ACE环境下通过ACE环境启动
-        [ -z "$IS_ACE_ENV" ] && ace_runner launch "$2"
-        exit $?
-    fi
-    ;;
-*)
-    log.error "Invalid command: $1"
-    exit 2
-    ;;
-esac

extras/check-is-installed

@@ -1,43 +0,0 @@
-#!/bin/bash
-readonly ACE_ENVIRONMENTS=(
-    "bookworm-run:amber-ce-bookworm"
-    "trixie-run:amber-ce-trixie"
-    "deepin23-run:amber-ce-deepin23"
-    "sid-run:amber-ce-sid"
-)
-dpkg -s "$1" 2>/dev/null | grep -q 'Status: install ok installed' > /dev/null 2>&1
-RET="$?"
-if [[ "$RET" != "0" ]] && [[ "$IS_ACE_ENV" == "" ]];then ## 如果未在ACE环境中
-
-    for ace_entry in "${ACE_ENVIRONMENTS[@]}"; do
-        ace_cmd=${ace_entry%%:*}
-        if command -v "$ace_cmd" >/dev/null 2>&1; then
-            echo "----------------------------------------"
-            echo "正在检查 $ace_cmd 环境的安装..."
-            echo "----------------------------------------"
-            
-            # 在ACE环境中使用dpkg -s检查安装状态
-            # 使用dpkg -s并检查输出中是否包含"Status: install ok installed"
-            $ace_cmd dpkg -s "$1" 2>/dev/null | grep -q 'Status: install ok installed'
-            try_run_ret="$?"
-            
-            # 最终检测结果处理
-            if [ "$try_run_ret" -eq 0 ]; then
-                echo "----------------------------------------"
-                echo "在 $ace_cmd 环境中找到了安装"
-                echo "----------------------------------------"
-                exit $try_run_ret
-            else
-                echo "----------------------------------------"
-                echo "在 $ace_cmd 环境中未能找到安装，继续查找"
-                echo "----------------------------------------"
-            fi
-        fi
-    done
-    echo "----------------------------------------"
-    echo "所有已安装的 ACE 环境中未能找到安装，退出"
-    echo "----------------------------------------"
-    exit "$RET"
-fi
-## 如果在ACE环境中或者未出错
-exit "$RET"

extras/list-apm-apps.sh

@@ -1,187 +0,0 @@
-#!/usr/bin/env bash
-
-get_script_dir() {
-    local source="${BASH_SOURCE[0]}"
-    while [ -L "$source" ]; do
-        local dir="$(cd -P "$(dirname "$source")" && pwd)"
-        source="$(readlink "$source")"
-        [[ $source != /* ]] && source="$dir/$source"
-    done
-    local dir="$(cd -P "$(dirname "$source")" && pwd)"
-    echo "$dir"
-}
-
-find_apm_launcher() {
-    local script_dir="$1"
-    local paths=(
-        "${script_dir}/../extras/shell-helper/apm-launcher"
-        "/home/momen/Desktop/apm-app-store/extras/shell-helper/apm-launcher"
-        "/opt/apm-store/extras/shell-helper/apm-launcher"
-        "/usr/local/bin/apm-launcher"
-    )
-    
-    for path in "${paths[@]}"; do
-        if [[ -f "$path" ]]; then
-            echo "$path"
-            return 0
-        fi
-    done
-    
-    return 1
-}
-
-SCRIPT_DIR="$(get_script_dir)"
-APM_LAUNCHER="$(find_apm_launcher "$SCRIPT_DIR")"
-
-if [[ -z "$APM_LAUNCHER" ]]; then
-    echo "Error: apm-launcher not found" >&2
-    exit 1
-fi
-
-SHOW_DESKTOP=false
-
-function show_help() {
-    echo "Usage: $(basename "$0") [OPTIONS] [KEYWORD]"
-    echo ""
-    echo "List installed APM packages or desktop applications."
-    echo ""
-    echo "Options:"
-    echo "  -d, --desktop       List only desktop applications (with .desktop files)"
-    echo "  -h, --help          Show this help message"
-    echo ""
-    echo "Arguments:"
-    echo "  KEYWORD             Filter results by keyword (optional)"
-    echo ""
-    echo "Examples:"
-    echo "  $(basename "$0")                    # List all installed packages"
-    echo "  $(basename "$0") firefox            # Search for firefox in packages"
-    echo "  $(basename "$0") -d                 # List all desktop applications"
-    echo "  $(basename "$0") --desktop firefox  # Search for desktop apps named firefox"
-}
-
-if [[ "$1" == "-h" || "$1" == "--help" ]]; then
-    show_help
-    exit 0
-fi
-
-if [[ "$1" == "-d" || "$1" == "--desktop" ]]; then
-    SHOW_DESKTOP=true
-    SEARCH_KEYWORD="${2:-}"
-else
-    SEARCH_KEYWORD="${1:-}"
-fi
-
-function get_desktop_name() {
-    local desktop_file="$1"
-    local name=""
-    
-    if [[ -f "$desktop_file" ]]; then
-        name=$(grep -m1 '^Name=' "$desktop_file" | cut -d= -f2-)
-    fi
-    
-    echo "$name"
-}
-
-if [[ "$SHOW_DESKTOP" == "true" ]]; then
-    echo "正在扫描已安装包中的桌面应用..."
-    echo ""
-    
-    installed_pkgs=$(apm list --installed 2>/dev/null | \
-        sed 's/\x1b\[[0-9;]*m//g' | \
-        grep -vE "^Listing|^$|^\[INFO\]|^警告" | \
-        grep "/" | \
-        awk '{split($1,a,"/"); print a[1]}' | \
-        sort)
-    
-    if [[ -z "$installed_pkgs" ]]; then
-        echo "未找到匹配的已安装包"
-        exit 0
-    fi
-    
-    printf "%-35s %-20s %-10s | %s\n" "PKGNAME" "VERSION" "ARCH" "DESCRIPTION"
-    printf "%-35s-%-20s-%-10s-+-%s\n" "-----------------------------------" "--------------------" "----------" "---------"
-    
-    while IFS= read -r pkgname; do
-        [[ -z "$pkgname" ]] && continue
-        
-        desktop_files=$("$APM_LAUNCHER" list "$pkgname" 2>/dev/null)
-        
-        if [[ -n "$desktop_files" ]]; then
-            IFS=',' read -ra files <<< "$desktop_files"
-            for df in "${files[@]}"; do
-                app_name=$(get_desktop_name "$df")
-                if [[ -n "$app_name" ]]; then
-                    pkg_info=$(apm show "$pkgname" 2>/dev/null)
-                    version=$(echo "$pkg_info" | grep "^Version:" | cut -d: -f2 | xargs)
-                    arch=$(echo "$pkg_info" | grep "^Architecture:" | cut -d: -f2 | xargs)
-                    description=$(echo "$pkg_info" | grep "^Description:" | cut -d: -f2- | xargs)
-                    
-                    [[ -z "$arch" ]] && arch="amd64"
-                    
-                    if [[ -n "$SEARCH_KEYWORD" ]]; then
-                        if [[ "$app_name" =~ $SEARCH_KEYWORD ]] || [[ "$pkgname" =~ $SEARCH_KEYWORD ]]; then
-                            printf "%-35s %-20s %-10s | %s\n" "$pkgname" "$version" "$arch" "$app_name"
-                        fi
-                    else
-                        printf "%-35s %-20s %-10s | %s\n" "$pkgname" "$version" "$arch" "$app_name"
-                    fi
-                fi
-            done
-        fi
-    done <<< "$installed_pkgs"
-    
-    exit 0
-fi
-
-if [[ -n "$SEARCH_KEYWORD" ]]; then
-    installed_pkgs=$(apm list --installed 2>/dev/null | \
-        sed 's/\x1b\[[0-9;]*m//g' | \
-        grep -vE "^Listing|^$|^\[INFO\]|^警告" | \
-        grep "/" | \
-        awk '{split($1,a,"/"); print a[1]}' | \
-        grep -i "${SEARCH_KEYWORD}" | \
-        sort)
-    
-    if [[ -z "$installed_pkgs" ]]; then
-        echo "未找到匹配的已安装包"
-        exit 0
-    fi
-    
-    printf "%-35s %-20s %-10s | %s\n" "PKGNAME" "VERSION" "ARCH" "DESCRIPTION"
-    printf "%-35s-%-20s-%-10s-+-%s\n" "-----------------------------------" "--------------------" "----------" "---------"
-    
-    while IFS= read -r pkgname; do
-        [[ -z "$pkgname" ]] && continue
-        
-        pkg_info=$(apm show "$pkgname" 2>/dev/null)
-        version=$(echo "$pkg_info" | grep "^Version:" | cut -d: -f2 | xargs)
-        arch=$(echo "$pkg_info" | grep "^Architecture:" | cut -d: -f2 | xargs)
-        description=$(echo "$pkg_info" | grep "^Description:" | cut -d: -f2- | xargs)
-        
-        [[ -z "$arch" ]] && arch="amd64"
-        
-        printf "%-35s %-20s %-10s | %s\n" "$pkgname" "$version" "$arch" "${description:0:50}"
-    done <<< "$installed_pkgs"
-    
-    exit 0
-fi
-
-if [[ "$SHOW_DESKTOP" == "false" && -z "$SEARCH_KEYWORD" ]]; then
-    apm list --installed 2>/dev/null | \
-        sed 's/\x1b\[[0-9;]*m//g' | \
-        grep -vE "^Listing|^$|^\[INFO\]|^警告" | \
-        grep "/" | \
-        awk '{
-            n = split($0, parts, "/")
-            pkgname = parts[1]
-            if (pkgname == "") next
-            version = $2
-            sub(/,.*/, "", version)
-            arch = $3
-            match($0, /\[(.+)\]/, m)
-            flags = m[1]
-            printf "%-35s %-20s %-8s [%s]\n", pkgname, version, arch, flags
-        }' | sort
-    
-    exit 0
-fi

extras/shell-caller.sh

@@ -1,173 +0,0 @@
-#!/bin/bash
-
-# 显示进度条并执行命令（支持 garma / zenity）
-run_with_progress() {
-    local title="$1"
-    local text="$2"
-    local cmd="$3"
-
-    # 检测可用的对话框工具
-    local tool=""
-    if command -v garma &> /dev/null; then
-        tool="garma"
-    elif command -v zenity &> /dev/null; then
-        tool="zenity"
-    else
-        echo "警告：未找到 garma 或 zenity，无法显示进度条。直接执行命令..." >&2
-        eval "$cmd"
-        return $?
-    fi
-
-    # 根据工具启动进度条
-    local progress_pid
-    if [[ "$tool" == "garma" ]]; then
-        # garma 的进度条用法（假设 --progress --pulsate 可用）
-        garma --progress --pulsate --title="$title" --text="$text" --no-cancel 2>/dev/null &
-        progress_pid=$!
-    else
-        # zenity 进度条 pulsate 模式
-        zenity --progress --pulsate --title="$title" --text="$text" --no-cancel 2>/dev/null &
-        progress_pid=$!
-    fi
-
-    # 执行实际命令
-    eval "$cmd"
-    local cmd_exit=$?
-
-    # 关闭进度条
-    kill "$progress_pid" 2>/dev/null
-    wait "$progress_pid" 2>/dev/null
-
-    return $cmd_exit
-}
-
-# 1. 检查是否提供了至少一个参数
-if [[ $# -eq 0 ]]; then
-    echo "错误：未提供命令参数。"
-    echo "用法: $0 [apm|aptss|ssinstall] <子命令> [参数...]"
-    exit 1
-fi
-
-# 2. 获取第一个参数作为主指令
-command_type="$1"
-
-# 3. 根据指令类型分发逻辑
-case "$command_type" in
-    "apm")
-        # 禁止 apm debug 命令
-        if [[ "$2" == "debug" ]]; then
-            echo "错误：apm debug 命令已被禁止执行。"
-            echo "提示：如需调试，请使用其他方式。"
-            exit 1
-        fi
-        # 禁止 apm ssaudit 命令（已弃用，请使用 apm ssinstall）
-        if [[ "$2" == "ssaudit" ]]; then
-            echo "错误：apm ssaudit 命令已被弃用，请使用 apm ssinstall。"
-            echo "提示：请将 APM 升级到 1.2.2 版本以上以继续使用安装功能。"
-            exit 1
-        fi
-        # 执行 apm 命令（跳过第一个参数）
-        /usr/bin/apm "${@:2}" 2>&1
-        exit_code=$?
-        # 如果 apm ssinstall 执行失败，提示可能是版本过低
-        if [[ "$2" == "ssinstall" && "$exit_code" != "0" ]]; then
-            echo "提示：apm ssinstall 执行失败，可能是您的 APM 版本过低（需要 1.2.2+）。"
-            echo "请升级 APM 到 1.2.2 版本以上来继续安装。"
-        fi
-        ;;
-
-    "ssinstall")
-        # 执行 ssinstall 命令（跳过第一个参数）
-        /usr/bin/ssinstall "${@:2}" --native 2>&1
-        exit_code=$?
-        if [[ "$exit_code" != "0" ]];then
-            echo "安装失败，可尝试安装对应的 APM 版本应用；若无对应的 APM 版本应用，可提交用户反馈"
-        fi
-        ;;
-
-    "aptss")
-        # 针对 aptss 的特殊逻辑：如果是 remove 子命令，需要图形化确认
-        if [[ "$2" == "remove" ]]; then
-            packages="${@:3}"
-            
-            # 确认框通用参数
-            title="确认卸载"
-            text="正在准备卸载: $packages\n\n若这是您下达的卸载指令，请选择确认继续卸载"
-
-            # 优先尝试 garma，其次 zenity
-            if command -v garma &> /dev/null; then
-                garma --question --title="$title" --text="$text" \
-                      --ok-label="确认卸载" --cancel-label="取消" --width=400
-                confirmed=$?
-            elif command -v zenity &> /dev/null; then
-                zenity --question --title="$title" --text="$text" \
-                       --ok-label="确认卸载" --cancel-label="取消" --width=400
-                confirmed=$?
-            else
-                echo "错误：未找到 garma 或 zenity，无法显示确认对话框。卸载操作已拒绝。"
-                exit 1
-            fi
-
-            # 根据确认结果执行
-            if [[ $confirmed -eq 0 ]]; then
-                /usr/bin/aptss "${@:2}" -y 2>&1
-                exit_code=$?
-            else
-                echo "操作已取消"
-                exit 0
-            fi
-        elif [[ "$2" == "install" ]]; then
-            packages="${@:3}"
-            # 确认框通用参数
-            title="确认安装"
-            text="正在准备安装: $packages\n\n若这是您下达的安装指令，请选择确认继续安装"
-
-            # 优先尝试 garma，其次 zenity
-            if command -v garma &> /dev/null; then
-                garma --question --title="$title" --text="$text" \
-                      --ok-label="确认安装" --cancel-label="取消" --width=400
-                confirmed=$?
-            elif command -v zenity &> /dev/null; then
-                zenity --question --title="$title" --text="$text" \
-                       --ok-label="确认安装" --cancel-label="取消" --width=400
-                confirmed=$?
-            else
-                echo "错误：未找到 garma 或 zenity，无法显示确认对话框。安装操作已拒绝。"
-                exit 1
-            fi
-
-            # 根据确认结果执行
-            if [[ $confirmed -eq 0 ]]; then
-                # 1) 先更新软件源（带进度条）
-                echo "正在更新软件源..."
-                if ! run_with_progress "更新软件源" "正在更新软件源，请稍候..." "/usr/bin/aptss update"; then
-                    echo "错误：软件源更新失败，安装已终止。"
-                    exit 1
-                fi
-                # 2) 执行安装（带进度条）
-                echo "正在安装软件包..."
-                if ! run_with_progress "安装软件包" "正在安装: $packages，请稍候..." "/usr/bin/aptss ${@:2} -y"; then
-                    echo "错误：软件包安装失败。"
-                    exit 1
-                fi
-                exit_code=0
-            else
-                echo "操作已取消"
-                exit 0
-            fi
-
-        else
-            # 非 remove/install 命令，拒绝执行
-            echo "拒绝执行 aptss 白名单外的指令"
-            exit 1
-        fi
-        ;;
-
-    *)
-        # 兜底：拒绝非法指令
-        echo "拒绝执行：仅允许执行 'apm', 'aptss' 或 'ssinstall'。收到的参数: '$command_type'"
-        exit 1
-        ;;
-esac
-
-exit $exit_code

extras/spark-store

@@ -1,45 +0,0 @@
-#!/bin/bash
-
-# 基础参数，始终添加 --no-sandbox
-ARGS="--no-sandbox"
-
-# 检查是否在容器中运行
-# 方法1: 检查 root 路径
-ROOT_PATH=$(readlink -f /proc/self/root)
-if [ "$ROOT_PATH" != "/" ]; then
-    echo "检测到容器环境 (root path: $ROOT_PATH)"
-    ARGS="$ARGS --no-apm"
-fi
-
-# 方法2: 检查 IS_ACE_ENV 环境变量
-if [ "$IS_ACE_ENV" = "1" ]; then
-    echo "检测到 ACE 容器环境"
-    ARGS="$ARGS --no-apm"
-fi
-
-# 检查是否存在 apt 指令
-if ! command -v apt >/dev/null 2>&1; then
-    echo "未检测到 apt 指令"
-    ARGS="$ARGS --no-spark"
-fi
-
-# 注意：已移除原先针对 arm64 + wayland 添加 --disable-gpu 的逻辑，
-# 现在 arm64 设备无论是否使用 wayland 均不再添加此参数。
-
-# 执行程序（不使用 exec，以便捕获退出状态）
-/opt/spark-store/bin/spark-store $ARGS "$@"
-exit_code=$?
-
-# 若程序退出码非0，使用 zenity 弹出友好提示
-if [ $exit_code -ne 0 ]; then
-    if command -v zenity >/dev/null 2>&1; then
-        zenity --warning --width=600 --text="检测到您可能无法正确打开商店，可手动回退到旧版。\n在终端中执行  sudo aptss install spark-store-legacy -y 即可降级。\n\n对于银河麒麟，您可以尝试 APM 网页版商店 https://amber-pm.spark-app.store/"
-    else
-        # 降级方案：若 zenity 不可用，至少输出错误信息到终端
-        echo "警告: 程序异常退出（退出码 $exit_code），但无法显示图形提示。您可以尝试手动降级：" >&2
-        echo "sudo aptss install spark-store-legacy -y" >&2
-        echo "或访问 APM 网页版商店: https://amber-pm.spark-app.store/" >&2
-    fi
-fi
-
-exit $exit_code

icons/convert-to-png.py

@@ -1,179 +0,0 @@
-#!/usr/bin/env python3
-"""
-图标转换脚本 - 将spark-store.svg转换为标准尺寸的PNG图标
-支持尺寸: 64x64, 128x128, 256x256, 512x512
-"""
-
-import os
-import sys
-from PIL import Image
-import cairosvg
-
-def convert_svg_to_png(svg_path, output_dir, sizes=[64, 128, 256, 512]):
-    """
-    将SVG文件转换为多种尺寸的PNG图标
-    
-    Args:
-        svg_path: SVG文件路径
-        output_dir: 输出目录
-        sizes: 需要生成的尺寸列表
-    """
-    
-    # 检查输入文件是否存在
-    if not os.path.exists(svg_path):
-        print(f"错误: 找不到SVG文件 {svg_path}")
-        return False
-    
-    # 创建输出目录（如果不存在）
-    if not os.path.exists(output_dir):
-        os.makedirs(output_dir)
-        print(f"创建输出目录: {output_dir}")
-    
-    # 获取文件名（不含扩展名）
-    base_name = os.path.splitext(os.path.basename(svg_path))[0]
-    
-    # 读取SVG文件
-    with open(svg_path, 'rb') as svg_file:
-        svg_data = svg_file.read()
-    
-    # 为每个尺寸生成PNG
-    for size in sizes:
-        output_filename = f"{base_name}_{size}x{size}.png"
-        output_path = os.path.join(output_dir, output_filename)
-        
-        try:
-            # 使用cairosvg将SVG转换为PNG
-            cairosvg.svg2png(
-                bytestring=svg_data,
-                write_to=output_path,
-                output_width=size,
-                output_height=size
-            )
-            print(f"✓ 已生成: {output_filename} ({size}x{size})")
-            
-            # 验证生成的PNG文件
-            with Image.open(output_path) as img:
-                actual_size = img.size
-                if actual_size == (size, size):
-                    print(f"  - 尺寸验证通过: {actual_size}")
-                else:
-                    print(f"  - 警告: 实际尺寸为 {actual_size}")
-                    
-        except Exception as e:
-            print(f"✗ 生成 {size}x{size} 时出错: {str(e)}")
-            return False
-    
-    return True
-
-def generate_hicolor_icons(svg_path, base_output_dir):
-    """
-    生成符合hicolor主题标准的图标目录结构
-    
-    Args:
-        svg_path: SVG文件路径
-        base_output_dir: 基础输出目录
-    """
-    
-    # 定义标准尺寸和对应的子目录
-    icon_sizes = {
-        64: "64x64/apps",
-        128: "128x128/apps",
-        256: "256x256/apps",
-        512: "512x512/apps"
-    }
-    
-    # 获取文件名（不含扩展名）
-    base_name = os.path.splitext(os.path.basename(svg_path))[0]
-    
-    # 为每个尺寸创建目录并生成图标
-    for size, subdir in icon_sizes.items():
-        output_dir = os.path.join(base_output_dir, subdir)
-        
-        if not os.path.exists(output_dir):
-            os.makedirs(output_dir)
-        
-        output_path = os.path.join(output_dir, f"{base_name}.png")
-        
-        try:
-            # 读取SVG并转换
-            with open(svg_path, 'rb') as svg_file:
-                svg_data = svg_file.read()
-            
-            cairosvg.svg2png(
-                bytestring=svg_data,
-                write_to=output_path,
-                output_width=size,
-                output_height=size
-            )
-            print(f"✓ 已生成: {output_dir}/{base_name}.png ({size}x{size})")
-            
-        except Exception as e:
-            print(f"✗ 生成 {size}x{size} 时出错: {str(e)}")
-            return False
-    
-    return True
-
-def main():
-    """
-    主函数
-    """
-    # 默认配置
-    svg_file = "spark-store.svg"
-    output_dir = "spark-store-icons"
-    hicolor_dir = "hicolor"
-    
-    print("=" * 50)
-    print("Spark Store 图标转换工具")
-    print("=" * 50)
-    
-    # 检查是否安装了必要的库
-    try:
-        import PIL
-        import cairosvg
-    except ImportError as e:
-        print("错误: 缺少必要的Python库")
-        print("请安装依赖:")
-        print("  pip install Pillow cairosvg")
-        return
-    
-    # 检查SVG文件
-    if not os.path.exists(svg_file):
-        print(f"错误: 在当前目录找不到 {svg_file}")
-        print(f"请确保 {svg_file} 文件存在于当前目录")
-        return
-    
-    print(f"\n输入文件: {svg_file}")
-    
-    # 生成普通PNG图标
-    print("\n[1/2] 生成标准尺寸PNG图标...")
-    if convert_svg_to_png(svg_file, output_dir):
-        print(f"✓ 所有PNG图标已生成到: {output_dir}/")
-    else:
-        print("✗ 生成PNG图标失败")
-        return
-    
-    # 生成hicolor格式图标
-    print("\n[2/2] 生成hicolor格式图标...")
-    if generate_hicolor_icons(svg_file, hicolor_dir):
-        print(f"✓ hicolor图标已生成到: {hicolor_dir}/")
-    else:
-        print("✗ 生成hicolor图标失败")
-        return
-    
-    print("\n" + "=" * 50)
-    print("✓ 图标转换完成！")
-    print("=" * 50)
-    print("\n生成的文件：")
-    print(f"1. 普通PNG图标: {output_dir}/")
-    print(f"   - spark-store_64x64.png")
-    print(f"   - spark-store_128x128.png")
-    print(f"   - spark-store_256x256.png")
-    print(f"   - spark-store_512x512.png")
-    print(f"\n2. hicolor格式图标: {hicolor_dir}/")
-    print(f"   - {hicolor_dir}/64x64/apps/spark-store.png")
-    print(f"   - {hicolor_dir}/128x128/apps/spark-store.png")
-    print(f"   - {hicolor_dir}/256x256/apps/spark-store.png")
-    print(f"   - {hicolor_dir}/512x512/apps/spark-store.png")
-
-if __name__ == "__main__":
-    main()

index.html

@@ -1,14 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/spark-store.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta http-equiv="Content-Security-Policy" content="script-src 'self' 'unsafe-inline';" />
-    <title>星火应用商店</title>
-  </head>
-  <body>
-    <div id="app"></div>
-    <script type="module" src="/src/main.ts"></script>
-  </body>
-</html>

mock_test.spec.ts

@@ -1,11 +0,0 @@
-import { test, expect } from "@playwright/test";
-
-test("mock test", async ({ page }) => {
-  page.on('console', msg => console.log('PAGE LOG:', msg.text()));
-  page.on('pageerror', exception => {
-      console.log(`Uncaught exception: "${exception}"`);
-  });
-
-  await page.goto("http://localhost:5173/");
-  await page.waitForTimeout(2000);
-});

package.json

@@ -1,81 +0,0 @@
-{
-  "name": "spark-store",
-  "version": "5.0.0beta3",
-  "main": "dist-electron/main/index.js",
-  "description": "Client for Spark App Store",
-  "author": "elysia-best <elysia-best@simplelinux.cn.eu.org>",
-  "license": "GPL-3.0",
-  "private": true,
-  "keywords": [
-    "electron",
-    "rollup",
-    "vite",
-    "vue3",
-    "vue",
-    "spark-app-store"
-  ],
-  "debug": {
-    "env": {
-      "VITE_DEV_SERVER_URL": "http://127.0.0.1:3344/"
-    }
-  },
-  "type": "module",
-  "scripts": {
-    "dev": "vite --mode debug | pino-pretty",
-    "build": "vue-tsc --noEmit && vite build --mode production && electron-builder --config electron-builder.yml",
-    "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",
-    "preview": "vite preview --mode debug",
-    "lint": "eslint --ext .ts,.vue src electron",
-    "lint:fix": "eslint --ext .ts,.vue src electron --fix",
-    "format": "prettier --write \"src/**/*.{ts,vue}\" \"electron/**/*.{ts,vue}\"",
-    "changelog": "conventional-changelog -p angular -r 0",
-    "test": "vitest",
-    "test:watch": "vitest --watch",
-    "test:coverage": "vitest --coverage",
-    "test:e2e": "playwright test",
-    "test:e2e:ui": "playwright test --ui",
-    "test:e2e:debug": "playwright test --debug",
-    "test:all": "npm run test && npm run test:e2e"
-  },
-  "devDependencies": {
-    "@dotenvx/dotenvx": "^1.51.4",
-    "@eslint/create-config": "^1.11.0",
-    "@eslint/js": "^9.39.2",
-    "@loongdotjs/electron-builder": "^26.0.12-1",
-    "@playwright/test": "^1.40.0",
-    "@testing-library/jest-dom": "^6.1.5",
-    "@testing-library/vue": "^8.0.1",
-    "@vitejs/plugin-vue": "^6.0.3",
-    "@vitest/coverage-v8": "^1.0.0",
-    "@vue/test-utils": "^2.4.3",
-    "conventional-changelog": "^7.1.1",
-    "conventional-changelog-angular": "^8.1.0",
-    "electron": "^40.0.0",
-    "eslint": "^9.39.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.5",
-    "eslint-plugin-vue": "^10.7.0",
-    "globals": "^17.3.0",
-    "jiti": "^2.6.1",
-    "jsdom": "^23.0.1",
-    "pino-pretty": "^13.1.3",
-    "prettier": "3.8.1",
-    "typescript": "^5.4.2",
-    "typescript-eslint": "^8.55.0",
-    "vite": "^6.4.1",
-    "vite-plugin-electron": "^0.29.0",
-    "vite-plugin-electron-renderer": "^0.14.5",
-    "vitest": "^1.0.0",
-    "vue": "^3.4.21",
-    "vue-tsc": "^3.2.4"
-  },
-  "dependencies": {
-    "@tailwindcss/vite": "^4.1.18",
-    "axios": "^1.13.2",
-    "pino": "^10.3.0",
-    "tailwindcss": "^4.1.18",
-    "vue-virtual-scroller": "^2.0.0-beta.8"
-  }
-}