okooooooo/AvDict
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
AvDict/README_de.md
T

8.5 KiB
Raw Permalink Blame History

English | 中文 | 日本語 | 한국어 | Deutsch

AvDict 🎬

Ein Kommandozeilen-Tool zum Abrufen von JAV-Metadaten anhand der Titel-ID — Besetzung, Erscheinungsdatum, Studio und mehr

npm version Node.js License: MIT Platform

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.

JavDict-Demo-de

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）

npm install -g javdict

Option 2: Klonen von GitHub（für Entwickler）

git clone https://github.com/gdjdkid/AvDict.git
cd AvDict
npm install
npm install -g .

Installation überprüfen：

jav -v

Aktualisierung

Option 1: Update über npm（empfohlen）

sudo npm install -g javdict@latest

Option 2: Update von GitHub（für Entwickler）

cd AvDict
git pull
sudo npm install -g .

Verwendung

Titel-ID suchen：

jav SSIS-001
jav ABF-331
jav JUR-067

Ausgabe in bestimmter Sprache：

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：

jav -r SSIS-001

Lokalen Cache leeren：

jav --clear-cache

JAVDB Cookie konfigurieren（optional）：

jav --setup

Hilfe anzeigen：

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 in Chrome und melde dich an
  2. Installiere die Chrome-Erweiterung Get cookies.txt LOCALLY
  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：
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：

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：

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：

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 Schnell, breite Abdeckung
NJAV njav.com Hohe Abdeckung, kein Cookie erforderlich
JavLibrary javlibrary.com Detaillierte Metadaten, enthält Bewertungen
JAVDB javdb.com Umfangreichste Datenbank, Cookie erforderlich

Lizenz

Dieses Projekt ist Open Source unter der MIT 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
WeChat 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
Reference in new issue View Git Blame Copy Permalink