Face Sorter (人臉自動分類器)

這是一個基於 Python 的自動化工具，能夠讀取指定資料夾內的所有照片，利用人臉辨識技術偵測不同的人物，並自動將屬於同一人的照片分類到各自的資料夾中。

功能特色 (Features)

• 自動人臉偵測：使用 face_recognition 函式庫進行高準確度的人臉識別。
• 自動分群：自動判斷新人物或已知人物，並建立對應資料夾。
• 可調整門檻值：提供 --threshold 參數，可根據照片品質或需求調整辨識的嚴格程度。
• 處理無人臉照片：自動將偵測不到人臉的照片歸類至 no_face 資料夾。
• 靈活操作：支援複製 (Copy) 或移動 (Move) 檔案模式。

安裝指南 (Installation)

1. 取得專案

git clone <your-repo-url>
cd Face_sorter

2. 建立虛擬環境 (Virtual Environment)

建議使用虛擬環境以避免套件衝突：

python -m venv venv

3. 安裝依賴套件 (Dependencies)

本專案已包含適用於 Windows 的 dlib 預編譯版本，可直接安裝：

# Windows
venv\Scripts\pip install -r requirements.txt

# Linux / Mac
source venv/bin/activate
pip install -r requirements.txt

注意：本專案依賴 face_recognition 和 dlib。如果在安裝 dlib 時遇到問題，requirements.txt 中使用的 dlib-bin 是專為 Windows Python 3.11 優化的解決方案。

使用方法 (Usage)

請確保您位於虛擬環境中，或使用虛擬環境的 Python 執行路徑。

基本指令

# Windows
venv\Scripts\python face_sorter.py --input_dir "您的照片資料夾路徑"

進階參數

venv\Scripts\python face_sorter.py --input_dir "C:\Photos\Unsorted" --output_dir "C:\Photos\Sorted" --threshold 0.5 --move

參數說明 (Options)

參數	說明	預設值
--input_dir	(必填) 包含未分類照片的來源資料夾。	無
--output_dir	輸出分類後照片的目標資料夾。	input_dir/sorted
--threshold	人臉比對的距離門檻值 (0.0 - 1.0)。數值越低越嚴格。	0.6
--move	若加上此標籤，將會移動檔案而非複製。	False (複製)

技術細節

• 語言：Python 3.11+
• 核心套件：
  • face_recognition: 基於 dlib 的先進人臉識別。
  • click: 用於建構優雅的命令行介面。
  • Pillow: 圖像處理。

授權 (License)

MIT License