javdict 1.2.3 → 1.2.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gdjdkid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -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

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

package/README_ja.md

@@ -0,0 +1,230 @@
+[English](README.md) | [中文](README_zh.md) | 日本語 | [한국어](README_ko.md) | [Deutsch](README_de.md)
+
+# AvDict 🎬
+
+> コマンドラインで AV 番号を検索するツール — 出演者、発売日、メーカーなどの情報を取得
+
+[![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)]()
+
+番号を入力するだけで、出演者・発売日・メーカー・収録時間・タグなどの詳細情報を取得できます。複数のデータソースを自動的に切り替えて検索します。
+
+---
+
+## 特徴
+
+- 🔍 **複数データソース自動フォールバック** — 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** — 初回リリース

package/README_ko.md

@@ -0,0 +1,230 @@
+[English](README.md) | [中文](README_zh.md) | [日本語](README_ja.md) | 한국어 | [Deutsch](README_de.md)
+
+# AvDict 🎬
+
+> 커맨드라인에서 AV 번호로 상세 정보를 검색하는 도구 — 출연진, 발매일, 제작사 등
+
+[![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)]()
+
+번호를 입력하면 출연진, 발매일, 제작사, 재생 시간, 태그 등 상세 정보를 바로 확인할 수 있습니다. 여러 데이터 소스를 자동으로 전환하며 검색합니다.
+
+---
+
+## 주요 기능
+
+- 🔍 **다중 소스 자동 폴백** — 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** — 최초 릴리스

package/README_zh.md

@@ -1,16 +1,16 @@
+[English](README.md) | 中文 | [日本語](README_ja.md) | [한국어](README_ko.md) | [Deutsch](README_de.md)
+
 # AvDict 🎬
 
 > 一个命令行查询 AV 车牌号详细信息的工具
 
-[![npm version](https://img.shields.io/badge/version-1.2.1-blue.svg)](https://github.com/gdjdkid/AvDict)
+[![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)]()
 
 输入一个车牌号，即可获取女优、发售日期、制作商、时长、类别等完整信息。支持多数据源自动兜底，无需手动切换。
 
-![示例](https://raw.githubusercontent.com/gdjdkid/AvDict/master/example.gif)
-
 ---
 
 ## 功能特点
@@ -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** — 初始版本发布

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "javdict",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "description": "AV番号命令行查询工具",
   "main": "./index.js",
   "type": "module",