# appicon **Repository Path**: pig_tree/appicon ## Basic Information - **Project Name**: appicon - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-12 - **Last Updated**: 2026-07-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Site Icon Resolver 自动获取网站 Logo / Favicon 的全栈工具,支持 Android、iOS 应用图标搜索。 ## 功能 - **网站图标**:输入 URL,自动解析 HTML `` / Web App Manifest / favicon.ico,多策略回退 - **Android 应用图标**:通过 Google Play 搜索并获取应用图标 - **iOS 应用图标**:通过 App Store(多区域)搜索并获取应用图标 - **批量处理**:支持换行/逗号分隔批量获取 - **安全防护**:SSRF 防护、请求限流、超时控制 - **多层缓存**:内存 LRU(24h)+ 可选 Redis(7天) ## 依赖与磁盘占用 首次 `pnpm install` 后,`node_modules/` 约 **404 MB**(13 个顶层包,含所有 transitive 依赖)。 | 依赖 | 版本 | 用途 | |------|------|------| | next | ^15.1 | 全栈框架、API Routes | | react / react-dom | ^18.3 | 前端 UI | | cheerio | ^1.0 | HTML 解析 | | lru-cache | ^11.0 | 内存缓存 | | @upstash/redis | ^1.31 | 可选远程缓存 | | framer-motion | ^12 | 前端动画 | | lucide-react | ^0.562 | 图标库 | | typescript | ^5.7 | 类型检查 | | vitest | ^2.1 | 单元测试 | ## 快速开始 ```bash # 安装依赖 pnpm install # 配置环境变量 cp .env.example .env.local # 启动开发服务器 pnpm dev # 运行测试 pnpm test:run # 构建生产版本 pnpm build ``` 访问 http://localhost:3000 ## API ### 解析网站图标 ```bash GET /api/web?url=huggingface.co ``` ### 搜索 Android 应用 ```bash GET /api/android/search?query=Gemini ``` ### 搜索 iOS 应用 ```bash GET /api/ios/search?query=微信 ``` ## 项目结构 ``` app/ # Next.js App Router(页面 + API Routes) api/web/ # 网站图标解析 API api/android/ # Android 应用搜索 API api/ios/ # iOS 应用搜索 API components/ # React 组件 lib/ # 核心业务逻辑 web/ # 网站图标解析(waterfall 回退链) net/ # 网络请求、SSRF 防护、限流 cache/ # 内存 + Redis 缓存 android/ # Google Play / APKPure 搜索 ios/ # App Store 搜索 types/ # TypeScript 类型定义 tests/ # 单元测试 ``` ## 环境变量 参考 `.env.example`,主要配置项: | 变量 | 默认值 | 说明 | |------|--------|------| | `ALLOW_AGGREGATOR` | true | 是否允许聚合服务兜底 | | `FETCH_TIMEOUT_MS` | 8000 | HTML 抓取超时 | | `RATE_LIMIT_PER_MIN` | 60 | 每分钟请求限制 | | `REDIS_URL` | - | 可选 Upstash Redis |