feat: 新增App图标搜索器增强版功能
引入完整的App图标搜索器增强版,包括前端页面、后端缓存系统、样式和脚本。主要功能包括实时搜索、多尺寸图标下载、图片预览、响应式设计和智能缓存机制。后端通过ImageCache类实现图片缓存,前端通过JavaScript优化搜索交互和图片加载体验。新增README.md提供详细的部署和开发指南。
This commit is contained in:
164
README.md
Normal file
164
README.md
Normal file
@@ -0,0 +1,164 @@
|
||||
# App图标搜索器增强版
|
||||
|
||||
一个高效、现代的 App 图标搜索和下载工具,基于 iTunes Search API 开发。支持多种尺寸图标下载,具有响应式设计和用户友好的界面。
|
||||
|
||||
## 功能特点
|
||||
|
||||
- 实时搜索:支持即时搜索结果展示
|
||||
- 多尺寸下载:支持 75px、100px、256px、512px 尺寸
|
||||
- 图片预览:支持图标大图预览
|
||||
- 响应式设计:完美适配移动端和桌面端
|
||||
- 智能缓存:支持服务端和客户端双重缓存机制
|
||||
- 用户友好:简洁的界面设计和流畅的交互体验
|
||||
|
||||
## 技术栈
|
||||
|
||||
### 前端
|
||||
- HTML5 + CSS3
|
||||
- 原生 JavaScript (ES6+)
|
||||
- CSS Grid 和 Flexbox 布局
|
||||
- Service Worker 离线缓存
|
||||
|
||||
### 后端
|
||||
- PHP 7.4+
|
||||
- iTunes Search API
|
||||
- 文件系统缓存
|
||||
|
||||
### 服务器
|
||||
- Apache/Nginx
|
||||
- PHP-FPM
|
||||
- 图片缓存系统
|
||||
|
||||
## 部署指南
|
||||
|
||||
### 环境要求
|
||||
- PHP >= 7.4
|
||||
- Apache/Nginx Web服务器
|
||||
- 允许外部API访问
|
||||
- PHP GD库(用于图片处理)
|
||||
- 足够的磁盘空间用于缓存
|
||||
|
||||
### Apache 部署步骤
|
||||
|
||||
```
|
||||
<VirtualHost *:80>
|
||||
ServerName your-domain.com
|
||||
DocumentRoot /path/to/icons-enhanced
|
||||
|
||||
<Directory /path/to/icons-enhanced>
|
||||
Options -Indexes +FollowSymLinks
|
||||
AllowOverride All
|
||||
Require all granted
|
||||
</Directory>
|
||||
|
||||
<FilesMatch "\.(jpg|jpeg|png|gif)$">
|
||||
Header set Cache-Control "max-age=31536000, public"
|
||||
</FilesMatch>
|
||||
</VirtualHost>
|
||||
```
|
||||
|
||||
### Nginx 部署步骤
|
||||
|
||||
```
|
||||
server {
|
||||
listen 80;
|
||||
server_name your-domain.com;
|
||||
root /path/to/icons-enhanced;
|
||||
index index.php;
|
||||
|
||||
location / {
|
||||
try_files $uri $uri/ /index.php?$query_string;
|
||||
}
|
||||
|
||||
location ~ \.php$ {
|
||||
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
|
||||
fastcgi_index index.php;
|
||||
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
|
||||
include fastcgi_params;
|
||||
}
|
||||
|
||||
location ~* \.(jpg|jpeg|png|gif)$ {
|
||||
expires 1y;
|
||||
add_header Cache-Control "public, no-transform";
|
||||
access_log off;
|
||||
}
|
||||
}
|
||||
```
|
||||
### 配置权限
|
||||
|
||||
```
|
||||
chmod -R 755 .
|
||||
chmod -R 777 cache/images
|
||||
```
|
||||
|
||||
## 自定义开发指南
|
||||
### 前端定制
|
||||
1. 样式修改
|
||||
- 主题颜色:修改 css/styles.css 中的 CSS 变量
|
||||
- 布局调整:修改 Grid 和 Flexbox 相关样式
|
||||
- 响应式断点:调整 media queries 中的尺寸
|
||||
2. 交互优化
|
||||
- 搜索逻辑:修改 js/scripts.js 中的防抖函数
|
||||
- 动画效果:调整 transition 和 transform 相关属性
|
||||
- 预览功能:自定义模态框行为
|
||||
### 后端定制
|
||||
1. 缓存策略
|
||||
- 修改缓存时间:调整 ImageCache.php 中的 cacheDuration
|
||||
- 自定义缓存目录:更改 cacheDir 配置
|
||||
- 添加缓存清理机制
|
||||
2. API 调整
|
||||
- 修改搜索参数:调整 iTunes API 请求参数
|
||||
- 添加错误处理:完善异常处理机制
|
||||
- 扩展搜索源:添加其他图标源支持
|
||||
### 性能优化
|
||||
1. 图片优化
|
||||
- 实现图片懒加载
|
||||
- 添加图片压缩功能
|
||||
- 使用 WebP 格式支持
|
||||
2. 缓存优化
|
||||
- 实现浏览器缓存
|
||||
- 添加 CDN 支持
|
||||
- 优化缓存策略
|
||||
## 常见问题
|
||||
1. 图片加载失败
|
||||
- 检查服务器权限设置
|
||||
- 验证缓存目录权限
|
||||
- 确认外部API访问是否正常
|
||||
2. 搜索响应慢
|
||||
- 调整防抖时间
|
||||
- 优化数据请求策略
|
||||
- 检查服务器性能
|
||||
3. 移动端适配问题
|
||||
- 检查视口设置
|
||||
- 调整响应式断点
|
||||
- 优化触摸交互
|
||||
## 维护建议
|
||||
1. 定期维护
|
||||
- 清理过期缓存
|
||||
- 更新依赖版本
|
||||
- 检查API可用性
|
||||
2. 性能监控
|
||||
- 监控服务器负载
|
||||
- 跟踪API响应时间
|
||||
- 分析用户使用数据
|
||||
## 贡献指南
|
||||
欢迎提交 Pull Request 或 Issue。在提交之前,请确保:
|
||||
|
||||
1. 代码符合现有风格
|
||||
2. 添加必要的注释和文档
|
||||
3. 测试所有功能正常
|
||||
## 许可证
|
||||
MIT License - 详见根目录 LICENSE 文件
|
||||
|
||||
## 作者
|
||||
[Snowz]
|
||||
|
||||
## 更新日志
|
||||
### v1.0.0 (2025-03-31)
|
||||
- 初始版本发布
|
||||
- 基础搜索功能
|
||||
- 多尺寸下载支持
|
||||
### v1.1.0 (计划中)
|
||||
- 添加图片懒加载
|
||||
- 优化搜索体验
|
||||
- 改进缓存机制
|
||||
Reference in New Issue
Block a user