name: aavegotchi-traits description: 从Base主网通过gotchi ID或名称检索Aavegotchi NFT数据。获取特征（BRS、亲密度、经验值、能量、攻击性、幽灵度、脑容量、眼型、眼色）、已装备的穿戴品、幽灵编号、等级和年龄。当用户询问Base链上特定Aavegotchi的统计数据、特征、穿戴品、稀有度分数或任何gotchi特定信息时使用。支持通过The Graph子图（当可用时）或链上回退进行即时ID查找和名称搜索。

Aavegotchi 特征

获取Base主网上Aavegotchi NFT的详细链上数据，可选择子图支持以实现即时名称查找。

快速开始

通过ID或名称获取gotchi的数据：

# 通过ID
cd scripts && node get-gotchi.js 9638  # aaigotchi

# 通过名称
cd scripts && node get-gotchi.js "aaigotchi"

脚本输出：

人类可读的格式化显示
用于编程的JSON对象

子图支持 (The Graph)

此技能包含 The Graph子图集成 以实现即时名称查找：

当前状态 (2026年2月)

⚠️ 目前尚无Base子图可用。 Aavegotchi于2025年7月迁移到Base，但官方子图尚未部署。脚本会自动回退到链上扫描。

当子图可用时

通过环境变量设置子图端点：

export AAVEGOTCHI_SUBGRAPH_URL=https://api.thegraph.com/subgraphs/name/aavegotchi/aavegotchi-base

或在您的shell配置中（~/.bashrc, ~/.zshrc）：

echo 'export AAVEGOTCHI_SUBGRAPH_URL=https://api.thegraph.com/subgraphs/name/aavegotchi/aavegotchi-base' >> ~/.bashrc
source ~/.bashrc

配置子图后：

名称查找： 即时（GraphQL查询）
ID查找： 仍使用链上查询（对于完整特征数据最可靠）

查找策略

ID查找 (#9638 - aaigotchi)
  └─> 直接链上查询（即时）

名称查找 ("aaigotchi" - #9638)  
  ├─> 尝试子图（即时，如果可用）
  └─> 回退到链上扫描（30-60秒）

获取内容

对于任何Aavegotchi代币ID，脚本会检索：

核心统计：

基础稀有度分数 (BRS)
修正稀有度分数（包含穿戴品加成）
亲密度等级
经验值 (XP)
等级

特征（6个数值）：

⚡ 能量 (NRG)
💥 攻击性 (AGG)
👻 幽灵度 (SPK)
🧠 脑容量 (BRN)
👁️ 眼型 (EYS)
🎨 眼色 (EYC)

每个特征都显示基础和修正（包含穿戴品）值。

穿戴品：

所有已装备穿戴品的列表，包含ID和名称
格式：ID: 名称（例如：“50: GldnXross Robe”）
过滤掉空槽位
包含已装备物品数量

身份信息：

代币ID
名称（如果已设置）
所有者地址
幽灵编号

质押信息：

抵押代币地址
质押金额
最后交互时间戳
年龄（自上次交互以来的天数）

使用方法

通过Gotchi ID

cd scripts && node get-gotchi.js 9638  # aaigotchi

通过名称

cd scripts && node get-gotchi.js "aaigotchi"
cd scripts && node get-gotchi.js "Slide"
cd scripts && node get-gotchi.js "XIBOT"

性能：

使用子图（当可用时）：即时 ⚡
不使用子图（当前）：30-60秒（链上扫描所有gotchi）

💡 提示： 尽可能使用gotchi ID以保证即时结果。

示例输出

============================================================
AAVEGOTCHI #9638: aaigotchi
============================================================
所有者: 0x8BE974bC760bea450A733c58B051c14F723ce79C
幽灵: 1
等级: 8
年龄: 自上次交互后 0 天

分数:
  基础稀有度分数 (BRS): 475
  修正稀有度分数: 475
  亲密度: 2276
  经验值: 2960

特征:
  ⚡ 能量: 0
  💥 攻击性: 66
  👻 幽灵度: 99
  🧠 脑容量: 76
  👁️ 眼型: 41
  🎨 眼色: 28

穿戴品:
  已装备 (1):
    210: Haunt 1 Background

质押:
  抵押品: 0x20D3922b4a1A8560E1aC99FBA4faDe0c849e2142
  质押金额: 0.0 代币
  最后交互: 2026-02-12T18:30:13.000Z
============================================================

JSON输出:
{
  "tokenId": "9638",
  "name": "aaigotchi",
  ...
}

合约详情

合约： 0xa99c4b08201f2913db8d28e71d020c4298f29dbf (Base主网)

网络： Base (链ID: 8453)

RPC： https://mainnet.base.org

理解数据

有关特征、BRS、亲密度、穿戴品、幽灵和其他Aavegotchi机制的详细解释：

参见： references/aavegotchi-data.md

要求

Node.js (v18+)
npm包：ethers, node-fetch（通过package.json安装）
网络连接（查询Base RPC和可选的The Graph）
穿戴品数据文件（已包含：wearables-data.json，包含400+物品）

依赖项和数据文件已预装在技能的scripts目录中。

故障排除

“无效代币ID”错误：

Gotchi在Base上不存在
验证ID是否正确

网络错误：

检查网络连接
Base RPC可能暂时宕机
稍后再试

名称查找耗时过长：

使用子图时： 检查AAVEGOTCHI_SUBGRAPH_URL是否正确设置
不使用子图时（当前）： 名称搜索会顺序扫描所有23,000+个gotchi（30-60秒）
使用gotchi ID以获得即时结果
确保网络连接稳定

“子图不可用”消息：

预期行为（尚未部署Base子图）
脚本自动回退到链上扫描
无需操作

未来增强

潜在的添加功能：

✅ The Graph子图支持（已实现，等待Base子图部署）
✅ 穿戴品名称解析（已实现：映射了400+个穿戴品）
多个gotchi的批量查询
历史特征/亲密度追踪
穿戴品稀有度/统计数据展示
口袋/库存查询
公会/借贷数据
实时抚摸状态
特征稀有度百分位数