javdict 1.2.2 → 1.2.4

package/README.md

@@ -1,56 +1,58 @@
+English | [中文](README_zh.md) | [日本語](README_ja.md) | [한국어](README_ko.md) | [Deutsch](README_de.md)
+
 # AvDict 🎬
 
-> 一个命令行查询 AV 车牌号详细信息的工具
+> 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.
 
-![示例](https://raw.githubusercontent.com/gdjdkid/AvDict/master/example.gif)
+![Example](https://raw.githubusercontent.com/gdjdkid/AvDict/master/example.gif)
 
 ---
 
-## 功能特点
+## Features
 
-- 🔍 **多数据源自动兜底** — 依次查询 JAVBUS → NJAV → JavLibrary → JAVDB，任意一个命中即返回
-- 📋 **信息完整** — 女优、男优、发售日期、时长、制作商、发行商、导演、系列、类别、封面、评分
-- 💾 **本地缓存** — 查询结果缓存 7 天，减少重复请求
-- 🖥️ **跨平台** — 支持 Linux、Windows、macOS
-- 🎨 **彩色输出** — 终端美化显示，字段分色，清晰易读
-- ⚡ **查询快速** — 直接番号拼 URL，无需登录即可使用
+- 🔍 **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（Linux/macOS 系统自带；Windows 请确认 Git Bash 环境下可用）
+- curl (built into Linux/macOS; ensure it's available in your Git Bash environment on Windows)
 
 ---
 
-## 支持的平台
+## Platform Support
 
-| 平台 | JAVBUS | NJAV | JavLibrary | JAVDB |
-|------|--------|------|------------|-------|
+| Platform | JAVBUS | NJAV | JavLibrary | JAVDB |
+|----------|--------|------|------------|-------|
 | Linux / macOS | ✅ | ✅ | ✅ | ✅ |
 | Windows | ✅ | ✅ | ✅ | ❌ |
 
-> JAVDB 在 Windows 上因 Cloudflare TLS 指纹限制无法使用，其他三个数据源在 Windows 上完全正常。
+> JAVDB is unavailable on Windows due to Cloudflare TLS fingerprint restrictions. The other three sources work fully on Windows.
 
 ---
 
-## 安装方法
+## Installation
 
-**方式一：通过 npm 安装（推荐）**
+**Option 1: Install via npm (recommended)**
 ```bash
 npm install -g javdict
 ```
 
-**方式二：从 GitHub 克隆安装（开发者）**
+**Option 2: Clone from GitHub (for developers)**
 ```bash
 git clone https://github.com/gdjdkid/AvDict.git
 cd AvDict
@@ -58,7 +60,7 @@ npm install
 npm install -g .
 ```
 
-**验证安装成功：**
+**Verify the installation:**
 
 ```bash
 jav -v
@@ -66,9 +68,9 @@ jav -v
 
 ---
 
-## 使用说明
+## Usage
 
-**查询车牌号：**
+**Look up a title ID:**
 
 ```bash
 jav SSIS-001
@@ -76,25 +78,25 @@ jav ABF-331
 jav JUR-067
 ```
 
-**输出原始 JSON 数据：**
+**Output raw JSON:**
 
 ```bash
 jav -r SSIS-001
 ```
 
-**清空本地缓存：**
+**Clear local cache:**
 
 ```bash
 jav --clear-cache
 ```
 
-**配置 JAVDB Cookie（可选）：**
+**Configure JAVDB Cookie (optional):**
 
 ```bash
 jav --setup
 ```
 
-**显示帮助信息：**
+**Show help:**
 
 ```bash
 jav -h
@@ -102,56 +104,53 @@ jav -h
 
 ---
 
-## 命令行选项
+## CLI Options
 
 ```
-Usage: jav [options] [番号]
+Usage: jav [options] [id]
 
 Arguments:
-  番号                   要查询的车牌号，例如: SSIS-001
+  id                    Title ID to look up, e.g. SSIS-001
 
 Options:
-  -v, --version         显示版本号
-  -r, --raw             以原始 JSON 格式输出结果
-  --setup               配置 JAVDB Cookie（可选，提高覆盖率）
-  --clear-cache         清空本地缓存
-  -h, --help            显示帮助信息
+  -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 配置（可选）
+### JAVDB Cookie (optional)
 
-不配置也可以正常使用，配置后可提高部分冷门番号的查询覆盖率（仅 Linux/macOS 生效）。
+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. 用 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. 运行以下命令并粘贴：
+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
 ```
 
-Cookie 配置保存在本地 `~/.config/javinfo/config.json`，不会上传到任何地方。
+Your Cookie is saved locally at `~/.config/javinfo/config.json` and never sent anywhere.
 
-**Cookie 有效期约 2 周**，过期后重新运行 `jav --setup` 更新即可。
+**Cookies typically expire in about 2 weeks.** When niche titles start returning "not found", just run `jav --setup` again to refresh.
 
 ---
 
-## 缓存说明
-
-查询结果自动缓存到 `~/.config/javinfo/cache.json`，有效期 7 天。缓存可以：
+## 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
@@ -159,84 +158,84 @@ jav --clear-cache
 
 ---
 
-## 常见问题
+## FAQ
 
-**Q: 查询失败提示 `未找到番号`？**
+**Q: I get "title not found" — what's wrong?**
 
-A: 可能原因有三个：
-1. 该番号在所有数据源均未收录（极小众内容）
-2. JAVDB Cookie 已过期，运行 `jav --setup` 重新配置
-3. 网络无法访问数据源，请检查代理设置
+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: Windows 上部分番号查不到？**
+**Q: Some titles don't show up on Windows?**
 
-A: Windows 上 JAVDB 数据源因 Cloudflare 限制无法使用，少数仅收录于 JAVDB 的番号在 Windows 上无法查询。建议在 Linux 环境（如树莓派）下使用以获得最完整的查询结果。
+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: 提示 `Permission denied`？**
+**Q: I get `Permission denied` when installing?**
 
-A: 全局安装时需要管理员权限：
+A: Global installation requires elevated permissions:
 ```bash
 sudo npm install -g .
 ```
 
-**Q: Cookie 多久需要更新一次？**
+**Q: How often do I need to update my Cookie?**
 
-A: 通常 2 周左右，当出现冷门番号突然查不到时，运行 `jav --setup` 更新即可。
+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: 支持 FC2 素人番号吗？**
+**Q: Does it support FC2 amateur titles?**
 
-A: 支持，输入格式为 `031926-100`（连字符格式），工具会自动识别并转换格式查询。
+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
 
-| 数据源 | 网站 | 特点 |
-|--------|------|------|
-| 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 |
+| 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
 
-本项目基于 [MIT License](LICENSE) 开源，你可以自由使用、修改和分发。
+This project is open source under the [MIT License](LICENSE). You're free to use, modify, and distribute it.
 
 ---
 
-## 如何贡献代码
+## Contributing
 
-欢迎提交 PR 或 Issue！
+PRs and Issues are welcome!
 
-1. Fork 这个仓库
-2. 创建你的功能分支：`git checkout -b feat/your-feature`
-3. 提交改动：`git commit -m "feat: 描述你的改动"`
-4. 推送分支：`git push origin feat/your-feature`
-5. 提交 Pull Request
+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 规范：**
-- `feat:` 新增功能
-- `fix:` 修复 bug
-- `docs:` 修改文档
-- `chore:` 杂项维护
+**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** — 修复代码细节，稳定性优化
-- **v1.2.0** — 新增 NJAV 第四数据源，调整数据源优先级
-- **v1.1.x** — 三数据源兜底，JAVDB Cookie 改为可选配置，跨平台兼容优化
-- **v1.0.0** — 初始版本发布
+- **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/README_de.md

@@ -0,0 +1,230 @@
+[English](README.md) | [中文](README_zh.md) | [日本語](README_ja.md) | [한국어](README_ko.md) | Deutsch
+
+# AvDict 🎬
+
+> Ein Kommandozeilen-Tool zum Abrufen von JAV-Metadaten anhand der Titel-ID — Besetzung, Erscheinungsdatum, Studio und mehr
+
+[![npm version](https://img.shields.io/badge/version-1.2.2-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)]()
+
+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.
+
+---
+
+## Funktionen
+
+- 🔍 **Automatisches Multi-Source-Fallback** — Fragt JAVBUS → NJAV → JavLibrary → JAVDB der Reihe nach ab und gibt beim ersten Treffer zurück
+- 📋 **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
+- 🎨 **Farbige Ausgabe** — Übersichtliche Terminal-Darstellung mit feldweiser Farbkodierung
+- ⚡ **Schnelle Suche** — Direkte URL-Konstruktion anhand der Titel-ID, kein Login erforderlich
+
+---
+
+## Systemanforderungen
+
+- Node.js >= 18.0.0
+- npm >= 6.0.0
+- curl（unter Linux/macOS vorinstalliert; unter Windows in der Git Bash-Umgebung verfügbar）
+
+---
+
+## Plattform-Unterstützung
+
+| Plattform | JAVBUS | NJAV | JavLibrary | JAVDB |
+|-----------|--------|------|------------|-------|
+| Linux / macOS | ✅ | ✅ | ✅ | ✅ |
+| Windows | ✅ | ✅ | ✅ | ❌ |
+
+> JAVDB ist unter Windows aufgrund von Cloudflare TLS-Fingerprint-Einschränkungen nicht verfügbar. Die anderen drei Quellen funktionieren unter Windows vollständig.
+
+---
+
+## Installation
+
+**Option 1: Installation über npm（empfohlen）**
+
+```bash
+npm install -g javdict
+```
+
+**Option 2: Klonen von GitHub（für Entwickler）**
+
+```bash
+git clone https://github.com/gdjdkid/AvDict.git
+cd AvDict
+npm install
+npm install -g .
+```
+
+**Installation überprüfen：**
+
+```bash
+jav -v
+```
+
+---
+
+## Verwendung
+
+**Titel-ID suchen：**
+
+```bash
+jav SSIS-001
+jav ABF-331
+jav JUR-067
+```
+
+**Rohdaten als JSON ausgeben：**
+
+```bash
+jav -r SSIS-001
+```
+
+**Lokalen Cache leeren：**
+
+```bash
+jav --clear-cache
+```
+
+**JAVDB Cookie konfigurieren（optional）：**
+
+```bash
+jav --setup
+```
+
+**Hilfe anzeigen：**
+
+```bash
+jav -h
+```
+
+---
+
+## CLI-Optionen
+
+```
+Usage: jav [options] [id]
+
+Arguments:
+  id                    Zu suchende Titel-ID, z.B. SSIS-001
+
+Options:
+  -v, --version         Versionsnummer ausgeben
+  -r, --raw             Ausgabe als rohes JSON
+  --setup               JAVDB Cookie konfigurieren（optional, verbessert Abdeckung）
+  --clear-cache         Lokalen Cache leeren
+  -h, --help            Hilfe anzeigen
+```
+
+---
+
+## Konfiguration
+
+### JAVDB Cookie（optional）
+
+Das Tool funktioniert ohne jede Konfiguration. Das Hinzufügen eines JAVDB Cookies verbessert die Abdeckung für seltene Titel, die nur in der JAVDB-Datenbank vorhanden sind. Dies gilt nur für Linux/macOS.
+
+**So erhältst du deinen Cookie：**
+
+1. Öffne [https://javdb.com](https://javdb.com) in Chrome und melde dich an
+2. Installiere die Chrome-Erweiterung [Get cookies.txt LOCALLY](https://chrome.google.com/webstore/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)
+3. Klicke auf das Erweiterungs-Symbol auf der JAVDB-Seite und exportiere die Cookies
+4. Suche die Zeile `_jdb_session` und kopiere den Wert in der letzten Spalte
+5. Führe den Setup-Befehl aus und füge den Wert ein：
+
+```bash
+jav --setup
+```
+
+Dein Cookie wird lokal unter `~/.config/javinfo/config.json` gespeichert und nirgendwo hin gesendet.
+
+**Cookies laufen in etwa 2 Wochen ab.** Wenn seltene Titel plötzlich nicht mehr gefunden werden, führe einfach `jav --setup` erneut aus.
+
+---
+
+## Caching
+
+Suchergebnisse werden automatisch in `~/.config/javinfo/cache.json` mit einer Gültigkeitsdauer von 7 Tagen gespeichert.
+
+Um frische Daten zu erzwingen：
+
+```bash
+jav --clear-cache
+```
+
+---
+
+## Häufige Fragen
+
+**F: Ich erhalte „Titel nicht gefunden" — was ist falsch?**
+
+A: Es gibt drei mögliche Ursachen：
+1. Der Titel ist in keiner der vier Quellen indexiert（sehr seltene Inhalte）
+2. Dein JAVDB Cookie ist abgelaufen — führe `jav --setup` aus, um ihn zu erneuern
+3. Dein Netzwerk kann die Quellen nicht erreichen — überprüfe deine Proxy-Einstellungen
+
+**F: Einige Titel werden unter Windows nicht gefunden?**
+
+A: JAVDB ist unter Windows aufgrund von Cloudflare-Einschränkungen nicht verfügbar. Eine kleine Anzahl von Titeln, die nur in JAVDB existieren, kann unter Windows nicht gefunden werden. Für vollständige Abdeckung empfehlen wir eine Linux-Umgebung（z.B. Raspberry Pi）.
+
+**F: Werden FC2-Amateur-Titel unterstützt?**
+
+A: Ja. Gib den Titel im Bindestrich-Format ein, z.B. `031926-100`. Das Tool erkennt das FC2-Format automatisch und wandelt es intern um.
+
+---
+
+## Datenquellen
+
+| Quelle | Website | Hinweise |
+|--------|---------|----------|
+| JAVBUS | [javbus.com](https://www.javbus.com) | Schnell, breite Abdeckung |
+| NJAV | [njav.com](https://www.njav.com) | Hohe Abdeckung, kein Cookie erforderlich |
+| JavLibrary | [javlibrary.com](https://www.javlibrary.com) | Detaillierte Metadaten, enthält Bewertungen |
+| JAVDB | [javdb.com](https://javdb.com) | Umfangreichste Datenbank, Cookie erforderlich |
+
+---
+
+## Lizenz
+
+Dieses Projekt ist Open Source unter der [MIT License](LICENSE). Du kannst es frei verwenden, modifizieren und verteilen.
+
+---
+
+## Mitwirken
+
+PRs und Issues sind willkommen！
+
+1. Dieses Repository forken
+2. Branch erstellen：`git checkout -b feat/dein-feature`
+3. Änderungen committen：`git commit -m "feat: Beschreibe deine Änderung"`
+4. Branch pushen：`git push origin feat/dein-feature`
+5. Pull Request öffnen
+
+**Commit-Nachricht-Konventionen：**
+- `feat:` — Neue Funktion
+- `fix:` — Fehlerbehebung
+- `docs:` — Dokumentation aktualisiert
+- `chore:` — Wartung / Housekeeping
+
+---
+
+## Kauf mir einen Kaffee ☕
+
+Wenn dir dieses Tool Zeit spart, unterstütze gerne die Entwicklung：
+
+| WeChat Pay | Alipay |
+|------------|--------|
+| *(QR-Code)* | *(QR-Code)* |
+
+---
+
+## Änderungsprotokoll
+
+- **v1.2.2** — Mehrsprachige README, npm-Veröffentlichung
+- **v1.2.0** — NJAV als vierte Datenquelle hinzugefügt, Quellenpriorität neu geordnet
+- **v1.1.x** — Drei-Quellen-Fallback, JAVDB Cookie optional, plattformübergreifende Kompatibilität
+- **v1.0.0** — Erstveröffentlichung