javdict 1.2.9 → 1.2.11

package/README.md

@@ -66,6 +66,20 @@ npm install -g .
 jav -v
 ```
 
+## Updating
+
+**Option 1: Update via npm (recommended)**
+```bash
+sudo npm install -g javdict@latest
+```
+
+**Option 2: Update from GitHub (for developers)**
+```bash
+cd AvDict
+git pull
+sudo npm install -g .
+```
+
 ---
 
 ## Usage
@@ -186,6 +200,17 @@ A: Roughly every 2 weeks. If niche titles that previously worked start returning
 
 A: Yes. Enter the title in hyphen format, e.g. `031926-100`. The tool auto-detects FC2 format and handles the conversion internally.
 
+**Q: Does it work in mainland China?**
+
+A: All data sources are hosted outside mainland China and require a proxy to access. If queries consistently fail, run the following commands to check your network connectivity:
+```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"
+```
+
+A response of `200` means the site is reachable. A response of `000` means the connection failed — check your proxy settings.
+
 ---
 
 ## Data Sources

package/README_de.md

@@ -68,6 +68,20 @@ npm install -g .
 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
@@ -173,10 +187,32 @@ A: Es gibt drei mögliche Ursachen：
 
 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

package/README_ja.md

@@ -68,6 +68,20 @@ npm install -g .
 jav -v
 ```
 
+## アップデート方法
+
+**方法1：npm でアップデート（推奨）**
+```bash
+sudo npm install -g javdict@latest
+```
+
+**方法2：GitHub からアップデート（開発者向け）**
+```bash
+cd AvDict
+git pull
+sudo npm install -g .
+```
+
 ---
 
 ## 使い方
@@ -173,10 +187,32 @@ A: 考えられる原因：
 
 A: Windows では Cloudflare の制限により JAVDB が使用できません。JAVDB にのみ収録されている一部の作品は Windows では検索できません。完全な検索結果を得るには Linux 環境（Raspberry Pi など）の使用を推奨します。
 
+**Q: `Permission denied` と表示される？**
+
+A: グローバルインストールには管理者権限が必要です：
+```bash
+sudo npm install -g .
+```
+
+**Q: Cookie はどのくらいの頻度で更新が必要ですか？**
+
+A: 通常は約2週間ごとです。以前は検索できていたマイナー作品が見つからなくなったら、Cookie の有効期限切れの可能性があります — `jav --setup` を実行して更新してください。
+
 **Q: FC2 素人番号は対応していますか？**
 
 A: 対応しています。`031926-100` のようなハイフン形式で入力してください。ツールが自動的に形式を変換して検索します。
 
+**Q: 中国本土でも使えますか？**
+
+A: すべてのデータソースは中国本土からアクセスできない海外サイトです。中国本土ではプロキシ（VPN）が必要です。検索が失敗する場合は、以下のコマンドでネットワーク接続を確認してください：
+```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` が返ってくれば接続可能、`000` が返ってくれば接続不可です。プロキシ設定を確認してください。
+
 ---
 
 ## データソース

package/README_ko.md

@@ -68,6 +68,20 @@ npm install -g .
 jav -v
 ```
 
+## 업데이트 방법
+
+**방법 1：npm으로 업데이트（권장）**
+```bash
+sudo npm install -g javdict@latest
+```
+
+**방법 2：GitHub에서 업데이트（개발자용）**
+```bash
+cd AvDict
+git pull
+sudo npm install -g .
+```
+
 ---
 
 ## 사용 방법
@@ -173,10 +187,32 @@ A: 가능한 원인：
 
 A: Windows에서는 Cloudflare 제한으로 JAVDB를 사용할 수 없습니다. JAVDB에만 등록된 일부 번호는 Windows에서 검색할 수 없습니다. 완전한 검색 결과를 위해서는 Linux 환경（예: Raspberry Pi）사용을 권장합니다.
 
+**Q: `Permission denied` 가 표시되면？**
+
+A: 전역 설치에는 관리자 권한이 필요합니다：
+```bash
+sudo npm install -g .
+```
+
+**Q: Cookie는 얼마나 자주 업데이트해야 하나요？**
+
+A: 보통 약 2주마다입니다. 이전에 검색되던 마이너 번호가 갑자기 검색되지 않으면 Cookie가 만료된 것입니다 — `jav --setup`을 실행하여 갱신하세요.
+
 **Q: FC2 소인 번호도 지원하나요？**
 
 A: 지원합니다. `031926-100`과 같은 하이픈 형식으로 입력하세요. 도구가 자동으로 형식을 변환하여 검색합니다.
 
+**Q: 중국 본토에서도 사용할 수 있나요？**
+
+A: 모든 데이터 소스는 중국 본토에서 접근할 수 없는 해외 사이트입니다. 중국 본토에서는 프록시（VPN）가 필요합니다. 검색이 계속 실패한다면 아래 명령어로 네트워크 연결을 확인하세요：
+```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` 이 반환되면 접속 가능, `000` 이 반환되면 접속 불가입니다. 프록시 설정을 확인하세요.
+
 ---
 
 ## 데이터 소스

package/README_zh.md

@@ -68,6 +68,20 @@ npm install -g .
 jav -v
 ```
 
+## 更新方法
+
+**方式一：通过 npm 更新（推荐）**
+```bash
+sudo npm install -g javdict@latest
+```
+
+**方式二：从 GitHub 克隆安装（开发者）**
+```bash
+cd AvDict
+git pull
+sudo npm install -g .
+```
+
 ---
 
 ## 使用说明
@@ -188,6 +202,17 @@ A: 通常 2 周左右，当出现冷门番号突然查不到时，运行 `jav --
 
 A: 支持，输入格式为 `031926-100`（连字符格式），工具会自动识别并转换格式查询。
 
+**Q: 在中国大陆能用吗？**
+
+A: 所有数据源均需要访问境外网站，在中国大陆必须配合代理（科学上网）才能正常使用。如果查询总是失败，可以用以下命令测试网络连通性：
+```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` 表示可以访问，返回 `000` 表示无法连接，需要检查代理设置。
+
 ---
 
 ## 数据来源

package/package.json

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