> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/zh-hant/user-manual/configure/risk-engines/lists.md).

# 清單

「清單」分頁提供風險偵測所用所有地址清單的統一管理功能。提供三種類型的清單：

| 類型        | 說明                               | 預先建立     | 可編輯       |
| --------- | -------------------------------- | -------- | --------- |
| **黑名單**   | 自動標記為嚴重風險的地址。略過所有規則。             | 是（全域黑名單） | 僅可新增／移除地址 |
| **白名單**   | 自動標記為無風險的地址、實體或類別。略過所有規則。        | 是（全域白名單） | 僅可新增／移除項目 |
| **規則白名單** | 將特定地址、實體或類別豁免於特定規則之外。其他規則仍會照常評估。 | 否（使用者建立） | 完整控制      |

<figure><img src="https://2458772471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLWwO7vpr6nNW5dAF9VOK%2Fuploads%2Fgit-blob-8c24635088443587929a02a632d73d81344858a5%2Frisk-engine-lists-tab.png?alt=media" alt="Lists tab showing Blacklist, Whitelist, and Rule Whitelist"><figcaption></figcaption></figure>

{% hint style="info" %}
\*\*評估優先順序：\*\*黑名單／白名單 → 規則白名單 → 風險引擎規則。黑名單或白名單上的地址會略過所有規則；規則白名單只會略過指定規則。
{% endhint %}

## 黑名單

全域黑名單會預先建立，且無法刪除。列入黑名單的地址會自動標記為**嚴重**風險，並略過所有規則評估。

* **項目類型**：僅限地址
* **篩查費用**：黑名單比對不會消耗篩查額度。

您可以逐一新增地址，或匯入 CSV 檔案（每行一個地址，並可選擇在第二欄加入標籤）。匯入後，Phalcon 會回報成功、失敗或略過的地址數量及原因。

## 白名單

全域白名單會預先建立，且無法刪除。列入白名單的項目會自動標記為**無風險**，並略過所有規則評估。

* **項目類型**：地址、實體或類別
* **篩查費用**：白名單比對不會消耗篩查額度。

### 項目類型

* **地址** — 單一鏈上地址。完全比對。
* **實體** — 實體（例如 Binance）。自動包含已知屬於該實體的所有地址。
* **類別** — 類別（例如 CEX）。自動包含該類別中的所有實體及其地址。

實體和類別的地址集合由 BlockSec 的標籤資料庫維護 — 您不必管理個別地址。搜尋類別或實體名稱即可新增。

{% hint style="info" %}
同一地址可以列入黑名單或白名單，但不能同時列入兩者。列入白名單的實體或類別仍可能涵蓋您黑名單上的地址。Phalcon 不會阻止這種情況 — 黑名單優先，因此該地址仍會標記為嚴重風險。
{% endhint %}

## 規則白名單

規則白名單可讓您將特定項目豁免於特定規則之外。與全域白名單不同，規則白名單只會略過您指定的規則 — 所有其他規則仍會照常評估。

{% hint style="warning" %}
規則白名單適用於 **Scale** 方案及以上方案。
{% endhint %}

由於其餘規則仍會執行，規則白名單比對到的地址仍會照常消耗篩查額度。

### 建立規則白名單

建立清單時需要輸入名稱，也可以選擇要略過的規則 — 您可以先不選擇規則，之後再進行設定。建立表單不包含項目：清單建立後，請開啟其詳細資料頁面以新增地址、實體和類別。

<figure><img src="https://2458772471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLWwO7vpr6nNW5dAF9VOK%2Fuploads%2Fgit-blob-b84f5761081cb699bf2f5fe48d85c5825cdb1510%2Frisk-engine-create-rule-whitelist.png?alt=media" alt="Create Rule Whitelist dialog"><figcaption></figcaption></figure>

### 規則白名單詳細資料

詳細資料頁面分為三個部分：

* **詳細資料** — 清單類型、建立資訊及項目數量。
* **要略過的規則** — 此白名單會略過的規則，可隨時編輯。如果規則遭到刪除，系統會自動將其從此清單中移除。
* **項目** — 此清單中的地址、實體和類別。您可以在此搜尋、新增、匯入或移除項目。

如果清單中的實體已不在標籤資料庫中，該實體會以灰色顯示，方便您決定是否移除。

### 規則白名單如何影響篩查

篩查地址或交易時：

* 如果地址（或其所屬的實體／類別）列在規則白名單中，系統會完全略過指定規則 — 這些規則不會出現在篩查結果中，無論是以略過或未觸發的狀態呈現都不會。
* 所有其他規則都會照常評估。

如要查看哪些規則白名單豁免了特定規則，請開啟該規則的[規則詳細資料](https://docs.compliance.phalcon.blocksec.com/zh-hant/user-manual/configure/risk-engines.md#rule-detail)頁面。
