# 🧲 Kenney Asset Scrapper

一个为开发者而生的自动化工具，专为抓取、整理和本地化 [Kenney.nl](https://kenney.nl/assets) 免费资源库而设计。支持批量提取资源信息、下载素材包和图片，并可生成本地资源索引，方便在离线环境中高效使用。

---

## 📁 项目结构

```plaintext
Kenney-Asset-Scrapper/
├── frontend/                   # 已废弃的旧前端版本（v1~v3）
│   ├── v1/
│   ├── v2/
│   └── v3/
├── scrapper/                  # 爬虫与处理核心
│   ├── main.py                # 爬取所有资源链接与详情
│   ├── asset_downloader.py   # 批量下载 ZIP 素材包
│   ├── image_downloader.py   # 批量下载预览图
│   ├── kenney_data_to_local.py # 替换 JSON 为本地路径
```

---

## 🚀 功能亮点

| 模块 | 功能 |
|------|------|
| `main.py` | 爬取 Kenney 网站资源列表与详情，包括标题、分类、版本日志、预览图与下载链接，并保存为结构化 JSON |
| `asset_downloader.py` | 根据 JSON 批量下载 ZIP 资源，自动分类存储（按类型 + 系列） |
| `image_downloader.py` | 批量下载所有预览图，结构化存储至本地 |
| `kenney_data_to_local.py` | 将所有网络路径（资源/图片）替换为对应的本地路径，方便离线访问或嵌入其他系统 |

---

## 🛠 使用说明

1. **抓取资源页面数据**  

   ```bash
   python scrapper/main.py
   ```

   ⏳ 会生成 `kenney_links.txt` 和 `kenney_data.json`。

2. **下载 ZIP 素材包**  

   ```bash
   python scrapper/asset_downloader.py
   ```

   ✅ 下载到 `kenney_assets/`，按分类 & 系列整理。

3. **下载图片预览**  

   ```bash
   python scrapper/image_downloader.py
   ```

   🎨 所有图片将下载到 `kenney_assets_images/`，与资源信息匹配。

4. **本地路径替换**  

   ```bash
   python scrapper/kenney_data_to_local.py
   ```

   📝 生成 `kenney_data_local.json`，将所有 `download` 和 `images` 字段替换为本地路径。

---

## 🗃 示例结构

```plaintext
kenney_assets/
└── 2D/
    └── Roguelike RPG/
        └── Roguelike RPG V1.4.zip

kenney_assets_images/
└── 2D/
    └── Roguelike RPG/
        └── Roguelike RPG/
            ├── preview1.png
            ├── preview2.jpg
            └── ...
```

---

## 🧪 注意事项

- 所有请求均带有浏览器头（User-Agent）以防被屏蔽
- 下载任务中加入了随机延迟以模拟人类操作，避免触发反爬机制
- 项目未来将继续支持更多格式，如 CSV 导出、数据库同步、本地 Web UI 预览等

---

## 📦 前端说明

原始 `frontend/` 文件夹中的 v1~v3 版本已**弃用**，请转而使用新的 Vue 前端项目 👉 [`kenney-asset-frontend-vue`](https://github.com/kingsmai/kenney-asset-frontend-vue)

---

## 📜 License

MIT License © 2025 — Inspired by the generosity of **Kenney** and his contributions to the open game development community.

---

如需增强或集成至你的工作流，欢迎提 Issue 或 PR！  
Let's automate creativity! 🎮✨