> 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/api-documentation/introduction/changelog.md).

# 變更日誌

Phalcon Compliance API 的所有重要變更均記錄於此。以下依時間倒序排列。

## 2026-07-16

新增 `riskProfile` 欄位作為風險資料的唯一事實來源，取代多個舊版欄位。

### 新增

| 欄位 / 結構描述                                                                                                             | 適用於                                              | 說明                                                                  |
| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------- |
| `riskProfile`                                                                                                         | `AddressScreenResult`, `TransactionScreenResult` | 結構化風險摘要，包含 `entityRisks`、`interactionRisks` 和 `behaviorRisks`。一律回傳。 |
| `taskId`                                                                                                              | 同步篩查回應                                           | 同步地址和交易回應現在會回傳 `taskId`。                                            |
| `note`                                                                                                                | `AddressScreenResult`, `TransactionScreenResult` | 使用者為地址或交易定義的備註。                                                     |
| `RiskProfile`, `EntityRisk`, `InteractionRisk`, `ExposurePart`, `ExposureTotal`, `BehaviorRisk`, `BehaviorRiskFields` | 新結構描述                                            | 用於支援 `riskProfile` 結構的結構描述。                                         |

### 已棄用

{% hint style="warning" %}
以下欄位預定於 **2026-08-31** 移除。請於此日期前遷移至 `riskProfile`。
{% endhint %}

| 欄位                                                                             | 適用於                       | 遷移方式                                                         |
| ------------------------------------------------------------------------------ | ------------------------- | ------------------------------------------------------------ |
| `includeDetails`                                                               | 請求參數                      | 不再需要 — 一律會回傳 `riskProfile`。                                  |
| `alerts[].riskDetail`                                                          | 回應                        | 改用 `riskProfile`。                                            |
| `isBlacklisted`, `blacklistedInfo`, `isWhitelisted`, `whitelistedInfo`         | `AddressScreenResult`     | 改用類型為 `blacklist` / `whitelist` 的 `riskProfile.entityRisks`。 |
| `fromIsBlacklisted`, `toIsBlacklisted`, `fromIsWhitelisted`, `toIsWhitelisted` | `TransactionScreenResult` | 改用 `riskProfile.entityRisks`。                                |

### 已移除

| 欄位                  | 說明              |
| ------------------- | --------------- |
| `enableReScreening` | 已從文件中完全移除此請求參數。 |

***

## 2026-04-29

棄用地址重新篩查參數，並移除相關狀態欄位。

### 已棄用

| 欄位                  | 適用於                  | 說明                     |
| ------------------- | -------------------- | ---------------------- |
| `enableReScreening` | `AddressScreen` 請求參數 | 為維持向後相容性而保留，但不會產生任何作用。 |

### 已移除

| 欄位                  | 說明                              |
| ------------------- | ------------------------------- |
| `reScreeningStatus` | 已從 `AddressScreenResult` 回應中移除。 |

***

## 2026-03-30

新增對 BTC 多輸入交易的支援。

### 新增

| 欄位              | 適用於                   | 說明                             |
| --------------- | --------------------- | ------------------------------ |
| `fromAddresses` | `TransactionTransfer` | BTC 交易的來源地址清單；此類交易可能由多個輸入提供資金。 |

### 變更

| 欄位                                | 說明                                                           |
| --------------------------------- | ------------------------------------------------------------ |
| `TransactionScreen.transferIndex` | 可獨立使用，也可與 `toAddress` 搭配使用。對於 BTC 交易，此欄位代表 `toAddressIndex`。 |
