Open Source

2025-04-22 09:11:40 +08:00
commit a4bf39a958
14 changed files with 1043 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,111 @@
+# 🧲 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! 🎮✨