【免費下載鏈接】CrossWatchSynchronize your data across media servers, media agents and trackers. Keep your movies and shows in sync, no matter where you watch.項目地址https://gitcode.com/gh_mirrors/cr/CrossWatch點擊查看免費下載當你的媒體同時存在于 Plex、Jellyfin、Emby 等多臺服務器時CrossWatch 路徑匹配Path Matching提供了 ID 之外的第二重保險只要兩邊文件路徑的尾部結構一致CrossWatch 就能把它們識別為同一部影片或同一集劇集從而讓觀影歷史、評分和播放進度照常同步。本文面向新手完整講解這項功能何時該開、如何匹配、以及哪些情況會匹配失敗。為什么 ID 匹配不夠用不同媒體服務器會為同一部電影分配各自不同的內部 ID即使使用外部 IDIMDb、TMDB 等也常常出現(xiàn)一邊有、一邊缺的情況。CrossWatch 的常規(guī)流程是優(yōu)先用 ID 匹配Strict ID matching 開啟時只會用 IDID 無法解析時才輪到本文的主角——按文件路徑兜底匹配。典型場景你把Alien (1979)從 Linux NAS 遷移到 Windows 媒體服務器兩邊路徑完全不同盤符和分隔符但只要尾部目錄結構一致就能對上/mnt/media/movies/Alien (1979)/Alien.mkv D:\Movies\Alien (1979)\Alien.mkv官方說明文檔見 docs/path-matching.md。如何開啟“Match by file path”該選項位于配對Pair配置中默認關閉打開對應 pair →General → Matching→ 勾選Match by file path開啟前請先確認你的組合是否受支持支持情況說明? 支持Plex、Jellyfin、Emby 兩兩配對含同一服務器的不同實例? 不支持Kodi 目前暫不支持此選項勾選后該選項對雙向 pair 的兩個方向同時生效且與 Strict ID matching 可以疊加——它會允許路徑兜底但不會開啟按標題搜索匹配邏輯依然是保守的。UI 開關實現(xiàn)位于 assets/js/modals/pair-config/index.js。路徑匹配到底怎么“對”核心邏輯在 cw_platform/path_matching.py 中規(guī)則可以概括為電影比較路徑的最后 2 段影片文件夾 文件名劇集比較最后 3 段 季數(shù) 集數(shù)文件夾/劇集文件夾/文件名 SxxExx分隔符\與/和大小寫會先做歸一化所以 Linux 和 Windows 路徑可以互認帶顯式分集編號的多部分電影Part 1 / Part 2會被區(qū)分開不會互相混淆整個過程不讀取文件內容純粹做字符串索引比對匹配成功的日志會記錄為path_matchreason 文案為 “Matched by file path”并附帶resolution_methodfile_path方便你在事件日志中確認它確實走了路徑兜底。標簽定義見 cw_platform/reason_labels.py同步側對接邏輯見 providers/sync/_path_matching.py。支持什么、不支持什么數(shù)據(jù)類別是否支持 電影 / 劇集觀看歷史?? 評分? 播放進度Playback Progress? 追劇列表Watchlist、播放列表、收藏集? Trakt、SIMKL 等 Tracker 服務?也就是說路徑匹配是媒體服務器之間的兜底手段不會延伸到 Tracker 或列表類數(shù)據(jù)上。追劇列表頁面例如哪些情況會匹配失敗CrossWatch 要求恰好命中一個目標條目否則寧缺毋濫實現(xiàn)見 cw_platform/path_matching.py 的PathIndex.resolve日志 reason含義path_not_found目標庫里沒有路徑尾部一致的條目path_ambiguous命中了多個條目路徑重復為避免同步錯數(shù)據(jù)而跳過path_id_conflict路徑雖然一致但外部 ID 互相沖突同樣跳過另外還有三種“天然對不上”的情況兩邊文件名不同比如一個叫Alien.mkv另一個叫Alien.1979.1080p.mkv尾部文件夾結構不同多套了一層目錄或改名劇集季集編號不同一邊 S01E01另一邊用別的編號體系這些被跳過的條目都會寫入日志便于你針對性地手動修正命名。性能影響與目錄緩存需要開啟前知道的一點路徑兜底可能需要完整讀取目標庫的元數(shù)據(jù)目錄包括未觀看的條目大庫首次同步會明顯變慢。為此 CrossWatch 把目錄緩存在本地 SQLite 中并在同一服務器、同一憑據(jù)、同一選庫范圍的 pair 和特性之間復用避免反復全量拉取目錄超過24 小時或檢測到服務器端內容變更信號 → 整體刷新服務器無法提供可信的變更信號時 → 緩存有效期縮短為5 分鐘單個適配器內的檢查結果最多緩存90 秒7 天未被使用的目錄會被自動清理緩存策略的測試覆蓋見 tests/test_path_catalog_cache.py匹配規(guī)則本身的單測見 tests/test_path_matching.py。另外在Maintenance → Retry provider items中還可以主動清空已保存的路徑目錄緩存并重建。小結 一句話總結ID 優(yōu)先、路徑兜底、嚴格到寧可跳過。如果你的 pair 是 Plex/Jellyfin/Emby 組合、且兩邊目錄命名習慣一致那么打開 General → Matching 下的Match by file path就能在 ID 缺失時自動救回大量本會丟失的歷史、評分和進度同步。記得開啟后觀察一次事件日志確認path_match按預期出現(xiàn)即可。贊分享【免費下載鏈接】CrossWatchSynchronize your data across media servers, media agents and trackers. Keep your movies and shows in sync, no matter where you watch.項目地址https://gitcode.com/gh_mirrors/cr/CrossWatch點擊查看免費下載相關推薦如何快速掌握 path-to-regexp多段路徑參數(shù)匹配終極指南如何快速掌握 path to regexp多段路徑參數(shù)匹配終極指南 path to regexp 是一個功能強大的 JavaScript 庫能夠將路徑字符串后端YTSage 下載指南從粘貼鏈接到批量保存3 步搞定 YouTube 視頻下載YTSage 下載指南從粘貼鏈接到批量保存3 步搞定 YouTube 視頻下載 想保存一個 YouTube 視頻卻被滿屏的命令行參數(shù)勸退其實下載工具不一桌面應用音視頻DeerFlow 文件上傳路徑系統(tǒng)path、virtual_path 與 artifact_url 三類路徑全解析DeerFlow 文件上傳路徑系統(tǒng)path、virtual_path 與 artifact_url 三類路徑全解析 DeerFlow 的文件上傳系統(tǒng)會為每個上人工智能大模型AI AgentAgent 框架多智能體Agent 沙箱Agent 記憶MCP 服務后端前端上一篇如何用Nuklear打造高性能跨平臺GUI單文件ANSI C庫的終極指南下一篇BentoML Codespaces在云端 GPU 上用本地 IDE 開發(fā) AI 應用附 bentoml code 全流程解析創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 CrossWatch 路徑匹配（Path Matching）詳解：ID 對不上時，文件路徑如何救場
【免費下載鏈接】CrossWatchSynchronize your data across media servers, media agents and trackers. Keep your movies and shows in sync, no matter where you watch.項目地址https://gitcode.com/gh_mirrors/cr/CrossWatch點擊查看免費下載當你的媒體同時存在于 Plex、Jellyfin、Emby 等多臺服務器時CrossWatch 路徑匹配Path Matching提供了 ID 之外的第二重保險只要兩邊文件路徑的尾部結構一致CrossWatch 就能把它們識別為同一部影片或同一集劇集從而讓觀影歷史、評分和播放進度照常同步。本文面向新手完整講解這項功能何時該開、如何匹配、以及哪些情況會匹配失敗。為什么 ID 匹配不夠用不同媒體服務器會為同一部電影分配各自不同的內部 ID即使使用外部 IDIMDb、TMDB 等也常常出現(xiàn)一邊有、一邊缺的情況。CrossWatch 的常規(guī)流程是優(yōu)先用 ID 匹配Strict ID matching 開啟時只會用 IDID 無法解析時才輪到本文的主角——按文件路徑兜底匹配。典型場景你把Alien (1979)從 Linux NAS 遷移到 Windows 媒體服務器兩邊路徑完全不同盤符和分隔符但只要尾部目錄結構一致就能對上/mnt/media/movies/Alien (1979)/Alien.mkv D:\Movies\Alien (1979)\Alien.mkv官方說明文檔見 docs/path-matching.md。如何開啟“Match by file path”該選項位于配對Pair配置中默認關閉打開對應 pair →General → Matching→ 勾選Match by file path開啟前請先確認你的組合是否受支持支持情況說明? 支持Plex、Jellyfin、Emby 兩兩配對含同一服務器的不同實例? 不支持Kodi 目前暫不支持此選項勾選后該選項對雙向 pair 的兩個方向同時生效且與 Strict ID matching 可以疊加——它會允許路徑兜底但不會開啟按標題搜索匹配邏輯依然是保守的。UI 開關實現(xiàn)位于 assets/js/modals/pair-config/index.js。路徑匹配到底怎么“對”核心邏輯在 cw_platform/path_matching.py 中規(guī)則可以概括為電影比較路徑的最后 2 段影片文件夾 文件名劇集比較最后 3 段 季數(shù) 集數(shù)文件夾/劇集文件夾/文件名 SxxExx分隔符\與/和大小寫會先做歸一化所以 Linux 和 Windows 路徑可以互認帶顯式分集編號的多部分電影Part 1 / Part 2會被區(qū)分開不會互相混淆整個過程不讀取文件內容純粹做字符串索引比對匹配成功的日志會記錄為path_matchreason 文案為 “Matched by file path”并附帶resolution_methodfile_path方便你在事件日志中確認它確實走了路徑兜底。標簽定義見 cw_platform/reason_labels.py同步側對接邏輯見 providers/sync/_path_matching.py。支持什么、不支持什么數(shù)據(jù)類別是否支持 電影 / 劇集觀看歷史?? 評分? 播放進度Playback Progress? 追劇列表Watchlist、播放列表、收藏集? Trakt、SIMKL 等 Tracker 服務?也就是說路徑匹配是媒體服務器之間的兜底手段不會延伸到 Tracker 或列表類數(shù)據(jù)上。追劇列表頁面例如哪些情況會匹配失敗CrossWatch 要求恰好命中一個目標條目否則寧缺毋濫實現(xiàn)見 cw_platform/path_matching.py 的PathIndex.resolve日志 reason含義path_not_found目標庫里沒有路徑尾部一致的條目path_ambiguous命中了多個條目路徑重復為避免同步錯數(shù)據(jù)而跳過path_id_conflict路徑雖然一致但外部 ID 互相沖突同樣跳過另外還有三種“天然對不上”的情況兩邊文件名不同比如一個叫Alien.mkv另一個叫Alien.1979.1080p.mkv尾部文件夾結構不同多套了一層目錄或改名劇集季集編號不同一邊 S01E01另一邊用別的編號體系這些被跳過的條目都會寫入日志便于你針對性地手動修正命名。性能影響與目錄緩存需要開啟前知道的一點路徑兜底可能需要完整讀取目標庫的元數(shù)據(jù)目錄包括未觀看的條目大庫首次同步會明顯變慢。為此 CrossWatch 把目錄緩存在本地 SQLite 中并在同一服務器、同一憑據(jù)、同一選庫范圍的 pair 和特性之間復用避免反復全量拉取目錄超過24 小時或檢測到服務器端內容變更信號 → 整體刷新服務器無法提供可信的變更信號時 → 緩存有效期縮短為5 分鐘單個適配器內的檢查結果最多緩存90 秒7 天未被使用的目錄會被自動清理緩存策略的測試覆蓋見 tests/test_path_catalog_cache.py匹配規(guī)則本身的單測見 tests/test_path_matching.py。另外在Maintenance → Retry provider items中還可以主動清空已保存的路徑目錄緩存并重建。小結 一句話總結ID 優(yōu)先、路徑兜底、嚴格到寧可跳過。如果你的 pair 是 Plex/Jellyfin/Emby 組合、且兩邊目錄命名習慣一致那么打開 General → Matching 下的Match by file path就能在 ID 缺失時自動救回大量本會丟失的歷史、評分和進度同步。記得開啟后觀察一次事件日志確認path_match按預期出現(xiàn)即可。贊分享【免費下載鏈接】CrossWatchSynchronize your data across media servers, media agents and trackers. Keep your movies and shows in sync, no matter where you watch.項目地址https://gitcode.com/gh_mirrors/cr/CrossWatch點擊查看免費下載相關推薦如何快速掌握 path-to-regexp多段路徑參數(shù)匹配終極指南如何快速掌握 path to regexp多段路徑參數(shù)匹配終極指南 path to regexp 是一個功能強大的 JavaScript 庫能夠將路徑字符串后端YTSage 下載指南從粘貼鏈接到批量保存3 步搞定 YouTube 視頻下載YTSage 下載指南從粘貼鏈接到批量保存3 步搞定 YouTube 視頻下載 想保存一個 YouTube 視頻卻被滿屏的命令行參數(shù)勸退其實下載工具不一桌面應用音視頻DeerFlow 文件上傳路徑系統(tǒng)path、virtual_path 與 artifact_url 三類路徑全解析DeerFlow 文件上傳路徑系統(tǒng)path、virtual_path 與 artifact_url 三類路徑全解析 DeerFlow 的文件上傳系統(tǒng)會為每個上人工智能大模型AI AgentAgent 框架多智能體Agent 沙箱Agent 記憶MCP 服務后端前端上一篇如何用Nuklear打造高性能跨平臺GUI單文件ANSI C庫的終極指南下一篇BentoML Codespaces在云端 GPU 上用本地 IDE 開發(fā) AI 應用附 bentoml code 全流程解析創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考