docs: add domain group subscription guide for Apple Safari Extension users to README files

Author: piquark6046

README.ja.md

@@ -20,6 +20,22 @@ tinyShieldスクリプトは、AdblockコミュニティとAdGuardによって
 
 https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js
 
+### ドメイングループ購読ガイド (Apple Safari Extension ユーザー専用)
+> [!IMPORTANT]
+> 以下のドメイングループ購読URLは Apple Safari Extension ユーザーのみ使用してください。
+> AdGuard のユーザースクリプト機能を使う場合は、従来どおり基本URL (`dist/tinyShield.user.js`) を使用してください。
+
+- ビルド出力のファイル構成:
+    - 基本スクリプト: `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js`
+    - ドメイングループ別スクリプト: `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/tinyShield-<domain-group>.user.js`
+- ドメイングループごとの購読ファイル選択手順:
+    1. `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/` を開きます。
+    2. 利用しているサイトに対応する `tinyShield-<domain-group>.user.js` を1つ選びます。
+    3. そのファイルを一度開き、メタデータ `@match` に対象ドメインが含まれていることを確認します。
+    4. Safari のユーザースクリプト拡張には、そのファイルURLをそのまま購読URLとして登録します。
+
+このドメイングループ分割は、issue #38 の影響範囲を可能な限り最小化することを目的としています。
+
 ### インストールのやり方
 - [Violentmonkey](https://addons.mozilla.org/en-US/firefox/addon/violentmonkey/) (AdGuard Premiumにアクセスできない場合に推奨) - ブラウザー拡張
     1. `ダッシュボード`を開きます。
@@ -95,7 +111,7 @@ https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.use
         * iOS 18+: `システム設定` => `アプリ` => `Safari` => `拡張機能`
         * iOS 17 とそれ以下: `システム設定` => `Safari` => `拡張機能`
         **Usercripts**を見つけて有効化後に`他のサイト`の権限を許可します。
-    4. [tinyShield](https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js)のURLをブラウザで開きます。
+    4. `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/` をブラウザで開き、対象ドメインに対応するグループスクリプトURL (`tinyShield-<domain-group>.user.js`) を選択します。
     5. Safariのアドレスバーにある拡張機能アイコンを押して、Userscriptsを選択します。
     6. タップでインストールします。
     7. 開いたポップアップを下にスクロールでインストールボタンを押します。

README.ko.md

@@ -23,6 +23,22 @@ tinyShield 유저스크립트는 AdGuard와 애드블록 커뮤니티에 의해
 
 https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js
 
+### 도메인 그룹 구독 가이드 (Apple Safari Extension 사용자 전용)
+> [!IMPORTANT]
+> 아래 도메인 그룹 구독 URL은 Apple Safari Extension 사용자만 사용하십시오.
+> AdGuard 유저스크립트 기능 사용자는 기본 URL(`dist/tinyShield.user.js`)을 계속 사용하십시오.
+
+- 빌드 결과 파일 구조:
+  - 기본 스크립트: `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js`
+  - 도메인 그룹 스크립트: `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/tinyShield-<domain-group>.user.js`
+- 도메인 그룹별 구독 파일 선택 방법:
+  1. `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/`를 엽니다.
+  2. 사용하는 웹 사이트에 맞는 `tinyShield-<domain-group>.user.js` 파일 하나를 선택합니다.
+  3. 해당 파일을 한 번 열어 메타데이터 `@match`에 대상 도메인이 포함되어 있는지 확인합니다.
+  4. Safari 유저스크립트 확장에 그 파일 URL을 그대로 구독 URL로 등록합니다.
+
+이 도메인 그룹 분리는 issue #38의 영향 범위를 가능한 한 최소화하기 위한 목적입니다.
+
 ### 설치하는 법
 - [Violentmonkey](https://addons.mozilla.org/ko/firefox/addon/violentmonkey/) (AdGuard 프리미엄이 없다면 권장됨) - 브라우저 확장
   1. `Dashboard`를 엽니다.
@@ -56,7 +72,7 @@ https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.use
     * iOS 18 이상: `시스템 설정` => `앱` => `Safari` => `확장 프로그램`
     * iOS 17 이하: `시스템 설정` => `Safari` => `확장 프로그램`
     **Userscripts**을 찾으시고 활성화하신 후 `기타 웹 사이트` 권한을 허용하십시오.
-  3. Safari에서 [빠른 시작 세션에 있는 URL](https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js)을 클릭하십시오.
+  3. Safari에서 `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/`를 열고, 대상 도메인에 맞는 그룹 스크립트 URL(`tinyShield-<domain-group>.user.js`)을 선택하십시오.
   4. Safari의 주소바에 있는 확장 아이콘을 클릭하시고 **Userscripts**을 선택하십시오.
   5. 설치하는 버튼을 누르십시오.
   6. 열린 팝업을 스크롤하신 후에 설치하는 버튼을 누르십시오.

README.md

@@ -23,6 +23,22 @@ Just click the following URL to detect this userscript.
 
 https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js
 
+### Domain Group Subscription Guide (Apple Safari Extension Only)
+> [!IMPORTANT]
+> The grouped subscription URLs below are only for Apple Safari Extension users.
+> If you use AdGuard's userscript support, keep using the default URL (`dist/tinyShield.user.js`).
+
+- Build output structure:
+    - Default script: `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js`
+    - Domain-grouped scripts: `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/tinyShield-<domain-group>.user.js`
+- How to choose the subscription file for your domain group:
+    1. Open `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/`.
+    2. Select one `tinyShield-<domain-group>.user.js` file for the website you use.
+    3. Open that file once and confirm its metadata `@match` includes your target domain.
+    4. Subscribe to that exact grouped file URL in your Safari userscript extension.
+
+This domain-group split is intended to reduce the impact scope of issue #38 as much as possible.
+
 ### How to install
 - [Violentmonkey](https://addons.mozilla.org/en-US/firefox/addon/violentmonkey/) (Recommended if you cannot access AdGuard Premium) - Browser extension
     1. Open `Dashboard`.
@@ -98,7 +114,7 @@ https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.use
         * iOS 18+: `System settings` => `Apps` => `Safari` => `Extensions`
         * iOS 17 and older: `System settings` => `Safari` => `Extensions`
         Find **Usercripts**, enable it and allow `On other sites` permission
-    3. Open the [tinyShield](https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/tinyShield.user.js) userscript URL in browser
+    3. Open `https://cdn.jsdelivr.net/npm/@filteringdev/tinyshield@latest/dist/grouped/` in browser and select the grouped userscript URL for your domain (`tinyShield-<domain-group>.user.js`)
     4. Press the extensions icon in the address bar of Safari and select Userscripts 
     5. Tap to install
     5. In opened popup, scroll down and press Install button