跳到主要内容

什么是 AI Agent

AI Agent 是一个链下自动化程序，代表你的文明自动执行游戏操作。Agent 通过权限位掩码获得你的授权，在策略约束范围内操作。

Agent 能做什么​

Agent 通过授权权限控制可执行的操作：

权限位值操作
COLLECT1采集能源
REPAIR2修复系统
CLAIM_COMBAT8领取战斗能源
ATTACK32攻击
UPGRADE64升级系统
JUMP128空间跳跃
REBUILD256重建文明
DONATE512捐赠图腾

你可以授予 Agent 任意权限组合（位掩码）。

策略约束（Policy）​

除了权限控制，你还可以为 Agent 设置策略约束：

约束说明
minEnergyReserve最低能源保留量（Agent 不会消耗到低于此值）
minDftReserve最低 SES 保留量
maxAttackPerHour每小时最大攻击次数
maxUpgradePerDay每天最大升级次数
maxSingleUpgradeCost单次升级最大 SES 消耗
autoCollect是否自动采集
autoRepair是否自动修复
autoShieldRepair是否自动修复护盾
autoUpgrade是否自动升级
autoAttack是否自动攻击

安全机制​

1. 链上注册​

Agent 的策略存储在 SilentExpanseStrifeAgentRegistry.sol 合约中，一旦设置不可篡改。

2. 权限分离​

  • 授权（Authorize）：你授权 Agent 代你执行操作
  • 权限位掩码：精确控制每个操作
  • 可随时撤销：revokeAgent() 立即失效

3. 熔断限制​

攻击频率限制：每小时最多 N 次
升级频率限制：每天最多 N 次
能源保留底线：不低于 X
SES 保留底线：不低于 Y

4. 黑名单/白名单​

  • 黑名单：禁止攻击指定玩家
  • 白名单：只允许攻击指定玩家（开启白名单后黑名单失效）

两阶段架构​

┌─────────────────────────────────────┐
│          链下 Agent                 │
│  ┌──────────────────────────────┐   │
│  │ 策略引擎（YAML 配置文件）      │   │
│  │ 四种预设策略                  │   │
│  │ 自定义策略模板                │   │
│  └──────────┬───────────────────┘   │
│             │ 通过合约调用          │
│             ▼                      │
│  ┌──────────────────────────────┐   │
│  │ Agent SDK                    │   │
│  │ 调用合约方法（只读/写入）      │   │
│  └──────────────────────────────┘   │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│    链上 SilentExpanseStrifeAgentRegistry     │
│  ┌──────────────────────────────┐   │
│  │ 权限位掩码检查               │   │
│  │ 策略约束检查                 │   │
│  │ 频率限制检查                 │   │
│  └──────────────────────────────┘   │
└─────────────────────────────────────┘

Agent vs 手动操作​

对比手动操作AI Agent
在线要求需要经常在线24/7 运行
响应速度有延迟即时
操作精度可能出错严格按策略
安全私钥在钱包加密存储 + 链上约束

推荐下一步：5 分钟快速配置 →