chore: enforce strict CI checks and typing

Author: DennySORA

.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: ci
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install project dependencies
+        run: uv sync --frozen
+
+      - name: Install tooling
+        run: |
+          uv pip install \
+            ruff \
+            mypy \
+            pytest \
+            pytest-cov \
+            pip-audit \
+            pydantic
+
+      - name: Ruff format check
+        run: uv run ruff format --check
+
+      - name: Ruff lint
+        run: uv run ruff check
+
+      - name: Mypy
+        run: uv run mypy src
+
+      - name: Pytest
+        run: uv run pytest
+
+      - name: Dependency security audit
+        run: uv run pip-audit

.github/workflows/release.yml

@@ -0,0 +1,65 @@
+name: release
+
+on:
+  push:
+    tags:
+      - "*"
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install project dependencies
+        run: uv sync --frozen
+
+      - name: Install tooling
+        run: |
+          uv pip install \
+            ruff \
+            mypy \
+            pytest \
+            pytest-cov \
+            pip-audit \
+            pydantic
+
+      - name: Ruff format check
+        run: uv run ruff format --check
+
+      - name: Ruff lint
+        run: uv run ruff check
+
+      - name: Mypy
+        run: uv run mypy src
+
+      - name: Pytest
+        run: uv run pytest
+
+      - name: Dependency security audit
+        run: uv run pip-audit
+
+  publish:
+    needs: checks
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Create GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true

README.md

@@ -4,6 +4,24 @@
 
 A user-friendly tool for removing image backgrounds with multiple methods and a guided flow. It is designed for batch processing and for handling both everyday photos and green-screen shots.
 
+## Installation
+- Make sure Python 3.13 and `uv` are available.
+- Clone the repository and install dependencies.
+
+```bash
+git clone <repository-url>
+cd Remove-Background
+uv sync
+```
+
+## How to Use
+- Start the interactive flow and follow the prompts.
+- Outputs are saved as transparent PNGs in an `output/` folder under the selected directory.
+
+```bash
+uv run main.py
+```
+
 ## Usage Options
 - Guided interactive flow: select a folder, pick a removal method, adjust strength, and confirm before processing.
 - Green-screen workflow: optimized for solid green backdrops to clean edges and reduce color spill.

docs/README.ja.md

@@ -4,6 +4,24 @@
 
 複数の方式とガイド付きの流れを備えた、使いやすい背景除去ツールです。まとめて処理したい場合や、一般写真・グリーンスクリーン写真の両方に対応します。
 
+## インストール
+- Python 3.13 と `uv` を用意してください。
+- リポジトリを取得して依存関係をインストールします。
+
+```bash
+git clone <repository-url>
+cd Remove-Background
+uv sync
+```
+
+## 使い方
+- 対話フローを起動して案内に従います。
+- 出力は透明 PNG で、選択したフォルダ配下の `output/` に保存されます。
+
+```bash
+uv run main.py
+```
+
 ## 利用オプション
 - ガイド付きの対話的な流れ：フォルダを選択し、方式を選び、強さを調整してから確認して処理します。
 - グリーンスクリーン向け：単色の緑背景に最適化し、縁をきれいにし色かぶりを抑えます。

docs/README.zh-CN.md

@@ -4,6 +4,24 @@
 
 这是一款易用的图片去背工具，提供多种方案与引导式流程，适合批量处理，也能应付普通照片与绿幕照片。
 
+## 安装
+- 确认 Python 3.13 与 `uv` 可用。
+- 下载项目并安装依赖。
+
+```bash
+git clone <repository-url>
+cd Remove-Background
+uv sync
+```
+
+## 使用方法
+- 启动交互流程并按提示操作。
+- 输出为透明 PNG，保存在所选文件夹的 `output/` 内。
+
+```bash
+uv run main.py
+```
+
 ## 使用方案
 - 引导式流程：选择文件夹、选择方案、调整强度、确认后开始处理。
 - 绿幕流程：适合纯绿背景，让边缘更干净并减少色彩残留。

docs/README.zh-TW.md

@@ -4,6 +4,24 @@
 
 這是一款易用的圖片去背工具，提供多種方案與引導式流程，適合批次處理，也能應付一般照片與綠幕照片。
 
+## 安裝
+- 確認 Python 3.13 與 `uv` 可用。
+- 下載專案並安裝相依套件。
+
+```bash
+git clone <repository-url>
+cd Remove-Background
+uv sync
+```
+
+## 使用方法
+- 啟動互動流程並依提示操作。
+- 輸出為透明 PNG，存放在所選資料夾的 `output/` 內。
+
+```bash
+uv run main.py
+```
+
 ## 使用方案
 - 引導式流程：選擇資料夾、選擇方案、調整強度、確認後開始處理。
 - 綠幕流程：適合純綠背景，讓邊緣更乾淨並減少色彩殘留。

main.py

@@ -9,10 +9,11 @@
     uv run main.py
 """
 
+import logging
 import sys
 
-from src.core.processor import ImageProcessor
 from src.backends import BackendRegistry
+from src.core.processor import ImageProcessor
 from src.ui import InteractiveUI
 
 
@@ -23,6 +24,7 @@ def main() -> int:
     Returns:
         退出碼 (0: 成功, 1: 失敗或取消)
     """
+    logging.basicConfig(level=logging.INFO, format="%(message)s")
     try:
         # 1. 建立 UI
         ui = InteractiveUI()
@@ -49,16 +51,18 @@ def main() -> int:
         ui.show_result(result)
         ui.wait_for_exit()
 
-        return 0 if result.is_complete_success else 1
-
     except KeyboardInterrupt:
-        print("\n\n已取消")
+        sys.stdout.write("\n\n已取消\n")
+        sys.stdout.flush()
         return 1
 
-    except Exception as e:
-        print(f"\n錯誤: {e}", file=sys.stderr)
+    except Exception as exc:
+        sys.stderr.write(f"\n錯誤: {exc}\n")
+        sys.stderr.flush()
         return 1
+    else:
+        return 0 if result.is_complete_success else 1
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     sys.exit(main())