## ✨ 功能特性
### 前台
- 🌐 聚合 8+ 主流平台热榜（微博、百度、知乎、B站、抖音、今日头条、GitHub、腾讯新闻）
- 🎨 科技感暗色 UI，支持浅/深模式一键切换（自动记忆）
- 📐 网格 / 列表双布局自由切换
- ⚡ 快速加载（AJAX 异步获取，骨架屏过渡）
- 🔄 每个卡片支持单独刷新
- 📦 每榜默认显示 6 条，点击"查看更多"展开全部
- 🎬 卡片入场动画、悬停动效
- 🕐 实时时钟显示
- 🌤️ 天气信息显示
- 📊 实时统计：数据源数量、加载条数、更新时间
### 后台
- 🔐 管理员登录系统（支持多管理员）
- 🌐 平台管理：添加 / 编辑 / 删除 / 启停平台
- 🔌 支持自定义 API 接口和解析规则
- ⚡ 一键立即更新全部热榜
- 🔄 单平台单独刷新
- ⚙️ 系统设置（站点名、描述、布局、天气城市等）
- 👥 管理员管理（添加 / 删除 / 修改密码）
- 📊 仪表盘统计
## 📦 环境要求
- PHP >= 7.4
- 扩展：PDO SQLite、cURL
- Web 服务器：Nginx / Apache
- 可访问外网（用于抓取各平台 API）
4. **配置定时任务（自动更新热榜）**
- 宝塔面板 → 计划任务
- 任务类型：Shell 脚本
- 任务名称：热榜自动更新
- 执行周期：每 5 分钟
- 脚本内容：
```bash
php /www/wwwroot/hotsearch.yourdomain.com/api/cron.php
```
## 🔧 添加自定义平台
在后台 → 平台管理中可添加新平台：
1. **平台名称**：显示名称
2. **唯一标识**：英文，如 `weibo`
3. **API 地址**：数据源 URL
4. **解析类型**：
- 微博热搜 / 百度热搜 / 知乎热榜 / B站热门 / 抖音热点 / 今日头条 / GitHub Trending / 腾讯新闻
- **通用 JSON**：自动识别常见 JSON 结构（无需写解析代码）
5. **请求方法**：GET / POST
6. **自定义请求头**：如 `Referer: https://xxx.com`
7. **图标**：Emoji 表情
8. **颜色**：卡片主题色
## ⏰ 计划任务说明
| 方式 | 命令 |
|------|------|
| 宝塔 Shell 脚本 | `php /路径/api/cron.php` |
| Web 访问 | `https://域名/api/cron.php?key=xxx` |
| crontab | `*/5 * * * * php /路径/api/cron.php` |
## 🎨 技术特点
- **纯原生 PHP**：零依赖、零框架、轻量高效
- **SQLite 数据库**：无需 MySQL，单文件即数据库
- **全站 AJAX**：前台无刷新加载，流畅体验
- **响应式设计**：完美适配手机、平板、桌面
- **主题系统**：深浅双色主题，自动记忆用户偏好
- **动画过渡**：卡片入场、悬停、展开动画