OpenAver

English | 繁體中文

把放片的資料夾指給 OpenAver，它會做成一面封面牆。點封面看劇照和標籤，點女優看她的所有片，點標籤找同類。哪部片資料不全，按一下就從網路補上。

已經整理過的片，不用重新抓資料。 影片旁邊如果已經有資料檔（NFO，記著片名、女優、標籤的小檔案）和封面圖，掃描時直接讀進來，檔案原封不動。不管是 JavSP、EverAver、MDCX，還是 Jellyfin／Emby 整理的，都一樣。

可以只用這一個，也可以跟電視上的播放軟體一起用。 想在客廳看，整理時順便產出 Jellyfin／Emby／Kodi 要的資料檔和封面；不想裝那些，在 OpenAver 裡就能把收藏逛完。

預設不改、不搬、不刪你的影片。 補資料只會在影片旁邊新增資料檔和圖。只有你按「整理」，才會依你定的規則改名或搬家，而且絕不刪除。程式在你自己的電腦跑，不用註冊。

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

⚡ Live Demo → openaver.slive.uk

裡面只有 mecha 反派與虛構電影海報，零 NSFW。老闆從你身後走過也沒事。

規格速覽

截圖預覽

搜尋頁	女優收藏

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

💡 Windows 不想開 PowerShell：到 Releases 下載 OpenAver-Windows-Setup.bat，雙擊就是同一套安裝。

安裝指令會自動下載最新版、解除系統的安全限制、建立桌面捷徑（Windows），升級時保留你的設定。安裝畫面跟著系統語言走（繁中／簡中／日文／英文）。

手動下載 ZIP

從 GitHub Releases 下載：

⚠️ 手動 ZIP 要多一步解除安全限制，見 ZIP 內附的疑難排解文件。macOS 只支援 Apple 晶片。

第一次打開會有新手導覽，帶你指定資料夾、按下「產生網頁」，不用先讀文件。

🐧 Linux：沒有官方安裝程式，但可以自己架成區網伺服器用瀏覽器操作，步驟見 docs/linux-server.md（需要命令列）。

三個頁面

OpenAver 只有三個主要頁面，照順序用就對了：

1. 📋 Scanner（掃描）：把放片的資料夾加進來，按「產生網頁」。有資料檔的片直接入庫，缺資料的列出來，一鍵補完。
2. 🎬 Showcase（瀏覽）：封面牆。逛收藏、篩選、看劇照、找相似、管理女優。
3. 🔍 Search（搜尋）：新下載的片從這裡處理。拖進來，查資料，按「整理」改名搬到收藏。

核心功能

📋 Scanner：先把現有收藏接進來

• 認得別人整理過的東西：影片旁有 .nfo 就讀它的片名、女優、標籤、片商、系列、日期。封面認同名圖、-poster／-fanart 後綴、資料夾裡的 poster／fanart／cover／folder，還有 NFO 裡寫的圖片路徑；extrafanart/ 劇照夾一併讀。
• 掃描只讀不寫：來源資料夾一個位元組都不動。
• 缺什麼補什麼：掃完列出「缺 NFO」「缺封面」的片，一鍵從網路補齊。補完只填空的欄位，已有的資料不覆蓋；新增的 NFO 與封面放在影片旁，影片本身不動。
• 女優／標籤別名：在畫面裡直接加別名，不用手改設定檔。搜尋時中日英同義詞自動展開（「女僕＝Maid＝メイド」），同一人的藝名與退休名收成一張卡。
• 來源順序自己排：拖曳排出你偏好的來源順序（想要哪家的封面就排前面）；一鍵切「無碼模式」只用無碼來源。
• 搬檔時帶走字幕、保留 VR 標籤：整理時同目錄的字幕檔跟著走；VR 檔名裡的投影標籤（_180_LR、mkx200）保留，Skybox / DeoVR / HereSphere 才認得。

🎬 Showcase：用封面逛、用女優找

播放軟體用片名和資料夾找片；這裡用封面、標籤、女優。

• 封面牆＋大圖：點封面看劇照、標籤、女優資料。無碼片的封面自動對準人臉裁切，不會切掉半張臉；不滿意可以手動拖。
• 條件可以疊：大圖裡點女優、標籤、片商、導演、系列，搜尋框就多一枚可按掉的條件，多枚同時存在時取交集。點出來的是精準比對（點「巨乳」不會撈到「巨乳痴女」），自己打字才是模糊比對。
• 橫式封面↔直式卡片一鍵切：JAV 橫式封面的正面在右半邊，切成直式卡片一列放更多。只是畫面變形，不會多產生檔案。
• 女優模式：女優自己一面牆。資料卡有身高、罩杯、三圍、年齡、別名歷史；可依罩杯／年齡／身高／片數排序，也能用「165 以下」「B 罩杯」直接篩。
• 從自己的片庫補女優牆：按 + 就是一份「庫裡有誰、各幾片」的清單，別名自動合併成同一人，逐列點愛心加入。
• 相似探索：大圖點魔杖，同類的片環繞主圖，點任一顆繼續往下鑽。純本機規則比對（標籤、系列、片商、女優），離線即時、免 GPU。
• 整理完馬上出現：在 Search 整理成功的片，目標在掃描範圍內就直接飛進 Showcase，不必重掃。
• 連不到的位置會說：片庫放 NAS 或外接碟，連不到時底部狀態列直接寫出是哪一個。
• 手機、平板也能逛：設定裡一鍵切「伺服器」，同 Wi-Fi 的裝置用瀏覽器打開網址就能逛；用完切回「單機」立刻關閉對外。介面為觸控重做，封面可左右滑。

🔍 Search：新片從這裡進來

• 8 家一次查：JavBus、Jav321、JavDB、DMM、D2Pass、HEYZO、FC2、AVSOX 同時查，結果自動比對片庫、標示已收藏。JavDB 走它官方 App 用的資料通道，被擋、安裝路徑含中日韓文字的情況大多也查得到，封面沒有浮水印。
• 拖檔案或資料夾進來：自動認番號、批次查資料、拉封面和劇照。番號、女優名、系列、片商都能搜；UC / LEAK / 4K 這類版本自動變成標籤。
• 看完再整理：查到的資料先看大圖（封面、劇照、演員、標籤），確認了才按「整理」改名、建資料夾、寫 NFO、下載封面。
• 書籤：想看但還沒入手的片先收起來，封面當下存本機，原站掛了也不破圖。片子入庫後書籤自動消失。
• 定時整理：「我的最愛」（你指定的下載完成資料夾）旁一顆開關，開著之後每 12 小時自動對那個資料夾跑一輪「查資料 → 整理」，人不必在場；也能按「立刻執行一次」。
• 進階重刮：刮錯片或想換來源時，改番號、指定來源重抓，先看預覽再決定要不要覆蓋。

📀 唯讀來源：NAS 上的片不搬、不改，也能進播放軟體

想把 NAS、雲端掛載，或任何「不想被工具碰」的收藏掛進 Jellyfin／Emby／Kodi，又不想複製幾 TB 的原檔：把那個來源標成唯讀。

• 來源一個位元組都不動：只讀。抓好的 NFO、封面、劇照全部寫到你指定的本地輸出夾。
• .strm 直接餵播放軟體：.strm 是一個只寫著「影片在哪裡」的小檔案，Emby / Jellyfin / Kodi 掃到就能直接播原檔，不用複製。
• 兩台電腦路徑不一樣也行：OpenAver 這台看到的路徑跟播放軟體那台不一樣時（不同掛載點、Windows 網芳路徑 UNC、Windows 裡的 Linux 路徑 WSL），設一組替換規則自動改寫；改規則時既有的 .strm 一併更新。

🌐 AI 翻譯

• 日文片名一鍵翻成你的介面語言（繁中／簡中／英文）。
• 支援 Ollama（本地 GPU，免費）、Gemini Flash（有免費額度）、OpenAI 相容端點（OpenRouter 等）。

⚙️ Settings

• 四種語言即時切換（繁中／簡中／日文／英文）。
• 命名規則自己定：資料夾層級、檔名格式、變數，設定頁即時預覽結果。
• 「我的最愛資料夾」：指向下載器的已完成夾（不是女優收藏），Search 頁按「我的最愛」一鍵載入裡面全部影片。
• 播放軟體模式（選配）：選 Jellyfin / Emby / Kodi，整理時自動產出它們認得的 poster＋fanart 檔名與 NFO。（{stem}-fanart 只有 Jellyfin／Kodi 讀，Emby 不認。）
• 靜態 HTML 匯出：產生一個獨立的 HTML 檔，不開程式也能離線翻。

🔌 Metatube 聯邦（進階選配）

內建 8 家開箱即用。想要更多來源：在進階設定接上你自架的 Metatube，來源合計就有 30+ 個社群維護的 provider，無碼與小眾片商一次補強。Metatube 要自己架（Docker 或執行檔）；不啟用完全不影響預設體驗。

🤖 AI-Ready API

本機提供一份說明檔（capabilities manifest），AI 工具讀完就能自己串多個步驟，做那些人做起來瑣碎到放棄的事：

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

一行 curl 讓 AI 自學所有端點（Port 在 Settings 頁的「AI API」區塊）：

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

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

💡 對話內想看到封面：Codex App（對話內嵌） 或 Google Antigravity 2.0（artifact 面板） 兩款桌面 app 都能在對話中向你展示封面。

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

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

🪄 進階玩家彩蛋：FC2 自動找女優。 FC2 影片幾乎都沒女優標記，但其中不少是後來轉有碼出道的熟面孔（白上咲花就是經典案例）。SQL 撈 actress 為空的片 → DeepFace（RetinaFace + ArcFace）對 Gfriends 庫比對 → POST /api/user-tags 寫回標記。50 行 Python 一個週末跑完全庫，發現喜歡的手動加收藏；未識別素人 DBSCAN 自建群組下次直接配對。

常見問題（FAQ）

從 JavSP、MDCX 或 EverAver 換過來，已經整理好的資料夾會怎樣？ 不用重刮，影片旁的資料檔（NFO）和封面會直接讀進來，已有的內容不會被覆蓋。把原資料夾加進 Scanner、按一次「產生網頁」就好。

用 OpenAver 整理好的片，可以直接給 Jellyfin / Emby / Kodi 用嗎？ 可以。整理時一併產出它們要讀的 NFO 和封面圖（poster / fanart），影片留在原地，Jellyfin / Emby / Kodi 掃到那個資料夾就會正確顯示封面和資料。

OpenAver 可以和 Jellyfin / Emby / Kodi 一起用嗎？ 可以一起用。OpenAver 負責找片、抓資料、用封面和女優逛收藏；它們負責在電視上播放。不裝它們也行，OpenAver 本身就能把收藏逛完。

片子在 NAS 或雲端硬碟上，不想搬也不想被改，可以用嗎？ 可以，把那個資料夾設成「唯讀」，原檔不搬不改、不寫入任何東西，抓好的資料檔和封面另外放到本機輸出夾，還能產生 .strm 讓播放軟體直接串流原檔。NAS、掛載成磁碟的雲端硬碟、外接碟都適用。

OpenAver 會搬移、改名或刪除我的檔案嗎？ 只有你主動按「整理」才會依你設定的規則搬移或重新命名影片檔，而且絕不刪除；目標位置已有同名檔會先提醒你。搜尋、瀏覽、掃描都是純讀取；補資料只在影片旁新增 NFO 與封面，影片本身不動。

Mac 可以用嗎？要裝 Docker 嗎？ Mac 可以用，限 Apple 晶片（M1 之後），一行指令或下載 ZIP 就裝好。不需要 Docker，Windows 與 Mac 都是桌面程式，裝好後用滑鼠操作。

有沒有可以靠封面和女優找片、不用翻資料夾的 JAV 管理軟體？ OpenAver 就是為這個做的：收藏做成封面牆，點封面看劇照和標籤，點女優看她的全部片子；檔名和資料夾不再是主要找片方式。

電腦裡的片子可以用手機或平板逛嗎？ 可以，同一個 Wi-Fi 下在設定裡打開「伺服器」，手機瀏覽器打開那個網址就能逛；用完關掉，預設不會暴露到外網。

如果內建的刮削來源（Scraper）失效了怎麼辦？ 內建 8 家來源彼此備援，一家暫時失效其他家會補上；JavDB 另有官方 App 用的資料通道，被擋時多半仍查得到。進階玩家可接自架的 Metatube 聯邦再擴 30+ 家，等於替片庫多買一份保險。

官方站已經下架的片還查得到資料嗎？ 查得到，桌面版接了 JavLibrary 與 FC2-javten 兩個備份站。它們在 Cloudflare 人機驗證後面，OpenAver 選擇尊重它：會彈出一個真的瀏覽器視窗讓你手動點一次，之後自動重試回填。所以這兩家只支援桌面版的手動精確番號查詢，不參與批次搜尋、也不開放給 AI。

可以讓 AI 工具操作 OpenAver 嗎？ 可以，本機提供一份說明檔（capabilities manifest），Claude Code、Cursor 等 AI 工具用一行 curl 讀完就能下指令整理片庫、批次收藏女優、加標籤。

會收集隱私或上傳我的檔案嗎？ 不會上傳你的影片或片庫清單，也沒有帳號和遙測；連網只為了抓公開的片名、封面、女優資料。

Windows 關閉視窗後可以在背景跑嗎？ 可以縮到右下角系統匣繼續跑，點圖示再打開。點右上角 X 時會問你要退出還是縮小，可勾「不再顯示」記住；之後到「設定 → 系統設定 → 關閉視窗時」調整。

開發者指南

技術架構