javdict 1.3.3 → 1.3.5

package/README.md

@@ -9,15 +9,15 @@ English | [中文](README_zh.md) | [日本語](README_jp.md) | [한국어](READM
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20Windows%20%7C%20macOS-lightgrey.svg)]()
 
-Type a title ID, get back the full details — cast, release date, studio, duration, tags, and more. Multiple data sources are queried automatically with no manual switching required.
+Type a title ID, get back the full details — cast, release date, studio, duration, tags, and more. Multiple data sources are queried automatically by default, and you can optionally force a single source.
 
-![JavDict-Demo](https://raw.githubusercontent.com/gdjdkid/AvDict/master/Javdict-Demo.gif)
+![JavDict-Demo-en](https://raw.githubusercontent.com/gdjdkid/AvDict/master/assets/Javdict-Demo-en.gif)
 
 ---
 
 ## Features
 
-- 🔍 **Multi-source fallback** — Queries JAVBUS → NJAV → JavLibrary → JAVDB in order; returns on first hit
+- 🔍 **Multi-source fallback** — By default it queries JAVBUS → NJAV → JavLibrary → JAVDB in order and returns on first hit; you can also force a single source manually
 - 📋 **Rich metadata** — Cast, release date, duration, studio, label, director, series, tags, cover image, rating
 - 💾 **Local cache** — Results cached for 7 days to reduce repeat requests
 - 🖥️ **Cross-platform** — Linux, Windows, and macOS supported
@@ -108,6 +108,13 @@ jav -l en SSIS-001       # shorthand
 jav -r SSIS-001
 ```
 
+**Force a specific data source:**
+
+```bash
+jav --source javbus SSIS-001
+jav -s njav SSIS-001
+```
+
 **Clear local cache:**
 
 ```bash
@@ -139,6 +146,7 @@ Arguments:
 Options:
   -v, --version         Print version number
   -l, --lang <lang>     Output language: zh/en/jp/kr/de (default: zh)
+  -s, --source <source> Select source: auto/javbus/njav/javlibrary/javdb (default: auto)
   -r, --raw             Output raw JSON instead of formatted display
   --setup               Configure JAVDB Cookie (optional, improves coverage)
   --clear-cache         Clear local result cache

package/README_de.md

@@ -9,15 +9,15 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20Windows%20%7C%20macOS-lightgrey.svg)]()
 
-Gib eine Titel-ID ein und erhalte sofort vollständige Informationen — Besetzung, Erscheinungsdatum, Studio, Laufzeit, Tags und mehr. Mehrere Datenquellen werden automatisch abgefragt, ohne manuelles Umschalten.
+Gib eine Titel-ID ein und erhalte sofort vollständige Informationen — Besetzung, Erscheinungsdatum, Studio, Laufzeit, Tags und mehr. Mehrere Datenquellen werden standardmäßig automatisch abgefragt, bei Bedarf kannst du aber auch eine einzelne Quelle erzwingen.
 
-![JavDict-Demo](https://raw.githubusercontent.com/gdjdkid/AvDict/master/Javdict-Demo.gif)
+![JavDict-Demo-de](https://raw.githubusercontent.com/gdjdkid/AvDict/master/assets/Javdict-Demo-de.gif)
 
 ---
 
 ## Funktionen
 
-- 🔍 **Automatisches Multi-Source-Fallback** — Fragt JAVBUS → NJAV → JavLibrary → JAVDB der Reihe nach ab und gibt beim ersten Treffer zurück
+- 🔍 **Automatisches Multi-Source-Fallback** — Fragt standardmäßig JAVBUS → NJAV → JavLibrary → JAVDB der Reihe nach ab und gibt beim ersten Treffer zurück; bei Bedarf kannst du auch eine einzelne Quelle erzwingen
 - 📋 **Umfangreiche Metadaten** — Besetzung, Erscheinungsdatum, Laufzeit, Studio, Label, Regisseur, Serie, Tags, Cover-Bild, Bewertung
 - 💾 **Lokaler Cache** — Ergebnisse werden 7 Tage lang gecacht, um wiederholte Anfragen zu reduzieren
 - 🖥️ **Plattformübergreifend** — Linux, Windows und macOS werden unterstützt
@@ -110,6 +110,13 @@ jav -l de SSIS-001       # Kurzform
 jav -r SSIS-001
 ```
 
+**Eine bestimmte Datenquelle erzwingen：**
+
+```bash
+jav --source javbus SSIS-001
+jav -s njav SSIS-001
+```
+
 **Lokalen Cache leeren：**
 
 ```bash
@@ -141,6 +148,7 @@ Arguments:
 Options:
   -v, --version         Versionsnummer ausgeben
   -l, --lang <Sprache>  Ausgabesprache: zh/en/jp/kr/de (Standard: zh)
+  -s, --source <source> Datenquelle wählen: auto/javbus/njav/javlibrary/javdb (Standard: auto)
   -r, --raw             Ausgabe als rohes JSON
   --setup               JAVDB Cookie konfigurieren（optional, verbessert Abdeckung）
   --clear-cache         Lokalen Cache leeren

package/README_jp.md

@@ -9,15 +9,15 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20Windows%20%7C%20macOS-lightgrey.svg)]()
 
-番号を入力するだけで、出演者・発売日・メーカー・収録時間・タグなどの詳細情報を取得できます。複数のデータソースを自動的に切り替えて検索します。
+番号を入力するだけで、出演者・発売日・メーカー・収録時間・タグなどの詳細情報を取得できます。複数のデータソースを既定で自動フォールバックし、必要に応じて単一ソースを手動指定できます。
 
-![JavDict-Demo](https://raw.githubusercontent.com/gdjdkid/AvDict/master/Javdict-Demo.gif)
+![JavDict-Demo-jp](https://raw.githubusercontent.com/gdjdkid/AvDict/master/assets/Javdict-Demo-jp.gif)
 
 ---
 
 ## 特徴
 
-- 🔍 **複数データソース自動フォールバック** — JAVBUS → NJAV → JavLibrary → JAVDB の順に検索、最初にヒットした結果を返す
+- 🔍 **複数データソース自動フォールバック** — 既定では JAVBUS → NJAV → JavLibrary → JAVDB の順に検索して最初のヒットを返し、必要に応じて単一ソースを手動指定できます
 - 📋 **豊富な情報** — 女優、男優、発売日、収録時間、メーカー、レーベル、監督、シリーズ、タグ、パッケージ画像、評価
 - 💾 **ローカルキャッシュ** — 検索結果を7日間キャッシュし、重複リクエストを削減
 - 🖥️ **クロスプラットフォーム** — Linux、Windows、macOS 対応
@@ -110,6 +110,13 @@ jav -l ja SSIS-001       # 省略形
 jav -r SSIS-001
 ```
 
+**データソースを手動指定：**
+
+```bash
+jav --source javbus SSIS-001
+jav -s njav SSIS-001
+```
+
 **キャッシュを削除：**
 
 ```bash
@@ -141,6 +148,7 @@ Arguments:
 Options:
   -v, --version         バージョンを表示
   -l, --lang <言語>     出力言語：zh/en/jp/kr/de（デフォルト：zh）
+  -s, --source <source> データソースを指定：auto/javbus/njav/javlibrary/javdb（デフォルト：auto）
   -r, --raw             生の JSON 形式で出力
   --setup               JAVDB Cookie を設定（任意、カバレッジ向上）
   --clear-cache         ローカルキャッシュを削除

package/README_kr.md

@@ -9,15 +9,15 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20Windows%20%7C%20macOS-lightgrey.svg)]()
 
-번호를 입력하면 출연진, 발매일, 제작사, 재생 시간, 태그 등 상세 정보를 바로 확인할 수 있습니다. 여러 데이터 소스를 자동으로 전환하며 검색합니다.
+번호를 입력하면 출연진, 발매일, 제작사, 재생 시간, 태그 등 상세 정보를 바로 확인할 수 있습니다. 기본값으로 여러 데이터 소스를 자동 폴백하며, 필요하면 단일 소스를 직접 지정할 수 있습니다.
 
-![JavDict-Demo](https://raw.githubusercontent.com/gdjdkid/AvDict/master/Javdict-Demo.gif)
+![JavDict-Demo-kr](https://raw.githubusercontent.com/gdjdkid/AvDict/master/assets/Javdict-Demo-kr.gif)
 
 ---
 
 ## 주요 기능
 
-- 🔍 **다중 소스 자동 폴백** — JAVBUS → NJAV → JavLibrary → JAVDB 순서로 검색, 첫 번째 결과 반환
+- 🔍 **다중 소스 자동 폴백** — 기본값으로 JAVBUS → NJAV → JavLibrary → JAVDB 순서로 검색해 첫 결과를 반환하며, 필요하면 단일 소스를 직접 지정할 수 있습니다
 - 📋 **풍부한 정보** — 여배우, 남배우, 발매일, 재생 시간, 제작사, 레이블, 감독, 시리즈, 태그, 커버 이미지, 평점
 - 💾 **로컬 캐시** — 검색 결과를 7일간 캐시하여 중복 요청 감소
 - 🖥️ **크로스 플랫폼** — Linux, Windows, macOS 지원
@@ -110,6 +110,13 @@ jav -l ko SSIS-001       # 축약형
 jav -r SSIS-001
 ```
 
+**데이터 소스 직접 지정：**
+
+```bash
+jav --source javbus SSIS-001
+jav -s njav SSIS-001
+```
+
 **로컬 캐시 삭제：**
 
 ```bash
@@ -141,6 +148,7 @@ Arguments:
 Options:
   -v, --version         버전 출력
   -l, --lang <언어>     출력 언어: zh/en/jp/kr/de (기본값: zh)
+  -s, --source <source> 데이터 소스 지정: auto/javbus/njav/javlibrary/javdb (기본값: auto)
   -r, --raw             원시 JSON 형식으로 출력
   --setup               JAVDB Cookie 설정（선택, 커버리지 향상）
   --clear-cache         로컬 캐시 삭제

package/README_zh.md

@@ -9,15 +9,15 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20Windows%20%7C%20macOS-lightgrey.svg)]()
 
-输入一个车牌号，即可获取女优、发售日期、制作商、时长、类别等完整信息。支持多数据源自动兜底，无需手动切换。
+输入一个车牌号，即可获取女优、发售日期、制作商、时长、类别等完整信息。默认启用多数据源自动兜底，也支持手动指定单一数据源。
 
-![JavDict-Demo](https://raw.githubusercontent.com/gdjdkid/AvDict/master/Javdict-Demo.gif)
+![JavDict-Demo-zh](https://raw.githubusercontent.com/gdjdkid/AvDict/master/assets/Javdict-Demo-zh.gif)
 
 ---
 
 ## 功能特点
 
-- 🔍 **多数据源自动兜底** — 依次查询 JAVBUS → NJAV → JavLibrary → JAVDB，任意一个命中即返回
+- 🔍 **多数据源自动兜底** — 默认依次查询 JAVBUS → NJAV → JavLibrary → JAVDB，任意一个命中即返回，也可手动指定单一数据源
 - 📋 **信息完整** — 女优、男优、发售日期、时长、制作商、发行商、导演、系列、类别、封面、评分
 - 💾 **本地缓存** — 查询结果缓存 7 天，减少重复请求
 - 🖥️ **跨平台** — 支持 Linux、Windows、macOS
@@ -110,6 +110,13 @@ jav -l en SSIS-001       # 缩写
 jav -r SSIS-001
 ```
 
+**手动指定数据源：**
+
+```bash
+jav --source javbus SSIS-001
+jav -s njav SSIS-001
+```
+
 **清空本地缓存：**
 
 ```bash
@@ -141,6 +148,7 @@ Arguments:
 Options:
   -v, --version         显示版本号
   -l, --lang <语言>      输出语言：zh/en/jp/kr/de（默认：zh）
+  -s, --source <source> 指定数据源：auto/javbus/njav/javlibrary/javdb（默认：auto）
   -r, --raw             以原始 JSON 格式输出结果
   --setup               配置 JAVDB Cookie（可选，提高覆盖率）
   --clear-cache         清空本地缓存

package/index.js

@@ -3,7 +3,7 @@
 import { createInterface } from 'readline';
 import { program } from 'commander';
 import { createRequire } from 'module';
-import { search } from './lib/fetcher.js';
+import { search, SUPPORTED_SOURCES } from './lib/fetcher.js';
 import { display } from './lib/display.js';
 import { clearCache, setConfig } from './lib/cache.js';
 import ora from 'ora';
@@ -22,9 +22,11 @@ program
     .option('--clear-cache', '清空本地缓存')
     .option('--setup', '配置JAVDB Cookie（可选，提高查询覆盖率）')
     .option('-l, --lang <lang>', '显示语言 zh/en/jp/kr/de', 'zh')
+    .option('-s, --source <source>', '指定数据源 auto/javbus/njav/javlibrary/javdb', 'auto')
     .action(async (id, options) => {
 
         const lang = options.lang || 'zh';
+        const source = (options.source || 'auto').toLowerCase();
         const t = getLang(lang);   // 统一获取语言包
 
         if (options.setup) {
@@ -68,10 +70,16 @@ program
             process.exit(0);
         }
 
+        if (!SUPPORTED_SOURCES.includes(source)) {
+            console.error(`\n${t.invalidSource}: ${source}`);
+            console.error(`${t.availableSources}: ${SUPPORTED_SOURCES.join(', ')}`);
+            process.exit(1);
+        }
+
         const spinner = ora(`${t.searching} ${id.toUpperCase()} ...`).start();
 
         try {
-            const result = await search(id.toUpperCase(), lang);
+            const result = await search(id.toUpperCase(), lang, source);
             spinner.stop();
 
             if (!result) {
@@ -91,4 +99,4 @@ program
         }
     });
 
-program.parse();
+program.parse();

package/lib/cache.js

@@ -10,6 +10,11 @@ const CACHE_FILE = join(CACHE_DIR, 'cache.json');
 // 缓存有效期：7 天（单位毫秒）
 const TTL = 7 * 24 * 60 * 60 * 1000;
 
+function getCacheKey(id, source = 'auto') {
+    const normalizedSource = (source || 'auto').toLowerCase();
+    return normalizedSource === 'auto' ? id : `${normalizedSource}:${id}`;
+}
+
 function loadCache() {
     if (!existsSync(CACHE_FILE)) return {};
     try {
@@ -26,9 +31,9 @@ function saveCache(data) {
     writeFileSync(CACHE_FILE, JSON.stringify(data, null, 2), 'utf-8');
 }
 
-export function getCache(id) {
+export function getCache(id, source = 'auto') {
     const cache = loadCache();
-    const entry = cache[id];
+    const entry = cache[getCacheKey(id, source)];
     if (!entry) return null;
 
     const isExpired = Date.now() - entry.cachedAt > TTL;
@@ -37,9 +42,9 @@ export function getCache(id) {
     return entry.data;
 }
 
-export function setCache(id, data) {
+export function setCache(id, data, source = 'auto') {
     const cache = loadCache();
-    cache[id] = {
+    cache[getCacheKey(id, source)] = {
         cachedAt: Date.now(),
         data,
     };
@@ -79,4 +84,4 @@ export function setConfig(data) {
     }
     const configFile = join(CACHE_DIR, 'config.json');
     writeFileSync(configFile, JSON.stringify(data, null, 2), 'utf-8');
-}
+}

package/lib/fetcher.js

@@ -4,6 +4,8 @@ import { getCache, setCache, getConfig } from './cache.js';
 import chalk from 'chalk';
 import {getLang} from "./i18n.js";
 
+export const SUPPORTED_SOURCES = ['auto', 'javbus', 'njav', 'javlibrary', 'javdb'];
+
 // ─── 通用请求函数（JAVBUS / JavLibrary 使用）────────────
 function fetchHtml(url, cookie = '') {
     const cookieHeader = cookie ? `-H "Cookie: ${cookie}"` : '';
@@ -323,9 +325,31 @@ function parseJavdb(html, queryId) {
     return result.title ? result : null;
 }
 
-// ─── 主入口：依次尝试数据源 ─────────────────────────
-export async function search(id, lang = 'zh') {
+const SOURCE_HANDLERS = {
+    javbus: searchJavbus,
+    njav: searchNjav,
+    javlibrary: searchJavlibrary,
+    javdb: searchJavdb,
+};
+
+function getSearchPipeline(source = 'auto') {
+    const normalizedSource = (source || 'auto').toLowerCase();
+    if (normalizedSource === 'auto') {
+        return ['javbus', 'njav', 'javlibrary', 'javdb'];
+    }
+
+    return SOURCE_HANDLERS[normalizedSource] ? [normalizedSource] : [];
+}
+
+// ─── 主入口：默认自动兜底，手动指定时仅查询单一数据源 ─────────
+export async function search(id, lang = 'zh', source = 'auto') {
     const t = getLang(lang);
+    const normalizedSource = (source || 'auto').toLowerCase();
+    const searchPipeline = getSearchPipeline(normalizedSource);
+
+    if (!searchPipeline.length) {
+        throw new Error(`Unsupported source: ${source}`);
+    }
 
     // FC2 格式识别：031926-100 → 031926_100
     let searchId = id;
@@ -334,29 +358,19 @@ export async function search(id, lang = 'zh') {
         console.log(chalk.gray(`  ${t.fc2Detected}: ${id} → ${searchId}`));
     }
 
-    const cached = getCache(id);
+    const cached = getCache(id, normalizedSource);
     if (cached) return cached;
 
-    const MAX_RETRY = 3;
+    const MAX_RETRY = normalizedSource === 'auto' ? 3 : 1;
 
     for (let attempt = 1; attempt <= MAX_RETRY; attempt++) {
-        let result = null;
-
-        // 第一优先：JAVBUS（最快，直接番号拼URL）
-        result = searchJavbus(searchId);
-        if (result) { setCache(id, result); return result; }
-
-        // 第二优先：NJAV（无需Cookie，覆盖率高，能查到JUR等小众番号）
-        result = searchNjav(searchId);
-        if (result) { setCache(id, result); return result; }
-
-        // 第三优先：JavLibrary（补充数据）
-        result = searchJavlibrary(searchId);
-        if (result) { setCache(id, result); return result; }
-
-        // 第四优先：JAVDB（需要Cookie，仅Linux）
-        result = await searchJavdb(searchId);
-        if (result) { setCache(id, result); return result; }
+        for (const sourceName of searchPipeline) {
+            const result = await SOURCE_HANDLERS[sourceName](searchId);
+            if (result) {
+                setCache(id, result, normalizedSource);
+                return result;
+            }
+        }
 
         if (attempt < MAX_RETRY) {
             await new Promise(resolve => setTimeout(resolve, 2000));
@@ -364,4 +378,4 @@ export async function search(id, lang = 'zh') {
     }
 
     return null;
-}
+}

package/lib/i18n.js

@@ -16,6 +16,8 @@ export const messages = {
         searching: '正在查询',
         notFound: '未找到番号',
         queryFailed: '查询失败',
+        invalidSource: '不支持的数据源',
+        availableSources: '可选数据源',
         cacheCleared: '缓存已清空',
         cacheClearFailed: '清空缓存失败',
         cachePath: '缓存路径',
@@ -50,6 +52,8 @@ export const messages = {
         searching: 'Searching',
         notFound: 'Title not found',
         queryFailed: 'Query failed',
+        invalidSource: 'Unsupported data source',
+        availableSources: 'Available sources',
         cacheCleared: 'Cache cleared',
         cacheClearFailed: 'Failed to clear cache',
         cachePath: 'Cache path',
@@ -84,6 +88,8 @@ export const messages = {
         searching: '検索中',
         notFound: '番号が見つかりません',
         queryFailed: '検索失敗',
+        invalidSource: 'サポートされていないデータソース',
+        availableSources: '利用可能なデータソース',
         cacheCleared: 'キャッシュを削除しました',
         cacheClearFailed: 'キャッシュの削除に失敗しました',
         cachePath: 'キャッシュパス',
@@ -118,6 +124,8 @@ export const messages = {
         searching: '검색 중',
         notFound: '번호를 찾을 수 없습니다',
         queryFailed: '검색 실패',
+        invalidSource: '지원되지 않는 데이터 소스',
+        availableSources: '사용 가능한 데이터 소스',
         cacheCleared: '캐시가 삭제되었습니다',
         cacheClearFailed: '캐시 삭제 실패',
         cachePath: '캐시 경로',
@@ -152,6 +160,8 @@ export const messages = {
         searching: 'Suche läuft',
         notFound: 'Titel nicht gefunden',
         queryFailed: 'Suche fehlgeschlagen',
+        invalidSource: 'Nicht unterstützte Datenquelle',
+        availableSources: 'Verfügbare Datenquellen',
         cacheCleared: 'Cache geleert',
         cacheClearFailed: 'Cache konnte nicht geleert werden',
         cachePath: 'Cache-Pfad',
@@ -173,4 +183,4 @@ export const messages = {
 
 export function getLang(lang) {
     return messages[lang] || messages.zh; // 默认中文
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "javdict",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "AV番号命令行查询工具",
   "main": "./index.js",
   "type": "module",

package/test/cache.test.js

@@ -69,6 +69,19 @@ describe('cache.js', () => {
         expect(getCache('IPX-001')).toEqual(dataB);
     });
 
+    it('setCache：自动模式和手动指定数据源的缓存彼此隔离', async () => {
+        const { getCache, setCache } = await importCache();
+        const autoData = { id: 'SSIS-001', source: 'NJAV', title: '自动兜底结果' };
+        const manualData = { id: 'SSIS-001', source: 'JAVBUS', title: '手动指定结果' };
+
+        setCache('SSIS-001', autoData);
+        setCache('SSIS-001', manualData, 'javbus');
+
+        expect(getCache('SSIS-001')).toEqual(autoData);
+        expect(getCache('SSIS-001', 'javbus')).toEqual(manualData);
+        expect(getCache('SSIS-001', 'njav')).toBeNull();
+    });
+
     it('clearCache：清空后所有缓存消失', async () => {
         const { getCache, setCache, clearCache } = await importCache();
         setCache('SSIS-001', { id: 'SSIS-001' });
@@ -79,4 +92,4 @@ describe('cache.js', () => {
         expect(getCache('SSIS-001')).toBeNull();
         expect(getCache('IPX-001')).toBeNull();
     });
-});
+});

package/test/fetcher.test.js

@@ -43,6 +43,7 @@ vi.mock('../lib/cache.js', () => ({
 }));
 
 import { execSync } from 'child_process';
+import { getCache, setCache } from '../lib/cache.js';
 import { search } from '../lib/fetcher.js';
 
 // 模拟 HTML 数据
@@ -80,9 +81,32 @@ const MOCK_404_HTML = `
 </html>
 `;
 
+const MOCK_NJAV_HTML = `
+<html>
+  <head><title>SSIS-001 - NJAV</title></head>
+  <body>
+    <script type="application/ld+json">
+      {
+        "name": "SSIS-001 NJAV 标题",
+        "uploadDate": "2021-02-03T00:00:00Z",
+        "duration": "PT2H05M06S",
+        "actor": [{ "name": "女优B" }],
+        "genre": ["人妻", "剧情"],
+        "partOfSeries": { "name": "系列B" }
+      }
+    </script>
+    <div class="detail-item">
+      <div><span>片商</span><span>Studio B</span></div>
+      <div><span>導演</span><span>导演B</span></div>
+    </div>
+  </body>
+</html>
+`;
+
 describe('fetcher.js', () => {
     beforeEach(() => {
         vi.clearAllMocks();
+        getCache.mockReturnValue(null);
     });
 
     it('search：正常番号能返回结构完整的对象', async () => {
@@ -96,22 +120,64 @@ describe('fetcher.js', () => {
         expect(result.actresses).toContain('天使もえ');
         expect(result.releaseDate).toBe('2021-01-01');
         expect(result.studio).toBe('SOD Create');
+        expect(getCache).toHaveBeenCalledWith('SSIS-001', 'auto');
+        expect(setCache).toHaveBeenCalledWith('SSIS-001', expect.objectContaining({ source: 'JAVBUS' }), 'auto');
     });
 
-    it('search：搜索结果为空时返回 null', async () => {
-        execSync.mockReturnValue(Buffer.from(MOCK_404_HTML));
+    it('search：默认模式会按顺序自动兜底到下一个数据源', async () => {
+        execSync.mockImplementation((command) => {
+            if (command.includes('https://www.javbus.com/SSIS-001')) {
+                return Buffer.from(MOCK_404_HTML);
+            }
 
-        const result = await search('INVALID-999');
-        expect(result).toBeNull();
-    });
+            if (command.includes('https://www.njav.com/zh/xvideos/ssis-001')) {
+                return Buffer.from(MOCK_NJAV_HTML);
+            }
 
-    it('search：网络请求失败时返回 null', async () => {
-        execSync.mockImplementation(() => {
-            throw new Error('Network Error');
+            throw new Error(`Unexpected command: ${command}`);
         });
 
         const result = await search('SSIS-001');
+
+        expect(result).not.toBeNull();
+        expect(result.source).toBe('NJAV');
+        expect(result.title).toBe('SSIS-001 NJAV 标题');
+        expect(result.studio).toBe('Studio B');
+        expect(execSync).toHaveBeenCalledTimes(2);
+        expect(setCache).toHaveBeenCalledWith('SSIS-001', expect.objectContaining({ source: 'NJAV' }), 'auto');
+    });
+
+    it('search：手动指定数据源时只查询该数据源', async () => {
+        execSync.mockImplementation((command) => {
+            if (command.includes('https://www.javbus.com/SSIS-001')) {
+                return Buffer.from(MOCK_JAVBUS_HTML);
+            }
+
+            throw new Error(`Unexpected command: ${command}`);
+        });
+
+        const result = await search('SSIS-001', 'zh', 'javbus');
+
+        expect(result).not.toBeNull();
+        expect(result.source).toBe('JAVBUS');
+        expect(execSync).toHaveBeenCalledTimes(1);
+        expect(getCache).toHaveBeenCalledWith('SSIS-001', 'javbus');
+        expect(setCache).toHaveBeenCalledWith('SSIS-001', expect.objectContaining({ source: 'JAVBUS' }), 'javbus');
+    });
+
+    it('search：手动指定数据源未命中时不会回退到其他数据源', async () => {
+        execSync.mockImplementation((command) => {
+            if (command.includes('https://www.javlibrary.com/cn/vl_searchbyid.php?keyword=SSIS-001')) {
+                return Buffer.from('<html><body>empty</body></html>');
+            }
+
+            throw new Error(`Unexpected command: ${command}`);
+        });
+
+        const result = await search('SSIS-001', 'zh', 'javlibrary');
+
         expect(result).toBeNull();
+        expect(execSync).toHaveBeenCalledTimes(1);
     });
 
     it('search：返回对象包含所有预期字段', async () => {
@@ -128,4 +194,4 @@ describe('fetcher.js', () => {
             expect(result).toHaveProperty(field);
         });
     });
-});
+});