TronLink Skills

概述

GitHub: https://github.com/TronLink/tronlink-skills

TronLink Wallet Skills 是一套 AI Agent 技能集，通过自然语言提供完整的 TRON 区块链钱包和 DeFi 功能。专为 Claude Code、Cursor、OpenCode、Codex CLI 及其他 AI 代理设计。

核心亮点： - 6 大技能，41 个命令，涵盖钱包、代币研究、市场数据、兑换、资源和质押 - 零 npm 依赖：所有只读操作使用原生 Node.js 18+ fetch 和 crypto - TRON 专属领域知识 — 专门处理能量 + 带宽资源模型 - 多平台支持 — Claude Code、Cursor、OpenCode、Codex CLI、LangChain/CrewAI - 人工确认机制：所有涉及资金移动的操作需用户确认 - MCP 服务封装：为结构化 AI 代理集成提供标准接口

为什么需要 TronLink Skills？

TRON 的费用模型与 EVM 链有根本性不同。TRON 不使用统一的 Gas，而是使用能量（用于智能合约）和带宽（用于所有交易）。现有的 AI Agent 技能集均未覆盖：

• TRON 独特的资源模型和成本优化策略
• Stake 2.0（冻结 TRX 获取资源并赚取奖励）
• 超级代表（SR）投票机制
• 跨 SunSwap V2/V3 和 Sun.io 的 DEX 聚合
• 14 天解冻等待期及其影响

TronLink Skills 以深度 TRON 领域知识填补了这一空白。

架构设计

自然语言输入
         |
         v
AI 代理 (Claude Code / Cursor / OpenCode / 自定义)
         |
         v
tron_api.mjs (Node.js 18+, 原生 fetch, 1,248 行)
    ├── 只读操作零依赖
    ├── 可选: tronweb 用于签名
    ├── TronGrid HTTP API（公共或带 API Key）
    └── Tronscan API 用于代币元数据
         |
         v
结构化 JSON → Agent 解读 → 自然语言回复

6 大技能详解

1. tron-wallet（8 个命令）

钱包管理与基础操作。

特点： 同时支持 Base58Check（T...）和 hex 地址格式，内置常用代币符号，自动转换精度。

2. tron-token（7 个命令）

代币研究与安全分析。

特点： 检测 Rug Pull、分析持有者集中度、检查流动性锁定。

3. tron-market（8 个命令）

实时市场数据和巨鲸监控。

特点： 多 DEX 聚合、智能资金信号检测、K 线分析。

4. tron-swap（5 个命令）

DEX 交易与兑换执行。

特点： 聚合多源流动性、估算能量成本、处理多跳路由、强制人工确认。

5. tron-resource（7 个命令）

能量与带宽管理 — TRON 专属。

特点： 成本优化决策树逻辑、追踪每日免费带宽、计算 TRX 燃烧等值。

6. tron-staking（8 个命令）

Stake 2.0 和 SR 投票。

特点： 完整 Stake 2.0 支持、14 天解锁管理、APY 计算、SR 佣金追踪。

推荐技能组合工作流

查余额 & 转账

tron-wallet（查余额）→ tron-resource（估算能量）→ tron-wallet（发送）

研究 & 买入

tron-token（搜索）→ tron-market（价格/K线）→ tron-resource（检查能量）→ tron-swap（执行）

质押流程

tron-wallet（查余额）→ tron-staking（冻结）→ tron-staking（投票）→ tron-staking（领奖）

资源优化

tron-resource（检查状态）→ tron-resource（估算成本）→ tron-staking（冻结）或 tron-resource（租赁）

TRON 资源模型参考

能量 vs. 带宽

成本示例

Stake 2.0 要点

• 冻结 TRX → 获取能量或带宽 → 投票给 SR → 赚取奖励
• 解冻需 14 天等待期 才能提取
• 解冻后投票重置；重新冻结后需重新投票
• 1 冻结 TRX ≈ 每天 4.5 能量
• 投票奖励每 6 小时可领取一次

集成方式

方式一：Claude Code（推荐）

# 克隆后直接使用
git clone <repo>
cd tronlink-skills
claude   # 自动发现 SKILL.md 文件

只读操作无需 npm install。

方式二：MCP 服务器

# 注册为 MCP 服务器
claude mcp add tronlink -- node ~/.tronlink-skills/scripts/mcp_server.mjs

# 提供 25 个 MCP 工具，可被 Claude Desktop / Claude Code 直接调用

方式三：命令行直接使用

# 直接执行命令
node scripts/tron_api.mjs wallet-balance --address T地址...
node scripts/tron_api.mjs token-price --token USDT
node scripts/tron_api.mjs swap-quote --from TRX --to USDT --amount 100

方式四：其他 AI 平台

快速安装脚本

# 自动安装到所有 AI 环境
bash install.sh

# 清洁卸载
bash uninstall.sh

配置说明

环境变量

# 可选：TronGrid API Key，获取更高请求频率
export TRONGRID_API_KEY="your-api-key"

# 可选：切换网络（默认：mainnet）
export TRON_NETWORK="mainnet"    # 或 "shasta" / "nile"

# 签名操作（二选一）：
export TRON_PRIVATE_KEY="你的十六进制私钥"
# 或
export TRON_PRIVATE_KEY_FILE="/path/to/keyfile.txt"

网络支持

内置代币快捷符号

项目结构

tronlink-skills/
├── README.md                          # 主文档
├── package.json                       # Node.js 配置文件
├── install.sh                         # 全环境自动安装脚本
├── uninstall.sh                       # 清洁卸载脚本
│
├── scripts/
│   ├── tron_api.mjs                   # 主 CLI（1,248 行，41 个命令）
│   └── mcp_server.mjs                 # MCP 协议服务封装
│
├── skills/                            # 技能定义（自动发现）
│   ├── tron-wallet/SKILL.md
│   ├── tron-token/SKILL.md
│   ├── tron-market/SKILL.md
│   ├── tron-swap/SKILL.md
│   ├── tron-resource/SKILL.md
│   └── tron-staking/SKILL.md
│
├── docs/
│   ├── claude-integration-guide.md    # 3 种集成方式
│   ├── resource-model.md              # 能量与带宽深度解析
│   ├── staking-guide.md               # Stake 2.0 与 APY 说明
│   └── integration-guide.sh
│
├── .claude-plugin/                    # Claude Code 插件配置
├── .cursor-plugin/                    # Cursor IDE 插件配置
├── .opencode/                         # OpenCode 配置
├── .codex/                            # Codex CLI 安装说明
├── .claude/                           # 预配置测试命令
├── _meta.json                         # 技能注册元数据
└── LICENSE                            # MIT

依赖项

安全模型

地址格式支持

所有命令均支持并自动归一化两种格式：

关键设计决策

1. 默认零依赖 — 只读操作无需 npm install，对 AI Agent 而言轻量且即时
2. 资金操作人工确认 — 所有移动资金的交易需要明确的用户确认
3. TRON 专属领域知识 — 为能量/带宽和 Stake 2.0 提供专门技能，尊重 TRON 独特架构
4. 多格式地址支持 — 透明处理 Base58Check 和 hex 两种格式
5. 代币符号解析 — 常用代币有内置快捷方式；未知合约可直接使用地址
6. 成本优化建议 — optimize-cost 命令提供个性化策略
7. MCP 服务封装 — 为 Claude Desktop 和现代 AI Agent 提供结构化集成

快速开始

# 1. 克隆
git clone <repo>
cd tronlink-skills

# 2. 配合 Claude Code 使用（只读操作无需安装）
claude
> "查一下 T地址... 的 TRX 余额"
> "展示 TRON 上最热门的代币"
> "发送 USDT 需要多少能量？"
> "获取能量最好的方式是什么——冻结、租赁还是燃烧？"

# 3. 或直接使用命令行
node scripts/tron_api.mjs wallet-balance --address T地址...
node scripts/tron_api.mjs token-price --token USDT
node scripts/tron_api.mjs optimize-cost --address T地址...