javdict 1.2.2 → 1.2.4

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

@@ -0,0 +1,241 @@
+[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.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 在 Windows 上因 Cloudflare TLS 指纹限制无法使用，其他三个数据源在 Windows 上完全正常。
+
+---
+
+## 安装方法
+
+**方式一：通过 npm 安装（推荐）**
+
+```bash
+npm install -g javdict
+```
+
+**方式二：从 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 上 JAVDB 数据源因 Cloudflare 限制无法使用，少数仅收录于 JAVDB 的番号在 Windows 上无法查询。建议在 Linux 环境（如树莓派）下使用以获得最完整的查询结果。
+
+**Q: 提示 `Permission denied`？**
+
+A: 全局安装时需要管理员权限：
+```bash
+sudo npm install -g .
+```
+
+**Q: Cookie 多久需要更新一次？**
+
+A: 通常 2 周左右，当出现冷门番号突然查不到时，运行 `jav --setup` 更新即可。
+
+**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
+
+**Commit 规范：**
+- `feat:` 新增功能
+- `fix:` 修复 bug
+- `docs:` 修改文档
+- `chore:` 杂项维护
+
+---
+
+## 请作者喝一杯咖啡 ☕
+
+如果这个工具对你有帮助，欢迎打赏支持：
+
+| 微信支付 | 支付宝 |
+|---------|--------|
+| *(二维码)* | *(二维码)* |
+
+---
+
+## 更新日志
+
+- **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.2",
+  "version": "1.2.4",
   "description": "AV番号命令行查询工具",
   "main": "./index.js",
   "type": "module",