如何快速下载Kemono.su图片？Kemono-scraper完整使用指南 🚀

Kemono-scraper是一款专为Kemono.su平台设计的高效图片下载工具，支持批量获取艺术作品、自定义筛选条件和智能文件管理。作为开源项目，它提供简单易用的命令行接口，让新手也能轻松上手，快速构建个人艺术收藏库。

📌 为什么选择Kemono-scraper？

✅ 核心功能亮点

• 多模式下载：支持通过链接、创作者主页或收藏夹批量获取内容
• 智能过滤系统：按日期、文件大小、扩展名精准筛选所需图片
• 自定义存储路径：通过模板自动按服务/创作者/标题分类文件
• 隐私保护：内置代理支持和Cookie认证，安全访问受限内容

💡 适用场景

无论是艺术爱好者备份收藏作品，还是创作者迁移个人作品集，Kemono-scraper都能提供高效解决方案。其异步下载机制可最大化利用带宽，比手动保存效率提升10倍以上！

📥 快速开始：3步安装指南

1️⃣ 克隆项目仓库

git clone https://gitcode.com/gh_mirrors/ke/Kemono-scraper
cd Kemono-scraper

2️⃣ 安装依赖

确保已安装Go环境（1.16+），执行：

go mod tidy

3️⃣ 构建可执行文件

go build -o kemono-scraper main/main.go

⚙️ 基础使用教程

🔗 通过链接下载单篇帖子

./kemono-scraper --url https://kemono.su/post/12345

👤 下载创作者全部作品

./kemono-scraper --creator https://kemono.su/creator/artist123

⚡ 高级筛选示例

只下载2023年1月后发布的PNG格式图片（>1MB）：

./kemono-scraper --creator https://kemono.su/creator/artist123 \
  --after 2023-01-01 \
  --ext png \
  --min-size 1048576

🛠️ 配置文件详解

创建config.json自定义默认参数：

{
  "output_dir": "downloads/{{service}}/{{creator}}",
  "max_concurrent": 5,
  "proxy": "socks5://127.0.0.1:1080"
}

配置文件加载路径：main/path.go中定义了默认配置查找顺序，支持用户目录和程序目录双重配置。

🔒 Cookie认证设置

自动获取浏览器Cookie

程序会自动检测系统中的Chrome/Firefox浏览器Cookie（main/cookie/），无需手动复制。

手动导入Cookie

创建cookies.txt文件，按Netscape格式保存Cookie，执行：

./kemono-scraper --cookie cookies.txt --url https://kemono.su/secret-post

📚 高级功能探索

📝 自定义下载模板

修改utils/format.go中的路径格式化函数，实现个性化文件组织方案。例如按日期+标题命名：

// 示例格式：2023-10/[artist]-[title]-[id].ext

📊 下载进度监控

内置进度条显示功能（downloader/progress.go），实时展示下载速度、剩余时间和成功/失败统计。

❓ 常见问题解决

🔍 Cookie获取失败？

• 确保浏览器处于运行状态
• 检查权限：Linux系统需确保程序可访问浏览器配置目录
• 尝试手动导出Cookie：main/cookie/utils/helper.go提供格式转换工具

🚫 下载速度慢？

调整并发数参数：--max-concurrent 10（建议不超过10，避免触发反爬机制）

🛡️ 安全与合规提示

• 使用前请确保遵守Kemono.su用户协议
• 下载内容仅供个人学习使用，勿用于商业用途
• 敏感内容建议启用代理：--proxy socks5://127.0.0.1:1080

📈 性能优化建议

1. 大文件下载启用断点续传：--resume
2. 定期清理临时文件：--cleanup
3. 复杂筛选建议先用--dry-run测试匹配结果

🤝 参与项目开发

Kemono-scraper采用模块化设计，主要代码结构：

• 核心下载逻辑：downloader/
• 命令行参数处理：main/args.go
• 终端交互功能：term/

欢迎提交PR改进功能或修复bug，详细贡献指南参见项目README.md。

通过本指南，您已掌握Kemono-scraper的核心使用方法。这款开源工具将持续更新，为艺术内容管理提供更强大支持。立即开始体验高效图片下载新方式吧！ 🎨