> 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/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`。 |
