# 更新日志 (CHANGELOG)

本文档记录 NEXT Store 2.0 的所有版本更新和功能变更。

---

## [v2.0.0] - 2024-12-XX

### 🎉 重大更新

#### 后端架构重构
- **全新爬虫系统**
  - 实现华为应用市场API爬虫
  - 支持应用信息、指标数据、评分数据的完整抓取
  - 智能Token管理系统，自动刷新和重试
  - 数据处理器，自动去重和更新
  - 支持批量爬取和单个应用爬取

- **数据库优化**
  - 新增 `app_info`、`app_metrics`、`app_rating` 三表分离设计
  - 支持历史数据追踪
  - 优化索引，提升查询性能
  - 新增数据库迁移工具

- **API增强**
  - `/api/apps/search` - 应用搜索
  - `/api/apps/categories` - 分类统计
  - `/api/apps/category/{category}` - 按分类查询
  - `/api/apps/today` - 今日上架应用（根据 listed_at 判断）
  - `/api/apps/by-date` - 按日期查询应用
  - `/api/apps/top-downloads` - 热门应用Top100（修复重复问题）
  - `/api/apps/top-ratings` - 评分Top100
  - `/api/apps/{app_id}` - 应用详情

#### 前端全面升级

##### 🏠 首页 (Home)
- 全新探索页面设计
- 今日上架应用展示（横向滚动）
- 热门应用Top5快速访问
- 鸿蒙系统推广卡片
- 骨架屏加载效果，优化用户体验
- 数据预加载，减少闪烁

##### 📱 应用页面 (Apps)
- 参考 Apple 风格的搜索栏
  - 圆角胶囊设计（border-radius: 22px）
  - 实时清除按钮
  - 取消按钮
  - 白色背景 + 阴影效果
- 彩色分类磁贴网格
  - 16种渐变色循环
  - 智能图标匹配（150+分类图标）
  - 图标作为背景装饰（右下角半透明）
  - 悬停动画效果
- 搜索结果网格展示
- 分页功能
- 骨架屏加载

##### 🆕 今日上新页面 (NewApps)
- 日期切换（今日/昨日/前日）
- 根据 `listed_at` 字段精确判断
- 网格布局展示应用图标
- 空状态提示
- 骨架屏加载

##### 🔥 热门应用页面 (HotApps)
- 卡片式布局
- 显示应用图标、名称、分类、版本、下载量
- 按下载量排序
- 骨架屏加载

##### 📄 应用详情页面 (AppDetail)
- 参考模板设计的详情页
- 应用基本信息展示
- 统计卡片（评分、下载量、大小）
- 评分分布图表
- 详细信息列表
- 平台支持标签（带图标和颜色）
- 下载按钮（跳转华为应用市场）
- 浅色背景 (#F5F5F7)
- 移除SDK和API信息

##### 🧭 导航优化
- 底部导航栏
  - 探索、应用、上新、我的
  - 简洁的线条图标
  - 毛玻璃效果背景
  - 激活状态高亮
- 响应式设计，适配各种屏幕

##### 🦶 页脚组件 (Footer)
- 三列布局（关于、快速链接、法律信息）
- CC BY-NC-SA 4.0 许可协议
- 版权信息
- 响应式设计
- Profile 页面不显示

#### 🎨 UI/UX 改进
- 统一使用 #F5F5F7 浅色背景
- FontAwesome 6.4.0 图标库集成
- 流畅的过渡动画
- 骨架屏加载状态
- 响应式设计，完美适配移动端和桌面端
- 毛玻璃效果（backdrop-filter）

#### 🔧 功能特性

##### 元服务分类
- 自动识别元服务（packing_type = 1）
- 单独"元服务"分类
- 元服务不在其他分类中重复出现
- 元服务分类显示在首位

##### 搜索功能
- 支持应用名称、包名、开发者搜索
- 实时搜索建议
- 搜索结果分页

##### 数据展示
- 下载量格式化（亿、万）
- 文件大小格式化（GB、MB、KB）
- 日期格式化
- 评分星级显示

#### 📚 文档完善
- `QUICKSTART.md` - 快速开始指南
- `backend/START_GUIDE.md` - 后端启动指南
- `backend/USAGE_UPDATED.md` - 爬虫使用文档
- `backend/ATOMIC_SERVICE.md` - 元服务分类说明
- `backend/PERFORMANCE.md` - 性能优化文档
- `backend/FIXED.md` - 问题修复记录
- `backend/app/crawler/README.md` - 爬虫系统文档
- `frontend/DEBUG.md` - 前端调试指南

#### 🐛 Bug 修复
- 修复热门应用重复显示问题（交管12123）
- 修复搜索栏样式问题
- 修复图标不显示问题
- 修复首页加载闪烁问题
- 优化数据库查询性能

#### 🔒 安全性
- 环境变量配置
- 数据库连接池优化
- API错误处理
- 数据验证

#### 📦 依赖更新
- FastAPI
- SQLAlchemy 2.0
- Vue 3
- Vue Router 4
- Axios
- FontAwesome 6.4.0

---

## 技术栈

### 后端
- Python 3.9+
- FastAPI
- SQLAlchemy 2.0 (异步)
- MySQL/MariaDB
- aiomysql
- httpx (异步HTTP客户端)

### 前端
- Vue 3 (Composition API)
- TypeScript
- Vue Router 4
- Axios
- Vite
- FontAwesome 6.4.0

---

## 安装和使用

请参考以下文档：
- [快速开始](QUICKSTART.md)
- [后端启动指南](backend/START_GUIDE.md)
- [爬虫使用文档](backend/USAGE_UPDATED.md)

---

## 贡献者

感谢所有为本项目做出贡献的开发者！

---

## 许可证

本项目采用 CC BY-NC-SA 4.0 许可协议

---

## 下一步计划

### v2.1.0 (计划中)
- [ ] 用户系统
- [ ] 收藏功能
- [ ] 评论系统
- [ ] 应用推荐算法
- [ ] 数据统计图表
- [ ] 管理后台
- [ ] 暗色模式
- [ ] 多语言支持
- [ ] PWA支持
- [ ] 性能监控

---

**最后更新**: 2024-12-XX  
**当前版本**: v2.0.0