TronLink Skills

概述

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

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

核心亮点： - 6 大技能，33 个命令，涵盖钱包、代币研究、市场数据、兑换、资源和质押 - 零 npm 依赖：使用原生 Node.js 18+ fetch 和 crypto，无需 npm install - 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, 零依赖)
    ├── 零 npm 依赖
    ├── TronGrid HTTP API（公共或带 API Key）
    └── Tronscan API 用于代币元数据
         |
         v
结构化 JSON → Agent 解读 → 自然语言回复

6 大技能详解

1. tron-wallet（6 个命令）

钱包查询与账户信息。

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

何时不要用： 发送 TRX / 代币——这些命令是只读的，请走 signer SDK 或 MCP Server TronLink。代币层面的深度分析（rug-pull / 流动性锁定）请用 tron-token。

2. tron-token（7 个命令）

代币研究与安全分析。

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

何时不要用： 单账户余额或交易历史——那是 tron-wallet 的活；实时价格/成交量——那是 tron-market 的活。

3. tron-market（8 个命令）

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

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

何时不要用： 立刻执行 swap 报价或路径——那是 tron-swap（会算上滑点）；静态代币元数据——tron-token。

4. tron-swap（3 个命令）

DEX 兑换报价与路由优化。

特点： 聚合多源流动性、估算能量成本、处理多跳路由。

何时不要用： 真正执行 swap——报价是只读的，实际兑换走 MCP Server TronLink（tl_chain_swap_v3）或 signer SDK；历史成交数据——tron-market。

5. tron-resource（6 个命令）

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

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

何时不要用： 真正冻结 TRX 获取能量/带宽——那是 Remote Write，请走 signer SDK / MCP Server；冻结后的 SR 投票策略——见 tron-staking。

6. tron-staking（3 个命令）

Stake 2.0 查询与 SR 信息。

特点： Stake 2.0 状态查询、APY 计算、SR 佣金追踪。

何时不要用： 执行 freeze / 投票 / 解冻动作——这些是 Remote Write，请走 signer SDK / MCP Server；单次操作能量成本——tron-resource。

Skill ↔ MCP 工具映射

scripts/mcp_server.mjs（即方式二的封装）将 33 个 CLI 命令中的 25 个 暴露为 MCP 工具——签名、输入字段、输出结构都由同一份 tron_api.mjs 实现派生，因此 CLI 与 MCP 工具保证等价。剩余 8 个 CLI-only 命令仍可通过方式一（skill 提示词）和方式三（直接 CLI）使用。需要按用户提问路由到具体工具，或核对 tools/list 输出时，请用下表。

汇总。 33 个 CLI 命令 · 25 个 MCP 工具 · 8 个仅 CLI 命令。所有命令都是只读——不签名、不广播、不动资金。若需执行交易，请路由到 MCP Server TronLink（tl_chain_*）或 signer SDK（sendTrx、sendTrc20、sign*）。

用户提问 → Skill → 工具路由

先按"问的是什么类"挑 skill，再按"问的是哪个字段"挑命令。常见提问对照：

若意图涉及改变链上状态（转账、执行 swap、freeze、投票、领奖），说明这里已不是合适的入口——请回看每个 skill 的"何时不要用"小节。

❌ 不要走这里（反例）

Skills 是只读的。如果用户意图涉及签名或 Remote Write，不要派发到 skill——底层命令会成功，但只是做了查询/估算，用户真正的目标并没有完成。这种意图请改路由到 signer SDK 或 mcp-server-tronlink：

判断口诀。 用户动词只要出现 send / freeze / unfreeze / vote / unvote / approve / swap（执行）/ claim / sign / broadcast，答案就不在这个 Skills 集里起步。Skills 仍然可以做前置（报价、估算成本、校验地址、查余额）——只是别声称"Skills 调用完成了用户的请求"。

推荐技能组合工作流

余额与代币查询

tron-wallet（查余额）→ tron-wallet（列出代币）→ tron-resource（检查能量状态）

研究与兑换报价

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

质押分析

tron-wallet（查余额）→ tron-staking（质押信息）→ tron-staking（APY 估算）→ tron-staking（SR 列表）

资源优化

tron-resource（检查状态）→ tron-resource（估算成本）→ tron-resource（optimize-cost）

TRON 资源模型参考

能量 vs. 带宽

成本示例

数据截至 2026-05。 能量数字会随合约升级（尤其是 USDT TRC-20）和网络参数变化；TRX 燃烧列用到的带宽/能量单价也会变。仅作量级参考，不是契约值。数据来源：TronGrid / Tronscan 交易采样与 TRON 网络参数。需要实时数值请用 tron-resource 的 estimate-energy / estimate-bandwidth 命令。

Stake 2.0 要点

• 冻结 TRX → 获取能量或带宽 → 投票给 SR → 赚取奖励
• 解冻需 14 天等待期 才能提取
• 解冻后投票重置；重新冻结后需重新投票
• 1 冻结 TRX ≈ 每天 4.5 能量——动态值：取决于全网总质押量；实时数请用 tron-resource estimate-energy。数据截至 2026-05。
• 投票奖励每 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 直接调用
# （逐项对照见上文 "Skill ↔ MCP 工具映射"；剩余 8 个命令仅 CLI 可用）

方式三：命令行直接使用

# 直接执行命令
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 平台

Cursor（Windsurf 配置同构）

~/.cursor/mcp.json:

{
  "mcpServers": {
    "tronlink-skills": {
      "command": "node",
      "args": ["/absolute/path/to/tronlink-skills/scripts/mcp_server.mjs"]
    }
  }
}

Codex CLI

# 将 skills 目录软链到 agent 发现路径
ln -s "$(pwd)/tronlink-skills" ~/.agents/skills/tronlink-skills
# 验证识别
codex skills list | grep tron

OpenCode

~/.config/opencode/config.json:

{
  "plugins": {
    "tronlink-skills": { "path": "/absolute/path/to/tronlink-skills" }
  }
}

LangChain / CrewAI（Python）

from langchain_core.tools import Tool
import subprocess, json

def tron_call(cmd: str) -> dict:
    out = subprocess.check_output(
        ["node", "scripts/tron_api.mjs", *cmd.split()],
        cwd="/absolute/path/to/tronlink-skills",
    )
    return json.loads(out)

tron_wallet_balance = Tool.from_function(
    func=lambda addr: tron_call(f"wallet-balance --address {addr}"),
    name="tron_wallet_balance",
    description="TRX 余额与冻结量，地址为 TRON Base58（T...）字符串。",
)

快速安装脚本

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

# 清洁卸载
bash uninstall.sh

配置说明

环境变量

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

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

网络支持

内置代币快捷符号

项目结构

tronlink-skills/
├── README.md                          # 主文档
├── package.json                       # Node.js 配置文件
├── install.sh                         # 全环境自动安装脚本
├── uninstall.sh                       # 清洁卸载脚本
│
├── scripts/
│   ├── tron_api.mjs                   # 主 CLI（33 个命令，零依赖）
│   └── 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地址...

版本与许可证

• 包： tronlink-skills v1.0.1
• 许可证： MIT —— SPDX-License-Identifier: MIT
• 变更记录 / 发布： https://github.com/TronLink/tronlink-skills/releases —— 截至当前 v1.0.x 尚无 GitHub tag 发布；打 tag 之前请直接看 commit 历史。

兼容性与迁移策略

Skills 已进入 v1.0.x，适用标准 semver——只有 major 升级允许破坏公开面。

• 稳定契约（minor / patch 不会动）：
  • 33 个 CLI 命令名与其必填 / 可选 flag（tron_api.mjs <command> [...]）。
  • Skill ↔ MCP 工具映射 列出的 25 个 MCP 工具名（tron_* 形式）及其 inputSchema 字段名。
  • Exit code：0 成功，1 查询错误 / 参数非法，2 未支持 / 未知命令。
  • Network Read 副作用分级——任何命令未经 major 升级都不会变成 Remote Write。
• 不稳定契约（minor 允许变化）：
  • JSON stdout 输出的具体字段——新增字段任意 minor 都允许；改名或删除属于 major。请用宽容解析。
  • 内置代币 symbol 快捷表（USDT、USDC、WTRX…）——minor 允许新增 symbol；已存在的映射 minor 不会重指。
  • 启发式与阈值（whale-transfers 默认阈值、optimize-cost 决策树权重等）。
• 子集关系。 MCP 工具子集（目前 25 / 33）可能在 minor 中 扩大（CLI-only 命令被新增为 MCP 工具）；不会在 minor 中 缩小。
• 废弃窗口。 被标 deprecated 的命令 / 工具至少在 一个 minor 周期 内继续可用，runtime 会在 stderr 打印 [DEPRECATED] 警告；移除最早发生在下一个 major。
• 升级后校验。 重新 tron_api.mjs --help，使用 MCP 时再跑 tools/list，确认依赖的名字仍在。MCP initialize 阶段返回的 serverInfo.version 应与升级后的 package.json 版本一致。