Docs: Added Japanese, Korean, and German README files; added language switching links to all versions.
This commit is contained in:
gdjdkid committed
1 parent
a866805bf5
commit
428813de78
6 files changed
+700
-9
No files matched your search
@@ -1,3 +1,5 @@
|
||||
English | [中文](README_zh.md) | [日本語](README_ja.md) | [한국어](README_ko.md) | [Deutsch](README_de.md)
|
||||
|
||||
# AvDict 🎬
|
||||
|
||||
> A command-line tool to look up JAV metadata by title ID — cast, release date, studio, and more
|
||||
|
||||
+230
@@ -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
|
||||
|
||||
[](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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 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
|
||||
+230
@@ -0,0 +1,230 @@
|
||||
[English](README.md) | [中文](README_zh.md) | 日本語 | [한국어](README_ko.md) | [Deutsch](README_de.md)
|
||||
|
||||
# AvDict 🎬
|
||||
|
||||
> コマンドラインで AV 番号を検索するツール — 出演者、発売日、メーカーなどの情報を取得
|
||||
|
||||
[](https://github.com/gdjdkid/AvDict)
|
||||
[](https://nodejs.org)
|
||||
[](LICENSE)
|
||||
[]()
|
||||
|
||||
番号を入力するだけで、出演者・発売日・メーカー・収録時間・タグなどの詳細情報を取得できます。複数のデータソースを自動的に切り替えて検索します。
|
||||
|
||||
---
|
||||
|
||||
## 特徴
|
||||
|
||||
- 🔍 **複数データソース自動フォールバック** — 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 は Cloudflare の TLS フィンガープリント制限により Windows では利用不可。その他の3つのソースは Windows でも正常に動作します。
|
||||
|
||||
---
|
||||
|
||||
## インストール
|
||||
|
||||
**方法1：npm からインストール（推奨）**
|
||||
|
||||
```bash
|
||||
npm install -g javdict
|
||||
```
|
||||
|
||||
**方法2：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 では Cloudflare の制限により JAVDB が使用できません。JAVDB にのみ収録されている一部の作品は Windows では検索できません。完全な検索結果を得るには Linux 環境（Raspberry Pi など）の使用を推奨します。
|
||||
|
||||
**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 を作成
|
||||
|
||||
**コミットメッセージ規則：**
|
||||
- `feat:` — 新機能
|
||||
- `fix:` — バグ修正
|
||||
- `docs:` — ドキュメント更新
|
||||
- `chore:` — メンテナンス
|
||||
|
||||
---
|
||||
|
||||
## 作者にコーヒーを ☕
|
||||
|
||||
このツールが役に立った場合は、サポートをご検討ください：
|
||||
|
||||
| WeChat Pay | Alipay |
|
||||
|------------|--------|
|
||||
| *(QRコード)* | *(QRコード)* |
|
||||
|
||||
---
|
||||
|
||||
## 更新履歴
|
||||
|
||||
- **v1.2.2** — README 多言語対応、npm 公開
|
||||
- **v1.2.0** — NJAV を第4データソースとして追加、優先順位を調整
|
||||
- **v1.1.x** — 3ソースフォールバック、JAVDB Cookie をオプション化、クロスプラットフォーム対応
|
||||
- **v1.0.0** — 初回リリース
|
||||
+230
@@ -0,0 +1,230 @@
|
||||
[English](README.md) | [中文](README_zh.md) | [日本語](README_ja.md) | 한국어 | [Deutsch](README_de.md)
|
||||
|
||||
# AvDict 🎬
|
||||
|
||||
> 커맨드라인에서 AV 번호로 상세 정보를 검색하는 도구 — 출연진, 발매일, 제작사 등
|
||||
|
||||
[](https://github.com/gdjdkid/AvDict)
|
||||
[](https://nodejs.org)
|
||||
[](LICENSE)
|
||||
[]()
|
||||
|
||||
번호를 입력하면 출연진, 발매일, 제작사, 재생 시간, 태그 등 상세 정보를 바로 확인할 수 있습니다. 여러 데이터 소스를 자동으로 전환하며 검색합니다.
|
||||
|
||||
---
|
||||
|
||||
## 주요 기능
|
||||
|
||||
- 🔍 **다중 소스 자동 폴백** — 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는 Cloudflare TLS 핑거프린트 제한으로 인해 Windows에서 사용 불가. 나머지 3개 소스는 Windows에서도 정상 동작합니다.
|
||||
|
||||
---
|
||||
|
||||
## 설치 방법
|
||||
|
||||
**방법 1：npm으로 설치（권장）**
|
||||
|
||||
```bash
|
||||
npm install -g javdict
|
||||
```
|
||||
|
||||
**방법 2：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에서는 Cloudflare 제한으로 JAVDB를 사용할 수 없습니다. JAVDB에만 등록된 일부 번호는 Windows에서 검색할 수 없습니다. 완전한 검색 결과를 위해서는 Linux 환경（예: Raspberry Pi）사용을 권장합니다.
|
||||
|
||||
**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 생성
|
||||
|
||||
**커밋 메시지 규칙：**
|
||||
- `feat:` — 새 기능
|
||||
- `fix:` — 버그 수정
|
||||
- `docs:` — 문서 업데이트
|
||||
- `chore:` — 유지보수
|
||||
|
||||
---
|
||||
|
||||
## 작성자에게 커피 한 잔 ☕
|
||||
|
||||
이 도구가 도움이 됐다면 후원을 고려해 주세요：
|
||||
|
||||
| WeChat Pay | Alipay |
|
||||
|------------|--------|
|
||||
| *(QR코드)* | *(QR코드)* |
|
||||
|
||||
---
|
||||
|
||||
## 변경 이력
|
||||
|
||||
- **v1.2.2** — README 다국어 지원, npm 공개
|
||||
- **v1.2.0** — NJAV를 4번째 데이터 소스로 추가, 우선순위 조정
|
||||
- **v1.1.x** — 3소스 폴백, JAVDB Cookie 선택 사항으로 변경, 크로스 플랫폼 호환성
|
||||
- **v1.0.0** — 최초 릴리스
|
||||
+7
-8
@@ -1,16 +1,16 @@
|
||||
[English](README.md) | 中文 | [日本語](README_ja.md) | [한국어](README_ko.md) | [Deutsch](README_de.md)
|
||||
|
||||
# AvDict 🎬
|
||||
|
||||
> 一个命令行查询 AV 车牌号详细信息的工具
|
||||
|
||||
[](https://github.com/gdjdkid/AvDict)
|
||||
[](https://github.com/gdjdkid/AvDict)
|
||||
[](https://nodejs.org)
|
||||
[](LICENSE)
|
||||
[]()
|
||||
|
||||
输入一个车牌号，即可获取女优、发售日期、制作商、时长、类别等完整信息。支持多数据源自动兜底，无需手动切换。
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 功能特点
|
||||
@@ -46,11 +46,13 @@
|
||||
## 安装方法
|
||||
|
||||
**方式一：通过 npm 安装（推荐）**
|
||||
|
||||
```bash
|
||||
npm install -g javdict
|
||||
```
|
||||
|
||||
**方式二：从 GitHub 克隆安装（开发者）**
|
||||
|
||||
```bash
|
||||
git clone https://github.com/gdjdkid/AvDict.git
|
||||
cd AvDict
|
||||
@@ -146,10 +148,7 @@ Cookie 配置保存在本地 `~/.config/javinfo/config.json`，不会上传到
|
||||
|
||||
## 缓存说明
|
||||
|
||||
查询结果自动缓存到 `~/.config/javinfo/cache.json`，有效期 7 天。缓存可以：
|
||||
|
||||
- 加快重复查询速度
|
||||
- 减少对数据源网站的请求压力
|
||||
查询结果自动缓存到 `~/.config/javinfo/cache.json`，有效期 7 天。
|
||||
|
||||
如需强制刷新数据，运行：
|
||||
|
||||
@@ -236,7 +235,7 @@ A: 支持，输入格式为 `031926-100`（连字符格式），工具会自动
|
||||
|
||||
## 更新日志
|
||||
|
||||
- **v1.2.1** — 修复代码细节，稳定性优化
|
||||
- **v1.2.2** — README 多语言支持，发布到 npm
|
||||
- **v1.2.0** — 新增 NJAV 第四数据源，调整数据源优先级
|
||||
- **v1.1.x** — 三数据源兜底，JAVDB Cookie 改为可选配置，跨平台兼容优化
|
||||
- **v1.0.0** — 初始版本发布
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "javdict",
|
||||
"version": "1.2.3",
|
||||
"version": "1.2.4",
|
||||
"description": "AV番号命令行查询工具",
|
||||
"main": "./index.js",
|
||||
"type": "module",
|
||||
|
||||
Reference in new issue
Block a user