@tronscanteam/cli 1.0.0

package/.env.example

@@ -0,0 +1 @@
+TRONSCAN_API_KEY=your_api_key_here

package/README.md

@@ -0,0 +1,111 @@
+# TronScan CLI
+
+[中文文档](README_CN.md)
+
+A CLI tool built on [TronScan API](https://docs.tronscan.org/), providing 80+ subcommands covering tokens, search, blocks, accounts, governance, transactions, statistics, contracts, security, deep analysis, stablecoins, and more.
+
+Two ways to use: **`ts` in the terminal** (after global install) and **natural language in AI IDEs** ([Claude Code](https://claude.ai/code), [Cursor](https://cursor.com), VS Code Copilot, etc.).
+
+## Install (global `ts` command)
+
+```bash
+git clone https://github.com/sshnii/tronscan-cli.git
+cd tronscan-cli
+npm install
+cp .env.example .env
+# Edit .env and set TRONSCAN_API_KEY
+```
+
+Get your API Key: https://docs.tronscan.org/zh/api/api-keys
+
+Register **`ts`** on your machine (use either one):
+
+```bash
+npm link
+# or
+npm install -g .
+```
+
+The CLI loads `.env` from the **cloned project root** (same folder as `package.json`). Keep your API Key there; you can run `ts` from any working directory.
+
+## Usage
+
+### 1. In the terminal
+
+After installing `ts` globally, run commands directly (`ts help` lists all subcommands):
+
+```bash
+ts help                         # list all subcommands
+ts token usdt                   # token info
+ts search usdt                  # search
+ts block                        # latest block
+ts tps                          # current TPS
+ts account TXxx...              # account details
+ts tx af949...                  # transaction by hash
+ts transfer-trc20 TXxx...       # TRC20 transfers
+ts security-account TXxx...     # account risk check
+```
+
+### 2. In AI IDEs
+
+Open this repo as your working directory and describe what you need in natural language. The AI reads the rule files, infers intent, picks the right API, and interprets the response.
+
+Built-in rule files:
+
+| AI IDE | Rule File |
+|--------|-----------|
+| Claude Code | `CLAUDE.md` |
+| Cursor | `.cursorrules` |
+| VS Code Copilot | `.github/copilot-instructions.md` |
+
+Example using Claude Code:
+
+```
+You: Look up USDT token info
+AI:  Runs ts token usdt and summarizes key fields (price, supply, holders, etc.)
+
+You: Show account details for TXxx...
+AI:  Runs ts account TXxx... and interprets balance, resources, and related fields
+
+You: What's the TRON network overview?
+AI:  Runs ts overview and summarizes the bundled network stats
+
+You: What's the latest block?
+AI:  Runs ts block and summarizes the latest block (or height and key fields)
+
+You: What's the current TPS?
+AI:  Runs ts tps and returns the result
+```
+
+No need to memorize commands or API paths — the AI matches the best endpoint from 80+ APIs in `api-reference.md`.
+
+## Dependencies
+
+- [Node.js](https://nodejs.org/) >= 18
+
+## Command Categories
+
+| Category | Count | Description |
+|----------|-------|-------------|
+| Token | 7 | Token details, holders, price, list, distribution |
+| Search | 2 | Search, trending tokens |
+| Overview | 3 | TPS, TRON network overview, nodes |
+| Block | 1 | Latest or specific block |
+| Account | 11 | Balance, holdings, resources, approvals, votes, analysis |
+| Super Representative | 4 | SR list, votes, chain parameters, proposals |
+| Transaction | 10 | Transaction details, transfers (TRX/TRC20/TRC721/TRC1155) |
+| Statistics | 19 | TRX supply, transaction trends, active accounts, energy, DeFi TVL |
+| Contract | 10 | Contract details, callers, energy consumption, daily analysis |
+| Security | 6 | Account/token/URL/transaction risk detection, authorization check |
+| Deep Analysis | 4 | Related accounts, fund flow, large transactions |
+| Stablecoin | 11 | Holder distribution, top holders, mint/burn, liquidity pools |
+
+Run `ts help` for the full command list.
+
+## API Reference
+
+See [api-reference.md](api-reference.md) for the complete API endpoint list.
+
+## License
+
+MIT

package/README_CN.md

@@ -0,0 +1,111 @@
+# TronScan CLI
+
+[English](README.md)
+
+基于 [TronScan API](https://docs.tronscan.org/) 的命令行工具，80+ 子命令覆盖代币、搜索、区块、账户、治理、交易、统计、合约、安全、深度分析、稳定币等场景。
+
+支持两种使用方式：**终端全局命令 `ts`** 和 **在 AI IDE 中用自然语言查询**（支持 [Claude Code](https://claude.ai/code)、[Cursor](https://cursor.com)、VS Code Copilot 等）。
+
+## 安装（全局命令 `ts`）
+
+```bash
+git clone https://github.com/sshnii/tronscan-cli.git
+cd tronscan-cli
+npm install
+cp .env.example .env
+# 编辑 .env，设置 TRONSCAN_API_KEY
+```
+
+API Key 申请：https://docs.tronscan.org/zh/api/api-keys
+
+在本机注册全局命令 **`ts`**（任选其一）：
+
+```bash
+npm link
+# 或
+npm install -g .
+```
+
+CLI 会从**你克隆下来的项目根目录**（与 `package.json` 同级）读取 `.env`。请在该目录配置好 API Key；之后在任意工作目录都可以直接执行 `ts`。
+
+## 使用方式
+
+### 一、在终端中使用
+
+全局安装 `ts` 后，在终端直接输入命令（`ts help` 可查看全部子命令）：
+
+```bash
+ts help                         # 查看所有子命令
+ts token usdt                   # 代币信息
+ts search usdt                  # 搜索
+ts block                        # 最新区块
+ts tps                          # 当前 TPS
+ts account TXxx...              # 账户详情
+ts tx af949...                  # 按交易哈希查询
+ts transfer-trc20 TXxx...       # TRC20 转账记录
+ts security-account TXxx...     # 账户风险检测
+```
+
+### 二、在 AI IDE 中使用
+
+将本项目作为工作目录打开，用自然语言描述需求即可；AI 会读取规则文件，识别意图、选择接口并解读返回结果。
+
+已内置规则文件：
+
+| AI IDE | 规则文件 |
+|--------|----------|
+| Claude Code | `CLAUDE.md` |
+| Cursor | `.cursorrules` |
+| VS Code Copilot | `.github/copilot-instructions.md` |
+
+以 Claude Code 为例，你只需要用自然语言描述需求：
+
+```
+你：查一下 USDT 代币信息
+AI：自动执行 ts token usdt 并解读价格、供应、持币地址等关键字段
+
+你：查一下这个地址的账户信息 TXxx...
+AI：自动执行 ts account TXxx... 并解读余额、资源等相关字段
+
+你：TRON 网络概况怎么样
+AI：自动执行 ts overview 并汇总网络综合数据
+
+你：最新区块是什么
+AI：自动执行 ts block 并解读最新区块（或高度与关键字段）
+
+你：当前 TPS 多少
+AI：自动执行 ts tps 并返回结果
+```
+
+无需记住任何命令和 API 路径，AI 会根据 `api-reference.md` 中的 80+ 接口自动匹配最合适的调用方式。
+
+## 依赖
+
+- [Node.js](https://nodejs.org/) >= 18
+
+## 命令分类
+
+| 分类 | 命令数 | 说明 |
+|------|--------|------|
+| 代币 | 7 | 代币详情、持有者、价格、列表、持仓分布 |
+| 搜索 | 2 | 搜索、热搜代币 |
+| 概览 | 3 | TPS、TRON 网络概览、节点 |
+| 区块 | 1 | 最新或指定区块 |
+| 账户 | 11 | 余额、持仓、资源、授权、投票、分析 |
+| 超级代表 | 4 | SR 列表、投票、链参数、提案 |
+| 交易 | 10 | 交易详情、转账记录(TRX/TRC20/TRC721/TRC1155) |
+| 统计 | 19 | TRX 供应、交易趋势、活跃账户、能量、DeFi TVL |
+| 合约 | 10 | 合约详情、调用者、能量消耗、日度分析 |
+| 安全 | 6 | 账户/代币/URL/交易风险检测、授权检查 |
+| 深度分析 | 4 | 关联账户、资金流向、大额交易 |
+| 稳定币 | 11 | 持仓分布、大户、增发/销毁、流动性池 |
+
+输入 `ts help` 查看完整命令列表。
+
+## API 参考
+
+完整 API 接口列表见 [api-reference.md](api-reference.md)。
+
+## License
+
+MIT

package/api-reference.md

@@ -0,0 +1,177 @@
+# TronScan API 速查表
+
+Base URL: `https://apilist.tronscanapi.com`
+认证 Header: `TRON-PRO-API-KEY: <key>`
+通用分页: `start=0&limit=20`（start+limit ≤ 10000）
+
+---
+
+## 账户
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/accountv2?address=` | 账户详情（余额、资源、质押） | `address` |
+| `GET /api/account/list` | 账户列表排行 | `start`, `limit`, `sort=-balance` |
+| `GET /api/account/tokens` | 账户持仓代币 | `address`, `start`, `limit` |
+| `GET /api/account/resourcev2` | Stake 2.0 资源（带宽/能量） | `address` |
+| `GET /api/account/resource` | Stake 1.0 资源 | `address` |
+| `GET /api/account/approve/list` | 代币授权列表 | `address`, `start`, `limit` |
+| `GET /api/account/approve/change` | 授权变更历史 | `address` |
+| `GET /api/account/analysis` | 账户日度分析（余额、转账、能量） | `address` |
+| `GET /api/account/token_asset_overview` | 钱包持仓总览（含估值） | `address` |
+| `GET /api/vote` | 投票记录 | `address` |
+| `GET /api/participate_project` | 参与项目 | `address` |
+| `GET /api/multiple/chain/query` | 多链地址查询 | `address` |
+
+---
+
+## 交易 & 转账
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/transaction` | 交易列表 | `start`, `limit`, `fromAddress`, `toAddress`, `block`, `start_timestamp`, `end_timestamp` |
+| `GET /api/transaction-info?hash=` | 交易详情（按哈希） | `hash` |
+| `GET /api/transfer` | TRX & TRC10 转账记录 | `address`, `fromAddress`, `toAddress`, `tokens`, `start`, `limit` |
+| `GET /api/token_trc20/transfers` | TRC20/TRC721 转账 | `relatedAddress`, `contract_address`, `fromAddress`, `toAddress`, `start`, `limit`, `start_timestamp`, `end_timestamp` |
+| `GET /api/token_trc1155/transfers` | TRC1155 转账 | `relatedAddress`, `contract_address`, `start`, `limit` |
+| `GET /api/internal-transaction` | 内部交易 | `address`, `contract`, `block`, `start`, `limit` |
+| `GET /api/token_trc20/transfers-with-status` | TRC20 转账（带状态） | `address`, `trc20Id`, `direction`, `start`, `limit` |
+| `GET /api/exchange/transaction` | 交易所交易 | `exchangeID`, `address`, `start`, `limit` |
+| `GET /api/transaction/statistics` | 交易统计 | - |
+| `GET /api/transfer/statistics` | 转账分布统计 | - |
+
+---
+
+## 区块
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/block` | 区块列表/详情 | `start`, `limit`, `producer`, `sort=-number`, `start_timestamp`, `end_timestamp` |
+
+---
+
+## 代币
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/tokens/overview` | 已索引代币列表/排行（CLI: `ts token-list`） | `start`, `limit`, `filter` |
+| `GET /api/token_trc20` | TRC20/721/1155 代币详情 | `contract` |
+| `GET /api/token` | TRC10 代币详情 | `id` |
+| `GET /api/token_trc20/holders` | TRC20 持有者列表 | `contract_address`, `start`, `limit` |
+| `GET /api/tokenholders` | TRC10 持有者列表 | `token`, `start`, `limit` |
+| `GET /api/tokens/position-distribution` | 代币持仓分布 | `token` |
+| `GET /api/token/price` | 代币价格 | `token` |
+| `GET /api/trc721/transfers` | TRC721 转账记录 | `contract`, `tokenId` |
+| `GET /api/token_trc20/totalSupply` | TRC20 流通量 | `contract` |
+| `GET /api/trc721/token` | TRC721 NFT 详情 | `contract` |
+| `GET /api/trc1155/inventory` | TRC1155 库存 | `contract` |
+
+---
+
+## 合约
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/contracts` | 合约列表 | `search`, `sort`, `start`, `limit`, `verified-only`, `open-source-only` |
+| `GET /api/contract` | 合约详情 | `contract` |
+| `POST /api/contracts/smart-contract-triggers-batch` | 合约事件 | `contractAddress`, `hashList`, `term`, `limit` |
+| `GET /api/onecontractenergystatistic` | 合约能量消耗 | `address` |
+| `GET /api/contracts/top_call` | 合约调用者排行 | `contract_address` |
+| `GET /api/onecontractcallerstatistic` | 每日独立调用者 | `address`, `start_timestamp`, `end_timestamp` |
+| `GET /api/onecontracttriggerstatistic` | 每日调用次数 | `address`, `start_timestamp`, `end_timestamp` |
+| `GET /api/contract/analysis` | 合约日度分析 | `address`, `type`(0-5), `start_timestamp`, `end_timestamp` |
+| `GET /api/onecontractcallers` | 所有调用者列表 | `address`, `day`, `start`, `limit` |
+| `GET /api/contracts/trigger` | 合约触发交易 | `start`, `limit`, `start_timestamp`, `end_timestamp` |
+
+---
+
+## 超级代表 & 治理
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/pagewitness` | SR 列表 | `witnesstype`(0=SR,1=partner,3=candidate) |
+| `GET /api/account/votes` | 账户投票记录 | `address` |
+| `GET /api/vote/witness` | SR 当前投票详情 | `address` |
+| `GET /api/chainparameters` | 链参数列表 | - |
+| `GET /api/proposal` | 提案信息 | `id`, `start`, `limit`, `address` |
+
+---
+
+## 安全检测
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/security/account/data` | 账户风险检测 | `address` |
+| `GET /api/security/token/data` | 代币安全检测 | `address` |
+| `GET /api/security/url/data` | URL 钓鱼检测 | `url` |
+| `GET /api/security/transaction/data` | 交易风险检测 | `hashes` |
+| `GET /api/security/sign/data` | 多签配置检查 | `address` |
+| `GET /api/security/auth/data` | 授权风险检查 | `address` |
+
+---
+
+## 网络概览 & 搜索
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/system/homepage-bundle` | TRON 网络概览（CLI: `ts overview`） | - |
+| `GET /api/search/v2` | 全局搜索 | `term`, `type`(token/address/contract/transaction/block), `start`, `limit` |
+| `GET /api/search/bar` | 热门搜索代币 | - |
+| `GET /api/search/hot` | 热搜排行 | - |
+| `GET /api/system/tps` | 当前 TPS | - |
+| `GET /api/nodemap` | 全网节点信息 | - |
+
+---
+
+## 链上统计
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/funds` | TRX 供应量/销毁 | - |
+| `GET /api/turnover` | TRX 发行与销毁分析 | - |
+| `GET /api/trx/volume` | TRX 历史价格和交易量 | - |
+| `GET /api/overview/dailytransactionnum` | 每日交易数趋势 | - |
+| `GET /api/overview/transactionnum` | 累计交易数 | - |
+| `GET /api/account/active_statistic` | 每日活跃账户 | - |
+| `GET /api/overview/dailyaccounts` | 每日新增账户 | - |
+| `GET /api/energydailystatistic` | 每日能量消耗 | - |
+| `GET /api/energystatistic` | 能量消耗分布 | - |
+| `GET /api/acquisition_cost_statistic` | 能量/带宽获取成本 | - |
+| `GET /api/netstatistic` | 每日带宽消耗 | - |
+| `GET /api/triggeramountstatistic` | 合约调用分布 | - |
+| `GET /api/tokenTvc` | 代币链上价值(TVC) | - |
+| `GET /api/token/analysis` | 代币交易分析 | - |
+| `GET /api/tokenTransfer/analysis` | 代币转账分析 | - |
+| `GET /api/overview/dailyavgblockSize` | 平均区块大小 | - |
+| `GET /api/overview/totalblockchainsize` | 区块链总大小 | - |
+| `GET /api/top10` | Top 10 排行 | - |
+| `GET /api/defiTvl` | DeFi TVL | - |
+
+---
+
+## 深度分析
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/deep/account/relatedAccount` | 关联账户 | `address` |
+| `GET /api/deep/account/transferAmount` | 资金流入/流出分析 | `address` |
+| `GET /api/deep/account/token/bigAmount` | 大额交易 | `address`, `token`, `type` |
+| `GET /api/deep/account/holderToken/basicInfo/trc20/transfer` | 代币转账次数 | `address` |
+
+---
+
+## 稳定币分析
+
+| 接口 | 用途 | 关键参数 |
+|------|------|----------|
+| `GET /api/stableCoin/holder/balance/overview` | 持仓分布概览 | - |
+| `GET /api/stableCoin/holder/change` | 持有者变化趋势 | - |
+| `GET /api/stableCoin/holder/top` | 大户排行 | - |
+| `GET /api/deep/stableCoin/bigAmount` | 稳定币大额交易 | - |
+| `GET /api/deep/stableCoin/totalSupply/keyEvents` | 增发/销毁/黑名单事件 | - |
+| `GET /api/stableCoin/distribution` | 交易所/DeFi 分布 | - |
+| `GET /api/deep/stableCoin/liquidity/transaction` | 流动性操作记录 | - |
+| `GET /api/stableCoin/pool/overview` | 池子概览(TVL) | - |
+| `GET /api/stableCoin/pool/trend` | 池子趋势 | - |
+| `GET /api/stableCoin/pool/change` | 池子历史变化 | - |
+| `GET /api/stableCoin/tvl` | 稳定币 TVL 分布 | - |

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@tronscanteam/cli",
+  "version": "1.0.0",
+  "description": "TronScan API CLI tool - 80+ commands for TRON blockchain data",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sshnii/tronscan-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sshnii/tronscan-cli/issues"
+  },
+  "homepage": "https://github.com/sshnii/tronscan-cli#readme",
+  "files": [
+    "src",
+    "README.md",
+    "README_CN.md",
+    "api-reference.md",
+    ".env.example"
+  ],
+  "bin": {
+    "ts": "src/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node --watch src/index.js"
+  },
+  "keywords": [
+    "tron",
+    "tronscan",
+    "blockchain",
+    "cli"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/api.js

@@ -0,0 +1,152 @@
+import { resolve } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+// ============ Config ============
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PROJECT_ROOT = resolve(__dirname, '..');
+
+export const VERSION = '1.0.0';
+const BASE_URL = 'https://apilist.tronscanapi.com';
+
+let apiKey = process.env.TRONSCAN_API_KEY || '';
+
+export function loadConfig() {
+  if (apiKey) return;
+  const envPath = resolve(PROJECT_ROOT, '.env');
+  if (existsSync(envPath)) {
+    const content = readFileSync(envPath, 'utf-8');
+    for (const line of content.split('\n')) {
+      const match = line.match(/^\s*TRONSCAN_API_KEY\s*=\s*(.+?)\s*$/);
+      if (match) {
+        apiKey = match[1].replace(/^["']|["']$/g, '');
+        process.env.TRONSCAN_API_KEY = apiKey;
+      }
+    }
+  }
+  if (!apiKey) {
+    err('未找到 API Key');
+    warn('请设置 TRONSCAN_API_KEY 环境变量或创建 .env 文件');
+    process.exit(2);
+  }
+}
+
+// ============ Colors ============
+
+const isTTY = process.stderr.isTTY ?? false;
+const c = {
+  red:    (s) => (isTTY ? `\x1b[31m${s}\x1b[0m` : s),
+  green:  (s) => (isTTY ? `\x1b[32m${s}\x1b[0m` : s),
+  yellow: (s) => (isTTY ? `\x1b[33m${s}\x1b[0m` : s),
+  cyan:   (s) => (isTTY ? `\x1b[36m${s}\x1b[0m` : s),
+  bold:   (s) => (isTTY ? `\x1b[1m${s}\x1b[0m` : s),
+  dim:    (s) => (isTTY ? `\x1b[2m${s}\x1b[0m` : s),
+};
+export { c };
+
+export function err(msg) {
+  console.error(c.red(`✗ ${msg}`));
+}
+
+export function warn(msg) {
+  console.error(c.yellow(`  ↳ ${msg}`));
+}
+
+// ============ HTTP ============
+
+function httpHint(status) {
+  if (status === 401 || status === 403) warn('请检查 API Key 是否正确');
+  else if (status === 404) warn('接口路径不存在或参数无效');
+  else if (status === 429) warn('请求频率超限，请稍后重试');
+  else if (status >= 500) warn('服务端异常，请稍后重试');
+}
+
+export async function get(path) {
+  let res;
+  try {
+    res = await fetch(`${BASE_URL}${path}`, {
+      headers: { 'TRON-PRO-API-KEY': apiKey },
+    });
+  } catch (e) {
+    err(`网络请求失败: ${e.message}`);
+    warn('请检查网络连接');
+    process.exit(3);
+  }
+  if (!res.ok) {
+    err(`请求失败 [HTTP ${res.status}]`);
+    httpHint(res.status);
+    const body = await res.text();
+    if (body) console.error(body);
+    process.exit(4);
+  }
+  return res.json();
+}
+
+export async function post(path, body) {
+  let res;
+  try {
+    res = await fetch(`${BASE_URL}${path}`, {
+      method: 'POST',
+      headers: {
+        'TRON-PRO-API-KEY': apiKey,
+        'Content-Type': 'application/json',
+      },
+      body: typeof body === 'string' ? body : JSON.stringify(body),
+    });
+  } catch (e) {
+    err(`网络请求失败: ${e.message}`);
+    warn('请检查网络连接');
+    process.exit(3);
+  }
+  if (!res.ok) {
+    err(`请求失败 [HTTP ${res.status}]`);
+    httpHint(res.status);
+    const text = await res.text();
+    if (text) console.error(text);
+    process.exit(4);
+  }
+  return res.json();
+}
+
+// ============ Output ============
+
+export function output(data, raw) {
+  if (raw) {
+    console.log(JSON.stringify(data));
+  } else {
+    console.log(JSON.stringify(data, null, 2));
+  }
+}
+
+// ============ Resolve ============
+
+export async function resolveContract(input) {
+  if (/^T[A-Za-z0-9]{33}$/.test(input)) return input;
+  const data = await get(`/api/search/v2?term=${encodeURIComponent(input)}&start=0&limit=1`);
+  const tokens = (data.token || [])
+    .filter((t) => t.token_type === 'trc20');
+  const lq = input.toLowerCase();
+  const match =
+    tokens.find((t) => t.abbr?.toLowerCase() === lq) ||
+    tokens.find((t) => t.name?.toLowerCase() === lq) ||
+    tokens.sort((a, b) => (a.vip ? 0 : 1) - (b.vip ? 0 : 1))[0];
+  if (match?.token_id) return match.token_id;
+  throw new Error(`无法解析代币: ${input}`);
+}
+
+export async function resolveTrc10(input) {
+  if (/^\d+$/.test(input)) return input;
+  const data = await get(`/api/search/v2?term=${encodeURIComponent(input)}&start=0&limit=1`);
+  const tokens = (data.token || [])
+    .filter((t) => t.token_type === 'trc10');
+  const lq = input.toLowerCase();
+  const match =
+    tokens.find((t) => t.abbr?.toLowerCase() === lq) ||
+    tokens.find((t) => t.name?.toLowerCase() === lq) ||
+    tokens[0];
+  if (match?.token_id) return match.token_id;
+  throw new Error(`无法解析 TRC10 代币: ${input}`);
+}

package/src/commands.js

@@ -0,0 +1,443 @@
+import { get, resolveContract, resolveTrc10, err, warn, c } from './api.js';
+
+// ============ Helpers ============
+
+function require(args, index, name, usage) {
+  const val = args[index];
+  if (!val) {
+    err(`缺少必需参数: ${name}`);
+    console.error(`  ${c.bold('用法:')} ${usage}`);
+    process.exit(2);
+  }
+  return val;
+}
+
+async function resolveAndLog(input, resolver) {
+  const result = await resolver(input);
+  if (result !== input) console.error(c.dim(`→ ${input} → ${result}`));
+  return result;
+}
+
+// ============ Command Definitions ============
+
+export const commands = {
+
+  // --- 账户 ---
+
+  'account': {
+    usage: 'ts account <address>', desc: '账户详情',
+    run: (a) => get(`/api/accountv2?address=${require(a, 0, 'address', 'ts account <address>') }`)
+  },
+  'account-list': {
+    usage: 'ts account-list [--start N] [--limit N]', desc: '账户排行榜',
+    run: (a, o) => get(`/api/account/list?start=${o.start}&limit=${o.limit}&sort=${o.sort || '-balance'}`)
+  },
+  'account-tokens': {
+    usage: 'ts account-tokens <address>', desc: '持仓代币',
+    run: (a, o) => get(`/api/account/tokens?address=${require(a, 0, 'address', 'ts account-tokens <address>')}&start=${o.start}&limit=${o.limit}`)
+  },
+  'account-resource': {
+    usage: 'ts account-resource <address>', desc: 'Stake 2.0 资源(带宽/能量)',
+    run: (a) => get(`/api/account/resourcev2?address=${require(a, 0, 'address', 'ts account-resource <address>')}`)
+  },
+  'account-resource-v1': {
+    usage: 'ts account-resource-v1 <address>', desc: 'Stake 1.0 资源',
+    run: (a) => get(`/api/account/resource?address=${require(a, 0, 'address', 'ts account-resource-v1 <address>')}`)
+  },
+  'account-approve': {
+    usage: 'ts account-approve <address>', desc: '代币授权列表',
+    run: (a, o) => get(`/api/account/approve/list?address=${require(a, 0, 'address', 'ts account-approve <address>')}&start=${o.start}&limit=${o.limit}`)
+  },
+  'account-approve-change': {
+    usage: 'ts account-approve-change <address>', desc: '授权变更历史',
+    run: (a, o) => get(`/api/account/approve/change?address=${require(a, 0, 'address', 'ts account-approve-change <address>')}&start=${o.start}&limit=${o.limit}`)
+  },
+  'account-votes': {
+    usage: 'ts account-votes <address>', desc: '投票记录',
+    run: (a) => get(`/api/vote?address=${require(a, 0, 'address', 'ts account-votes <address>')}`)
+  },
+  'account-analysis': {
+    usage: 'ts account-analysis <address>', desc: '日度分析',
+    run: (a) => get(`/api/account/analysis?address=${require(a, 0, 'address', 'ts account-analysis <address>')}`)
+  },
+  'account-asset': {
+    usage: 'ts account-asset <address>', desc: '持仓总览(含估值)',
+    run: (a) => get(`/api/account/token_asset_overview?address=${require(a, 0, 'address', 'ts account-asset <address>')}`)
+  },
+  'account-projects': {
+    usage: 'ts account-projects <address>', desc: '参与项目',
+    run: (a) => get(`/api/participate_project?address=${require(a, 0, 'address', 'ts account-projects <address>')}`)
+  },
+
+  // --- 交易 ---
+
+  'tx': {
+    usage: 'ts tx <hash>', desc: '交易详情',
+    run: (a) => get(`/api/transaction-info?hash=${require(a, 0, 'hash', 'ts tx <hash>')}`)
+  },
+  'tx-list': {
+    usage: 'ts tx-list [--start N] [--limit N]', desc: '交易列表',
+    run: (a, o) => get(`/api/transaction?start=${o.start}&limit=${o.limit}`)
+  },
+  'tx-stats': {
+    usage: 'ts tx-stats', desc: '交易统计',
+    run: () => get('/api/transaction/statistics')
+  },
+  'transfer': {
+    usage: 'ts transfer <address>', desc: 'TRX/TRC10 转账',
+    run: (a, o) => get(`/api/transfer?address=${require(a, 0, 'address', 'ts transfer <address>')}&start=${o.start}&limit=${o.limit}`)
+  },
+  'transfer-stats': {
+    usage: 'ts transfer-stats', desc: '转账分布统计',
+    run: () => get('/api/transfer/statistics')
+  },
+  'transfer-trc20': {
+    usage: 'ts transfer-trc20 <address>', desc: 'TRC20 转账(按地址)',
+    run: (a, o) => get(`/api/token_trc20/transfers?relatedAddress=${require(a, 0, 'address', 'ts transfer-trc20 <address>')}&start=${o.start}&limit=${o.limit}`)
+  },
+  'transfer-trc20-contract': {
+    usage: 'ts transfer-trc20-contract <contract>', desc: 'TRC20 转账(按合约)',
+    run: (a, o) => get(`/api/token_trc20/transfers?contract_address=${require(a, 0, 'contract', 'ts transfer-trc20-contract <contract>')}&start=${o.start}&limit=${o.limit}`)
+  },
+  'transfer-trc1155': {
+    usage: 'ts transfer-trc1155 <address>', desc: 'TRC1155 转账',
+    run: (a, o) => get(`/api/token_trc1155/transfers?relatedAddress=${require(a, 0, 'address', 'ts transfer-trc1155 <address>')}&start=${o.start}&limit=${o.limit}`)
+  },
+  'transfer-trc721': {
+    usage: 'ts transfer-trc721 <contract> <tokenId>', desc: 'TRC721 转账',
+    run: (a) => {
+      require(a, 0, 'contract', 'ts transfer-trc721 <contract> <tokenId>');
+      require(a, 1, 'tokenId', 'ts transfer-trc721 <contract> <tokenId>');
+      return get(`/api/trc721/transfers?contract=${a[0]}&tokenId=${a[1]}`);
+    }
+  },
+  'internal-tx': {
+    usage: 'ts internal-tx <address>', desc: '内部交易',
+    run: (a, o) => get(`/api/internal-transaction?address=${require(a, 0, 'address', 'ts internal-tx <address>')}&start=${o.start}&limit=${o.limit}`)
+  },
+
+  // --- 区块 ---
+
+  'block': {
+    usage: 'ts block [number]', desc: '最新区块(传区块号查指定区块)',
+    run: (a, o) => {
+      if (a[0] && /^\d+$/.test(a[0])) {
+        return get(`/api/block?number=${a[0]}&limit=1`);
+      }
+      return get(`/api/block?sort=-number&start=${o.start}&limit=${o.limit || '1'}`);
+    }
+  },
+
+  // --- 代币 ---
+
+  'token': {
+    usage: 'ts token <contract|symbol>', desc: 'TRC20 代币详情(支持符号如 USDT)',
+    run: async (a) => {
+      require(a, 0, 'contract|symbol', 'ts token <contract|symbol>');
+      if (a[0].toLowerCase() === 'trx') return get('/api/token?id=0&showAll=1');
+      const contract = await resolveAndLog(a[0], resolveContract);
+      return get(`/api/token_trc20?contract=${contract}`);
+    }
+  },
+  'token-trc10': {
+    usage: 'ts token-trc10 <id|symbol>', desc: 'TRC10 代币详情',
+    run: async (a) => {
+      require(a, 0, 'id|symbol', 'ts token-trc10 <id|symbol>');
+      const tid = await resolveAndLog(a[0], resolveTrc10);
+      return get(`/api/token?id=${tid}`);
+    }
+  },
+  'token-holders': {
+    usage: 'ts token-holders <contract|symbol>', desc: 'TRC20 持有者列表',
+    run: async (a, o) => {
+      require(a, 0, 'contract|symbol', 'ts token-holders <contract|symbol>');
+      const contract = await resolveAndLog(a[0], resolveContract);
+      return get(`/api/token_trc20/holders?contract_address=${contract}&start=${o.start}&limit=${o.limit}`);
+    }
+  },
+  'token-holders-trc10': {
+    usage: 'ts token-holders-trc10 <token|symbol>', desc: 'TRC10 持有者列表',
+    run: async (a, o) => {
+      require(a, 0, 'token|symbol', 'ts token-holders-trc10 <token|symbol>');
+      const tid = await resolveAndLog(a[0], resolveTrc10);
+      return get(`/api/tokenholders?token=${tid}&start=${o.start}&limit=${o.limit}`);
+    }
+  },
+  'token-price': {
+    usage: 'ts token-price <symbol>', desc: '代币价格',
+    run: (a) => {
+      require(a, 0, 'symbol', 'ts token-price <symbol>');
+      return get(`/api/token/price?token=${a[0].toLowerCase()}`);
+    }
+  },
+  'token-list': {
+    usage: 'ts token-list [--start N] [--limit N]', desc: '代币排行',
+    run: (a, o) => get(`/api/tokens/overview?start=${o.start}&limit=${o.limit}`)
+  },
+  'token-distribution': {
+    usage: 'ts token-distribution <token>', desc: '持仓分布',
+    run: (a) => get(`/api/tokens/position-distribution?token=${require(a, 0, 'token', 'ts token-distribution <token>')}`)
+  },
+
+  // --- 合约 ---
+
+  'contract': {
+    usage: 'ts contract <address>', desc: '合约详情',
+    run: (a) => get(`/api/contract?contract=${require(a, 0, 'address', 'ts contract <address>')}`)
+  },
+  'contract-list': {
+    usage: 'ts contract-list [--start N] [--limit N]', desc: '合约列表',
+    run: (a, o) => get(`/api/contracts?start=${o.start}&limit=${o.limit}&sort=${o.sort || '-trxCount'}`)
+  },
+  'contract-callers': {
+    usage: 'ts contract-callers <address>', desc: '调用者排行',
+    run: (a) => get(`/api/contracts/top_call?contract_address=${require(a, 0, 'address', 'ts contract-callers <address>')}`)
+  },
+  'contract-energy': {
+    usage: 'ts contract-energy <address>', desc: '能量消耗统计',
+    run: (a) => get(`/api/onecontractenergystatistic?address=${require(a, 0, 'address', 'ts contract-energy <address>')}`)
+  },
+  'contract-daily-callers': {
+    usage: 'ts contract-daily-callers <addr> <start_ts> <end_ts>', desc: '每日独立调用者',
+    run: (a) => {
+      require(a, 0, 'address', 'ts contract-daily-callers <addr> <start_ts> <end_ts>');
+      require(a, 1, 'start_timestamp', 'ts contract-daily-callers <addr> <start_ts> <end_ts>');
+      require(a, 2, 'end_timestamp', 'ts contract-daily-callers <addr> <start_ts> <end_ts>');
+      return get(`/api/onecontractcallerstatistic?address=${a[0]}&start_timestamp=${a[1]}&end_timestamp=${a[2]}`);
+    }
+  },
+  'contract-daily-calls': {
+    usage: 'ts contract-daily-calls <addr> <start_ts> <end_ts>', desc: '每日调用次数',
+    run: (a) => {
+      require(a, 0, 'address', 'ts contract-daily-calls <addr> <start_ts> <end_ts>');
+      require(a, 1, 'start_timestamp', 'ts contract-daily-calls <addr> <start_ts> <end_ts>');
+      require(a, 2, 'end_timestamp', 'ts contract-daily-calls <addr> <start_ts> <end_ts>');
+      return get(`/api/onecontracttriggerstatistic?address=${a[0]}&start_timestamp=${a[1]}&end_timestamp=${a[2]}`);
+    }
+  },
+  'contract-analysis': {
+    usage: 'ts contract-analysis <address> [type:0-5]', desc: '合约日度分析',
+    run: (a) => get(`/api/contract/analysis?address=${require(a, 0, 'address', 'ts contract-analysis <address> [type:0-5]')}&type=${a[1] || '0'}`)
+  },
+  'contract-all-callers': {
+    usage: 'ts contract-all-callers <address> [day]', desc: '所有调用者列表',
+    run: (a, o) => get(`/api/onecontractcallers?address=${require(a, 0, 'address', 'ts contract-all-callers <address> [day]')}&day=${a[1] || '1'}&start=${o.start}&limit=${o.limit}`)
+  },
+  'contract-triggers': {
+    usage: 'ts contract-triggers [--start N] [--limit N]', desc: '合约触发交易',
+    run: (a, o) => get(`/api/contracts/trigger?start=${o.start}&limit=${o.limit}`)
+  },
+
+  // --- 超级代表 ---
+
+  'sr': {
+    usage: 'ts sr [type: 0=SR, 1=partner, 3=candidate]', desc: 'SR 列表',
+    run: (a) => get(`/api/pagewitness?witnesstype=${a[0] || '0'}`)
+  },
+  'sr-votes': {
+    usage: 'ts sr-votes <address>', desc: 'SR 投票详情',
+    run: (a) => get(`/api/vote/witness?address=${require(a, 0, 'address', 'ts sr-votes <address>')}`)
+  },
+  'params': {
+    usage: 'ts params', desc: '链参数',
+    run: () => get('/api/chainparameters')
+  },
+  'proposal': {
+    usage: 'ts proposal <id>', desc: '提案详情',
+    run: (a) => get(`/api/proposal?id=${require(a, 0, 'id', 'ts proposal <id>')}`)
+  },
+
+  // --- 安全 ---
+
+  'security-account': {
+    usage: 'ts security-account <address>', desc: '账户风险检测',
+    run: (a) => get(`/api/security/account/data?address=${require(a, 0, 'address', 'ts security-account <address>')}`)
+  },
+  'security-token': {
+    usage: 'ts security-token <address>', desc: '代币安全检测',
+    run: (a) => get(`/api/security/token/data?address=${require(a, 0, 'address', 'ts security-token <address>')}`)
+  },
+  'security-url': {
+    usage: 'ts security-url <url>', desc: 'URL 钓鱼检测',
+    run: (a) => get(`/api/security/url/data?url=${require(a, 0, 'url', 'ts security-url <url>')}`)
+  },
+  'security-tx': {
+    usage: 'ts security-tx <hash>', desc: '交易风险检测',
+    run: (a) => get(`/api/security/transaction/data?hashes=${require(a, 0, 'hash', 'ts security-tx <hash>')}`)
+  },
+  'security-auth': {
+    usage: 'ts security-auth <address>', desc: '授权风险检查',
+    run: (a) => get(`/api/security/auth/data?address=${require(a, 0, 'address', 'ts security-auth <address>')}`)
+  },
+  'security-sign': {
+    usage: 'ts security-sign <address>', desc: '多签配置检查',
+    run: (a) => get(`/api/security/sign/data?address=${require(a, 0, 'address', 'ts security-sign <address>')}`)
+  },
+
+  // --- 搜索 ---
+
+  'search': {
+    usage: 'ts search <keyword>', desc: '搜索',
+    run: (a, o) => get(`/api/search/v2?term=${require(a, 0, 'keyword', 'ts search <keyword>')}&start=0&limit=${o.limit || '10'}`)
+  },
+  'tps': {
+    usage: 'ts tps', desc: '当前 TPS',
+    run: () => get('/api/system/tps')
+  },
+  'overview': {
+    usage: 'ts overview', desc: 'TRON 网络概览',
+    run: () => get('/api/system/homepage-bundle')
+  },
+  'hot-token': {
+    usage: 'ts hot-token', desc: '热搜代币排行',
+    run: () => get('/api/search/hot')
+  },
+  'nodes': {
+    usage: 'ts nodes', desc: '全网节点信息',
+    run: () => get('/api/nodemap')
+  },
+
+  // --- 统计 ---
+
+  'trx-supply': {
+    usage: 'ts trx-supply', desc: 'TRX 供应/销毁',
+    run: () => get('/api/funds')
+  },
+  'trx-turnover': {
+    usage: 'ts trx-turnover', desc: 'TRX 发行与销毁分析',
+    run: () => get('/api/turnover')
+  },
+  'tx-trend': {
+    usage: 'ts tx-trend', desc: '每日交易趋势',
+    run: () => get('/api/overview/dailytransactionnum')
+  },
+  'tx-total': {
+    usage: 'ts tx-total', desc: '累计交易数',
+    run: () => get('/api/overview/transactionnum')
+  },
+  'active-accounts': {
+    usage: 'ts active-accounts', desc: '活跃账户',
+    run: () => get('/api/account/active_statistic')
+  },
+  'new-accounts': {
+    usage: 'ts new-accounts', desc: '新增账户',
+    run: () => get('/api/overview/dailyaccounts')
+  },
+  'defi-tvl': {
+    usage: 'ts defi-tvl', desc: 'DeFi TVL',
+    run: () => get('/api/defiTvl')
+  },
+  'top10': {
+    usage: 'ts top10', desc: 'Top 10 排行',
+    run: () => get('/api/top10')
+  },
+  'trx-price': {
+    usage: 'ts trx-price', desc: 'TRX 价格历史',
+    run: () => get('/api/trx/volume')
+  },
+  'energy-daily': {
+    usage: 'ts energy-daily', desc: '每日能量消耗',
+    run: () => get('/api/energydailystatistic')
+  },
+  'energy-dist': {
+    usage: 'ts energy-dist', desc: '能量消耗分布',
+    run: () => get('/api/energystatistic')
+  },
+  'energy-cost': {
+    usage: 'ts energy-cost', desc: '能量/带宽获取成本',
+    run: () => get('/api/acquisition_cost_statistic')
+  },
+  'bandwidth-daily': {
+    usage: 'ts bandwidth-daily', desc: '每日带宽消耗',
+    run: () => get('/api/netstatistic')
+  },
+  'trigger-stats': {
+    usage: 'ts trigger-stats', desc: '合约调用分布',
+    run: () => get('/api/triggeramountstatistic')
+  },
+  'token-tvc': {
+    usage: 'ts token-tvc', desc: '代币链上价值(TVC)',
+    run: () => get('/api/tokenTvc')
+  },
+  'token-analysis': {
+    usage: 'ts token-analysis', desc: '代币交易分析',
+    run: () => get('/api/token/analysis')
+  },
+  'token-transfer-analysis': {
+    usage: 'ts token-transfer-analysis', desc: '代币转账分析',
+    run: () => get('/api/tokenTransfer/analysis')
+  },
+
+  // --- 深度分析 ---
+
+  'deep-related': {
+    usage: 'ts deep-related <address>', desc: '关联账户',
+    run: (a) => get(`/api/deep/account/relatedAccount?address=${require(a, 0, 'address', 'ts deep-related <address>')}`)
+  },
+  'deep-flow': {
+    usage: 'ts deep-flow <address>', desc: '资金流向',
+    run: (a) => get(`/api/deep/account/transferAmount?address=${require(a, 0, 'address', 'ts deep-flow <address>')}`)
+  },
+  'deep-big-tx': {
+    usage: 'ts deep-big-tx <address>', desc: '大额交易',
+    run: (a) => get(`/api/deep/account/token/bigAmount?address=${require(a, 0, 'address', 'ts deep-big-tx <address>')}`)
+  },
+  'deep-token-transfer': {
+    usage: 'ts deep-token-transfer <address>', desc: '代币转账次数',
+    run: (a) => get(`/api/deep/account/holderToken/basicInfo/trc20/transfer?address=${require(a, 0, 'address', 'ts deep-token-transfer <address>')}`)
+  },
+
+  // --- 稳定币 ---
+
+  'stable-holders': {
+    usage: 'ts stable-holders', desc: '持仓分布概览',
+    run: () => get('/api/stableCoin/holder/balance/overview')
+  },
+  'stable-change': {
+    usage: 'ts stable-change', desc: '持有者变化趋势',
+    run: () => get('/api/stableCoin/holder/change')
+  },
+  'stable-top': {
+    usage: 'ts stable-top', desc: '大户排行',
+    run: () => get('/api/stableCoin/holder/top')
+  },
+  'stable-big-tx': {
+    usage: 'ts stable-big-tx', desc: '大额交易',
+    run: () => get('/api/deep/stableCoin/bigAmount')
+  },
+  'stable-events': {
+    usage: 'ts stable-events', desc: '增发/销毁/黑名单事件',
+    run: () => get('/api/deep/stableCoin/totalSupply/keyEvents')
+  },
+  'stable-dist': {
+    usage: 'ts stable-dist', desc: '交易所/DeFi 分布',
+    run: () => get('/api/stableCoin/distribution')
+  },
+  'stable-liquidity': {
+    usage: 'ts stable-liquidity', desc: '流动性操作记录',
+    run: () => get('/api/deep/stableCoin/liquidity/transaction')
+  },
+  'stable-pool': {
+    usage: 'ts stable-pool', desc: '池子概览(TVL)',
+    run: () => get('/api/stableCoin/pool/overview')
+  },
+  'stable-pool-trend': {
+    usage: 'ts stable-pool-trend', desc: '池子趋势',
+    run: () => get('/api/stableCoin/pool/trend')
+  },
+  'stable-pool-change': {
+    usage: 'ts stable-pool-change', desc: '池子历史变化',
+    run: () => get('/api/stableCoin/pool/change')
+  },
+  'stable-tvl': {
+    usage: 'ts stable-tvl', desc: '稳定币 TVL 分布',
+    run: () => get('/api/stableCoin/tvl')
+  },
+
+  // --- 兜底 ---
+
+  'api': {
+    usage: 'ts api "/api/xxx?param=value"', desc: '直接调用 API',
+    run: (a) => get(require(a, 0, 'path', 'ts api "/api/xxx?param=value"'))
+  },
+};

package/src/help.js

@@ -0,0 +1,140 @@
+import { VERSION, c } from './api.js';
+
+export function printHelp() {
+  const isTTY = process.stdout.isTTY ?? false;
+  const B = (s) => (isTTY ? `\x1b[1m${s}\x1b[0m` : s);
+  const C = (s) => (isTTY ? `\x1b[36m${s}\x1b[0m` : s);
+
+  console.log(`${B(`TronScan CLI v${VERSION}`)} - TRON 链上数据查询工具
+
+${C('用法:')} ts <command> [args...] [options...]
+
+${B('全局选项:')}
+  --start N     分页起始位置（默认 0）
+  --limit N     每页数量（默认 20）
+  --sort FIELD  排序字段
+  --raw         输出紧凑 JSON（适合管道）
+  --help, -h    显示命令帮助
+  --version, -V 显示版本号
+
+  代币:
+    ts token <contract|symbol>      TRC20 代币详情（支持 USDT 等符号）
+    ts token-trc10 <id|symbol>      TRC10 代币详情
+    ts token-holders <contract|symbol> TRC20 持有者列表
+    ts token-holders-trc10 <token|symbol> TRC10 持有者列表
+    ts token-price <symbol>         代币价格（如 trx、usdt）
+    ts token-list                   代币排行
+    ts token-distribution <token>   持仓分布
+
+  搜索:
+    ts search <keyword>             搜索
+    ts hot-token                    热搜代币排行
+
+  概览:
+    ts tps                          当前 TPS
+    ts overview                     TRON 网络概览
+    ts nodes                        全网节点信息
+
+  区块:
+    ts block [number]               最新区块（传区块号查指定区块）
+
+  账户:
+    ts account <addr>               账户详情
+    ts account-list                 账户排行榜
+    ts account-tokens <addr>        持仓代币
+    ts account-resource <addr>      Stake 2.0 资源(带宽/能量)
+    ts account-resource-v1 <addr>   Stake 1.0 资源
+    ts account-approve <addr>       代币授权列表
+    ts account-approve-change <addr> 授权变更历史
+    ts account-votes <addr>         投票记录
+    ts account-analysis <addr>      日度分析
+    ts account-asset <addr>         持仓总览(含估值)
+    ts account-projects <addr>      参与项目
+
+  超级代表:
+    ts sr [type]                    SR 列表 (0=SR,1=partner,3=candidate)
+    ts sr-votes <addr>              SR 投票详情
+    ts params                       链参数
+    ts proposal <id>                提案详情
+
+  交易:
+    ts tx <hash>                    交易详情
+    ts tx-list                      交易列表
+    ts tx-stats                     交易统计
+    ts transfer <addr>              TRX/TRC10 转账
+    ts transfer-stats               转账分布统计
+    ts transfer-trc20 <addr>        TRC20 转账(按地址)
+    ts transfer-trc20-contract <contract> TRC20 转账(按合约)
+    ts transfer-trc1155 <addr>      TRC1155 转账
+    ts transfer-trc721 <contract> <tokenId> TRC721 转账
+    ts internal-tx <addr>           内部交易
+
+  统计:
+    ts trx-supply                   TRX 供应/销毁
+    ts trx-turnover                 TRX 发行与销毁分析
+    ts tx-trend                     每日交易趋势
+    ts tx-total                     累计交易数
+    ts active-accounts              活跃账户
+    ts new-accounts                 新增账户
+    ts defi-tvl                     DeFi TVL
+    ts top10                        Top 10 排行
+    ts trx-price                    TRX 价格历史
+    ts energy-daily                 每日能量消耗
+    ts energy-dist                  能量消耗分布
+    ts energy-cost                  能量/带宽获取成本
+    ts bandwidth-daily              每日带宽消耗
+    ts trigger-stats                合约调用分布
+    ts token-tvc                    代币链上价值(TVC)
+    ts token-analysis               代币交易分析
+    ts token-transfer-analysis      代币转账分析
+
+  合约:
+    ts contract <addr>              合约详情
+    ts contract-list                合约列表
+    ts contract-callers <addr>      调用者排行
+    ts contract-energy <addr>       能量消耗统计
+    ts contract-daily-callers <addr> <start_ts> <end_ts> 每日独立调用者
+    ts contract-daily-calls <addr> <start_ts> <end_ts>   每日调用次数
+    ts contract-analysis <addr> [type] 合约日度分析(type:0-5)
+    ts contract-all-callers <addr> [day] 所有调用者列表
+    ts contract-triggers            合约触发交易
+
+
+  安全:
+    ts security-account <addr>      账户风险检测
+    ts security-token <addr>        代币安全检测
+    ts security-url <url>           URL 钓鱼检测
+    ts security-tx <hash>           交易风险检测
+    ts security-auth <addr>         授权风险检查
+    ts security-sign <addr>         多签配置检查
+
+  深度分析:
+    ts deep-related <addr>          关联账户
+    ts deep-flow <addr>             资金流向
+    ts deep-big-tx <addr>           大额交易
+    ts deep-token-transfer <addr>   代币转账次数
+
+  稳定币:
+    ts stable-holders               持仓分布概览
+    ts stable-change                持有者变化趋势
+    ts stable-top                   大户排行
+    ts stable-big-tx                大额交易
+    ts stable-events                增发/销毁/黑名单事件
+    ts stable-dist                  交易所/DeFi 分布
+    ts stable-liquidity             流动性操作记录
+    ts stable-pool                  池子概览(TVL)
+    ts stable-pool-trend            池子趋势
+    ts stable-pool-change           池子历史变化
+    ts stable-tvl                   稳定币 TVL 分布
+`);
+}
+
+export function printCommandHelp(name, usage, desc) {
+  const isTTY = process.stdout.isTTY ?? false;
+  const B = (s) => (isTTY ? `\x1b[1m${s}\x1b[0m` : s);
+  const C = (s) => (isTTY ? `\x1b[36m${s}\x1b[0m` : s);
+
+  console.log(`${B('用法:')} ${usage}`);
+  console.log(`  ${C(desc)}\n`);
+  console.log(`  全局选项: --raw (紧凑JSON)  --start N  --limit N  --sort FIELD`);
+}

package/src/index.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+import { loadConfig, output, err, warn, VERSION } from './api.js';
+import { commands } from './commands.js';
+import { printHelp, printCommandHelp } from './help.js';
+
+// ============ Parse arguments ============
+
+const rawArgs = process.argv.slice(2);
+
+// --version / -V
+if (rawArgs[0] === '--version' || rawArgs[0] === '-V' || rawArgs[0] === 'version') {
+  console.log(`TronScan CLI v${VERSION}`);
+  process.exit(0);
+}
+
+// --help / -h (no command)
+if (!rawArgs[0] || rawArgs[0] === '--help' || rawArgs[0] === '-h' || rawArgs[0] === 'help') {
+  printHelp();
+  process.exit(0);
+}
+
+// Extract command
+const cmd = rawArgs[0];
+const rest = rawArgs.slice(1);
+
+// Parse options and positional args
+const opts = { start: '0', limit: '20', sort: '', raw: false };
+let showHelp = false;
+const positional = [];
+
+let i = 0;
+while (i < rest.length) {
+  const arg = rest[i];
+  switch (arg) {
+    case '--raw':     opts.raw = true; i++; break;
+    case '--help':
+    case '-h':        showHelp = true; i++; break;
+    case '--start':   opts.start = rest[++i] || '0'; i++; break;
+    case '--limit':   opts.limit = rest[++i] || '20'; i++; break;
+    case '--sort':    opts.sort = rest[++i] || ''; i++; break;
+    case '--':        positional.push(...rest.slice(++i)); i = rest.length; break;
+    default:          positional.push(arg); i++; break;
+  }
+}
+
+// ============ Dispatch ============
+
+const command = commands[cmd];
+
+if (!command) {
+  err(`未知命令: ${cmd}`);
+  warn('输入 ts help 查看帮助');
+  process.exit(1);
+}
+
+if (showHelp) {
+  printCommandHelp(cmd, command.usage, command.desc);
+  process.exit(0);
+}
+
+// Load config and run
+loadConfig();
+
+try {
+  const result = await command.run(positional, opts);
+  output(result, opts.raw);
+} catch (e) {
+  err(e.message);
+  process.exit(1);
+}