mirror of
https://gitee.com/spark-store-project/spark-store
synced 2026-04-26 09:20:18 +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
161 lines
2.3 KiB
Markdown
161 lines
2.3 KiB
Markdown
# 问题排查指南
|
|
|
|
## 📋 目录
|
|
|
|
- [常见问题](#常见问题)
|
|
- [调试方法](#调试方法)
|
|
- [日志分析](#日志分析)
|
|
- [性能问题](#性能问题)
|
|
|
|
## 常见问题
|
|
|
|
### 应用无法启动
|
|
|
|
**症状:** 双击应用图标后无反应
|
|
|
|
**可能原因:**
|
|
|
|
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 应用商店项目**
|