aavegotchi-traits

该技能用于查询 Base 主网上的 Aavegotchi NFT 详细链上数据，支持通过 Gotchi ID 或名称检索，可获取包括基础稀有度评分（BRS）、亲密度（Kinship）、经验值（XP）、六大特性值（Energy、Aggression 等）以及装备穿戴情况在内的完整数据。

核心用法上，用户可通过 Node.js 脚本调用，支持两种查询模式：直接通过 Token ID 进行链上查询（即时响应），或通过名称搜索（当前因 Base subgraph 尚未部署需全量扫描，耗时 30-60 秒，未来可通过 The Graph 实现即时检索）。脚本输出包含人类可读的格式化展示和 JSON 结构化数据，便于程序化使用。

显著优点在于数据维度全面，不仅展示基础特性值，还计算装备加成后的修正值，并解析 400 余种可穿戴装备的具体名称。同时，技能设计具备前瞻性，已预留 The Graph subgraph 接口，待官方部署后即可实现毫秒级名称查询。文档结构清晰，包含完整的故障排查指南和合约信息透明度。

潜在局限性包括当前 Base 链尚无官方 subgraph，导致名称查询需遍历全部 23,000+ 个 Gotchi，性能较差；该技能本身为纯文档型资产，实际查询功能依赖外部脚本文件（get-gotchi.js），而脚本未包含在技能包中需单独获取；此外，查询依赖 Base 公共 RPC 节点，在网络拥堵时可能影响稳定性。

适合的目标群体主要是 Aavegotchi 游戏玩家、NFT 收藏者以及 GameFi 数据分析师。对于需要批量查询资产特性、评估稀有度或追踪装备搭配策略的用户尤为实用。开发者也可参考其合约交互逻辑（0xa99c4b...dbf）进行二次开发。

使用风险方面，除性能瓶颈外，需注意来源可信度为 T3 级（个人/社区来源），虽文档本身安全但引用的脚本需自行验证。依赖项包括 ethers.js 和 node-fetch，需确保 Node.js v18+ 环境。另外，查询过程会暴露用户 IP 至 Base RPC 和潜在的 The Graph 服务端，对隐私敏感用户需考虑使用私有 RPC。

核心功能

Aavegotchi Traits是一款专注于Base主网Aavegotchi NFT生态的数据查询Skill，提供深度的链上数据分析能力。用户可通过Gotchi ID（即时响应）或名称（支持子图加速）检索任意Aavegotchi的完整档案，包括：

稀有度与成长指标

• Base Rarity Score (BRS) 基础与装备修正后的稀有度评分
• Kinship亲密度等级、XP经验值、角色等级
• 质押 collateral 金额与最后互动时间戳

六维特质系统
涵盖Energy (NRG)、Aggression (AGG)、Spookiness (SPK)、Brain Size (BRN)、Eye Shape (EYS)、Eye Color (EYC) 六个核心属性，每项均显示基础值与装备加成后的修正值。

装备与身份

• 已装备可穿戴装备列表（400+装备数据库映射）
• Haunt批次编号、Token ID、自定义名称、持有者地址

显著优势

1. 双轨查询架构：优先使用The Graph子图实现名称秒级解析，无子图时自动降级为链上扫描，保障功能可用性
2. 纯链上数据源：直接读取Base主网合约（0xa99c4b08...），数据真实可验证，无中心化服务器篡改风险
3. 开发者友好：同时输出格式化终端展示与结构化JSON，便于集成至分析脚本或前端应用
4. 前瞻性设计：子图端点已通过环境变量预留配置，待Aavegotchi官方Base子图部署后即可无缝升级

局限性与注意事项

⚠️ 当前关键限制：Aavegotchi于2025年7月迁移至Base后，官方尚未部署Base子图，导致名称查询需遍历全部23,000+枚Gotchi，耗时30-60秒。强烈建议优先使用ID查询以获得即时响应。

其他约束：

• 依赖外部RPC节点（https://mainnet.base.org）与The Graph的可用性
• 不包含历史数据追踪、批量查询、公会/租赁状态等进阶功能（列入未来增强计划）
• 文档中提及的Node.js脚本实现尚未随Skill附带，当前主要为接口规范文档

适用人群

• Aavegotchi持有者：快速检查Gotchi状态、评估稀有度、规划装备策略
• NFT交易者：验证链上真实数据，交叉核对市场列表信息
• GameFi分析师：提取结构化数据进行生态研究与估值建模
• Base生态开发者：学习NFT数据索引与The Graph集成范式

风险提示

• 区块链数据读取本身无资金风险，但需注意勿将本Skill用于任何需要私钥签名的场景
• 合约地址与RPC端点已硬编码为官方渠道，但仍建议用户二次核对
• 子图可用性状态可能随Aavegotchi官方进度变化，需关注文档更新