> For the complete documentation index, see [llms.txt](https://docs.catfee.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catfee.io/getting-started/real-time-collection.md).

# 实时归集

实时归集是 CatFee 面向 TRON 多地址收款、USDT 归集和热钱包整理场景提供的自动补能服务。

当您的收款地址达到归集条件时，CatFee 会按照预设规则为目标地址补充 TRON 能量，帮助后续 USDT 转账或归集脚本稳定执行。实时归集只负责补充能量，不接触私钥，不托管钱包，也不会替您转移 USDT、TRX 或其他资产。

## 适合谁使用

实时归集适合需要管理多个 TRON 收款地址，并希望降低人工补能、人工值守和归集失败成本的用户。

**商户收款归集**

适合电商、支付团队、OTC 商户等多地址收款场景。多个收款地址陆续收到 USDT 后，系统可在达到归集阈值时自动补能，减少人工判断能量和手动补能带来的处理延迟。

**钱包与交易所运营**

适合钱包、交易所和资金运营团队。热钱包整理、充值地址处理和内部地址池归集通常需要稳定执行，实时归集可帮助运营团队保留补能记录、费用记录和失败状态，方便后续核对。

**DApp 与链上工具**

适合支付工具、链上工具和内部系统开发者。当业务地址能量状态不稳定时，用户转账可能失败，自研监控和补能系统也会增加开发维护成本。实时归集可作为地址监控和补能执行层，降低接入复杂度。

**小额高频收款**

适合个人或小型团队管理大量小额收款地址的场景。地址数量多时，逐个检查余额和能量效率较低，使用规则触发补能可以减少重复操作。

> **已有归集脚本？**
>
> 通常不需要大幅改造。实时归集可以作为现有归集流程前的一层能量保障：CatFee 负责在规则命中时补能，归集转账仍由您的钱包、脚本或业务系统发起。

## 核心能力

* **规则监控**：按地址池配置触发条件，例如 USDT 余额达到指定阈值。
* **批量地址管理**：支持将多个收款地址放入同一规则统一管理，后续可按业务需要增删地址。
* **自动补能**：规则命中后为目标地址补充 TRON 能量，减少 USDT 转账因能量不足失败的概率。
* **预算控制**：可通过规则启停、单次补能数量和预算限制控制成本。
* **执行记录**：每次补能都会生成目标地址、能量数量、费用明细和执行状态，便于运营复盘和财务核对。
* **非托管边界**：不需要私钥，不控制钱包权限，不代转资产。

## 工作流程

### 1. 创建归集补能规则

在 CatFee Dashboard 中创建归集补能配置。创建配置时先设置基础规则，创建完成后再添加需要监控的收款地址。

常见配置项包括：

* **余额阈值（Balance Threshold）**：当监控地址的 USDT 余额大于或等于该阈值时，系统触发补能。例如设置为 `10`，表示地址余额达到 10 USDT 后触发补能。
* **补能数量（Energy Quantity）**：每次触发时补充的能量数量，最低为 65,000 Energy，可根据归集转账需要设置。
* **带宽保护（Bandwidth Protection）**：开启后会预留带宽，降低归集转账因带宽不足失败的概率。
* **备注（Remark）**：用于标记规则用途，例如主钱包归集、商户地址池或某个业务线。

创建配置后，需要继续添加监控地址。如果新增地址尚未激活，系统会自动激活该地址，并按 Dashboard 实际展示收取地址激活费用。

### 2. 导入收款地址

将需要监控的 TRON 收款地址导入规则。适合按业务线、商户、钱包地址池或归集批次分组管理。

导入后，系统会持续检查地址状态。您也可以根据业务变化新增、删除或调整地址。

### 3. 系统自动监控

规则启用后，CatFee 会持续检查地址是否达到触发条件。例如：

* 地址 USDT 余额达到 30 USDT、100 USDT 或其他自定义阈值。
* 地址进入需要归集的运营状态。
* 地址池中某个地址符合补能规则。

当前主要支持基于地址余额的触发条件。更多触发方式，例如时间触发、手动触发和组合规则，会以后续 Dashboard 实际能力为准。

### 4. 命中规则后自动补能

当地址满足条件时，系统会按照规则补充 TRON 能量。规则触发后，通常会在 1 个 TRON 区块内执行补能，约 3 秒。

补能完成后，您的归集脚本、钱包操作或内部系统即可继续发起 USDT 归集转账。

### 5. 查看记录和费用

每次补能都会生成执行记录，通常包含：

* 执行时间
* 目标地址
* 补能数量
* 补能费用
* 交易 Hash 或执行状态
* 成功、失败、余额不足等结果说明

规则未命中前不会产生补能订单。补能失败不会扣费，失败状态会保留在记录中，方便排查地址、余额、规则或网络状态。

## 配置示例

以下示例只用于理解配置思路，真实配置项和价格以 CatFee Dashboard 实际展示为准。

| 场景    | 触发条件          | 补能策略                     | 地址范围    | 余额要求             |
| ----- | ------------- | ------------------------ | ------- | ---------------- |
| 小额收款  | USDT 余额 ≥ 30  | 自定义补能数量，最低 65,000 Energy | 32 个地址  | 确保 CatFee 账户余额充足 |
| 商户归集  | USDT 余额 ≥ 100 | 自定义补能数量，最低 65,000 Energy | 128 个地址 | 确保 CatFee 账户余额充足 |
| 热钱包运营 | 业务余额达到运营阈值    | 自定义补能数量，最低 65,000 Energy | 500+ 地址 | 确保 CatFee 账户余额充足 |

## 费用与控制

实时归集按实际补能执行计费。规则命中前不会产生补能订单，规则暂停后也不会产生新的补能订单。

您可以通过以下方式控制成本：

* **暂停规则**：运营调整、活动结束或预算收紧时，可直接暂停规则。
* **控制单次补能数量**：根据转账类型选择合适的能量数量，避免过度补能。
* **查看执行记录**：通过目标地址、能量数量和费用明细核对成本。
* **关注账户余额**：账户余额不足时，Dashboard 会显示余额预警，建议及时充值，避免归集流程中断。

## 安全边界

实时归集只解决能量准备问题，不负责资产归集本身。

| 边界      | 说明                                          |
| ------- | ------------------------------------------- |
| 不需要私钥   | CatFee 不要求用户提交私钥，也不要求托管钱包                   |
| 不代转资产   | CatFee 只补充 TRON 能量，不代替用户发起 USDT、TRX 或其他资产转账 |
| 用户保留控制权 | 用户可以随时暂停、修改或删除规则，也可以调整地址列表和补能策略             |
| 记录可审计   | 补能结果和费用明细可用于运营复盘、财务核对和问题排查                  |

## 操作建议

1. 先梳理需要监控的收款地址，并按业务线或用途分组。
2. 根据归集策略设置 USDT 余额阈值，例如小额收款使用较低阈值，商户归集使用较高阈值。
3. 根据目标转账类型选择补能数量，例如 65,000 Energy 或 131,000 Energy。
4. 设置预算限制和余额提醒，避免账户余额不足导致补能失败。
5. 先用少量地址验证规则，再逐步扩大到完整地址池。
6. 定期导出或查看执行记录，用于运营复盘和成本核对。

## 常见问题

### 什么是 TRON 实时归集？

TRON 实时归集是 CatFee 面向 USDT 多地址收款和资金归集场景提供的自动补能能力。用户配置监控地址、余额阈值和补能规则后，当地址达到归集条件时，系统会为目标地址补充 TRON 能量，减少 USDT 转账因能量不足而失败或中断。

### CatFee 会控制我的钱包吗？

不会。实时归集是非托管服务，不需要私钥，也不会控制您的钱包权限。CatFee 只在规则命中时为目标地址补充 TRON 能量。

### 补能后会自动帮我归集 USDT 吗？

不会。实时归集只解决 TRON 能量准备问题，不负责转移资产。补能完成后，仍由您的钱包操作、归集脚本或内部系统发起 USDT 归集转账。

### 什么情况下会自动补能？

当您配置的 TRON 地址满足触发条件时会自动补能，例如 USDT 余额达到指定归集阈值。您可以在 Dashboard 中配置监控条件和补能策略。

### 补能需要多长时间？

规则触发后，系统通常会在 1 个 TRON 区块内执行补能，约 3 秒。能量到账后，您的 USDT 归集脚本或转账流程即可继续执行。

### 如果补能失败会怎样？

如果自动补能失败，系统会记录失败状态，并在 Dashboard 中展示执行结果，方便您排查地址、余额、规则或网络状态等问题。补能失败不会扣费。

### 是否支持批量导入地址？

支持。实时归集适合商户、钱包和交易所管理大量 TRON 收款地址。您可以通过 Dashboard 批量导入地址列表，并统一配置补能规则。

### 可以随时修改或删除规则吗？

可以。您可以随时暂停、修改或删除归集补能规则，也可以调整地址列表、USDT 余额阈值和补能数量。规则暂停后不会产生新的补能订单。

### 我已经有归集脚本，还需要改造吗？

通常不需要大幅改造。CatFee 归集补能可以作为现有 USDT 归集流程前的一层能量保障。补能完成后，继续由原有脚本、钱包或内部系统发起归集。如果需要 API 对接，请联系 CatFee 技术支持确认方案。