近年來，AI 技術在影像修復領域的應用日益成熟。CodeFormer 作為一款開源且功能強大的 AI 臉部修復工具，不僅能在官網線上修復模糊人臉照片，也支持本地批次修復，極大提升處理效率。本文將分享如何在 Debian 13 系統中，使用原生 Python 環境部署 CodeFormer，並示範利用自製的 aiphoto 腳本批次進行多種 AI 影像優化。
1. 升級 Debian 13 後重新部署 CodeFormer 環境
升級 Debian 13 後，我們放棄了先前使用 Anaconda3 的安裝方式，採用原生 Python3 虛擬環境以避免相依性和空間不足的問題。整個部署流程包括安裝 NVIDIA GPU 驅動（若有使用 Nvidia 顯卡）、CUDA環境配置、Python 環境建置與 CodeFormer 安裝等步驟。詳細步驟可參考完整教學：https://livedebiansystem.blogspot.com/2025/09/debian-13-python-codeformer.html
2. CodeFormer 專案測試資料夾與 aiphoto 腳本介紹
CodeFormer 專案中自帶一個測試資料夾，方便用戶快速驗證各類修復功能。本次示範的重點是 aiphoto 腳本，它是一個 Bash 腳本，可在已有圖片的資料夾中批次自動執行 CodeFormer 相關的多種影像修復與優化任務，省去手動複製與搬移圖片的麻煩，提升作業效率。
3. aiphoto 腳本五大功能示範
| 功能編號 | 功能說明 | 備註 |
|---|---|---|
| 1 | 僅修復人臉 | 權重越接近1失真越少 |
| 2 | 強化背景區域 | 權重越接近1失真越少 |
| 3 | 進一步提升修復後的人臉細節 | 權重越接近1失真越少 |
| 4 | 彩色化黑白或褪色照片 | 僅限 512x512 頭像 |
| 5 | 人臉修補（裁切並對齊的人臉） | 僅限 512x512 頭像 |
用戶可輸入權重（0~1 之間）調整修復強度，權重越接近 1，修復越自然且失真較少。彩色化和人臉修補功能目前限制處理大小為 512×512 像素的人臉圖像。
4. 腳本特色與使用便利性
此版本的 aiphoto 腳本主要特色是能夠直接在現有圖片資料夾內運作，批次處理後會在該資料夾下自動建立名稱為 ai_＋原資料夾名稱的子資料夾，將完成的修復圖片搬移其中。這大大簡化了以往需要手動複製來源圖片到執行資料夾，再搬移結果的繁瑣流程，使用起來更直覺且節省時間。
此外，彩色化與人臉修補結果直接從暫存資料夾搬移，其他功能則先在暫存的 final_results 子目錄生成結果，再搬移到最終資料夾，確保檔案管理清晰且作業過程順暢。
5. 相關影片示範
為了方便理解各功能的使用流程，請參考底下實際示範影片。
整體而言，利用 Debian 13 的原生 Python 環境結合 aiphoto 腳本，能讓喜愛影像修復的使用者輕鬆完成批次修復任務，並有效管理修復結果，適合日常照片整理與優化。
留言
張貼留言