HenTiny - 極致圖片壓縮

AI驅動的智能圖片壓縮工具，讓您的圖片更小、更清晰！

線上試用版本：https://hentiny.vercel.app/

✨ 特色功能

🤖 AI 智能分析

• 畫質增強與壓縮：使用Google Gemini AI智能分析圖片內容
• 內容識別：自動識別圖片類型並優化壓縮策略
• 品質預測：AI驅動的壓縮品質預測

🎨 全面格式支持

• 多種格式：JPEG、PNG、WebP、AVIF
• 智能格式選擇：AI推薦最佳壓縮格式
• 無損/有損模式：可選擇無失真或有失真壓縮

⚙️ 精細控制

• 畫質調節：0-100%精確品質控制
• 尺寸調整：比例縮放或固定像素設定
• 畫質增強：銳利度、對比度、飽和度調節
• 進階優化：周邊模糊、色調分離、智慧降噪

📦 批量處理

• 批量壓縮：一次處理多張圖片
• 批量下載：一鍵下載所有處理結果
• 進度追蹤：實時監控處理進度

🚀 快速開始

環境要求

• Node.js 16+
• npm 或 yarn

安裝與運行

1. 克隆倉庫

   git clone https://github.com/your-username/hentiny.git
   cd hentiny

2. 安裝依賴

   npm install

3. 配置環境變量 複製 .env.local 文件並填入您的Google Gemini API Key：

   cp .env.local .env.local.example

   在 .env.local 中設置：

   GEMINI_API_KEY=your_gemini_api_key_here
   

4. 啟動開發服務器

   npm run dev

5. 訪問應用 打開瀏覽器訪問 http://localhost:3000

生產構建

# 構建生產版本
npm run build

# 預覽生產版本
npm run preview

📖 使用說明

獲取Google Gemini API Key

1. 訪問 Google AI Studio
2. 創建新的API Key
3. 將API Key添加到 .env.local 文件中

基本操作流程

1. 上傳圖片：拖拽或點擊上傳圖片文件
2. AI分析：點擊「AI智慧分析」讓AI分析圖片
3. 調整設定：根據需要調整壓縮參數
4. 開始壓縮：點擊「全部壓縮」處理圖片
5. 下載結果：下載壓縮後的圖片

進階功能

• 格式效率分析：查看不同格式的壓縮效果對比
• 畫質增強：使用AI增強圖片畫質
• 批量處理：一次性處理多張圖片
• 快速匯出：一鍵匯出為最佳格式

🛠️ 技術架構

核心技術

• 前端框架：React 19 + TypeScript
• 構建工具：Vite 6
• UI組件：Lucide React Icons
• AI服務：Google Gemini API
• 圖片處理：瀏覽器原生Canvas API

項目結構

hentiny/
├── src/
│   ├── components/          # React組件
│   │   ├── SettingsPanel.tsx
│   │   └── ComparisonSlider.tsx
│   ├── services/           # 服務層
│   │   ├── geminiService.ts
│   │   └── imageService.ts
│   ├── types.ts           # TypeScript類型定義
│   ├── App.tsx            # 主應用組件
│   └── main.tsx           # 入口文件
├── public/                # 靜態資源
├── .env.local            # 環境變量
├── .gitignore            # Git忽略規則
├── package.json          # 項目配置
├── tsconfig.json         # TypeScript配置
├── vite.config.ts        # Vite配置
└── README.md             # 項目說明

🎯 項目亮點

• ✨ AI驅動：整合Google Gemini AI，智能分析圖片內容
• 🚀 高性能：使用Vite構建，開發體驗流暢
• 📱 響應式：完美支持桌面和移動設備
• 🎨 現代UI：使用Lucide Icons，界面美觀直觀
• 🔧 高度可配置：豐富的壓縮參數和畫質選項
• 📦 批量處理：支持多圖片批量處理
• 🌐 多格式支持：支持主流圖片格式

🤝 貢獻指南

歡迎提交Issue和Pull Request來幫助改進項目！

開發流程

1. Fork本項目
2. 創建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 開啟Pull Request

📝 許可證

本項目採用 MIT 許可證 - 查看 LICENSE 文件了解詳情。

🙏 致謝

• Google Gemini AI - 提供強大的AI分析能力
• React - 優秀的前端框架
• Vite - 快速的構建工具
• Lucide - 美麗的圖標庫

---

如果這個項目對您有幫助，請給個⭐支持一下！

問題回報 • 功能請求 • 聯繫我