mirror of
https://gitee.com/spark-store-project/spark-store
synced 2026-04-26 01:10:16 +08:00
momen
cef68a95d9
## 文档（全部中文） - 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
155 lines
2.8 KiB
Markdown
155 lines
2.8 KiB
Markdown
# 常见问题 (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 应用商店？
|
||
|
||
**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) 协议开源。
|
||
|
||
---
|
||
|
||
**© 2026 APM 应用商店项目**
|