網站控制與網站規則

透過黑白名單決定執行範圍，並以 per-site JSON 安全設定匹配、selector、版面、門檻與 CSS。

功能	位置	用途
網站控制	設定 → 一般	以黑名單或白名單允許/阻止擴充功能在整個主機執行。
網站規則	設定 → 網站規則	修改匹配頁面的解析、版面、過濾與樣式。

網站控制適合權限政策；擴充功能能運作但選錯節點、破壞行內文字、翻譯程式碼或需要專屬 CSS 時使用網站規則。

一般網站控制

黑名單模式在清單外執行，白名單模式只在清單內執行。此處只做主機名稱與子網域匹配：example.com 也匹配 news.example.com，不接受路徑或萬用字元。

網站規則 URL pattern

匹配時忽略 query string。

Pattern	匹配
`github.com`	該主機的 HTTP/HTTPS 頁面
`*.example.com`	根網域及所有子網域
`docs.example.com/guides/*`	指定 guides 路徑
`https://example.com/*`	僅 HTTPS
`www.amazon.*`	多個頂級網域的匹配主機
`javdb*.com`	`javdb` 後帶匹配文字的主機

scheme 可為 http、https 或 *，不允許明確連接埠。用 excludeMatches 排除寬泛規則中的頁面。

規則合併順序

Read Frog 先套用所有匹配且啟用的內建規則，再套用使用者規則；內建規則可依 ID 停用。

selector 清單按 base、.add、.remove 依序處理；
minCharacters、minWords 由最後匹配值覆寫；
injectedCss 與 injectedCss.add 依序串接；
無效 pattern 或 selector 會被略過並顯示警告。

陣列不是整體取代。用 .remove 撤銷先前 selector，用 .add 擴充。

欄位

每條規則需要唯一 id 和 matches。

欄位	含義
`description`	選用的人類可讀說明。
`matches` / `excludeMatches`	URL pattern 或陣列。
`enabled`	啟用或停用使用者規則。
`excludeSelectors` / `includeSelectors`	排除或明確納入節點。
`forceBlockSelectors` / `forceInlineSelectors`	強制區塊或行內版面。
`preserveTextSelectors`	保留匹配原文。
`minCharacters` / `minWords`	覆寫小段落門檻。
`injectedCss`	注入匹配頁面的 CSS。

selector 集合也支援 .add 和 .remove。

安全範例

[
  {
    "id": "example-docs",
    "description": "Translate article copy but leave navigation and code untouched.",
    "matches": ["docs.example.com/*"],
    "excludeSelectors": ["nav", "pre", "code", "[aria-label='Breadcrumb']"],
    "includeSelectors": ["main article"],
    "forceBlockSelectors": ["article p", "article li"],
    "preserveTextSelectors": [".product-name", ".command-name"],
    "minCharacters": 2,
    "minWords": 1,
    "injectedCss": ".read-frog-translated-content-wrapper { max-width: 100%; }"
  }
]

先在單一狹窄主機測試，儲存後重新載入頁面，再擴大 pattern。使用穩定語意屬性，避免容易變動的建置 class。

[
  {
    "id": "example-docs-adjustment",
    "matches": ["docs.example.com/*"],
    "excludeSelectors.add": [".sidebar-ad"],
    "excludeSelectors.remove": [".article-summary"],
    "forceInlineSelectors.add": [".term-with-tooltip"]
  }
]

整條內建規則都有問題時，直接停用比複製全部欄位可靠。

驗證與限制

編輯器會驗證 JSON、schema、重複 ID、selector、pattern、數量與大小。上限為 200 條使用者規則、65,536 字元 JSON，每個 CSS 值 8,192 字元。

注入 CSS 會在每個匹配頁面執行。保持 pattern 狹窄，且不要隱藏登入、安全或帳戶控制項。

排查時依序確認一般網站控制、matches、excludeMatches、selector 與 CSS，儲存後重新載入頁面。