280 lines
8.5 KiB
Markdown
280 lines
8.5 KiB
Markdown
[English](README.md) | [中文](README_zh.md) | [日本語](README_jp.md) | [한국어](README_kr.md) | Deutsch
|
||
|
||
# AvDict 🎬
|
||
|
||
> Ein Kommandozeilen-Tool zum Abrufen von JAV-Metadaten anhand der Titel-ID — Besetzung, Erscheinungsdatum, Studio und mehr
|
||
|
||
[](https://github.com/gdjdkid/AvDict)
|
||
[](https://nodejs.org)
|
||
[](LICENSE)
|
||
[]()
|
||
|
||
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
|
||
```
|
||
|
||
## Aktualisierung
|
||
|
||
**Option 1: Update über npm（empfohlen）**
|
||
```bash
|
||
sudo npm install -g javdict@latest
|
||
```
|
||
|
||
**Option 2: Update von GitHub（für Entwickler）**
|
||
```bash
|
||
cd AvDict
|
||
git pull
|
||
sudo npm install -g .
|
||
```
|
||
|
||
---
|
||
|
||
## Verwendung
|
||
|
||
**Titel-ID suchen：**
|
||
|
||
```bash
|
||
jav SSIS-001
|
||
jav ABF-331
|
||
jav JUR-067
|
||
```
|
||
|
||
**Ausgabe in bestimmter Sprache：**
|
||
```bash
|
||
jav --lang de SSIS-001 # Deutsch
|
||
jav --lang zh SSIS-001 # 中文
|
||
jav --lang en SSIS-001 # English
|
||
jav --lang jp SSIS-001 # 日本語
|
||
jav --lang kr SSIS-001 # 한국어
|
||
jav -l de SSIS-001 # Kurzform
|
||
```
|
||
|
||
**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
|
||
-l, --lang <Sprache> Ausgabesprache: zh/en/jp/kr/de (Standard: zh)
|
||
-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: Ich erhalte `Permission denied` bei der Installation？**
|
||
|
||
A: Für die globale Installation sind erhöhte Rechte erforderlich：
|
||
```bash
|
||
sudo npm install -g .
|
||
```
|
||
|
||
**F: Wie oft muss ich meinen Cookie aktualisieren？**
|
||
|
||
A: Ungefähr alle 2 Wochen. Wenn zuvor funktionierende Nischen-Titel plötzlich nicht mehr gefunden werden, ist dein Cookie wahrscheinlich abgelaufen — führe `jav --setup` aus, um ihn zu aktualisieren.
|
||
|
||
**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.
|
||
|
||
**F: Funktioniert es in China?**
|
||
|
||
A: Alle Datenquellen sind auf Servern außerhalb Chinas gehostet und in China geblockt. Ein Proxy ist erforderlich. Falls Abfragen fehlschlagen, teste die Netzwerkverbindung mit diesen Befehlen：
|
||
```bash
|
||
curl -sL --connect-timeout 5 "https://www.javbus.com" -o /dev/null -w "JAVBUS: %{http_code}\n"
|
||
curl -sL --connect-timeout 5 "https://www.njav.com" -o /dev/null -w "NJAV: %{http_code}\n"
|
||
curl -sL --connect-timeout 5 "https://www.google.com" -o /dev/null -w "Google: %{http_code}\n"
|
||
```
|
||
|
||
`200` bedeutet erreichbar, `000` bedeutet keine Verbindung — überprüfe deine Proxy-Einstellungen.
|
||
|
||
---
|
||
|
||
## 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 | PayPal |
|
||
|------------|--------|--------|
|
||
|  |  |  |
|
||
|
||
---
|
||
|
||
## Ä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
|