mirror of https://gitee.com/spark-store-project/spark-store synced 2026-04-26 01:10:16 +08:00

Files

momen cef68a95d9 chore: add comprehensive documentation and testing infrastructure

## 文档（全部中文）
- AGENTS.md - 完整的 AI 编码指南（中文版）
- CONTRIBUTING.md - 贡献指南
- DEVELOPMENT.md - 开发文档
- DEPLOYMENT.md - 部署文档
- TESTING.md - 测试文档
- TROUBLESHOOTING.md - 问题排查指南
- FAQ.md - 常见问题
- WORKFLOW.md - 标准开发流程文档
## AI 工作流（9个详细工作流）
- feature-development.md - 新功能开发流程
- bug-fix.md - Bug 修复流程
- code-review.md - 代码审查流程
- testing.md - 测试编写流程
- release.md - 发布流程
- refactoring.md - 代码重构流程
- documentation.md - 文档更新流程
- performance-optimization.md - 性能优化流程
- security-audit.md - 安全审计流程
## 测试基础设施
- vitest.config.ts - Vitest 单元测试配置
- playwright.config.ts - Playwright E2E 测试配置
- src/__tests__/setup.ts - 测试环境设置
- src/__tests__/unit/downloadStatus.test.ts - 示例单元测试
- e2e/basic.spec.ts - 示例 E2E 测试
## CI/CD
- .github/workflows/test.yml - 新建测试 CI 工作流
- .github/workflows/build.yml - 更新构建工作流，添加测试步骤
## Issue 模板
- 更新 bug_report.md 为标准 Bug 报告模板
- 更新 help_wanted.md 为标准功能请求模板
## 配置更新
- package.json - 添加测试依赖和 7 个新的 npm 脚本
- .gitignore - 添加测试相关忽略项
## 新增 npm 脚本
- test - 运行单元测试
- test:watch - 监听模式
- test:coverage - 生成覆盖率报告
- test:e2e - 运行 E2E 测试
- test:e2e:ui - E2E UI 模式
- test:e2e:debug - E2E 调试模式
- test:all - 运行所有测试
## 新增测试依赖
- @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

2026-03-10 00:42:56 +08:00

2.8 KiB

Raw Permalink Blame History

常见问题 (FAQ)

基本问题

Q: APM 应用商店是什么？

A: APM 应用商店是基于 Electron + Vue 3 构建的桌面应用商店客户端，用于 APM (AmberPM) 包管理器的图形化界面。

Q: 支持哪些操作系统？

A: 目前支持 Linux 系统，包括但不限于：

Ubuntu 20.04+
Debian 11+
Fedora 35+
Arch Linux
银河麒麟
统信 UOS

Q: 如何安装 APM 应用商店？

从 GitHub Releases 下载 deb 或 rpm 包

使用包管理器安装：

# Debian/Ubuntu
sudo dpkg -i spark-store_*.deb

# Fedora/RHEL
sudo dnf install spark-store_*.rpm

Q: 需要 APM 包管理器吗？

A: 是的，APM 应用商店需要 APM 包管理器才能工作。请先安装 APM。

使用问题

Q: 如何安装应用？

打开 APM 应用商店
浏览或搜索应用
点击应用卡片查看详情
点击"安装"按钮
等待安装完成

Q: 如何卸载应用？

点击右上角"已安装"按钮
在列表中找到要卸载的应用
点击"卸载"按钮
确认卸载

Q: 如何更新应用？

点击右上角"更新"按钮
选择要更新的应用
点击"更新"按钮
等待更新完成

Q: 下载的应用在哪里？

A: 应用下载后存储在 APM 管理的目录中，通常位于：

/opt/spark-store/apps/{pkgname}/

技术问题

Q: 应用无法启动怎么办？

A: 请参考问题排查指南。

Q: 如何查看日志？

A: 日志位置：

主进程日志：~/.config/spark-store/logs/
系统日志：journalctl -u spark-store

Q: 如何切换主题？

A: 点击右上角主题切换按钮，或按 Ctrl+Shift+T。

Q: 支持深色模式吗？

A: 是的，支持亮色、暗色和跟随系统主题。

开发问题

Q: 如何参与开发？

A: 请参考贡献指南。

Q: 如何运行开发版本？

git clone https://github.com/elysia-best/apm-app-store.git
cd apm-app-store
npm install
npm run dev

Q: 技术栈是什么？

Electron 40.0.0
Vue 3
Vite 6.4.1
TypeScript
Tailwind CSS 4.1.18

Q: 如何报告 Bug？

A: 请在 GitHub Issues 提交 Bug 报告。

其他问题

Q: 可以在 Windows/Mac 上使用吗？

A: 目前不支持，但计划在未来添加跨平台支持。

Q: 如何获取帮助？

查看文档
提交 Issue
加入社区论坛

Q: 许可证是什么？

A: 本项目采用 GPL-3.0 协议开源。

2.8 KiB Raw Permalink Blame History Unescape Escape