javdict 1.2.2

package/.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_24" project-jdk-name="21" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+</project>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/AvDict.iml" filepath="$PROJECT_DIR$/AvDict.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

package/AvDict.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="GENERAL_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/README.md

@@ -0,0 +1,242 @@
+# AvDict 🎬
+
+> 一个命令行查询 AV 车牌号详细信息的工具
+
+[![npm version](https://img.shields.io/badge/version-1.2.1-blue.svg)](https://github.com/gdjdkid/AvDict)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)](https://nodejs.org)
+[![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)]()
+
+输入一个车牌号，即可获取女优、发售日期、制作商、时长、类别等完整信息。支持多数据源自动兜底，无需手动切换。
+
+![示例](https://raw.githubusercontent.com/gdjdkid/AvDict/master/example.gif)
+
+---
+
+## 功能特点
+
+- 🔍 **多数据源自动兜底** — 依次查询 JAVBUS → NJAV → JavLibrary → JAVDB，任意一个命中即返回
+- 📋 **信息完整** — 女优、男优、发售日期、时长、制作商、发行商、导演、系列、类别、封面、评分
+- 💾 **本地缓存** — 查询结果缓存 7 天，减少重复请求
+- 🖥️ **跨平台** — 支持 Linux、Windows、macOS
+- 🎨 **彩色输出** — 终端美化显示，字段分色，清晰易读
+- ⚡ **查询快速** — 直接番号拼 URL，无需登录即可使用
+
+---
+
+## 系统要求
+
+- Node.js >= 18.0.0
+- npm >= 6.0.0
+- curl（Linux/macOS 系统自带；Windows 请确认 Git Bash 环境下可用）
+
+---
+
+## 支持的平台
+
+| 平台 | JAVBUS | NJAV | JavLibrary | JAVDB |
+|------|--------|------|------------|-------|
+| Linux / macOS | ✅ | ✅ | ✅ | ✅ |
+| Windows | ✅ | ✅ | ✅ | ❌ |
+
+> JAVDB 在 Windows 上因 Cloudflare TLS 指纹限制无法使用，其他三个数据源在 Windows 上完全正常。
+
+---
+
+## 安装方法
+
+**方式一：通过 npm 安装（推荐）**
+```bash
+npm install -g javdict
+```
+
+**方式二：从 GitHub 克隆安装（开发者）**
+```bash
+git clone https://github.com/gdjdkid/AvDict.git
+cd AvDict
+npm install
+npm install -g .
+```
+
+**验证安装成功：**
+
+```bash
+jav -v
+```
+
+---
+
+## 使用说明
+
+**查询车牌号：**
+
+```bash
+jav SSIS-001
+jav ABF-331
+jav JUR-067
+```
+
+**输出原始 JSON 数据：**
+
+```bash
+jav -r SSIS-001
+```
+
+**清空本地缓存：**
+
+```bash
+jav --clear-cache
+```
+
+**配置 JAVDB Cookie（可选）：**
+
+```bash
+jav --setup
+```
+
+**显示帮助信息：**
+
+```bash
+jav -h
+```
+
+---
+
+## 命令行选项
+
+```
+Usage: jav [options] [番号]
+
+Arguments:
+  番号                   要查询的车牌号，例如: SSIS-001
+
+Options:
+  -v, --version         显示版本号
+  -r, --raw             以原始 JSON 格式输出结果
+  --setup               配置 JAVDB Cookie（可选，提高覆盖率）
+  --clear-cache         清空本地缓存
+  -h, --help            显示帮助信息
+```
+
+---
+
+## 自定义设置
+
+### JAVDB Cookie 配置（可选）
+
+不配置也可以正常使用，配置后可提高部分冷门番号的查询覆盖率（仅 Linux/macOS 生效）。
+
+**获取步骤：**
+
+1. 用 Chrome 打开 [https://javdb.com](https://javdb.com) 并登录账号
+2. 安装 Chrome 插件 [Get cookies.txt LOCALLY](https://chrome.google.com/webstore/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)
+3. 在 JAVDB 页面点击插件图标，导出 Cookie 文件
+4. 找到 `_jdb_session` 那一行，复制最后一列的值
+5. 运行以下命令并粘贴：
+
+```bash
+jav --setup
+```
+
+Cookie 配置保存在本地 `~/.config/javinfo/config.json`，不会上传到任何地方。
+
+**Cookie 有效期约 2 周**，过期后重新运行 `jav --setup` 更新即可。
+
+---
+
+## 缓存说明
+
+查询结果自动缓存到 `~/.config/javinfo/cache.json`，有效期 7 天。缓存可以：
+
+- 加快重复查询速度
+- 减少对数据源网站的请求压力
+
+如需强制刷新数据，运行：
+
+```bash
+jav --clear-cache
+```
+
+---
+
+## 常见问题
+
+**Q: 查询失败提示 `未找到番号`？**
+
+A: 可能原因有三个：
+1. 该番号在所有数据源均未收录（极小众内容）
+2. JAVDB Cookie 已过期，运行 `jav --setup` 重新配置
+3. 网络无法访问数据源，请检查代理设置
+
+**Q: Windows 上部分番号查不到？**
+
+A: Windows 上 JAVDB 数据源因 Cloudflare 限制无法使用，少数仅收录于 JAVDB 的番号在 Windows 上无法查询。建议在 Linux 环境（如树莓派）下使用以获得最完整的查询结果。
+
+**Q: 提示 `Permission denied`？**
+
+A: 全局安装时需要管理员权限：
+```bash
+sudo npm install -g .
+```
+
+**Q: Cookie 多久需要更新一次？**
+
+A: 通常 2 周左右，当出现冷门番号突然查不到时，运行 `jav --setup` 更新即可。
+
+**Q: 支持 FC2 素人番号吗？**
+
+A: 支持，输入格式为 `031926-100`（连字符格式），工具会自动识别并转换格式查询。
+
+---
+
+## 数据来源
+
+| 数据源 | 网站 | 特点 |
+|--------|------|------|
+| JAVBUS | [javbus.com](https://www.javbus.com) | 速度快，数据丰富 |
+| NJAV | [njav.com](https://www.njav.com) | 覆盖率高，无需 Cookie |
+| JavLibrary | [javlibrary.com](https://www.javlibrary.com) | 数据完整，评分信息 |
+| JAVDB | [javdb.com](https://javdb.com) | 数据最全，需要 Cookie |
+
+---
+
+## 开源协议
+
+本项目基于 [MIT License](LICENSE) 开源，你可以自由使用、修改和分发。
+
+---
+
+## 如何贡献代码
+
+欢迎提交 PR 或 Issue！
+
+1. Fork 这个仓库
+2. 创建你的功能分支：`git checkout -b feat/your-feature`
+3. 提交改动：`git commit -m "feat: 描述你的改动"`
+4. 推送分支：`git push origin feat/your-feature`
+5. 提交 Pull Request
+
+**Commit 规范：**
+- `feat:` 新增功能
+- `fix:` 修复 bug
+- `docs:` 修改文档
+- `chore:` 杂项维护
+
+---
+
+## 请作者喝一杯咖啡 ☕
+
+如果这个工具对你有帮助，欢迎打赏支持：
+
+| 微信支付 | 支付宝 |
+|---------|--------|
+| *(二维码)* | *(二维码)* |
+
+---
+
+## 更新日志
+
+- **v1.2.1** — 修复代码细节，稳定性优化
+- **v1.2.0** — 新增 NJAV 第四数据源，调整数据源优先级
+- **v1.1.x** — 三数据源兜底，JAVDB Cookie 改为可选配置，跨平台兼容优化
+- **v1.0.0** — 初始版本发布

package/README_en.md

@@ -0,0 +1,239 @@
+# AvDict 🎬
+
+> A command-line tool to look up JAV metadata by title ID — cast, release date, studio, and more
+
+[![npm version](https://img.shields.io/badge/version-1.2.1-blue.svg)](https://github.com/gdjdkid/AvDict)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)](https://nodejs.org)
+[![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.
+
+![Example](https://raw.githubusercontent.com/gdjdkid/AvDict/master/example.gif)
+
+---
+
+## Features
+
+- 🔍 **Multi-source fallback** — Queries JAVBUS → NJAV → JavLibrary → JAVDB in order; returns on first hit
+- 📋 **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
+- 🎨 **Color output** — Terminal-formatted display with field-level color coding
+- ⚡ **Fast lookups** — Direct URL construction by title ID; no login required for most sources
+
+---
+
+## Requirements
+
+- Node.js >= 18.0.0
+- npm >= 6.0.0
+- curl (built into Linux/macOS; ensure it's available in your Git Bash environment on Windows)
+
+---
+
+## Platform Support
+
+| Platform | JAVBUS | NJAV | JavLibrary | JAVDB |
+|----------|--------|------|------------|-------|
+| Linux / macOS | ✅ | ✅ | ✅ | ✅ |
+| Windows | ✅ | ✅ | ✅ | ❌ |
+
+> JAVDB is unavailable on Windows due to Cloudflare TLS fingerprint restrictions. The other three sources work fully on Windows.
+
+---
+
+## Installation
+
+**Option 1: Install via npm (recommended)**
+```bash
+npm install -g javdict
+```
+
+**Option 2: Clone from GitHub (for developers)**
+```bash
+git clone https://github.com/gdjdkid/AvDict.git
+cd AvDict
+npm install
+npm install -g .
+```
+
+**Verify the installation:**
+
+```bash
+jav -v
+```
+
+---
+
+## Usage
+
+**Look up a title ID:**
+
+```bash
+jav SSIS-001
+jav ABF-331
+jav JUR-067
+```
+
+**Output raw JSON:**
+
+```bash
+jav -r SSIS-001
+```
+
+**Clear local cache:**
+
+```bash
+jav --clear-cache
+```
+
+**Configure JAVDB Cookie (optional):**
+
+```bash
+jav --setup
+```
+
+**Show help:**
+
+```bash
+jav -h
+```
+
+---
+
+## CLI Options
+
+```
+Usage: jav [options] [id]
+
+Arguments:
+  id                    Title ID to look up, e.g. SSIS-001
+
+Options:
+  -v, --version         Print version number
+  -r, --raw             Output raw JSON instead of formatted display
+  --setup               Configure JAVDB Cookie (optional, improves coverage)
+  --clear-cache         Clear local result cache
+  -h, --help            Show help
+```
+
+---
+
+## Configuration
+
+### JAVDB Cookie (optional)
+
+The tool works without any configuration. Adding a JAVDB Cookie improves coverage for niche titles that only exist in JAVDB's database. This only takes effect on Linux/macOS.
+
+**How to get your Cookie:**
+
+1. Open [https://javdb.com](https://javdb.com) in Chrome and sign in
+2. Install the Chrome extension [Get cookies.txt LOCALLY](https://chrome.google.com/webstore/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)
+3. Click the extension icon on the JAVDB page and export your cookies
+4. Find the `_jdb_session` row and copy the value in the last column
+5. Run the setup command and paste it in:
+
+```bash
+jav --setup
+```
+
+Your Cookie is saved locally at `~/.config/javinfo/config.json` and never sent anywhere.
+
+**Cookies typically expire in about 2 weeks.** When niche titles start returning "not found", just run `jav --setup` again to refresh.
+
+---
+
+## Caching
+
+Query results are automatically cached to `~/.config/javinfo/cache.json` with a 7-day TTL. This speeds up repeat lookups and reduces load on the source sites.
+
+To force a fresh fetch:
+
+```bash
+jav --clear-cache
+```
+
+---
+
+## FAQ
+
+**Q: I get "title not found" — what's wrong?**
+
+A: There are three likely causes:
+1. The title isn't indexed by any of the four sources (extremely niche content)
+2. Your JAVDB Cookie has expired — run `jav --setup` to refresh it
+3. Your network can't reach the source sites — check your proxy settings
+
+**Q: Some titles don't show up on Windows?**
+
+A: JAVDB is unavailable on Windows due to Cloudflare restrictions. A small number of titles that only exist in JAVDB can't be found on Windows. For full coverage, use a Linux environment (e.g. a Raspberry Pi).
+
+**Q: I get `Permission denied` when installing?**
+
+A: Global installation requires elevated permissions:
+```bash
+sudo npm install -g .
+```
+
+**Q: How often do I need to update my Cookie?**
+
+A: Roughly every 2 weeks. If niche titles that previously worked start returning "not found", your Cookie has likely expired — run `jav --setup` to update it.
+
+**Q: Does it support FC2 amateur titles?**
+
+A: Yes. Enter the title in hyphen format, e.g. `031926-100`. The tool auto-detects FC2 format and handles the conversion internally.
+
+---
+
+## Data Sources
+
+| Source | Website | Notes |
+|--------|---------|-------|
+| JAVBUS | [javbus.com](https://www.javbus.com) | Fast, broad coverage |
+| NJAV | [njav.com](https://www.njav.com) | High coverage, no Cookie needed |
+| JavLibrary | [javlibrary.com](https://www.javlibrary.com) | Detailed metadata, includes ratings |
+| JAVDB | [javdb.com](https://javdb.com) | Most comprehensive, requires Cookie |
+
+---
+
+## License
+
+This project is open source under the [MIT License](LICENSE). You're free to use, modify, and distribute it.
+
+---
+
+## Contributing
+
+PRs and Issues are welcome!
+
+1. Fork this repository
+2. Create your branch: `git checkout -b feat/your-feature`
+3. Commit your changes: `git commit -m "feat: describe your change"`
+4. Push the branch: `git push origin feat/your-feature`
+5. Open a Pull Request
+
+**Commit message conventions:**
+- `feat:` — new feature
+- `fix:` — bug fix
+- `docs:` — documentation update
+- `chore:` — maintenance / housekeeping
+
+---
+
+## Buy Me a Coffee ☕
+
+If this tool saves you time, consider supporting development:
+
+| WeChat Pay | Alipay |
+|------------|--------|
+| *(QR code)* | *(QR code)* |
+
+---
+
+## Changelog
+
+- **v1.2.1** — Minor fixes and stability improvements
+- **v1.2.0** — Added NJAV as fourth data source; reordered source priority
+- **v1.1.x** — Three-source fallback; JAVDB Cookie made optional; cross-platform compatibility fixes
+- **v1.0.0** — Initial release

package/index.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+
+import { createInterface } from 'readline';
+import { program } from 'commander';
+import { createRequire } from 'module';
+import { search } from './lib/fetcher.js';
+import { display } from './lib/display.js';
+import { clearCache, setConfig } from './lib/cache.js';
+import ora from 'ora';
+import chalk from 'chalk';
+
+const require = createRequire(import.meta.url);
+const pkg = require('./package.json');
+
+program
+    .name('jav')
+    .description('AV番号命令行查询工具')
+    .version(pkg.version, '-v, --version')
+    .argument('[番号]', '要查询的番号，例如: SSIS-001')
+    .option('-r, --raw', '显示原始详细数据')
+    .option('--clear-cache', '清空本地缓存')
+    .option('--setup', '配置JAVDB Cookie（可选，提高查询覆盖率）')
+    .action(async (id, options) => {
+
+        if (options.setup) {
+            console.log('');
+            console.log(chalk.yellow('=== 配置 JAVDB Cookie（可选）==='));
+            console.log('');
+            console.log('不配置也可以正常使用，配置后覆盖率更高。');
+            console.log('');
+            console.log('获取步骤：');
+            console.log('  1. Chrome 打开 https://javdb.com 并登录账号');
+            console.log('  2. 安装插件 "Get cookies.txt LOCALLY"');
+            console.log('  3. 导出 Cookie 文件，找到 _jdb_session 那行');
+            console.log('  4. 复制最后一列的值粘贴到下面');
+            console.log('');
+
+            const rl = createInterface({ input: process.stdin, output: process.stdout });
+            await new Promise((resolve) => {
+                rl.question(chalk.cyan('请粘贴 _jdb_session 的值（直接回车跳过）: '), (session) => {
+                    rl.close();
+                    if (!session.trim()) {
+                        console.log(chalk.gray('\n已跳过，使用 JAVBUS + JavLibrary 作为数据源。'));
+                    } else {
+                        setConfig({ session: session.trim() });
+                        console.log(chalk.green('\n✅ 配置保存成功！'));
+                        console.log(chalk.gray('保存位置: ~/.config/javinfo/config.json'));
+                    }
+                    console.log('');
+                    resolve();
+                });
+            });
+            process.exit(0);
+        }
+
+        if (options.clearCache) {
+            clearCache();
+            process.exit(0);
+        }
+
+        if (!id) {
+            program.help();
+            process.exit(0);
+        }
+
+        const spinner = ora(`正在查询 ${id.toUpperCase()} ...`).start();
+
+        try {
+            const result = await search(id.toUpperCase());
+            spinner.stop();
+
+            if (!result) {
+                console.log(chalk.red(`\n未找到番号: ${id.toUpperCase()}`));
+                process.exit(1);
+            }
+
+            display(result, options.raw);
+        } catch (err) {
+            spinner.stop();
+            console.error('\n查询失败:', err.message);
+            process.exit(1);
+        }
+    });
+
+program.parse();

package/lib/cache.js

@@ -0,0 +1,73 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+// 缓存文件存放在用户主目录下，和 yddict 的做法一致
+const CACHE_DIR = join(homedir(), '.config', 'javinfo');
+const CACHE_FILE = join(CACHE_DIR, 'cache.json');
+
+// 缓存有效期：7 天（单位毫秒）
+const TTL = 7 * 24 * 60 * 60 * 1000;
+
+function loadCache() {
+    if (!existsSync(CACHE_FILE)) return {};
+    try {
+        return JSON.parse(readFileSync(CACHE_FILE, 'utf-8'));
+    } catch {
+        // 文件损坏就当缓存不存在
+        return {};
+    }
+}
+
+function saveCache(data) {
+    if (!existsSync(CACHE_DIR)) {
+        mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    writeFileSync(CACHE_FILE, JSON.stringify(data, null, 2), 'utf-8');
+}
+
+export function getCache(id) {
+    const cache = loadCache();
+    const entry = cache[id];
+    if (!entry) return null;
+
+    // 检查是否过期
+    const isExpired = Date.now() - entry.cachedAt > TTL;
+    if (isExpired) return null;
+
+    return entry.data;
+}
+
+export function setCache(id, data) {
+    const cache = loadCache();
+    cache[id] = {
+        cachedAt: Date.now(),
+        data,
+    };
+    saveCache(cache);
+}
+
+export function clearCache() {
+    if (existsSync(CACHE_FILE)) {
+        writeFileSync(CACHE_FILE, '{}', 'utf-8');
+        console.log('缓存已清空');
+    }
+}
+
+export function getConfig() {
+    const configFile = join(CACHE_DIR, 'config.json');
+    if (!existsSync(configFile)) return {};
+    try {
+        return JSON.parse(readFileSync(configFile, 'utf-8'));
+    } catch {
+        return {};
+    }
+}
+
+export function setConfig(data) {
+    if (!existsSync(CACHE_DIR)) {
+        mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    const configFile = join(CACHE_DIR, 'config.json');
+    writeFileSync(configFile, JSON.stringify(data, null, 2), 'utf-8');
+}

package/lib/display.js

@@ -0,0 +1,57 @@
+import chalk from 'chalk';
+
+const DIVIDER = chalk.gray('─'.repeat(60));
+
+function row(label, value, color = chalk.white) {
+    if (!value || (Array.isArray(value) && value.length === 0)) return;
+    const paddedLabel = chalk.cyan(label.padEnd(8, '　')); // 用全角空格对齐中文
+    console.log(`  ${paddedLabel}  ${color(value)}`);
+}
+
+export function display(info, raw = false) {
+    if (raw) {
+        console.log(JSON.stringify(info, null, 2));
+        return;
+    }
+
+    console.log('');
+    console.log(DIVIDER);
+    console.log(
+        '  ' +
+        chalk.bold.yellow('🎬  ') +
+        chalk.bold.white(info.id) +
+        (info.score ? chalk.yellow(`  ⭐ ${info.score}`) : '')
+    );
+
+    if (info.title) {
+        console.log('  ' + chalk.gray(info.title));
+    }
+
+    console.log(DIVIDER);
+
+    row('女优', info.actresses.join(' / '), chalk.magenta);
+    row('男优', info.actors.join(' / '), chalk.blue);
+    row('发售日期', info.releaseDate, chalk.green);
+    row('时长', info.duration);
+    row('制作商', info.studio, chalk.yellow);
+    row('发行商', info.label);
+    row('导演', info.director);
+    row('系列', info.series);
+
+    if (info.tags.length > 0) {
+        const tagStr = info.tags.map(t => chalk.bgGray(` ${t} `)).join(' ');
+        console.log('  ' + chalk.cyan('类别　　') + '  ' + tagStr);
+    }
+
+    if (info.coverUrl) {
+        console.log('');
+        console.log('  ' + chalk.cyan('封面　　') + '  ' + chalk.underline.gray(info.coverUrl));
+    }
+
+    if (info.source) {
+        console.log('  ' + chalk.gray(`数据来源: ${info.source}`));
+    }
+
+    console.log(DIVIDER);
+    console.log('');
+}

package/lib/fetcher.js

@@ -0,0 +1,367 @@
+import { execSync } from 'child_process';
+import * as cheerio from 'cheerio';
+import { getCache, setCache, getConfig } from './cache.js';
+import chalk from 'chalk';
+
+// ─── 通用请求函数（JAVBUS / JavLibrary 使用）────────────
+function fetchHtml(url, cookie = '') {
+    const cookieHeader = cookie ? `-H "Cookie: ${cookie}"` : '';
+    const result = execSync(
+        `curl -sL "${url}" \
+      -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" \
+      -H "Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8" \
+      -H "Accept-Language: zh-CN,zh;q=0.9,en;q=0.8" \
+      ${cookieHeader}`,
+        { timeout: 15000, maxBuffer: 1024 * 1024 * 10 }
+    );
+    return result.toString();
+}
+
+// ─── 数据源一：JAVBUS ────────────────────────────────────
+function searchJavbus(id) {
+    try {
+        const url = `https://www.javbus.com/${id}`;
+        const html = fetchHtml(url);
+        const $ = cheerio.load(html);
+
+        if ($('title').text().includes('404') || !$('.container .row').length) {
+            return null;
+        }
+
+        const result = {
+            id,
+            source: 'JAVBUS',
+            title: $('h3').first().text().trim(),
+            actresses: [],
+            actors: [],
+            releaseDate: '',
+            duration: '',
+            studio: '',
+            label: '',
+            director: '',
+            series: '',
+            tags: [],
+            coverUrl: $('.screencap img').attr('src') || '',
+            score: '',
+        };
+
+        $('.info p').each((_, el) => {
+            const text = $(el).text().trim();
+            const label = $(el).find('span.header').text().trim();
+            if (/發行日期|发行日期/.test(label)) {
+                result.releaseDate = text.replace(label, '').trim();
+            } else if (/長度|长度/.test(label)) {
+                result.duration = text.replace(label, '').trim();
+            } else if (/導演|导演/.test(label)) {
+                result.director = $(el).find('a').text().trim();
+            } else if (/製作商|制作商/.test(label)) {
+                result.studio = $(el).find('a').text().trim();
+            } else if (/發行商|发行商/.test(label)) {
+                result.label = $(el).find('a').text().trim();
+            } else if (/系列/.test(label)) {
+                result.series = $(el).find('a').text().trim();
+            }
+        });
+
+        $('span.genre a').each((_, el) => {
+            const tag = $(el).text().trim();
+            if (tag) result.tags.push(tag);
+        });
+
+        $('.star-name a').each((_, el) => {
+            const name = $(el).text().trim();
+            if (name) result.actresses.push(name);
+        });
+
+        return result.title ? result : null;
+    } catch {
+        return null;
+    }
+}
+
+// ─── 数据源二：JavLibrary ────────────────────────────────
+function searchJavlibrary(id) {
+    try {
+        const searchUrl = `https://www.javlibrary.com/cn/vl_searchbyid.php?keyword=${encodeURIComponent(id)}`;
+        const searchHtml = fetchHtml(searchUrl);
+        const $ = cheerio.load(searchHtml);
+
+        let detailHtml = searchHtml;
+        const firstResult = $('.videos .video a').first();
+        if (firstResult.length) {
+            const detailPath = firstResult.attr('href');
+            detailHtml = fetchHtml(`https://www.javlibrary.com/cn/${detailPath}`);
+        }
+
+        const $d = cheerio.load(detailHtml);
+        if (!$d('#video_id .text').length) return null;
+
+        const foundId = $d('#video_id .text').text().trim().toUpperCase();
+        if (foundId !== id.toUpperCase()) return null;
+
+        const result = {
+            id,
+            source: 'JavLibrary',
+            title: $d('#video_title h3').text().trim(),
+            actresses: [],
+            actors: [],
+            releaseDate: $d('#video_date .text').text().trim(),
+            duration: $d('#video_length .text').text().trim(),
+            studio: $d('#video_maker .text a').text().trim(),
+            label: $d('#video_label .text a').text().trim(),
+            director: $d('#video_director .text a').text().trim(),
+            series: $d('#video_series .text a').text().trim(),
+            tags: [],
+            coverUrl: $d('#video_jacket_img').attr('src') || '',
+            score: $d('#video_review .score').text().trim(),
+        };
+
+        $d('#video_genres .genre a').each((_, el) => {
+            const tag = $d(el).text().trim();
+            if (tag) result.tags.push(tag);
+        });
+
+        $d('#video_cast .cast .star a').each((_, el) => {
+            const name = $d(el).text().trim();
+            if (name) result.actresses.push(name);
+        });
+
+        return result.title ? result : null;
+    } catch {
+        return null;
+    }
+}
+
+// ─── 数据源三：JAVDB（需要Cookie，仅Linux/Mac）──────────
+async function searchJavdb(id) {
+    try {
+        const config = getConfig();
+        if (!config.session) return null;
+
+        // Windows上Cloudflare封锁了非OpenSSL的TLS请求，跳过
+        if (process.platform === 'win32') return null;
+
+        const session = decodeURIComponent(config.session);
+        const cookie = `locale=zh; over18=1; _jdb_session=${session}`;
+
+        function fetchJavdbHtml(url) {
+            return execSync(
+                `curl -sL "${url}" \
+                  -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" \
+                  -H "Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8" \
+                  -H "Accept-Language: zh-CN,zh;q=0.9" \
+                  -H "Cookie: ${cookie}"`,
+                { timeout: 15000, maxBuffer: 1024 * 1024 * 10 }
+            ).toString();
+        }
+
+        const searchUrl = `https://javdb.com/search?q=${encodeURIComponent(id)}&f=all`;
+        const searchHtml = fetchJavdbHtml(searchUrl);
+
+        const $ = cheerio.load(searchHtml);
+        let detailPath = null;
+
+        $('.movie-list .item a.box').each((_, el) => {
+            const foundId = $(el).find('.video-title strong').text().trim().toUpperCase();
+            const normalize = s => s.replace(/[-_]/g, '');
+            if (normalize(foundId) === normalize(id.toUpperCase())) {
+                detailPath = $(el).attr('href');
+                return false;
+            }
+        });
+
+        if (!detailPath) detailPath = $('.movie-list .item a.box').first().attr('href');
+        if (!detailPath) return null;
+
+        // 详情页最多重试 3 次，每次间隔 2 秒
+        let detailHtml = '';
+        for (let i = 0; i < 3; i++) {
+            await new Promise(resolve => setTimeout(resolve, 2000));
+            detailHtml = fetchJavdbHtml(`https://javdb.com${detailPath}`);
+            if (detailHtml.length > 1000) break;
+        }
+
+        if (detailHtml.length < 1000) return null;
+        return parseJavdb(detailHtml, id);
+    } catch {
+        return null;
+    }
+}
+
+// ─── 数据源四：NJAV（无需Cookie，覆盖率高）────────────
+function searchNjav(id) {
+    try {
+        const url = `https://www.njav.com/zh/xvideos/${id.toLowerCase()}`;
+        const html = fetchHtml(url);
+        const $ = cheerio.load(html);
+
+        // 确认页面包含正确番号
+        const pageTitle = $('title').text();
+        if (!pageTitle.includes(id.toUpperCase())) return null;
+
+        const result = {
+            id,
+            source: 'NJAV',
+            title: '',
+            actresses: [],
+            actors: [],
+            releaseDate: '',
+            duration: '',
+            studio: '',
+            label: '',
+            director: '',
+            series: '',
+            tags: [],
+            coverUrl: `https://static.javcdn.vip/images/${id.toLowerCase()}/thumb_h.webp`,
+            score: '',
+        };
+
+        // 优先用 JSON-LD 解析，最稳定
+        const jsonLd = $('script[type="application/ld+json"]').text();
+        if (jsonLd) {
+            try {
+                const data = JSON.parse(jsonLd);
+                result.title = data.name || '';
+                result.releaseDate = data.uploadDate?.substring(0, 10) || '';
+                // 解析时长 PT3H22M51S → 3:22:51
+                if (data.duration) {
+                    const m = data.duration.match(/PT(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?/);
+                    if (m) {
+                        const h = m[1] || '0';
+                        const min = m[2] ? m[2].padStart(2, '0') : '00';
+                        const sec = m[3] ? m[3].padStart(2, '0') : '00';
+                        result.duration = `${h}:${min}:${sec}`;
+                    }
+                }
+                if (Array.isArray(data.actor)) {
+                    result.actresses = data.actor.map(a => a.name).filter(Boolean);
+                }
+                if (Array.isArray(data.genre)) {
+                    result.tags = data.genre;
+                }
+                if (data.partOfSeries?.name) {
+                    result.series = data.partOfSeries.name;
+                }
+            } catch {}
+        }
+
+        // 补充 HTML 里的字段（JSON-LD 没有的）
+        $('.detail-item div').each((_, el) => {
+            const label = $(el).find('span').first().text().trim();
+            const value = $(el).find('span').last().text().trim();
+            if (/片商|制作|製作|Studio|Maker/i.test(label)) {
+                result.studio = value;
+            } else if (/導演|Director/i.test(label)) {
+                result.director = value;
+            }
+        });
+
+        return result.title ? result : null;
+    } catch {
+        return null;
+    }
+}
+
+function parseJavdb(html, queryId) {
+    const $ = cheerio.load(html);
+    const result = {
+        id: queryId,
+        source: 'JAVDB',
+        title: $('strong.current-title').text().trim(),
+        actresses: [],
+        actors: [],
+        releaseDate: '',
+        duration: '',
+        studio: '',
+        label: '',
+        director: '',
+        series: '',
+        tags: [],
+        coverUrl: $('.video-cover img').attr('src') || '',
+        score: $('.score .value').first().text().trim(),
+    };
+
+    $('.movie-panel-info .panel-block').each((_, el) => {
+        const label = $(el).find('strong').first().text().replace(/：|:/g, '').trim();
+        const valueEl = $(el).find('.value');
+        const valueText = valueEl.text().trim();
+
+        if (/日期/.test(label)) {
+            const m = valueText.match(/\d{4}-\d{2}-\d{2}/);
+            result.releaseDate = m ? m[0] : valueText;
+        } else if (/時長|时长/.test(label)) {
+            result.duration = valueText;
+        } else if (/導演|导演/.test(label)) {
+            result.director = valueText;
+        } else if (/片商/.test(label)) {
+            result.studio = valueText;
+        } else if (/發行商|发行商/.test(label)) {
+            result.label = valueText;
+        } else if (/系列/.test(label)) {
+            result.series = valueText;
+        } else if (/類別|类别/.test(label)) {
+            valueEl.find('a').each((_, a) => {
+                const t = $(a).text().trim();
+                if (t) result.tags.push(t);
+            });
+        } else if (/演員|演员/.test(label)) {
+            valueEl.find('a').each((_, a) => {
+                const name = $(a).text().trim();
+                if (name) result.actresses.push(name);
+            });
+        } else if (/男優|男优/.test(label)) {
+            valueEl.find('a').each((_, a) => {
+                const name = $(a).text().trim();
+                if (name) result.actors.push(name);
+            });
+        }
+    });
+
+    return result.title ? result : null;
+}
+
+// ─── 主入口：依次尝试三个数据源 ─────────────────────────
+export async function search(id) {
+    // FC2 格式识别：031926-100 → 031926_100（JAVDB 存储格式）
+    let searchId = id;
+    if (/^\d{5,6}-\d+$/.test(id)) {
+        searchId = id.replace(/-/g, '_');  // 全局替换，更安全
+        console.log(chalk.gray(`  识别为FC2格式的车牌号: ${id}`));
+    }
+
+    const cached = getCache(id);
+    if (cached) return cached;
+
+    const MAX_RETRY = 3;
+
+    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; }
+
+        if (attempt < MAX_RETRY) {
+            await new Promise(resolve => setTimeout(resolve, 2000));
+        }
+    }
+
+    // Windows 用户提示
+    if (process.platform === 'win32') {
+        process.stderr.write(chalk.gray('  温馨提示: 此车牌号需要JAVDB数据源，Windows暂不支持~\n'));
+    }
+
+    return null;
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "javdict",
+  "version": "1.2.2",
+  "description": "AV番号命令行查询工具",
+  "main": "./index.js",
+  "type": "module",
+  "scripts": {
+    "start": "node index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "bin": {
+    "jav": "./index.js"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "chalk": "^5.3.0",
+    "cheerio": "^1.0.0",
+    "commander": "^12.0.0",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^1.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT"
+}

package/test/cache.test.js

@@ -0,0 +1,82 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { existsSync, rmSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+// 每次测试前后清理真实缓存文件，避免污染
+const CACHE_FILE = join(homedir(), '.config', 'javinfo', 'cache.json');
+
+// 动态 import 保证每次拿到最新模块
+async function importCache() {
+    return await import('../lib/cache.js');
+}
+
+describe('cache.js', () => {
+    beforeEach(() => {
+        // 清空缓存文件，保证每个测试独立
+        if (existsSync(CACHE_FILE)) {
+            rmSync(CACHE_FILE);
+        }
+    });
+
+    afterEach(() => {
+        if (existsSync(CACHE_FILE)) {
+            rmSync(CACHE_FILE);
+        }
+    });
+
+    it('getCache：缓存不存在时返回 null', async () => {
+        const { getCache } = await importCache();
+        const result = getCache('SSIS-001');
+        expect(result).toBeNull();
+    });
+
+    it('setCache + getCache：写入后能正确读取', async () => {
+        const { getCache, setCache } = await importCache();
+        const mockData = { id: 'SSIS-001', title: '测试标题', actresses: ['女优A'] };
+
+        setCache('SSIS-001', mockData);
+        const result = getCache('SSIS-001');
+
+        expect(result).toEqual(mockData);
+    });
+
+    it('getCache：缓存过期后返回 null', async () => {
+        const { getCache, setCache } = await importCache();
+        const mockData = { id: 'ABW-001', title: '过期测试' };
+
+        setCache('ABW-001', mockData);
+
+        // 手动篡改缓存时间为 8 天前，模拟过期
+        const { readFileSync, writeFileSync } = await import('fs');
+        const raw = JSON.parse(readFileSync(CACHE_FILE, 'utf-8'));
+        raw['ABW-001'].cachedAt = Date.now() - 8 * 24 * 60 * 60 * 1000;
+        writeFileSync(CACHE_FILE, JSON.stringify(raw), 'utf-8');
+
+        const result = getCache('ABW-001');
+        expect(result).toBeNull();
+    });
+
+    it('setCache：不同番号互不干扰', async () => {
+        const { getCache, setCache } = await importCache();
+        const dataA = { id: 'SSIS-001', title: 'A' };
+        const dataB = { id: 'IPX-001', title: 'B' };
+
+        setCache('SSIS-001', dataA);
+        setCache('IPX-001', dataB);
+
+        expect(getCache('SSIS-001')).toEqual(dataA);
+        expect(getCache('IPX-001')).toEqual(dataB);
+    });
+
+    it('clearCache：清空后所有缓存消失', async () => {
+        const { getCache, setCache, clearCache } = await importCache();
+        setCache('SSIS-001', { id: 'SSIS-001' });
+        setCache('IPX-001', { id: 'IPX-001' });
+
+        clearCache();
+
+        expect(getCache('SSIS-001')).toBeNull();
+        expect(getCache('IPX-001')).toBeNull();
+    });
+});

package/test/display.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { display } from '../lib/display.js';
+
+// 完整的 mock 数据
+const MOCK_INFO = {
+    id: 'SSIS-001',
+    title: '测试标题',
+    actresses: ['天使もえ'],
+    actors: ['男优A'],
+    releaseDate: '2021-01-01',
+    duration: '120分钟',
+    studio: 'SOD Create',
+    label: 'SOD',
+    director: '导演A',
+    series: '系列A',
+    tags: ['独占', '美少女'],
+    coverUrl: 'https://example.com/cover.jpg',
+    score: '4.5分',
+};
+
+describe('display.js', () => {
+    beforeEach(() => {
+        // 拦截 console.log，不真正打印，但可以断言调用内容
+        vi.spyOn(console, 'log').mockImplementation(() => {});
+    });
+
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+
+    it('display：正常调用不抛出异常', () => {
+        expect(() => display(MOCK_INFO)).not.toThrow();
+    });
+
+    it('display：输出内容包含番号', () => {
+        display(MOCK_INFO);
+        const allOutput = console.log.mock.calls.flat().join(' ');
+        expect(allOutput).toContain('SSIS-001');
+    });
+
+    it('display：输出内容包含女优名', () => {
+        display(MOCK_INFO);
+        const allOutput = console.log.mock.calls.flat().join(' ');
+        expect(allOutput).toContain('天使もえ');
+    });
+
+    it('display：raw 模式输出 JSON 字符串', () => {
+        display(MOCK_INFO, true);
+        const allOutput = console.log.mock.calls.flat().join(' ');
+        // raw 模式应该输出可解析的 JSON
+        expect(() => JSON.parse(allOutput)).not.toThrow();
+    });
+
+    it('display：空字段不影响正常输出', () => {
+        const sparseInfo = { ...MOCK_INFO, actors: [], tags: [], coverUrl: '' };
+        expect(() => display(sparseInfo)).not.toThrow();
+    });
+});

package/test/fetcher.test.js

@@ -0,0 +1,102 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+
+// mock axios，避免真实网络请求
+vi.mock('axios', () => ({
+    default: {
+        get: vi.fn(),
+    },
+}));
+
+import axios from 'axios';
+import { search } from '../lib/fetcher.js';
+
+// 模拟搜索结果页的 HTML
+const MOCK_SEARCH_HTML = `
+  <div class="movie-list">
+    <div class="item">
+      <a href="/v/abc123">
+        <div class="video-title">SSIS-001</div>
+      </a>
+    </div>
+  </div>
+`;
+
+// 模拟详情页的 HTML
+const MOCK_DETAIL_HTML = `
+  <h2 class="title"><strong class="current-title">测试标题</strong></h2>
+  <div class="video-cover"><img src="https://example.com/cover.jpg" /></div>
+  <div class="score"><span class="value">4.5分</span></div>
+  <div class="movie-panel-info">
+    <div class="panel-block">
+      <strong>日期:</strong>
+      <span class="value">2021-01-01</span>
+    </div>
+    <div class="panel-block">
+      <strong>演員:</strong>
+      <span class="value"><a>天使もえ</a></span>
+    </div>
+    <div class="panel-block">
+      <strong>片商:</strong>
+      <span class="value">SOD Create</span>
+    </div>
+    <div class="panel-block">
+      <strong>時長:</strong>
+      <span class="value">120分钟</span>
+    </div>
+  </div>
+`;
+
+describe('fetcher.js', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+
+    it('search：正常番号能返回结构完整的对象', async () => {
+        // 第一次调用返回搜索页，第二次返回详情页
+        axios.get
+            .mockResolvedValueOnce({ data: MOCK_SEARCH_HTML })
+            .mockResolvedValueOnce({ data: MOCK_DETAIL_HTML });
+
+        const result = await search('SSIS-001');
+
+        expect(result).not.toBeNull();
+        expect(result.id).toBe('SSIS-001');
+        expect(result.title).toBe('测试标题');
+        expect(result.actresses).toContain('天使もえ');
+        expect(result.releaseDate).toBe('2021-01-01');
+        expect(result.studio).toBe('SOD Create');
+        expect(result.duration).toBe('120分钟');
+        expect(result.coverUrl).toBe('https://example.com/cover.jpg');
+    });
+
+    it('search：搜索结果为空时返回 null', async () => {
+        // 返回一个没有结果的搜索页
+        axios.get.mockResolvedValueOnce({ data: '<div class="movie-list"></div>' });
+
+        const result = await search('INVALID-999');
+        expect(result).toBeNull();
+    });
+
+    it('search：网络请求失败时抛出错误', async () => {
+        axios.get.mockRejectedValueOnce(new Error('Network Error'));
+
+        await expect(search('SSIS-001')).rejects.toThrow('Network Error');
+    });
+
+    it('search：返回对象包含所有预期字段', async () => {
+        axios.get
+            .mockResolvedValueOnce({ data: MOCK_SEARCH_HTML })
+            .mockResolvedValueOnce({ data: MOCK_DETAIL_HTML });
+
+        const result = await search('SSIS-001');
+        const expectedFields = [
+            'id', 'title', 'actresses', 'actors',
+            'releaseDate', 'duration', 'studio', 'label',
+            'director', 'series', 'tags', 'coverUrl', 'score',
+        ];
+
+        expectedFields.forEach(field => {
+            expect(result).toHaveProperty(field);
+        });
+    });
+});