OpenAver

English version below ↓

一行安裝

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

💡 不想開 PowerShell 的 Windows 用戶：到下方 Assets 下載 OpenAver-Windows-Setup.bat，雙擊即可。 🗄️ Synology 用戶：到下方 Assets 下載 OpenAver-v0.17.18-Synology-beta.spk，安裝方式見說明文件。

v0.17 系列。

🔍 模糊搜尋大改：DMM／JavBus／JavDB 三家全面升級

不打完整番號的搜尋（女優名、片商、關鍵字…）以前大多只是拿字去比對標題，漏很多。這次三家一起重做：

• 能搜的東西變多了：除了女優、片商，現在系列、導演、AV廠商、番號前綴（含 HEYZO 這類無碼前綴）都能直接打，列出它的全部作品。
• 女優片單完整多了：先認出是哪一位、再列出她的整份作品，不再只看標題有沒有她的名字（例：三上悠亜 從約 108 部變成約 417 部）。改名的女優打新名或舊名都是同一份片單；繁中、簡中、羅馬字名字也查得到。
• DMM 看得到還沒發行的預購片，結果卡上的番號也改用 DMM 官方番號，3DSVR-1774 這類不再轉錯。
• JavDB 加入模糊搜尋，三家照你在設定頁排的順序接力：前一家查不到或連不上，就換下一家；「載入更多」一路由同一家回答，不會中途換家。
• 直接打片商名（SOD、MOODYZ、本中…）看它最新的作品；搜尋頁還沒搜尋時，也會列出你最近最常收的幾家片商，點一下就看。

🧩 自訂來源：中文片、動畫、片商官網也能加成來源

• 內建來源沒收的片——中文片、動畫、片商自己的官網——只要網站上每部片有自己的編號頁、不用登入，就能加進來。
• 最簡單的做法是跟 AI 助理說一句：「幫我把 https://… 這個站加成 OpenAver 的自訂來源」。它會寫好規則檔、上傳、跑驗收，通過就自動啟用。
• 規則檔只是描述「片名、封面、女優在頁面哪裡」的設定，不執行任何程式碼；想自己手寫也可以，格式見說明文件。
• 片入庫後，在大圖 ⚙ 重刮時選它。

📊 片庫分析頁更好用

• 年份、女優、片商三種條件可以同時選、各自清掉；年份長條可以用滑鼠拖出一段範圍。
• 點片數、標籤、導演、系列，帶著目前的條件直接跳到瀏覽頁看那幾部片，兩邊片數對得上。
• 女優榜加長成 Top 25；還沒收藏的女優在這頁點空心愛心就能收藏，頭像和年齡圖當場更新。

🖥️ 客戶端模式：桌面 App 連 NAS，不再被瀏覽器綁手綁腳

以前 OpenAver 裝在 NAS（或另一台電腦）上，你只能用瀏覽器逛：播放只能用瀏覽器內建的、外掛字幕讀不到、JavLibrary／FC2-javten 整個灰掉不能用。現在改用桌面 App 連過去，這些限制都沒了：

• 用你自己的播放器：PotPlayer、IINA 這類播放器直接開 NAS 上的原檔，旁邊的 .srt 字幕自動載入，畫質增強、補幀這些播放器功能照用。
• JavLibrary／FC2-javten 能用了：需要真人驗證的來源，驗證視窗跳在你眼前這台電腦，點一下就過。
• 「在資料夾中顯示」也行：直接打開 NAS 上那部片所在的資料夾。
• 設定很簡單：側欄「連線」填網址和密碼、測試、套用。這台電腦要看得到 NAS 的共用資料夾；兩邊看到的路徑寫法不同時，設一張對照表即可，每一列都能單獨測試。想回本機，按「切回本機」。

🌐 AI 翻譯

• 新增 Claude 翻譯引擎（貼 Anthropic API Key 就能用）。
• 大圖片名旁多一顆翻譯鈕：日文片名一鍵換成中文，原文留著、6 秒內可復原，也會寫進 NFO（記著片名的資料檔）。
• Gemini、OpenAI 相容端點用「思考型」模型時不再翻出空白；「測試翻譯」成功就代表真的翻得出來；翻譯失敗會分「被內容審查擋下」「額度用完」「其他」講清楚。
• 翻譯時人名、品牌名保留原文。

✨ 其他新功能

• 代理可以給所有來源用：設定頁 Proxy 填位址後，選「僅 DMM」或「所有來源」；NAS／伺服器版也能讓全部來源走代理。旁邊多一顆「測試連線」，一次測完所有開著的來源。
• 女優資料多一個來源 avbase：剛改名、剛出道的女優也查得到生日和身材，別名會帶出她的另一個名字；查得到資料但沒照片時，收藏會從她的片封面裁一張頭像。
• AI 助理新能力：可以改片名、加書籤、查書籤，搭配排程就能「每週幫我看收藏的女優有沒有新片，有就加書籤」。

🐛 修復

• 搜已引退女優的名字（例 三上悠亜）時，上方資料卡不再顯示成同批合輯裡的另一位女優。
• 開 App 不再等 NAS 和 metatube 回應，視窗馬上出來。
• 封面圖不再因為圖床網域不在內建清單裡而破圖（開 Clash／Surge TUN 也可以）。
• 片庫路徑連不上時說「無法存取」，不再說成「資料夾不存在」；NAS 掛的是別台的分享、那台關機時，瀏覽頁狀態列會提示。
• 維基上「158.5 cm」這種身高不再被讀成 5 cm，註腳標記也不再混進資料。
• 「載入更多」還沒回來時就換了搜尋，舊結果不會再接到新畫面後面。
• Jellyfin 10.11.7 起，指向硬碟路徑的 .strm 播不了（只能放網址）；說明文件補上改走 Alist／OpenList 網址的做法。

已知限制

• 「連線」需要對方主機也是 0.17.7 以上。
• 自訂來源不參與新片入庫與自動搜尋，要入庫後在 ⚙ 重刮時手動選；需要登入或 Cloudflare 驗證的網站不支援；網站改版後要重跑一次驗收。
• 搜尋頁「片商最新作品」那排只問 JavBus，JavBus 擋你的時候用不了。
• JavDB 回答的女優名少數會是中文字形（例 三上悠亞），同一人可能出現兩種寫法，請到別名管理合併。

English

One-line install

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

💡 Prefer not to open PowerShell? Grab OpenAver-Windows-Setup.bat from the Assets below and double-click it. 🗄️ Synology users: grab OpenAver-v0.17.18-Synology-beta.spk from the Assets below — see the install guide.

This is the whole v0.17 series.

🔍 Fuzzy search, rebuilt across DMM, JavBus and JavDB

Searching without a full video ID (an actress name, a maker, a keyword…) used to mostly match words against titles, so a lot slipped through. All three sources have been reworked together:

• More things you can search: besides actresses and makers, you can now type a series, director, label, or ID prefix (including uncensored prefixes like HEYZO) and get everything un

English version below ↓

一行安裝

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

💡 不想開 PowerShell 的 Windows 用戶：到下方 Assets 下載 OpenAver-Windows-Setup.bat，雙擊即可。 🗄️ Synology 用戶：到下方 Assets 下載 OpenAver-v0.16.13-Synology-beta.spk，安裝方式見說明文件。

v0.16 系列。

🗄️ 可以裝在 Synology NAS 上了（beta）

• 從 DSM 套件中心手動安裝，DS218、DS918+ 這類 64 位元機種都能裝（DSM 7.0 以上）。
• 安裝時選好你的影片「片庫」，OpenAver 會自動取得讀寫權限並加進掃描清單，裝好就能掃，不用再去控制台授權。其他資料夾一樣可以加，但要自己到控制台授權（說明文件有步驟）。
• 裝好後用瀏覽器打開設定頁上的網址，手機、平板、其他電腦都能看。
• 區網密碼改成在瀏覽器裡就能設；掃描會略過 NAS 的回收筒；沒權限時會講清楚，不再說成「資料夾不存在」。

🐢 舊電腦、低階 NAS、在外面連回家，都更順了

• 第一次打開瀏覽頁快很多，走 VPN 連回家差別最明顯。
• 封面捲到哪才載到哪，眼前那幾張出來得更快。
• 掃描時 App 不會再卡住。

🏆 新頁面：片庫分析

側欄多一個頒獎台圖示，把片庫畫成圖：歷年片數、片商分布、女優 Top 20 等。點年份、女優、片商就能縮到那個範圍再看。

✨ 其他新功能

• 你收藏的女優名字後面會顯示 (28y)：她拍這部片時幾歲。
• 燈箱 ⚙ 重新刮削可以勾「保留目前標題」，翻譯過的片名不會被蓋掉；NFO 片名格式也可以自訂。
• 女優資料來源 minnano 已失效，改用 xcity，已收藏的資料不受影響。
• 有在用 AI 助理（Claude Code、Cursor 等）的話，現在可以叫它幫你整理女優資料：它會比對各來源、自己上網查證，再把生日、身高、照片這些一次補好。寫入前都會先問你。
• 掃描頁「缺 NFO：25 部」這類數字點得開，看得到是哪幾部、能一鍵複製。

🐛 修復

• caribbeancom 的女優被寫成「ログイン」（issue #193）；已寫錯的片請按 ⚙「進階重新刮削」。
• Jellyfin／Emby／Kodi 用的唯讀片，補資料後封面不再配不到。

已知限制

• Synology 版是 beta，只能手動安裝更新；32 位元機種（如 DS218j）不支援。
• 安裝時自動授權片庫這個功能，目前只在單一儲存空間的 DS918+ 上測過；有多個儲存空間或接 USB 硬碟的機器還沒驗證。
• 新收藏的女優，「事務所」和「標籤」會是空的。

English

One-line install

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

💡 Prefer not to open PowerShell? Grab OpenAver-Windows-Setup.bat from the Assets below and double-click it. 🗄️ Synology users: grab OpenAver-v0.16.13-Synology-beta.spk from the Assets below — see the install guide.

This is the whole v0.16 series.

🗄️ Runs on your Synology NAS now (beta)

• Install it manually from DSM's Package Center. Works on 64-bit models like the DS218 and DS918+ (DSM 7.0 or later).
• During install, pick the shared folder that holds your videos as your "Library". OpenAver gets read/write access to it automatically and adds it to your scan list, so it's ready to scan as soon as it's installed — no trip to Control Panel. You can add other folders too, but you'll have to grant access to those yourself in Control Panel (the install guide walks you through it).
• Once installed, open the address shown on the Settings page in any browser — your phone, tablet or another computer.
• You can now set the LAN password right from the browser; scans skip the NAS recycle bin; and when OpenAver can't read a folder because of permissions, it says so instead of claiming the folder doesn't exist.

🐢 Smoother on older PCs, low-end NAS boxes, and when you're away from home

• Browse opens much faster the first time — most noticeable when you connect back home over a VPN.
• Covers load as you scroll, so the ones you're looking at show up sooner.
• The app no longer freezes while scanning.

🏆 New page: Library Insights

A new podium icon in the sidebar turns your library into charts: titles per year, studio breakdown, your top 20 actresses and more. Click a year, an actress or a studio to zoom the whole page into just that.

✨ Other new features

• Actresses you've favorited now show an age after their name, like (28y) — how old she was when that title came out.
• ⚙ Advanced Re-scrape in the lightbox has a "Keep current title" option, so titles you translated or edited aren't overwritten. You can also customize how titles are written into NFO

v0.15.16

🐛 修復

• 片庫放在網路共用資料夾最上層時整理全數失敗 (#180), is_fs_path_under_dir() 的 commonpath 比對遇到 bare UNC share root（\\server\share / 對映成 O:\）拋 ValueError 後 fail-closed；改為 resolve 後前綴比對，.. 逃逸與前綴碰撞仍照擋
• 一鍵補完對只缺封面的片空轉 (#190), 缺失判定只認 8 個文字欄位、不含封面，連外站都不會查一次；順帶把批次成功判準對齊成「NFO／封面／欄位／劇照任一」
• 搜尋頁「整理」寫出的 NFO 缺簡介與評分, _summary / _rating 在四個搜尋 API 回應中被剝除，而整理端點優先採用前端送回的那份；strip 機制整支移除（7 個呼叫點）。來源本身要有才寫得出來——簡介來自 DMM／jav321／HEYZO／D2Pass／FC2(javten)，評分再加 javdb／JavLibrary／FC2 官方，JavBus 與 avsox 兩欄都不提供
• 整理在檔案搬移後才崩潰, NFO 寫入口對評分／片長／標籤容器的非預期型別一律收斂為空值，不再出現「畫面說失敗、檔案已搬走」
• 定時整理對殘缺番號模糊搜尋後搬錯資料夾, 改為單片精確查詢，查不到則原地不動

♻️ 變更

• AI 以檔案路徑整理改用單一來源整包, 與搜尋頁「整理」／定時整理一致，不再跨站合併欄位；AI 自行聚合多來源後整包送進來的那條路不變，補完／重刮指定 source 也不受影響，無 UI 入口

v0.15.16 (English)

🐛 Fixes

• Organizing fails entirely when the library sits at a network share root (#180), is_fs_path_under_dir()'s commonpath check raised ValueError on a bare UNC share root and fail-closed; replaced with a resolved-path prefix comparison, .. escapes and prefix collisions still rejected
• "Enrich all" no-ops on cover-only files (#190), the missing-field check only looked at 8 text fields and ignored covers, so no source was ever queried; batch success is now "NFO, cover, fields, or stills — any one"
• NFOs written by Search-page "Organize" lost plot and rating, _summary / _rating were stripped from four search API responses while the organize endpoint prefers the frontend payload; the strip mechanism is gone (7 call sites). The source must still provide them — plot from DMM / jav321 / HEYZO / D2Pass / FC2 (javten), rating from those plus javdb / JavLibrary / FC2 official; JavBus and avsox provide neither
• Organizing crashed after the file had already been moved, the NFO writer now coerces unexpected types in rating / duration / tag containers to empty values
• Scheduled Organize moved files into the wrong folder after a fuzzy match on a partial ID, now falls back to an exact single-title lookup and leaves the file untouched

♻️ Changed

• AI organize-by-path now takes one source whole, consistent with Search-page "Organize" and Scheduled Organize, no cross-site field merging; unchanged when the AI composes its own multi-source result and passes it in, and enrich / re-scrape with an explicit source is unaffected; no UI entry point

English version below ↓

一行安裝

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

💡 不想開 PowerShell 的 Windows 用戶：到下方 Assets 下載 OpenAver-Windows-Setup.bat，雙擊跑完同一套安裝。安裝畫面現在會跟著你的系統語言走（繁中／簡中／日文／英文）。

v0.15 系列。

🔍 資料抓得更準、更多

• javdb 重寫：改走 javdb 官方 App 用的資料通道。過去「被 javdb 擋下來」和「安裝路徑含中日韓文字」兩種會讓 javdb 完全沒結果的情況，現在大多查得到；封面不再有中央的半透明浮水印；片長、導演、發行商、系列、劇照五個欄位補齊。（輸入番號的搜尋走這條；關鍵字搜尋維持網頁路徑。）
• DMM 番號對照更準：DMM 的番號對照表改成隨版本附上，離線對帳全中。過去那張表是每台電腦自己邊用邊學的，換電腦歸零，而且學錯時完全無聲，會把別部片的標題和女優寫進你的 NFO。現在不再用本機那份。DMM 的連線也改成尊重你的系統代理設定（它過去是八個來源裡唯一硬性繞過的）。
• 番號不會再被改壞：手打或檔名裡的 n0762、200GANA-3360、FC2PPV-4943690 過去都會被改到查不到，現在原樣保留；前面帶數字的番號（200GANA-3360、T28-103）過去被當成女優名去搜，現在走精準搜尋；FC2 番號掃描入庫時統一成 FC2-<數字>，跟搜尋結果對得上。查無結果時多一顆「使用番號進階搜尋」逃生口。

🤖 AI 助理當你的多來源聚合器

• 過去 AI 助理只能叫 OpenAver「去某個站重抓」，站方給什麼就是什麼。現在它可以看完 8 個來源的結果之後，自己組一份：封面用 DMM 的、片名和資訊用 javdb 的、片名再翻成中文，一次交回來，OpenAver 直接寫進 NFO 和收藏庫。這就是 MDCX 那種「多來源聚合」，差別是由 AI 來判斷哪個欄位該用誰的。
• 四道保護：番號對不上就擋（不會把別部片蓋上來）；純文字修改預設不動封面（已對好的焦點、放好的劇照不重生）；AI 沒帶的簡介／評分沿用既有 NFO 不清空；內部欄位不給冒充。
• 用法跟以前一樣：Claude Code、Cursor 等 AI 工具讀一次 /api/capabilities 就會。畫面上沒有對應按鈕，沒在用 AI 助理的人這一版零差別。

🔖 書籤：想看但還沒入手的片，先收起來

• 搜尋結果卡右上角現在是「播放／加入書籤／移除書籤」三選一；搜尋框左邊多了「搜尋結果 ／ 書籤」切換，帶計數。
• 書籤有自己的牆和大圖，方向鍵、滾輪、手機滑動都能換片。封面在加入的當下就存到本機，原站掛了也不破圖。
• 入手之後自己消失：掃描完成或補完後，已經進片庫的書籤自動移除，側欄通知列出番號。片庫已有的片按「加入書籤」不會重複加。
• 書籤牆與大圖的動效補到跟搜尋牆同一個水準：移除時其餘卡片滑動補位（不再瞬間重排）、加入時封面飛向左上角的書籤鈕。
• 書籤卡會提示「N 天前加入」，放太久會轉琥珀色。

⏱ 定時整理：沒人在場也會自己整理

• 搜尋頁「我的最愛」旁多一顆**「定時整理」**開關。開著之後每 12 小時自動對最愛資料夾跑一輪「查資料 → 整理」，整理好的片直接進片庫；想馬上跑按「立刻執行一次」，結果看側欄通知。
• 你按「我的最愛」的那一刻，背景那一輪做完手上那一部就停下來讓位。
• 查不到、已重複的片會被記住，24 小時／7 天內不再每次重問 8 個來源，清單上直接標「查無結果」或「重複」。
• 側欄通知關掉 App、重開機之後還在，上限 10 → 50 則。

🧭 第一次打開更好懂

• 新手引導第 3 步改成在「產生網頁」按鈕正下方直接畫一張等一下真的會出現的卡片，並明講已經用其他工具整理過的片直接匯入、不重刮。第 1 步順帶說明資料夾可以直接拖進視窗。
• 搜尋頁空狀態一行講一顆按鈕，最後一行用你當下的命名設定即時算出檔名範例，告訴你按「整理」之後檔案會變成什麼樣。最愛資料夾不在掃描清單裡時會先用琥珀色字提醒你「整理後不會進瀏覽頁」。
• 安裝程式跟著系統語言走：Windows 一鍵安裝與 macOS 一行安裝都有繁中／簡中／日文／英文；Windows 安裝視窗不再被滑鼠點一下就凍住。
• 0.15 系列新增的介面文字，簡中／日文／英文本版全部補齊。

🎬 瀏覽頁與唯讀來源

• 封面↔海報一鍵切換：右上角四選一下拉換成一顆直切按鈕；表格／清單改為預設不顯示，要的話到「設定 → 列表顯示預設」打開。切換動畫真的播得出來了（過去是凍一秒、閃兩次）。側欄「瀏覽」那顆永遠在轉的指示燈也改成進場轉一圈就停——燈箱開著時捲動順很多。
• 從別的頁面回到瀏覽頁不再重傳整個片庫，沒變動就幾乎瞬間；帶著女優大卡切回來也不再整牆閃一下。
• 女優大卡展開資訊時不再空一大塊：補上年齡／身高／罩杯／三圍一行，再用標籤／出身地／事務所把剩下的空間填掉（純顯示不可點）。女優牆與影片牆互切時，畫面也不再跳到最底。
• 連不到的位置會說：片庫放 NAS 或外接碟，連不到時底部狀態列直接寫出是哪一個，封面牆一次畫完、不再一批一批等逾時。
• 唯讀來源跟一般掃描走同一條線：掃到的每個影片檔一律留卡（過去認不出番號又刮不到的片會整部消失，連重刮入口都沒有）；自訂標籤改寫在輸出夾，來源資料夾零寫入；重刮不再沖掉標籤。
• 五個頁面的左邊緣對到同一條線，切頁時內容不再左右跳；平板不再同時出現側欄與手機頂欄。

🐛 修復

• 掃描頁「一鍵補完」對檔名就是番號的片，標題不再永遠停在番號（issue #182；升級前就已經寫壞的片，請到瀏覽頁按 ⚙「進階重新刮削」）。
• 女優換圖：wiki 來源那張候選圖點了不再「抓取失敗」。拖資料夾中途拖出視窗外放開，覆蓋層不再卡住整頁。女優大卡的對焦裁切拖了存了會真的生效。整理搬檔改為原子佔位，排程與手動撞到同一個目標檔名時保證恰好一邊成功。
• 搜尋頁燈箱與兩頁的劇照集補上鍵盤焦點鎖：按 Tab 不會再跑到背景看不見的元素上。

已知限制

• DMM：番號前綴含數字的片（3DSVR-1774、34ID-017）主路徑仍查不到，請用進階搜尋打完整 cid（如 13dsvr01774）。javdb 新路徑只適用輸入番號的搜尋。
• 定時整理：App 沒開就不會跑；「立刻執行一次」沒有進度條，結果看側欄通知；最愛資料夾請指向下載器「已完成」的資料夾，指到下載中的資料夾，寫到一半的檔可能被當成寫完了搬走。
• 書籤：0.15.7 之前掃描入庫的 FC2 影片，書籤可能不會自動移除（重新掃描一次即可）。
• 唯讀來源：升級前就已經入庫的唯讀片不會自己變好，要按 ⚙ 重刮。
• 連不到的位置：手機／窄螢幕看不到那句話；App 開著才拔碟最長 10 分鐘後才顯示；映射磁碟機／SMB 掛載斷線偵測不到。
• 瀏覽頁：升級後停在表格／清單的人會被收斂回封面格。

English

One-line install

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

💡 Prefer not to open PowerShell? Grab OpenAver-Windows-Setup.bat from the Assets below and double-click it — same installer. The installer now follows your system language (Traditional Chinese / Simplified Chinese / Japanese / English).

This is the whole v0.15 series.

🔍 Better, more complete scraping

• javdb rewritten: OpenAver now talks to the same data channel javdb's own app u