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 (2025-04-12)

• 添加图片懒加载
• 多尺寸下载支持
• 优化搜索体验
• 改进缓存机制