OpenAver

不需要 Docker，不需要命令列 — Win/Mac 一行安裝，打開就是完整圖形介面的 JAV 元數據管理工具。
6 大來源聯合搜尋 · 女優收藏與別名管理 · 互動式收藏瀏覽器 · Jellyfin 整合 · AI API 一句話操作片庫

Open-source desktop GUI for JAV metadata — one-line install, 6 scrape sources, actress favorites + alias system, Jellyfin/Emby ready, AI-operable REST API.

English | 繁體中文

核心功能由三個頁面組成：🔍 搜尋影片資訊 → 📋 掃描建庫 → 🎬 瀏覽收藏

100% 本地運行 — 不蒐集資料、不上傳任何檔案資訊，網路請求僅用於刮削公開元數據。

✨ 亮點：同時搜 6 個來源一次查完 · 女優收藏自動建檔 + 別名搜尋展開 · 缺 NFO 或封面一鍵從網路補齊 · AI 一句話操作你的片庫 · Jellyfin / Emby 封面自動生成 · 2400+ 自動化測試

截圖預覽

搜尋頁	女優收藏

更多截圖

Search Demo	女優搜尋 Gallery

Showcase 影片模式	Showcase 詳細

---

安裝

推薦方式：一行安裝

macOS:

curl -fsSL https://raw.githubusercontent.com/slive777/OpenAver/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/slive777/OpenAver/main/install.ps1 | iex

安裝指令會自動：

• 偵測系統架構並下載最新版本
• 解除平台安全限制（macOS quarantine / Windows Mark of the Web）
• 建立桌面快捷方式（Windows）
• 保留設定與日誌檔案（升級時）

備用方式：手動下載 ZIP

從 GitHub Releases 下載：

平台	檔案
Windows x64	OpenAver-vX.X.X-Windows-x64.zip
macOS arm64	OpenAver-vX.X.X-macOS-arm64.zip

⚠️ 手動 ZIP 安裝需額外步驟解除安全限制，見 ZIP 內附的疑難排解文件。 ℹ️ macOS 版本僅支援 Apple Silicon (M1/M2/M3/M4)。

首次開啟會自動進入新手導覽，帶你完成資料夾與基本設定，不需要先讀文件。

---

核心功能

🔍 Search（搜尋）

• 多來源聯合搜尋：同時搜尋 JavBus, Jav321, JavDB, DMM, D2Pass, HEYZO，一次查完所有來源。
• 大圖詳情頁：封面、劇照、演員、標籤集中顯示，不用反覆切頁找資訊。
• 智慧搜尋：番號、女優名、系列、片商都能搜，搜尋結果自動比對本地片庫並標示已收藏。
• 女優功能：搜尋已收藏女優自動顯示個人資料卡，搜尋結果可直接加入收藏。
• 版本自動辨識：自動識別 UC/LEAK/4K 等版本差異，整理檔名時不用手動補。
• 本地檔案批次搜尋：拖入影片檔案或資料夾，自動辨識番號並批次查詢影片資訊、封面與劇照。

🎬 Showcase（瀏覽收藏）

• 影片模式：封面牆 Grid + 詳細 Lightbox + 搜尋篩選排序 + 劇照瀏覽，完整的互動式收藏瀏覽器。
• 女優模式：收藏女優 Grid + 個人資料 Lightbox + 按罩杯 / 年齡 / 身高排序，一鍵重新抓取更新資料。
• 視覺設計：GSAP 動效 + Fluent Design 毛玻璃特效 + Dark Mode，SSR 即時渲染。

📋 Scanner（掃描與管理）

• 掃描建庫：掃描本地影片資料夾，建立 SQLite 元數據庫，自動讀取 NFO 封面。
• NFO / 封面補完：偵測缺失的 NFO 欄位或檔案，一鍵從網路刮削補齊。
• 女優別名管理：新增、編輯別名，搜尋時自動展開所有已知名稱。
• 字幕偵測：影片搬移時自動偵測並搬移同目錄字幕檔。

🌐 AI 翻譯

• 日文標題一鍵翻譯為你的 UI 語系（繁中 / 简中 / 英文），日文模式跳過翻譯。
• 支援 Ollama（本地 GPU，免費無限制）、Gemini Flash（Google 雲端，有免費額度）和 OpenAI API Compatible（OpenRouter、任意相容端點）。

⚙️ Settings（設定）

• 多語系 UI：繁中 / 简中 / 日文 / 英文，即時切換。
• 路徑管理：靈活設定輸出路徑與檔案命名規則，支援 {suffix} 格式變數。
• 我的最愛資料夾：設定常用資料夾，一鍵載入並自動搜尋。
• Jellyfin 圖片模式：自動生成 poster / fanart 供 Jellyfin / Emby 使用。
• 靜態 HTML 匯出：生成獨立 HTML 索引檔，不需部署伺服器也能離線瀏覽。

🤖 AI-Ready API

OpenAver 內建 capabilities manifest，AI agent 讀一次就知道所有端點怎麼用。不只查資料 — 它能自己串多個步驟，完成那些人做起來瑣碎到放棄的事。

一句話，AI 自己跑完整流程：

• 「幫我把片子最多的 top 20 女優加入最愛，跳過已收藏的。」 _{SQL 統計 → 查重 → 批次收藏 → 下載照片}
• 「橋本ありな 跟 新ありな 是同一人而且退休了，幫我加 tag。」 _{建立別名關聯 → 搜出兩個名字的所有片 → 批次加上「引退」標籤}
• 「這篇文章提到的番號，做成有封面的 HTML 頁面。」 _{解析番號 → 批次搜尋 → 下載封面 → 生成 Gallery HTML}

日常操作也順手：

• 「搜 SAME-123, PRED-456, IPZZ-789 的完整資訊」— 多來源聯合搜尋
• 「把 D:\av 的 NFO 資料補齊」— 原地補完，不搬移不改名
• 「我今年抓最多的系列是哪個？」— SQL 查詢收藏資料庫

不需要 SDK，不需要讀文件。一行 curl，AI 自學所有端點：

curl http://localhost:<port>/api/capabilities

Port 和完整 URL 可在 Settings 頁面的「AI API」區塊查看。

支援任何 MCP / function-calling 相容的 AI 工具：

使用方式	工具	說明
CLI	Claude Code, Codex CLI, Gemini CLI, Aider 等	終端機直接 curl，所有 CLI agent 皆支援
IDE	Cursor, GitHub Copilot in VS Code, Windsurf, Trae, Google Antigravity 等	Agent 模式 / MCP 呼叫本地 API
桌面 App	Codex App, Claude Cowork, OpenClaw	不需開發環境，開箱即用

💡 推薦：OpenAI Codex App（Win/Mac，免費方案可用）— 目前唯一能在對話中直接顯示封面圖片的 AI 工具，安裝簡單，開箱即用。

⚡ 小模型友善：capabilities manifest 已針對輕量模型優化，Gemini Flash / GPT-5.4 mini / Claude Haiku 皆可正確操作所有端點。

💻 想讓 AI 預讀 repo、或自己擴充端點？ 所有端點定義在 web/routers/capabilities.py — AI agent clone repo 時會優先讀這個檔，不需要啟動服務就能學會所有工具。

---

開發者指南

技術架構

層級	技術
Backend	FastAPI (Python 3.10+)
Frontend	Jinja2 + DaisyUI + Tailwind CSS + Alpine.js 3.x + Fluent Design 2
Animation	GSAP 3.14+ + Motion Adapter (reduced-motion support)
Desktop	PyWebView (Windows/macOS)
Database	SQLite (WAL mode)
Testing	Pytest (2400+ tests)

從原始碼執行

前置需求: Python 3.10+、Chrome/Edge、WebView2 Runtime (Windows 10/VM)

# Clone + 建立虛擬環境 + 安裝依賴
git clone https://github.com/slive777/OpenAver.git
cd OpenAver
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

# 開發模式 (Hot Reload)
uvicorn web.app:app --reload --host 0.0.0.0 --port 8000

# 桌面模式 (Windows)
python windows/launcher.py

執行測試

source venv/bin/activate
pytest

目錄結構

OpenAver/
├── web/                # Web GUI (FastAPI)
│   ├── routers/
│   │   ├── capabilities.py  # 🌟 AI Manifest — 所有端點的自描述定義（單檔全貌）
│   │   └── ...              # 其餘業務端點（search / scanner / scraper / actress / ...）
│   ├── templates/      # HTML Templates (DaisyUI + Fluent Design 2)
│   └── static/         # CSS/JS Assets (Modular JS, Theme CSS)
├── core/               # 核心邏輯
│   ├── scrapers/       # 模組化爬蟲 (JavBus/JavDB/Jav321/FC2/AVSOX/DMM/D2Pass/HEYZO)
│   ├── database.py     # SQLite 資料層 (WAL mode)
│   ├── organizer.py    # 檔案整理 + fallback 空值防護
│   ├── path_utils.py   # 跨平台路徑處理 (file:// URI)
│   ├── i18n.py         # 多語系翻譯核心 (t() / fallback chain)
│   └── translate_service.py  # AI 翻譯 (Ollama/Gemini/OpenAI Compatible)
├── locales/            # 四語系 JSON (zh_TW/zh_CN/ja/en)
├── tests/              # 測試代碼 (Pytest)
└── windows/            # Windows 啟動器 (PyWebView)

打包應用程式

source venv/bin/activate
python build.py          # Windows
python build_macos.py    # macOS

---

疑難排解

💡 疑難排解請參閱打包版 ZIP 內附的「疑難排解」文件，或查看 GitHub Wiki。

---

社群與回報問題

加入 Telegram 群組 與其他使用者交流討論！

管道	適用情境
GitHub Issues	Bug 回報、功能建議、開發討論
Telegram 群組	隱私敏感問題、截圖/影片直傳

回報時請附上: 問題描述、重現步驟、OS 版本、日誌檔案（執行 Debug 版啟動腳本取得）。

---

致謝

OpenAver 使用並感謝以下開源專案：

• FastAPI - 現代化的 Python Web 框架
• PyWebView - 輕量級的跨平台桌面應用框架
• GSAP - 高效能 JavaScript 動畫引擎
• DaisyUI - Tailwind CSS 元件庫
• Tailwind CSS - Utility-first CSS 框架
• Alpine.js - 輕量級 JavaScript 框架

License

MIT License

---

⚠️ 免責聲明

本專案僅供個人學習研究使用，請使用者遵守：

• 尊重網站服務條款
• 合理控制請求頻率
• 不用於商業目的

使用本專案造成的任何後果由使用者自行承擔。