pic-gather 是一款专为图像收集需求打造的开源工具，旨在帮助用户高效地从网络或本地批量获取图片资源。在日常工作流中，设计师寻找灵感素材、研究人员构建数据集或普通用户整理照片时，往往面临手动下载效率低下、来源分散且难以统一管理的痛点。pic-gather 通过提供灵活的自定义采集源功能，让用户能够根据具体需求配置抓取规则，轻松跨越不同平台限制，将分散的图像资源集中归档。

该工具特别注重跨平台体验，完美兼容 Windows 和 MacOS 系统，确保不同操作环境下的用户都能获得一致流畅的使用感受。其技术亮点在于高度的可配置性，用户无需编写复杂代码即可定义采集逻辑，既降低了使用门槛，又保留了应对特殊场景的扩展能力。无论是需要快速建立视觉库的设计师、从事计算机视觉研究的数据分析师，还是希望自动化整理个人相册的普通用户，pic-gather 都能成为得力的助手。它以简洁实用的设计理念，将繁琐的图像搜集工作转化为简单的配置过程，让使用者能将更多精力专注于内容创作与分析本身。

pic-gather 快速上手指南

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux (Ubuntu/Debian/CentOS), macOS 或 Windows (WSL2 推荐)
• Python 版本：Python 3.8 或更高版本
• 前置依赖：
  • pip (Python 包管理工具)
  • git (用于克隆代码仓库)

提示：国内用户建议配置 pip 国内镜像源以加速下载：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装步骤

您可以通过以下两种方式之一安装 pic-gather：

方式一：通过 PyPI 安装（推荐）

pip install pic-gather

方式二：从源码安装

git clone https://github.com/your-org/pic-gather.git
cd pic-gather
pip install -e .

基本使用

安装完成后，即可在终端中使用 pic-gather 命令。以下是最简单的使用示例，用于抓取指定目录下的所有图片：

pic-gather --input ./source_folder --output ./collected_images

参数说明：

• --input: 指定包含图片或待扫描的源文件夹路径。
• --output: 指定整理后图片的输出文件夹路径。

执行完毕后，所有识别到的图片将被自动收集并保存至输出目录中。