diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml
index 443a6f15..3cc59ee6 100644
--- a/.github/workflows/docker.yml
+++ b/.github/workflows/docker.yml
@@ -8,6 +8,7 @@ on:
       - update-mcp-server
       - ai-bankofai-patch-1
       - x402-sdk-1.0.0-update
+      - Refactor
     tags:
       - 'test'
   pull_request:
@@ -17,6 +18,7 @@ on:
       - update-mcp-server
       - ai-bankofai-patch-1
       - x402-sdk-1.0.0-update
+      - Refactor
   workflow_dispatch: # Intentionally unrestricted — allows manual builds from any branch for flexibility
 
 env:
diff --git a/changelog/8004.md b/changelog/8004.md
new file mode 100644
index 00000000..1e84124f
--- /dev/null
+++ b/changelog/8004.md
@@ -0,0 +1,49 @@
+---
+title: '8004 Protocol'
+description: 'Release notes for the 8004 Protocol.'
+---
+
+# 8004 Protocol
+
+Release notes for the 8004 Protocol.
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 2, 2026</div>
+<div className="changelog-body">
+
+### GitHub organization moved
+
+<div className="changelog-tags"><span className="changelog-tag">Update</span></div>
+
+- Repository links moved from `bankofai` to **`BofAI`**. Old URLs redirect, but update any pinned clone or dependency reference.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Feb 12, 2026</div>
+<div className="changelog-body">
+
+### v1.1.0
+
+<div className="changelog-tags"><span className="changelog-tag">New Release</span></div>
+
+- Added **Supported Networks** and **Contract Addresses** pages so you can confirm where the registry is deployed before you register.
+- Published the Usage set: **Install**, **Configure Agents**, and **HTTP Registration**.
+- Rewrote the **Quick Start** around registering your first agent end to end.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Feb 11, 2026</div>
+<div className="changelog-body">
+
+### First documentation
+
+<div className="changelog-tags"><span className="changelog-tag">New</span></div>
+
+- Initial 8004 Protocol docs — what on-chain agent identity is for, and how to get started.
+
+</div>
+</div>
diff --git a/changelog/agent-wallet.md b/changelog/agent-wallet.md
new file mode 100644
index 00000000..cadb15ee
--- /dev/null
+++ b/changelog/agent-wallet.md
@@ -0,0 +1,35 @@
+---
+title: 'Agent Wallet'
+description: 'Release notes for Agent Wallet.'
+---
+
+# Agent Wallet
+
+Release notes for Agent Wallet.
+
+<div className="changelog-entry">
+<div className="changelog-date">Apr 15, 2026</div>
+<div className="changelog-body">
+
+### Introduction and quick install
+
+<div className="changelog-tags"><span className="changelog-tag">Docs</span></div>
+
+- Added an **Introduction** covering how keys are stored and how signing works, plus a **Quick Start** for creating your first wallet.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 22, 2026</div>
+<div className="changelog-body">
+
+### Developer docs — and a password-handling fix
+
+<div className="changelog-tags"><span className="changelog-tag">New</span><span className="changelog-tag">Security</span></div>
+
+- Published the developer set: **CLI Reference**, **SDK Guide**, and **SDK Cookbook**.
+- **Security fix**: the setup docs previously used `echo $AGENT_WALLET_PASSWORD`, which prints your wallet password to the terminal and leaves it in shell history. Those examples have been removed. If you followed the old instructions, clear your shell history and consider rotating the password.
+
+</div>
+</div>
diff --git a/changelog/index.md b/changelog/index.md
new file mode 100644
index 00000000..9b2d440c
--- /dev/null
+++ b/changelog/index.md
@@ -0,0 +1,255 @@
+---
+title: 'Changelogs'
+description: 'Product updates and announcements for BANK OF AI — all products, newest first.'
+---
+
+# Changelogs
+
+Product updates and announcements for BANK OF AI.
+
+<div className="changelog-entry">
+<div className="changelog-date">Jul 21, 2026</div>
+<div className="changelog-body">
+
+### Docs
+
+<div className="changelog-tags"><span className="changelog-tag">Product Updates</span><span className="changelog-tag">Docs</span><span className="changelog-tag">x402</span></div>
+
+- **TRON network IDs now use CAIP-2 format** across the x402 docs — `tron:0x2b6653dc` (Mainnet), `tron:0xcd8690dc` (Nile), `tron:0x94a9059e` (Shasta). In application code, prefer the SDK constants `TRON_MAINNET` / `TRON_NILE` / `TRON_SHASTA` over hard-coded hex strings. [Network & Token Support](../x402/core-concepts/network-and-token-support/)
+- **`auth-capture` scheme removed** — x402 now documents four payment schemes: `exact`, `upto`, `batch-settlement`, and `exact_gasfree` (TRON). [SDK Features](../x402/sdk-features/)
+- **x402 quickstarts simplified** for both buyers and sellers.
+- **New model**: Kimi K3 pricing docs added to LLM Service.
+- **Rewritten BANK OF AI introduction** — restructured around what your AI actually gains, with a capability overview and an end-to-end execution example.
+- **New section — Best Practices**: hands-on walkthroughs and habits worth keeping, alongside the product docs. [Read the first one](../devnotes/first-onchain-swap/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jul 17, 2026</div>
+<div className="changelog-body">
+
+### Docs
+
+<div className="changelog-tags"><span className="changelog-tag">Product Updates</span><span className="changelog-tag">Docs</span></div>
+
+- **New x402 CLI documentation set**: overview, quick start, full command reference, and FAQ — in English and 中文. [Read the docs](../x402/cli/)
+- **Docs site refresh**: offline full-text search (⌘K), a Changelogs tab, section icons, and a cleaner sidebar layout.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jul 15, 2026</div>
+<div className="changelog-body">
+
+### x402 CLI
+
+<div className="changelog-tags"><span className="changelog-tag">New Release</span><span className="changelog-tag">x402</span><span className="changelog-tag">CLI</span></div>
+
+- **`v1.0.0` — first stable release** of `@bankofai/x402-cli`, a TypeScript command-line client for x402 payments: `pay` any x402-protected URL, `serve` a local paywall endpoint, `roundtrip` for end-to-end smoke tests, plus `gateway` and `catalog` for provider files and the service catalog.
+- Built on the published `@bankofai/x402-core` / `x402-evm` / `x402-tron` SDK 1.0 packages; `scheme=exact` with Permit2.
+- Networks: TRON (`tron:mainnet` / `tron:nile` / `tron:shasta`) and BSC (`eip155:56` / `eip155:97`). [Quick Start](../x402/cli/quickstart/)
+
+</div>
+</div>
+<div className="changelog-entry">
+<div className="changelog-date">Jul 10, 2026</div>
+<div className="changelog-body">
+
+### SKILLS · LLM Service
+
+<div className="changelog-tags"><span className="changelog-tag">Update</span><span className="changelog-tag">New Model</span><span className="changelog-tag">x402</span></div>
+
+- **SKILLS** — added guidance for the **`exact_gasfree` scheme** on TRON, and moved the API catalog to a new endpoint. Re-install if you pinned an older version. [Details](./skills/)
+- **LLM Service** — added the **GPT-5.6** family: `sol`, `terra`, and `luna`. [Details](./llm-service/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jul 2, 2026</div>
+<div className="changelog-body">
+
+### LLM Service
+
+<div className="changelog-tags"><span className="changelog-tag">New Model</span></div>
+
+- **Claude Fable 5** and **Claude Sonnet 5** added with full pricing. [Details](./llm-service/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jun 19, 2026</div>
+<div className="changelog-body">
+
+### LLM Service
+
+<div className="changelog-tags"><span className="changelog-tag">New Model</span><span className="changelog-tag">Pricing</span></div>
+
+- Added **GLM-5.2**.
+- Corrected the **Qwen cache-read price** — re-check any cost estimates based on the old figure. [Details](./llm-service/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jun 13, 2026</div>
+<div className="changelog-body">
+
+### LLM Service
+
+<div className="changelog-tags"><span className="changelog-tag">Removed</span></div>
+
+- Deprecated models removed from the model list and pricing page. Requests naming them will now fail. [Details](./llm-service/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jun 1, 2026</div>
+<div className="changelog-body">
+
+### LLM Service
+
+<div className="changelog-tags"><span className="changelog-tag">New Model</span></div>
+
+- Added **MiniMax M3** and **Claude Opus 4.8**, and regrouped the model sidebar by family. [Details](./llm-service/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Apr 15, 2026</div>
+<div className="changelog-body">
+
+### SKILLS · Agent Wallet
+
+<div className="changelog-tags"><span className="changelog-tag">Docs</span></div>
+
+- **SKILLS** — new Introduction and a Quick Start that installs in one command. [Details](./skills/)
+- **Agent Wallet** — new Introduction covering key storage and signing, plus a Quick Start for your first wallet. [Details](./agent-wallet/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Apr 1, 2026</div>
+<div className="changelog-body">
+
+### Openclaw Extension
+
+<div className="changelog-tags"><span className="changelog-tag">Privacy</span></div>
+
+- Wallet addresses now display **masked** in the extension UI — safer for screen-sharing and recordings. [Details](./openclaw-extension/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 31, 2026</div>
+<div className="changelog-body">
+
+### Openclaw Extension
+
+<div className="changelog-tags"><span className="changelog-tag">New</span></div>
+
+- Added a **Windows installation guide** alongside macOS and Linux. [Details](./openclaw-extension/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 22, 2026</div>
+<div className="changelog-body">
+
+### Agent Wallet
+
+<div className="changelog-tags"><span className="changelog-tag">New</span><span className="changelog-tag">Security</span></div>
+
+- Published the developer set: **CLI Reference**, **SDK Guide**, and **SDK Cookbook**.
+- **Security fix** — setup docs no longer use `echo $AGENT_WALLET_PASSWORD`, which printed your wallet password to the terminal and left it in shell history. If you followed the old instructions, clear your shell history and consider rotating the password. [Details](./agent-wallet/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 17, 2026</div>
+<div className="changelog-body">
+
+### MCP Server · Openclaw Extension
+
+<div className="changelog-tags"><span className="changelog-tag">New</span><span className="changelog-tag">Docs</span></div>
+
+- **MCP Server** — added a full **Tool List** for the TRON MCP Server, with parameters. [Details](./mcp-server/)
+- **Openclaw Extension** — first release: Introduction and Quick Start for connecting the browser extension to your Agent Wallet. [Details](./openclaw-extension/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 13, 2026</div>
+<div className="changelog-body">
+
+### SKILLS
+
+<div className="changelog-tags"><span className="changelog-tag">New</span></div>
+
+- Published the **BANK OF AI Skill** reference — the bundle that teaches your AI client to read balances, quote swaps, and execute transactions through Agent Wallet. [Details](./skills/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 10, 2026</div>
+<div className="changelog-body">
+
+### MCP Server
+
+<div className="changelog-tags"><span className="changelog-tag">New</span><span className="changelog-tag">TRON</span></div>
+
+- Two ways to connect: **Official Server Access** for the hosted endpoint, and **Local Private Deployment** when keys and traffic must stay in your own environment. [Details](./mcp-server/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 2, 2026</div>
+<div className="changelog-body">
+
+### 8004 Protocol
+
+<div className="changelog-tags"><span className="changelog-tag">Update</span></div>
+
+- Repository links moved from `bankofai` to **`BofAI`**. Old URLs redirect, but update any pinned clone or dependency reference. [Details](./8004/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Feb 12, 2026</div>
+<div className="changelog-body">
+
+### 8004 Protocol
+
+<div className="changelog-tags"><span className="changelog-tag">New Release</span></div>
+
+- **v1.1.0** — added Supported Networks and Contract Addresses, published the Usage set (Install, Configure Agents, HTTP Registration), and rewrote the Quick Start around registering your first agent end to end. [Details](./8004/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Feb 11, 2026</div>
+<div className="changelog-body">
+
+### MCP Server · 8004 Protocol
+
+<div className="changelog-tags"><span className="changelog-tag">New</span></div>
+
+- **MCP Server** — first documentation for the **TRON MCP Server** and **BSC MCP Server**: installation, features, and API surface. [Details](./mcp-server/)
+- **8004 Protocol** — initial docs on what on-chain agent identity is for and how to get started. [Details](./8004/)
+
+</div>
+</div>
diff --git a/changelog/llm-service.md b/changelog/llm-service.md
new file mode 100644
index 00000000..1aab28bc
--- /dev/null
+++ b/changelog/llm-service.md
@@ -0,0 +1,87 @@
+---
+title: 'LLM Service'
+description: 'Release notes for LLM Service.'
+---
+
+# LLM Service
+
+Release notes for LLM Service.
+
+<div className="changelog-entry">
+<div className="changelog-date">Jul 21, 2026</div>
+<div className="changelog-body">
+
+### Kimi K3
+
+<div className="changelog-tags"><span className="changelog-tag">New Model</span></div>
+
+- **Kimi K3** is now available, with pricing documented. [Models](../llmservice/models/kimi-k3/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jul 10, 2026</div>
+<div className="changelog-body">
+
+### GPT-5.6
+
+<div className="changelog-tags"><span className="changelog-tag">New Model</span></div>
+
+- Added the **GPT-5.6** family — `sol`, `terra`, and `luna` — with pricing for each.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jul 2, 2026</div>
+<div className="changelog-body">
+
+### Claude Fable 5 and Claude Sonnet 5
+
+<div className="changelog-tags"><span className="changelog-tag">New Model</span></div>
+
+- **Claude Fable 5** and **Claude Sonnet 5** added with full pricing.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jun 19, 2026</div>
+<div className="changelog-body">
+
+### GLM-5.2 and a Qwen pricing correction
+
+<div className="changelog-tags"><span className="changelog-tag">New Model</span><span className="changelog-tag">Pricing</span></div>
+
+- Added **GLM-5.2**.
+- Corrected the **Qwen cache-read price** — if you were estimating costs from the old figure, re-check your numbers.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jun 13, 2026</div>
+<div className="changelog-body">
+
+### Deprecated models removed
+
+<div className="changelog-tags"><span className="changelog-tag">Removed</span></div>
+
+- Retired models have been removed from the model list and pricing page. Requests naming them will fail — switch to a current model.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Jun 1, 2026</div>
+<div className="changelog-body">
+
+### MiniMax M3 and Claude Opus 4.8
+
+<div className="changelog-tags"><span className="changelog-tag">New Model</span></div>
+
+- Added **MiniMax M3** and **Claude Opus 4.8**, and reorganized the model sidebar so families group together.
+
+</div>
+</div>
diff --git a/changelog/mcp-server.md b/changelog/mcp-server.md
new file mode 100644
index 00000000..f455bc23
--- /dev/null
+++ b/changelog/mcp-server.md
@@ -0,0 +1,48 @@
+---
+title: 'MCP Server'
+description: 'Release notes for MCP Server.'
+---
+
+# MCP Server
+
+Release notes for MCP Server.
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 17, 2026</div>
+<div className="changelog-body">
+
+### Full tool list for TRON MCP Server
+
+<div className="changelog-tags"><span className="changelog-tag">Docs</span><span className="changelog-tag">TRON</span></div>
+
+- Added a **Tool List** page — every tool the TRON MCP Server exposes, with parameters, so you can see up front what your AI client will be able to call.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 10, 2026</div>
+<div className="changelog-body">
+
+### Two ways to connect
+
+<div className="changelog-tags"><span className="changelog-tag">New</span><span className="changelog-tag">TRON</span></div>
+
+- **Official Server Access** — point your client at the hosted endpoint, no infrastructure required.
+- **Local Private Deployment** — run the server yourself when keys and traffic need to stay in your own environment.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Feb 11, 2026</div>
+<div className="changelog-body">
+
+### TRON and BSC MCP Servers
+
+<div className="changelog-tags"><span className="changelog-tag">New</span></div>
+
+- First documentation for the **TRON MCP Server** and the **BSC MCP Server**, covering installation, features, and the API surface.
+
+</div>
+</div>
diff --git a/changelog/openclaw-extension.md b/changelog/openclaw-extension.md
new file mode 100644
index 00000000..bd9117ae
--- /dev/null
+++ b/changelog/openclaw-extension.md
@@ -0,0 +1,47 @@
+---
+title: 'Openclaw Extension'
+description: 'Release notes for the Openclaw Extension.'
+---
+
+# Openclaw Extension
+
+Release notes for the Openclaw Extension.
+
+<div className="changelog-entry">
+<div className="changelog-date">Apr 1, 2026</div>
+<div className="changelog-body">
+
+### TRON addresses are masked by default
+
+<div className="changelog-tags"><span className="changelog-tag">Privacy</span></div>
+
+- Wallet addresses now display masked in the extension UI — useful when you're screen-sharing or recording.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 31, 2026</div>
+<div className="changelog-body">
+
+### Windows setup
+
+<div className="changelog-tags"><span className="changelog-tag">New</span></div>
+
+- Added a **Windows installation guide** alongside the existing macOS and Linux steps, and expanded the general setup walkthrough.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 17, 2026</div>
+<div className="changelog-body">
+
+### First release
+
+<div className="changelog-tags"><span className="changelog-tag">New</span></div>
+
+- Published the **Introduction** and **Quick Start** for the Openclaw Extension — connect the browser extension to your Agent Wallet and start acting on-chain from the page you're already on.
+
+</div>
+</div>
diff --git a/changelog/skills.md b/changelog/skills.md
new file mode 100644
index 00000000..a97e5f5f
--- /dev/null
+++ b/changelog/skills.md
@@ -0,0 +1,48 @@
+---
+title: 'SKILLS'
+description: 'Release notes for SKILLS.'
+---
+
+# SKILLS
+
+Release notes for SKILLS.
+
+<div className="changelog-entry">
+<div className="changelog-date">Jul 10, 2026</div>
+<div className="changelog-body">
+
+### GasFree guidance and a new catalog URL
+
+<div className="changelog-tags"><span className="changelog-tag">Update</span><span className="changelog-tag">x402</span></div>
+
+- Skills now document the **`exact_gasfree` payment scheme** on TRON — pay for an x402 service without keeping TRX around for energy.
+- The **API catalog endpoint moved to a new URL**. Skills and the facilitator config were updated together; re-install if you pinned an older version.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Apr 15, 2026</div>
+<div className="changelog-body">
+
+### Introduction and one-line install
+
+<div className="changelog-tags"><span className="changelog-tag">Docs</span></div>
+
+- Added an **Introduction** page explaining what Skills give your AI, plus a **Quick Start** that gets you installed in a single command.
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">Mar 13, 2026</div>
+<div className="changelog-body">
+
+### BANK OF AI Skill
+
+<div className="changelog-tags"><span className="changelog-tag">New</span></div>
+
+- Published the **BANK OF AI Skill** reference — the bundle that teaches your AI client to read balances, quote swaps, and execute on-chain transactions through Agent Wallet.
+
+</div>
+</div>
diff --git a/changelog/x402.md b/changelog/x402.md
new file mode 100644
index 00000000..b5538e79
--- /dev/null
+++ b/changelog/x402.md
@@ -0,0 +1,30 @@
+---
+title: 'x402 Payment Protocol'
+description: 'Release notes for the x402 payment protocol, SDK, and CLI.'
+---
+
+# x402 Payment Protocol
+
+Release notes for the x402 protocol, SDK, and [CLI](../x402/cli/).
+
+<div className="changelog-entry">
+<div className="changelog-date">Jul 15, 2026</div>
+<div className="changelog-body">
+
+### x402 CLI v1.0.0
+
+<div className="changelog-tags"><span className="changelog-tag">New Release</span><span className="changelog-tag">CLI</span></div>
+
+First stable release of `@bankofai/x402-cli` — a TypeScript command-line client for x402 payments.
+
+- **`pay`** — pay any x402-protected URL: probe, read the `402` challenge, sign, and retry
+- **`serve`** — run a local x402 paywall endpoint that verifies and settles through a facilitator
+- **`roundtrip`** — start a temporary server, pay it, exit: the fastest end-to-end smoke test
+- **`gateway`** / **`catalog`** — validate and scaffold provider files; search, cache, and export the provider catalog
+- Built on the published `@bankofai/x402-core` / `x402-evm` / `x402-tron` SDK 1.0 packages; `scheme=exact` with Permit2
+- Networks: TRON (`tron:mainnet` / `tron:nile` / `tron:shasta`) and BSC (`eip155:56` / `eip155:97`)
+
+👉 Get started: [x402 CLI Quick Start](../x402/cli/quickstart/)
+
+</div>
+</div>
diff --git a/devnotes/first-onchain-swap.md b/devnotes/first-onchain-swap.md
new file mode 100644
index 00000000..d46bb0b3
--- /dev/null
+++ b/devnotes/first-onchain-swap.md
@@ -0,0 +1,116 @@
+---
+title: 'Your First On-Chain Swap, Step by Step'
+description: 'A practical walkthrough: from installing Skills to completing a real swap on the Nile testnet — including what to check at each step and what to do when it fails.'
+---
+
+# Your First On-Chain Swap, Step by Step
+
+The [Quick Start](/BANK-OF-AI/QuickStart/) gets you installed in a minute. This note picks up where it ends: a complete, realistic walkthrough of one on-chain task — with the checks worth making at each step, and what to do when something breaks.
+
+We'll swap **TRX for USDT on the Nile testnet**. Testnet tokens are free, so nothing here costs real money.
+
+---
+
+## Before you start
+
+You need three things:
+
+1. Skills installed and a wallet created — see [Quick Start](/BANK-OF-AI/QuickStart/)
+2. A TRON **Nile testnet** address with some test TRX
+3. Your AI client open (OpenClaw, Claude Code, Cursor, Codex — whichever you use)
+
+Get test TRX from the [Nile faucet](https://nileex.io/join/getJoinPage). You'll need TRX both as the asset to swap and to pay for energy.
+
+---
+
+## Step 1: Confirm what you're working with
+
+Before any transaction, check the state you're starting from:
+
+> Show my wallet address and my TRX balance on the Nile testnet.
+
+The AI returns your address and balance. Two things to verify:
+
+- **The address is the one you funded.** If you created multiple wallets, the AI uses the active one — easy to mix up.
+- **The balance is non-zero.** A brand-new TRON address stays "inactive" until it receives its first transfer, and an inactive account can't sign contract calls.
+
+If the balance is zero or the account shows as inactive, fund it from the faucet and check again before continuing.
+
+---
+
+## Step 2: Get a quote before you commit
+
+Never let the first on-chain action be the transaction itself. Ask for a quote:
+
+> On the Nile testnet, how much USDT would I get for 100 TRX on SunSwap?
+
+The AI queries SunSwap and returns the expected output. This is a read-only call — nothing is signed and nothing is spent.
+
+Take a moment on the number it gives you. If the rate looks far off from what you expect, stop and investigate rather than proceeding. A quote that seems wrong usually means low liquidity in the pool, or the wrong token being resolved — both are much cheaper to catch now than after signing.
+
+---
+
+## Step 3: Run the swap
+
+Now the real thing:
+
+> Swap 100 TRX for USDT on the Nile testnet, with 1% max slippage.
+
+Two details in that sentence matter:
+
+- **State the network explicitly.** Otherwise the AI may default to mainnet, where the same command spends real money.
+- **State the slippage.** It caps how much worse than the quote you'll accept. Without it you're agreeing to whatever the pool gives you at execution time.
+
+The AI now works through a standard sequence: check balance → check token approval → fetch a fresh quote → calculate slippage → **show you the bill** → wait.
+
+It stops there. Nothing is signed until you confirm.
+
+Read the bill before you approve it — the amount out, the recipient, and the network. This is the last point where a mistake is free.
+
+---
+
+## Step 4: Verify on-chain
+
+After you confirm, the AI signs locally, broadcasts, and returns a transaction hash. That hash is the proof, not the AI's summary — check it:
+
+> Look up that transaction on TronScan and show me the result.
+
+Or paste the hash into [Nile TronScan](https://nile.tronscan.org) yourself. Confirm the status is success and the token amount matches what you approved.
+
+---
+
+## When it doesn't work
+
+Four failures cover almost everything you'll hit early on:
+
+**"Account not activated"** — the address has never received anything on-chain. Send it a small amount of TRX first; activation is a one-time thing per address.
+
+**"Insufficient energy" / the transaction fails at broadcast** — TRON charges energy for contract calls. Keep some TRX beyond the amount you're swapping, or stake TRX for energy.
+
+**"Insufficient allowance" or an approval error** — spending a TRC-20 token requires a one-time approval of the DEX contract. The AI normally handles this automatically; if it errors here, ask it directly: *"Approve SunSwap to spend my USDT, then retry the swap."*
+
+**The quote and the result differ noticeably** — this is slippage doing its job. On thin testnet pools it's common. Lower the amount, or state a tighter slippage and let the transaction revert rather than fill badly.
+
+---
+
+## What to do next
+
+Once the swap works, the same pattern extends to everything else — check state, preview, execute, verify:
+
+> Check the holder distribution of this token: `<address>`
+
+> Transfer 10 USDT to `<address>` on the Nile testnet.
+
+> Stake 100 TRX and show me my current TRON Power.
+
+Two habits worth keeping past the testnet stage: **always run a read-only query before a write**, and **always state the network explicitly**. Both take a second and both prevent the expensive kind of mistake.
+
+When you move to mainnet, run the same task once with a small amount before doing it at full size.
+
+---
+
+## Related
+
+- [Quick Start](/BANK-OF-AI/QuickStart/) — install and create your wallet
+- [Skills](/McpServer-Skills/SKILLS/Intro/) — the full list of what your AI can do
+- [Agent Wallet](/Agent-Wallet/Intro/) — how keys are stored and signing works
diff --git a/devnotes/index.md b/devnotes/index.md
new file mode 100644
index 00000000..6d1bc88e
--- /dev/null
+++ b/devnotes/index.md
@@ -0,0 +1,12 @@
+---
+title: 'Best Practices'
+description: 'Practical, battle-tested guidance from the BANK OF AI team — hands-on walkthroughs and the habits worth keeping.'
+---
+
+# Best Practices
+
+Practical, battle-tested guidance from the BANK OF AI team — hands-on walkthroughs and the habits worth keeping when you put your AI to work on-chain.
+
+## Practices
+
+- [**Your First On-Chain Swap, Step by Step**](./first-onchain-swap/) — a complete walkthrough of one real task on the Nile testnet, including what to check at each step and what to do when it fails.
diff --git a/docs/BANK-OF-AI/Intro.md b/docs/BANK-OF-AI/Intro.md
index 9d57cc46..d9c42165 100644
--- a/docs/BANK-OF-AI/Intro.md
+++ b/docs/BANK-OF-AI/Intro.md
@@ -1,249 +1,192 @@
-# Introduction
-
-## BANK OF AI in One Sentence
-
-**BANK OF AI — Your Web3 Gateway to AI.**
-
-One entry point gives your AI four core capabilities at once:
-
-- 💸 **Payment** — pay in crypto (x402)
-- 🪪 **Identity** — a verifiable on-chain identity and reputation (8004)
-- ⚙️ **Action** — call the full set of on-chain atomic capabilities, plus orchestration (Skills + MCP Server + Agent Wallet)
-- 🧠 **Cognition** — every top-tier LLM in one account (LLM Service)
-
-You don't need to write code, switch wallets, or hop between multiple dApps — just hand the task to your AI, and BANK OF AI lines up payment, identity, action, and brain for it.
-
 ---
-
-## The BANK OF AI Product Matrix
-
-BANK OF AI is made up of **4 layers**:
-
-- **🧠 Model Layer | Top AI in One Account** — LLM Service (BANKOFAI APP + API Gateway), a single entry point to every leading LLM
-- **🛤️ Protocol Layer | Payment. Verify. Build.** — x402 Payment · 8004 Protocol, two open protocols connecting AI and Web3
-- **🔧 Tool Layer | Everything Your Agent Needs** — Agent Wallet · Skills · MCP Server, the full toolkit giving your AI on-chain signing, operational SOPs, and protocol wrappers
-- **🌐 Ecosystem Layer | AI Agent Ecosystem** — Third-party MCP Servers and Skills across TRON / Ethereum / BNB Chain, all plugged into the same protocols
-
-Each layer is usable on its own, or composable with the others — pick what you need.
-
+title: 'Introduction'
+description: >-
+  BANK OF AI is the infrastructure connecting AI and Web3. Install it, and your AI can pay, prove its identity, and execute on-chain — you describe the goal, the AI gets it done.
 ---
 
-## 🧠 Model Layer | Top AI in One Account
-
-### LLM Service — A Unified Entry Point to Every Leading LLM
+# Introduction
 
-**LLM Service is BANK OF AI's model-access layer.** It aggregates GPT, Claude, Gemini, DeepSeek, Kimi, GLM, MiniMax, and other leading models under a single account, exposed two ways:
+Today's AI can write code, analyze data, build presentations — it can even deliver an entire software project on its own.
 
-- **BANKOFAI APP** (the official app, corresponding to the `BANKOFAI APP →` button in the top-right of the website): an AI Chat app for end users — open [chat.bankofai.io/chat](https://chat.bankofai.io/chat) and use it directly, switch models on demand
-- **API Gateway** (one API key for every model): a unified API for developers, billed by usage, OpenAI-compatible, usable from any OpenAI-compatible third-party AI client
+But tell it this:
 
-**Key points**: fund with crypto (supports TRON, BNB Chain, Ethereum, Base, Arbitrum, Optimism, Polygon), pay-as-you-go, no card linking, no subscription.
+> Swap 100 USDT for TRX.
 
-👉 Learn more: [LLM Service Introduction](../llmservice/introduction.md)
+and it can't do a thing. The problem isn't that it doesn't know how. The problem is that — **it has no way into Web3**.
 
 ---
 
-## 🛤️ Protocol Layer | Payment. Verify. Build.
-
-With the model layer in place, AI is still just a "brain." To let it spend on-chain and be verified, you first need two open protocols: **x402 defines how payments get made**, and **8004 defines who each Agent is.**
-
-### 01 · x402 Payment — One Line of Code for On-chain Payments
-
-**An open payment protocol built on an extension of HTTP `402 Payment Required`.** When AI calls a paid service, it automatically signs a small on-chain payment and instantly receives the content — no account, no credit card, no pre-funding.
+## What's missing?
 
-- **Currently supports**: TRON, BNB Chain (more chains rolling out)
-- **SDK components**: Client SDK · Server SDK · Facilitator
+To operate in Web3, AI is missing four essential capabilities:
 
-**Typical scenarios**:
+- 💸 **Payment** — no way to pay when a service charges for access
+- 🪪 **Identity** — no way to prove who it is on-chain
+- ⚙️ **Execution** — no connection to the blockchain, so nothing actually lands
+- 🔐 **Wallet** — can't hold assets, can't sign
 
-- MCP Server calls a paid off-chain API
-- The `x402-payment` Skill triggers payment explicitly
-- An AI Agent autonomously decides to buy paid content
-- **Agent-to-Agent auto-settlement** — pay-per-call between two AIs
-
-> ⚙️ **Dependency**: The x402 SDK uses [Agent-Wallet](#03--agent-wallet--ais-local-signing-layer) to parse and manage wallet credentials — installing x402 pulls in agent-wallet automatically.
-
-👉 Learn more: [x402 Protocol Introduction](../x402/index.md)
+A model solves "figuring it out." These four solve "getting it done." Supplying them is exactly why BANK OF AI exists.
 
 ---
 
-### 02 · 8004 Protocol — On-chain Identity and Reputation for AI Agents
-
-**A Web3-native "Agent Registry + Reputation System."** Any Agent can mint an identity NFT on-chain, bind its service endpoints (Web / MCP / DID), and openly accept feedback from other Agents and users.
-
-It solves one core question: **as AI Agents proliferate, how do you know which ones you can trust?**
-
-- **Standard metadata**: name, capability claims, service endpoints
-- **Verifiable credentials**: signatures + rotation policy
-- **Chain support**: TRON · BNB Chain
+## What is BANK OF AI?
 
-**Typical uses**:
+> **BANK OF AI is the infrastructure connecting AI and Web3.**
 
-- An AI Agent checks a stranger's on-chain reputation before calling its service
-- Skills orchestration runs a pre-flight risk check
-- MCP Servers verify each other's identity
-- Check a counterparty's reputation before paying or granting authorization
+It isn't a new model, a wallet app, or an exchange. It installs into the AI client you already use — OpenClaw, Claude Code, Cursor, Codex — and gives your AI what it needs to enter Web3, without changing how you work.
 
-8004 is a **horizontal protocol** — any step that needs "identity verification" or "reputation lookup" can call it; it isn't tied to a specific layer.
-
-👉 Learn more: [8004 Protocol Introduction](../8004/general.md)
+Once installed, your AI goes from "offering advice" to "getting things done." Here's what it gains.
 
 ---
 
-## 🔧 Tool Layer | Everything Your Agent Needs
-
-The protocol layer is in place — now AI needs tools to actually use those protocols. For any on-chain operation, AI needs three things: **on-chain signing (Agent Wallet), on-chain operation SOPs (Skills), and protocol wrappers (MCP Server)**.
+## What your AI gains
 
-### 03 · Agent Wallet — AI's Local Signing Layer
+<div className="intro-cards">
 
-**Agent Wallet is the AI Agent's local encrypted wallet**, providing unified signing for every Skill, MCP Server, and the x402 SDK.
+<div className="intro-card">
 
-Your private key is encrypted and locked in a hidden local directory; the AI only ever holds an unlock password. **Even if the password leaks, the encrypted file alone is useless. Even if the file is stolen, without the password it's just gibberish.**
+<div className="intro-card-title">💸 Payment</div>
 
-- 🔒 **Encrypted storage**: Keystore encryption + `local_secure` mode, 100% local and offline
-- 🔑 **Flexible import**: create new, or import from private key / mnemonic
-- 🔄 **Multi-wallet switching**: manage multiple wallets and switch the active account any time
-- ⛓️ **Multi-chain signing**: TRON + every EVM-compatible chain (Ethereum / BSC / Polygon / Base / Arbitrum…)
+Your AI can pay for APIs and Agent services automatically — always confirming with you before spending.
 
-> 💡 **Who depends on Agent-Wallet**:
-> - **x402 SDK** — parses payment credentials, signs x402 micropayments (pulled in automatically when x402 is installed)
-> - **Skills** — whenever an on-chain operation needs a signature
-> - **MCP Servers** (when self-hosted) — write-type tools read the local wallet before executing
+<div className="intro-card-links">
 
-**What users see**: when you first follow the [Quick Start](./QuickStart.md), Agent-Wallet is created and configured for you automatically — most users never touch it directly.
+[x402](../x402/index.md)
 
-👉 Learn more: [Agent-Wallet Introduction](../Agent-Wallet/Intro.md)
+</div>
 
----
+</div>
 
-### 04 · Skills — The SOP Playbook for AI On-chain Operations
+<div className="intro-card">
 
-**Skills are pre-written standard operating procedures for AI on-chain actions.** The AI Agent follows the Skill's SOP step by step — **check balance → check approval → fetch quote → apply slippage protection → wait for your confirmation → call MCP Server to execute** — nothing skipped, common pitfalls avoided.
+<div className="intro-card-title">⚙️ Execution</div>
 
-Example: a user says "use 50 USDT to buy some TRX." A vanilla AI might generate a transaction that fails because USDT was never approved on SunSwap. An AI loaded with the `sunswap-dex-trading` Skill walks the full SOP automatically.
+Your AI can run transfers, swaps, and staking through standard, checked workflows.
 
-**Key properties**: one sentence installs every Skill; invoked in natural language; automatically calls the underlying MCP Server to execute atomic on-chain operations. The BANK OF AI Skills suite covers wallet management, SunSwap swaps, SunPerp perpetuals, the TRC20 toolkit, TronScan lookups, TRX staking + SR voting, USDD/JUST, multi-sig permissions, x402 payments, and more — and keeps growing alongside the ecosystem.
+<div className="intro-card-links">
 
-👉 Learn more: [Skills Introduction](../McpServer-Skills/SKILLS/Intro.md) · [Quick Start](./QuickStart.md)
+[Skills](../McpServer-Skills/SKILLS/Intro.md) · [MCP Server](../McpServer-Skills/MCP/Intro.md)
 
----
+</div>
 
-### 05 · MCP Server — The On-chain Atomic Capability Interface
+</div>
 
-**MCP Server (Model Context Protocol Server)** is built on Anthropic's MCP standard. It wraps on-chain and off-chain capabilities into standardized, AI-callable tools.
+<div className="intro-card">
 
-**Relationship between Skills and MCP Server:**
+<div className="intro-card-title">🔐 Wallet</div>
 
-| Layer | Role | Responsibility |
-| :-- | :-- | :-- |
-| **Skills** | Business Orchestration Layer | Stringing multi-step operations into SOPs, handling pre-checks and risk control |
-| **MCP Server** | Capability Provider Layer | Exposing atomic capability tools for upper layers to call |
+Your AI can sign securely — your private key never leaves your device.
 
-BANK OF AI ships two **MCP Servers**, pointed at BANK OF AI cloud endpoints by default — ready to use out of the box:
+<div className="intro-card-links">
 
-- **TRON MCP Server** — atomic TRON on-chain operations (query, transfer, contracts, staking, governance), 60+ tools. Supports local private deployment
-- **SUN MCP Server** — SunSwap V2/V3/V4 swap and liquidity capabilities, 20+ tools. Supports local private deployment. Also ships **[SUN CLI](../McpServer-Skills/Tools/SUNCli/Intro.md)** — a command-line implementation fully equivalent to SUN MCP Server's capabilities, for scripting / automation / CI-CD scenarios
+[Agent Wallet](../Agent-Wallet/Intro.md)
 
-> 💡 **Private deployment**: Skills call MCP Server via the official cloud endpoints by default — no separate install needed. For local deployment, see each MCP Server's deployment guide.
+</div>
 
-> ⚙️ **Dependency**: A self-hosted MCP Server needs Agent-Wallet configured first — the wallet determines which identity the AI uses for on-chain actions. Without a wallet, write-type tools return an error.
+</div>
 
-Beyond BANK OF AI's first-party MCP Servers, the ecosystem has more third-party MCP Servers and Skills — see [🌐 Ecosystem Layer](#-ecosystem-layer--ai-agent-ecosystem) below.
+<div className="intro-card">
 
-👉 Learn more: [MCP Server Introduction](../McpServer-Skills/MCP/Intro.md)
+<div className="intro-card-title">🪪 Identity</div>
 
----
+Your AI has a verifiable on-chain identity, so Agents can trust and work with each other.
 
-## 🌐 Ecosystem Layer | AI Agent Ecosystem
+<div className="intro-card-links">
 
-Beyond BANK OF AI's first-party products, the ecosystem already includes several leading DeFi / data protocols across 3 chains — each shipping a **production-grade MCP Server or Skills** that AI can install and use immediately.
+[8004](../8004/general.md)
 
-### 🔴 TRON
+</div>
 
-| Product | Provider | Capabilities | Install |
-| :-- | :-- | :-- | :-- |
-| **TRON MCP Server** | BANK OF AI | Transfer / Contract / Staking / Governance, 60+ tools | `npx -y @bankofai/mcp-server-tron` |
-| **SUN MCP Server** | BANK OF AI | Swap / Liquidity / Farming, V2/V3/V4, 20+ tools | `npx -y @bankofai/sun-mcp-server` |
-| **JustLend MCP Server** | JustLend DAO | Lend / Borrow / Staking / Governance, 50 tools | `npx -y @justlend/mcp-server-justlend` |
-| **TronScan MCP Server** | TronScan | Query / Analytics / Security, 119 tools | `https://mcp.tronscan.org/mcp` |
+</div>
 
-### 🔵 Ethereum
+</div>
 
-| Product | Provider | Capabilities | Install |
-| :-- | :-- | :-- | :-- |
-| **Etherscan** | Etherscan Official | Query / Tracking / Analytics, 60+ chains | `npx skills add https://docs.etherscan.io` |
-| **Uniswap AI** | Uniswap Labs | Swap / Liquidity / V4 Hooks / 5 Plugins | `npx skills add Uniswap/uniswap-ai` |
+Reasoning, of course, your AI already has. BANK OF AI doesn't replace your model — it lets you switch freely between GPT, Claude, Gemini and others, and combine that reasoning with real Web3 capability ([LLM Service](../llmservice/introduction.md)).
 
-### 🟡 BNB Chain
+You don't need to memorize these product names, and there are no new commands or tools to learn. Just tell your AI what you want, the same way you'd chat with it:
 
-| Product | Provider | Capabilities | Install |
-| :-- | :-- | :-- | :-- |
-| **BNB Chain** | BNB Chain Official | Transfer / Contract / Query / 8004 identity registry | `npx skills add bnb-chain/bnbchain-skills` |
-| **PancakeSwap AI** | PancakeSwap Official | Swap / Liquidity / Farming, 3 Skills · 8 chains | `npx skills add pancakeswap/pancakeswap-ai` |
-| **ListaDAO** | ListaDAO Official | Lending / Staking / CDP, 3 Skills · 9 MCP tools | `npx skills add lista-dao/lista-skills` |
+> **You describe the goal. The AI gets it done.**
 
-> 💡 The ecosystem is expanding — refer to the official **[AI Agent Ecosystem](https://bankofai.io)** page for the latest list.
+Here's a real example of how these capabilities work together.
 
 ---
 
-## How BANK OF AI Layers Work Together
-
-The sections above covered what each of the 4 layers does. Below is what happens when they collaborate on a real operation — a **TRC20 transfer**, the most common case.
-
-<div style={{ textAlign: 'center', margin: '1.5rem 0' }}>
+## A real execution
 
-![AI Agent completes a TRC20 transfer through natural conversation](./image/bankofai-architecture.svg)
+Once installed, you say:
 
-</div>
+> Swap 100 USDT for TRX, keep slippage under 1%.
 
-**① Model Layer · Understanding Intent**
+The whole path, at a glance:
 
-In any AI client (OpenClaw / Cursor / Claude Code / Codex / …), you type a sentence:
+```text
+User
+ ↓
+AI interprets the request
+ ↓
+Selects a Skill or calls an MCP Server
+ ↓
+Agent Wallet signs
+ ↓
+Transaction broadcast
+ ↓
+Blockchain
+ ↓
+Result
+```
 
-> Transfer 100 TRX to address `T....XXXXX`
+If anything goes wrong along the way — insufficient balance, a malformed address — the AI stops immediately and tells you why. And anything that spends money always needs your confirmation first.
 
-The AI client is powered by **LLM Service**, recognizes this as a TRC20 / TRX transfer, and decides to call the `trc20-token-toolkit` Skill.
+---
 
-**② Tool Layer · Skills Orchestration**
+## Architecture
 
-`trc20-token-toolkit` walks its SOP step by step: **check balance → validate the recipient address → build the transaction → wait for your confirmation.** If any step fails (insufficient balance, malformed address, etc.), it stops immediately and returns the reason.
+Abstract that path into a diagram, and you have all of BANK OF AI:
 
-**③ Tool Layer · MCP + Wallet · Build · Sign · Submit**
+```text
+    AI
+    │
+BANK OF AI
+    │
+   Web3
+```
 
-The Skill calls **TRON MCP Server** to assemble the TRC20 transfer, hands it to **Agent-Wallet** for local signing on your machine (**private keys never leave your computer**), and submits it to TRON Mainnet.
+Internally it's four layers, each with a single job:
 
-**④ Return · The result travels back to the AI Agent**
+| Layer | What it does |
+| :-- | :-- |
+| 🧠 Model | Provides reasoning — pick whichever model fits |
+| 🛤️ Protocol | Sets the rules: how to pay, how to prove identity |
+| 🔧 Tool | Handles execution: workflows, tools, signing |
+| 🌐 Ecosystem | Connects third-party services across chains through one standard |
 
-Once on-chain execution completes, the tx hash, status, and event logs travel back along the same path — MCP Server parses them into structured data, and the AI Agent turns that into a natural-language summary:
+Each layer works on its own, or combines into the full platform. Later chapters cover the design and usage of each one — for now, a general picture is all you need.
 
-> ✅ Transferred 100 TRX to `T....XXXXX`. Fee: 1.1 TRX.
-> Tx hash: `0xabc123...def456` ([view on TronScan](https://tronscan.org))
+---
 
-:::tip When do the other two layers engage?
-This example only involves the **Model Layer** and **Tool Layer**. The other two kick in by scenario:
+## Want to go deeper?
 
-- **🛤️ Protocol Layer**: **x402** activates when a payment is involved (calling a paid API, subscribing to an Agent service, etc.); **8004** activates when verifying an unfamiliar Agent's identity or looking up its reputation
-- **🌐 Ecosystem Layer**: when you need to call a third-party protocol (e.g. swapping on Ethereum via **Uniswap AI**, staking on BNB Chain via **ListaDAO**), the AI Agent calls the corresponding third-party MCP Server / Skills — the flow is identical to this example, just with a different MCP Server at the target chain
-:::
+| If you want to understand | Go here |
+| :-- | :-- |
+| How AI uses multiple models | [LLM Service](../llmservice/introduction.md) |
+| How AI pays automatically | [x402 Payment Protocol](../x402/index.md) |
+| On-chain identity and reputation | [8004 Protocol](../8004/general.md) |
+| How keys are stored and signing works | [Agent Wallet](../Agent-Wallet/Intro.md) |
+| The workflows AI follows | [Skills](../McpServer-Skills/SKILLS/Intro.md) |
+| How AI calls on-chain tools | [MCP Server](../McpServer-Skills/MCP/Intro.md) |
 
 ---
 
-## Is BANK OF AI for Me?
+## Your turn
 
-- **Web3 beginner:** Absolutely. Paste one install command into your AI client, and everything else is configured automatically; from there, plain-language conversation is all you need — no underlying knowledge required.
-- **Web3 veteran:** Skip the "switch wallet → copy address → calculate slippage → wait for blocks" grind. Let AI handle the repetitive work; you focus on strategy.
-- **AI Agent developer:** Full SDKs, CLIs, APIs, and MCP-standard interfaces — build your own AI Agents on top of BANK OF AI, giving them on-chain capability and autonomous payment.
-- **API service provider:** With x402, your paid APIs can be called by AI and billed per call automatically — no traditional account registration, no credit-card binding required. Especially well-suited for micropayments and agent-to-agent settlement.
-
----
+You now know what BANK OF AI is, why it exists, and how it works. One step left: try it yourself.
 
-## Ready?
+Setup takes about a minute — paste an install command, then confirm wallet creation. After that, you can give your AI its first on-chain instruction:
 
-Want your AI client to gain BANK OF AI's on-chain capabilities? Just **two steps**, under **1 minute**:
+> Check my wallet balance.
 
-1. **Paste the install command** → AI installs Skills, checks wallet status, and asks whether to create a wallet
-2. **Confirm wallet creation** → AI automatically creates your local encrypted wallet
+From that moment on, your AI has Web3 capability, and everything that follows happens in plain language.
 
-For standalone integration of **LLM Service / x402 / 8004**, or **local private deployment of MCP Server / using SUN CLI**, refer to each product's own docs.
+Whether you're checking assets, executing trades, or calling on-chain services — describe the goal, and leave the rest to your AI.
 
 👉 **[Go to Quick Start](./QuickStart.md)**
diff --git a/docs/BANK-OF-AI/QuickStart.md b/docs/BANK-OF-AI/QuickStart.md
index 306e3793..80475ec8 100644
--- a/docs/BANK-OF-AI/QuickStart.md
+++ b/docs/BANK-OF-AI/QuickStart.md
@@ -5,6 +5,13 @@ Want your AI client to gain BANK OF AI's on-chain capabilities? Just **two steps
 1. **Paste the install command** → AI installs every Skill, checks wallet status, and asks whether to create a wallet
 2. **Confirm wallet creation** → AI automatically creates your local encrypted wallet
 
+**No coding, no pre-existing wallet needed** — all you'll actually do is copy one message and reply with one letter.
+
+**Before you start, you need:**
+
+- An AI client that supports Skills: **OpenClaw / Claude Code / Cursor / Codex** — whichever you already use
+- **Node.js** on your machine (the AI runs `npx` during install). Not sure if you have it? Just start Step 1 — if the AI reports `npx` is unavailable, install it from [nodejs.org](https://nodejs.org/) and retry
+
 ---
 
 ## Step 1: Paste the Install Command
@@ -84,7 +91,9 @@ The AI will install the Skills and then ask whether to create a wallet.
 
 ## Step 2: Confirm Wallet Creation
 
-Confirm wallet creation however the AI prompts you (e.g. reply "create", "go ahead", or whichever option the AI offers). The AI will create your local encrypted wallet and, in one message, show your wallet info, addresses, master password, and suggested next steps.
+Confirm wallet creation however the AI prompts you (e.g. reply "A", "create", or whichever option the AI offers). The AI will create your local encrypted wallet and, in one message, show your wallet info, addresses, master password, and suggested next steps.
+
+⚠️ **When the master password appears, pause:** it is shown **only this once** — it's the one and only key to your safe. Copy it into a password manager (1Password / Bitwarden / etc.) right now, then continue. See [Safety First](#a-few-reminders) below.
 
 <details>
 <summary>Show example AI output</summary>
@@ -156,7 +165,7 @@ Open your AI chat and send:
 Check the TRX and USDT balances of the wallet address you just created.
 ```
 
-If the AI returns the balance — **congrats, the full stack is live and ready to use.**
+If the AI returns the balance — **congrats, you now have an AI butler that can work on-chain!** Everything is in place; from here on, just tell it what you want.
 
 :::note What a brand-new wallet may show
 A TRON address that has never received any transfer is considered **not activated**, so the query may report **balance 0 / account not activated**. This is completely normal for a fresh wallet and doesn't prevent you from using BANK OF AI.
@@ -196,31 +205,28 @@ Just describe what you want in plain language:
 
 ## A Few Reminders
 
-:::warning Three Rules for Beginners · On-chain transactions are irreversible
+:::warning Safety First · On-chain transactions are irreversible
+
+**Three rules for beginners:**
+
 1. **Always practice on testnet first.** Run 1–2 transactions on Nile testnet, confirm the AI behaves exactly as expected, *then* switch to mainnet.
 2. **Review the AI's bill before every spending action.**
 3. **Start small.** Even for operations you've tested, use a small amount the first time you run them on mainnet.
-:::
 
-:::caution The master password is critical — back it up immediately
-The master password is shown **exactly once in Step 2**. It's auto-saved to `~/.agent-wallet/runtime_secrets.json` locally, but we strongly recommend **also saving it manually in a password manager** (1Password / Bitwarden / etc.). If the local file is ever lost or corrupted *and* you have no external backup, your wallet becomes **permanently unrecoverable** (no recovery mechanism, no support, no backdoors).
+**Back up the master password immediately:** it is shown **exactly once in Step 2**. It's auto-saved to `~/.agent-wallet/runtime_secrets.json` locally, but we strongly recommend **also saving it manually in a password manager** (1Password / Bitwarden / etc.). If the local file is ever lost or corrupted *and* you have no external backup, your wallet becomes **permanently unrecoverable** (no recovery mechanism, no support, no backdoors). **Never** paste this password into chat tools, emails, screenshots, or public repos.
 
-⚠️ **Never** paste this password into chat tools, emails, screenshots, or public repos.
 :::
 
-:::info If you skip wallet creation in Step 2
-The AI skips wallet creation. When you're ready, you can trigger **conversational wallet creation** right in the AI chat at any time — no need to re-run the install command. See [Agent-Wallet Quick Start · Option 1: Conversational Creation](../Agent-Wallet/QuickStart.md).
-:::
+**If you skip wallet creation in Step 2** — the AI skips wallet creation. When you're ready, you can trigger **conversational wallet creation** right in the AI chat at any time, no need to re-run the install command. See [Agent-Wallet Quick Start · Option 1: Conversational Creation](../Agent-Wallet/QuickStart.md).
 
-:::tip Want to use the other products independently, or self-host?
-**The full BANK OF AI product matrix is more than Skills.** To use the other products independently or to self-host the lower layers, see:
+### Want to use the other products independently, or self-host?
+
+The full BANK OF AI product matrix is more than Skills. To use the other products independently or to self-host the lower layers, see:
 
 - **LLM Service** (model-access layer): use BANKOFAI APP directly, or connect to the unified API Gateway → [LLM Service Introduction](../llmservice/introduction.md)
 - **x402 Payment** (payment protocol): let AI auto-settle micropayments on-chain → [x402 Protocol Introduction](../x402/index.md)
 - **8004 Protocol** (identity + reputation): on-chain reputation lookup for Agents → [8004 Protocol Introduction](../8004/general.md)
-- **MCP Server local private deployment**: Skills call MCP Server through BANK OF AI's official cloud endpoints by default — no separate install needed. For local deployment, see [TRON MCP — Local Private Deployment](../McpServer-Skills/MCP/TRONMCPServer/LocalPrivatizedDeployment.md) · [SUN MCP — Local Private Deployment](../McpServer-Skills/MCP/SUNMCPServer/LocalPrivatizedDeployment.md) · [BSC MCP — Installation](../McpServer-Skills/MCP/BSCMCPServer/Installation.md)
-- **SUN CLI**: a command-line tool with capabilities equivalent to SUN MCP Server, for scripting / automation / CI-CD → [SUN CLI Quick Start](../McpServer-Skills/Tools/SUNCli/QuickStart.md)
-:::
+- **MCP Server local private deployment**: Skills call MCP Server through BANK OF AI's official cloud endpoints by default — no separate install needed. For local deployment, see [TRON MCP — Local Private Deployment](../McpServer-Skills/MCP/TRONMCPServer/LocalPrivatizedDeployment.md) · [BSC MCP — Installation](../McpServer-Skills/MCP/BSCMCPServer/Installation.md)
 
 ---
 
diff --git a/docs/McpServer-Skills/Intro.md b/docs/McpServer-Skills/Intro.md
deleted file mode 100644
index 1ed5acb0..00000000
--- a/docs/McpServer-Skills/Intro.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# Introduction
-
-BANK OF AI provides a comprehensive AI Agent capability framework through **MCP Server** and **Skills**: the former delivers standardized blockchain interaction capabilities, while the latter organizes these capabilities into executable workflows, enabling AI Agents to perform complex operations in on-chain environments.
-
-* **MCP Server** is designed to provide a standardized framework for interactions between Large Language Models (LLMs) and external tools and data sources. Its core lies in a well-defined client-server architecture and layered communication mechanism, ensuring that AI applications can securely and efficiently access and utilize external information.
-
-* **Skills** are capability abstractions that orchestrate multiple tools into structured workflows, enabling AI Agents to complete complex, multi-step tasks.
-
-## Quick Navigation
-
-- **Learn about MCP Server**: Go to [MCP Server Introduction](./MCP/Intro.md) to understand the protocol architecture and communication mechanisms.
-- **Learn about Skills**: Go to [Skills Introduction](./SKILLS/Intro.md) to understand the design philosophy and usage of skill packages.
diff --git a/docs/McpServer-Skills/MCP/Intro.md b/docs/McpServer-Skills/MCP/Intro.md
index 76da6657..074c3d6f 100644
--- a/docs/McpServer-Skills/MCP/Intro.md
+++ b/docs/McpServer-Skills/MCP/Intro.md
@@ -8,7 +8,7 @@ MCP follows a **client-server** architecture, primarily comprising the following
 
 *   **MCP Host**: Typically the AI application itself. It is responsible for coordinating and managing one or more MCP Clients.
 *   **MCP Client**: Instantiated by the MCP Host for each MCP Server. Each client maintains a dedicated connection with its corresponding MCP Server and obtains context information from the MCP Server for the host to use.
-*   **MCP Server**: A program responsible for providing context data to MCP Clients. Servers can run locally (e.g., a filesystem server) or remotely (e.g., a TRON MCP/SUN MCP server).
+*   **MCP Server**: A program responsible for providing context data to MCP Clients. Servers can run locally (e.g., a filesystem server) or remotely (e.g., a TRON MCP server).
 
 This architecture allows AI applications to connect to different MCP Servers simultaneously through multiple clients, thereby expanding their capabilities.
 
diff --git a/docs/McpServer-Skills/MCP/SUNMCPServer/FAQ.md b/docs/McpServer-Skills/MCP/SUNMCPServer/FAQ.md
deleted file mode 100644
index 6494e046..00000000
--- a/docs/McpServer-Skills/MCP/SUNMCPServer/FAQ.md
+++ /dev/null
@@ -1,481 +0,0 @@
----
-title: FAQ & Troubleshooting
-description: SUN MCP Server FAQ covering connection, authentication, DeFi operations and troubleshooting.
----
-
-# FAQ & Troubleshooting
-
-This page collects frequently asked questions when using SUN MCP Server and their solutions.
-
-## Connection Issues
-
-### MCP client "Cannot Connect to MCP Server"
-
-**Symptom:** MCP client shows server unresponsive or connection refused.
-
-**Resolution Steps:**
-
-1. **Check Node.js Installation**
-   ```bash
-   node --version  # Should return v18+
-   npm --version
-   ```
-
-2. **Verify Server Running**
-   ```bash
-   # If using official server
-   npx -y @bankofai/sun-mcp-server
-   
-   # If using local deployment
-   npm start
-   ```
-
-3. **Check JSON Format**
-   - Verify JSON format of `stdio.json` in MCP client configuration
-   - Common errors: trailing commas, unmatched brackets
-
-4. **Restart MCP client**
-   - Completely close application
-   - Clear client cache (method depends on your specific MCP client)
-   - Restart application
-
-5. **Check Server Logs**
-   ```bash
-   # If using official server, enable verbose logging
-   DEBUG=* npx -y @bankofai/sun-mcp-server
-   ```
-
-**If issue persists:** See [Official Server Access Guide](OfficialServerAccess.md) for latest configuration examples.
-
-### "Connection Refused" in HTTP Mode
-
-**Symptom:** Getting connection refused error when trying to connect via HTTP.
-
-**Common Causes and Solutions:**
-
-1. **Server Not Running**
-   ```bash
-   # Start server in HTTP mode
-   sun-mcp-server --http --port 8080
-   ```
-
-2. **Port 8080 Already in Use**
-   ```bash
-   # Check port usage
-   lsof -i :8080
-   
-   # Use different port
-   sun-mcp-server --http --port 8081
-   ```
-
-3. **Firewall Blocking Connection**
-   - Check local firewall rules
-   - Ensure localhost:8080 connection is allowed
-   - On macOS: System Settings > Security & Privacy > Firewall
-
-4. **Confirm Server Address**
-   - Use `http://localhost:8080` rather than `127.0.0.1:8080`
-   - Ensure no typos
-
-### Only Read Tools in Tool List
-
-**Symptom:** Cannot see `sunswap_swap`, `sunswap_add_liquidity` and other write tools.
-
-**Cause:** No wallet configured.
-
-**Solution:**
-
-1. **Configure [Agent Wallet](../../../Agent-Wallet/Intro.md)** — set `AGENT_WALLET_PASSWORD`
-   ```bash
-   export AGENT_WALLET_PASSWORD='your_password'
-   ```
-
-2. **Restart server** and reconnect MCP client
-
-Verify successful configuration by checking [Full Capability List](ToolList.md) for Full Capability List.
-
-## Authentication and Key Issues
-
-### "Invalid Private Key" Error
-
-**Symptom:** Server rejects provided private key.
-
-**Private Key Format Requirements:**
-- Must be 64 hexadecimal characters (excluding `0x` prefix)
-- Valid range: `0x0000000000000000000000000000000000000000000000000000000000000001` to `0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364140`
-
-**Verification Steps:**
-```bash
-# Check private key length
-echo -n "your_private_key" | wc -c
-# Should output 64
-
-# Check if valid hexadecimal
-echo "your_private_key" | grep -E '^[0-9a-fA-F]{64}$'
-# If output exists, format is correct
-```
-
-**Common Errors:**
-- Contains `0x` prefix (remove it)
-- Length less than 64 characters (get complete key from export tool)
-- Contains spaces or special characters
-
-### "Agent Wallet Password Incorrect"
-
-**Symptom:** Server cannot decrypt Agent Wallet.
-
-**Resolution Steps:**
-
-1. **Verify password is set**: Run `[[ -n "$AGENT_WALLET_PASSWORD" ]] && echo "Password is set" || echo "Password NOT set"` to confirm the variable is set without revealing the value.
-2. **Check wallet directory**: Verify `~/.agent-wallet/` exists and contains wallet files. If you used a custom directory, ensure `AGENT_WALLET_DIR` points to the correct path.
-3. **If password is lost**: You'll need to re-initialize the wallet. **Warning: this wipes all wallets and keys — ensure funds are moved or mnemonics backed up before proceeding.** Run `agent-wallet reset` to wipe and start over — see [CLI Reference → Reset](../../../Agent-Wallet/Developer/CLI-Reference.md#agent-wallet-reset-reset-all-data) and [Agent-Wallet FAQ](../../../Agent-Wallet/FAQ.md) for details. Passwords with special characters are supported — use single quotes when setting the environment variable.
-
-
-### "Wallet Not Found" or Initialization Error
-
-**Symptom:** Server cannot find or initialize wallet.
-
-**Cause:** Agent Wallet not properly configured.
-
-**Solution:** Ensure Agent Wallet is installed and configured:
-
-```bash
-# Set Agent Wallet password
-export AGENT_WALLET_PASSWORD='your_password'
-
-# Optional: specify custom wallet directory
-export AGENT_WALLET_DIR="$HOME/.agent-wallet"
-
-# Restart server
-sun-mcp-server
-```
-
-If you haven't initialized Agent Wallet yet, see the [Agent-Wallet documentation](../../../Agent-Wallet/Intro.md) for setup instructions.
-
-## DeFi Operation Errors
-
-### "Swap Failed"
-
-**Symptom:** `sunswap_swap` call returns error.
-
-**Common Causes and Solutions:**
-
-1. **Insufficient Balance**
-   ```bash
-   # Check source token balance
-   sunswap_get_balances  # List all balances
-   ```
-   - Confirm sufficient source tokens
-   - Account amount should include Gas fees
-
-2. **Slippage Tolerance Too Low**
-   ```
-   # Example: 2% slippage tolerance may not be enough
-   Increase to 3-5%
-   ```
-   - May need higher tolerance in volatile markets
-   - But higher tolerance increases frontrunning risk
-
-3. **Token Not Tradeable**
-   - Check if token listed on SunSwap
-   - Some new tokens may not support trading
-   - Verify token contract address is correct
-
-4. **Insufficient Liquidity**
-   ```
-   Use sunswap_quote_exact_input to check available liquidity
-   ```
-   - Small trades may fail
-   - Try smaller amount or use multi-hop routes
-
-**Diagnostic Steps:**
-```
-1. Check balance
-2. Use sunswap_quote_exact_input to estimate output
-3. Try higher slippage tolerance
-4. Check network status
-```
-
-### "Add Liquidity Failed"
-
-**Symptom:** `sunswap_add_liquidity` returns error.
-
-**Common Causes and Solutions:**
-
-1. **Tokens Not Authorized**
-   ```
-   Need to authorize both tokens for SunSwap contract
-   ```
-   - Call `sunswap_approve_token` or `permit2_approve`
-   - Grant sufficient amount
-   - Both tokens need authorization
-
-2. **Amount Ratio Not Reasonable**
-   ```
-   Current price may have changed
-   Reduce slippage tolerance to allow wider ratio range
-   ```
-   - Check current pool price
-   - Adjust token amounts to match pool ratio
-   - Or increase tolerance percentage
-
-3. **Amount Too Small**
-   ```
-   Minimum liquidity requirement may not be met
-   ```
-   - Try increasing amount
-   - Check SunSwap's minimum position requirement
-
-4. **Pool Doesn't Exist**
-   - Verify trading pair exists on SunSwap
-   - Check fee tier is correct (V2: 0.3%, V3: 0.01%-1%)
-
-**Diagnostic Tip:** Always verify balance and authorization first, before calling add liquidity.
-
-### "Permit2 Signature Failed"
-
-**Symptom:** Permit2 authorization returns signature error.
-
-**Resolution Steps:**
-
-1. **Check Wallet Support**
-   ```bash
-   # Agent Wallet must support signTypedData
-   [[ -n "$AGENT_WALLET_PASSWORD" ]] && echo "Password is set" || echo "Password NOT set"
-   ```
-
-2. **Verify Signature Data**
-   - Check Permit2 request structured data
-   - Confirm chain ID, token address, deadline correct
-
-3. **Reinitialize Wallet** — run `agent-wallet reset` to wipe and start over. See [CLI Reference → Reset](../../../Agent-Wallet/Developer/CLI-Reference.md#agent-wallet-reset-reset-all-data) for details.
-
-4. **Use Alternate Authorization Method**
-   ```
-   If Permit2 continues to fail, use sunswap_approve_token instead
-   ```
-
-### Transaction Shows "REVERT" Status
-
-**Symptom:** Transaction submitted but reverted on-chain.
-
-**Common Causes:**
-
-1. **Balance Decreased After Transaction Signed**
-   - Wallet may be participating in other transactions simultaneously
-   - Space sufficient time between submissions
-
-2. **Slippage Price Changed**
-   - Price changed while transaction queued
-   - Increase slippage tolerance and retry
-
-3. **Contract State Changed**
-   - Pool or token contract updated
-   - Retry after one block
-
-4. **Insufficient Authorization**
-   - Permit2 authorization expired or used up
-   - Re-authorize and retry
-
-5. **Insufficient Gas**
-   - Uncommon on TRON, but check account balance
-   - Ensure account has sufficient TRX as Gas
-
-**Debug Tip:**
-```
-Check transaction hash details on https://tronscan.org for error message
-```
-
-## AI Behavior Issues
-
-### AI Constructed Invalid Token Address
-
-**Symptom:** AI used non-existent token address, causing operation failure.
-
-**Solution:**
-
-1. **Provide Accurate Address in Prompt**
-   ```
-   Please use USDT (TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t)
-   ```
-
-2. **Use Official Token List**
-   - Get address from SunSwap or TronScan
-   - Always verify address format (case and length)
-
-3. **Have AI Verify Address**
-   ```
-   Before executing any operation, use sunswap_get_token_price
-   to verify token exists
-   ```
-
-### AI Tried to Call Non-existent Tool
-
-**Symptom:** AI called `invalid_tool_name` or other non-existent tool.
-
-**Solution:**
-
-1. **Reference Official Tool List**
-   - Check [SUN MCP Server Tool List](ToolList.md)
-   - Provide correct tool names to AI
-
-2. **Explicitly List Tools in Prompt**
-   ```
-   Available swap tools include:
-   - sunswap_swap
-   - sunswap_quote_exact_input
-   - sunswap_quote_exact_output
-   ```
-
-3. **Simplify Request**
-   - Request single operation rather than complex multi-step workflow
-   - AI will call correct tool more reliably
-
-### Slow Response Speed
-
-**Symptom:** Querying data or executing operations takes long time.
-
-**Optimization Steps:**
-
-1. **Simplify Workflow**
-   - Reduce multi-tool coordination steps
-   - Avoid large number of consecutive queries
-
-2. **Use Local Server**
-   - See [Local Privatized Deployment](LocalPrivatizedDeployment.md)
-   - May be faster than official server (depends on network)
-
-3. **Batch Operations**
-   ```
-   Merge related queries to reduce round trips
-   ```
-
-## General Questions
-
-### What's the Difference Between Mainnet, Nile and Shasta?
-
-| Feature | Mainnet | Nile Testnet | Shasta Testnet |
-|------|---|---|---|
-| **Purpose** | Production | Official testing | Community testing |
-| **Network Parameter** | `mainnet` | `nile` | `shasta` |
-| **Real Value** | Yes | No (test TRX) | No (test TRX) |
-| **Transaction Finality** | Immediate | Immediate | Immediate |
-| **Recommended Use** | Production DeFi | Development and testing | Experimentation |
-| **Stability** | Highest | High | Medium |
-| **Get Test TRX** | N/A | [Nile Faucet](https://nile.trongrid.io/join/getjoined) | [Shasta Faucet](https://shasta.trongrid.io/join/getjoined) |
-
-**Best Practice:**
-- Always use Nile during development
-- Final testing on Shasta
-- Only migrate to mainnet after sufficient verification
-
-### Can I Use Multiple MCP Server Instances Simultaneously?
-
-**Yes.** For example, can run official mainnet server and local Nile instance simultaneously.
-
-**Configuration Example (MCP client):**
-
-```json
-{
-  "mcpServers": {
-    "sun-mainnet": {
-      "command": "npx",
-      "args": ["-y", "@bankofai/sun-mcp-server"],
-      "env": {
-        "TRON_NETWORK": "mainnet",
-        "AGENT_WALLET_PASSWORD": "your_mainnet_password"
-      }
-    },
-    "sun-nile": {
-      "command": "sun-mcp-server",
-      "args": ["--port", "8081"],
-      "env": {
-        "TRON_NETWORK": "nile",
-        "AGENT_WALLET_PASSWORD": "your_testnet_password"
-      }
-    }
-  }
-}
-```
-
-**Note:** Use different wallet credentials for each instance to avoid confusion.
-
-### How to Update to Latest Version?
-
-**Using npx (Recommended):**
-```bash
-# npx automatically gets latest version
-npx -y @bankofai/sun-mcp-server
-
-# Force clear cache and get latest version
-npx --clear-cache -y @bankofai/sun-mcp-server
-```
-
-**Using Local Installation:**
-```bash
-# Update global installation
-npm install -g @bankofai/sun-mcp-server
-
-# Or update in project
-npm update @bankofai/sun-mcp-server
-```
-
-**Using Git Repository:**
-```bash
-# Clone or update repository
-git clone https://github.com/BofAI/sun-mcp-server.git
-cd sun-mcp-server
-
-# Pull latest code
-git pull
-
-# Install dependencies and start
-npm install
-npm start
-```
-
-### Too Many Tools Cause LLM Context Overflow?
-
-**Symptom:** Claude reports token limit exceeded or tool list too long.
-
-**Solution: Use Tool Filtering:**
-
-```bash
-# Enable only specific tools (whitelist)
-sun-mcp-server --whitelist sunswap_swap,sunswap_get_balances,sunswap_quote_exact_input
-
-# Exclude certain tools (blacklist)
-sun-mcp-server --blacklist getUserPositions,getPoolVolHistory
-```
-
-**Optimization Tips:**
-- Create multiple server instances for different tasks
-- Use whitelist to load only necessary tools
-- Regularly clean up unused tool configurations
-
-### Which MCP Protocol Version is Supported?
-
-**SUN MCP Server supports MCP 1.10.2 and higher.**
-
-**Verify Version:**
-```bash
-# Check version in dependencies
-npm list @modelcontextprotocol/sdk
-
-# Should output similar to:
-# @modelcontextprotocol/sdk@1.10.2
-```
-
-**Upgrade MCP SDK:**
-```bash
-npm update @modelcontextprotocol/sdk
-```
-
----
-
-## Get More Help
-
-- **GitHub Issues:** https://github.com/BofAI/sun-mcp-server/issues
-- **Full Capability List:** Check [Full Capability List](ToolList.md) 
-- **Local Deployment:** See [Local Privatized Deployment](LocalPrivatizedDeployment.md)
-- **Official Server:** See [Official Server Access](OfficialServerAccess.md)
diff --git a/docs/McpServer-Skills/MCP/SUNMCPServer/Intro.md b/docs/McpServer-Skills/MCP/SUNMCPServer/Intro.md
deleted file mode 100644
index cb3635f5..00000000
--- a/docs/McpServer-Skills/MCP/SUNMCPServer/Intro.md
+++ /dev/null
@@ -1,107 +0,0 @@
-# Introduction
-
-## What is SUN MCP Server?
-
-SUN MCP Server is the bridge connecting AI assistants to [SUN.IO (SunSwap)](https://sun.io), the largest decentralized exchange on the TRON blockchain. Built on the [Model Context Protocol (MCP)](../Intro.md) standard, it lets you query DeFi data, execute token swaps, and manage liquidity positions using natural language—without directly interacting with contracts or handling complex on-chain parameters.
-
-For example: just tell Claude "swap 100 USDT to TRX using SunSwap's best route," and the AI will automatically find the optimal path, estimate slippage, ask you to confirm, then execute the trade. No need to open a frontend, manually approve contracts, or understand the routing contract internals.
-
-What this means for different people:
-
-- If you're a **DeFi user**, it lets you operate SunSwap conversationally—swapping, adding liquidity, collecting fees, as naturally as sending a message.
-- If you're a **Web3 developer**, it's your tool for quickly querying SunSwap on-chain state and protocol metrics, saving significant API integration work.
-- If you're an **AI Agent builder**, it provides a standardized DeFi toolkit you can directly orchestrate into automated trading or market-making strategies.
-- If you're a **data analyst**, SunSwap's trading volume, pool APYs, and position data are all within reach—no API documentation required.
-
----
-
-## What can it do?
-
-SUN MCP Server covers the full range of SunSwap DEX interactions, from on-chain data queries to token swaps and liquidity management, providing **41 tools**.
-
-Here's a capability overview—each item can be triggered through natural language:
-
-**Data Queries (read-only, no private key needed):**
-
-| Capability | Description | Try saying |
-| :--- | :--- | :--- |
-| **Token Prices** | Query real-time prices for any token on SunSwap | "What's the current USDT/TRX price?" |
-| **Swap Quotes** | Get the optimal route and expected output for a given input | "How much TRX can I get for 100 USDT?" |
-| **Pool Data** | Query pool lists, APY, trading volume, liquidity history | "What's the current APY for the USDT-TRX pool?" |
-| **Position Query** | View liquidity positions for any address on SunSwap | "Check my SunSwap positions" |
-| **Protocol Stats** | Overall SunSwap trading volume, user counts, pool count history | "What was SunSwap's trading volume in the past 7 days?" |
-| **Farm Info** | Query farm lists and user mining positions | "What yield farms are available on SunSwap?" |
-
-**DeFi Operations (write, requires private key):**
-
-| Capability | Description | Try saying |
-| :--- | :--- | :--- |
-| **Token Swap** | Execute optimal-route swaps via the Universal Router | "Swap 100 USDT to TRX for me" |
-| **V2 Liquidity** | Add/remove V2 pool liquidity, auto-handles TRX/WTRX conversion | "Add 100 USDT of liquidity to the USDT-TRX V2 pool" |
-| **V3 Liquidity** | Mint and manage concentrated liquidity positions, collect fees | "Collect the accrued fees from my V3 position" |
-| **V4 Liquidity** | V4 concentrated liquidity operations with Permit2 authorization | "Mint a V4 USDT-TRX position" |
-| **Contract Interaction** | Directly read or call any TRON smart contract function | "Query the current slot0 state of this contract" |
-
-For the Full Capability List and parameter details, see [Full Capability List](./ToolList.md).
-
----
-
-## Two Access Modes
-
-Now that you understand SUN MCP Server's capabilities, you need to choose an access mode. There are two paths depending on your use case:
-
-**[Official Cloud Service](./OfficialServerAccess.md)** — Best for quick exploration and data queries. No installation required—just add a service address to your AI client config and you're ready. The cloud service is **read-only**: it supports querying token prices, pool data, protocol stats, but does not support executing swaps or adding liquidity.
-
-**[Local Private Deployment](./LocalPrivatizedDeployment.md)** — For users who need full DeFi functionality. Run SUN MCP Server on your own machine, configure a wallet, and unlock swaps, liquidity management, and all other operations. Private keys stay entirely local and are never uploaded to any remote service.
-
-The core difference comes down to one thing: **whether you need to sign transactions**.
-
-| Comparison | Official Cloud Service | Local Private Deployment |
-| :--- | :--- | :--- |
-| **Feature scope** | Read-only (data queries) | Full (queries + swaps + liquidity) |
-| **Setup difficulty** | Add one line of config | Requires local install and build |
-| **Private key required** | No | Yes (required for write operations) |
-| **Token swaps / liquidity** | Not supported | Supported |
-| **Best for** | Data queries, getting started | DeFi operations, automated strategies |
-| **Security** | High (no private key exposure risk) | Depends on your key management |
-
-:::tip Not sure which to choose?
-If you just want to check SunSwap prices and pool data, start with the [Official Cloud Service](./OfficialServerAccess.md)—it takes 1 minute to connect. When you need to execute swaps or manage liquidity, switch to [Local Private Deployment](./LocalPrivatizedDeployment.md).
-:::
-
----
-
-## Supported Networks
-
-Both access modes support the following three networks (mainnet by default):
-
-| Network | Identifier | Purpose | Block Explorer |
-| :--- | :--- | :--- | :--- |
-| **Mainnet** | `mainnet` | Production, real assets | [tronscan.org](https://tronscan.org) |
-| **Nile Testnet** | `nile` | Development and testing (recommended) | [nile.tronscan.org](https://nile.tronscan.org) |
-| **Shasta Testnet** | `shasta` | Development and testing | [shasta.tronscan.org](https://shasta.tronscan.org) |
-
-Specify the target network via the `network` parameter when calling tools. **We strongly recommend validating any new operation on the Nile testnet first**—mainnet operations involve real assets and cannot be undone.
-
----
-
-## Security Notes
-
-:::warning
-Before you start, keep these security principles in mind—DeFi operations directly involve on-chain assets and mistakes cannot be reversed:
-
-- **Never hardcode private keys**: Do not write private keys or mnemonics directly into config files. Use system environment variables or encrypted wallet management.
-- **Test on testnet first**: Before executing any swap or liquidity operation on mainnet, verify it on the Nile testnet.
-- **Minimum funds principle**: Only keep the funds needed for the current task in the AI Agent's wallet.
-- **Watch authorization risk**: Token `approve` operations require extra care—avoid granting unlimited allowances.
-- **Confirm every transaction**: Before executing any on-chain write operation, the AI will present transaction details and ask for confirmation. Don't skip this step.
-:::
-
----
-
-## Next Steps
-
-- Want the fastest way to try it out? → [Quick Start](./QuickStart.md)
-- Only need to query on-chain data? → [Official Cloud Service](./OfficialServerAccess.md)
-- Need token swaps or liquidity management? → [Local Private Deployment](./LocalPrivatizedDeployment.md)
-- Want to explore all 41 tools? → [Full Capability List](./ToolList.md)
diff --git a/docs/McpServer-Skills/MCP/SUNMCPServer/LocalPrivatizedDeployment.md b/docs/McpServer-Skills/MCP/SUNMCPServer/LocalPrivatizedDeployment.md
deleted file mode 100644
index fef556dc..00000000
--- a/docs/McpServer-Skills/MCP/SUNMCPServer/LocalPrivatizedDeployment.md
+++ /dev/null
@@ -1,298 +0,0 @@
-# Local Privatized Deployment
-
-## What is Local Privatized Deployment?
-
-Local privatized deployment refers to running a complete instance of SUN MCP Server on your own computer. Unlike relying on third-party services, local deployment gives you full control over your wallet, network connection, and data privacy.
-
-This mode is particularly suitable for scenarios that require executing DeFi operations. By configuring wallet private keys or mnemonics, you can unlock the following write operations:
-
-- **Swap**: Automatic routing swaps using Universal Router
-- **Liquidity Management**: Add and remove liquidity for SunSwap V2/V3/V4
-- **Position Management**: Mint, increase, decrease positions and collect fees for SunSwap V3/V4
-- **Contract Interaction**: Call arbitrary contracts via `sunswap_send_contract`
-
-:::info
-Without wallet configuration, SUN MCP Server will run in **read-only mode**, allowing querying on-chain data but unable to execute write operations.
-:::
-
----
-
-## Before You Start
-
-### Environment Requirements
-
-| Item | Requirement | Description |
-|------|------|------|
-| Node.js | >= 20.0.0 | v20.0.0 or higher ([download](https://nodejs.org/)) |
-| npm | >= 10.0 | Usually installed with Node.js |
-| Operating System | Linux / macOS / Windows | Cross-platform support |
-| Disk Space | >= 100 MB | For dependency installation |
-| Network | Internet Connection | Communication with TRON network |
-
-### Security Principles
-
-:::danger Important Security Tips
-1. **Private Key Protection**: Never commit private keys to version control. Use `.env` files and add them to `.gitignore`.
-2. **Permission Management**: Ensure `.env` file permissions are `600` (owner read-only).
-3. **Multiple Wallet Mode Prohibited**: Configuring multiple wallet methods simultaneously will trigger an error. Only one method can be used at a time.
-4. **Mnemonic Terminology**: In this document, "mnemonic" refers to BIP-39 standard 12-word or 24-word recovery phrases.
-5. **Mainnet Caution**: Before using real funds on mainnet, thoroughly test on testnets (Nile, Shasta).
-:::
-
----
-
-## Installation Steps
-### Step 1: Configure Wallet
-
-The wallet determines which identity the AI assistant uses to perform on-chain operations. SUN MCP Server uses [Agent Wallet](../../../Agent-Wallet/Intro.md) for secure wallet management. If no wallet is configured, the server automatically runs in read-only mode.
-
-#### Agent Wallet
-
-SUN MCP Server uses [Agent Wallet](../../../Agent-Wallet/Intro.md) for wallet management. Private keys are encrypted and stored on local disk, never exposed as plaintext in environment variables. Even if environment variables are leaked, the attacker still needs the encrypted keystore file to access funds. Agent Wallet also supports **multi-wallet management** and runtime wallet switching via the `select_wallet` tool.
-
-| Feature | Description |
-| :--- | :--- |
-| Security Level | High (encrypted storage) |
-| Multi-Wallet Support | Yes |
-| Runtime Wallet Switching | Yes |
-| Recommended For | All use cases |
-
-> For installation, initialization, and detailed usage of Agent Wallet, see the [Agent-Wallet documentation](../../../Agent-Wallet/Intro.md).
-
-First, install Agent Wallet:
-
-```bash
-npm install -g @bankofai/agent-wallet
-```
-
-Then, choose one of the following two options depending on your situation:
-
-#### Option A: Generate a New Wallet (Recommended for New Users)
-
-If you don't have an existing private key, use `agent-wallet start` to generate a new wallet with an encrypted keystore and master password:
-
-```bash
-agent-wallet start
-```
-
-Follow the interactive prompts to set your master password and generate a wallet. Once complete, the wallet is ready to use — **no additional environment variables are needed**. Agent Wallet will automatically manage the encrypted keystore.
-
-#### Option B: Import an Existing Private Key
-
-If you already have a private key you want to use, set it via the `AGENT_WALLET_PRIVATE_KEY` environment variable:
-
-```bash
-export AGENT_WALLET_PRIVATE_KEY=your_private_key_here
-```
-
-:::tip
-To make this persist across terminal sessions, add it to your shell configuration file:
-
-```bash
-echo 'export AGENT_WALLET_PRIVATE_KEY=your_private_key' >> ~/.zshrc   # zsh (macOS default)
-echo 'export AGENT_WALLET_PRIVATE_KEY=your_private_key' >> ~/.bashrc  # bash (Linux default)
-source ~/.zshrc   # or source ~/.bashrc — takes effect immediately without restarting the terminal
-```
-
-Verify the environment variable is set:
-
-```bash
-echo $AGENT_WALLET_PRIVATE_KEY
-```
-:::
-
-
----
-
-
-### Step 2: Local Private Deployment
-
-#### Option A: Run directly with npx (Recommended)
-
-The simplest and quickest method, no installation or cloning needed.
-
-**Command:**
-
-```bash
-npx -y @bankofai/sun-mcp-server
-```
-
-**Description:**
-- `npx` automatically downloads the latest version of `@bankofai/sun-mcp-server`
-- `-y` flag automatically confirms prompts
-- First run may take a few seconds to download
-
-**Run with environment variables:**
-
-```bash
-TRON_NETWORK=nile npx -y @bankofai/sun-mcp-server
-```
-
-#### Option B: Clone from Source
-
-Suitable for development and custom modifications.
-
-**Steps:**
-
-```bash
-# 1. Clone repository
-git clone https://github.com/BofAI/sun-mcp-server.git
-cd sun-mcp-server
-
-# 2. Install dependencies
-npm install
-
-# 3. Build project
-npm run build
-
-# 4. Run server
-npx tsx src/index.ts
-```
-
-**Or install globally:**
-
-```bash
-npm install -g @bankofai/sun-mcp-server
-sun-mcp-server
-```
-
----
-
-### Step 3: Server Running Methods
-
-After wallet configuration is complete, you can run the server using one of the following methods:
-
-### Option A: Run directly with npx (Recommended)
-
-The simplest and quickest method, no installation or cloning needed.
-
-**Command:**
-
-```bash
-npx -y @bankofai/sun-mcp-server
-```
-
-**Description:**
-- `npx` automatically downloads the latest version of `@bankofai/sun-mcp-server`
-- `-y` flag automatically confirms prompts
-- First run may take a few seconds to download
-
-**Run with environment variables:**
-
-```bash
-TRON_NETWORK=nile npx -y @bankofai/sun-mcp-server
-```
-
-### Option B: Clone from Source
-
-Suitable for development and custom modifications.
-
-**Steps:**
-
-```bash
-# 1. Clone repository
-git clone https://github.com/BofAI/sun-mcp-server.git
-cd sun-mcp-server
-
-# 2. Install dependencies
-npm install
-
-# 3. Build project
-npm run build
-
-# 4. Run server
-npx tsx src/index.ts
-```
-
-**Or install globally:**
-
-```bash
-npm install -g @bankofai/sun-mcp-server
-sun-mcp-server
-```
-
-### Option C: HTTP Mode
-
-Run SUN MCP Server in HTTP server mode, allowing remote connections.
-
-**Start HTTP Server:**
-
-```bash
-sun-mcp-server --transport streamable-http --host 127.0.0.1 --port 8080 --mcpPath /mcp
-```
-
-:::warning
-HTTP mode is suitable for local development and testing. For remote deployment, use HTTPS and appropriate authentication.
-:::
-
-:::tip About Environment Variables
-- **npx Run**: Export environment variables directly in the terminal before running the command.
-- **HTTP Mode**: When starting the HTTP server, environment variables should be exported before the startup command:
-
-```bash
-export TRON_NETWORK=nile
-sun-mcp-server --transport streamable-http --host 127.0.0.1 --port 8080 --mcpPath /mcp
-```
-
-- **Server Configuration**: Once the server is running, configure your MCP client to connect to it.
-:::
-
----
-
-### Step 4: Client Configuration
-
-After the server is running, you need to configure your MCP client to connect to it. Refer to your MCP client's documentation for configuration instructions. The server will be accessible at one of the following:
-
-- **npx/Local Build**: Typically runs as a subprocess managed by your client
-- **HTTP Mode**: `http://127.0.0.1:8080/mcp` (or the host/port you specified)
-
----
-
-### Step 5: Verify Connection
-
-After starting the AI client, you should be able to see the tool list of SUN MCP Server. Perform the following tests to confirm the configuration is correct:
-
-#### Query Test
-
-Try the following command in chat:
-
-```
-Check the current prices of USDT and TRX on SunSwap
-```
-
-Expect to receive the current block number.
-
-#### If Testing on Testnet
-
-If you configured to use Nile testnet:
-
-```bash
-TRON_NETWORK=nile
-```
-
-You can get test TRX from [TRON Nile Faucet](https://nile.trongrid.io/join), then try the following operations:
-
-- Query test account balance
-- Execute a test swap (if wallet is configured)
-- Check transaction history
-
-:::info Diagnostic Steps
-If you encounter connection issues:
-
-1. **Check Network Connection**: Ensure you can access TRON network endpoints
-2. **View Logs**: When running the server, check console output for error messages
-3. **Test Network**: Try switching to testnet (Nile) to rule out network issues
-:::
-
----
-
-## Next Steps
-
-Now that you've successfully deployed SUN MCP Server! Next you can:
-
-1. **View Full Capability List**: Browse [Full Capability List](./ToolList.md) to understand all available operations
-2. **Resolve Common Issues**: Consult [Frequently Asked Questions](./FAQ.md) for help
-
-:::success
-Congratulations! You can now interact with the TRON blockchain through your AI client. Start exploring the unlimited possibilities of DeFi!
-:::
diff --git a/docs/McpServer-Skills/MCP/SUNMCPServer/OfficialServerAccess.md b/docs/McpServer-Skills/MCP/SUNMCPServer/OfficialServerAccess.md
deleted file mode 100644
index 434ca786..00000000
--- a/docs/McpServer-Skills/MCP/SUNMCPServer/OfficialServerAccess.md
+++ /dev/null
@@ -1,186 +0,0 @@
-# Official Cloud Service Access
-
-## What is the Official Cloud Service?
-
-The official cloud service is a SUN MCP Server instance hosted by **BANK OF AI**, providing AI clients with **read-only query capabilities for SunSwap on-chain data**.
-
-If you want your AI assistant to query token prices, pool APYs, or protocol trading volume on SunSwap, or analyze a specific address's liquidity positions — these are all read-only operations that can be completed via the official cloud service, with no wallet credentials needed.
-
-**The core purpose of the official cloud service is to handle all infrastructure for you.** You only need to add a single service URL to your AI client's configuration to start interacting with SunSwap.
-
-### Key Advantages
-
-**1. No private key exposure risk** — Since the cloud service is read-only, you never need to provide a wallet private key or mnemonic. This eliminates key leakage risks and makes team sharing straightforward.
-
-**2. Official maintenance and continuous updates** — The service always runs the latest stable version, including SunSwap protocol updates and SUN.IO API synchronization. No manual rebuilds needed.
-
-**3. Covers a large number of practical use cases** — Querying token prices and swap quotes, analyzing pool data and APYs, getting protocol statistics and historical metrics, viewing user liquidity positions — all the most commonly used DeFi data queries are fully supported. Only when you need to actually execute swaps or manage liquidity do you need to switch to [Local Private Deployment](./LocalPrivatizedDeployment.md).
-
-> In short: **The official cloud service acts as a "read-only data gateway" for SunSwap** — AI clients only need the service URL to query all public data on SunSwap.
-
-:::warning Important
-The official cloud service only provides **read-only access**. It does **not support** token swaps, adding/removing liquidity, or any other on-chain write operations. For full functionality, please use [Local Private Deployment](./LocalPrivatizedDeployment.md).
-:::
-
----
-
-## How to Connect
-
-We provide three installation methods. **Pick the one that matches your level of comfort** — the conversational install is the easiest; the interactive install gives you the most control.
-
-### Method 1: Conversational Install (Easiest)
-
-If you're already using an AI Agent that can run shell commands (OpenClaw, a Telegram bot, web chat, Claude Code, Cursor, etc.), you can install everything by **simply chatting with the AI** — no need to open a terminal yourself, no manual file copying.
-
-:::tip Prerequisite
-**Node.js is required** on the machine where the AI Agent runs (the Agent uses `npx` under the hood). If Node.js isn't installed yet, grab the LTS installer from [nodejs.org](https://nodejs.org) — install once, double-click and follow the prompts.
-:::
-
-**How it works:**
-
-1. Open your AI Agent chat
-2. Copy and paste the following prompt:
-
-   ```
-   Run npx add-mcp https://sun-mcp-server.bankofai.io/mcp -y to install the SUN MCP Server.
-   Note: Please install to the MCP config of the current Agent.
-   ```
-
-3. The AI handles the entire flow automatically:
-   - Detects the remote MCP service URL
-   - Auto-detects which AI client is currently running
-   - Writes the `sun-mcp-server` entry into the right MCP config file (no manual JSON editing)
-   - Reports back with a ✅ confirmation when done
-
-Once the AI confirms the install, the SUN MCP Server is ready — you can start asking questions right away.
-
-:::tip Why this is the recommended path for beginners
-You don't need to know what `npx`, `npm`, or "MCP config file" means. The AI handles every step including selecting the right config path for your client.
-:::
-
-### Method 2: Quick Auto-Install (Command Line)
-
-If you have Node.js installed and prefer the command line, run the following directly in your terminal:
-
-```bash
-npx add-mcp https://sun-mcp-server.bankofai.io/mcp -y
-```
-
-The `-y` flag skips all interactive prompts and automatically installs to every AI tool detected on your computer. Once complete, it will show ✅ Installation complete! along with the list of agents it was installed to.
-
-Once installation is complete, you can start interacting with SunSwap via SUN MCP Server.
-
-### Method 3: Interactive Install (Most Control)
-
-If you want to choose which AI tools to install to, remove the `-y` flag:
-
-```bash
-npx add-mcp https://sun-mcp-server.bankofai.io/mcp
-```
-
-:::tip
-This guide demonstrates the installation process using terminal commands as an example.
-:::
-
-#### Installation Walkthrough
-
-The installer will guide you through a few steps — just follow along:
-
-**1️⃣ Identify the service source**
-
-The installer automatically detects the remote MCP service URL and generates a server name:
-
-```
-◇  Source: https://sun-mcp-server.bankofai.io/mcp (remote)
-│
-●  Server name: sun-mcp-server
-```
-
-**2️⃣ Choose which AI tools to install to**
-
-The installer auto-detects AI tools on your computer (e.g., Claude Code, Cursor, Cline, etc.). Use Space to select the ones you want:
-
-```
-◇  Detected 1 agent
-│
-◇  Select agents to install to
-│  Claude Code
-```
-
-**3️⃣ Confirm installation details**
-
-The installer displays an installation summary. Review it and select `Yes` to proceed:
-
-```
-◇  Installation Summary ───╮
-│                          │
-│  Server: sun-mcp-server  │
-│  Type: remote            │
-│  Scope: Project          │
-│  Agents: Claude Code     │
-│                          │
-├──────────────────────────╯
-│
-◇  Proceed with installation?
-│  Yes
-```
-
-**4️⃣ Installation complete!**
-
-When you see output like this, SUN MCP Server has been successfully installed to your selected AI tools:
-
-```
-◇  Installation complete
-│
-◇  Installed to 1 agent ───────╮
-│                              │
-│  ✓ Claude Code: ~/.mcp.json  │
-│                              │
-├──────────────────────────────╯
-│
-└  Done!
-```
-
-Once installation is complete, you can start interacting with SunSwap via SUN MCP Server.
-
----
-
-## Verify Connection
-
-Once connected, you can test by asking your AI Agent the following question:
-
-```
-Check the current prices of USDT and TRX on SunSwap
-```
-
-If you receive a normal response, the connection is working.
-
-If you encounter issues, first confirm:
-1. Node.js version >= 20.0.0 (run `node --version` to check)
-2. Network can reach `sun-mcp-server.bankofai.io`
-
----
-
-## Available Capabilities Overview
-
-When connected via the official cloud service, you can use all **read-only** tools, including:
-
-| Category | Example Capabilities |
-| :--- | :--- |
-| **Token Prices** | Query real-time token prices by address or symbol |
-| **Swap Quotes** | Get the optimal swap quote for an exact input via smart routing |
-| **Token Info** | Search token information by address, protocol, or keyword |
-| **Pool Data** | Pool lists, APY rankings, trading volume history, liquidity history |
-| **Position Queries** | User liquidity positions, tick-level position details |
-| **Protocol Stats** | Trading volume, user counts, transaction counts, pool count history |
-| **Farm Info** | Farm lists, farm transactions, user farm positions |
-| **Contract Reading** | Call view/pure functions on any TRON contract |
-
-For the Full Capability List, see [Full Capability List](./ToolList.md).
-
----
-
-## Next Steps
-
-- Need token swaps or liquidity management? → [Local Private Deployment](./LocalPrivatizedDeployment.md)
-- Want the detailed description of all available tools? → [Full Capability List](./ToolList.md)
diff --git a/docs/McpServer-Skills/MCP/SUNMCPServer/QuickStart.md b/docs/McpServer-Skills/MCP/SUNMCPServer/QuickStart.md
deleted file mode 100644
index 6f1a689a..00000000
--- a/docs/McpServer-Skills/MCP/SUNMCPServer/QuickStart.md
+++ /dev/null
@@ -1,82 +0,0 @@
-# Quick Start
-
-The goal of this page is simple: **get you integrated and make your first DeFi query in just 1 minute.**
-
-We'll use the [official cloud service](./OfficialServerAccess.md) for this quick experience. The cloud service is read-only, requires no wallet, and is ready to use immediately.
-
----
-
-## Preparation
-
-Before you get started, make sure you have:
-
-1. **Node.js** >= 20.0.0 ([download link](https://nodejs.org/))
-2. **MCP Client**: Any AI client that supports MCP.
-
----
-
-## Install
-
-The easiest way to install is by **simply chatting with your AI Agent** — no need to open a terminal yourself, no manual file copying. If you're already using an AI Agent that can run shell commands (OpenClaw, a Telegram bot, web chat, Claude Code, Cursor, etc.), you're set.
-
-**How it works:**
-
-1. Open your AI Agent chat
-2. Copy and paste the following prompt:
-
-   ```
-   Run npx add-mcp https://sun-mcp-server.bankofai.io/mcp -y to install the SUN MCP Server.
-   Note: Please install to the MCP config of the current Agent.
-   ```
-
-3. The AI handles the entire flow automatically:
-   - Detects the remote MCP service URL
-   - Auto-detects which AI client is currently running
-   - Writes the `sun-mcp-server` entry into the right MCP config file (no manual JSON editing)
-   - Reports back with a ✅ confirmation when done
-
-Once the AI confirms the install, the SUN MCP Server is ready — you can start asking questions right away.
-
-:::tip Prefer the command line?
-If you'd rather run the install yourself or need finer control (e.g. selecting which AI tools to install to), see [Official Cloud Service Access](./OfficialServerAccess.md) for the command-line and interactive options.
-:::
-
----
-
-## Test It Out
-
-Try the following query in a conversation:
-
-```
-Check the current prices of USDT and TRX on SunSwap
-```
-
-:::info About Cloud Service
-The official cloud service we provide is **read-only**, suitable for querying data and analysis. If you need to execute on-chain transactions, deploy contracts, or other write operations, please see [Local Privatized Deployment](./LocalPrivatizedDeployment.md).
-:::
-
----
-
-## Continue Exploring
-
-Here are some common DeFi query examples:
-
-| Operation | Example Prompt |
-|------|--------|
-| **Price Query** | Query the real-time price of USDT/TRX |
-| **Liquidity Pool Data** | Get pool information for the TRX-USDC trading pair on SunSwap |
-| **Position Query** | View all liquidity positions of address TR... on SunSwap |
-| **Trade Quote** | Get a quote for swapping 1000 USDT for TRX |
-| **Protocol Stats** | Get SunSwap statistics including TVL and 24-hour trading volume |
-
----
-
-## Next Steps
-
-- **[Local Privatized Deployment](./LocalPrivatizedDeployment.md)** - Learn how to run SUN MCP Server locally and perform write operations
-- **[Official Server Access](./OfficialServerAccess.md)** - Learn more about the official cloud service
-- **[Full Capability List](./ToolList.md)** - View all available tools and features
-
----
-
-Happy coding! If you have any questions, feel free to provide feedback.
diff --git a/docs/McpServer-Skills/MCP/SUNMCPServer/ToolList.md b/docs/McpServer-Skills/MCP/SUNMCPServer/ToolList.md
deleted file mode 100644
index 09625201..00000000
--- a/docs/McpServer-Skills/MCP/SUNMCPServer/ToolList.md
+++ /dev/null
@@ -1,349 +0,0 @@
-# Full Capability List
-
-SUN MCP Server provides **41 tools**.
-
-## Understand Two Key Concepts First
-
-Before browsing the tool list, there are two things you should know:
-
-:::info Read vs Write
-Each tool is labeled with a **mode** — "read" or "write":
-
-- **Read tools**: Only query on-chain data and do not affect any state. They can be used in both cloud services and local deployments.
-- **Write tools**: Modify blockchain state (e.g., transfers, staking, contract interactions). These are only available in local deployments with a configured wallet.
-
-If you have not configured a wallet, write tools will not appear in the AI’s available tool list — they are automatically hidden, so there’s no risk of triggering them by mistake.
-:::
-
-:::tip `network` parameter
-Most tools include an optional `network` parameter used to specify the target network environment. By default, the mainnet is used, but it can be switched to a testnet if needed.
-:::
-
----
-
-## Custom Tools (18 total)
-
-### Wallet and Balance
-
-| Tool Name | Function Description | Tool Type | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|---------|
-| `sunswap_get_wallet_address` | Get current active TRON wallet address | Read | - | `network` |
-| `sunswap_get_balances` | Query TRX and TRC20 token balances | Read | `tokens` | `network`, `ownerAddress` |
-
-**Try saying this:**
-- "Query my TRON wallet address"
-- "Show my balance for USDT and SUNFLARE"
-- "Get my TRX balance on testnet"
-
----
-
-### Price and Quotes
-
-| Tool Name | Function Description | Tool Type | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|---------|
-| `sunswap_get_token_price` | Get token price (via SUN.IO API) | Read | `tokenAddress` or `symbol` | `network` |
-| `sunswap_quote_exact_input` | Swap quote for exact input amount (smart routing) | Read | `routerAddress`, `args` | `network`, `functionName`, `abi` |
-
-**Try saying this:**
-- "What is the current price of SUNFLARE?"
-- "If I swap 1000 USDT for SUNFLARE, how much will I get?"
-- "Query the current price of USDC on testnet"
-
----
-
-### Swaps
-
-| Tool Name | Function Description | Tool Type | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|---------|
-| `sunswap_swap` | Execute generic router swap (supports auto-routing + Permit2) | Write | `tokenIn`, `tokenOut`, `amountIn` | `network`, `slippage` |
-| `sunswap_swap_exact_input` | Exact input swap (smart router) | Write | `routerAddress`, `args` | `network`, `functionName`, `value`, `abi` |
-
-**Try saying this:**
-- "I want to swap 500 USDT for SUNFLARE with 1% slippage"
-- "Execute a swap of 1000 USDC for TRX"
-- "Help me swap SUNFLARE to USDT, completed in less than 2 seconds"
-
-:::caution Wallet Required
-Swap tools require local deployment of SUN MCP Server with configured wallet private key.
-:::
-
----
-
-### V2 Liquidity
-
-| Tool Name | Function Description | Tool Type | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|---------|
-| `sunswap_v2_add_liquidity` | Add V2 liquidity (automatic TRX/WTRX handling) | Write | `routerAddress`, `tokenA`, `tokenB`, `amountADesired`, `amountBDesired` | `network`, `amountAMin`, `amountBMin`, `to`, `deadline`, `abi` |
-| `sunswap_v2_remove_liquidity` | Remove V2 liquidity | Write | `routerAddress`, `tokenA`, `tokenB`, `liquidity` | `network`, `amountAMin`, `amountBMin`, `to`, `deadline`, `abi` |
-
-**Try saying this:**
-- "I want to add 1000 USDT and equivalent SUNFLARE to V2 liquidity pool"
-- "Remove 50% of my liquidity from the USDC-TRX pool"
-- "Add V2 liquidity with minimum 950 USDT and 9500 SUNFLARE"
-
-:::info Auto-handling
-When the pair involves TRX, the tool automatically converts to WTRX.
-:::
-
----
-
-### V3 Liquidity
-
-| Tool Name | Function Description | Tool Type | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|---------|
-| `sunswap_v3_mint_position` | Create V3 concentrated liquidity position | Write | `positionManagerAddress`, `token0`, `token1` | `network`, `fee`, `tickLower`, `tickUpper`, `amount0Desired`, `amount1Desired`, `amount0Min`, `amount1Min`, `recipient`, `deadline`, `abi` |
-| `sunswap_v3_increase_liquidity` | Increase V3 liquidity | Write | `positionManagerAddress`, `tokenId` | `network`, `token0`, `token1`, `fee`, `amount0Desired`, `amount1Desired`, `amount0Min`, `amount1Min`, `deadline` |
-| `sunswap_v3_decrease_liquidity` | Decrease V3 liquidity | Write | `positionManagerAddress`, `tokenId`, `liquidity` | `network`, `token0`, `token1`, `fee`, `amount0Min`, `amount1Min`, `deadline` |
-| `sunswap_v3_collect` | Collect V3 fees | Write | `positionManagerAddress`, `tokenId` | `network`, `recipient`, `abi` |
-
-**Try saying this:**
-- "Help me create liquidity in the USDT-SUNFLARE V3 0.3% fee pool with range ±50 ticks"
-- "Increase my V3 position #12345 by adding 1000 USDT"
-- "Collect fees from my V3 position"
-- "Decrease V3 liquidity to 50%"
-
-:::tip Auto-calculation
-When creating a new position, the system automatically calculates tick range (±50×tickSpacing) and optimal single-sided input amounts.
-:::
-
----
-
-### V4 Liquidity
-
-| Tool Name | Function Description | Tool Type | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|---------|
-| `sunswap_v4_mint_position` | Create V4 position (Permit2 supported) | Write | `token0`, `token1` | `network`, `fee`, `tickLower`, `tickUpper`, `amount0Desired`, `amount1Desired`, `slippage`, `recipient`, `deadline`, `sqrtPriceX96`, `createPoolIfNeeded` |
-| `sunswap_v4_increase_liquidity` | Increase V4 liquidity (Permit2 supported) | Write | `tokenId`, `token0`, `token1` | `network`, `fee`, `amount0Desired`, `amount1Desired`, `slippage`, `deadline` |
-| `sunswap_v4_decrease_liquidity` | Decrease V4 liquidity | Write | `tokenId`, `liquidity`, `token0`, `token1` | `network`, `fee`, `amount0Min`, `amount1Min`, `slippage`, `deadline` |
-| `sunswap_v4_collect` | Collect V4 fees | Write | `tokenId` | `network`, `token0`, `token1`, `fee`, `deadline` |
-
-**Try saying this:**
-- "Create a USDC-SUNFLARE liquidity position in V4 with 5% slippage"
-- "Increase my V4 position #67890 by injecting 5000 USDC"
-- "Collect all accumulated fees from V4 position"
-- "Decrease V4 liquidity ensuring slippage stays within 3%"
-
-:::info Permit2 Support
-V4 tools natively support Permit2 signature authorization, improving user experience.
-:::
-
----
-
-### Contract Interaction
-
-| Tool Name | Function Description | Tool Type | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|---------|
-| `sunswap_read_contract` | Read data from TRON smart contract (view/pure) | Read | `address`, `functionName` | `network`, `args`, `abi` |
-| `sunswap_send_contract` | Send state-changing contract transaction | Write | `address`, `functionName` | `network`, `args`, `value`, `abi` |
-
-**Try saying this:**
-- "Query the total supply of SUNFLARE contract"
-- "Read my balance in the liquidity contract"
-- "Call contract function to update pool parameters"
-- "Send 0.1 TRX to contract and execute specific function"
-
-:::caution ABI Requirement
-If ABI is not provided, the system will attempt to retrieve contract ABI from TronScan.
-:::
-
----
-
-## SUN.IO OpenAPI Derived Tools (23 total)
-
-### Transactions
-
-| Tool Name | Function Description | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|
-| `scanTransactions` | Scan DEX transactions | - | `protocol`, `token`, `pool`, `type`, `timeRange` |
-| `getFarmTransactions` | Scan farm pool transactions | `farmAddress` | - |
-
-**Try saying this:**
-- "View SUN protocol transactions from the past 24 hours"
-- "Query all transactions in the SUNFLARE-USDT pool"
-- "Get transaction data from the last 7 days"
-
----
-
-### Tokens
-
-| Tool Name | Function Description | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|
-| `getTokens` | Get tokens by address or protocol | - | `address`, `protocol` |
-| `searchTokens` | Fuzzy search tokens | `keyword` | - |
-| `getPrice` | Get token price by address | `tokenAddress` | - |
-
-**Try saying this:**
-- "Search for 'SUNFLARE' token"
-- "Get token information for address `TR7NHqjeKQxGTCi8q282JHJC8YXQFg...`"
-- "Query USDT price in SUN protocol"
-
----
-
-### Protocol
-
-| Tool Name | Function Description | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|
-| `getProtocol` | Protocol snapshot data | - | - |
-| `getVolHistory` | Protocol volume history | - | - |
-| `getLiqHistory` | Protocol liquidity history | - | - |
-| `getUsersCountHistory` | Protocol user count history | - | - |
-| `getTransactionsHistory` | Protocol transaction count history | - | - |
-| `getPoolsCountHistory` | Protocol pool count history | - | - |
-
-**Try saying this:**
-- "Get the latest snapshot of SUN protocol"
-- "View volume trends over the past 30 days"
-- "Get protocol user growth information"
-
----
-
-### Price
-
-| Tool Name | Function Description | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|
-| `getPrice` | Token price query | `tokenAddress` | - |
-
-**Try saying this:**
-- "Get the real-time price of SUNFLARE token"
-
----
-
-### Positions
-
-| Tool Name | Function Description | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|
-| `getUserPositions` | User liquidity positions | `userAddress` | - |
-| `getPoolUserPositionTick` | Pool user tick-level position details | `poolAddress`, `userAddress` | - |
-| `getFarmPositions` | User farm positions | `userAddress` | - |
-
-**Try saying this:**
-- "View all my liquidity positions"
-- "Get my tick-level details in the USDT-SUNFLARE pool"
-- "Query my farm yield positions"
-
----
-
-### Pools
-
-| Tool Name | Function Description | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|
-| `getPools` | Get pools | - | `address`, `token`, `protocol` |
-| `searchPools` | Search pools | `keyword` | - |
-| `searchCountPools` | Pool search count | `keyword` | - |
-| `getTopApyPoolList` | Get top APY pool list | - | `limit`, `offset` |
-| `getPoolHooks` | Pool hooks | `poolAddress` | - |
-| `getPoolVolHistory` | Pool volume history | `poolAddress` | - |
-| `getPoolLiqHistory` | Pool liquidity history | `poolAddress` | - |
-
-**Try saying this:**
-- "Get detailed information about the SUNFLARE-USDT pool"
-- "Find the top 10 pools with highest APY"
-- "Get volume history of the USDC-TRX pool"
-- "Query all hooks used by the pool"
-
----
-
-### Trading Pairs
-
-| Tool Name | Function Description | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|
-| `getPairsFromEntity` | Token pair query | - | `token0`, `token1` |
-
-**Try saying this:**
-- "Get trading pair information between SUNFLARE and USDT"
-- "Query all trading pairs containing USDC"
-
----
-
-### Farm
-
-| Tool Name | Function Description | Required Parameters | Optional Parameters |
-|--------|---------|---------|---------|
-| `getFarms` | Farm pool list | - | - |
-
-**Try saying this:**
-- "List all available farm pools"
-- "Query current farm reward situation"
-
----
-
-## Auto-Calculation Features
-
-SUN MCP Server has multiple tools with built-in intelligent auto-calculation features designed to simplify user interaction:
-
-### V3 Liquidity Auto-Calculation
-
-**`sunswap_v3_mint_position` Auto Features:**
-
-| Feature | Description | Use Case |
-|------|------|---------|
-| **Default Fee** | If `fee` not specified, system automatically uses `3000` (0.3%) | Quickly create standard liquidity position |
-| **Tick Range Calculation** | Automatically set `tickLower` and `tickUpper` to `±50 × tickSpacing` | No need to manually calculate complex math, get reasonable range directly |
-| **Single-Sided Input Handling** | Can specify only one token amount, system automatically calculates required amount of other token | Simplify multi-token liquidity deployment |
-
-**Example:**
-```
-Request: Create V3 position in USDT-SUNFLARE pool, inject 1000 USDT
-System automatically:
-  - Set fee to 3000 (0.3%)
-  - Calculate ±50 tick range
-  - Based on current price, calculate required SUNFLARE amount
-  - Submit multi-token authorization and transaction in one go
-```
-
-### V4 Liquidity Auto-Calculation
-
-**`sunswap_v4_mint_position` Auto Features:**
-
-| Feature | Description | Use Case |
-|------|------|---------|
-| **Tick Range Calculation** | Automatically set `tickLower` and `tickUpper` to `±100 × tickSpacing` | V4's more flexible range configuration |
-| **Default Slippage** | If `slippage` not specified, system automatically uses `5%` | Protect users from price volatility |
-| **Permit2 Authorization** | Native support for Permit2 signature process, no need for multiple approvals | Improve user experience, complete all authorizations with one signature |
-| **Dynamic Pool Creation** | If pool doesn't exist, `createPoolIfNeeded` can automatically create new pool | Quickly establish liquidity for new trading pairs |
-
-**Example:**
-```
-Request: Create USDC-SUNFLARE position in V4 with 3% slippage
-System automatically:
-  - Calculate ±100 tick range
-  - Use Permit2 signature authorization
-  - Create new pool if it doesn't exist
-  - Based on current price, calculate optimal input ratio
-```
-
-### Smart Swap Routing
-
-**`sunswap_swap` Auto Features:**
-
-| Feature | Description | Use Case |
-|------|------|---------|
-| **Multi-Route Optimization** | Automatically find optimal swap path, support direct trading pairs and multi-hop routes | Get best price |
-| **Permit2 Integration** | No need to pre-approve tokens, complete authorization and swap with one signature | Improve user flow |
-
-**Example:**
-```
-Request: Swap 1000 USDT for SUNFLARE with 1% slippage
-System automatically:
-  - Evaluate direct USDT-SUNFLARE pool
-  - Evaluate USDT → intermediate → SUNFLARE routes
-  - Choose optimal path
-  - Use Permit2 one-time signature to complete authorization and trade
-  - Ensure slippage doesn't exceed 1%
-```
-
-### Key Parameter Reference
-
-| Parameter | Default Value | When Auto-Calculated |
-|------|--------|-----------|
-| `fee` (V3) | 3000 | When not provided |
-| `tickLower`, `tickUpper` (V3) | ±50×tickSpacing | When not provided |
-| `tickLower`, `tickUpper` (V4) | ±100×tickSpacing | When not provided |
-| `slippage` (V4) | 5% | When not provided |
-| Counterparty token amount | Calculated by current price | When only one token amount specified |
-
-:::tip Best Practice
-Although most parameters are auto-calculated, for critical operations (such as adding large amounts of liquidity), it's recommended to actively specify parameters to get higher control precision.
-:::
-
-
diff --git a/docs/McpServer-Skills/SKILLS/Intro.md b/docs/McpServer-Skills/SKILLS/Intro.md
index 5eefda6f..b82c192a 100644
--- a/docs/McpServer-Skills/SKILLS/Intro.md
+++ b/docs/McpServer-Skills/SKILLS/Intro.md
@@ -57,111 +57,23 @@ No. Skills use an **on-demand, lightweight architecture** — the AI only loads
 
 ## What Can Skills Do for You?
 
-Fourteen skills in total — covering the most common scenarios in the TRON ecosystem plus X/Twitter tooling, and a dedicated onboarding helper. Each one comes with a ready-to-use sample prompt — copy it into your AI chat and hit enter to try it out.
-
-### 🔑 Secure Wallet Management
-
-Create encrypted wallets, sign transactions and messages, manage multiple wallets — all without exposing your private key. This is the foundation that other trading and payment skills rely on. Supports both EVM (BSC, Ethereum, Polygon, etc.) and TRON networks.
-
-> 🗣️ "Create a new agent wallet for me" or "List all my wallets and show their addresses."
-
-💡 For setup and advanced usage, see: [**agent-wallet**](./BANKOFAISkill.md#agent-wallet)
-
-### 💱 Execute DEX Trades
-
-Check prices, compare rates, even swap tokens in one go.
-
-> 🗣️ "How much TRX can I get for 100 USDT on SunSwap right now?"
-
-💡 For more advanced features, see: [**sunswap**](./BANKOFAISkill.md#sunswap)
-
-### 🚀 Launch & Trade SunPump Meme Coins
-
-Create your own meme token in one sentence, buy and sell on SunPump — TRON's meme-token launchpad — and check market data. Token creation happens **server-side, no wallet needed**: just give a name, symbol, description, and logo. For trading, the AI automatically picks the right path: tokens that haven't created a SunSwap V2 pair yet ("pre-launch") trade on the bonding curve, while tokens that already have a SunSwap V2 pair ("post-launch") go through a regular swap. You can also look up token detail, rankings, holder distribution, and wallet portfolios. TRON mainnet only.
-
-> 🗣️ "Launch a meme token on SunPump — here are the name, symbol, description, and logo." or "Show me the top 10 SunPump meme coins by 24h gain, then check the holder concentration of the top one."
-
-💡 For trading and risk details, see: [**sunpump-agent-skill**](./BANKOFAISkill.md#sunpump-agent-skill)
-
-### 📈 Trade Perpetual Contracts
-
-View market data, open and close positions on SunPerp. Built-in safety locks: max 20x leverage (configurable) and a mandatory stop-loss on every position-opening order — auto-set to 5% from entry if omitted, and rejected if wider than 25%. Keeps you from blowing up your account.
-
-> 🗣️ "What's BTC's funding rate right now? Open a 5x long position with a 5% stop-loss."
-
-💡 For more parameter settings, see: [**sunperp-skill**](./BANKOFAISkill.md#sunperp-skill)
-
-### 🕵️ Query On-Chain Data
-
-Look up accounts, transactions, and check if a new token is legit. Pure read-only, completely safe, costs nothing.
-
-> 🗣️ "Check the holder distribution for that new token — is it controlled by a whale?"
-
-💡 For more query dimensions, see: [**tronscan-skill**](./BANKOFAISkill.md#tronscan-skill)
-
-### 💸 Transfer & Manage TRC20 Tokens
-
-Check balances, transfer tokens, manage approvals — supports common tokens like USDT, USDD, SUN, and can also operate any TRC20 token via its contract address. Supports batch balance checks.
-
-> 🗣️ "Check my USDT, USDD, and SUN balances. Then transfer 10 USDT to TRecipientAddress."
-
-💡 For more token operations, see: [**trc20-toolkit-skill**](./BANKOFAISkill.md#trc20-toolkit-skill)
-
-### 💵 USDD Stablecoin & JUST Protocol
-
-Swap USDT ↔ USDD at 1:1 via the Peg Stability Module (zero fee currently), check USDD/USDT/USDC/TRX/JST balances, and read vault (CDP) positions and protocol parameters.
-
-> 🗣️ "Sell 1000 USDT for USDD via the PSM" or "Show me all USDD vault types and their stability fees."
-
-💡 For PSM swaps and vault queries, see: [**usdd-skill**](./BANKOFAISkill.md#usdd-skill)
-
-### 🗳️ TRX Staking & SR Voting
-
-Stake TRX for TRON Power, vote for Super Representatives, and claim voting rewards. Stake 2.0 compatible — top 27 SRs distribute block rewards every 6 hours proportionally to their voters.
-
-> 🗣️ "Show my TRON Power and current votes, then list the top 10 SRs." or "Claim my pending voting rewards."
-
-💡 For staking, voting, and reward flows, see: [**trx-staking-skill**](./BANKOFAISkill.md#trx-staking-skill)
-
-### 🔐 Multi-Sig & Account Permissions
-
-Set up multi-signature security for your TRON account — configure keys, thresholds, and co-sign transactions. Perfect for teams or for restricting your AI agent to DeFi-only operations.
-
-> 🗣️ "Check my account's current permission setup. Then set up a 2-of-3 multi-sig on owner permission."
-
-💡 For permission templates and multi-sig workflows, see: [**multisig-permissions**](./BANKOFAISkill.md#multisig-permissions)
-
-### ☕ Auto-Settle On-Chain Paid Services
-
-When the AI needs to call a paid on-chain service or data API, it uses the x402 protocol to automatically complete "pay first, then receive" on-chain settlement — no manual QR scanning or wallet switching needed. Multi-chain support — TRON (TRC20: USDT, USDD, with GasFree) and BSC (ERC20: USDT, USDC) both work; just switch the `--network` parameter.
-
-> 🗣️ "Use the x402 protocol to call this paid agent endpoint: https://api.example.com" (replace with the actual paid endpoint URL you want to call)
-
-💡 For payment and authorization details, see: [**x402-payment**](./BANKOFAISkill.md#x402-payment)
-
-### 🏦 Manage BANK OF AI Account
-
-Check your BANK OF AI balance and top up with a single sentence.
-
-> 🗣️ "How much balance do I have? Go ahead and recharge 5 USDT."
-
-💡 For top-up and withdrawal rules, see: [**recharge-skill**](./BANKOFAISkill.md#recharge-skill)
-
-### 🐦 X/Twitter Daily Digest
-
-Turn your own X/Twitter account into a daily briefing — mentions, home timeline, and reply opportunities, summarized for you.
-
-> 🗣️ "Generate today's X/Twitter digest for my account."
-
-💡 Two ways to run it: API-only via [**twitter-digest**](./BANKOFAISkill.md#twitter-digest), or from the local `xurl` CLI via [**twitter-mcp**](./BANKOFAISkill.md#twitter-mcp).
-
-### 🧭 Onboarding Guide (bankofai-guide)
-
-A lightweight companion skill that runs the post-install setup flow, helps you create your first AgentWallet, and acts as a "wallet guard" before any on-chain operation — reminding you to set up a wallet if none exists. You don't usually call it directly; it gets invoked automatically by the installer and by other skills when needed.
-
-> 🗣️ "Walk me through BANK OF AI onboarding." or "Run bankofai-guide so I can set up my first wallet."
-
-💡 For the full onboarding flow, see: [**bankofai-guide**](./BANKOFAISkill.md#bankofai-guide)
+Fourteen skills covering the most common TRON scenarios plus X/Twitter tooling — the table below shows everything at a glance. Each comes with a sample prompt you can paste straight into your AI chat; click a skill name for its full docs.
+
+| Skill | What it does | Try saying |
+| :-- | :-- | :-- |
+| 🔑 [agent-wallet](./BANKOFAISkill.md#agent-wallet) | Create/manage encrypted wallets and sign transactions without exposing your key; the foundation other skills rely on (EVM + TRON) | "Create a new agent wallet for me" |
+| 💱 [sunswap](./BANKOFAISkill.md#sunswap) | Check prices, compare rates, swap tokens in one go | "How much TRX can I get for 100 USDT?" |
+| 🚀 [sunpump-agent-skill](./BANKOFAISkill.md#sunpump-agent-skill) | Launch a meme token in one sentence, trade and track SunPump (TRON mainnet only; creation needs no wallet) | "Launch a meme token on SunPump" |
+| 📈 [sunperp-skill](./BANKOFAISkill.md#sunperp-skill) | SunPerp perpetuals — market data, open/close positions; built-in guardrails: ≤20x leverage, mandatory stop-loss | "Open a 5x long with a 5% stop-loss" |
+| 🕵️ [tronscan-skill](./BANKOFAISkill.md#tronscan-skill) | Look up accounts, transactions, token safety; read-only, free, zero risk | "Is that new token whale-controlled?" |
+| 💸 [trc20-toolkit-skill](./BANKOFAISkill.md#trc20-toolkit-skill) | TRC20 balances, transfers, approvals — batch checks and any contract address | "Transfer 10 USDT to TRecipientAddress" |
+| 💵 [usdd-skill](./BANKOFAISkill.md#usdd-skill) | 1:1 USDT ↔ USDD via the PSM (currently zero fee), read vault (CDP) positions | "Sell 1000 USDT for USDD via the PSM" |
+| 🗳️ [trx-staking-skill](./BANKOFAISkill.md#trx-staking-skill) | Stake TRX, vote for SRs, claim rewards (Stake 2.0) | "Claim my pending voting rewards" |
+| 🔐 [multisig-permissions](./BANKOFAISkill.md#multisig-permissions) | Multi-sig and permission management — great for teams or limiting your AI | "Set up a 2-of-3 multi-sig on owner" |
+| ☕ [x402-payment](./BANKOFAISkill.md#x402-payment) | Auto "pay first, then receive" settlement via x402 when calling paid APIs (TRON / BSC) | "Use x402 to call this paid endpoint: https://…" |
+| 🏦 [recharge-skill](./BANKOFAISkill.md#recharge-skill) | Check your BANK OF AI balance and top up in one sentence | "Check my balance, then recharge 5 USDT" |
+| 🐦 [twitter-digest](./BANKOFAISkill.md#twitter-digest) / [twitter-mcp](./BANKOFAISkill.md#twitter-mcp) | Your X/Twitter daily briefing: mentions, timeline, reply opportunities | "Generate today's X digest for my account" |
+| 🧭 [bankofai-guide](./BANKOFAISkill.md#bankofai-guide) | Onboarding + "wallet guard"; usually invoked automatically by the installer | "Walk me through BANK OF AI onboarding" |
 
 ---
 
diff --git a/docs/McpServer-Skills/Tools/SUNCli/CommandGuide.md b/docs/McpServer-Skills/Tools/SUNCli/CommandGuide.md
deleted file mode 100644
index 441640da..00000000
--- a/docs/McpServer-Skills/Tools/SUNCli/CommandGuide.md
+++ /dev/null
@@ -1,1189 +0,0 @@
-# Complete Capabilities
-
-This page is the complete reference for all SUN CLI commands. Commands are organized by category: wallet management, price, token, swap, pool, liquidity, position, pair, farm, protocol, transaction, contract, and SunPump.
-
-> Legend: `<arg>` = required argument, `[arg]` = optional argument.
-> Options marked with **(required)** must be provided. All others are optional.
-
----
-
-## Global Flags
-
-All commands inherit these root-level flags. **Root flags must be placed before the subcommand.**
-
-| Flag | Description |
-| :--- | :--- |
-| `--output <format>` | Output format: `table`, `json`, `tsv` |
-| `--json` | Shortcut for JSON output |
-| `--fields <list>` | Comma-separated output field filter |
-| `--network <network>` | Override `TRON_NETWORK` (e.g., `mainnet`, `nile`, `shasta`) |
-| `-k, --private-key <key>` | Provide a private key for this invocation only |
-| `-m, --mnemonic <phrase>` | Provide a mnemonic for this invocation only |
-| `-i, --mnemonic-account-index <index>` | Provide a mnemonic account index for this invocation only |
-| `-p, --agent-wallet-password <password>` | Override `AGENT_WALLET_PASSWORD` for this invocation |
-| `-d, --agent-wallet-dir <dir>` | Override `AGENT_WALLET_DIR` for this invocation |
-| `-y, --yes` | Skip confirmation prompts |
-| `--dry-run` | Print intent without sending the write action |
-
-:::caution Private Key Security
-The `-k` / `--private-key` and `-m` / `--mnemonic` flags pass sensitive
-material as command-line arguments, which may be recorded in shell history
-and process listings. Prefer environment variables (`AGENT_WALLET_PRIVATE_KEY`,
-`AGENT_WALLET_MNEMONIC`) or [agent-wallet](https://github.com/BofAI/agent-wallet)
-encrypted storage for all non-throwaway keys.
-:::
-
-**Examples:**
-
-```bash
-sun --json price TRX
-```
-
-```bash
-sun --output tsv pool top-apy --page-size 10
-```
-
-```bash
-sun --fields address,network wallet address
-```
-
-```bash
-sun -p your_agent_wallet_password wallet address
-```
-
-```bash
-sun -k your_private_key --network nile --yes swap TRX USDT 1000000
-```
-
-```bash
-sun --dry-run contract send TContract transfer --args '["TRecipient","1000000"]'
-```
-
----
-
-## Wallet & Portfolio
-
-### `wallet address` (read)
-
-Print the active wallet address.
-
-```bash
-sun wallet address
-```
-
-### `wallet balances` (read)
-
-Fetch wallet token balances.
-
-```bash
-sun wallet balances [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--owner <address>` | Wallet address to query | Active wallet |
-| `--tokens <tokens>` | Comma-separated token list: `TRX,<TRC20_ADDRESS>,...` | `TRX` |
-
----
-
-## Price
-
-### `price [token]` (read)
-
-Get token prices from SUN.IO. Accepts a built-in symbol or address.
-
-```bash
-sun price [token] [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--address <addresses>` | Comma-separated token contract addresses | — |
-
-```bash
-sun price TRX
-```
-
-```bash
-sun price USDT
-```
-
-```bash
-sun price --address TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
-```
-
----
-
-## Token
-
-### `token list` (read)
-
-Fetch tokens by address or protocol.
-
-```bash
-sun token list [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--address <tokenAddress>` | Filter by token contract address | — |
-| `--protocol <protocol>` | Protocol filter (V2, V3, V4) | — |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-| `--sort <field>` | Sort field | — |
-| `--no-blacklist` | Include blacklisted tokens | `false` |
-
-### `token search <keyword>` (read)
-
-Fuzzy search for tokens by name or symbol.
-
-```bash
-sun token search <keyword> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | Protocol filter | — |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-
----
-
-## Swap
-
-:::caution Amount precision — `<amountIn>` is an integer scaled by the token's `decimals`
-Every `<amountIn>` (and every `--amount*` option in the Liquidity section below) is the human-readable amount × `10^decimals`. **No decimal point, no automatic conversion.**
-
-- TRX, USDT (TRC20), WTRX, USDCOLD, WIN — **6 decimals** → `1` token = `1000000`
-- USDD, SUN, JST, BTT, USDDOLD — **18 decimals** → `1` token = `1000000000000000000`
-
-So `sun swap TRX USDT 1000000` swaps **1 TRX** (not 1,000,000 TRX) for USDT.
-:::
-
-### `swap <tokenIn> <tokenOut> <amountIn>` (write)
-
-Execute a token swap via SunSwap Universal Router.
-
-```bash
-sun swap <tokenIn> <tokenOut> <amountIn> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--slippage <n>` | Slippage tolerance as decimal (e.g. 0.005 = 0.5%) | `0.005` |
-
-```bash
-# Swap 1 TRX for USDT
-sun swap TRX USDT 1000000
-```
-
-```bash
-# Same swap, with 1% slippage tolerance
-sun swap TRX USDT 1000000 --slippage 0.01
-```
-
-### `swap:quote <tokenIn> <tokenOut> <amountIn>` (read)
-
-Get a swap quote without executing.
-
-```bash
-sun swap:quote <tokenIn> <tokenOut> <amountIn> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--all` | Show all available routes | `false` |
-
-```bash
-# Quote: swap 1 TRX for USDT
-sun swap:quote TRX USDT 1000000
-```
-
-```bash
-sun swap:quote TRX USDT 1000000 --all
-```
-
-### `swap:quote-raw` (read)
-
-Low-level router quote call.
-
-```bash
-sun swap:quote-raw [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--router <address>` | **(required)** Smart router contract address | — |
-| `--fn <name>` | Quote function name | `quoteExactInput` |
-| `--args <json>` | **(required)** Arguments as JSON array | — |
-| `--abi <json>` | Router ABI as JSON array | — |
-
-### `swap:exact-input` (write)
-
-Low-level router swap execution.
-
-```bash
-sun swap:exact-input [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--router <address>` | **(required)** Smart router contract address | — |
-| `--fn <name>` | Swap function name | `swapExactInput` |
-| `--args <json>` | **(required)** Arguments as JSON array | — |
-| `--value <sun>` | TRX call value in Sun | — |
-| `--abi <json>` | Router ABI as JSON array | — |
-
----
-
-## Pool
-
-### `pool list` (read)
-
-List pools with filters.
-
-```bash
-sun pool list [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--address <poolAddress>` | Filter by pool address | — |
-| `--token <tokenOrAddress>` | Filter by token (symbol or address) | — |
-| `--protocol <protocol>` | Protocol filter (V2, V3, V4) | — |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-| `--sort <field>` | Sort field | — |
-| `--no-blacklist` | Include blacklisted pools | `false` |
-
-### `pool search <keyword>` (read)
-
-Search pools by keyword.
-
-```bash
-sun pool search <keyword> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | Protocol filter | — |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-
-### `pool top-apy` (read)
-
-List top APY pools.
-
-```bash
-sun pool top-apy [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | Protocol filter | — |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-
-### `pool hooks` (read)
-
-List registered pool hooks.
-
-```bash
-sun pool hooks
-```
-
-### `pool vol-history <poolAddress>` (read)
-
-Pool volume history over a date range.
-
-```bash
-sun pool vol-history <poolAddress> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--start <date>` | Start date (YYYY-MM-DD) | — |
-| `--end <date>` | End date (YYYY-MM-DD) | — |
-
-### `pool liq-history <poolAddress>` (read)
-
-Pool liquidity history over a date range.
-
-```bash
-sun pool liq-history <poolAddress> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--start <date>` | Start date (YYYY-MM-DD) | — |
-| `--end <date>` | End date (YYYY-MM-DD) | — |
-
----
-
-## Liquidity
-
-### `liquidity v2:add` (write)
-
-Add V2 liquidity. Router address is auto-detected by network.
-
-```bash
-sun liquidity v2:add [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token-a <tokenOrSymbol>` | **(required)** Token A (symbol or address) | — |
-| `--token-b <tokenOrSymbol>` | **(required)** Token B (symbol or address) | — |
-| `--amount-a <raw>` | Amount of token A (raw units) | — |
-| `--amount-b <raw>` | Amount of token B (raw units) | — |
-| `--min-a <raw>` | Minimum amount A | — |
-| `--min-b <raw>` | Minimum amount B | — |
-| `--router <address>` | V2 router address | Auto by network |
-| `--to <address>` | LP token recipient | Active wallet |
-| `--deadline <timestamp>` | Transaction deadline | — |
-| `--abi <json>` | Custom router ABI | — |
-
-> Provide at least one of `--amount-a` or `--amount-b`. When only one is given, the other is auto-calculated from pool reserves.
-
-Create a new liquidity pool (both token amounts required):
-
-```bash
-sun liquidity v2:add --token-a TRX --token-b USDT --amount-a 1000000 --amount-b 290000
-```
-
-Add liquidity to an existing pool (the other token amount is calculated automatically):
-
-```bash
-sun liquidity v2:add --token-a TRX --token-b USDT --amount-a 1000000
-```
-
-### `liquidity v2:remove` (write)
-
-Remove V2 liquidity.
-
-```bash
-sun liquidity v2:remove [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token-a <tokenOrSymbol>` | **(required)** Token A | — |
-| `--token-b <tokenOrSymbol>` | **(required)** Token B | — |
-| `--liquidity <raw>` | **(required)** LP token amount to remove | — |
-| `--min-a <raw>` | Minimum amount A | — |
-| `--min-b <raw>` | Minimum amount B | — |
-| `--router <address>` | V2 router address | Auto by network |
-| `--to <address>` | Token recipient | Active wallet |
-| `--deadline <timestamp>` | Transaction deadline | — |
-| `--abi <json>` | Custom router ABI | — |
-
-```bash
-sun liquidity v2:remove --token-a TRX --token-b USDT --liquidity 500000
-```
-
-### `liquidity v3:mint` (write)
-
-Mint a new V3 concentrated liquidity position. Position Manager is auto-detected by network.
-
-```bash
-sun liquidity v3:mint [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token0 <tokenOrSymbol>` | **(required)** Token 0 (symbol or address) | — |
-| `--token1 <tokenOrSymbol>` | **(required)** Token 1 (symbol or address) | — |
-| `--fee <n>` | Pool fee tier | `3000` |
-| `--tick-lower <n>` | Lower tick boundary | Auto |
-| `--tick-upper <n>` | Upper tick boundary | Auto |
-| `--amount0 <raw>` | Amount of token 0 | — |
-| `--amount1 <raw>` | Amount of token 1 | — |
-| `--min0 <raw>` | Minimum amount 0 | — |
-| `--min1 <raw>` | Minimum amount 1 | — |
-| `--pm <address>` | Position Manager address | Auto by network |
-| `--recipient <address>` | NFT recipient | Active wallet |
-| `--deadline <timestamp>` | Transaction deadline | — |
-| `--abi <json>` | Custom ABI | — |
-
-> Provide at least one of `--amount0` or `--amount1`. When only one is given, the other is auto-calculated. TRX is automatically converted to WTRX for V3 pool lookup.
-
-```bash
-sun liquidity v3:mint --token0 TRX --token1 USDT --amount0 1000000
-```
-
-### `liquidity v3:increase` (write)
-
-Increase liquidity on an existing V3 position.
-
-```bash
-sun liquidity v3:increase [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **(required)** Position NFT token ID | — |
-| `--amount0 <raw>` | Amount of token 0 | — |
-| `--amount1 <raw>` | Amount of token 1 | — |
-| `--min0 <raw>` | Minimum amount 0 | — |
-| `--min1 <raw>` | Minimum amount 1 | — |
-| `--token0 <tokenOrSymbol>` | Token 0 (needed for single-sided auto-compute) | — |
-| `--token1 <tokenOrSymbol>` | Token 1 (needed for single-sided auto-compute) | — |
-| `--fee <n>` | Pool fee (needed for single-sided auto-compute) | `3000` |
-| `--pm <address>` | Position Manager address | Auto by network |
-| `--deadline <timestamp>` | Transaction deadline | — |
-| `--abi <json>` | Custom ABI | — |
-
-> When providing only one amount, `--token0`, `--token1`, and `--fee` are required for auto-calculation.
-
-```bash
-sun liquidity v3:increase --token-id 123 --amount0 500000
-```
-
-### `liquidity v3:decrease` (write)
-
-Decrease liquidity on an existing V3 position.
-
-```bash
-sun liquidity v3:decrease [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **(required)** Position NFT token ID | — |
-| `--liquidity <raw>` | **(required)** Liquidity amount to remove | — |
-| `--min0 <raw>` | Minimum amount 0 | — |
-| `--min1 <raw>` | Minimum amount 1 | — |
-| `--pm <address>` | Position Manager address | Auto by network |
-| `--deadline <timestamp>` | Transaction deadline | — |
-| `--abi <json>` | Custom ABI | — |
-
-```bash
-sun liquidity v3:decrease --token-id 123 --liquidity 1000
-```
-
-### `liquidity v3:collect` (write)
-
-Collect accumulated fees from a V3 position.
-
-```bash
-sun liquidity v3:collect [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **(required)** Position NFT token ID | — |
-| `--recipient <address>` | Fee recipient | Active wallet |
-| `--pm <address>` | Position Manager address | Auto by network |
-| `--abi <json>` | Custom ABI | — |
-
-```bash
-sun liquidity v3:collect --token-id 123
-```
-
-### `liquidity v4:mint` (write)
-
-Mint a new V4 concentrated liquidity position.
-
-```bash
-sun liquidity v4:mint [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token0 <tokenOrSymbol>` | **(required)** Token 0 | — |
-| `--token1 <tokenOrSymbol>` | **(required)** Token 1 | — |
-| `--fee <n>` | Pool fee tier | — |
-| `--tick-lower <n>` | Lower tick boundary | Auto |
-| `--tick-upper <n>` | Upper tick boundary | Auto |
-| `--amount0 <raw>` | Amount of token 0 | — |
-| `--amount1 <raw>` | Amount of token 1 | — |
-| `--slippage <n>` | Slippage tolerance | — |
-| `--sqrt-price <value>` | Initial sqrtPriceX96 (for pool creation) | — |
-| `--create-pool` | Create the pool if it doesn't exist | `false` |
-| `--recipient <address>` | NFT recipient | Active wallet |
-| `--deadline <timestamp>` | Transaction deadline | — |
-
-In an existing pool:
-
-```bash
-sun liquidity v4:mint --token0 TRX --token1 USDT --amount0 1000000
-```
-
-Create pool if it does not exist:
-
-```bash
-sun liquidity v4:mint --token0 TRX --token1 USDT --amount0 1000000 --create-pool
-```
-
-### `liquidity v4:increase` (write)
-
-Increase liquidity on an existing V4 position.
-
-```bash
-sun liquidity v4:increase [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **(required)** Position NFT token ID | — |
-| `--token0 <tokenOrSymbol>` | **(required)** Token 0 | — |
-| `--token1 <tokenOrSymbol>` | **(required)** Token 1 | — |
-| `--fee <n>` | Pool fee tier | — |
-| `--amount0 <raw>` | Amount of token 0 | — |
-| `--amount1 <raw>` | Amount of token 1 | — |
-| `--slippage <n>` | Slippage tolerance | — |
-| `--deadline <timestamp>` | Transaction deadline | — |
-
-```bash
-sun liquidity v4:increase --token-id 123 --token0 TRX --token1 USDT --amount0 500000
-```
-
-### `liquidity v4:decrease` (write)
-
-Decrease liquidity on an existing V4 position.
-
-```bash
-sun liquidity v4:decrease [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **(required)** Position NFT token ID | — |
-| `--liquidity <raw>` | **(required)** Liquidity amount to remove | — |
-| `--token0 <tokenOrSymbol>` | **(required)** Token 0 | — |
-| `--token1 <tokenOrSymbol>` | **(required)** Token 1 | — |
-| `--fee <n>` | Pool fee tier | — |
-| `--min0 <raw>` | Minimum amount 0 | — |
-| `--min1 <raw>` | Minimum amount 1 | — |
-| `--slippage <n>` | Slippage tolerance | — |
-| `--deadline <timestamp>` | Transaction deadline | — |
-
-```bash
-sun liquidity v4:decrease --token-id 123 --liquidity 1000 --token0 TRX --token1 USDT
-```
-
-### `liquidity v4:collect` (write)
-
-Collect accumulated fees from a V4 position.
-
-```bash
-sun liquidity v4:collect [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **(required)** Position NFT token ID | — |
-| `--token0 <tokenOrSymbol>` | Token 0 | — |
-| `--token1 <tokenOrSymbol>` | Token 1 | — |
-| `--fee <n>` | Pool fee tier | — |
-| `--deadline <timestamp>` | Transaction deadline | — |
-
-```bash
-sun liquidity v4:collect --token-id 123
-```
-
-### `liquidity v4:info` (read)
-
-Get details about a V4 position.
-
-```bash
-sun liquidity v4:info [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--pm <address>` | **(required)** Position Manager address | — |
-| `--token-id <id>` | **(required)** Position NFT token ID | — |
-
-```bash
-sun liquidity v4:info --pm <positionManager> --token-id 123
-```
-
----
-
-## Position
-
-### `position list` (read)
-
-List liquidity positions.
-
-```bash
-sun position list [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--owner <address>` | Owner wallet address | — |
-| `--pool <poolAddress>` | Filter by pool | — |
-| `--protocol <protocol>` | Protocol filter (V2, V3, V4) | — |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-
-### `position tick <poolAddress>` (read)
-
-Get tick data for a pool.
-
-```bash
-sun position tick <poolAddress> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-
----
-
-## Pair
-
-### `pair info` (read)
-
-Get token pair information.
-
-```bash
-sun pair info [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--token <tokenAddress>` | Token contract address | — |
-| `--protocol <protocol>` | Protocol filter | — |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-
----
-
-## Farm
-
-### `farm list` (read)
-
-List farming pools.
-
-```bash
-sun farm list [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--farm <farmAddress>` | Filter by farm address | — |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-
-### `farm tx` (read)
-
-List farming transaction history.
-
-```bash
-sun farm tx [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--owner <address>` | Owner address | — |
-| `--farm <farmAddress>` | Filter by farm | — |
-| `--type <farmTxType>` | Transaction type | — |
-| `--start <time>` | Start time (ISO or unix ms) | — |
-| `--end <time>` | End time | — |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-
-### `farm positions` (read)
-
-List farming positions.
-
-```bash
-sun farm positions [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--owner <address>` | Owner address | — |
-| `--farm <farmAddress>` | Filter by farm | — |
-| `--page <n>` | Page number | `1` |
-| `--page-size <n>` | Page size | `20` |
-
----
-
-## Protocol
-
-### `protocol info` (read)
-
-```bash
-sun protocol info [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | Protocol filter | — |
-
-### `protocol vol-history` (read)
-
-```bash
-sun protocol vol-history [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | Protocol filter | — |
-| `--start <date>` | Start date (YYYY-MM-DD) | — |
-| `--end <date>` | End date (YYYY-MM-DD) | — |
-
-### `protocol users-history` (read)
-
-```bash
-sun protocol users-history [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | Protocol filter | — |
-| `--start <date>` | Start date | — |
-| `--end <date>` | End date | — |
-
-### `protocol tx-history` (read)
-
-```bash
-sun protocol tx-history [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | Protocol filter | — |
-| `--start <date>` | Start date | — |
-| `--end <date>` | End date | — |
-
-### `protocol pools-history` (read)
-
-```bash
-sun protocol pools-history [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | Protocol filter | — |
-| `--start <date>` | Start date | — |
-| `--end <date>` | End date | — |
-
-### `protocol liq-history` (read)
-
-```bash
-sun protocol liq-history [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | Protocol filter | — |
-| `--start <date>` | Start date | — |
-| `--end <date>` | End date | — |
-
----
-
-## Transaction
-
-### `tx scan` (read)
-
-Scan on-chain transaction history.
-
-```bash
-sun tx scan [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | Protocol filter | — |
-| `--token <tokenAddress>` | Filter by token address | — |
-| `--pool <poolAddress>` | Filter by pool address | — |
-| `--type <type>` | Transaction type: `swap`, `add`, `withdraw` | — |
-| `--start <time>` | Start time (ISO or unix ms) | — |
-| `--end <time>` | End time | — |
-| `--page-size <n>` | Page size | `20` |
-| `--offset <offset>` | Pagination offset | — |
-
----
-
-## Contract
-
-### `contract read <address> <functionName>` (read)
-
-Read from any TRON smart contract.
-
-```bash
-sun contract read <address> <functionName> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--args <json>` | Arguments as JSON array | `[]` |
-| `--abi <json>` | Contract ABI as JSON array | — |
-
-```bash
-sun contract read TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t balanceOf --args '["TYourAddress"]'
-```
-
-### `contract send <address> <functionName>` (write)
-
-Send a transaction to any TRON smart contract.
-
-```bash
-sun contract send <address> <functionName> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--args <json>` | Arguments as JSON array | `[]` |
-| `--value <sun>` | TRX call value in Sun | — |
-| `--abi <json>` | Contract ABI as JSON array | — |
-
-```bash
-sun contract send TRecipient transfer --args '["TRecipient","1000000"]' --value 0
-```
-
-`contract send` returns `tronscanUrl` when a transaction is broadcast successfully.
-
----
-
-## SunPump
-
-SunPump is the meme-token launchpad on TRON. This command group covers token discovery (prices, rankings, holders, wallet portfolios, trade history), one-command token creation (`launch`), plus pre-launch trading.
-
-> **About the Bonding Curve:** the Bonding Curve is a token's launch progress bar — as the community participates and buys in, the meme coin's market cap grows and the curve fills toward 100%; once it hits 100% a trading pair is automatically created on SunSwap V2 and the token "launches". Tokens still under 100% (pre-launch) trade with `sun sunpump buy/sell` on SunPump; after launch, use [`sun swap`](#swap) instead.
-
-:::caution SunPump is TRON mainnet only
-All `sunpump` subcommands only work on TRON mainnet. The API host is `https://api-v2.sunpump.meme/pump-api` and the on-chain bonding-curve contract is `TTfvyrAz86hbZk5iDpKD78pqLGgi8C7AAw`. Passing `--network nile` (or any non-mainnet value) fails fast with `SunPump is only available on mainnet`. Drop `--network` or pass `--network mainnet`.
-:::
-
-:::tip Pre-launch vs post-launch — pick the right trade command
-- **Pre-launch (Bonding Curve under 100%, no SunSwap V2 pair yet):** `tokenLaunchedInstant` is `null`, on-chain `state` is `1` (TRADING) or `2` (READY_TO_LAUNCH) — trade with `sun sunpump buy` / `sun sunpump sell`.
-- **Post-launch (SunSwap V2 pair created):** `state` is `3` (LAUNCHED) and `swapPoolAddress` is set — use [`sun swap`](#swap) instead.
-
-Run `sun sunpump state <addr>` or `sun sunpump token get <addr>` before trading to decide which path to use. Read-only queries (prices, holders, portfolio, trade history) and `launch` need no wallet; trading does.
-:::
-
-### `sunpump token get <contractAddress>` (read)
-
-Get SunPump token detail by contract address: price, market cap, 24h volume, holder count, total supply, owner, swap-pool address, social links, and launch state.
-
-```bash
-sun sunpump token get <contractAddress>
-```
-
-### `sunpump token list` (read)
-
-List SunPump tokens with optional filters and pagination.
-
-```bash
-sun sunpump token list [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--contract <address>` | Filter by contract address | — |
-| `--owner <address>` | Filter by owner address | — |
-| `--symbol <symbol>` | Filter by symbol | — |
-| `--name <name>` | Filter by name | — |
-| `--description <text>` | Filter by description | — |
-| `--page <n>` | Page number | — |
-| `--size <n>` | Page size | — |
-| `--sort <field>` | Sort field (e.g. `marketCap,desc`) | — |
-
-### `sunpump token search <query>` (read)
-
-Fuzzy search tokens by name or symbol.
-
-```bash
-sun sunpump token search <query> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--on-sunswap` | Only tokens already launched on SunSwap | `false` |
-| `--page <n>` | Page number | — |
-| `--size <n>` | Page size | — |
-| `--sort <field>` | Sort field | — |
-
-### `sunpump token search-v2 <query>` (read)
-
-The v2 version of fuzzy search (calls the `/token/searchV2` endpoint). Compared with `search`, it adds the `--dlive`, `--ai-helper`, `--twitter-launch`, and `--sun-agent-launch` filters.
-
-```bash
-sun sunpump token search-v2 <query> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--on-sunswap` | Only tokens already launched on SunSwap | — |
-| `--dlive` | Filter: DLive showing | — |
-| `--ai-helper` | Filter: AI helper | — |
-| `--twitter-launch` | Filter: Twitter launch | — |
-| `--sun-agent-launch` | Filter: Sun agent launch | — |
-| `--page <n>` | Page number | — |
-| `--size <n>` | Page size | — |
-| `--sort <field>` | Sort field | — |
-
-### `sunpump token by-owner <ownerAddress>` (read)
-
-List tokens created by a wallet.
-
-```bash
-sun sunpump token by-owner <ownerAddress> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--page <n>` | Page number | — |
-| `--size <n>` | Page size | — |
-| `--sort <field>` | Sort field | — |
-
-### `sunpump token holders <tokenAddress>` (read)
-
-List a token's holders, with balance and percentage.
-
-```bash
-sun sunpump token holders <tokenAddress> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--include-zero` | Include zero-balance holders | — |
-| `--page <n>` | Page number | — |
-| `--size <n>` | Page size | — |
-| `--sort <field>` | Sort field (default: balance descending) | — |
-
-> The `percent` field is returned as a percent value (e.g. `38.51` = 38.51%) by the holders endpoint, but as a fraction (e.g. `0.3851`) by the token-list endpoint. The CLI normalizes this, but check the magnitude when reading raw JSON.
-
-### `sunpump token holders-v2 <tokenAddress>` (read)
-
-The v2 version of the holders list (calls the newer `/token/holdersV2` endpoint). Same input options as `holders`; returned fields may differ slightly.
-
-```bash
-sun sunpump token holders-v2 <tokenAddress> [options]
-```
-
-### `sunpump token ranking` (read)
-
-Get token ranking by a chosen metric. **`--type` is required.**
-
-```bash
-sun sunpump token ranking --type MARKET_CAP --size 10
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--type <rankingType>` | **(required)** Ranking type: `MARKET_CAP`, `VOLUME_24H`, `PRICE_CHANGE_24H` | — |
-| `--size <n>` | Number of entries | — |
-
-> `--type` only accepts `MARKET_CAP`, `VOLUME_24H`, or `PRICE_CHANGE_24H` (case-sensitive); other values are rejected by the API.
-
-### `sunpump token king-of-hill` (read)
-
-Get the current king-of-the-hill token.
-
-```bash
-sun sunpump token king-of-hill
-```
-
-### `sunpump token pump-list` (read)
-
-Get the raw SunPump token list (returns the API response directly, without stripping the outer `{code, msg, data}` envelope).
-
-```bash
-sun sunpump token pump-list
-```
-
-### `sunpump token favors` (read, requires signature)
-
-List a user's favorite tokens. Requires a signed message.
-
-```bash
-sun sunpump token favors --user-address <address> --signature <sig> --signed-message <msg> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--user-address <address>` | **(required)** User wallet address | — |
-| `--signature <sig>` | **(required)** Signature of the signed message | — |
-| `--signed-message <msg>` | **(required)** The signed message | — |
-| `--token-address <address>` | Filter by token address | — |
-| `--page <n>` | Page number | — |
-| `--size <n>` | Page size | — |
-
-### `sunpump tx token <contractAddress>` (read)
-
-Query a token's buy/sell trade history.
-
-```bash
-sun sunpump tx token <contractAddress> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--swap-type <type>` | Direction filter (`BUY` / `SELL`) | — |
-| `--pool <address>` | Swap pool address | — |
-| `--tx-hash <hash>` | Specific tx hash | — |
-| `--block <n>` | Block number | — |
-| `--start-time <epoch>` | Start time (epoch **seconds**) | — |
-| `--end-time <epoch>` | End time (epoch **seconds**) | — |
-| `--page <n>` | Page number | — |
-| `--size <n>` | Page size | — |
-| `--sort <field>` | Sort field (e.g. `txDateTime,desc`) | — |
-
-> `--start-time` / `--end-time` are epoch **seconds**, not milliseconds.
-
-### `sunpump tx user <ownerAddress>` (read)
-
-Query a wallet's buy/sell trade history. Same options as `tx token`.
-
-```bash
-sun sunpump tx user <ownerAddress> --size 20
-sun sunpump tx user <ownerAddress> --swap-type BUY --size 20
-```
-
-### `sunpump portfolio <walletAddress>` (read)
-
-List all SunPump tokens held by a wallet, with TRX-denominated value and portfolio weight.
-
-```bash
-sun sunpump portfolio <walletAddress> [options]
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--include-zero` | Include zero-balance tokens | — |
-| `--min-trx <amount>` | Minimum TRX-equivalent value | — |
-| `--page <n>` | Page number | — |
-| `--size <n>` | Page size | — |
-| `--sort <field>` | Sort field (e.g. `valueInTrx,desc`) | — |
-
-### `sunpump launch` (write, no wallet required)
-
-Create a new meme token through the SunPump agent endpoint (`POST /ai/agentTokenLaunch`). Creation is **server-side**: the platform signs and broadcasts the creation transaction, so no local wallet is needed. The CLI prints a summary and asks for confirmation (`--yes` skips); `--dry-run` previews the request without sending. On success it prints the new token's contract address, creation tx hash, and logo URL.
-
-```bash
-sun sunpump launch --name "<token name>" --symbol "<SYMBOL>" \
-  --description "<one-line description>" --image ./logo.png \
-  --twitter-url "https://x.com/<your-handle>" --website-url "https://<your-site>"
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--name <name>` | **(required)** Token name | — |
-| `--symbol <symbol>` | **(required)** Token symbol | — |
-| `--description <text>` | **(required)** Token description | — |
-| `--image <path>` | Logo image file, read and sent as base64 | — |
-| `--image-base64 <data>` | Logo as a raw base64 string (overrides `--image`) | — |
-| `--twitter-url <url>` | Twitter URL | — |
-| `--telegram-url <url>` | Telegram URL | — |
-| `--website-url <url>` | Website URL | — |
-| `--tweet-username <name>` | Tweet username to associate with the launch | — |
-
-> Providing a logo via `--image` / `--image-base64` is strongly recommended — launches without a logo may be rejected by the API with an opaque `500` (the CLI hints at this when it happens).
-
-### `sunpump state <tokenAddress>` (read)
-
-Show a SunPump token's on-chain state, to decide whether to use the SunPump bonding-curve path or SunSwap.
-
-```bash
-sun sunpump state <tokenAddress>
-```
-
-| State | Label | Tradeable via `sunpump buy/sell`? |
-| :--- | :--- | :--- |
-| `0` | `NOT_EXIST` | No (unknown to SunPump) |
-| `1` | `TRADING` | Yes |
-| `2` | `READY_TO_LAUNCH` | Yes (Bonding Curve at 100%, about to create a SunSwap V2 pair) |
-| `3` | `LAUNCHED` | No — use `sun swap` |
-
-> `sun-kit`'s TypeScript enum only lists 0–2, but the on-chain contract returns 3 for launched tokens. The CLI maps 3 to `LAUNCHED` — trust the printed label, not the raw number.
-
-### `sunpump quote-buy <tokenAddress>` (read)
-
-Preview a SunPump buy without sending a transaction.
-
-```bash
-sun sunpump quote-buy <tokenAddress> --trx 10
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--trx <amount>` | **(required)** TRX to spend, **decimal** (e.g. `10` or `1.5`) | — |
-
-### `sunpump quote-sell <tokenAddress>` (read)
-
-Preview a SunPump sell without sending a transaction.
-
-```bash
-sun sunpump quote-sell <tokenAddress> --amount 1000
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--amount <amount>` | **(required)** Token amount to sell, **decimal** | — |
-| `--decimals <n>` | Token decimals | `18` |
-
-### `sunpump buy <tokenAddress>` (write)
-
-Buy a meme token with TRX on SunPump (only for tokens that have not yet created a SunSwap V2 pair). `--trx` accepts decimals; the CLI scales by TRX-Sun (1e6) internally.
-
-```bash
-sun sunpump buy <tokenAddress> --trx 10
-sun sunpump buy <tokenAddress> --trx 10 --slippage 0.1
-sun sunpump buy <tokenAddress> --trx 10 --min-out 27955000000000000000000
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--trx <amount>` | **(required)** TRX to spend, **decimal** | — |
-| `--slippage <n>` | Slippage tolerance as a decimal (meme tokens are volatile) | `0.05` |
-| `--min-out <raw>` | Minimum tokens out in raw base units (overrides slippage) | — |
-
-### `sunpump sell <tokenAddress>` (write)
-
-Sell a meme token for TRX on SunPump (only for tokens that have not yet created a SunSwap V2 pair). On the first sell of a token, the SDK auto-sends a TRC20 `approve` transaction first.
-
-```bash
-sun sunpump sell <tokenAddress> --amount 1000
-sun sunpump sell <tokenAddress> --amount 1000 --decimals 6
-sun sunpump sell <tokenAddress> --amount 1000 --slippage 0.1
-```
-
-| Option | Description | Default |
-| :--- | :--- | :--- |
-| `--amount <amount>` | **(required)** Token amount to sell, **decimal** | — |
-| `--decimals <n>` | Token decimals (resolve via `sunpump token get` if unsure) | `18` |
-| `--slippage <n>` | Slippage tolerance as a decimal | `0.05` |
-| `--min-out <raw>` | Minimum TRX out in Sun (overrides slippage) | — |
-
-> Use `--dry-run` to print the resolved parameters (TRX/Sun scaling, computed `minOut`, slippage, network) without broadcasting — handy for showing the user exactly what will be sent.
-
----
-
-## Built-In Token Symbols
-
-Many commands accept token symbols in addition to full TRON addresses:
-
-| Symbol | Address | Decimals |
-| :--- | :--- | :--- |
-| `TRX` | `T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb` | 6 |
-| `WTRX` | `TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR` | 6 |
-| `USDT` | `TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t` | 6 |
-| `USDCOLD` | `TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8` | 6 |
-| `USDDOLD` | `TPYmHEhy5n8TCEfYGqW2rPxsghSfzghPDn` | 18 |
-| `USDD` | `TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz` | 18 |
-| `SUN` | `TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S` | 18 |
-| `JST` | `TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9` | 18 |
-| `BTT` | `TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4` | 18 |
-| `WIN` | `TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7` | 6 |
-| `NFT` | `TFczxzPhnThNSqr5by8tvxsdCFRRz6cPNq` | 6 |
-| `TUSD` | `TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4` | 18 |
-
-You can use either the symbol or the full address:
-
-```bash
-sun swap TRX USDT 1000000
-```
-
-```bash
-sun swap T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t 1000000
-```
-
-You can find other tokens in [tokenlist](https://sunlists.justnetwork.io/#/detail?uri=https://list.justswap.io/justswap.json).
diff --git a/docs/McpServer-Skills/Tools/SUNCli/FAQ.md b/docs/McpServer-Skills/Tools/SUNCli/FAQ.md
deleted file mode 100644
index c79f7d38..00000000
--- a/docs/McpServer-Skills/Tools/SUNCli/FAQ.md
+++ /dev/null
@@ -1,133 +0,0 @@
-# FAQ & Troubleshooting
-
-Common questions and troubleshooting tips for SUN CLI.
-
----
-
-## Installation & Setup
-
-### What are the system requirements?
-
-- **Node.js** 20.0.0 or later
-- **npm** (comes with Node.js)
-- A terminal or shell environment (macOS, Linux, or Windows with WSL)
-
-### How do I update SUN CLI?
-
-```bash
-npm update -g @bankofai/sun-cli
-```
-
----
-
-## Wallet & Configuration
-
-### I get "No wallet configured" — what should I do?
-
-Write operations (swap, liquidity, contract send) require a wallet. Set exactly one wallet source:
-
-- `AGENT_WALLET_PRIVATE_KEY` — direct private key
-- `AGENT_WALLET_MNEMONIC` — mnemonic phrase
-- `AGENT_WALLET_PASSWORD` — encrypted wallet via agent-wallet
-
-Or provide the equivalent root-level flag (`-k`, `-m`, `-p`) for a single invocation. See the [agent-wallet Quick Start](../../../Agent-Wallet/QuickStart.md).
-
-### Can I use SUN CLI without a wallet?
-
-Yes. All read-only commands work without any wallet configuration: price queries, swap quotes, pool data, protocol stats, token search, and more.
-
-### Is my private key safe?
-
-SUN CLI never uploads your private key to any remote service. All signing happens locally. However, be cautious with command-line flags (`-k`, `-m`) as they may appear in your shell history. Prefer environment variables or agent-wallet's encrypted storage.
-
----
-
-## Common Errors
-
-### `unknown command 'nile'`
-
-Root flags like `--network` must be placed **before** the subcommand:
-
-```bash
-# Correct
-sun --network nile swap TRX USDT 1000000
-
-# Wrong — 'nile' is parsed as a command
-sun swap TRX USDT 1000000 --network nile
-```
-
-When using npm scripts, pass arguments after `--`:
-
-```bash
-npm run start -- --network nile swap TRX USDT 1000000
-```
-
-### `Swap failed`
-
-Common causes:
-
-- Wallet not configured
-- Unsupported token symbol or invalid address
-- Insufficient balance
-- RPC or router API failure
-- Stale or invalid route parameters
-
-**Recommendation:** Run `swap:quote` first to verify the route, then retry with `--yes` only after the quote looks correct.
-
-### Transactions succeed but I see unexpected results
-
-- **Slippage**: In volatile markets, the actual output may differ from the quoted amount. Adjust slippage tolerance with `--slippage`.
-- **Token decimals**: Amounts are specified in the token's smallest unit. For TRX (6 decimals), `1000000` = 1 TRX.
-- **Network mismatch**: Make sure you're on the intended network. Check with `sun wallet address`.
-
----
-
-## AI Agent Integration
-
-### Can AI agents use SUN CLI?
-
-Yes. SUN CLI is designed for both human and AI-driven workflows. Key features for automation:
-
-- `--json` output for machine-readable responses
-- `--yes` flag to skip confirmation prompts
-- `--dry-run` to preview actions without executing
-- `--fields` to filter output to specific fields
-- Exit codes for error handling in scripts
-
-### What's the difference between SUN CLI and SUN MCP Server?
-
-SUN CLI is a command-line tool invoked directly. SUN MCP Server is an MCP-compatible server that AI clients connect to for natural language DeFi interaction. Both access the same SunSwap ecosystem. Choose CLI for scripts and automation, MCP Server for AI-assisted workflows.
-
----
-
-## Networks & Tokens
-
-### Which networks are supported?
-
-Mainnet, Nile testnet, and Shasta testnet. Default is mainnet. Use `--network nile` or `--network shasta` for testing.
-
-### How do I use a custom token not in the built-in list?
-
-Use the token's full TRON contract address instead of a symbol:
-
-```bash
-sun price --address TYourTokenAddress
-```
-
-```bash
-sun swap TYourTokenAddress TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t 1000000
-```
-
-### Can I set a custom RPC endpoint?
-
-Yes. Set the `TRON_RPC_URL` environment variable:
-
-```bash
-export TRON_RPC_URL=https://your-tron-rpc.example
-```
-
----
-
-## Still Need Help?
-
-If your question isn't covered here, check the [Complete Capabilities](./CommandGuide.md) for detailed usage, or file an issue on the [GitHub repository](https://github.com/BofAI/sun-cli).
diff --git a/docs/McpServer-Skills/Tools/SUNCli/Intro.md b/docs/McpServer-Skills/Tools/SUNCli/Intro.md
deleted file mode 100644
index 6afe3b1c..00000000
--- a/docs/McpServer-Skills/Tools/SUNCli/Intro.md
+++ /dev/null
@@ -1,132 +0,0 @@
-# Introduction
-
-## What is SUN CLI?
-
-SUN CLI (`@bankofai/sun-cli`) is a command-line tool that brings the full power of [SUN.IO (SunSwap)](https://sun.io) to your terminal. Whether you're a human operator or an AI agent, SUN CLI lets you query DeFi data, execute token swaps, and manage liquidity positions on the TRON network through a single command-line interface.
-
-Think of it this way: SUN MCP Server exposes DeFi capabilities as standard tool interfaces via the MCP protocol—AI assistants call them directly without assembling commands or parsing text output. SUN CLI provides a structured command-line interface for manual operation and scripting, and can also be invoked by AI agents through the shell. Both share the same underlying DeFi capabilities; the difference is the integration method: MCP is native protocol integration, CLI is command-line invocation.
-
-For example, checking the price of TRX is as simple as:
-
-```bash
-sun price TRX
-```
-
-And executing a swap — for example, **swap 1 TRX for USDT**:
-
-```bash
-sun swap TRX USDT 1000000 --yes
-```
-
-> Amounts are passed as integers scaled by the token's `decimals`. TRX has 6 decimals, so `1000000` is exactly **1 TRX**.
-
-No frontend, no browser, no manual contract interaction.
-
----
-
-## What can it do?
-
-SUN CLI covers the full range of SunSwap DEX interactions, from real-time market data to on-chain transactions.
-
-**Data Queries (read-only, no wallet needed):**
-
-| Capability | Description | Example Command |
-| :--- | :--- | :--- |
-| **Token Prices** | Real-time prices for any token on SunSwap | `sun price TRX` |
-| **Swap Quotes** | Get optimal route and expected output before executing | `sun swap:quote TRX USDT 1000000` |
-| **Pool Data** | Pool lists, APY rankings, volume and liquidity history | `sun pool top-apy --page-size 5` |
-| **Position Query** | View liquidity positions for any address | `sun position list --owner TYourAddress` |
-| **Protocol Stats** | SunSwap-wide volume, users, pools, and liquidity history | `sun protocol info` |
-| **Farm Info** | Yield farm lists, mining positions, and farming transactions | `sun farm list` |
-| **Token Discovery** | Search tokens, list by protocol version | `sun token search USDT` |
-| **SunPump Market Data** | Meme-token discovery: rankings, detail, holders, wallet portfolios, trade history (TRON mainnet only) | `sun sunpump token ranking --type MARKET_CAP --size 10` |
-
-**DeFi Operations (write, requires wallet):**
-
-| Capability | Description | Example Command |
-| :--- | :--- | :--- |
-| **Token Swap** | Execute optimal-route swaps via the Universal Router | `sun swap TRX USDT 1000000` |
-| **V2 Liquidity** | Create pools or add/remove V2 pool liquidity | `sun liquidity v2:add --token-a TRX --token-b USDT --amount-a 1000000` |
-| **V3 Liquidity** | Mint, increase, decrease concentrated positions, collect fees | `sun liquidity v3:mint --token0 TRX --token1 USDT --amount0 1000000` |
-| **V4 Liquidity** | V4 concentrated liquidity with Permit2 authorization | `sun liquidity v4:mint --token0 TRX --token1 USDT --amount0 1000000` |
-| **Contract Interaction** | Read or write to any TRON smart contract | `sun contract read <address> balanceOf --args '[...]'` |
-| **SunPump Token Launch** | Create a meme token in one command via the SunPump agent endpoint — server-side creation, **no wallet needed** (TRON mainnet only) | `sun sunpump launch --name "<name>" --symbol "<SYMBOL>" --description "..."` |
-| **SunPump Pre-launch Trading** | Buy/sell meme tokens that have no SunSwap V2 pair yet (TRON mainnet only) | `sun sunpump buy <address> --trx 10` |
-
----
-
-## SUN CLI vs SUN MCP Server
-
-Both tools connect you to the same SunSwap ecosystem, but serve different use cases:
-
-| Comparison | SUN CLI | SUN MCP Server |
-| :--- | :--- | :--- |
-| **Integration** | Command line (shell invocation) | MCP protocol (native tool interface) |
-| **Best for** | Manual operation, scripts, CI/CD, AI agents via shell | AI assistants calling tools directly via MCP |
-| **Invocation** | Assemble command + flags, parse text/JSON output | AI client sends structured tool calls—no command assembly needed |
-| **Output formats** | Table, JSON, TSV | Structured MCP responses |
-| **Write operations** | Supported (with wallet) | Supported (local deployment) |
-| **No-prompt mode** | `--yes` flag for unattended execution | AI handles confirmation flow |
-
-:::tip When to choose which?
-If your AI assistant supports the MCP protocol, prefer SUN MCP Server—the integration is cleaner with no command assembly or output parsing. If you need shell scripts, cron jobs, CI/CD pipelines, or your AI agent doesn't support MCP, choose SUN CLI.
-:::
-
----
-
-## Output Modes
-
-SUN CLI supports three output formats, making it friendly for both humans and machines:
-
-- **table** — default, human-friendly terminal tables
-- **json** — compact, machine-readable JSON for scripts and AI agents
-- **tsv** — tab-separated values for shell pipelines
-
-```bash
-sun pool top-apy --page-size 5
-```
-
-```bash
-sun --json wallet address
-```
-
-```bash
-sun --output tsv token list --protocol V3
-```
-
----
-
-## Supported Networks
-
-SUN CLI supports the same three TRON networks (mainnet by default):
-
-| Network | Identifier | Purpose | Block Explorer |
-| :--- | :--- | :--- | :--- |
-| **Mainnet** | `mainnet` | Production, real assets | [tronscan.org](https://tronscan.org) |
-| **Nile Testnet** | `nile` | Development and testing (recommended) | [nile.tronscan.org](https://nile.tronscan.org) |
-| **Shasta Testnet** | `shasta` | Development and testing | [shasta.tronscan.org](https://shasta.tronscan.org) |
-
-Specify the network with the `--network` flag. **We strongly recommend validating operations on the Nile testnet first**—mainnet operations involve real assets and cannot be undone.
-
----
-
-## Security Notes
-
-:::warning
-DeFi operations involve on-chain assets and mistakes cannot be reversed. Keep these principles in mind:
-
-- **Never hardcode private keys**: Use environment variables or encrypted wallet management via [agent-wallet](https://github.com/BofAI/agent-wallet), not command-line flags in shared environments.
-- **Test on testnet first**: Use `--network nile` before running any write operation on mainnet.
-- **Minimum funds principle**: Only keep the funds needed for the current task in the CLI's configured wallet.
-- **Use dry-run mode**: Run `--dry-run` before high-value writes to preview intent without broadcasting.
-- **Verify token addresses**: When not using built-in symbols, double-check contract addresses.
-- **Quotes are not guarantees**: In volatile markets, actual execution results may differ from quotes.
-:::
-
----
-
-## Next Steps
-
-- Want to get up and running fast? &rarr; [Quick Start](./QuickStart.md)
-- Need the full command reference? &rarr; [Complete Capabilities](./CommandGuide.md)
-- Have questions or running into issues? &rarr; [FAQ & Troubleshooting](./FAQ.md)
diff --git a/docs/McpServer-Skills/Tools/SUNCli/QuickStart.md b/docs/McpServer-Skills/Tools/SUNCli/QuickStart.md
deleted file mode 100644
index 9e4b3044..00000000
--- a/docs/McpServer-Skills/Tools/SUNCli/QuickStart.md
+++ /dev/null
@@ -1,147 +0,0 @@
-# Quick Start
-
-The goal of this page is simple: **install SUN CLI and make your first DeFi query in under 1 minute.**
-
-No wallet needed for read-only commands—install and start querying immediately.
-
----
-
-## Preparation
-
-Before you get started, make sure you have:
-
-1. **Node.js** >= 20.0.0 ([download link](https://nodejs.org/))
-2. **npm** (comes with Node.js)
-
----
-
-## Step 1: Install
-
-Run one command to install SUN CLI globally:
-
-```bash
-npm install -g @bankofai/sun-cli
-```
-
-After installation, the `sun` command is available in your terminal.
-
----
-
-## Step 2: Your First Query
-
-Let's check the current price of TRX. Run:
-
-```bash
-sun price TRX
-```
-
-You should see output like this:
-
-```text
-✔ Fetching prices...
-┌───────┬────────────────┐
-│ Token │ Price (USD)    │
-├───────┼────────────────┤
-│ TRX   │ 0.301739439813 │
-└───────┴────────────────┘
-```
-
-That's it—you're connected to SunSwap.
-
----
-
-## Step 3: Explore More Data
-
-Try a few more read-only commands to see what's available:
-
-**Check top APY pools:**
-
-```bash
-sun pool top-apy --page-size 5
-```
-
-**Quote a swap of 1 TRX for USDT** (no wallet required):
-
-```bash
-sun swap:quote TRX USDT 1000000
-```
-
-This shows the best route and expected output—without executing anything. (TRX has 6 decimals, so `1000000` = 1 TRX.)
-
-**Get JSON output for scripting:**
-
-```bash
-sun --json price USDT
-```
-
----
-
-## Configure a Wallet (For Write Operations)
-
-Read-only commands work out of the box. To execute swaps, manage liquidity, or send contract transactions, you need to configure a wallet.
-
-SUN CLI uses [`agent-wallet`](../../../Agent-Wallet/Intro.md) for wallet management. Install and configure it:
-
-```bash
-npm install -g @bankofai/agent-wallet
-```
-
-Then set up your wallet following the [agent-wallet Quick Start guide](../../../Agent-Wallet/QuickStart.md).
-
-:::caution Keep your keys safe
-Never hardcode private keys or mnemonics in config files or shell history. Use environment variables or agent-wallet's encrypted storage. For testing, always start with the Nile testnet.
-:::
-
-Once your wallet is configured, verify it:
-
-```bash
-sun wallet address
-```
-
-You should see your wallet address and network:
-
-```json
-{ "address": "TNmoJ...xxxxx", "network": "mainnet" }
-```
-
----
-
-## Execute Your First Swap (On Testnet)
-
-With a wallet configured, try **swapping 1 TRX for USDT** on the Nile testnet:
-
-```bash
-sun swap TRX USDT 1000000 --network nile --yes
-```
-
-The `--yes` flag skips the confirmation prompt. The output includes the transaction ID and a Tronscan link to verify on-chain.
-
-:::tip Always test on Nile first
-Before running any write operation on mainnet, verify it on the Nile testnet. Mainnet operations involve real assets and cannot be undone.
-:::
-
----
-
-## Network & API Configuration
-
-Optionally, set these environment variables for customization:
-
-```bash
-export TRON_NETWORK=mainnet
-```
-
-```bash
-export TRON_GRID_API_KEY="<YOUR_KEY>"
-```
-
-```bash
-export TRON_RPC_URL=https://your-rpc
-```
-
----
-
-## Next Steps
-
-- **[Complete Capabilities](./CommandGuide.md)** — Full reference for all commands: wallet, price, swap, liquidity, protocol, and contract operations
-- **[FAQ & Troubleshooting](./FAQ.md)** — Troubleshooting common issues
-- **[SUN MCP Server](../SUNMCPServer/Intro.md)** — Prefer AI-driven DeFi? Use SUN MCP Server for natural language interaction
diff --git a/docs/x402/cli/command-reference.md b/docs/x402/cli/command-reference.md
new file mode 100644
index 00000000..81b9fd0c
--- /dev/null
+++ b/docs/x402/cli/command-reference.md
@@ -0,0 +1,278 @@
+---
+title: 'Command Reference'
+description: >-
+  Complete reference for every x402 CLI command and flag — pay, serve, roundtrip, gateway, and catalog.
+---
+
+# Command Reference
+
+This page is the complete reference for all x402 CLI commands.
+
+> Legend: `<arg>` = required argument, `[arg]` = optional argument. Options are optional unless marked **(required)**.
+
+---
+
+## Global options
+
+These flags work on every command.
+
+| Flag | Description |
+| :--- | :--- |
+| `-h, --help` | Show help for the command |
+| `-V, --version` | Print the CLI version |
+| `--json` | Print a machine-readable JSON envelope |
+| `--human` | Print human-readable output (default) |
+
+`--json` and `--human` are mutually exclusive. The JSON envelope always contains `ok` and `command`, plus either a `result` object or a structured `error` (`code`, `message`, `hint`).
+
+```bash
+x402-cli --help
+x402-cli --version
+x402-cli pay --help
+```
+
+---
+
+## `pay`
+
+Pay an x402-protected URL. The CLI sends the request, and if the server answers `402 Payment Required`, it reads the `PAYMENT-REQUIRED` challenge, selects a matching requirement, signs a payment, and retries the request with the signed payload.
+
+```bash
+x402-cli pay <url> [options]
+```
+
+| Option | Description |
+| :--- | :--- |
+| `--method <method>` | HTTP method (default: `GET`) |
+| `--header "Name: Value"` | Request header; repeatable |
+| `--body <body>` | Request body for non-`GET`/`HEAD` methods |
+| `--network <caip2>` | Require a specific network (e.g. `tron:nile`) |
+| `--token <symbol>` | Require a specific token (e.g. `USDT`) |
+| `--scheme <scheme>` | Require a specific x402 scheme (e.g. `exact`) |
+| `--max-amount <amount>` | Maximum human-readable amount you'll pay |
+| `--max-raw-amount <amount>` | Maximum amount in smallest units |
+| `--dry-run` | Read the requirement but do not sign or pay |
+| `--private-key <hex>` | Explicit payer key (or use the env vars below) |
+| `--rpc-url <url>` | Explicit network RPC URL |
+| `--timeout-ms <ms>` | Network timeout in ms (default: `30000`) |
+| `--json` | Print the JSON envelope |
+
+The payer key is read from `--private-key`, or from an environment variable: `TRON_PRIVATE_KEY` for TRON networks and `EVM_PRIVATE_KEY` for EVM networks, with `PRIVATE_KEY` accepted as a fallback for either network.
+
+**Examples:**
+
+```bash
+# Preview the requirement without paying
+x402-cli pay https://api.example.com/paid --dry-run --json
+```
+
+```bash
+# Pay, but never spend more than 0.01 USDT
+TRON_PRIVATE_KEY=<hex> x402-cli pay https://api.example.com/paid \
+  --network tron:nile --token USDT --max-amount 0.01
+```
+
+```bash
+# POST with a body and a custom header
+x402-cli pay https://api.example.com/paid \
+  --method POST --header "X-Client: demo" --body '{"q":"hello"}'
+```
+
+If the endpoint does not return `402`, the CLI reports the actual status and response instead of paying.
+
+---
+
+## `serve`
+
+Run a local x402 paywall endpoint. It advertises a payment requirement, then verifies and settles submitted payments through a facilitator.
+
+```bash
+x402-cli serve --pay-to <address> [options]
+```
+
+| Option | Description |
+| :--- | :--- |
+| `--pay-to <address>` | **(required)** Recipient wallet address |
+| `--amount <amount>` | Human-readable token amount (default: `0.0001`) |
+| `--raw-amount <amount>` | Amount in smallest units (mutually exclusive with `--amount`) |
+| `--network <caip2>` | Payment network (default: `tron:nile`) |
+| `--token <symbol>` | Token symbol (default: `USDT`) |
+| `--asset <address>` | Explicit token address for an unregistered token |
+| `--decimals <count>` | Token decimals, required with an unregistered `--asset` |
+| `--host <host>` | Bind host (default: `127.0.0.1`) |
+| `--port <port>` | Bind port (default: `4020`) |
+| `--resource-url <url>` | URL advertised in the payment requirement |
+| `--facilitator-url <url>` | Facilitator base URL (default: `https://facilitator.bankofai.io`) |
+| `--timeout-ms <ms>` | Facilitator timeout in ms (default: `30000`) |
+| `-d, --daemon` | Run in the background and print the child pid |
+| `--json` | Print the JSON envelope |
+
+The server exposes four routes:
+
+| Route | Purpose |
+| :--- | :--- |
+| `GET /health` | Returns `{ "ok": true }` |
+| `GET /.well-known/x402` | Machine-readable payment metadata (network, scheme, asset, amount, `payTo`) |
+| `GET /pay` | Returns `402 Payment Required` with the challenge header |
+| `POST /pay` | Verifies the payment, settles it, and returns the transaction |
+
+**Examples:**
+
+```bash
+x402-cli serve --pay-to T... --network tron:nile --token USDT
+```
+
+```bash
+x402-cli serve --pay-to 0x... --network eip155:97 --token USDT --amount 0.0001 --daemon
+```
+
+---
+
+## `roundtrip`
+
+Start a temporary local server, immediately pay it, then exit. This is the quickest full end-to-end test. It accepts the same options as `serve` and `pay` combined.
+
+```bash
+x402-cli roundtrip --pay-to <address> [serve/pay options]
+```
+
+**Example:**
+
+```bash
+TRON_PRIVATE_KEY=<hex> x402-cli roundtrip \
+  --pay-to T... --amount 0.0001 --network tron:nile --token USDT
+```
+
+---
+
+## `gateway`
+
+Manage local gateway provider files — validate, scaffold, start a gateway process, and build catalog assets from `provider.yml` files.
+
+```bash
+x402-cli gateway <search|start|check|scaffold|catalog> [options]
+```
+
+| Subcommand | Description |
+| :--- | :--- |
+| `search <query>` | Search a catalog artifact (see [`catalog search`](#catalog)) |
+| `start` | Start a local x402 gateway process |
+| `check <providers>` | Validate one or more `provider.yml` files |
+| `scaffold <name>` | Write a starter `provider.yml` |
+| `catalog <command>` | Build/check/search gateway catalog assets |
+
+`start` and `gateway catalog` require the `@bankofai/x402-gateway` runtime. Install it (`npm install -g @bankofai/x402-gateway`), run from a checkout that has `../x402-gateway/dist/cli.js`, or pass `--gateway-bin <path>`.
+
+**Validate provider files:**
+
+```bash
+x402-cli gateway check ./providers
+```
+
+**Scaffold a new provider:**
+
+```bash
+x402-cli gateway scaffold my-service --forward-url https://api.myservice.com
+```
+
+This writes `providers/my-service/provider.yml` with a ready-to-edit template (network, recipient, currencies, and a sample metered endpoint).
+
+**Start a gateway:**
+
+```bash
+x402-cli gateway start --providers ./providers --host 127.0.0.1 --port 4020
+```
+
+### `gateway catalog`
+
+```bash
+x402-cli gateway catalog <build|check|pay-assets|search> [options]
+```
+
+| Subcommand | Description |
+| :--- | :--- |
+| `build <providers>` | Build a local catalog from `provider.yml` files |
+| `check <providers>` | Validate local `provider.yml` files |
+| `pay-assets <providers>` | List payable endpoint assets (method, path, network, price) |
+| `search <query>` | Search a catalog artifact |
+
+```bash
+x402-cli gateway catalog pay-assets ./providers --json
+```
+
+---
+
+## `catalog`
+
+Search, cache, inspect, and export the hosted provider catalog.
+
+```bash
+x402-cli catalog <update|search|show|endpoints|pay-json|export-gateway|build> [options]
+```
+
+| Subcommand | Description |
+| :--- | :--- |
+| `update` | Cache hosted/local catalog assets under `~/.cache/x402-cli/catalog` |
+| `search <query>` | Search providers by name, tags, chains, category, and endpoints |
+| `show <provider>` | Show provider detail JSON |
+| `endpoints <provider>` | List a provider's endpoints |
+| `pay-json <provider>` | Print a provider's pay JSON (payable route details) |
+| `export-gateway <url>` | Export `catalog.json` and `pay.md` from a live gateway |
+| `build <providers>` | Build a catalog from local `provider.yml` files |
+
+**Common options:**
+
+| Option | Description |
+| :--- | :--- |
+| `--catalog <source>` | `catalog.json` path or URL |
+| `--provider <fqn>` | Provider FQN (for `export-gateway`) |
+| `--output-dir <dir>` | Output directory for generated files |
+| `-n, --limit <count>` | Search result limit (default: `10`) |
+| `--include-blocked` | Include blocked providers in search results |
+| `--timeout-ms <ms>` | Network timeout in ms (default: `30000`) |
+| `--force` | Overwrite existing files (for `export-gateway`) |
+| `--raw` | Print the raw pay payload (for `pay-json`) |
+| `--json` | Print the JSON envelope |
+
+**Catalog source resolution.** When `--catalog` is omitted, the CLI resolves the source in this order: the `X402_CATALOG` or `X402_GATEWAY_CATALOG` environment variable, then the local cache at `~/.cache/x402-cli/catalog/catalog.json`, then the hosted default `https://x402-catalog.bankofai.io/api/catalog.json`.
+
+**Examples:**
+
+```bash
+# Cache the hosted catalog locally for fast, offline search
+x402-cli catalog update
+```
+
+```bash
+# Find providers, limited to 5 results
+x402-cli catalog search "weather forecast" -n 5
+```
+
+```bash
+# Inspect one provider
+x402-cli catalog show acme.weather
+x402-cli catalog endpoints acme.weather --json
+```
+
+```bash
+# Get the payable route JSON for a provider
+x402-cli catalog pay-json acme.weather --raw
+```
+
+```bash
+# Export catalog.json + pay.md from a running gateway
+x402-cli catalog export-gateway https://gateway.example.com \
+  --provider acme.weather --output-dir ./out --force
+```
+
+---
+
+## Exit codes
+
+| Exit code | Meaning |
+| :--- | :--- |
+| `0` | Success |
+| `1` | Runtime error (network, wallet, settlement, etc.) |
+| `2` | Invalid usage (missing/invalid argument, unknown command) |
+
+For the full list of error codes and their fixes, see [FAQ & Troubleshooting](./faq.md).
diff --git a/docs/x402/cli/faq.md b/docs/x402/cli/faq.md
new file mode 100644
index 00000000..e07ebc4c
--- /dev/null
+++ b/docs/x402/cli/faq.md
@@ -0,0 +1,136 @@
+---
+title: 'FAQ & Troubleshooting'
+description: >-
+  Common questions, error codes, and fixes for the x402 CLI.
+---
+
+# FAQ & Troubleshooting
+
+Common questions and troubleshooting tips for the x402 CLI.
+
+---
+
+## Installation & setup
+
+### What are the system requirements?
+
+- **Node.js** 20 or later
+- **npm** (comes with Node.js)
+- A terminal on macOS, Linux, or Windows (WSL recommended)
+
+### How do I update the CLI?
+
+```bash
+npm update -g @bankofai/x402-cli
+```
+
+### Can I run it without installing globally?
+
+Yes. From a project that has it installed, run `node dist/cli.js <command>`, or use `npx @bankofai/x402-cli <command>`.
+
+---
+
+## Wallets & payments
+
+### Do I need a wallet to use the CLI?
+
+Only for actual payments. Read-only commands — `pay --dry-run`, `catalog search`, `catalog show`, `gateway check` — need no wallet. A real `pay` or `roundtrip` requires a payer private key.
+
+### How do I provide my private key?
+
+Set one of these environment variables:
+
+- **TRON networks** → `TRON_PRIVATE_KEY`
+- **EVM networks** (BSC) → `EVM_PRIVATE_KEY`
+- **Either network** → `PRIVATE_KEY`, used as a fallback when the network-specific variable isn't set
+
+You can also pass `--private-key <hex>` for a single command, but avoid this in shared shells or committed scripts — command-line arguments are recorded in shell history and process listings.
+
+:::caution
+For anything beyond throwaway testing, use an [agent-wallet](../../Agent-Wallet/Intro.md) payer wallet rather than raw environment keys, and keep only the minimum funds the current task needs in the payer address.
+:::
+
+### Will a payment ever spend more than I expect?
+
+Not if you cap it. Use `--max-amount <human>` or `--max-raw-amount <smallest-units>`; if the endpoint's price exceeds your cap, the CLI aborts **before** signing. When in doubt, run `pay --dry-run` first to see the exact requirement.
+
+### Which networks and tokens are supported?
+
+TRON (`tron:mainnet`, `tron:nile`, `tron:shasta`) and BSC (`eip155:56`, `eip155:97`), with a built-in registry for USDT, USDD, and USDC depending on the network. See [x402 CLI overview](./index.md#supported-networks--tokens) for the full table. For a token that isn't registered, pass `--asset <address>` with `--decimals <count>`.
+
+---
+
+## Understanding errors
+
+Every failure prints a stable error `code`, a message, and a `hint`. Add `--json` to get the same information as a structured envelope. The most common codes:
+
+| Code | What happened | How to fix it |
+| :--- | :--- | :--- |
+| `WALLET_NOT_CONFIGURED` | No payer key found | Set `TRON_PRIVATE_KEY` / `EVM_PRIVATE_KEY` / `PRIVATE_KEY`, or configure an agent-wallet payer |
+| `TRON_ACCOUNT_NOT_ACTIVATED` | The TRON address has never been used on-chain | Send it a small amount of TRX to activate it before signing |
+| `INSUFFICIENT_TOKEN_BALANCE` | Payer lacks the token being charged | Fund the payer with the exact token and network the provider advertises |
+| `INSUFFICIENT_GAS` | Not enough native gas / energy | Fund the payer with the network's native gas token (TRX / BNB) |
+| `NO_MATCHING_PAYMENT_REQUIREMENT` | No offered requirement matched your filters | Relax `--network`, `--token`, or `--scheme`, or use values the provider offers |
+| `PAYMENT_AMOUNT_TOO_HIGH` | Price exceeded your `--max-amount` | Raise the cap only if the price is expected |
+| `INVALID_X402_RESPONSE` | Endpoint returned `402` without a `PAYMENT-REQUIRED` header | The endpoint is misconfigured; contact the provider |
+| `PERMIT_REVERTED` | Token/Permit2 rejected the signature | Retry with a fresh requirement; verify token/network support |
+| `DEADLINE_OR_CLOCK_SKEW` | Requirement expired or clock is off | Sync your local clock and retry with a fresh requirement |
+| `RATE_LIMITED` | Upstream service or RPC is rate limiting | Wait briefly and retry |
+| `NETWORK_ERROR` | Could not reach the URL/RPC | Check the URL, local server, proxy, and connectivity |
+| `SDK_API_DRIFT` | Installed SDK packages don't match the CLI | Reinstall `@bankofai/x402-cli` and its SDK dependencies |
+
+### "402 response missing PAYMENT-REQUIRED header"
+
+The endpoint returned `402` but didn't include the machine-readable challenge header. This is a server-side misconfiguration — the CLI can't derive a payment requirement from it.
+
+### "no matching payment requirement"
+
+The endpoint offered payment options, but none matched your `--network`, `--token`, or `--scheme` filters. Run `pay --dry-run --json` without those filters to see what the provider actually accepts, then narrow accordingly.
+
+---
+
+## The gateway
+
+### `gateway start` says the runtime isn't found
+
+`gateway start` and `gateway catalog` need the separate `@bankofai/x402-gateway` package. Install it (`npm install -g @bankofai/x402-gateway`), run from a checkout that has `../x402-gateway/dist/cli.js`, or point at a binary with `--gateway-bin <path>`.
+
+### How do I validate my provider files before deploying?
+
+```bash
+x402-cli gateway check ./providers
+```
+
+This parses every `provider.yml`, checks required fields (`name`, `forward_url`, `operator.network`, `operator.recipient`), validates each endpoint, and reports duplicates.
+
+---
+
+## The catalog
+
+### Where does `catalog` read from by default?
+
+When you omit `--catalog`, the source is resolved in this order: the `X402_CATALOG` / `X402_GATEWAY_CATALOG` environment variable, then the local cache (`~/.cache/x402-cli/catalog/catalog.json`), then the hosted default `https://x402-catalog.bankofai.io/api/catalog.json`.
+
+### How do I make search faster or work offline?
+
+Run `x402-cli catalog update` once to cache the hosted catalog and provider details locally. Subsequent searches read from the cache.
+
+---
+
+## Output & scripting
+
+### How do I get machine-readable output?
+
+Add `--json` to any command for an envelope with `ok`, `command`, and either `result` or a structured `error`. This is the recommended mode for scripts and AI agents.
+
+### What do the exit codes mean?
+
+`0` success, `1` runtime error (network, wallet, settlement), `2` invalid usage (missing/invalid argument or unknown command).
+
+---
+
+## Still stuck?
+
+- Re-read the exact usage for a command with `x402-cli <command> --help`.
+- Review the [Command Reference](./command-reference.md) for every flag.
+- Learn how the underlying handshake works in [Core Concepts](../core-concepts/http-402.md).
diff --git a/docs/x402/cli/index.md b/docs/x402/cli/index.md
new file mode 100644
index 00000000..b27a2607
--- /dev/null
+++ b/docs/x402/cli/index.md
@@ -0,0 +1,126 @@
+---
+title: 'x402 CLI'
+description: >-
+  x402 CLI (@bankofai/x402-cli) is a TypeScript command-line client for x402 payments — pay protected URLs, run a local paywall, and manage the provider catalog from your terminal.
+---
+
+# x402 CLI
+
+## What is x402 CLI?
+
+x402 CLI (`@bankofai/x402-cli`) brings the [x402 payment protocol](../index.md) to your terminal. It is a single, dependency-light command that lets a human operator, a shell script, or an AI agent **pay an x402-protected URL, stand up a local paywall, and browse the provider catalog** — without writing any integration code.
+
+Think of it this way: the [x402 SDK](../sdk-features.md) is what you embed inside an application to charge for or pay for a resource. The CLI is the same capability wrapped as a command you can run right now:
+
+```bash
+# Pay any x402-protected endpoint
+x402-cli pay https://api.example.com/paid --network tron:nile --token USDT
+```
+
+It is built entirely on the published TypeScript SDK packages — `@bankofai/x402-core`, `@bankofai/x402-evm`, and `@bankofai/x402-tron` — and every stablecoin payment uses `scheme=exact` with Permit2 authorization (`extra.assetTransferMethod=permit2`).
+
+---
+
+## What can it do?
+
+The CLI groups its capabilities into five commands.
+
+| Command | What it does | Example |
+| :--- | :--- | :--- |
+| **`pay`** | Pay an x402-protected URL. Probes the endpoint, reads the `402` challenge, signs a payment, and retries. | `x402-cli pay <url> --network tron:nile --token USDT` |
+| **`serve`** | Run a local x402 paywall that returns `402 Payment Required` and settles through a facilitator. | `x402-cli serve --pay-to <address> --amount 0.0001` |
+| **`roundtrip`** | Start a temporary server, immediately pay it, then exit — the fastest way to smoke-test end to end. | `x402-cli roundtrip --pay-to <address>` |
+| **`gateway`** | Manage local gateway provider files: validate, scaffold, start, and build catalog assets. | `x402-cli gateway check ./providers` |
+| **`catalog`** | Search, cache, inspect, and export the hosted provider catalog. | `x402-cli catalog search "weather"` |
+
+Read-only commands (`pay --dry-run`, `catalog search`, `gateway check`) need no wallet. Only an actual payment requires a payer private key.
+
+---
+
+## Human-readable by default, JSON when you need it
+
+Output is human-friendly text by default. Add `--json` to any command for a stable, machine-readable envelope — ideal for scripts and AI agents:
+
+```bash
+x402-cli pay https://api.example.com/paid --dry-run --json
+```
+
+```json
+{
+  "ok": true,
+  "command": "client",
+  "network": "tron:nile",
+  "scheme": "exact",
+  "result": {
+    "url": "https://api.example.com/paid",
+    "message": "Dry run - no payment submitted"
+  }
+}
+```
+
+Every JSON envelope carries `ok`, `command`, and either a `result` object or a structured `error` with `code`, `message`, and `hint`. On success you also get `network` and `scheme` where relevant.
+
+---
+
+## Supported networks & tokens
+
+The CLI ships a built-in token registry. Pass a network with `--network` and a token with `--token`.
+
+| Network | Identifier | Built-in tokens |
+| :--- | :--- | :--- |
+| **TRON Mainnet** | `tron:mainnet` | USDT, USDD |
+| **TRON Nile Testnet** | `tron:nile` | USDT, USDD |
+| **TRON Shasta Testnet** | `tron:shasta` | USDT |
+| **BSC Mainnet** | `eip155:56` | USDT |
+| **BSC Testnet** | `eip155:97` | USDT, USDC |
+
+Convenience aliases are accepted and normalized automatically:
+
+| Alias | Canonical identifier |
+| :--- | :--- |
+| `tron-mainnet` | `tron:mainnet` |
+| `tron-nile` | `tron:nile` |
+| `tron-shasta` | `tron:shasta` |
+| `bsc-mainnet` | `eip155:56` |
+| `bsc-testnet` | `eip155:97` |
+
+For a token that isn't in the registry, pass `--asset <address>` together with `--decimals <count>`.
+
+---
+
+## CLI vs SDK
+
+Both paths speak the same protocol; they differ in how you integrate.
+
+| Comparison | x402 CLI | x402 SDK |
+| :--- | :--- | :--- |
+| **Integration** | Command line (shell invocation) | Imported into your TypeScript app |
+| **Best for** | Manual testing, scripts, CI/CD, AI agents via shell | Production services and clients |
+| **Setup** | `npm install -g @bankofai/x402-cli` | `npm install @bankofai/x402-*` |
+| **Output** | Human text or `--json` envelope | Native SDK objects |
+
+:::tip When to choose which?
+Use the CLI to explore, test, and script against x402 endpoints, or to give an AI agent a payment capability through the shell. When you're embedding payments into a real product, build directly on the [SDK](../sdk-features.md).
+:::
+
+---
+
+## Security notes
+
+:::warning
+Payments move real on-chain assets and cannot be reversed. Keep these principles in mind:
+
+- **Never hardcode private keys.** Prefer environment variables (`TRON_PRIVATE_KEY`, `EVM_PRIVATE_KEY`, `PRIVATE_KEY`) or an [agent-wallet](../../Agent-Wallet/Intro.md) payer wallet over the `--private-key` flag in shared environments.
+- **Test on testnet first.** Use `tron:nile` or `eip155:97` before running any payment on mainnet.
+- **Preview before you pay.** Run `pay --dry-run` to inspect the exact requirement before signing.
+- **Cap the amount.** Use `--max-amount` or `--max-raw-amount` so a mispriced endpoint can't overcharge you.
+- **Fund the minimum.** Only keep the funds the current task needs in the payer address.
+:::
+
+---
+
+## Next steps
+
+- Want to run your first payment fast? → [Quick Start](./quickstart.md)
+- Need every command and flag? → [Command Reference](./command-reference.md)
+- Hit a snag or have a question? → [FAQ & Troubleshooting](./faq.md)
diff --git a/docs/x402/cli/quickstart.md b/docs/x402/cli/quickstart.md
new file mode 100644
index 00000000..383ca04c
--- /dev/null
+++ b/docs/x402/cli/quickstart.md
@@ -0,0 +1,136 @@
+---
+title: 'Quick Start'
+description: >-
+  Install x402 CLI and complete a full pay-to-settle roundtrip on the TRON Nile testnet in a few minutes.
+---
+
+# Quick Start
+
+The goal of this page is simple: **install the CLI and complete a full payment roundtrip on a testnet in a few minutes.** All testnet operations use free test tokens — no real funds are involved.
+
+---
+
+## Prerequisites
+
+Before you start, make sure you have:
+
+1. **Node.js** >= 20 ([download](https://nodejs.org/))
+2. **npm** (comes with Node.js)
+3. A funded testnet address for the payment step — a TRON **Nile** address holding a small amount of test **USDT** and **TRX** (for energy). See [Wallet](../core-concepts/wallet.md).
+
+Verify your environment:
+
+```bash
+node --version   # v20.x or later
+npm --version
+```
+
+---
+
+## Step 1: Install
+
+Install the CLI globally so the `x402-cli` command is available everywhere:
+
+```bash
+npm install -g @bankofai/x402-cli
+```
+
+Confirm it's working:
+
+```bash
+x402-cli --version
+x402-cli --help
+```
+
+You should see the version number and the list of commands (`pay`, `serve`, `roundtrip`, `gateway`, `catalog`).
+
+---
+
+## Step 2: Try it without spending anything
+
+The fastest way to see a real `402` challenge is a **dry run**. This probes an endpoint, reads its payment requirement, and prints exactly what you'd be asked to pay — without signing or spending:
+
+```bash
+x402-cli pay https://api.example.com/paid \
+  --network tron:nile \
+  --token USDT \
+  --dry-run \
+  --json
+```
+
+The `--dry-run` output includes the selected requirement (network, asset, amount, recipient). This is your safety net: always dry-run an unfamiliar endpoint before paying it.
+
+---
+
+## Step 3: Run a full roundtrip on testnet
+
+`roundtrip` starts a temporary local paywall, pays it, and exits — a complete end-to-end test of your setup. You'll need a payer private key for the Nile testnet.
+
+```bash
+TRON_PRIVATE_KEY=<your-nile-hex-key> \
+x402-cli roundtrip \
+  --pay-to <your-nile-recipient-address> \
+  --amount 0.0001 \
+  --network tron:nile \
+  --token USDT
+```
+
+When it succeeds, the CLI prints the settled transaction. That transaction hash is your proof the payment cleared on-chain — congratulations, your setup works end to end.
+
+:::caution Keep your keys safe
+Pass private keys through environment variables (`TRON_PRIVATE_KEY` for TRON, `EVM_PRIVATE_KEY` for EVM, or `PRIVATE_KEY` as a fallback for either), never as plain command-line flags in shared shells or scripts committed to source control — command-line arguments may be visible to other local processes. For anything beyond throwaway testing, use an [agent-wallet](../../Agent-Wallet/QuickStart.md) payer wallet.
+:::
+
+---
+
+## Step 4: Pay a real x402 endpoint
+
+Once the roundtrip works, paying any x402-protected URL is the same `pay` command pointed at a real resource:
+
+```bash
+TRON_PRIVATE_KEY=<your-hex-key> \
+x402-cli pay https://api.example.com/paid \
+  --network tron:nile \
+  --token USDT \
+  --max-amount 0.01
+```
+
+`--max-amount` caps what you're willing to pay: if the endpoint's price exceeds it, the CLI aborts before signing. For EVM networks, use `EVM_PRIVATE_KEY` (or the `PRIVATE_KEY` fallback) and an EVM network such as `eip155:97`.
+
+---
+
+## Optional: Run your own paywall
+
+Want to charge for a resource instead of paying for one? Start a local x402 server:
+
+```bash
+x402-cli serve \
+  --pay-to <your-recipient-address> \
+  --amount 0.0001 \
+  --network tron:nile \
+  --token USDT \
+  --port 4020
+```
+
+It exposes:
+
+- `GET /health` — liveness check
+- `GET /.well-known/x402` — machine-readable payment metadata
+- `GET /pay` — returns `402 Payment Required`
+- `POST /pay` — verifies and settles a submitted payment through the facilitator
+
+In another terminal, pay it:
+
+```bash
+TRON_PRIVATE_KEY=<hex> x402-cli pay http://127.0.0.1:4020/pay --network tron:nile --token USDT
+```
+
+Point the server at a specific facilitator with `--facilitator-url` (defaults to `https://facilitator.bankofai.io`), and add `--daemon` to run it in the background and print the child process id.
+
+---
+
+## Next steps
+
+- **[Command Reference](./command-reference.md)** — Every command and flag: `pay`, `serve`, `roundtrip`, `gateway`, `catalog`.
+- **[FAQ & Troubleshooting](./faq.md)** — Fix common errors and understand the error codes.
+- **[Core Concepts](../core-concepts/http-402.md)** — How the `402` handshake and facilitator settlement actually work.
diff --git a/docusaurus.config.js b/docusaurus.config.js
index 5e8fd252..10f7be9a 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -27,6 +27,11 @@ module.exports = {
   projectName: 'x402-tron',
   scripts: [{ src: '/hideErrorBanner.js', async: false }],
   themeConfig: {
+    docs: {
+      sidebar: {
+        autoCollapseCategories: false,
+      },
+    },
     image: 'img/logo.png',
     prism: {
       theme: require('prism-react-renderer/themes/github'),
@@ -39,27 +44,36 @@ module.exports = {
         alt: 'BANK OF AI',
         src: 'img/logo.png', // 浅色模式
         srcDark: 'img/logo_dark.png', // 深色模式
-        href: '/',
+        href: '/BANK-OF-AI/Intro/',
         height: 36,
         width: 154,
       },
       items: [
-        // 多语言选项
+        // 顶部左侧页签：Docs / Changelogs
         {
-          type: 'localeDropdown',
-          position: 'right',
+          type: 'docSidebar',
+          sidebarId: 'docsSidebar',
+          position: 'left',
+          label: 'Docs',
         },
         {
-          label: 'GitHub',
-          href: 'https://github.com/BofAI',
-          position: 'right',
-          className: 'persistent',
+          type: 'docSidebar',
+          sidebarId: 'devnotesSidebar',
+          docsPluginId: 'devnotes',
+          position: 'left',
+          label: 'Best Practices',
         },
         {
-          label: 'TRON',
-          href: 'https://tron.network',
+          type: 'docSidebar',
+          sidebarId: 'changelogSidebar',
+          docsPluginId: 'changelog',
+          position: 'left',
+          label: 'Changelogs',
+        },
+        // 多语言选项
+        {
+          type: 'localeDropdown',
           position: 'right',
-          className: 'persistent',
         },
       ],
     },
@@ -83,6 +97,9 @@ module.exports = {
           rehypePlugins: [katex],
           includeCurrentVersion: true,
         },
+        theme: {
+          customCss: require.resolve('./src/css/sidebar.css'),
+        },
         blog: false,
       },
     ],
@@ -97,6 +114,52 @@ module.exports = {
   ],
   plugins: [
     require.resolve('./docusaurus-plugin-global-style'),
+    // 兼容旧链接：/McpServer-Skills/Intro/ 已并入 MCP 简介，重定向过去（自动覆盖各 locale）
+    [
+      '@docusaurus/plugin-client-redirects',
+      {
+        createRedirects(existingPath) {
+          if (existingPath.endsWith('/McpServer-Skills/MCP/Intro/') || existingPath.endsWith('/McpServer-Skills/MCP/Intro')) {
+            return [existingPath.replace('/McpServer-Skills/MCP/Intro', '/McpServer-Skills/Intro')]
+          }
+          return undefined
+        },
+      },
+    ],
+    // Changelog：独立 docs 实例，路径 /changelog，对应顶部 Changelogs 页签
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'changelog',
+        path: 'changelog',
+        routeBasePath: 'changelog',
+        sidebarPath: require.resolve('./sidebarsChangelog.js'),
+      },
+    ],
+    // Developer Notes：独立 docs 实例，路径 /devnotes，对应顶部 Developer Notes 页签
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'devnotes',
+        path: 'devnotes',
+        routeBasePath: 'devnotes',
+        sidebarPath: require.resolve('./sidebarsDevnotes.js'),
+      },
+    ],
+    // Offline full-text search (no Algolia account needed). Indexes both locales.
+    [
+      require.resolve('@easyops-cn/docusaurus-search-local'),
+      {
+        hashed: true,
+        language: ['en', 'zh'],
+        indexBlog: false,
+        docsRouteBasePath: '/',
+        highlightSearchTermsOnTargetPage: true,
+        searchResultLimits: 10,
+        searchResultContextMaxLength: 80,
+        explicitSearchResultPath: true,
+      },
+    ],
     function webpackFallbackPlugin() {
       return {
         name: 'custom-webpack-fallback-plugin',
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current.json b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current.json
new file mode 100644
index 00000000..25b8d0a2
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current.json
@@ -0,0 +1,22 @@
+{
+  "version.label": {
+    "message": "当前",
+    "description": "The label for version current"
+  },
+  "sidebar.changelogSidebar.doc.All Products": {
+    "message": "全部产品",
+    "description": "The label for the doc item All Products in sidebar changelogSidebar"
+  },
+  "sidebar.changelogSidebar.doc.x402 Payment Protocol": {
+    "message": "x402支付协议",
+    "description": "The label for the doc item x402 Payment Protocol in sidebar changelogSidebar"
+  },
+  "sidebar.changelogSidebar.doc.LLM Service": {
+    "message": "LLM 服务",
+    "description": "The label for the doc item LLM Service in sidebar changelogSidebar"
+  },
+  "sidebar.changelogSidebar.doc.8004 Protocol": {
+    "message": "8004协议",
+    "description": "The label for the doc item 8004 Protocol in sidebar changelogSidebar"
+  }
+}
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/8004.md b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/8004.md
new file mode 100644
index 00000000..c7380559
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/8004.md
@@ -0,0 +1,49 @@
+---
+title: '8004 协议'
+description: '8004 协议的版本发布记录。'
+---
+
+# 8004 协议
+
+8004 协议的版本发布记录。
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-02</div>
+<div className="changelog-body">
+
+### GitHub 组织迁移
+
+<div className="changelog-tags"><span className="changelog-tag">更新</span></div>
+
+- 仓库地址从 `bankofai` 迁移到 **`BofAI`**。旧链接会自动跳转，但如果你在脚本或依赖里写死了地址，需要更新。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-02-12</div>
+<div className="changelog-body">
+
+### v1.1.0
+
+<div className="changelog-tags"><span className="changelog-tag">新版本</span></div>
+
+- 新增**支持网络**与**合约地址**页——注册前先确认注册表部署在哪条链上。
+- 发布 Usage 三篇：**安装**、**配置 Agent**、**HTTP 注册**。
+- 重写**快速开始**，完整走通注册第一个 Agent 的流程。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-02-11</div>
+<div className="changelog-body">
+
+### 首批文档发布
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span></div>
+
+- 8004 协议初版文档上线——讲清链上 Agent 身份解决什么问题，以及怎么上手。
+
+</div>
+</div>
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/agent-wallet.md b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/agent-wallet.md
new file mode 100644
index 00000000..2945ea1f
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/agent-wallet.md
@@ -0,0 +1,35 @@
+---
+title: 'Agent Wallet'
+description: 'Agent Wallet 的版本发布记录。'
+---
+
+# Agent Wallet
+
+Agent Wallet 的版本发布记录。
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-04-15</div>
+<div className="changelog-body">
+
+### 新增简介与快速安装
+
+<div className="changelog-tags"><span className="changelog-tag">文档</span></div>
+
+- 新增**简介**，讲清私钥存在哪里、签名怎么完成；配套**快速开始**，带你创建第一个钱包。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-22</div>
+<div className="changelog-body">
+
+### 开发者文档上线，以及一处密码处理修复
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span><span className="changelog-tag">安全</span></div>
+
+- 发布开发者文档三件套：**CLI 参考**、**SDK 指南**、**SDK Cookbook**。
+- **安全修复**：早期配置文档里用了 `echo $AGENT_WALLET_PASSWORD`，这会把钱包密码直接打印到终端，并留在 shell 历史里。相关示例已全部删除。如果你照旧文档操作过，建议清理 shell 历史并更换密码。
+
+</div>
+</div>
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/index.md b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/index.md
new file mode 100644
index 00000000..b411ea7a
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/index.md
@@ -0,0 +1,255 @@
+---
+title: '更新日志'
+description: 'BANK OF AI 各产品的更新与公告——全部产品，按时间倒序。'
+---
+
+# 更新日志
+
+BANK OF AI 各产品的更新与公告。
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-07-21</div>
+<div className="changelog-body">
+
+### 文档
+
+<div className="changelog-tags"><span className="changelog-tag">产品更新</span><span className="changelog-tag">文档</span><span className="changelog-tag">x402</span></div>
+
+- **TRON 网络标识符全面改用 CAIP-2 格式**——`tron:0x2b6653dc`（主网）、`tron:0xcd8690dc`（Nile）、`tron:0x94a9059e`（Shasta）。应用代码中建议使用 SDK 常量 `TRON_MAINNET` / `TRON_NILE` / `TRON_SHASTA`，而不是硬编码十六进制字符串。[网络与代币支持](../x402/core-concepts/network-and-token-support/)
+- **移除 `auth-capture` 方案**——x402 现记录四种支付方案：`exact`、`upto`、`batch-settlement` 与 `exact_gasfree`（TRON）。[SDK 功能](../x402/sdk-features/)
+- **x402 快速开始精简**——买家与卖家两篇均已简化。
+- **新增模型**：LLM Service 增加 Kimi K3 定价文档。
+- **BANK OF AI 简介重写**——围绕"你的 AI 究竟多了什么"重新组织，配四项能力概览与端到端执行示例。
+- **新增板块——最佳实践**：产品文档之外的动手演练与操作习惯沉淀。[阅读第一篇](../devnotes/first-onchain-swap/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-07-17</div>
+<div className="changelog-body">
+
+### 文档
+
+<div className="changelog-tags"><span className="changelog-tag">产品更新</span><span className="changelog-tag">文档</span></div>
+
+- **新增 x402 CLI 文档集**：概览、快速开始、完整命令参考与 FAQ，中英双语。[查看文档](../x402/cli/)
+- **文档站升级**：离线全文搜索（⌘K）、更新日志页签、板块图标、更清爽的侧边栏布局。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-07-15</div>
+<div className="changelog-body">
+
+### x402 CLI
+
+<div className="changelog-tags"><span className="changelog-tag">新版本</span><span className="changelog-tag">x402</span><span className="changelog-tag">CLI</span></div>
+
+- **`v1.0.0` 首个正式版发布**——`@bankofai/x402-cli`，用于 x402 支付的 TypeScript 命令行客户端：`pay` 支付任意受保护 URL、`serve` 启动本地付费端点、`roundtrip` 端到端冒烟测试，以及管理 provider 文件与服务目录的 `gateway` / `catalog`。
+- 基于已发布的 `@bankofai/x402-core` / `x402-evm` / `x402-tron` SDK 1.0 包构建；`scheme=exact` 配合 Permit2。
+- 支持网络：TRON（`tron:mainnet` / `tron:nile` / `tron:shasta`）与 BSC（`eip155:56` / `eip155:97`）。[快速开始](../x402/cli/quickstart/)
+
+</div>
+</div>
+<div className="changelog-entry">
+<div className="changelog-date">2026-07-10</div>
+<div className="changelog-body">
+
+### SKILLS · LLM Service
+
+<div className="changelog-tags"><span className="changelog-tag">更新</span><span className="changelog-tag">新模型</span><span className="changelog-tag">x402</span></div>
+
+- **SKILLS**——新增 TRON 上 **`exact_gasfree` 方案**的说明，同时 API 目录更换为新地址。如果你锁定了旧版本，需要重新安装。[详情](./skills/)
+- **LLM Service**——新增 **GPT-5.6** 系列：`sol`、`terra`、`luna`。[详情](./llm-service/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-07-02</div>
+<div className="changelog-body">
+
+### LLM Service
+
+<div className="changelog-tags"><span className="changelog-tag">新模型</span></div>
+
+- 新增 **Claude Fable 5** 与 **Claude Sonnet 5**，定价完整。[详情](./llm-service/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-06-19</div>
+<div className="changelog-body">
+
+### LLM Service
+
+<div className="changelog-tags"><span className="changelog-tag">新模型</span><span className="changelog-tag">定价</span></div>
+
+- 新增 **GLM-5.2**。
+- 修正 **Qwen 缓存读取价格**——按旧数字估算过成本的话需要重新核对。[详情](./llm-service/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-06-13</div>
+<div className="changelog-body">
+
+### LLM Service
+
+<div className="changelog-tags"><span className="changelog-tag">移除</span></div>
+
+- 废弃模型已从模型列表和定价页移除，继续调用这些模型名会直接报错。[详情](./llm-service/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-06-01</div>
+<div className="changelog-body">
+
+### LLM Service
+
+<div className="changelog-tags"><span className="changelog-tag">新模型</span></div>
+
+- 新增 **MiniMax M3** 与 **Claude Opus 4.8**，模型侧边栏按系列重新归类。[详情](./llm-service/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-04-15</div>
+<div className="changelog-body">
+
+### SKILLS · Agent Wallet
+
+<div className="changelog-tags"><span className="changelog-tag">文档</span></div>
+
+- **SKILLS**——新增简介，配套快速开始，一条命令完成安装。[详情](./skills/)
+- **Agent Wallet**——新增简介，讲清私钥存在哪里、签名怎么完成；配套快速开始带你创建第一个钱包。[详情](./agent-wallet/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-04-01</div>
+<div className="changelog-body">
+
+### Openclaw 扩展
+
+<div className="changelog-tags"><span className="changelog-tag">隐私</span></div>
+
+- 扩展界面中的钱包地址改为**脱敏展示**——共享屏幕或录屏时更安全。[详情](./openclaw-extension/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-31</div>
+<div className="changelog-body">
+
+### Openclaw 扩展
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span></div>
+
+- 在 macOS 与 Linux 之外补充 **Windows 安装指引**。[详情](./openclaw-extension/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-22</div>
+<div className="changelog-body">
+
+### Agent Wallet
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span><span className="changelog-tag">安全</span></div>
+
+- 发布开发者文档三件套：**CLI 参考**、**SDK 指南**、**SDK Cookbook**。
+- **安全修复**——配置文档不再使用 `echo $AGENT_WALLET_PASSWORD`，这条命令会把钱包密码打印到终端并留在 shell 历史里。如果你照旧文档操作过，建议清理 shell 历史并更换密码。[详情](./agent-wallet/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-17</div>
+<div className="changelog-body">
+
+### MCP Server · Openclaw 扩展
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span><span className="changelog-tag">文档</span></div>
+
+- **MCP Server**——新增 TRON MCP Server 完整**工具清单**，含参数说明。[详情](./mcp-server/)
+- **Openclaw 扩展**——首次发布：简介与快速开始，把浏览器扩展连上 Agent Wallet。[详情](./openclaw-extension/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-13</div>
+<div className="changelog-body">
+
+### SKILLS
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span></div>
+
+- 发布 **BANK OF AI Skill** 说明文档——正是这套技能包让 AI 客户端学会查余额、问报价，并通过 Agent Wallet 执行交易。[详情](./skills/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-10</div>
+<div className="changelog-body">
+
+### MCP Server
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span><span className="changelog-tag">TRON</span></div>
+
+- 两种接入方式：**官方服务接入**直接使用托管地址，**本地私有化部署**适用于密钥和流量必须留在自己环境的场景。[详情](./mcp-server/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-02</div>
+<div className="changelog-body">
+
+### 8004 协议
+
+<div className="changelog-tags"><span className="changelog-tag">更新</span></div>
+
+- 仓库地址从 `bankofai` 迁移到 **`BofAI`**。旧链接会自动跳转，但脚本或依赖里写死的地址需要更新。[详情](./8004/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-02-12</div>
+<div className="changelog-body">
+
+### 8004 协议
+
+<div className="changelog-tags"><span className="changelog-tag">新版本</span></div>
+
+- **v1.1.0**——新增支持网络与合约地址页，发布 Usage 三篇（安装、配置 Agent、HTTP 注册），并重写快速开始，完整走通注册第一个 Agent 的流程。[详情](./8004/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-02-11</div>
+<div className="changelog-body">
+
+### MCP Server · 8004 协议
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span></div>
+
+- **MCP Server**——**TRON MCP Server** 与 **BSC MCP Server** 首批文档发布，覆盖安装、功能与接口说明。[详情](./mcp-server/)
+- **8004 协议**——初版文档上线，讲清链上 Agent 身份解决什么问题以及怎么上手。[详情](./8004/)
+
+</div>
+</div>
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/llm-service.md b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/llm-service.md
new file mode 100644
index 00000000..f38be83f
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/llm-service.md
@@ -0,0 +1,87 @@
+---
+title: 'LLM Service'
+description: 'LLM Service 的版本发布记录。'
+---
+
+# LLM Service
+
+LLM Service 的版本发布记录。
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-07-21</div>
+<div className="changelog-body">
+
+### Kimi K3
+
+<div className="changelog-tags"><span className="changelog-tag">新模型</span></div>
+
+- 上线 **Kimi K3**，定价文档已同步。[模型列表](../llmservice/models/kimi-k3/)
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-07-10</div>
+<div className="changelog-body">
+
+### GPT-5.6
+
+<div className="changelog-tags"><span className="changelog-tag">新模型</span></div>
+
+- 新增 **GPT-5.6** 系列——`sol`、`terra`、`luna`，三者定价均已列出。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-07-02</div>
+<div className="changelog-body">
+
+### Claude Fable 5 与 Claude Sonnet 5
+
+<div className="changelog-tags"><span className="changelog-tag">新模型</span></div>
+
+- 新增 **Claude Fable 5** 与 **Claude Sonnet 5**，定价完整。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-06-19</div>
+<div className="changelog-body">
+
+### GLM-5.2 上线，Qwen 定价修正
+
+<div className="changelog-tags"><span className="changelog-tag">新模型</span><span className="changelog-tag">定价</span></div>
+
+- 新增 **GLM-5.2**。
+- 修正 **Qwen 缓存读取价格**——如果你按旧数字估算过成本，需要重新核对。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-06-13</div>
+<div className="changelog-body">
+
+### 下线废弃模型
+
+<div className="changelog-tags"><span className="changelog-tag">移除</span></div>
+
+- 已停用的模型从模型列表和定价页移除。继续调用这些模型名会直接报错，请切换到在售模型。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-06-01</div>
+<div className="changelog-body">
+
+### MiniMax M3 与 Claude Opus 4.8
+
+<div className="changelog-tags"><span className="changelog-tag">新模型</span></div>
+
+- 新增 **MiniMax M3** 与 **Claude Opus 4.8**，同时重排模型侧边栏，同系列模型归到一起。
+
+</div>
+</div>
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/mcp-server.md b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/mcp-server.md
new file mode 100644
index 00000000..529a05d0
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/mcp-server.md
@@ -0,0 +1,48 @@
+---
+title: 'MCP Server'
+description: 'MCP Server 的版本发布记录。'
+---
+
+# MCP Server
+
+MCP Server 的版本发布记录。
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-17</div>
+<div className="changelog-body">
+
+### TRON MCP Server 完整工具清单
+
+<div className="changelog-tags"><span className="changelog-tag">文档</span><span className="changelog-tag">TRON</span></div>
+
+- 新增**工具列表**页，逐个列出 TRON MCP Server 暴露的所有工具及其参数——接入前就能看清 AI 客户端到底能调用什么。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-10</div>
+<div className="changelog-body">
+
+### 两种接入方式
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span><span className="changelog-tag">TRON</span></div>
+
+- **官方服务接入**——客户端直接指向托管地址，不用自己维护任何服务。
+- **本地私有化部署**——密钥和流量需要留在自己环境里时，可以自行部署。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-02-11</div>
+<div className="changelog-body">
+
+### TRON 与 BSC MCP Server 上线
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span></div>
+
+- **TRON MCP Server** 与 **BSC MCP Server** 首批文档发布，覆盖安装、功能与接口说明。
+
+</div>
+</div>
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/openclaw-extension.md b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/openclaw-extension.md
new file mode 100644
index 00000000..9fa6dbb3
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/openclaw-extension.md
@@ -0,0 +1,47 @@
+---
+title: 'Openclaw 扩展'
+description: 'Openclaw 扩展的版本发布记录。'
+---
+
+# Openclaw 扩展
+
+Openclaw 扩展的版本发布记录。
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-04-01</div>
+<div className="changelog-body">
+
+### TRON 地址默认脱敏显示
+
+<div className="changelog-tags"><span className="changelog-tag">隐私</span></div>
+
+- 扩展界面中的钱包地址改为脱敏展示——共享屏幕或录屏时不会把完整地址暴露出去。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-31</div>
+<div className="changelog-body">
+
+### 新增 Windows 安装指引
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span></div>
+
+- 在原有 macOS 与 Linux 步骤之外补充 **Windows 安装指引**，并完善了整体配置流程说明。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-17</div>
+<div className="changelog-body">
+
+### 首次发布
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span></div>
+
+- 发布 Openclaw 扩展的**简介**与**快速开始**——把浏览器扩展连上 Agent Wallet，在当前页面直接发起链上操作。
+
+</div>
+</div>
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/skills.md b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/skills.md
new file mode 100644
index 00000000..77816570
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/skills.md
@@ -0,0 +1,48 @@
+---
+title: 'SKILLS'
+description: 'SKILLS 的版本发布记录。'
+---
+
+# SKILLS
+
+SKILLS 的版本发布记录。
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-07-10</div>
+<div className="changelog-body">
+
+### GasFree 支付说明与新的目录地址
+
+<div className="changelog-tags"><span className="changelog-tag">更新</span><span className="changelog-tag">x402</span></div>
+
+- Skills 现已支持并说明 TRON 上的 **`exact_gasfree` 支付方案**——账户里不备 TRX 也能付款调用 x402 服务。
+- **API 目录接口更换了新地址**。Skills 与 facilitator 配置同步更新；如果你锁定了旧版本，需要重新安装。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-04-15</div>
+<div className="changelog-body">
+
+### 新增简介与一行安装
+
+<div className="changelog-tags"><span className="changelog-tag">文档</span></div>
+
+- 新增**简介**页，说明 Skills 究竟给你的 AI 带来了什么；配套**快速开始**，一条命令完成安装。
+
+</div>
+</div>
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-03-13</div>
+<div className="changelog-body">
+
+### BANK OF AI Skill
+
+<div className="changelog-tags"><span className="changelog-tag">新增</span></div>
+
+- 发布 **BANK OF AI Skill** 说明文档——正是这套技能包让 AI 客户端学会查余额、问报价，并通过 Agent Wallet 执行链上交易。
+
+</div>
+</div>
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/x402.md b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/x402.md
new file mode 100644
index 00000000..73df74e9
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-changelog/current/x402.md
@@ -0,0 +1,30 @@
+---
+title: 'x402支付协议'
+description: 'x402 支付协议、SDK 与 CLI 的版本发布记录。'
+---
+
+# x402支付协议
+
+x402 协议、SDK 与 [CLI](../x402/cli/) 的版本发布记录。
+
+<div className="changelog-entry">
+<div className="changelog-date">2026-07-15</div>
+<div className="changelog-body">
+
+### x402 CLI v1.0.0
+
+<div className="changelog-tags"><span className="changelog-tag">新版本</span><span className="changelog-tag">CLI</span></div>
+
+`@bankofai/x402-cli` 首个正式版发布——用于 x402 支付的 TypeScript 命令行客户端。
+
+- **`pay`** —— 支付任意受 x402 保护的 URL：探测接口、读取 `402` 支付要求、签名并重试
+- **`serve`** —— 启动本地 x402 付费端点，通过 Facilitator 校验并结算
+- **`roundtrip`** —— 启动临时服务、支付、退出：最快的端到端冒烟测试
+- **`gateway`** / **`catalog`** —— 校验与生成 provider 文件；搜索、缓存、导出服务目录
+- 基于已发布的 `@bankofai/x402-core` / `x402-evm` / `x402-tron` SDK 1.0 包构建；`scheme=exact` 配合 Permit2
+- 支持网络：TRON（`tron:mainnet` / `tron:nile` / `tron:shasta`）与 BSC（`eip155:56` / `eip155:97`）
+
+👉 立即上手：[x402 CLI 快速开始](../x402/cli/quickstart/)
+
+</div>
+</div>
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-devnotes/current.json b/i18n/zh-Hans/docusaurus-plugin-content-docs-devnotes/current.json
new file mode 100644
index 00000000..adb79399
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-devnotes/current.json
@@ -0,0 +1,10 @@
+{
+  "version.label": {
+    "message": "当前",
+    "description": "The label for version current"
+  },
+  "sidebar.devnotesSidebar.doc.Overview": {
+    "message": "总览",
+    "description": "The label for the doc item Overview in sidebar devnotesSidebar"
+  }
+}
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-devnotes/current/first-onchain-swap.md b/i18n/zh-Hans/docusaurus-plugin-content-docs-devnotes/current/first-onchain-swap.md
new file mode 100644
index 00000000..131eb37e
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-devnotes/current/first-onchain-swap.md
@@ -0,0 +1,116 @@
+---
+title: '手把手完成第一笔链上兑换'
+description: '一篇实战演练：从装好 Skills 到在 Nile 测试网完成一笔真实兑换——每一步该确认什么，出错了怎么办。'
+---
+
+# 手把手完成第一笔链上兑换
+
+[快速开始](/zh-Hans/BANK-OF-AI/QuickStart/)让你在一分钟内装好环境。这篇实践从那里接着讲：完整走一遍真实的链上任务，包括每一步值得确认的地方，以及出问题时怎么处理。
+
+我们要做的是：**在 Nile 测试网上把 TRX 换成 USDT**。测试币是免费的，全程不花真钱。
+
+---
+
+## 开始之前
+
+需要准备三样东西：
+
+1. 已装好 Skills 并创建了钱包——见[快速开始](/zh-Hans/BANK-OF-AI/QuickStart/)
+2. 一个有测试 TRX 的 TRON **Nile 测试网**地址
+3. 打开你的 AI 客户端（OpenClaw、Claude Code、Cursor、Codex，用哪个都行）
+
+测试 TRX 可以从 [Nile 水龙头](https://nileex.io/join/getJoinPage)领取。TRX 有两个用途：既是要兑换的资产，也用来支付能量。
+
+---
+
+## 第 1 步：先确认起点状态
+
+做任何交易前，先看清自己的出发点：
+
+> 查一下我在 Nile 测试网的钱包地址和 TRX 余额。
+
+AI 会返回地址和余额。有两点要核对：
+
+- **地址是不是你充值的那个。** 如果你创建过多个钱包，AI 用的是当前活跃钱包，很容易搞混。
+- **余额不为零。** 全新的 TRON 地址在收到第一笔转账前处于"未激活"状态，未激活的账户无法签名合约调用。
+
+如果余额为零或显示未激活，先去水龙头充值，确认到账后再往下走。
+
+---
+
+## 第 2 步：先报价，再动手
+
+不要让第一个链上动作就是交易本身。先问价：
+
+> 在 Nile 测试网上，100 TRX 在 SunSwap 能换多少 USDT？
+
+AI 会查询 SunSwap 并返回预计到手数量。这是纯读取操作——不签名、不花钱。
+
+拿到数字后停一秒看一眼。如果汇率和你的预期差得离谱，先查清楚再继续，别硬着头皮往下走。报价异常通常意味着池子流动性太低，或者代币解析错了——这两种情况现在发现，比签完名再发现便宜得多。
+
+---
+
+## 第 3 步：执行兑换
+
+现在来真的：
+
+> 在 Nile 测试网上把 100 TRX 换成 USDT，滑点不超过 1%。
+
+这句话里有两个细节很关键：
+
+- **明确写出网络。** 否则 AI 可能默认走主网，同样一句话就是真金白银。
+- **明确写出滑点。** 它限定了你能接受的最差成交价。不写就等于接受成交时池子给你的任何价格。
+
+接下来 AI 会按标准流程推进：查余额 → 检查授权 → 拉取最新报价 → 计算滑点 → **把账单摊给你看** → 等待。
+
+它会停在这里。你不确认，就不会签名。
+
+批准前把账单读一遍——到手数量、收款地址、网络。这是最后一个犯错还免费的时刻。
+
+---
+
+## 第 4 步：链上验证
+
+确认之后，AI 会在本地签名、广播，并返回交易哈希。**凭证是这个哈希，不是 AI 的总结**——去验一下：
+
+> 帮我在 TronScan 上查一下这笔交易的结果。
+
+或者自己把哈希粘到 [Nile TronScan](https://nile.tronscan.org) 里。确认状态是成功，且代币数量和你批准的一致。
+
+---
+
+## 出错了怎么办
+
+早期会遇到的问题，基本逃不出这四类：
+
+**"账户未激活"**——这个地址从未在链上收到过任何东西。先给它转一小笔 TRX，激活是每个地址一次性的事。
+
+**"能量不足" / 广播时交易失败**——TRON 的合约调用要消耗能量。除了要兑换的金额，账户里再留一些 TRX，或者质押 TRX 换取能量。
+
+**"授权额度不足"或授权相关报错**——花费 TRC-20 代币需要先一次性授权 DEX 合约。AI 通常会自动处理；如果卡在这里，直接告诉它：*"帮我授权 SunSwap 使用我的 USDT，然后重试兑换。"*
+
+**报价和实际到手差得明显**——这是滑点在起作用。测试网池子薄，这种情况很常见。可以减小金额，或者把滑点设得更紧、宁可让交易回滚也不接受差价成交。
+
+---
+
+## 接下来可以做什么
+
+兑换跑通后，同样的模式可以套用到其它任务上——查状态、先预览、再执行、最后验证：
+
+> 查一下这个代币的持仓分布：`<地址>`
+
+> 在 Nile 测试网上转 10 USDT 到 `<地址>`。
+
+> 帮我质押 100 TRX，然后查一下我现在的 TRON Power。
+
+有两个习惯值得一直保持，哪怕早就不用测试网了：**写操作前先做一次只读查询**，以及**每次都明确写出网络**。两件事都只花一秒，但能挡住最贵的那类错误。
+
+真正上主网时，先用小额把同样的流程跑一遍，再放大金额。
+
+---
+
+## 相关文档
+
+- [快速开始](/zh-Hans/BANK-OF-AI/QuickStart/) —— 安装并创建钱包
+- [Skills](/zh-Hans/McpServer-Skills/SKILLS/Intro/) —— AI 能做的全部事情
+- [Agent Wallet](/zh-Hans/Agent-Wallet/Intro/) —— 私钥怎么保管、签名怎么完成
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs-devnotes/current/index.md b/i18n/zh-Hans/docusaurus-plugin-content-docs-devnotes/current/index.md
new file mode 100644
index 00000000..80286c6c
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs-devnotes/current/index.md
@@ -0,0 +1,12 @@
+---
+title: '最佳实践'
+description: 'BANK OF AI 团队沉淀的实战经验——动手演练，以及值得长期保持的操作习惯。'
+---
+
+# 最佳实践
+
+BANK OF AI 团队沉淀的实战经验——动手演练，以及让 AI 上链干活时值得长期保持的操作习惯。
+
+## 实践列表
+
+- [**手把手完成第一笔链上兑换**](./first-onchain-swap/) —— 在 Nile 测试网上完整走一遍真实任务，包括每一步该确认什么、出错了怎么办。
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json b/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json
index 90d606d2..2b257392 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json
@@ -7,6 +7,10 @@
     "message": "BANK OF AI",
     "description": "The label for category BANK OF AI in sidebar docsSidebar"
   },
+  "sidebar.docsSidebar.link.Official Website": {
+    "message": "官网",
+    "description": "The label for link Official Website in sidebar docsSidebar"
+  },
   "sidebar.docsSidebar.category.x402 Payment Protocol": {
     "message": "x402支付协议",
     "description": "The label for category x402 Payment Protocol in sidebar docsSidebar"
@@ -47,6 +51,10 @@
     "message": "简介",
     "description": "The label for the doc item OverView in sidebar docsSidebar"
   },
+  "sidebar.docsSidebar.doc.Overview": {
+    "message": "简介",
+    "description": "The label for the doc item Overview in sidebar docsSidebar"
+  },
   "sidebar.docsSidebar.category.LLM Service": {
     "message": "LLM 服务",
     "description": "The label for category LLM Service in sidebar docsSidebar"
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/BANK-OF-AI/Intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/BANK-OF-AI/Intro.md
index ef0e361b..8a69e582 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/BANK-OF-AI/Intro.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/BANK-OF-AI/Intro.md
@@ -1,249 +1,192 @@
-# 简介
-
-## 一句话理解 BANK OF AI
-
-**BANK OF AI —— Your Web3 Gateway to AI，你的 Web3 AI 门户。**
-
-一个入口，让你的 AI 同时拥有 4 项核心能力：
-
-- 💸 **付款能力**：会用加密货币付款（x402）
-- 🪪 **身份能力**：拥有可验证的链上身份与信誉（8004）
-- ⚙️ **行动能力**：调用完整的链上原子能力与编排（Skills + MCP Server + Agent Wallet）
-- 🧠 **认知能力**：一号通享顶级大模型（LLM Service）
-
-你不需要懂代码，不需要切钱包，不需要在多个 dApp 之间反复跳转——把任务交给 AI，BANK OF AI 替它接好支付、身份、行动与大脑。
-
 ---
-
-## BANK OF AI 的产品矩阵
-
-BANK OF AI 由 **4 层** 组成：
-
-- **🧠 模型层 | Top AI in One Account** —— LLM Service（BANKOFAI APP + API Gateway），主流大模型的统一入口
-- **🛤️ 协议层 | Payment. Verify. Build.** —— x402 Payment · 8004 Protocol，连接 AI 与 Web3 的两套开放协议
-- **🔧 工具层 | Everything Your Agent Needs** —— Agent Wallet · Skills · MCP Server，让 AI 获得链上签名、操作 SOP 与协议封装的完整工具包
-- **🌐 生态层 | AI Agent Ecosystem** —— 基于同一套协议开放接入的 TRON / Ethereum / BNB Chain 第三方 MCP Server 与 Skills
-
-每一层都可以独立使用，也可以组合起来——按需取用。
-
+title: '简介'
+description: >-
+  BANK OF AI 是连接 AI 与 Web3 的基础设施。装上它，你的 AI 就能付款、验证身份、执行链上操作——你负责说想做什么，AI 负责做成。
 ---
 
-## 🧠 模型层 | Top AI in One Account
-
-### LLM Service — 主流大模型的统一入口
+# 简介
 
-**LLM Service 是 BANK OF AI 的模型接入层**，把 GPT、Claude、Gemini、DeepSeek、Kimi、GLM、MiniMax 等主流大模型聚合到一个账户下，提供两种使用方式：
+今天的 AI 已经会写代码、分析数据、制作演示文稿，甚至能独立完成一个完整的软件项目。
 
-- **BANKOFAI APP**（官方应用，对应官网右上角 `BANKOFAI APP →` 按钮）：面向终端用户的 AI Chat 应用，打开 [chat.bankofai.io/chat](https://chat.bankofai.io/chat) 直接使用，随需切换模型
-- **API Gateway**（一套 API Key 调所有模型）：面向开发者的统一 API，按用量计费，兼容 OpenAI 协议，可接入任意兼容 OpenAI 协议的第三方 AI 客户端
+但如果你告诉它：
 
-**核心特点**：加密货币充值（支持 TRON、BNB Chain、Ethereum、Base、Arbitrum、Optimism、Polygon）、按用量付费（Pay-as-you-go）、不绑卡、不订阅。
+> 帮我把 100 USDT 换成 TRX。
 
-👉 详见：[LLM Service 简介](../llmservice/introduction.md)
+它却什么也做不了。问题不在于它不知道怎么做，而在于——**它没有进入 Web3**。
 
 ---
 
-## 🛤️ 协议层 | Payment. Verify. Build.
-
-有了模型层，AI 还只是一个"大脑"——要让 AI 能在链上花钱、被验证，得先约定两套公开协议：**x402 解决钱怎么收**，**8004 解决 Agent 是谁**。
-
-### 01 · x402 Payment — 一行代码接入链上支付
-
-**基于 HTTP `402 Payment Required` 扩展的开放支付协议**——让 AI 在调用付费服务时自动在链上签一笔小额支付、立刻拿到内容，无需账号、无需信用卡、无需预充值。
+## 它缺了什么？
 
-- **当前支持**：TRON、BNB Chain（更多公链陆续接入）
-- **SDK 组件**：Client SDK · Server SDK · Facilitator
+要进入 Web3，AI 缺少四种关键能力：
 
-**典型场景**：
+- 💸 **支付能力** —— 调用付费服务时，无法付款
+- 🪪 **身份能力** —— 链上无法证明自己是谁
+- ⚙️ **执行能力** —— 连不上区块链，操作落不了地
+- 🔐 **钱包能力** —— 拿不住资产，签不了名
 
-- MCP Server 调用链下付费 API
-- Skills 中的 `x402-payment` 显式发起支付
-- AI Agent 自主决定购买付费内容
-- **Agent 对 Agent 自动结算** —— 两个 AI 之间的按次计费
-
-> ⚙️ **依赖关系**：x402 SDK 通过 [Agent-Wallet](#03--agent-wallet--ai-的本地签名层) 解析和管理钱包凭证——安装 x402 时会自动把 agent-wallet 作为依赖一起装上。
-
-👉 详见：[x402 协议简介](../x402/index.md)
+模型解决的是"想清楚"，而这四种能力解决的是"干得成"。补齐它们，正是 BANK OF AI 存在的意义。
 
 ---
 
-### 02 · 8004 Protocol — AI Agent 的链上身份与信誉
-
-**Web3 上的「Agent 注册局 + 信誉系统」**——任何 Agent 都可以在链上铸造一个身份 NFT，绑定自己的服务端点（Web / MCP / DID），并公开接受其他 Agent 和用户的反馈。
-
-它解决一个核心问题：**AI Agent 越来越多，你怎么知道某个 Agent 可不可信？**
-
-- **标准元数据**：名称、能力声明、服务端点
-- **可验证凭证**：签名 + 轮换策略
-- **链支持**：TRON · BNB Chain
+## BANK OF AI 是什么？
 
-**典型用法**：
+> **BANK OF AI 是连接 AI 与 Web3 的基础设施。**
 
-- AI Agent 调用陌生服务前，先查对方的链上征信
-- Skills 编排中做前置风控校验
-- MCP Server 之间互相验证身份
-- 付费 / 授权之前查对方的信誉评级
+它不是新的大模型，不是钱包应用，也不是交易所。它安装在你已经在使用的 AI 客户端中（如 OpenClaw、Claude Code、Cursor、Codex 等），为 AI 补齐进入 Web3 所需的能力，而无需改变你原本的使用方式。
 
-8004 是**横向协议**——任何需要"验证身份"或"查信誉"的环节都可以调用，不绑定特定层。
-
-👉 详见：[8004 协议简介](../8004/general.md)
+装完之后，AI 就从"只会给建议"变成了"能把事办成"。具体多了哪些本事，往下看。
 
 ---
 
-## 🔧 工具层 | Everything Your Agent Needs
-
-协议层搭好了，还差一套工具让 AI 真正把协议用起来。AI 完成任意链上操作，需要三件事：**链上签名（Agent Wallet）、链上操作 SOP（Skills）、链上协议封装（MCP Server）**。
+## 装上之后，AI 多了四项能力
 
-### 03 · Agent Wallet — AI 的本地签名层
+<div className="intro-cards">
 
-**Agent Wallet 是 AI Agent 的本地加密钱包**，为所有 Skills、MCP Server、x402 SDK 提供统一的签名能力。
+<div className="intro-card">
 
-私钥被加密锁在本地隐藏目录中，AI 只持有一个"解锁密码"。**即便密码泄漏，没有加密文件依然无法解密；即便文件被窃取，没有密码也只是一段无法解读的密文。**
+<div className="intro-card-title">💸 支付</div>
 
-- 🔒 **加密存储**：Keystore 加密 + `local_secure` 模式，100% 本地离线
-- 🔑 **灵活导入**：新建、导入私钥或助记词
-- 🔄 **多钱包切换**：管理多个钱包，随时切换活跃账户
-- ⛓️ **多链签名**：TRON + 全部 EVM 兼容链（Ethereum / BSC / Polygon / Base / Arbitrum…）
+AI 能自动支付 API 与 Agent 服务费用——花钱前先经你确认。
 
-> 💡 **谁在依赖 Agent-Wallet**：
-> - **x402 SDK** —— 解析支付凭证、签发 x402 小额支付（安装 x402 时自动带入）
-> - **Skills** —— 执行需要签名的链上操作时
-> - **MCP Server** 私有化部署时 —— 写入类工具执行前读取本机钱包签名
+<div className="intro-card-links">
 
-**用户感知**：首次按 [快速开始](./QuickStart.md) 走一遍时，Agent-Wallet 会自动创建并配置好——大多数用户不需要单独接触它。
+[x402](../x402/index.md)
 
-👉 详见：[Agent-Wallet 简介](../Agent-Wallet/Intro.md)
+</div>
 
----
+</div>
 
-### 04 · Skills — AI 链上操作的 SOP 手册
+<div className="intro-card">
 
-**Skills 是一套预先编写好的 AI 链上操作标准作业流程。** AI Agent 按 Skills 的 SOP 逐步执行——**查余额 → 检查授权 → 报价 → 滑点保护 → 等你确认 → 调用 MCP Server 执行**，一步不漏，规避常见陷阱。
+<div className="intro-card-title">⚙️ 执行</div>
 
-举例：用户说"花 50 USDT 买点 TRX"。没装 Skills 的 AI 可能直接生成一段交易代码，因未授权 SunSwap 而报错；装了 `sunswap-dex-trading` Skill 的 AI 会严格按 SOP 自动完成所有前置与确认步骤。
+AI 能按标准流程完成转账、Swap、Stake 等链上任务。
 
-**关键特性**：一句话安装全部 Skills；自然语言调用；自动调用下层 MCP Server 完成链上原子操作。BANK OF AI Skills 套件覆盖钱包管理、SunSwap 兑换、SunPerp 永续、TRC20 工具、TronScan 查询、TRX 质押投票、USDD/JUST、多签权限、x402 支付等场景，并随生态持续扩展。
+<div className="intro-card-links">
 
-👉 详见：[Skills 简介](../McpServer-Skills/SKILLS/Intro.md) · [快速开始](./QuickStart.md)
+[Skills](../McpServer-Skills/SKILLS/Intro.md) · [MCP Server](../McpServer-Skills/MCP/Intro.md)
 
----
+</div>
 
-### 05 · MCP Server — 链上原子能力接口层
+</div>
 
-**MCP Server（Model Context Protocol Server）** 基于 Anthropic 的 MCP 标准，把链上与链下能力封装成 AI 可调用的标准化工具。
+<div className="intro-card">
 
-**Skills 与 MCP Server 的关系：**
+<div className="intro-card-title">🔐 钱包</div>
 
-| 层 | 角色 | 负责什么 |
-| :-- | :-- | :-- |
-| **Skills** | 业务编排层（Orchestration） | 把多步操作按 SOP 串起来，处理前置检查和风控 |
-| **MCP Server** | 能力提供层（Capability Provider） | 提供原子能力工具给上层调用 |
+AI 能安全完成签名——私钥永不离开你的设备。
 
-BANK OF AI 提供两套 **MCP Server**，默认接入 BANK OF AI 云服务端点，开箱即用：
+<div className="intro-card-links">
 
-- **TRON MCP Server** — TRON 链上原子操作（查询、转账、合约、质押、治理），60+ 工具。支持本地私有化部署
-- **SUN MCP Server** — SunSwap V2/V3/V4 兑换与流动性，20+ 工具。支持本地私有化部署。另提供 **[SUN CLI](../McpServer-Skills/Tools/SUNCli/Intro.md)**——与 SUN MCP Server 能力完全对等的命令行实现，面向脚本 / 自动化 / CI-CD 场景
+[Agent Wallet](../Agent-Wallet/Intro.md)
 
-> 💡 **私有化部署**：Skills 默认通过官方云端点调用 MCP Server，无需单独安装；若需本地部署，参考对应 MCP Server 的部署文档。
+</div>
 
-> ⚙️ **依赖关系**：MCP Server 私有化部署时需先配置 Agent-Wallet——钱包决定了 AI 以哪个身份执行链上操作。若未配置钱包，写入类工具执行时会返回错误提示。
+</div>
 
-除了 BANK OF AI 自研的 MCP Server，生态中还有更多第三方 MCP Server 和 Skills，见下方 [🌐 生态层](#-生态层--ai-agent-ecosystem)。
+<div className="intro-card">
 
-👉 详见：[MCP Server 简介](../McpServer-Skills/MCP/Intro.md)
+<div className="intro-card-title">🪪 身份</div>
 
----
+AI 拥有可验证的链上身份，Agent 之间可以互信协作。
 
-## 🌐 生态层 | AI Agent Ecosystem
+<div className="intro-card-links">
 
-除了 BANK OF AI 自研的产品，整个生态已接入跨 3 条链的多个主流 DeFi / 数据协议——每一家都提供**生产级的 MCP Server 或 Skills**，AI 安装后立即能用。
+[8004](../8004/general.md)
 
-### 🔴 TRON
+</div>
 
-| 产品 | 提供方 | 覆盖能力 | 安装 |
-| :-- | :-- | :-- | :-- |
-| **TRON MCP Server** | BANK OF AI | Transfer / Contract / Staking / Governance，60+ 工具 | `npx -y @bankofai/mcp-server-tron` |
-| **SUN MCP Server** | BANK OF AI | Swap / Liquidity / Farming，V2/V3/V4，20+ 工具 | `npx -y @bankofai/sun-mcp-server` |
-| **JustLend MCP Server** | JustLend DAO | Lend / Borrow / Staking / Governance，50 工具 | `npx -y @justlend/mcp-server-justlend` |
-| **TronScan MCP Server** | TronScan | Query / Analytics / Security，119 工具 | `https://mcp.tronscan.org/mcp` |
+</div>
 
-### 🔵 Ethereum
+</div>
 
-| 产品 | 提供方 | 覆盖能力 | 安装 |
-| :-- | :-- | :-- | :-- |
-| **Etherscan** | Etherscan Official | Query / Tracking / Analytics，60+ 链 | `npx skills add https://docs.etherscan.io` |
-| **Uniswap AI** | Uniswap Labs | Swap / Liquidity / V4 Hooks / 5 Plugins | `npx skills add Uniswap/uniswap-ai` |
+至于推理能力，AI 本来就已经具备。BANK OF AI 不会替换你的模型，而是让你可以在 GPT、Claude、Gemini 等模型之间自由切换，并结合 Web3 能力完成实际任务（[LLM Service](../llmservice/introduction.md)）。
 
-### 🟡 BNB Chain
+这些产品名现在不用记，也不需要学习任何新的命令或工具。你只需要像聊天一样，告诉 AI 你想完成什么：
 
-| 产品 | 提供方 | 覆盖能力 | 安装 |
-| :-- | :-- | :-- | :-- |
-| **BNB Chain** | BNB Chain Official | Transfer / Contract / Query / 8004 身份注册 | `npx skills add bnb-chain/bnbchain-skills` |
-| **PancakeSwap AI** | PancakeSwap Official | Swap / Liquidity / Farming，3 Skills · 8 链 | `npx skills add pancakeswap/pancakeswap-ai` |
-| **ListaDAO** | ListaDAO Official | Lending / Staking / CDP，3 Skills · 9 MCP 工具 | `npx skills add lista-dao/lista-skills` |
+> **你负责说想做什么，AI 负责做成。**
 
-> 💡 生态持续扩张中，以官网 **[AI Agent Ecosystem](https://bankofai.io)** 为准。
+下面通过一个真实示例，看看这套能力是如何协同工作的。
 
 ---
 
-## BANK OF AI 的协作流程
-
-前面介绍了 4 层各自的分工——下面看它们在一次真实操作中如何协作。用 **TRC20 转账** 这个最常见场景举例。
-
-<div style={{ textAlign: 'center', margin: '1.5rem 0' }}>
+## 一次真实的执行
 
-![AI 智能体通过自然对话完成 TRC20 转账的工作流程](./image/bankofai-architecture.svg)
+假设装好之后，你对 AI 说：
 
-</div>
+> 把 100 USDT 换成 TRX，滑点不超过 1%。
 
-**① 模型层 · 理解意图**
+整条链路一目了然：
 
-你在任意 AI 客户端（OpenClaw / Cursor / Claude Code / Codex 等）里发一句话：
+```text
+用户
+ ↓
+AI 理解需求
+ ↓
+选择 Skill 或调用 MCP Server
+ ↓
+Agent Wallet 签名
+ ↓
+广播交易
+ ↓
+区块链
+ ↓
+返回结果
+```
 
-> 向地址 `T....XXXXX` 转 100 TRX
+执行过程中，任何一步出现问题（余额不足、地址有误），AI 都会立即停下并说明原因；任何涉及资金支出的动作，都必须先经过你的确认。
 
-AI 客户端由 **LLM Service** 驱动，识别出这是一笔 TRC20 / TRX 转账，决定调用 `trc20-token-toolkit` 这个 Skill。
+---
 
-**② 工具层 · Skills 编排**
+## 整体架构
 
-`trc20-token-toolkit` 按 SOP 逐步推进：**查余额 → 校验收款地址 → 构造交易 → 等你确认**。任何一步不通过（余额不足、地址格式错等）都会立即停下并把原因返回给你。
+把上面那条链路抽象成一张图，就是 BANK OF AI 的全部：
 
-**③ 工具层 · MCP + Wallet · 构造 · 签名 · 上链**
+```text
+    AI
+    │
+BANK OF AI
+    │
+   Web3
+```
 
-Skill 调用 **TRON MCP Server** 组装这笔 TRC20 转账交易，然后交给 **Agent-Wallet** 在你本机本地完成签名（**私钥永不出本机**），最后提交到 TRON 主网。
+内部分为四层，每层只负责一件事：
 
-**④ 返回 · 结果沿原路径回到 AI 智能体**
+| 层 | 一句话职责 |
+| :-- | :-- |
+| 🧠 模型层 | 给 AI 提供推理能力，模型随选 |
+| 🛤️ 协议层 | 定好规矩：怎么付钱、怎么证明身份 |
+| 🔧 工具层 | 负责执行：流程、工具、签名 |
+| 🌐 生态层 | 用同一套标准接入各链的第三方服务 |
 
-链上执行完成后，交易哈希、状态、事件日志沿原路径反向返回——MCP Server 解析成结构化数据，AI 智能体再生成自然语言摘要：
+每一层都可以独立使用，也可以组合成完整的平台。后续章节会分别介绍每一层的设计理念和使用方式，现在只需要建立整体认知即可。
 
-> ✅ 已向 `T....XXXXX` 转账 100 TRX。手续费 1.1 TRX。
-> 交易哈希：`0xabc123...def456`（[在 TronScan 查看](https://tronscan.org)）
+---
 
-:::tip 另外两层什么时候登场？
-本例只涉及 **模型层** 和 **工具层**。其他两层按场景触发：
+## 想深入某个部分？
 
-- **🛤️ 协议层**：**涉及付费**时（调用付费 API、订阅 Agent 服务等）走 **x402**；**验证陌生 Agent 身份或查信誉**时走 **8004**
-- **🌐 生态层**：当你需要调用第三方协议（如 **Uniswap AI** 在以太坊兑换、**ListaDAO** 在 BNB Chain 质押）时，AI 智能体会调用对应的第三方 MCP Server / Skills——流程与本例一致，只是把 TRON MCP 换成目标链的 MCP Server
-:::
+| 你想了解 | 去这里 |
+| :-- | :-- |
+| AI 怎么用多个大模型 | [LLM Service](../llmservice/introduction.md) |
+| AI 怎么自动付款 | [x402 支付协议](../x402/index.md) |
+| AI 的链上身份和信誉 | [8004 协议](../8004/general.md) |
+| 私钥怎么保管、签名怎么完成 | [Agent Wallet](../Agent-Wallet/Intro.md) |
+| AI 按什么流程执行操作 | [Skills](../McpServer-Skills/SKILLS/Intro.md) |
+| AI 怎么调用链上工具 | [MCP Server](../McpServer-Skills/MCP/Intro.md) |
 
 ---
 
-## 我适合用 BANK OF AI 吗？
+## 现在，轮到你了
 
-- **Web3 新手：** 完全没问题。把一段安装指令粘贴给 AI 客户端，剩下的全部自动完成；之后用自然语言对话即可，无需了解底层细节。
-- **Web3 老手：** 可以告别「切钱包 + 复制地址 + 算滑点 + 等区块」的繁琐流程，让 AI 接管所有重复性工作，自己专注策略。
-- **AI Agent 开发者：** 完整的 SDK、CLI、API 和 MCP 标准接口——你可以基于 BANK OF AI 构建自己的 AI Agent，让 Agent 拥有链上能力和自动支付能力。
-- **API 服务提供方：** x402 协议让你的付费 API 被 AI 自动调用并按次计费，不需要传统账号注册、信用卡绑定流程，特别适合微支付和 Agent 对 Agent 自动结算场景。
-
----
+到这里，你已经清楚 BANK OF AI 是什么、为什么存在、以及它如何工作。剩下的只有一步：亲手试一次。
 
-## 准备好了吗？
+安装只需大约一分钟：粘贴一段安装指令，然后确认创建钱包。完成后，你就可以对 AI 说出第一句链上指令：
 
-想让你的 AI 客户端拥有 BANK OF AI 链上能力，只需**两步**，不到 **1 分钟**：
+> 帮我查一下钱包余额。
 
-1. **粘贴安装指令** → AI 自动完成 Skills 安装 + 检查钱包状态，询问是否创建钱包
-2. **确认创建钱包** → AI 自动创建本地加密钱包
+从这一刻起，你的 AI 就拥有了 Web3 能力——之后的所有操作，都可以直接用自然语言完成。
 
-如需独立接入 **LLM Service / x402 / 8004** 或对 MCP Server 做**本地私有化部署 / 使用 SUN CLI**，请参考对应产品的文档。
+无论是查询资产、执行交易，还是调用链上服务，你都只需要描述目标，剩下的交给 AI。
 
 👉 **[前往快速开始](./QuickStart.md)**
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/BANK-OF-AI/QuickStart.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/BANK-OF-AI/QuickStart.md
index 5303fef3..102932ac 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/BANK-OF-AI/QuickStart.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/BANK-OF-AI/QuickStart.md
@@ -5,6 +5,13 @@
 1. **粘贴安装指令** → AI 自动完成 Skills 安装 + 检查钱包状态，询问是否创建钱包
 2. **确认创建钱包** → AI 自动创建本地加密钱包
 
+全程**不需要懂代码，也不需要提前准备钱包**——你要做的只有两个动作：复制一段话，然后回复一个字母。
+
+**开始前你需要：**
+
+- 一个支持 Skills 的 AI 客户端：**OpenClaw / Claude Code / Cursor / Codex** 任选其一（你平时用哪个就用哪个）
+- 电脑上装有 **Node.js**（AI 执行安装时会用到 `npx` 命令）。不确定装没装？没关系——直接开始第 1 步，若 AI 提示 `npx` 不可用，去 [nodejs.org](https://nodejs.org/) 装一个再试即可
+
 ---
 
 ## 第 1 步：粘贴安装指令
@@ -84,7 +91,9 @@ AI 会自动安装 Skills，随后问你是否创建钱包。
 
 ## 第 2 步：确认创建钱包
 
-根据 AI 的提示确认创建钱包（比如回复「创建」「继续」或 AI 给出的选项），AI 会自动创建本地加密钱包，并展示钱包信息、地址、主密码和后续可做的事情。
+根据 AI 的提示确认创建钱包（比如回复「A」「创建」或 AI 给出的选项），AI 会自动创建本地加密钱包，并展示钱包信息、地址、主密码和后续可做的事情。
+
+⚠️ **看到主密码后，先停一下：** 它**只展示这一次**，相当于保险箱的唯一钥匙。请立刻复制并保存到密码管理器（1Password / Bitwarden 等），再继续下一步。详见下方[安全须知](#几条提醒)。
 
 <details>
 <summary>展开 AI 输出示例</summary>
@@ -156,7 +165,7 @@ AI 会自动安装 Skills，随后问你是否创建钱包。
 查一下刚刚创建钱包地址的 TRX 和 USDT 余额。
 ```
 
-如果 AI 能返回余额结果——**恭喜，所有组件已经就位，可以开始使用。**
+如果 AI 能返回余额结果——**恭喜，你已经拥有了一个能上链干活的 AI 管家！** 所有组件就位，接下来想让它做什么，直接说就行。
 
 :::note 新钱包可能出现的情况
 刚创建的 TRON 地址在首次收到转账前处于「未激活」状态，查询结果可能会显示 **余额 0 / 账户未激活**——这都是正常的，不影响你继续使用 BANK OF AI。
@@ -196,31 +205,28 @@ AI 会自动安装 Skills，随后问你是否创建钱包。
 
 ## 几条提醒
 
-:::warning 新手三条铁律 · 链上交易不可逆
+:::warning 安全须知 · 链上交易不可逆
+
+**新手三条铁律：**
+
 1. **务必先在测试网验证。** 在 Nile 测试网上先执行 1-2 笔测试交易，确认 AI 行为完全符合预期后，再切换到主网。
 2. **每一笔花费操作前，请仔细核对 AI 给出的账单。**
 3. **从小额开始。** 即便是已经测试过的操作，首次在主网执行时也建议使用小额资金验证。
-:::
 
-:::caution 主密码非常重要，请立即备份
-主密码**仅在第 2 步展示一次**。虽然会自动保存到本地的 `~/.agent-wallet/runtime_secrets.json`，但强烈建议你**同时手动保存到密码管理器**（1Password / Bitwarden 等）——一旦本地文件丢失或损坏，且没有外部备份，你的钱包将**永久无法解锁**（没有备份找回机制，没有客服，没有后门）。
+**主密码请立即备份：** 主密码**仅在第 2 步展示一次**。虽然会自动保存到本地的 `~/.agent-wallet/runtime_secrets.json`，但强烈建议你**同时手动保存到密码管理器**（1Password / Bitwarden 等）——一旦本地文件丢失或损坏，且没有外部备份，你的钱包将**永久无法解锁**（没有备份找回机制，没有客服，没有后门）。**切勿**把这个密码发到聊天工具、邮件、截图或公开仓库中。
 
-⚠️ **切勿**把这个密码发到聊天工具、邮件、截图或公开仓库中。
 :::
 
-:::info 如果你在第 2 步暂时不想创建钱包
-AI 会跳过钱包创建流程。等你准备好时，随时可以在 AI 对话框里触发**对话式创建**——无需重新运行安装指令。详见 [Agent-Wallet 快速开始 · 方式一：对话式创建](../Agent-Wallet/QuickStart.md)。
-:::
+**如果你在第 2 步暂时不想创建钱包** —— AI 会跳过钱包创建流程。等你准备好时，随时可以在 AI 对话框里触发**对话式创建**，无需重新运行安装指令。详见 [Agent-Wallet 快速开始 · 方式一：对话式创建](../Agent-Wallet/QuickStart.md)。
 
-:::tip 想独立使用其他产品或自行部署？
-**BANK OF AI 的完整产品矩阵不止 Skills**——如需独立使用其他产品或对底层做私有化部署，请分别参考：
+### 想独立使用其他产品或自行部署？
+
+BANK OF AI 的完整产品矩阵不止 Skills——如需独立使用其他产品或对底层做私有化部署，请分别参考：
 
 - **LLM Service**（模型接入层）：直接使用 BANKOFAI APP 或接入统一 API Gateway → [LLM Service 简介](../llmservice/introduction.md)
 - **x402 Payment**（支付协议）：让 AI 自动在链上完成小额付款 → [x402 协议简介](../x402/index.md)
 - **8004 Protocol**（身份与信誉）：Agent 链上征信查询 → [8004 协议简介](../8004/general.md)
-- **MCP Server 本地私有化部署**：Skills 默认通过 BANK OF AI 官方云端点调用 MCP Server，无需单独安装；若需本地部署，参考 [TRON MCP 本地私有化部署](../McpServer-Skills/MCP/TRONMCPServer/LocalPrivatizedDeployment.md) · [SUN MCP 本地私有化部署](../McpServer-Skills/MCP/SUNMCPServer/LocalPrivatizedDeployment.md) · [BSC MCP 安装](../McpServer-Skills/MCP/BSCMCPServer/Installation.md)
-- **SUN CLI**：与 SUN MCP Server 能力对等的命令行工具，面向脚本/自动化/CI-CD 场景 → [SUN CLI 快速开始](../McpServer-Skills/Tools/SUNCli/QuickStart.md)
-:::
+- **MCP Server 本地私有化部署**：Skills 默认通过 BANK OF AI 官方云端点调用 MCP Server，无需单独安装；若需本地部署，参考 [TRON MCP 本地私有化部署](../McpServer-Skills/MCP/TRONMCPServer/LocalPrivatizedDeployment.md) · [BSC MCP 安装](../McpServer-Skills/MCP/BSCMCPServer/Installation.md)
 
 ---
 
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Intro.md
deleted file mode 100644
index 43aba1c6..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Intro.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# 简介
-
-BANK OF AI 通过 **MCP Server** 与 **Skills** 构建了一套完整的 AI Agent 能力体系：前者是"锅碗瓢盆"——提供标准化的区块链交互工具；后者是"米其林菜谱"——将这些工具编排为可执行的任务流程，让 AI 在链上环境中像老手一样完成复杂操作。
-
-* **MCP Server** 为大型语言模型 (LLM) 与外部工具和数据源之间的交互提供标准化框架。其核心是清晰定义的客户端-服务器架构和分层通信机制，确保 AI 应用能安全、高效地访问和利用外部信息。
-* **Skills** 是用于将多个工具按流程编排起来的"任务操作手册"，帮助 AI 完成复杂的多步骤任务——从 DEX 交易、永续合约到链上数据分析。
-
-## 快速导航
-
-- **了解 MCP Server**：前往 [MCP Server 简介](./MCP/Intro.md)，了解协议架构与通信机制。
-- **了解 Skills**：前往 [Skills 简介](./SKILLS/Intro.md)，了解技能包的设计理念、一键安装和使用方式。
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/Intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/Intro.md
index 86978c0b..683a9263 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/Intro.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/Intro.md
@@ -8,7 +8,7 @@ MCP 遵循**客户端-服务器**架构，主要包含以下三个核心参与
 
 *   **MCP 主机**：通常是 AI 应用程序本身。它负责协调和管理一个或多个 MCP 客户端。
 *   **MCP 客户端**：由 MCP 主机为每个 MCP 服务器实例化。每个客户端维护与对应 MCP 服务器的专用连接，并从服务器获取上下文信息供主机使用。
-*   **MCP 服务器**：一个程序，负责向 MCP 客户端提供上下文数据。服务器可以是本地运行的（例如文件系统服务器），也可以是远程运行的（例如 TRON MCP/SUN MCP 服务器）。
+*   **MCP 服务器**：一个程序，负责向 MCP 客户端提供上下文数据。服务器可以是本地运行的（例如文件系统服务器），也可以是远程运行的（例如 TRON MCP 服务器）。
 
 这种架构允许 AI 应用通过多个客户端同时连接到不同的 MCP 服务器，从而扩展其能力。
 
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/FAQ.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/FAQ.md
deleted file mode 100644
index c9dc5909..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/FAQ.md
+++ /dev/null
@@ -1,481 +0,0 @@
----
-title: 常见问题与排查
-description: SUN MCP Server 的常见问题解答，涵盖连接、认证、DeFi 操作和故障排除。
----
-
-# 常见问题与排查
-
-本页面收集了使用 SUN MCP Server 时的常见问题及其解决方案。
-
-## 连接问题
-
-### MCP 客户端 "无法连接到 MCP 服务器"
-
-**症状：** MCP 客户端 显示服务器未响应或连接被拒绝。
-
-**解决步骤：**
-
-1. **检查 Node.js 安装**
-   ```bash
-   node --version  # 应返回 v18+
-   npm --version
-   ```
-
-2. **验证服务器运行**
-   ```bash
-   # 如果使用官方服务器
-   npx -y @bankofai/sun-mcp-server
-   
-   # 如果使用本地部署
-   npm start
-   ```
-
-3. **检查 JSON 格式**
-   - 在 MCP 客户端 配置中验证 `stdio.json` 的 JSON 格式
-   - 常见错误：末尾多余逗号、未匹配的括号
-
-4. **重启 MCP 客户端**
-   - 完全关闭应用程序
-   - 清除缓存（方法取决于你使用的特定 MCP 客户端）
-   - 重新启动应用程序
-
-5. **检查服务器日志**
-   ```bash
-   # 如果使用官方服务器，启用详细日志
-   DEBUG=* npx -y @bankofai/sun-mcp-server
-   ```
-
-**如果问题持续：** 查看 [官方服务器访问指南](OfficialServerAccess.md) 以获取最新的配置示例。
-
-### HTTP 模式下"连接被拒绝"
-
-**症状：** 尝试通过 HTTP 连接时出现连接被拒绝错误。
-
-**常见原因和解决方案：**
-
-1. **服务器未运行**
-   ```bash
-   # 启动服务器在 HTTP 模式
-   sun-mcp-server --http --port 8080
-   ```
-
-2. **端口 8080 被占用**
-   ```bash
-   # 检查端口占用
-   lsof -i :8080
-   
-   # 使用不同的端口
-   sun-mcp-server --http --port 8081
-   ```
-
-3. **防火墙阻止连接**
-   - 检查本地防火墙规则
-   - 确保允许 localhost:8080 连接
-   - 在 macOS 上：系统设置 > 安全与隐私 > 防火墙
-
-4. **确认服务器地址**
-   - 使用 `http://localhost:8080` 而非 `127.0.0.1:8080`
-   - 确保没有拼写错误
-
-### 工具列表中只有读取工具
-
-**症状：** 无法看到 `sunswap_swap`、`sunswap_add_liquidity` 等写入工具。
-
-**原因：** 未配置钱包。
-
-**解决方案：**
-
-1. **配置 [Agent Wallet](../../../Agent-Wallet/Intro.md)** — 设置 `AGENT_WALLET_PASSWORD`
-   ```bash
-   export AGENT_WALLET_PASSWORD='your_password'
-   ```
-
-2. **重新启动服务器**并重新连接 MCP 客户端
-
-验证配置成功的方式：查看 [完整能力清单](ToolList.md) 中的完整能力清单。
-
-## 认证与密钥问题
-
-### "私钥无效"错误
-
-**症状：** 服务器拒绝提供的私钥。
-
-**私钥格式要求：**
-- 必须是 64 个十六进制字符（不包括 `0x` 前缀）
-- 有效范围：`0x0000000000000000000000000000000000000000000000000000000000000001` 至 `0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364140`
-
-**检查步骤：**
-```bash
-# 检查私钥长度
-echo -n "your_private_key" | wc -c
-# 应输出 64
-
-# 检查是否为有效的十六进制
-echo "your_private_key" | grep -E '^[0-9a-fA-F]{64}$'
-# 如果有输出，则格式正确
-```
-
-**常见错误：**
-- 包含 `0x` 前缀（移除它）
-- 长度不足 64 字符（从导出工具获取完整密钥）
-- 包含空格或特殊字符
-
-### "Agent Wallet 密码错误"
-
-**症状：** 服务器无法解密 Agent Wallet。
-
-**解决步骤：**
-
-1. **验证密码已设置**：运行 `[[ -n "$AGENT_WALLET_PASSWORD" ]] && echo "已设置" || echo "未设置"` 确认变量已设置（不会泄露密码明文）。
-2. **检查钱包目录**：确认 `~/.agent-wallet/` 存在并包含钱包文件。如果使用了自定义目录，确保 `AGENT_WALLET_DIR` 指向正确路径。
-3. **密码丢失**：需要重新初始化钱包。**警告：此操作会清除所有钱包和密钥——请务必提前转移资金或备份助记词。** 运行 `agent-wallet reset` 清除并重新开始——详见 [CLI 命令行手册 → 重置](../../../Agent-Wallet/Developer/CLI-Reference.md#agent-wallet-reset-reset-all-data)和 [Agent-Wallet 常见问题](../../../Agent-Wallet/FAQ.md)。含有特殊字符的密码是受支持的——设置环境变量时请使用单引号。
-
-
-### 钱包未找到或初始化错误
-
-**症状：** 服务器无法找到或初始化钱包。
-
-**原因：** Agent Wallet 未正确配置。
-
-**解决方案：** 确保 Agent Wallet 已安装并配置：
-
-```bash
-# 设置 Agent Wallet 密码
-export AGENT_WALLET_PASSWORD='your_password'
-
-# 可选：指定自定义钱包目录
-export AGENT_WALLET_DIR="$HOME/.agent-wallet"
-
-# 重启服务器
-sun-mcp-server
-```
-
-如果尚未初始化 Agent Wallet，请参阅 [Agent-Wallet 文档](../../../Agent-Wallet/Intro.md) 了解设置步骤。
-
-## DeFi 操作错误
-
-### "兑换失败"
-
-**症状：** `sunswap_swap` 调用返回错误。
-
-**常见原因和解决方案：**
-
-1. **余额不足**
-   ```bash
-   # 检查源代币余额
-   sunswap_get_balances  # 列出所有余额
-   ```
-   - 确认有足够的源代币
-   - 账户中的金额应包括 Gas 费用
-
-2. **滑点容限过低**
-   ```
-   # 示例：2% 滑点容限可能不够
-   增加到 3-5%
-   ```
-   - 波动市场中可能需要更高的容限
-   - 但过高的容限增加了被抢先交易的风险
-
-3. **代币不可交易**
-   - 检查代币是否在 SunSwap 上列出
-   - 某些新代币可能不支持交易
-   - 验证代币合约地址是否正确
-
-4. **流动性不足**
-   ```
-   使用 sunswap_quote_exact_input 检查可用流动性
-   ```
-   - 小额交易可能失败
-   - 尝试更小的数量或使用多跳路由
-
-**诊断步骤：**
-```
-1. 检查余额
-2. 使用 sunswap_quote_exact_input 估计输出
-3. 尝试使用更高的滑点容限
-4. 检查网络状态
-```
-
-### "添加流动性失败"
-
-**症状：** `sunswap_add_liquidity` 返回错误。
-
-**常见原因和解决方案：**
-
-1. **代币未授权**
-   ```
-   需要授权两个代币用于 SunSwap 合约
-   ```
-   - 调用 `sunswap_approve_token` 或 `permit2_approve`
-   - 授予足够的金额
-   - 两个代币都需要授权
-
-2. **数量比例不合理**
-   ```
-   当前价格可能已变化
-   减少滑点容限允许更大范围的比例
-   ```
-   - 检查池子的当前价格
-   - 调整代币数量以匹配池子的比例
-   - 或增加容限百分比
-
-3. **金额太小**
-   ```
-   最小流动性要求可能未满足
-   ```
-   - 尝试增加金额
-   - 检查 SunSwap 的最小头寸要求
-
-4. **池子不存在**
-   - 验证池子对是否在 SunSwap 上存在
-   - 检查费用等级是否正确（V2：0.3%，V3：0.01%-1%）
-
-**诊断提示：** 始终先验证余额和授权，再调用添加流动性。
-
-### "Permit2 签名失败"
-
-**症状：** Permit2 授权返回签名错误。
-
-**解决步骤：**
-
-1. **检查 Wallet 支持**
-   ```bash
-   # Agent Wallet 必须支持 signTypedData
-   [[ -n "$AGENT_WALLET_PASSWORD" ]] && echo "已设置" || echo "未设置"
-   ```
-
-2. **验证签名数据**
-   - 检查 Permit2 请求的结构化数据
-   - 确认链 ID、代币地址、截止时间正确
-
-3. **重新初始化 Wallet** — 运行 `agent-wallet reset` 清除并重新开始。详见 [CLI 命令行手册 → 重置](../../../Agent-Wallet/Developer/CLI-Reference.md#agent-wallet-reset-reset-all-data)。
-
-4. **使用备用授权方法**
-   ```
-   如果 Permit2 持续失败，改用 sunswap_approve_token
-   ```
-
-### 交易显示"REVERT"状态
-
-**症状：** 交易提交但在链上还原。
-
-**常见原因：**
-
-1. **余额在交易签署后减少**
-   - 钱包可能同时参与其他交易
-   - 间隔足够的时间确保提交
-
-2. **滑点价格变化**
-   - 交易排队期间价格已改变
-   - 增加滑点容限重试
-
-3. **合约状态改变**
-   - 池子或代币合约已更新
-   - 等待一个区块后重试
-
-4. **授权不足**
-   - Permit2 授权已过期或用尽
-   - 重新授权后重试
-
-5. **Gas 不足**
-   - TRON 上不常见，但检查账户余额
-   - 确保账户有足够的 TRX 作为 Gas
-
-**调试提示：**
-```
-检查交易哈希在 https://tronscan.org 上的详细错误信息
-```
-
-## AI 行为问题
-
-### AI 构造了无效代币地址
-
-**症状：** AI 使用了不存在的代币地址，导致操作失败。
-
-**解决方案：**
-
-1. **在提示中提供准确的地址**
-   ```
-   请使用 USDT（TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t）
-   ```
-
-2. **使用官方代币列表**
-   - 从 SunSwap 或 TronScan 获取地址
-   - 始终验证地址格式（大小写和长度）
-
-3. **让 AI 验证地址**
-   ```
-   在执行任何操作前，使用 sunswap_get_token_price 
-   验证代币是否存在
-   ```
-
-### AI 尝试调用不存在的工具
-
-**症状：** AI 调用了 `invalid_tool_name` 等不存在的工具。
-
-**解决方案：**
-
-1. **参考官方工具列表**
-   - 查阅 [SUN MCP Server 工具列表](ToolList.md)
-   - 提供正确的工具名称给 AI
-
-2. **提示中明确列出工具**
-   ```
-   可用的兑换工具包括：
-   - sunswap_swap
-   - sunswap_quote_exact_input
-   - sunswap_quote_exact_output
-   ```
-
-3. **简化请求**
-   - 请求单个操作而非复杂的多步骤工作流
-   - AI 会更可靠地调用正确的工具
-
-### 响应速度较慢
-
-**症状：** 查询数据或执行操作需要很长时间。
-
-**优化步骤：**
-
-1. **简化工作流**
-   - 减少多工具协调的步骤数
-   - 避免大量连续查询
-
-2. **使用本地服务器**
-   - 参考 [本地私有化部署](LocalPrivatizedDeployment.md)
-   - 可能比官方服务器更快（取决于网络）
-
-3. **批量操作**
-   ```
-   合并相关查询以减少往返次数
-   ```
-
-## 通用问题
-
-### 主网、Nile 和 Shasta 有什么区别？
-
-| 特性 | 主网（Mainnet） | Nile 测试网 | Shasta 测试网 |
-|------|---|---|---|
-| **用途** | 生产环境 | 官方测试 | 社区测试 |
-| **网络参数** | `mainnet` | `nile` | `shasta` |
-| **真实价值** | 是 | 否（测试 TRX） | 否（测试 TRX） |
-| **交易最终性** | 立即 | 立即 | 立即 |
-| **推荐用途** | 生产 DeFi | 开发和测试 | 实验 |
-| **稳定性** | 最高 | 高 | 中等 |
-| **获取测试 TRX** | 不适用 | [Nile Faucet](https://nile.trongrid.io/join/getjoined) | [Shasta Faucet](https://shasta.trongrid.io/join/getjoined) |
-
-**最佳实践：**
-- 开发时始终使用 Nile
-- 最终测试在 Shasta
-- 仅在充分验证后迁移到主网
-
-### 能否同时使用多个 MCP Server 实例？
-
-**是的。** 例如，可以同时运行官方主网服务器和本地 Nile 实例。
-
-**配置示例（MCP 客户端）：**
-
-```json
-{
-  "mcpServers": {
-    "sun-mainnet": {
-      "command": "npx",
-      "args": ["-y", "@bankofai/sun-mcp-server"],
-      "env": {
-        "TRON_NETWORK": "mainnet",
-        "AGENT_WALLET_PASSWORD": "your_mainnet_password"
-      }
-    },
-    "sun-nile": {
-      "command": "sun-mcp-server",
-      "args": ["--port", "8081"],
-      "env": {
-        "TRON_NETWORK": "nile",
-        "AGENT_WALLET_PASSWORD": "your_testnet_password"
-      }
-    }
-  }
-}
-```
-
-**注意：** 分别为每个实例使用不同的钱包凭证，以避免混淆。
-
-### 如何更新到最新版本？
-
-**使用 npx（推荐）：**
-```bash
-# npx 自动获取最新版本
-npx -y @bankofai/sun-mcp-server
-
-# 强制清除缓存并获取最新版本
-npx --clear-cache -y @bankofai/sun-mcp-server
-```
-
-**使用本地安装：**
-```bash
-# 更新全局安装
-npm install -g @bankofai/sun-mcp-server
-
-# 或在项目中更新
-npm update @bankofai/sun-mcp-server
-```
-
-**使用 Git 仓库：**
-```bash
-# 克隆或更新仓库
-git clone https://github.com/BofAI/sun-mcp-server.git
-cd sun-mcp-server
-
-# 拉取最新代码
-git pull
-
-# 安装依赖和启动
-npm install
-npm start
-```
-
-### 工具太多导致 LLM 上下文溢出？
-
-**症状：** Claude 报告 token 限制被超出或工具列表太长。
-
-**解决方案：使用工具过滤：**
-
-```bash
-# 仅启用特定工具（白名单）
-sun-mcp-server --whitelist sunswap_swap,sunswap_get_balances,sunswap_quote_exact_input
-
-# 排除某些工具（黑名单）
-sun-mcp-server --blacklist getUserPositions,getPoolVolHistory
-```
-
-**优化提示：**
-- 为不同任务创建多个服务器实例
-- 使用白名单仅加载必要工具
-- 定期清理未使用的工具配置
-
-### 支持哪个 MCP 协议版本？
-
-**SUN MCP Server 支持 MCP 1.10.2 及更高版本。**
-
-**验证版本：**
-```bash
-# 检查依赖中的版本
-npm list @modelcontextprotocol/sdk
-
-# 应输出类似：
-# @modelcontextprotocol/sdk@1.10.2
-```
-
-**升级 MCP SDK：**
-```bash
-npm update @modelcontextprotocol/sdk
-```
-
----
-
-## 获取更多帮助
-
-- **GitHub Issues：** https://github.com/BofAI/sun-mcp-server/issues
-- **完整能力清单：** 查阅 [完整能力清单](ToolList.md) 
-- **本地部署：** 参考 [本地私有化部署](LocalPrivatizedDeployment.md)
-- **官方服务器：** 参考 [官方云服务接入](OfficialServerAccess.md)
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/Intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/Intro.md
deleted file mode 100644
index 2c60b56b..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/Intro.md
+++ /dev/null
@@ -1,107 +0,0 @@
-# 简介
-
-## SUN MCP Server 是什么？
-
-SUN MCP Server 是连接 AI 助手与 TRON 链上最大去中心化交易所 [SUN.IO（SunSwap）](https://sun.io) 的桥梁。它基于 [Model Context Protocol (MCP)](../Intro.md) 标准协议，让你可以用自然语言查询 DeFi 数据、执行代币兑换、管理流动性仓位——而无需自己与合约交互或处理复杂的链上参数。
-
-举个例子：你只需对 Claude 说"帮我把 100 USDT 换成 TRX，用 SunSwap 的最优路径"，AI 就会自动查询最佳兑换路径、估算滑点、请求你确认，然后执行交易。不需要打开前端界面，不需要手动审批合约，也不需要了解路由合约的细节。
-
-这对不同的人意味着不同的事情：
-
-- 如果你是 **DeFi 用户**，它让你用对话的方式操作 SunSwap——兑换、添加流动性、收取手续费，像发消息一样自然。
-- 如果你是 **Web3 开发者**，它是你快速查询 SunSwap 链上状态和协议指标的工具，省去大量 API 对接工作。
-- 如果你是 **AI Agent 构建者**，它提供标准化的 DeFi 工具集，可以直接编排进你的自动化交易或做市策略。
-- 如果你是 **数据分析师**，它让 SunSwap 的交易量、池子 APY、持仓数据触手可及，无需翻 API 文档。
-
----
-
-## 它能做什么？
-
-SUN MCP Server 覆盖了与 SunSwap DEX 交互的完整操作，从链上数据查询到代币兑换和流动性管理，共提供 **41 个工具**。
-
-以下是核心能力概览——每一项都可以通过自然语言触发：
-
-**数据查询（只读，无需私钥）：**
-
-| 能力 | 描述 | 你可以这样说 |
-| :--- | :--- | :--- |
-| **代币价格** | 查询 SunSwap 上任意代币的实时价格 | "USDT/TRX 现在的价格是多少？" |
-| **兑换报价** | 获取指定输入金额的最优兑换路径和预期输出 | "100 USDT 能换多少 TRX？" |
-| **池子数据** | 查询池子列表、APY、交易量、流动性历史 | "USDT-TRX 池子当前 APY 是多少？" |
-| **持仓查询** | 查看某地址在 SunSwap 上的流动性仓位 | "查一下我的 SunSwap 仓位" |
-| **协议统计** | 获取 SunSwap 整体交易量、用户数、池数量历史 | "过去 7 天 SunSwap 的交易量是多少？" |
-| **矿池信息** | 查询矿池列表和用户的挖矿持仓 | "SunSwap 上有哪些收益矿池？" |
-
-**DeFi 操作（写入，需要私钥）：**
-
-| 能力 | 描述 | 你可以这样说 |
-| :--- | :--- | :--- |
-| **代币兑换** | 通过 Universal Router 执行最优路径兑换 | "帮我把 100 USDT 换成 TRX" |
-| **V2 流动性** | 向 V2 池添加/移除流动性，自动处理 TRX/WTRX 转换 | "向 USDT-TRX V2 池添加 100 USDT 流动性" |
-| **V3 流动性** | 铸造和管理集中流动性仓位，收取手续费 | "收取我 V3 仓位累积的手续费" |
-| **V4 流动性** | V4 集中流动性操作，支持 Permit2 授权 | "铸造一个 V4 USDT-TRX 仓位" |
-| **合约交互** | 直接读取或调用任意 TRON 智能合约函数 | "查询这个合约的当前 slot0 状态" |
-
-完整的工具列表和参数说明，请参阅 [完整能力清单](./ToolList.md)。
-
----
-
-## 两种接入方式
-
-了解了 SUN MCP Server 的能力后，你需要选择一种接入方式。根据你的使用场景，有两条路径：
-
-**[官方云服务](./OfficialServerAccess.md)** — 适合快速体验和数据查询。不需要安装任何东西，在 AI 客户端配置中加一行服务地址就能开始使用。但云服务只提供**只读**能力——查询代币价格、池子数据、协议统计等，不支持执行兑换、添加流动性等链上写操作。
-
-**[本地私有化部署](./LocalPrivatizedDeployment.md)** — 适合需要完整 DeFi 功能的用户。在你自己的机器上运行 SUN MCP Server，配置钱包后即可解锁兑换、流动性管理等全部操作。私钥完全在本地管理，不会上传到任何远程服务。
-
-两者的核心区别归结为一点：**是否需要签名交易**。
-
-| 对比项 | 官方云服务 | 本地私有化部署 |
-| :--- | :--- | :--- |
-| **功能范围** | 仅读取（数据查询） | 完整功能（查询 + 兑换 + 流动性） |
-| **上手难度** | 加一条配置即可 | 需本地安装和构建 |
-| **是否需要私钥** | 不需要 | 需要（写入操作必须） |
-| **代币兑换/流动性** | 不支持 | 支持 |
-| **适合场景** | 数据查询、入门体验 | DeFi 操作、自动化交易策略 |
-| **安全性** | 高（无私钥暴露风险） | 取决于你的密钥管理方式 |
-
-:::tip 不确定选哪个？
-如果你只是想查查 SunSwap 的价格和池子数据，从[官方云服务](./OfficialServerAccess.md)开始就好，1 分钟即可接入。等到需要执行兑换或管理流动性时，再切换到[本地私有化部署](./LocalPrivatizedDeployment.md)。
-:::
-
----
-
-## 支持的网络
-
-无论选择哪种接入方式，SUN MCP Server 都支持以下三个网络（默认连接主网）：
-
-| 网络 | 标识符 | 用途 | 区块浏览器 |
-| :--- | :--- | :--- | :--- |
-| **主网** | `mainnet` | 生产环境，真实资产 | [tronscan.org](https://tronscan.org) |
-| **Nile 测试网** | `nile` | 开发测试（推荐） | [nile.tronscan.org](https://nile.tronscan.org) |
-| **Shasta 测试网** | `shasta` | 开发测试 | [shasta.tronscan.org](https://shasta.tronscan.org) |
-
-调用工具时，通过 `network` 参数指定目标网络。**强烈建议每次新操作先在 Nile 测试网上验证**，主网操作直接涉及真实资产，错误无法撤回。
-
----
-
-## 安全注意事项
-
-:::warning
-在开始使用之前，有几条安全原则值得牢记——DeFi 操作直接涉及链上资产，错误操作无法撤回：
-
-- **切勿硬编码私钥**：不要将私钥或助记词直接写入配置文件，应通过系统环境变量或加密钱包管理。
-- **先在测试网验证**：任何兑换或流动性操作在主网执行前，先在 Nile 测试网上跑通。
-- **最小资金原则**：为 AI Agent 配置的钱包只存放执行任务所需的最低金额。
-- **注意授权风险**：代币授权（`approve`）操作要格外谨慎，避免授予无限额度。
-- **确认每笔交易**：AI 执行链上写操作前会展示交易详情请求确认，不要跳过这一步。
-:::
-
----
-
-## 下一步
-
-- 想用最快的速度体验一下？ → [快速开始](./QuickStart.md)
-- 只需要查询链上数据？ → [官方云服务接入](./OfficialServerAccess.md)
-- 需要代币兑换或流动性管理？ → [本地私有化部署](./LocalPrivatizedDeployment.md)
-- 想了解全部 41 个工具？ → [完整能力清单](./ToolList.md)
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/LocalPrivatizedDeployment.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/LocalPrivatizedDeployment.md
deleted file mode 100644
index b90a9358..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/LocalPrivatizedDeployment.md
+++ /dev/null
@@ -1,242 +0,0 @@
-# 本地私有化部署
-
-## 什么是本地私有化部署？
-
-本地私有化部署是指在您自己的计算机上运行 SUN MCP Server 的完整实例。与依赖第三方服务不同，本地部署让您完全控制您的钱包、网络连接和数据隐私。
-
-这种模式特别适合需要执行 DeFi 操作的场景。通过配置钱包私钥或助记词，您可以解锁以下写入操作：
-
-- **Swap**：使用 Universal Router 进行自动路由交换
-- **流动性管理**：SunSwap V2/V3/V4 添加和移除流动性
-- **头寸管理**：SunSwap V3/V4 铸造、增加、减少头寸和收集费用
-- **合约交互**：通过 `sunswap_send_contract` 调用任意合约
-
-:::info
-无钱包配置下，SUN MCP Server 将以**只读模式**运行，允许查询链上数据但无法执行写入操作。
-:::
-
----
-
-## 开始之前
-
-### 环境要求
-
-| 项目 | 要求 | 说明 |
-|------|------|------|
-| Node.js | >= 20.0.0 | v20.0.0 或更高版本（[下载](https://nodejs.org/)） |
-| npm | >= 10.0 | 通常与 Node.js 一起安装 |
-| 操作系统 | Linux / macOS / Windows | 跨平台支持 |
-| 磁盘空间 | >= 100 MB | 用于安装依赖 |
-| 网络 | 互联网连接 | 与 TRON 网络通信 |
-
-### 安全原则
-
-:::danger 重要安全提示
-1. **私钥保护**：永远不要将私钥提交到版本控制系统。使用 `.env` 文件并将其添加到 `.gitignore`。
-2. **权限管理**：确保 `.env` 文件的权限为 `600`（仅所有者可读）。
-3. **多钱包模式禁止**：同时配置多个钱包方式将触发错误。只能同时使用一种方式。
-4. **助记词用语**：在本文档中，"助记词"指的是 BIP-39 标准的 12 词或 24 词恢复短语。
-5. **主网谨慎**：在主网中使用实际资金前，请务必在测试网（Nile、Shasta）上充分测试。
-:::
-
----
-
-## 安装步骤
-### 第一步：配置钱包
-
-钱包决定了 AI 助手以哪个身份执行链上操作。SUN MCP Server 使用 [Agent Wallet](../../../Agent-Wallet/Intro.md) 进行安全的钱包管理。若未配置钱包，服务器会自动以只读模式运行。
-
-#### Agent Wallet
-
-SUN MCP Server 使用 [Agent Wallet](../../../Agent-Wallet/Intro.md) 管理钱包。私钥加密存储在本地磁盘，不会以明文形式暴露在环境变量中。即使环境变量被泄露，攻击者仍需要加密的密钥库文件才能访问资金。Agent Wallet 还支持**多钱包管理**和运行时通过 `select_wallet` 工具切换钱包。
-
-| 特性 | 说明 |
-| :--- | :--- |
-| 安全等级 | 高（加密存储） |
-| 多钱包支持 | 是 |
-| 运行时切换钱包 | 是 |
-| 推荐场景 | 所有场景 |
-
-> Agent Wallet 的安装、初始化及详细用法请参阅 [Agent-Wallet 文档](../../../Agent-Wallet/Intro.md)。
-
-首先，安装 Agent Wallet：
-
-```bash
-npm install -g @bankofai/agent-wallet
-```
-
-然后，根据你的情况选择以下两种方式之一：
-
-#### 方式 A：生成新钱包（推荐新用户使用）
-
-如果你没有现成的私钥，使用 `agent-wallet start` 生成新钱包，包含加密密钥库和主密码：
-
-```bash
-agent-wallet start
-```
-
-按照交互式提示设置主密码并生成钱包。完成后即可直接使用——**无需额外设置任何环境变量**。Agent Wallet 会自动管理加密密钥库。
-
-#### 方式 B：导入已有私钥
-
-如果你已经有想使用的私钥，通过 `AGENT_WALLET_PRIVATE_KEY` 环境变量设置：
-
-```bash
-export AGENT_WALLET_PRIVATE_KEY=你的私钥
-```
-
-:::tip
-如需在每次打开终端时自动生效，可将其写入 shell 配置文件：
-
-```bash
-echo 'export AGENT_WALLET_PRIVATE_KEY=你的私钥' >> ~/.zshrc   # zsh（macOS 默认）
-echo 'export AGENT_WALLET_PRIVATE_KEY=你的私钥' >> ~/.bashrc  # bash（Linux 默认）
-source ~/.zshrc   # 或 source ~/.bashrc — 无需重启终端即可立即生效
-```
-
-验证环境变量已生效：
-
-```bash
-echo $AGENT_WALLET_PRIVATE_KEY
-```
-:::
-
----
-
-### 第二步：本地私有化部署
-
-#### 方式 A：npx 直接运行（推荐）
-
-最简单快捷的方式，无需安装或克隆。
-
-**命令：**
-
-```bash
-npx -y @bankofai/sun-mcp-server
-```
-
-**说明：**
-- `npx` 会自动下载最新版本的 `@bankofai/sun-mcp-server`
-- `-y` 标志自动确认提示
-- 首次运行可能需要几秒钟下载
-
-**带环境变量运行：**
-
-```bash
-TRON_NETWORK=nile npx -y @bankofai/sun-mcp-server
-```
-
-#### 方式 B：从源码克隆
-
-适合开发和自定义修改。
-
-**步骤：**
-
-```bash
-# 1. 克隆仓库
-git clone https://github.com/BofAI/sun-mcp-server.git
-cd sun-mcp-server
-
-# 2. 安装依赖
-npm install
-
-# 3. 构建项目
-npm run build
-
-# 4. 运行服务器
-npx tsx src/index.ts
-```
-
-**或者全局安装：**
-
-```bash
-npm install -g @bankofai/sun-mcp-server
-sun-mcp-server
-```
-
-
-#### 方式 C：HTTP 模式
-
-以 HTTP 服务器模式运行 SUN MCP Server，允许远程连接。
-
-**启动 HTTP 服务器：**
-
-```bash
-sun-mcp-server --transport streamable-http --host 127.0.0.1 --port 8080 --mcpPath /mcp
-```
-
-:::warning
-HTTP 模式适用于本地开发和测试。对于远程部署，请使用 HTTPS 和适当的身份验证。
-:::
-
-:::tip 关于环境变量
-- **npx 运行**：在运行命令前直接在终端导出环境变量。
-- **HTTP 模式**：启动 HTTP 服务器时，环境变量应在启动命令前导出：
-
-```bash
-export TRON_NETWORK=nile
-sun-mcp-server --transport streamable-http --host 127.0.0.1 --port 8080 --mcpPath /mcp
-```
-
-- **客户端配置**：服务器运行后，配置你的 MCP 客户端以连接到它。
-:::
-
----
-
-### 第三步：客户端配置
-
-服务器运行后，需要配置你的 MCP 客户端与其连接。请参考你的 MCP 客户端文档获取配置说明。服务器可通过以下方式访问：
-
-- **npx/本地构建**：通常作为客户端管理的子进程运行
-- **HTTP 模式**：`http://127.0.0.1:8080/mcp`（或你指定的主机/端口）
-
----
-
-### 第四步：验证接入是否成功
-
-启动 AI 客户端后，应该能看到 SUN MCP Server 的工具列表。进行以下测试以确认配置正确：
-
-#### 查询测试
-
-在聊天中尝试以下命令：
-
-```
-查一下 SunSwap 上 USDT 和 TRX 的当前价格
-```
-
-期望返回当前区块号。
-
-#### 如果在测试网中
-
-如果您配置为使用 Nile 测试网：
-
-```bash
-TRON_NETWORK=nile
-```
-
-可以在 [TRON Nile 水龙头](https://nile.trongrid.io/join) 获取测试 TRX，然后尝试以下操作：
-
-- 查询测试账户余额
-- 执行一次测试交换（如果已配置钱包）
-- 检查交易历史
-
-:::info 诊断步骤
-如果遇到连接问题：
-
-1. **检查网络连接**：确保能访问 TRON 网络端点
-2. **查看日志**：运行服务器时查看控制台输出，寻找错误信息
-3. **测试网络**：尝试切换到测试网（Nile）排除网络问题
-:::
-
----
-
-## 下一步
-
-现在您已成功部署 SUN MCP Server！接下来可以：
-
-1. **查看完整能力清单**：浏览 [完整能力清单](./ToolList.md) 了解所有可用操作
-2. **解决常见问题**：查阅 [常见问题解答](./FAQ.md) 获取帮助
-
-:::success
-恭喜！您现在可以通过 AI 客户端与 TRON 区块链进行交互。开始探索 DeFi 的无限可能吧！
-:::
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/OfficialServerAccess.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/OfficialServerAccess.md
deleted file mode 100644
index 97778db6..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/OfficialServerAccess.md
+++ /dev/null
@@ -1,192 +0,0 @@
-# 官方云服务接入
-
-## 什么是官方云服务？
-
-官方云服务是由 **BANK OF AI** 托管的 SUN MCP Server 实例，用于为 AI 客户端提供 **SunSwap 链上数据的只读查询能力**。
-
-如果你想让 AI 助手查询 SunSwap 上的代币价格、池子 APY、协议交易量，或者分析某个地址的流动性持仓——这些都是只读操作，通过官方云服务即可完成，不需要提供任何钱包凭证。
-
-**官方云服务的核心作用，就是将基础设施工作全部托管。** 你只需要在 AI 客户端的配置中添加一行服务地址，即可开始与 SunSwap 对话。
-
-### 使用官方云服务的主要优点
-
-**1. 无私钥暴露风险**
-
-由于云服务是只读的，你完全不需要提供任何钱包私钥或助记词。这从根本上消除了密钥泄露的风险。在团队协作场景中尤为方便——任何成员都可以直接接入，不存在密钥分发和管理的问题。
-
-**2. 官方维护与持续升级**
-
-云服务始终运行最新稳定版本，包括 SunSwap 协议更新的适配和 SUN.IO API 的同步。你无需关心版本号，也不需要手动重新构建。
-
-**3. 覆盖大量实用场景**
-
-查询代币价格和兑换报价、分析池子数据和 APY、获取协议统计和历史指标、查看用户流动性持仓——这些日常最常用的 DeFi 数据查询，通过云服务全部可以完成。只有当你需要实际执行兑换或管理流动性时，才需要切换到[本地私有化部署](./LocalPrivatizedDeployment.md)。
-
-> 简单来说：**官方云服务就像 SunSwap 的"只读数据网关"**，AI 客户端只需要知道服务地址，就可以查询 SunSwap 上的一切公开数据。
-
-:::warning 重要说明
-官方云服务仅提供**只读访问**。**不支持**代币兑换、添加/移除流动性以及任何其他链上写操作。如需完整功能，请使用[本地私有化部署](./LocalPrivatizedDeployment.md)。
-:::
-
----
-
-## 如何接入官方云服务？
-
-我们提供了三种安装方式。**根据你的使用习惯选一种即可**——对话式安装最简单；交互式安装控制最精细。
-
-### 方式一：对话式安装（最简单）
-
-如果你已经在使用支持 shell 命令的 AI Agent（OpenClaw、Telegram Bot、Web 聊天页面、Claude Code、Cursor 等），你可以**直接在对话框里让 AI 完成安装**——不用自己打开终端，不用手动复制文件。
-
-:::tip 前置依赖
-**需要在 AI Agent 运行的机器上安装 Node.js**（Agent 内部会调用 `npx`）。如果还没装，去 [nodejs.org](https://nodejs.org) 下载 LTS 安装包，双击按提示装一次即可，后续无需再操作。
-:::
-
-**操作步骤：**
-
-1. 打开你的 AI Agent 对话框
-2. 复制下面这段 prompt 发送给 AI：
-
-   ```
-   运行 npx add-mcp https://sun-mcp-server.bankofai.io/mcp -y 安装 SUN MCP Server。
-   注意：请安装到当前 Agent 对应的 MCP 配置中。
-   ```
-
-3. AI 会自动完成以下流程（无需人工干预）：
-   - 识别远程 MCP 服务地址
-   - 自动检测当前正在使用的 AI 客户端
-   - 把 `sun-mcp-server` 配置写入对应的 MCP 配置文件（无需手动改 JSON）
-   - 完成后给出 ✅ 确认信息
-
-AI 给出 ✅ 确认后，SUN MCP Server 就已就位，可以直接开始提问。
-
-:::tip 这是新手最推荐的路径
-你不需要懂 `npx`、`npm` 是什么，也不用关心 MCP 配置文件在哪里。AI 会处理每一步，包括为你的客户端选对配置文件路径。
-:::
-
-### 方式二：一键自动安装（命令行）
-
-如果你已经装好 Node.js 并习惯使用命令行，直接在终端运行以下命令：
-
-```bash
-npx add-mcp https://sun-mcp-server.bankofai.io/mcp -y
-```
-
-`-y` 参数会跳过所有交互选择，自动安装到你电脑上检测到的所有 AI 工具中。安装完成后会显示 ✅ 安装完成！以及安装到了哪些 Agent。
-
-安装完成后，即可使用 SUN MCP Server 开始与 SunSwap 交互。
-
-### 方式三：交互式安装（最精细控制）
-
-如果你想手动选择安装到哪些 AI 工具，去掉 `-y` 参数即可：
-
-```bash
-npx add-mcp https://sun-mcp-server.bankofai.io/mcp
-```
-
-:::tip 提示
-本文档以在终端中运行命令为例展示安装过程。
-:::
-
-#### 安装过程详解
-
-安装器会引导你完成以下几步，照着做就行：
-
-**1️⃣ 识别服务来源**
-
-安装器会自动识别远程 MCP 服务地址，并为其生成服务名称：
-
-```
-◇  Source: https://sun-mcp-server.bankofai.io/mcp (remote)
-│
-●  Server name: sun-mcp-server
-```
-
-**2️⃣ 选择要安装到哪些 AI 工具**
-
-安装器会自动检测你电脑上装了哪些 AI 工具（如 Claude Code、Cursor、Cline 等），用空格键勾选你要用的：
-
-```
-◇  Detected 1 agent
-│
-◇  Select agents to install to
-│  Claude Code
-```
-
-**3️⃣ 确认安装信息**
-
-安装器会展示安装摘要，确认无误后选择 `Yes` 开始安装：
-
-```
-◇  Installation Summary ───╮
-│                          │
-│  Server: sun-mcp-server  │
-│  Type: remote            │
-│  Scope: Project          │
-│  Agents: Claude Code     │
-│                          │
-├──────────────────────────╯
-│
-◇  Proceed with installation?
-│  Yes
-```
-
-**4️⃣ 安装完成！**
-
-看到类似以下输出，说明 SUN MCP Server 已经成功安装到你选择的 AI 工具中：
-
-```
-◇  Installation complete
-│
-◇  Installed to 1 agent ───────╮
-│                              │
-│  ✓ Claude Code: ~/.mcp.json  │
-│                              │
-├──────────────────────────────╯
-│
-└  Done!
-```
-
-安装完成后，即可使用 SUN MCP Server 开始与 SunSwap 交互。
-
----
-
-## 验证接入是否成功
-
-接入完成后，你可以直接向 AI Agent 提出以下问题来测试：
-
-```
-查一下 SunSwap 上 USDT 和 TRX 的当前价格
-```
-
-如果收到正常响应，说明接入成功。
-
-如遇到问题，请先确认：
-1. Node.js 版本 >= 20.0.0（运行 `node --version` 检查）
-2. 网络能正常访问 `sun-mcp-server.bankofai.io`
-
----
-
-## 可用能力一览
-
-通过官方云服务连接时，可以使用全部**只读**工具，包括：
-
-| 分类 | 示例能力 |
-| :--- | :--- |
-| **代币价格** | 按地址或符号查询代币实时价格 |
-| **兑换报价** | 通过智能路由获取精确输入的最优兑换报价 |
-| **代币信息** | 按地址、协议或关键字搜索代币信息 |
-| **池子数据** | 池子列表、APY 排行、交易量历史、流动性历史 |
-| **持仓查询** | 用户流动性持仓、tick 级别持仓详情 |
-| **协议统计** | 交易量、用户数、交易笔数、池子数量历史 |
-| **矿池信息** | 矿池列表、矿池交易记录、用户矿池持仓 |
-| **合约读取** | 调用任意 TRON 合约的 view/pure 函数 |
-
-完整能力清单请参阅 [完整能力清单](./ToolList.md)。
-
----
-
-## 下一步
-
-- 需要代币兑换或流动性管理？ → [本地私有化部署](./LocalPrivatizedDeployment.md)
-- 想看所有可用工具的详细说明？ → [完整能力清单](./ToolList.md)
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/QuickStart.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/QuickStart.md
deleted file mode 100644
index b2e13812..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/QuickStart.md
+++ /dev/null
@@ -1,82 +0,0 @@
-# 快速开始
-
-这个页面的目标很简单：**让你在 1 分钟内完成接入，发起第一次 DeFi 查询。**
-
-我们会使用[官方云服务](./OfficialServerAccess.md)来完成这次快速体验。云服务是只读的，无需钱包，立即可用。
-
----
-
-## 准备工作
-
-在开始之前，请确保你已经有：
-
-1. **Node.js** >= 20.0.0（[下载链接](https://nodejs.org/)）
-2. **MCP 客户端**：所有支持 MCP 的 AI 客户端。
-
----
-
-## 安装
-
-最简单的安装方式是**直接在 AI Agent 对话框里让 AI 完成**——不用自己打开终端，不用手动复制文件。如果你已经在使用支持 shell 命令的 AI Agent（OpenClaw、Telegram Bot、Web 聊天页面、Claude Code、Cursor 等），这一步即可搞定。
-
-**操作步骤：**
-
-1. 打开你的 AI Agent 对话框
-2. 复制下面这段 prompt 发送给 AI：
-
-   ```
-   运行 npx add-mcp https://sun-mcp-server.bankofai.io/mcp -y 安装 SUN MCP Server。
-   注意：请安装到当前 Agent 对应的 MCP 配置中。
-   ```
-
-3. AI 会自动完成以下流程（无需人工干预）：
-   - 识别远程 MCP 服务地址
-   - 自动检测当前正在使用的 AI 客户端
-   - 把 `sun-mcp-server` 配置写入对应的 MCP 配置文件（无需手动改 JSON）
-   - 完成后给出 ✅ 确认信息
-
-AI 给出 ✅ 确认后，SUN MCP Server 就已就位，可以直接开始提问。
-
-:::tip 想用命令行？
-如果你更习惯自己跑命令或需要更精细的控制（比如手动选择要安装到哪些 AI 工具），请参阅[官方云服务接入](./OfficialServerAccess.md)里的命令行和交互式安装方式。
-:::
-
----
-
-## 试用一下
-
-在对话中尝试以下查询：
-
-```
-查一下 SunSwap 上 USDT 和 TRX 的当前价格
-```
-
-:::info 关于云服务
-我们提供的官方云服务是**只读的**，适合查询数据和分析。如果你需要执行链上交易、部署合约等写操作，请查看[本地私有化部署](./LocalPrivatizedDeployment.md)。
-:::
-
----
-
-## 继续探索
-
-以下是一些常见的 DeFi 查询示例：
-
-| 操作 | 示例提示 |
-|------|--------|
-| **价格查询** | 查询 USDT/TRX 的实时价格 |
-| **流动性池数据** | 获取 SunSwap 中 TRX-USDC 交易对的池信息 |
-| **头寸查询** | 查看地址 TR... 在 SunSwap 中的所有流动性头寸 |
-| **交易报价** | 获取交换 1000 USDT 为 TRX 的报价 |
-| **协议统计** | 获取 SunSwap 的 TVL、24 小时交易量等统计数据 |
-
----
-
-## 下一步
-
-- **[本地私有化部署](./LocalPrivatizedDeployment.md)** - 学习如何在本地运行 SUN MCP Server 并进行写操作
-- **[官方服务器访问](./OfficialServerAccess.md)** - 了解官方云服务的详细信息
-- **[完成能力清单](./ToolList.md)** - 查看所有可用的工具和功能
-
----
-
-祝你使用愉快！如有问题，欢迎反馈。
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/ToolList.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/ToolList.md
deleted file mode 100644
index d37f9254..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/MCP/SUNMCPServer/ToolList.md
+++ /dev/null
@@ -1,350 +0,0 @@
-# 完整能力清单
-
-SUN MCP Server 提供 **41 个工具**。
-
-## 先了解两个概念
-
-在浏览工具列表之前，有两件事需要知道：
-
-:::info 读取 vs 写入
-每个工具都标记了**模式**——"读取"或"写入"：
-
-- **读取工具**：只查询链上数据，不影响任何状态。在云服务和本地部署中均可使用。
-- **写入工具**：会修改区块链状态（转账、质押、合约调用等）。仅在本地部署且配置了钱包后才可使用。
-
-如果你没有配置钱包，写入工具不会出现在 AI 的可用工具列表中——它们会被自动隐藏，不用担心误触。
-:::
-
-:::tip network 参数
-大多数工具都有可选的 `network` 参数，用于指定交互的网络环境。默认使用主网配置，也可切换至测试网。
-:::
-
----
-
-## 自定义工具（共 18 个）
-
-### 钱包与余额
-
-| 工具名 | 功能描述 | 工具类型 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|---------|
-| `sunswap_get_wallet_address` | 获取当前活跃的 TRON 钱包地址 | 读取 | - | `network` |
-| `sunswap_get_balances` | 查询 TRX 和 TRC20 代币余额 | 读取 | `tokens` | `network`, `ownerAddress` |
-
-**试试这样说：**
-- "查询我的 TRON 钱包地址"
-- "查看我 USDT 和 SUNFLARE 的余额"
-- "获取我在测试网上的 TRX 余额"
-
----
-
-### 价格与报价
-
-| 工具名 | 功能描述 | 工具类型 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|---------|
-| `sunswap_get_token_price` | 获取代币价格（通过 SUN.IO API） | 读取 | `tokenAddress` 或 `symbol` | `network` |
-| `sunswap_quote_exact_input` | 精确输入金额的兑换报价（智能路由） | 读取 | `routerAddress`, `args` | `network`, `functionName`, `abi` |
-
-**试试这样说：**
-- "SUNFLARE 现在的价格是多少？"
-- "我想兑换 1000 USDT 换 SUNFLARE，会得到多少？"
-- "在测试网上查询 USDC 的当前价格"
-
----
-
-### 兑换
-
-| 工具名 | 功能描述 | 工具类型 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|---------|
-| `sunswap_swap` | 执行通用路由器兑换（支持自动路由 + Permit2） | 写入 | `tokenIn`, `tokenOut`, `amountIn` | `network`, `slippage` |
-| `sunswap_swap_exact_input` | 精确输入兑换（智能路由器） | 写入 | `routerAddress`, `args` | `network`, `functionName`, `value`, `abi` |
-
-**试试这样说：**
-- "我想用 500 USDT 兑换 SUNFLARE，滑点 1%"
-- "执行 1000 USDC 换 TRX 的交易"
-- "帮我兑换 SUNFLARE 到 USDT，尽量少于 2 秒内完成"
-
-:::caution 钱包要求
-兑换工具需要本地部署 SUN MCP Server 并配置钱包私钥。
-:::
-
----
-
-### V2 流动性
-
-| 工具名 | 功能描述 | 工具类型 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|---------|
-| `sunswap_v2_add_liquidity` | 添加 V2 流动性（自动 TRX/WTRX 处理） | 写入 | `routerAddress`, `tokenA`, `tokenB`, `amountADesired`, `amountBDesired` | `network`, `amountAMin`, `amountBMin`, `to`, `deadline`, `abi` |
-| `sunswap_v2_remove_liquidity` | 移除 V2 流动性 | 写入 | `routerAddress`, `tokenA`, `tokenB`, `liquidity` | `network`, `amountAMin`, `amountBMin`, `to`, `deadline`, `abi` |
-
-**试试这样说：**
-- "我想添加 1000 USDT 和等量的 SUNFLARE 到 V2 流动性池"
-- "移除我在 USDC-TRX 池中的 50% 流动性"
-- "添加 V2 流动性，USDT 最少 950，SUNFLARE 最少 9500"
-
-:::info 自动处理
-当配对涉及 TRX 时，工具会自动转换为 WTRX。
-:::
-
----
-
-### V3 流动性
-
-| 工具名 | 功能描述 | 工具类型 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|---------|
-| `sunswap_v3_mint_position` | 创建 V3 集中流动性头寸 | 写入 | `positionManagerAddress`, `token0`, `token1` | `network`, `fee`, `tickLower`, `tickUpper`, `amount0Desired`, `amount1Desired`, `amount0Min`, `amount1Min`, `recipient`, `deadline`, `abi` |
-| `sunswap_v3_increase_liquidity` | 增加 V3 流动性 | 写入 | `positionManagerAddress`, `tokenId` | `network`, `token0`, `token1`, `fee`, `amount0Desired`, `amount1Desired`, `amount0Min`, `amount1Min`, `deadline` |
-| `sunswap_v3_decrease_liquidity` | 减少 V3 流动性 | 写入 | `positionManagerAddress`, `tokenId`, `liquidity` | `network`, `token0`, `token1`, `fee`, `amount0Min`, `amount1Min`, `deadline` |
-| `sunswap_v3_collect` | 收取 V3 费用 | 写入 | `positionManagerAddress`, `tokenId` | `network`, `recipient`, `abi` |
-
-**试试这样说：**
-- "帮我在 USDT-SUNFLARE 的 V3 0.3% 费率池中创建流动性，范围 ±50 ticks"
-- "增加我的 V3 头寸 #12345，再添加 1000 USDT"
-- "从我的 V3 头寸中收取费用"
-- "减少 V3 头寸的流动性至 50%"
-
-:::tip 自动计算
-创建新头寸时，系统自动计算 tick 范围（±50×tickSpacing）和单边输入最优量。
-:::
-
----
-
-### V4 流动性
-
-| 工具名 | 功能描述 | 工具类型 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|---------|
-| `sunswap_v4_mint_position` | 创建 V4 头寸（支持 Permit2） | 写入 | `token0`, `token1` | `network`, `fee`, `tickLower`, `tickUpper`, `amount0Desired`, `amount1Desired`, `slippage`, `recipient`, `deadline`, `sqrtPriceX96`, `createPoolIfNeeded` |
-| `sunswap_v4_increase_liquidity` | 增加 V4 流动性（支持 Permit2） | 写入 | `tokenId`, `token0`, `token1` | `network`, `fee`, `amount0Desired`, `amount1Desired`, `slippage`, `deadline` |
-| `sunswap_v4_decrease_liquidity` | 减少 V4 流动性 | 写入 | `tokenId`, `liquidity`, `token0`, `token1` | `network`, `fee`, `amount0Min`, `amount1Min`, `slippage`, `deadline` |
-| `sunswap_v4_collect` | 收取 V4 费用 | 写入 | `tokenId` | `network`, `token0`, `token1`, `fee`, `deadline` |
-
-**试试这样说：**
-- "在 V4 中创建 USDC-SUNFLARE 的流动性头寸，滑点 5%"
-- "增加我的 V4 头寸 #67890，再注入 5000 USDC"
-- "从 V4 头寸中收取所有累积费用"
-- "减少 V4 流动性，确保滑点在 3% 以内"
-
-:::info Permit2 支持
-V4 工具原生支持 Permit2 签名授权，提升用户体验。
-:::
-
----
-
-### 合约交互
-
-| 工具名 | 功能描述 | 工具类型 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|---------|
-| `sunswap_read_contract` | 从 TRON 智能合约读取数据（view/pure） | 读取 | `address`, `functionName` | `network`, `args`, `abi` |
-| `sunswap_send_contract` | 发送状态改变的合约交易 | 写入 | `address`, `functionName` | `network`, `args`, `value`, `abi` |
-
-**试试这样说：**
-- "查询 SUNFLARE 合约的总供应量"
-- "读取我在流动性合约中的余额"
-- "调用合约函数更新矿池参数"
-- "向合约发送 0.1 TRX 并执行特定函数"
-
-:::caution ABI 要求
-若不提供 ABI，系统将尝试从 TronScan 获取合约 ABI。
-:::
-
----
-
-## SUN.IO OpenAPI 衍生工具（共 23 个）
-
-### 交易
-
-| 工具名 | 功能描述 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|
-| `scanTransactions` | 扫描 DEX 交易 | - | `protocol`, `token`, `pool`, `type`, `timeRange` |
-| `getFarmTransactions` | 扫描挖矿池交易 | `farmAddress` | - |
-
-**试试这样说：**
-- "查看 SUN 协议过去 24 小时的交易"
-- "查询 SUNFLARE-USDT 池的所有交易"
-- "获取最近 7 天的交易数据"
-
----
-
-### 代币
-
-| 工具名 | 功能描述 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|
-| `getTokens` | 按地址或协议获取代币 | - | `address`, `protocol` |
-| `searchTokens` | 模糊搜索代币 | `keyword` | - |
-| `getPrice` | 按地址获取代币价格 | `tokenAddress` | - |
-
-**试试这样说：**
-- "搜索 'SUNFLARE' 代币"
-- "获取地址 `TR7NHqjeKQxGTCi8q282JHJC8YXQFg...` 的代币信息"
-- "查询 USDT 在 SUN 协议中的价格"
-
----
-
-### 协议
-
-| 工具名 | 功能描述 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|
-| `getProtocol` | 协议快照数据 | - | - |
-| `getVolHistory` | 协议成交量历史 | - | - |
-| `getLiqHistory` | 协议流动性历史 | - | - |
-| `getUsersCountHistory` | 协议用户数历史 | - | - |
-| `getTransactionsHistory` | 协议交易数历史 | - | - |
-| `getPoolsCountHistory` | 协议矿池数历史 | - | - |
-
-**试试这样说：**
-- "获取 SUN 协议的最新快照"
-- "查看过去 30 天的成交量趋势"
-- "获取协议用户数增长情况"
-
----
-
-### 价格
-
-| 工具名 | 功能描述 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|
-| `getPrice` | 代币价格查询 | `tokenAddress` | - |
-
-**试试这样说：**
-- "获取 SUNFLARE 代币的实时价格"
-
----
-
-### 持仓
-
-| 工具名 | 功能描述 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|
-| `getUserPositions` | 用户流动性头寸 | `userAddress` | - |
-| `getPoolUserPositionTick` | 矿池用户 Tick 级别头寸详情 | `poolAddress`, `userAddress` | - |
-| `getFarmPositions` | 用户挖矿头寸 | `userAddress` | - |
-
-**试试这样说：**
-- "查看我所有的流动性头寸"
-- "获取我在 USDT-SUNFLARE 池中的 Tick 详情"
-- "查询我的挖矿收益头寸"
-
----
-
-### 池子
-
-| 工具名 | 功能描述 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|
-| `getPools` | 获取矿池 | - | `address`, `token`, `protocol` |
-| `searchPools` | 搜索矿池 | `keyword` | - |
-| `searchCountPools` | 矿池搜索计数 | `keyword` | - |
-| `getTopApyPoolList` | 获取最高 APY 矿池列表 | - | `limit`, `offset` |
-| `getPoolHooks` | 矿池钩子（Hooks） | `poolAddress` | - |
-| `getPoolVolHistory` | 矿池成交量历史 | `poolAddress` | - |
-| `getPoolLiqHistory` | 矿池流动性历史 | `poolAddress` | - |
-
-**试试这样说：**
-- "获取 SUNFLARE-USDT 池的详细信息"
-- "查找最高 APY 的前 10 个矿池"
-- "获取 USDC-TRX 池的成交量历史"
-- "查询矿池使用的所有 Hooks"
-
----
-
-### 交易对
-
-| 工具名 | 功能描述 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|
-| `getPairsFromEntity` | 代币交易对查询 | - | `token0`, `token1` |
-
-**试试这样说：**
-- "获取 SUNFLARE 和 USDT 之间的交易对信息"
-- "查询所有包含 USDC 的交易对"
-
----
-
-### 矿池
-
-| 工具名 | 功能描述 | 必需参数 | 可选参数 |
-|--------|---------|---------|---------|
-| `getFarms` | 挖矿池列表 | - | - |
-
-**试试这样说：**
-- "列出所有可用的挖矿池"
-- "查询当前的挖矿奖励情况"
-
----
-
-## 自动计算特性
-
-SUN MCP Server 的多个工具内置了智能自动计算功能，旨在简化用户交互：
-
-### V3 流动性自动计算
-
-**`sunswap_v3_mint_position` 自动特性：**
-
-| 特性 | 说明 | 使用场景 |
-|------|------|---------|
-| **默认费率** | 若未指定 `fee`，系统自动使用 `3000`（0.3%） | 快速创建标准流动性头寸 |
-| **Tick 范围计算** | 自动设置 `tickLower` 和 `tickUpper` 为 `±50 × tickSpacing` | 无需手动计算复杂数学，直接获得合理范围 |
-| **单边输入处理** | 可只指定一种代币金额，系统自动计算另一种代币所需金额 | 简化多币种流动性部署 |
-
-**示例：**
-```
-请求：在 USDT-SUNFLARE 池中创建 V3 头寸，注入 1000 USDT
-系统自动：
-  - 设定费率为 3000（0.3%）
-  - 计算 ±50 个 tick 范围
-  - 根据当前价格，计算所需 SUNFLARE 数量
-  - 一次性提交多币种授权和交易
-```
-
-### V4 流动性自动计算
-
-**`sunswap_v4_mint_position` 自动特性：**
-
-| 特性 | 说明 | 使用场景 |
-|------|------|---------|
-| **Tick 范围计算** | 自动设置 `tickLower` 和 `tickUpper` 为 `±100 × tickSpacing` | V4 更灵活的范围配置 |
-| **默认滑点** | 若未指定 `slippage`，系统自动使用 `5%` | 保护用户免受价格波动影响 |
-| **Permit2 授权** | 原生支持 Permit2 签名流程，无需多次批准 | 改善用户体验，一次签名完成所有授权 |
-| **动态池创建** | 若池不存在，`createPoolIfNeeded` 可自动创建新池 | 为新交易对快速建立流动性 |
-
-**示例：**
-```
-请求：在 V4 中创建 USDC-SUNFLARE 头寸，滑点 3%
-系统自动：
-  - 计算 ±100 个 tick 范围
-  - 使用 Permit2 签名授权
-  - 若池不存在，创建新池
-  - 根据当前价格计算最优输入比例
-```
-
-### 智能兑换路由
-
-**`sunswap_swap` 自动特性：**
-
-| 特性 | 说明 | 使用场景 |
-|------|------|---------|
-| **多路由优化** | 自动查找最优兑换路径，支持直接交易对及多跳路由 | 获取最佳价格 |
-| **Permit2 集成** | 无需预先批准代币，一次签名完成授权和兑换 | 改善用户流程 |
-
-**示例：**
-```
-请求：1000 USDT 换 SUNFLARE，滑点 1%
-系统自动：
-  - 评估直接 USDT-SUNFLARE 池
-  - 评估 USDT → 中间币 → SUNFLARE 路由
-  - 选择最优路径
-  - 使用 Permit2 一次签名完成授权和交易
-  - 确保滑点不超过 1%
-```
-
-### 关键参数说明
-
-| 参数 | 默认值 | 何时自动计算 |
-|------|--------|-----------|
-| `fee`（V3） | 3000 | 未提供时 |
-| `tickLower`, `tickUpper`（V3） | ±50×tickSpacing | 未提供时 |
-| `tickLower`, `tickUpper`（V4） | ±100×tickSpacing | 未提供时 |
-| `slippage`（V4） | 5% | 未提供时 |
-| 对方代币金额 | 根据当前价格计算 | 只指定一种代币时 |
-
-:::tip 最佳实践
-虽然大多数参数已自动计算，但在关键操作（如添加大额流动性）时，建议主动指定参数以获得更高的控制精度。
-:::
-
-
-
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/SKILLS/Intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/SKILLS/Intro.md
index 19e06ff5..82d867e6 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/SKILLS/Intro.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/SKILLS/Intro.md
@@ -57,111 +57,23 @@
 
 ## 目前 Skills 能帮你干什么？
 
-一共 14 个技能——覆盖 TRON 生态最常用的场景以及 X/Twitter 工具，外加一个专属的引导辅助技能。每个技能都配了一句"参考话术"——复制到 AI 对话框里回车就能体验。
-
-### 🔑 安全钱包管理
-
-创建加密钱包、签名交易和消息、管理多个钱包——全程不暴露你的私钥。这是其他交易和支付技能的底层依赖。同时支持 EVM（BSC、Ethereum、Polygon 等）和 TRON 网络。
-
-> 🗣️ "帮我创建一个新的 agent 钱包" 或 "帮我列出所有钱包和它们的地址。"
-
-💡 如需了解设置与进阶用法，请查看：[**agent-wallet**](./BANKOFAISkill.md#agent-wallet)
-
-### 💱 执行 DEX 交易
-
-查价格、比报价、甚至一键换币。
-
-> 🗣️ "帮我算算现在 100 USDT 在 SunSwap 上能换多少 TRX？"
-
-💡 如需了解更多进阶玩法，请查看：[**sunswap**](./BANKOFAISkill.md#sunswap)
-
-### 🚀 玩转 SunPump meme 币：发币 + 交易
-
-一句话发行自己的 meme 币，在 TRON 的 meme 代币发射台 SunPump 上买卖、查行情。发币在**服务端完成，无需钱包**——给出名称、符号、描述和 logo 即可。交易时 AI 会自动判断该走哪条路：还没在 SunSwap V2 上创建交易对的「发射前」代币在 SunPump 上买卖，已在 SunSwap V2 建好交易对的「发射后」代币走普通兑换。还能查代币详情、排行榜、持有人分布和钱包持仓。**sunpump-agent-skill 的所有功能都只支持 TRON 主网**。
-
-> 🗣️ "帮我在 SunPump 上发一个 meme 币，名称、符号、描述和 logo 我发给你。" 或 "帮我看看 SunPump 上 24 小时涨幅前 10 的 meme 币，再查一下第一名的持有人集中度。"
-
-💡 如需了解交易与风控细节，请查看：[**sunpump-agent-skill**](./BANKOFAISkill.md#sunpump-agent-skill)
-
-### 📈 进行永续合约交易
-
-在 SunPerp 看行情、开平仓。内置安全锁：最高只允许 20 倍杠杆（可在配置里调整），且每次开仓都**强制带止损**——没指定时默认设在距开仓价 5% 的位置，超过 25% 会被直接拒绝。帮你管住手，防爆仓。
-
-> 🗣️ "现在 BTC 资金费率是多少？帮我开一张 5 倍杠杆的多单，亏损 5% 自动止损。"
-
-💡 如需了解更多参数设置，请查看：[**sunperp-skill**](./BANKOFAISkill.md#sunperp-skill)
-
-### 🕵️ 查询链上数据
-
-查账户、查交易、查新币靠不靠谱。纯查询，绝对安全，不花一分钱。
-
-> 🗣️ "帮我查一下昨天那个土狗币现在的持仓分布，有没有被庄家控盘？"
-
-💡 如需了解更多查询维度，请查看：[**tronscan-skill**](./BANKOFAISkill.md#tronscan-skill)
-
-### 💸 转账与管理 TRC20 代币
-
-查余额、转代币、管理授权——支持 USDT、USDD、SUN 等常见代币，也能通过合约地址操作任意 TRC20 代币。支持批量查余额。
-
-> 🗣️ "帮我查一下 USDT、USDD 和 SUN 的余额，然后转 10 USDT 到 TRecipientAddress。"
-
-💡 如需了解更多代币操作，请查看：[**trc20-toolkit-skill**](./BANKOFAISkill.md#trc20-toolkit-skill)
-
-### 💵 USDD 稳定币与 JUST 协议
-
-通过 PSM（Peg Stability Module）进行 1:1 的 USDT ↔ USDD 兑换（目前零手续费），查看 USDD/USDT/USDC/TRX/JST 余额，以及查询金库（CDP）仓位和协议参数。
-
-> 🗣️ "帮我通过 PSM 用 1000 USDT 换成 USDD" 或 "帮我列出所有 USDD 金库类型和它们的稳定费率。"
-
-💡 如需了解 PSM 兑换和金库查询，请查看：[**usdd-skill**](./BANKOFAISkill.md#usdd-skill)
-
-### 🗳️ TRX 质押与超级代表投票
-
-质押 TRX 换取 TRON Power，给超级代表投票，领取投票奖励。兼容 Stake 2.0——得票前 27 名的超级代表每 6 小时按得票比例分配区块奖励给投票人。
-
-> 🗣️ "查一下我的 TRON Power 和当前投票情况，然后列出前 10 名超级代表。" 或 "帮我领取待结算的投票奖励。"
-
-💡 如需了解质押、投票与奖励流程，请查看：[**trx-staking-skill**](./BANKOFAISkill.md#trx-staking-skill)
-
-### 🔐 多签与账户权限管理
-
-给你的 TRON 账户加上多重签名保护——配置密钥、设定阈值、协调多方共签。非常适合团队钱包，或者限制 AI 只能执行 DeFi 操作。
-
-> 🗣️ "帮我查一下账户当前的权限配置，然后给 owner 权限设置 2-of-3 多签。"
-
-💡 如需了解权限模板和多签流程，请查看：[**multisig-permissions**](./BANKOFAISkill.md#multisig-permissions)
-
-### ☕ 自动结算链上付费服务
-
-当 AI 需要调用付费的链上服务或数据接口时，会通过 x402 协议自动完成"先付费、再获取"的链上结算，无需你手动扫码或切换钱包。支持多条链付款：TRON（TRC20：USDT、USDD，含 GasFree）和 BSC（ERC20：USDT、USDC）都能用，切 `--network` 参数即可。
-
-> 🗣️ "使用 x402 协议调用这个付费智能体端点：https://api.example.com"（请替换为你实际要调用的付费端点地址）
-
-💡 如需了解支付与授权细节，请查看：[**x402-payment**](./BANKOFAISkill.md#x402-payment)
-
-### 🏦 管理 BANK OF AI 账户
-
-查看你的 BANK OF AI 余额，一句话完成充值。
-
-> 🗣️ "帮我看看我的账户还有多少余额，顺便再充 5 个 U 进去。"
-
-💡 如需了解充值与提现规则，请查看：[**recharge-skill**](./BANKOFAISkill.md#recharge-skill)
-
-### 🐦 X/Twitter 每日日报
-
-把你自己的 X/Twitter 账号变成每日简报——提及、主页时间线与可回复机会，一并帮你汇总。
-
-> 🗣️ "生成我账号今天的 X/Twitter 日报。"
-
-💡 两种运行方式：纯 API 的 [**twitter-digest**](./BANKOFAISkill.md#twitter-digest)，或基于本地 `xurl` CLI 的 [**twitter-mcp**](./BANKOFAISkill.md#twitter-mcp)。
-
-### 🧭 引导辅助（bankofai-guide）
-
-一个轻量的辅助技能，负责跑完安装后的首次上手流程、帮你创建第一个 AgentWallet，并在任何链上操作之前充当"钱包守门员"——如果还没配钱包会提醒你先配一个。你通常不需要主动调用它，安装器和其他技能会在需要时自动把它唤醒。
-
-> 🗣️ "带我走一遍 BANK OF AI 的新手引导。" 或 "运行 bankofai-guide，帮我配第一个钱包。"
-
-💡 如需了解完整的引导流程，请查看：[**bankofai-guide**](./BANKOFAISkill.md#bankofai-guide)
+一共 14 个技能，覆盖 TRON 生态最常用的场景与 X/Twitter 工具。下表一眼看全：每个技能配一句"参考话术"，复制进 AI 对话框回车就能体验；点技能名查看完整文档。
+
+| 技能 | 一句话能干嘛 | 试试这句话 |
+| :-- | :-- | :-- |
+| 🔑 [agent-wallet](./BANKOFAISkill.md#agent-wallet) | 创建/管理加密钱包、签名交易，私钥全程不暴露；其它技能的底层依赖（EVM + TRON） | "帮我创建一个新的 agent 钱包" |
+| 💱 [sunswap](./BANKOFAISkill.md#sunswap) | 查价格、比报价、一键换币 | "100 USDT 在 SunSwap 能换多少 TRX？" |
+| 🚀 [sunpump-agent-skill](./BANKOFAISkill.md#sunpump-agent-skill) | 一句话发 meme 币、SunPump 买卖与行情（仅 TRON 主网；发币无需钱包） | "帮我在 SunPump 上发一个 meme 币" |
+| 📈 [sunperp-skill](./BANKOFAISkill.md#sunperp-skill) | SunPerp 永续合约看行情、开平仓；内置风控：≤20 倍杠杆、强制止损 | "开一张 5 倍多单，亏 5% 自动止损" |
+| 🕵️ [tronscan-skill](./BANKOFAISkill.md#tronscan-skill) | 查账户、交易、代币安全；纯查询零风险、不花钱 | "查查这个币有没有被庄家控盘" |
+| 💸 [trc20-toolkit-skill](./BANKOFAISkill.md#trc20-toolkit-skill) | TRC20 查余额、转账、管理授权，支持批量与任意合约地址 | "转 10 USDT 到 TRecipientAddress" |
+| 💵 [usdd-skill](./BANKOFAISkill.md#usdd-skill) | PSM 1:1 兑换 USDT↔USDD（现零手续费）、查金库（CDP）仓位 | "用 1000 USDT 通过 PSM 换成 USDD" |
+| 🗳️ [trx-staking-skill](./BANKOFAISkill.md#trx-staking-skill) | 质押 TRX、给超级代表投票、领奖励（Stake 2.0） | "帮我领取待结算的投票奖励" |
+| 🔐 [multisig-permissions](./BANKOFAISkill.md#multisig-permissions) | 账户多签与权限管理，适合团队钱包或限制 AI 权限 | "给 owner 权限设置 2-of-3 多签" |
+| ☕ [x402-payment](./BANKOFAISkill.md#x402-payment) | 调用付费接口时经 x402 自动"先付费再获取"（TRON / BSC 多链） | "用 x402 调用这个付费端点：https://…" |
+| 🏦 [recharge-skill](./BANKOFAISkill.md#recharge-skill) | 查 BANK OF AI 余额、一句话充值 | "查下余额，顺便再充 5 个 U" |
+| 🐦 [twitter-digest](./BANKOFAISkill.md#twitter-digest) / [twitter-mcp](./BANKOFAISkill.md#twitter-mcp) | 你的 X/Twitter 每日简报：提及、时间线、可回复机会 | "生成我账号今天的 X 日报" |
+| 🧭 [bankofai-guide](./BANKOFAISkill.md#bankofai-guide) | 新手引导 + "钱包守门员"，通常由安装器自动唤醒 | "带我走一遍新手引导" |
 
 ---
 
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/CommandGuide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/CommandGuide.md
deleted file mode 100644
index aebc6fb4..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/CommandGuide.md
+++ /dev/null
@@ -1,1188 +0,0 @@
-# 完整能力清单
-
-本页是 SUN CLI 所有命令的完整参考。命令按类别组织：钱包管理、价格、代币、兑换、池子、流动性、持仓、交易对、矿池、协议、交易、合约和 SunPump。
-
-> 说明：`<arg>` = 必需参数，`[arg]` = 可选参数。
-> 标注 **(必需)** 的选项必须提供，其余均为可选。
-
----
-
-## 全局标志
-
-所有命令都继承以下根级标志。**根级标志必须放在子命令之前。**
-
-| 标志 | 描述 |
-| :--- | :--- |
-| `--output <format>` | 输出格式：`table`、`json`、`tsv` |
-| `--json` | JSON 输出的快捷方式 |
-| `--fields <list>` | 逗号分隔的输出字段过滤 |
-| `--network <network>` | 覆盖 `TRON_NETWORK`（如 `mainnet`、`nile`、`shasta`） |
-| `-k, --private-key <key>` | 仅为本次调用提供私钥 |
-| `-m, --mnemonic <phrase>` | 仅为本次调用提供助记词 |
-| `-i, --mnemonic-account-index <index>` | 仅为本次调用提供助记词账户索引 |
-| `-p, --agent-wallet-password <password>` | 覆盖本次调用的 `AGENT_WALLET_PASSWORD` |
-| `-d, --agent-wallet-dir <dir>` | 覆盖本次调用的 `AGENT_WALLET_DIR` |
-| `-y, --yes` | 跳过确认提示 |
-| `--dry-run` | 预览操作意图而不发送交易 |
-
-:::caution 私钥安全
-`-k` / `--private-key` 和 `-m` / `--mnemonic` 标志会将敏感信息作为命令行参数传递，
-可能被记录在 shell 历史和进程列表中。请优先使用环境变量（`AGENT_WALLET_PRIVATE_KEY`、
-`AGENT_WALLET_MNEMONIC`）或 [agent-wallet](https://github.com/BofAI/agent-wallet)
-加密存储来管理所有非临时密钥。
-:::
-
-**示例：**
-
-```bash
-sun --json price TRX
-```
-
-```bash
-sun --output tsv pool top-apy --page-size 10
-```
-
-```bash
-sun --fields address,network wallet address
-```
-
-```bash
-sun -p your_agent_wallet_password wallet address
-```
-
-```bash
-sun -k your_private_key --network nile --yes swap TRX USDT 1000000
-```
-
-```bash
-sun --dry-run contract send TContract transfer --args '["TRecipient","1000000"]'
-```
-
----
-
-## 钱包与持仓
-
-### `wallet address`（读取）
-
-显示已配置的钱包地址。
-
-```bash
-sun wallet address
-```
-
-### `wallet balances`（读取）
-
-查询钱包代币余额。
-
-```bash
-sun wallet balances [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--owner <address>` | 要查询的钱包地址 | 当前钱包 |
-| `--tokens <tokens>` | 逗号分隔的代币列表：`TRX,<TRC20地址>,...` | `TRX` |
-
----
-
-## 价格
-
-### `price [token]`（读取）
-
-从 SUN.IO 获取代币价格。接受内置符号或地址。
-
-```bash
-sun price [token] [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--address <addresses>` | 逗号分隔的代币合约地址 | — |
-
-```bash
-sun price TRX
-```
-
-```bash
-sun price USDT
-```
-
-```bash
-sun price --address TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
-```
-
----
-
-## 代币
-
-### `token list`（读取）
-
-按地址或协议获取代币列表。
-
-```bash
-sun token list [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--address <tokenAddress>` | 按代币合约地址过滤 | — |
-| `--protocol <protocol>` | 协议过滤（V2、V3、V4） | — |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-| `--sort <field>` | 排序字段 | — |
-| `--no-blacklist` | 包含黑名单代币 | `false` |
-
-### `token search <keyword>`（读取）
-
-按名称或符号模糊搜索代币。
-
-```bash
-sun token search <keyword> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | 协议过滤 | — |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-
----
-
-## 兑换
-
-:::caution 金额精度 —— `<amountIn>` 是按代币 `decimals` 整数缩放后的值
-所有 `<amountIn>`（以及下面流动性命令里的 `--amount*` 参数）= 人类可读金额 × `10^decimals`，**不带小数点，也不会自动换算**。
-
-- TRX、USDT（TRC20）、WTRX、USDCOLD、WIN —— **精度 6** → `1` 个代币 = `1000000`
-- USDD、SUN、JST、BTT、USDDOLD —— **精度 18** → `1` 个代币 = `1000000000000000000`
-
-所以 `sun swap TRX USDT 1000000` 是**用 1 个 TRX**（不是 100 万个）兑换 USDT。
-:::
-
-### `swap <tokenIn> <tokenOut> <amountIn>`（写入）
-
-通过 SunSwap Universal Router 执行代币兑换。
-
-```bash
-sun swap <tokenIn> <tokenOut> <amountIn> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--slippage <n>` | 滑点容差，小数表示（如 0.005 = 0.5%） | `0.005` |
-
-```bash
-# 用 1 个 TRX 兑换 USDT
-sun swap TRX USDT 1000000
-```
-
-```bash
-# 同样的兑换，滑点容差 1%
-sun swap TRX USDT 1000000 --slippage 0.01
-```
-
-### `swap:quote <tokenIn> <tokenOut> <amountIn>`（读取）
-
-获取兑换报价，不执行交易。
-
-```bash
-sun swap:quote <tokenIn> <tokenOut> <amountIn> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--all` | 显示所有可用路径 | `false` |
-
-```bash
-# 报价：用 1 个 TRX 兑换 USDT
-sun swap:quote TRX USDT 1000000
-```
-
-```bash
-sun swap:quote TRX USDT 1000000 --all
-```
-
-### `swap:quote-raw`（读取）
-
-低级路由报价调用。
-
-```bash
-sun swap:quote-raw [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--router <address>` | **（必需）** 智能路由合约地址 | — |
-| `--fn <name>` | 报价函数名称 | `quoteExactInput` |
-| `--args <json>` | **（必需）** JSON 数组格式的参数 | — |
-| `--abi <json>` | 路由 ABI，JSON 数组格式 | — |
-
-### `swap:exact-input`（写入）
-
-低级路由兑换执行。
-
-```bash
-sun swap:exact-input [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--router <address>` | **（必需）** 智能路由合约地址 | — |
-| `--fn <name>` | 兑换函数名称 | `swapExactInput` |
-| `--args <json>` | **（必需）** JSON 数组格式的参数 | — |
-| `--value <sun>` | TRX 调用值（Sun 为单位） | — |
-| `--abi <json>` | 路由 ABI，JSON 数组格式 | — |
-
----
-
-## 池子
-
-### `pool list`（读取）
-
-列出池子，支持多种过滤条件。
-
-```bash
-sun pool list [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--address <poolAddress>` | 按池子地址过滤 | — |
-| `--token <tokenOrAddress>` | 按代币过滤（符号或地址） | — |
-| `--protocol <protocol>` | 协议过滤（V2、V3、V4） | — |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-| `--sort <field>` | 排序字段 | — |
-| `--no-blacklist` | 包含黑名单池子 | `false` |
-
-### `pool search <keyword>`（读取）
-
-按关键词搜索池子。
-
-```bash
-sun pool search <keyword> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | 协议过滤 | — |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-
-### `pool top-apy`（读取）
-
-按 APY 排行列出池子。
-
-```bash
-sun pool top-apy [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | 协议过滤 | — |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-
-### `pool hooks`（读取）
-
-列出已注册的池子 hooks。
-
-```bash
-sun pool hooks
-```
-
-### `pool vol-history <poolAddress>`（读取）
-
-查询池子在指定日期范围内的交易量历史。
-
-```bash
-sun pool vol-history <poolAddress> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--start <date>` | 开始日期（YYYY-MM-DD） | — |
-| `--end <date>` | 结束日期（YYYY-MM-DD） | — |
-
-### `pool liq-history <poolAddress>`（读取）
-
-查询池子在指定日期范围内的流动性历史。
-
-```bash
-sun pool liq-history <poolAddress> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--start <date>` | 开始日期（YYYY-MM-DD） | — |
-| `--end <date>` | 结束日期（YYYY-MM-DD） | — |
-
----
-
-## 流动性
-
-### `liquidity v2:add`（写入）
-
-添加 V2 流动性。路由地址根据网络自动检测。
-
-```bash
-sun liquidity v2:add [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token-a <tokenOrSymbol>` | **（必需）** 代币 A（符号或地址） | — |
-| `--token-b <tokenOrSymbol>` | **（必需）** 代币 B（符号或地址） | — |
-| `--amount-a <raw>` | 代币 A 数量（原始单位） | — |
-| `--amount-b <raw>` | 代币 B 数量（原始单位） | — |
-| `--min-a <raw>` | 代币 A 最小数量 | — |
-| `--min-b <raw>` | 代币 B 最小数量 | — |
-| `--router <address>` | V2 路由地址 | 根据网络自动检测 |
-| `--to <address>` | LP 代币接收地址 | 当前钱包 |
-| `--deadline <timestamp>` | 交易截止时间 | — |
-| `--abi <json>` | 自定义路由 ABI | — |
-
-> 至少提供 `--amount-a` 或 `--amount-b` 之一。只提供一个时，另一个会根据池子储备自动计算。
-
-创建流动性池（需要输入两个代币数量）：
-
-```bash
-sun liquidity v2:add --token-a TRX --token-b USDT --amount-a 1000000 --amount-b 290000
-```
-
-向已有池子添加流动性（另一个代币数量会自动计算）：
-
-```bash
-sun liquidity v2:add --token-a TRX --token-b USDT --amount-a 1000000
-```
-
-### `liquidity v2:remove`（写入）
-
-移除 V2 流动性。
-
-```bash
-sun liquidity v2:remove [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token-a <tokenOrSymbol>` | **（必需）** 代币 A | — |
-| `--token-b <tokenOrSymbol>` | **（必需）** 代币 B | — |
-| `--liquidity <raw>` | **（必需）** 要移除的 LP 代币数量 | — |
-| `--min-a <raw>` | 代币 A 最小数量 | — |
-| `--min-b <raw>` | 代币 B 最小数量 | — |
-| `--router <address>` | V2 路由地址 | 根据网络自动检测 |
-| `--to <address>` | 代币接收地址 | 当前钱包 |
-| `--deadline <timestamp>` | 交易截止时间 | — |
-| `--abi <json>` | 自定义路由 ABI | — |
-
-```bash
-sun liquidity v2:remove --token-a TRX --token-b USDT --liquidity 500000
-```
-
-### `liquidity v3:mint`（写入）
-
-创建 V3 集中流动性仓位。Position Manager 根据网络自动检测。
-
-```bash
-sun liquidity v3:mint [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token0 <tokenOrSymbol>` | **（必需）** 代币 0（符号或地址） | — |
-| `--token1 <tokenOrSymbol>` | **（必需）** 代币 1（符号或地址） | — |
-| `--fee <n>` | 池子手续费等级 | `3000` |
-| `--tick-lower <n>` | 下界 tick | 自动 |
-| `--tick-upper <n>` | 上界 tick | 自动 |
-| `--amount0 <raw>` | 代币 0 数量 | — |
-| `--amount1 <raw>` | 代币 1 数量 | — |
-| `--min0 <raw>` | 代币 0 最小数量 | — |
-| `--min1 <raw>` | 代币 1 最小数量 | — |
-| `--pm <address>` | Position Manager 地址 | 根据网络自动检测 |
-| `--recipient <address>` | NFT 接收地址 | 当前钱包 |
-| `--deadline <timestamp>` | 交易截止时间 | — |
-| `--abi <json>` | 自定义 ABI | — |
-
-> 至少提供 `--amount0` 或 `--amount1` 之一。只提供一个时，另一个会自动计算。TRX 在 V3 池子查找时会自动转换为 WTRX。
-
-```bash
-sun liquidity v3:mint --token0 TRX --token1 USDT --amount0 1000000
-```
-
-### `liquidity v3:increase`（写入）
-
-增加已有 V3 仓位的流动性。
-
-```bash
-sun liquidity v3:increase [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **（必需）** 仓位 NFT 代币 ID | — |
-| `--amount0 <raw>` | 代币 0 数量 | — |
-| `--amount1 <raw>` | 代币 1 数量 | — |
-| `--min0 <raw>` | 代币 0 最小数量 | — |
-| `--min1 <raw>` | 代币 1 最小数量 | — |
-| `--token0 <tokenOrSymbol>` | 代币 0（单边自动计算时需要） | — |
-| `--token1 <tokenOrSymbol>` | 代币 1（单边自动计算时需要） | — |
-| `--fee <n>` | 池子手续费（单边自动计算时需要） | `3000` |
-| `--pm <address>` | Position Manager 地址 | 根据网络自动检测 |
-| `--deadline <timestamp>` | 交易截止时间 | — |
-| `--abi <json>` | 自定义 ABI | — |
-
-> 只提供一个数量时，需要同时指定 `--token0`、`--token1` 和 `--fee` 以进行自动计算。
-
-```bash
-sun liquidity v3:increase --token-id 123 --amount0 500000
-```
-
-### `liquidity v3:decrease`（写入）
-
-减少已有 V3 仓位的流动性。
-
-```bash
-sun liquidity v3:decrease [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **（必需）** 仓位 NFT 代币 ID | — |
-| `--liquidity <raw>` | **（必需）** 要移除的流动性数量 | — |
-| `--min0 <raw>` | 代币 0 最小数量 | — |
-| `--min1 <raw>` | 代币 1 最小数量 | — |
-| `--pm <address>` | Position Manager 地址 | 根据网络自动检测 |
-| `--deadline <timestamp>` | 交易截止时间 | — |
-| `--abi <json>` | 自定义 ABI | — |
-
-```bash
-sun liquidity v3:decrease --token-id 123 --liquidity 1000
-```
-
-### `liquidity v3:collect`（写入）
-
-领取 V3 仓位累积的手续费。
-
-```bash
-sun liquidity v3:collect [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **（必需）** 仓位 NFT 代币 ID | — |
-| `--recipient <address>` | 手续费接收地址 | 当前钱包 |
-| `--pm <address>` | Position Manager 地址 | 根据网络自动检测 |
-| `--abi <json>` | 自定义 ABI | — |
-
-```bash
-sun liquidity v3:collect --token-id 123
-```
-
-### `liquidity v4:mint`（写入）
-
-创建 V4 集中流动性仓位。
-
-```bash
-sun liquidity v4:mint [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token0 <tokenOrSymbol>` | **（必需）** 代币 0 | — |
-| `--token1 <tokenOrSymbol>` | **（必需）** 代币 1 | — |
-| `--fee <n>` | 池子手续费等级 | — |
-| `--tick-lower <n>` | 下界 tick | 自动 |
-| `--tick-upper <n>` | 上界 tick | 自动 |
-| `--amount0 <raw>` | 代币 0 数量 | — |
-| `--amount1 <raw>` | 代币 1 数量 | — |
-| `--slippage <n>` | 滑点容差 | — |
-| `--sqrt-price <value>` | 初始 sqrtPriceX96（用于创建池子） | — |
-| `--create-pool` | 如果池子不存在则创建 | `false` |
-| `--recipient <address>` | NFT 接收地址 | 当前钱包 |
-| `--deadline <timestamp>` | 交易截止时间 | — |
-
-在已有池子中创建仓位：
-
-```bash
-sun liquidity v4:mint --token0 TRX --token1 USDT --amount0 1000000
-```
-
-池子不存在时先创建池子，再创建仓位：
-
-```bash
-sun liquidity v4:mint --token0 TRX --token1 USDT --amount0 1000000 --create-pool
-```
-
-### `liquidity v4:increase`（写入）
-
-增加已有 V4 仓位的流动性。
-
-```bash
-sun liquidity v4:increase [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **（必需）** 仓位 NFT 代币 ID | — |
-| `--token0 <tokenOrSymbol>` | **（必需）** 代币 0 | — |
-| `--token1 <tokenOrSymbol>` | **（必需）** 代币 1 | — |
-| `--fee <n>` | 池子手续费等级 | — |
-| `--amount0 <raw>` | 代币 0 数量 | — |
-| `--amount1 <raw>` | 代币 1 数量 | — |
-| `--slippage <n>` | 滑点容差 | — |
-| `--deadline <timestamp>` | 交易截止时间 | — |
-
-```bash
-sun liquidity v4:increase --token-id 123 --token0 TRX --token1 USDT --amount0 500000
-```
-
-### `liquidity v4:decrease`（写入）
-
-减少已有 V4 仓位的流动性。
-
-```bash
-sun liquidity v4:decrease [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **（必需）** 仓位 NFT 代币 ID | — |
-| `--liquidity <raw>` | **（必需）** 要移除的流动性数量 | — |
-| `--token0 <tokenOrSymbol>` | **（必需）** 代币 0 | — |
-| `--token1 <tokenOrSymbol>` | **（必需）** 代币 1 | — |
-| `--fee <n>` | 池子手续费等级 | — |
-| `--min0 <raw>` | 代币 0 最小数量 | — |
-| `--min1 <raw>` | 代币 1 最小数量 | — |
-| `--slippage <n>` | 滑点容差 | — |
-| `--deadline <timestamp>` | 交易截止时间 | — |
-
-```bash
-sun liquidity v4:decrease --token-id 123 --liquidity 1000 --token0 TRX --token1 USDT
-```
-
-### `liquidity v4:collect`（写入）
-
-领取 V4 仓位累积的手续费。
-
-```bash
-sun liquidity v4:collect [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token-id <id>` | **（必需）** 仓位 NFT 代币 ID | — |
-| `--token0 <tokenOrSymbol>` | 代币 0 | — |
-| `--token1 <tokenOrSymbol>` | 代币 1 | — |
-| `--fee <n>` | 池子手续费等级 | — |
-| `--deadline <timestamp>` | 交易截止时间 | — |
-
-```bash
-sun liquidity v4:collect --token-id 123
-```
-
-### `liquidity v4:info`（读取）
-
-查询 V4 仓位详情。
-
-```bash
-sun liquidity v4:info [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--pm <address>` | **（必需）** Position Manager 地址 | — |
-| `--token-id <id>` | **（必需）** 仓位 NFT 代币 ID | — |
-
-```bash
-sun liquidity v4:info --pm <positionManager> --token-id 123
-```
-
----
-
-## 持仓
-
-### `position list`（读取）
-
-查看流动性仓位列表。
-
-```bash
-sun position list [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--owner <address>` | 所有者钱包地址 | — |
-| `--pool <poolAddress>` | 按池子过滤 | — |
-| `--protocol <protocol>` | 协议过滤（V2、V3、V4） | — |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-
-### `position tick <poolAddress>`（读取）
-
-查询指定池子的 tick 数据。
-
-```bash
-sun position tick <poolAddress> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-
----
-
-## 交易对
-
-### `pair info`（读取）
-
-获取代币的交易对信息。
-
-```bash
-sun pair info [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--token <tokenAddress>` | 代币合约地址 | — |
-| `--protocol <protocol>` | 协议过滤 | — |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-
----
-
-## 矿池
-
-### `farm list`（读取）
-
-列出收益矿池。
-
-```bash
-sun farm list [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--farm <farmAddress>` | 按矿池地址过滤 | — |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-
-### `farm tx`（读取）
-
-查看矿池交易历史。
-
-```bash
-sun farm tx [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--owner <address>` | 所有者地址 | — |
-| `--farm <farmAddress>` | 按矿池过滤 | — |
-| `--type <farmTxType>` | 交易类型 | — |
-| `--start <time>` | 开始时间（ISO 或 unix 毫秒） | — |
-| `--end <time>` | 结束时间 | — |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-
-### `farm positions`（读取）
-
-查看矿池持仓。
-
-```bash
-sun farm positions [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--owner <address>` | 所有者地址 | — |
-| `--farm <farmAddress>` | 按矿池过滤 | — |
-| `--page <n>` | 页码 | `1` |
-| `--page-size <n>` | 每页数量 | `20` |
-
----
-
-## 协议
-
-### `protocol info`（读取）
-
-```bash
-sun protocol info [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | 协议过滤 | — |
-
-### `protocol vol-history`（读取）
-
-```bash
-sun protocol vol-history [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | 协议过滤 | — |
-| `--start <date>` | 开始日期（YYYY-MM-DD） | — |
-| `--end <date>` | 结束日期（YYYY-MM-DD） | — |
-
-### `protocol users-history`（读取）
-
-```bash
-sun protocol users-history [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | 协议过滤 | — |
-| `--start <date>` | 开始日期 | — |
-| `--end <date>` | 结束日期 | — |
-
-### `protocol tx-history`（读取）
-
-```bash
-sun protocol tx-history [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | 协议过滤 | — |
-| `--start <date>` | 开始日期 | — |
-| `--end <date>` | 结束日期 | — |
-
-### `protocol pools-history`（读取）
-
-```bash
-sun protocol pools-history [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | 协议过滤 | — |
-| `--start <date>` | 开始日期 | — |
-| `--end <date>` | 结束日期 | — |
-
-### `protocol liq-history`（读取）
-
-```bash
-sun protocol liq-history [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | 协议过滤 | — |
-| `--start <date>` | 开始日期 | — |
-| `--end <date>` | 结束日期 | — |
-
----
-
-## 交易扫描
-
-### `tx scan`（读取）
-
-扫描链上交易历史。
-
-```bash
-sun tx scan [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--protocol <protocol>` | 协议过滤 | — |
-| `--token <tokenAddress>` | 按代币地址过滤 | — |
-| `--pool <poolAddress>` | 按池子地址过滤 | — |
-| `--type <type>` | 交易类型：`swap`、`add`、`withdraw` | — |
-| `--start <time>` | 开始时间（ISO 或 unix 毫秒） | — |
-| `--end <time>` | 结束时间 | — |
-| `--page-size <n>` | 每页数量 | `20` |
-| `--offset <offset>` | 分页偏移量 | — |
-
----
-
-## 合约
-
-### `contract read <address> <functionName>`（读取）
-
-读取任意 TRON 智能合约。
-
-```bash
-sun contract read <address> <functionName> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--args <json>` | JSON 数组格式的参数 | `[]` |
-| `--abi <json>` | 合约 ABI，JSON 数组格式 | — |
-
-```bash
-sun contract read TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t balanceOf --args '["TYourAddress"]'
-```
-
-### `contract send <address> <functionName>`（写入）
-
-向任意 TRON 智能合约发送交易。
-
-```bash
-sun contract send <address> <functionName> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--args <json>` | JSON 数组格式的参数 | `[]` |
-| `--value <sun>` | TRX 调用值（Sun 为单位） | — |
-| `--abi <json>` | 合约 ABI，JSON 数组格式 | — |
-
-```bash
-sun contract send TRecipient transfer --args '["TRecipient","1000000"]' --value 0
-```
-
-`contract send` 交易广播成功后会返回 `tronscanUrl` 链接。
-
----
-
-## SunPump
-
-SunPump 是 TRON 上的 meme 代币发射平台。本命令组覆盖代币发现（行情、排行、持有人、钱包持仓、交易历史）、一键发币（`launch`）以及发射前交易。
-
-> **关于 Bonding Curve：** Bonding Curve 是代币的发射进度条——随着社区参与和买入增加，meme 币市值逐步增长，进度最高涨到 100%；满 100% 后会自动在 SunSwap V2 上创建交易对，代币就「发射」了。进度未满 100% 的「发射前」代币用 `sun sunpump buy/sell` 在 SunPump 上交易；发射后改用 [`sun swap`](#兑换)。
-
-:::caution SunPump 仅支持 TRON 主网
-所有 `sunpump` 子命令只在 TRON 主网可用。API 端点为 `https://api-v2.sunpump.meme/pump-api`，链上 Bonding Curve 合约为 `TTfvyrAz86hbZk5iDpKD78pqLGgi8C7AAw`。传入 `--network nile`（或任何非 mainnet 值）会立即报错 `SunPump is only available on mainnet`。去掉 `--network` 或显式传 `--network mainnet` 即可。
-:::
-
-:::tip 发射前 vs 发射后 —— 选对交易命令
-- **发射前（Bonding Curve 进度未满 100%、还没在 SunSwap V2 上创建交易对）：** `tokenLaunchedInstant` 为 `null`，链上 `state` 为 `1`（TRADING）或 `2`（READY_TO_LAUNCH）——用 `sun sunpump buy` / `sun sunpump sell` 交易。
-- **发射后（已在 SunSwap V2 建好交易对）：** `state` 为 `3`（LAUNCHED），`swapPoolAddress` 非空——走普通兑换 [`sun swap`](#兑换)。
-
-下单前先用 `sun sunpump state <addr>` 或 `sun sunpump token get <addr>` 判断走哪条路径。只读查询（行情、持有人、钱包持仓、交易历史）与一键发币（`launch`）无需钱包；发射前交易需要钱包。
-:::
-
-### `sunpump token get <contractAddress>`（读取）
-
-按合约地址获取 SunPump 代币详情：价格、市值、24h 成交量、持有人数、总量、所有者、交易池地址、社交链接和发射状态。
-
-```bash
-sun sunpump token get <contractAddress>
-```
-
-### `sunpump token list`（读取）
-
-列出 SunPump 代币，支持过滤和分页。
-
-```bash
-sun sunpump token list [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--contract <address>` | 按合约地址过滤 | — |
-| `--owner <address>` | 按所有者地址过滤 | — |
-| `--symbol <symbol>` | 按符号过滤 | — |
-| `--name <name>` | 按名称过滤 | — |
-| `--description <text>` | 按描述过滤 | — |
-| `--page <n>` | 页码 | — |
-| `--size <n>` | 每页数量 | — |
-| `--sort <field>` | 排序字段（如 `marketCap,desc`） | — |
-
-### `sunpump token search <query>`（读取）
-
-按名称或符号模糊搜索代币。
-
-```bash
-sun sunpump token search <query> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--on-sunswap` | 仅显示已发射到 SunSwap 的代币 | `false` |
-| `--page <n>` | 页码 | — |
-| `--size <n>` | 每页数量 | — |
-| `--sort <field>` | 排序字段 | — |
-
-### `sunpump token search-v2 <query>`（读取）
-
-模糊搜索的 v2 版本（调用 `/token/searchV2` 接口）。相比 `search`，额外支持 `--dlive`、`--ai-helper`、`--twitter-launch`、`--sun-agent-launch` 几个过滤维度。
-
-```bash
-sun sunpump token search-v2 <query> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--on-sunswap` | 仅显示已发射到 SunSwap 的代币 | — |
-| `--dlive` | 过滤：DLive showing | — |
-| `--ai-helper` | 过滤：AI helper | — |
-| `--twitter-launch` | 过滤：Twitter launch | — |
-| `--sun-agent-launch` | 过滤：Sun agent launch | — |
-| `--page <n>` | 页码 | — |
-| `--size <n>` | 每页数量 | — |
-| `--sort <field>` | 排序字段 | — |
-
-### `sunpump token by-owner <ownerAddress>`（读取）
-
-列出某个钱包创建的代币。
-
-```bash
-sun sunpump token by-owner <ownerAddress> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--page <n>` | 页码 | — |
-| `--size <n>` | 每页数量 | — |
-| `--sort <field>` | 排序字段 | — |
-
-### `sunpump token holders <tokenAddress>`（读取）
-
-列出某个代币的持有人，含余额和占比。
-
-```bash
-sun sunpump token holders <tokenAddress> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--include-zero` | 包含零余额持有人 | — |
-| `--page <n>` | 页码 | — |
-| `--size <n>` | 每页数量 | — |
-| `--sort <field>` | 排序字段（默认按余额降序） | — |
-
-> `percent` 字段在 holders 端点返回的是百分值（如 `38.51` = 38.51%），而 token list 端点返回的是小数（如 `0.3851`）。CLI 会自动归一化，但直接读原始 JSON 时请注意量级。
-
-### `sunpump token holders-v2 <tokenAddress>`（读取）
-
-持有人列表的 v2 版本（调用较新的 `/token/holdersV2` 接口），输入参数同 `holders`，返回字段可能略有差异。
-
-```bash
-sun sunpump token holders-v2 <tokenAddress> [options]
-```
-
-### `sunpump token ranking`（读取）
-
-按指定指标获取代币排行。**`--type` 为必需项。**
-
-```bash
-sun sunpump token ranking --type MARKET_CAP --size 10
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--type <rankingType>` | **（必需）** 排行类型：`MARKET_CAP`、`VOLUME_24H`、`PRICE_CHANGE_24H` | — |
-| `--size <n>` | 返回条数 | — |
-
-> `--type` 只接受 `MARKET_CAP`、`VOLUME_24H`、`PRICE_CHANGE_24H` 三个值（大小写敏感），其他值会被 API 拒绝。
-
-### `sunpump token king-of-hill`（读取）
-
-获取当前的 king-of-the-hill 代币。
-
-```bash
-sun sunpump token king-of-hill
-```
-
-### `sunpump token pump-list`（读取）
-
-获取 SunPump 原始代币列表（直接返回接口响应，不拆除外层的 `{code, msg, data}` 包装）。
-
-```bash
-sun sunpump token pump-list
-```
-
-### `sunpump token favors`（读取，需签名）
-
-列出用户收藏的代币。需要签名消息。
-
-```bash
-sun sunpump token favors --user-address <address> --signature <sig> --signed-message <msg> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--user-address <address>` | **（必需）** 用户钱包地址 | — |
-| `--signature <sig>` | **（必需）** 签名消息的签名 | — |
-| `--signed-message <msg>` | **（必需）** 被签名的消息 | — |
-| `--token-address <address>` | 按代币地址过滤 | — |
-| `--page <n>` | 页码 | — |
-| `--size <n>` | 每页数量 | — |
-
-### `sunpump tx token <contractAddress>`（读取）
-
-查询某个代币的买卖交易历史。
-
-```bash
-sun sunpump tx token <contractAddress> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--swap-type <type>` | 方向过滤（`BUY` / `SELL`） | — |
-| `--pool <address>` | 交易池地址 | — |
-| `--tx-hash <hash>` | 指定交易哈希 | — |
-| `--block <n>` | 区块号 | — |
-| `--start-time <epoch>` | 开始时间（epoch **秒**） | — |
-| `--end-time <epoch>` | 结束时间（epoch **秒**） | — |
-| `--page <n>` | 页码 | — |
-| `--size <n>` | 每页数量 | — |
-| `--sort <field>` | 排序字段（如 `txDateTime,desc`） | — |
-
-> `--start-time` / `--end-time` 是 epoch **秒**，不是毫秒。
-
-### `sunpump tx user <ownerAddress>`（读取）
-
-查询某个钱包的买卖交易历史，选项同 `tx token`。
-
-```bash
-sun sunpump tx user <ownerAddress> --size 20
-sun sunpump tx user <ownerAddress> --swap-type BUY --size 20
-```
-
-### `sunpump portfolio <walletAddress>`（读取）
-
-列出某个钱包持有的所有 SunPump 代币，含 TRX 计价价值和持仓占比。
-
-```bash
-sun sunpump portfolio <walletAddress> [options]
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--include-zero` | 包含零余额代币 | — |
-| `--min-trx <amount>` | 最低 TRX 计价价值过滤 | — |
-| `--page <n>` | 页码 | — |
-| `--size <n>` | 每页数量 | — |
-| `--sort <field>` | 排序字段（如 `valueInTrx,desc`） | — |
-
-### `sunpump launch`（写入，无需钱包）
-
-通过 SunPump agent 端点（`POST /ai/agentTokenLaunch`）创建新的 meme 代币。创建在**服务端**完成：由平台签名并广播创建交易，本地无需钱包。CLI 会先打印摘要并要求确认（`--yes` 跳过）；`--dry-run` 只预览请求不发送。成功后输出新代币的合约地址、创建交易哈希和 logo URL。
-
-```bash
-sun sunpump launch --name "<token name>" --symbol "<SYMBOL>" \
-  --description "<one-line description>" --image ./logo.png \
-  --twitter-url "https://x.com/<your-handle>" --website-url "https://<your-site>"
-```
-
-| 选项 | 说明 | 默认值 |
-| :--- | :--- | :--- |
-| `--name <name>` | **（必填）**代币名称 | — |
-| `--symbol <symbol>` | **（必填）**代币符号 | — |
-| `--description <text>` | **（必填）**代币描述 | — |
-| `--image <path>` | logo 图片文件，读取后以 base64 发送 | — |
-| `--image-base64 <data>` | logo 的 base64 原始字符串（优先于 `--image`） | — |
-| `--twitter-url <url>` | Twitter 链接 | — |
-| `--telegram-url <url>` | Telegram 链接 | — |
-| `--website-url <url>` | 官网链接 | — |
-| `--tweet-username <name>` | 关联的推文用户名 | — |
-
-> 强烈建议通过 `--image` / `--image-base64` 提供 logo——缺少 logo 时 API 可能直接返回不带原因的 `500`（CLI 遇到时会给出提示）。
-
-### `sunpump state <tokenAddress>`（读取）
-
-查询 SunPump 代币的链上状态，用于判断该走 SunPump 发射前交易还是 SunSwap。
-
-```bash
-sun sunpump state <tokenAddress>
-```
-
-| 状态值 | 标签 | 能否用 `sunpump buy/sell` 交易 |
-| :--- | :--- | :--- |
-| `0` | `NOT_EXIST` | 否（SunPump 不认识该代币） |
-| `1` | `TRADING` | 是 |
-| `2` | `READY_TO_LAUNCH` | 是（Bonding Curve 进度已满 100%，即将在 SunSwap V2 上创建交易对） |
-| `3` | `LAUNCHED` | 否——改用 `sun swap` |
-
-> `sun-kit` 的 TypeScript 枚举只列了 0–2，但链上合约对已发射代币会返回 3。CLI 会把 3 映射为 `LAUNCHED`——请以打印出的标签为准，不要只看原始数字。
-
-### `sunpump quote-buy <tokenAddress>`（读取）
-
-预览一笔 SunPump 发射前买入，不发送交易。
-
-```bash
-sun sunpump quote-buy <tokenAddress> --trx 10
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--trx <amount>` | **（必需）** 要花费的 TRX，**小数**（如 `10` 或 `1.5`） | — |
-
-### `sunpump quote-sell <tokenAddress>`（读取）
-
-预览一笔 SunPump 发射前卖出，不发送交易。
-
-```bash
-sun sunpump quote-sell <tokenAddress> --amount 1000
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--amount <amount>` | **（必需）** 要卖出的代币数量，**小数** | — |
-| `--decimals <n>` | 代币精度 | `18` |
-
-### `sunpump buy <tokenAddress>`（写入）
-
-在 SunPump 上用 TRX 买入 meme 代币（仅限还没在 SunSwap V2 上创建交易对的代币）。`--trx` 接受小数，CLI 内部按 TRX-Sun（1e6）缩放。
-
-```bash
-sun sunpump buy <tokenAddress> --trx 10
-sun sunpump buy <tokenAddress> --trx 10 --slippage 0.1
-sun sunpump buy <tokenAddress> --trx 10 --min-out 27955000000000000000000
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--trx <amount>` | **（必需）** 要花费的 TRX，**小数** | — |
-| `--slippage <n>` | 滑点容差，小数表示（meme 代币波动大） | `0.05` |
-| `--min-out <raw>` | 最少获得代币数（原始单位，覆盖滑点） | — |
-
-### `sunpump sell <tokenAddress>`（写入）
-
-在 SunPump 上把 meme 代币卖成 TRX（仅限还没在 SunSwap V2 上创建交易对的代币）。首次卖出某代币时，SDK 会自动先发一笔 TRC20 `approve` 交易。
-
-```bash
-sun sunpump sell <tokenAddress> --amount 1000
-sun sunpump sell <tokenAddress> --amount 1000 --decimals 6
-sun sunpump sell <tokenAddress> --amount 1000 --slippage 0.1
-```
-
-| 选项 | 描述 | 默认值 |
-| :--- | :--- | :--- |
-| `--amount <amount>` | **（必需）** 要卖出的代币数量，**小数** | — |
-| `--decimals <n>` | 代币精度（不确定时用 `sunpump token get` 查） | `18` |
-| `--slippage <n>` | 滑点容差，小数表示 | `0.05` |
-| `--min-out <raw>` | 最少获得 TRX（Sun 为单位，覆盖滑点） | — |
-
-> 用 `--dry-run` 可在不广播的情况下打印解析后的参数（TRX/Sun 缩放、计算出的 `minOut`、滑点、网络），方便先给用户看清将要发送的内容。
-
----
-
-## 内置代币符号
-
-很多命令同时接受代币符号和完整的 TRON 地址：
-
-| 符号 | 地址 | 精度 |
-| :--- | :--- | :--- |
-| `TRX` | `T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb` | 6 |
-| `WTRX` | `TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR` | 6 |
-| `USDT` | `TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t` | 6 |
-| `USDCOLD` | `TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8` | 6 |
-| `USDDOLD` | `TPYmHEhy5n8TCEfYGqW2rPxsghSfzghPDn` | 18 |
-| `USDD` | `TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz` | 18 |
-| `SUN` | `TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S` | 18 |
-| `JST` | `TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9` | 18 |
-| `BTT` | `TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4` | 18 |
-| `WIN` | `TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7` | 6 |
-| `NFT` | `TFczxzPhnThNSqr5by8tvxsdCFRRz6cPNq` | 6 |
-| `TUSD` | `TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4` | 18 |
-
-你可以使用符号或完整地址：
-
-```bash
-sun swap TRX USDT 1000000
-```
-
-```bash
-sun swap T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t 1000000
-```
-
-你可以在 [tokenlist](https://sunlists.justnetwork.io/#/detail?uri=https://list.justswap.io/justswap.json) 查找其他代币。
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/FAQ.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/FAQ.md
deleted file mode 100644
index a15f8407..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/FAQ.md
+++ /dev/null
@@ -1,133 +0,0 @@
-# 常见问题与排查
-
-SUN CLI 常见问题与故障排查。
-
----
-
-## 安装与配置
-
-### 系统要求是什么？
-
-- **Node.js** 20.0.0 或更高版本
-- **npm**（随 Node.js 一起安装）
-- 终端或 Shell 环境（macOS、Linux 或 Windows WSL）
-
-### 如何更新 SUN CLI？
-
-```bash
-npm update -g @bankofai/sun-cli
-```
-
----
-
-## 钱包与配置
-
-### 提示"No wallet configured"怎么办？
-
-写入操作（swap、liquidity、contract send）需要钱包。设置以下钱包源之一：
-
-- `AGENT_WALLET_PRIVATE_KEY` — 直接提供私钥
-- `AGENT_WALLET_MNEMONIC` — 助记词
-- `AGENT_WALLET_PASSWORD` — 通过 agent-wallet 的加密钱包
-
-或者使用根级标志（`-k`、`-m`、`-p`）为单次调用提供钱包。详见 [agent-wallet 快速开始](../../../Agent-Wallet/QuickStart.md)。
-
-### 不配置钱包能用吗？
-
-可以。所有只读命令无需任何钱包配置：价格查询、兑换报价、池子数据、协议统计、代币搜索等等。
-
-### 我的私钥安全吗？
-
-SUN CLI 永远不会将你的私钥上传到任何远程服务。所有签名都在本地完成。但要注意命令行标志（`-k`、`-m`）可能出现在 Shell 历史记录中。建议使用环境变量或 agent-wallet 的加密存储。
-
----
-
-## 常见错误
-
-### `unknown command 'nile'`
-
-`--network` 等根级标志必须放在**子命令之前**：
-
-```bash
-# 正确
-sun --network nile swap TRX USDT 1000000
-
-# 错误——'nile' 被解析为命令
-sun swap TRX USDT 1000000 --network nile
-```
-
-使用 npm scripts 时，在 `--` 后传递参数：
-
-```bash
-npm run start -- --network nile swap TRX USDT 1000000
-```
-
-### `Swap failed`
-
-常见原因：
-
-- 钱包未配置
-- 不支持的代币符号或无效地址
-- 余额不足
-- RPC 或路由 API 故障
-- 路径参数过期或无效
-
-**建议：** 先运行 `swap:quote` 验证路径，确认报价合理后再使用 `--yes` 重试。
-
-### 交易成功但结果不符预期
-
-- **滑点**：在波动市场中，实际输出可能与报价不同。通过 `--slippage` 调整滑点容忍度。
-- **代币精度**：金额以代币最小单位指定。TRX（6 位精度），`1000000` = 1 TRX。
-- **网络不匹配**：确保你在目标网络上。用 `sun wallet address` 检查。
-
----
-
-## AI Agent 集成
-
-### AI Agent 能使用 SUN CLI 吗？
-
-可以。SUN CLI 专为人类和 AI 驱动的工作流设计。自动化相关的关键特性：
-
-- `--json` 输出提供机器可读响应
-- `--yes` 标志跳过确认提示
-- `--dry-run` 预览操作而不执行
-- `--fields` 过滤输出到指定字段
-- 退出码用于脚本中的错误处理
-
-### SUN CLI 和 SUN MCP Server 有什么区别？
-
-SUN CLI 是直接调用的命令行工具。SUN MCP Server 是一个 MCP 兼容的服务器，AI 客户端通过它进行自然语言 DeFi 交互。两者访问的是同一个 SunSwap 生态。脚本和自动化选 CLI，AI 辅助工作流选 MCP Server。
-
----
-
-## 网络与代币
-
-### 支持哪些网络？
-
-主网、Nile 测试网和 Shasta 测试网。默认为主网。使用 `--network nile` 或 `--network shasta` 进行测试。
-
-### 如何使用内置列表之外的代币？
-
-使用代币的完整 TRON 合约地址代替符号：
-
-```bash
-sun price --address TYourTokenAddress
-```
-
-```bash
-sun swap TYourTokenAddress TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t 1000000
-```
-
-### 可以使用自定义 RPC 端点吗？
-
-可以。设置 `TRON_RPC_URL` 环境变量：
-
-```bash
-export TRON_RPC_URL=https://your-tron-rpc.example
-```
-
----
-
-## 还有其他问题？
-
-如果这里没有覆盖你的问题，查看 [完整能力清单](./CommandGuide.md) 了解详细用法，或在 [GitHub 仓库](https://github.com/BofAI/sun-cli) 提交 Issue。
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/Intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/Intro.md
deleted file mode 100644
index 8bd6ff7d..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/Intro.md
+++ /dev/null
@@ -1,132 +0,0 @@
-# 简介
-
-## SUN CLI 是什么？
-
-SUN CLI（`@bankofai/sun-cli`）是一个命令行工具，让你在终端里就能使用 [SUN.IO（SunSwap）](https://sun.io) 的全部 DeFi 能力。无论你是开发者、运维人员还是 AI Agent，SUN CLI 都能通过一行命令完成代币价格查询、兑换执行、流动性管理等 TRON 链上操作。
-
-简单理解：SUN MCP Server 通过 MCP 协议将 DeFi 能力暴露为标准工具接口，AI 助手可以直接调用，无需拼接命令或解析文本输出。SUN CLI 则提供结构化的命令行界面，适合你手动操作、编写脚本，也可以由 AI Agent 通过 Shell 调用。两者共享同一套底层 DeFi 能力，区别在于集成方式：MCP 是原生协议集成，CLI 是命令行调用。
-
-举个例子，查询 TRX 的实时价格只需：
-
-```bash
-sun price TRX
-```
-
-执行一笔兑换 —— 比如**用 1 个 TRX 兑换 USDT**：
-
-```bash
-sun swap TRX USDT 1000000 --yes
-```
-
-> 金额按该代币的 `decimals` 进行整数缩放传入。TRX 精度为 6，所以 `1000000` 就是 **1 个 TRX**。
-
-不需要打开浏览器，不需要前端界面，不需要手动与合约交互。
-
----
-
-## 它能做什么？
-
-SUN CLI 覆盖了与 SunSwap DEX 交互的完整操作，从实时行情数据到链上交易执行。
-
-**数据查询（只读，无需钱包）：**
-
-| 能力 | 描述 | 示例命令 |
-| :--- | :--- | :--- |
-| **代币价格** | 查询 SunSwap 上任意代币的实时价格 | `sun price TRX` |
-| **兑换报价** | 执行前获取最优路径和预期输出 | `sun swap:quote TRX USDT 1000000` |
-| **池子数据** | 池子列表、APY 排行、交易量和流动性历史 | `sun pool top-apy --page-size 5` |
-| **持仓查询** | 查看任意地址的流动性仓位 | `sun position list --owner TYourAddress` |
-| **协议统计** | SunSwap 全局交易量、用户数、池数量、流动性历史 | `sun protocol info` |
-| **矿池信息** | 收益矿池列表、挖矿持仓和矿池交易历史 | `sun farm list` |
-| **代币发现** | 按名称搜索代币、按协议版本列表 | `sun token search USDT` |
-| **SunPump 行情** | meme 代币发现：排行、详情、持有人、钱包持仓、交易历史（仅 TRON 主网） | `sun sunpump token ranking --type MARKET_CAP --size 10` |
-
-**DeFi 操作（写入，需要钱包）：**
-
-| 能力 | 描述 | 示例命令 |
-| :--- | :--- | :--- |
-| **代币兑换** | 通过 Universal Router 执行最优路径兑换 | `sun swap TRX USDT 1000000` |
-| **V2 流动性** | 创建流动性池或向 V2 池添加/移除流动性 | `sun liquidity v2:add --token-a TRX --token-b USDT --amount-a 1000000` |
-| **V3 流动性** | 铸造、增加、减少集中流动性仓位，收取手续费 | `sun liquidity v3:mint --token0 TRX --token1 USDT --amount0 1000000` |
-| **V4 流动性** | V4 集中流动性操作，支持 Permit2 授权 | `sun liquidity v4:mint --token0 TRX --token1 USDT --amount0 1000000` |
-| **合约交互** | 读取或写入任意 TRON 智能合约 | `sun contract read <address> balanceOf --args '[...]'` |
-| **SunPump 一键发币** | 通过 SunPump agent 端点一条命令创建 meme 代币——服务端签名创建，**无需钱包**（仅 TRON 主网） | `sun sunpump launch --name "<name>" --symbol "<SYMBOL>" --description "..."` |
-| **SunPump 发射前交易** | 在 SunPump 上买卖还没在 SunSwap V2 上建交易对的 meme 代币（仅 TRON 主网） | `sun sunpump buy <address> --trx 10` |
-
----
-
-## SUN CLI vs SUN MCP Server
-
-两个工具连接的是同一个 SunSwap 生态，但服务于不同的使用场景：
-
-| 对比项 | SUN CLI | SUN MCP Server |
-| :--- | :--- | :--- |
-| **集成方式** | 命令行（Shell 调用） | MCP 协议（原生工具接口） |
-| **适合场景** | 手动操作、脚本、CI/CD、AI Agent 通过 Shell 调用 | AI 助手通过 MCP 协议直接调用 |
-| **调用方式** | 拼接命令 + 参数，解析文本/JSON 输出 | AI 客户端直接发送结构化工具调用，无需拼接命令 |
-| **输出格式** | Table、JSON、TSV | 结构化 MCP 响应 |
-| **写入操作** | 支持（需配置钱包） | 支持（需本地部署） |
-| **免确认模式** | `--yes` 标志跳过确认 | AI 处理确认流程 |
-
-:::tip 什么时候选哪个？
-如果你的 AI 助手支持 MCP 协议，优先选 SUN MCP Server——集成更简洁，无需处理命令拼接和输出解析。如果你需要在 Shell 脚本、定时任务、CI/CD 流水线中使用，或者你的 AI Agent 不支持 MCP 协议，选 SUN CLI。
-:::
-
----
-
-## 输出模式
-
-SUN CLI 支持三种输出格式，同时友好于人类和机器：
-
-- **table** — 默认，人类友好的终端表格
-- **json** — 紧凑的机器可读 JSON，适合脚本和 AI Agent
-- **tsv** — Tab 分隔值，适合 Shell 管道
-
-```bash
-sun pool top-apy --page-size 5
-```
-
-```bash
-sun --json wallet address
-```
-
-```bash
-sun --output tsv token list --protocol V3
-```
-
----
-
-## 支持的网络
-
-SUN CLI 支持以下三个 TRON 网络（默认连接主网）：
-
-| 网络 | 标识符 | 用途 | 区块浏览器 |
-| :--- | :--- | :--- | :--- |
-| **主网** | `mainnet` | 生产环境，真实资产 | [tronscan.org](https://tronscan.org) |
-| **Nile 测试网** | `nile` | 开发测试（推荐） | [nile.tronscan.org](https://nile.tronscan.org) |
-| **Shasta 测试网** | `shasta` | 开发测试 | [shasta.tronscan.org](https://shasta.tronscan.org) |
-
-通过 `--network` 标志指定目标网络。**强烈建议每次新操作先在 Nile 测试网上验证**——主网操作涉及真实资产，错误无法撤回。
-
----
-
-## 安全注意事项
-
-:::warning
-DeFi 操作直接涉及链上资产，错误操作无法撤回。请牢记以下原则：
-
-- **切勿硬编码私钥**：使用环境变量或 [agent-wallet](https://github.com/BofAI/agent-wallet) 的加密存储，不要在共享环境中使用命令行参数传递密钥。
-- **先在测试网验证**：使用 `--network nile` 在主网执行前验证每个写操作。
-- **最小资金原则**：CLI 配置的钱包只存放当前任务所需的最低金额。
-- **使用 dry-run 模式**：高价值操作前运行 `--dry-run` 预览意图而不广播交易。
-- **验证代币地址**：不使用内置符号时，仔细核对合约地址。
-- **报价不等于保证**：在波动市场中，实际执行结果可能与报价不同。
-:::
-
----
-
-## 下一步
-
-- 想最快速度上手？ → [快速开始](./QuickStart.md)
-- 需要完整命令参考？ → [完整能力清单](./CommandGuide.md)
-- 遇到问题？ → [常见问题与排查](./FAQ.md)
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/QuickStart.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/QuickStart.md
deleted file mode 100644
index fb97335a..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/McpServer-Skills/Tools/SUNCli/QuickStart.md
+++ /dev/null
@@ -1,147 +0,0 @@
-# 快速开始
-
-这一页的目标很简单：**安装 SUN CLI，在 1 分钟内完成第一次 DeFi 查询。**
-
-只读命令不需要钱包——安装即用。
-
----
-
-## 准备工作
-
-开始之前，确保你已安装：
-
-1. **Node.js** >= 20.0.0（[下载链接](https://nodejs.org/)）
-2. **npm**（随 Node.js 一起安装）
-
----
-
-## 第一步：安装
-
-运行一行命令全局安装 SUN CLI：
-
-```bash
-npm install -g @bankofai/sun-cli
-```
-
-安装完成后，终端里就能使用 `sun` 命令了。
-
----
-
-## 第二步：你的第一次查询
-
-查一下 TRX 当前的实时价格。运行：
-
-```bash
-sun price TRX
-```
-
-你会看到类似这样的输出：
-
-```text
-✔ Fetching prices...
-┌───────┬────────────────┐
-│ Token │ Price (USD)    │
-├───────┼────────────────┤
-│ TRX   │ 0.301739439813 │
-└───────┴────────────────┘
-```
-
-就这么简单——你已经连上 SunSwap 了。
-
----
-
-## 第三步：探索更多数据
-
-再试几个只读命令，看看还能查什么：
-
-**查看 APY 最高的池子：**
-
-```bash
-sun pool top-apy --page-size 5
-```
-
-**获取「用 1 个 TRX 兑换 USDT」的报价**（不需要钱包）：
-
-```bash
-sun swap:quote TRX USDT 1000000
-```
-
-这会显示最佳路径和预期输出——不会执行任何交易。（TRX 精度为 6，所以 `1000000` = 1 TRX。）
-
-**获取 JSON 格式输出（适合脚本）：**
-
-```bash
-sun --json price USDT
-```
-
----
-
-## 配置钱包（用于写入操作）
-
-只读命令开箱即用。要执行兑换、管理流动性或发送合约交易，需要配置钱包。
-
-SUN CLI 使用 [`agent-wallet`](../../../Agent-Wallet/Intro.md) 进行钱包管理。先安装：
-
-```bash
-npm install -g @bankofai/agent-wallet
-```
-
-然后按照 [agent-wallet 快速开始指南](../../../Agent-Wallet/QuickStart.md) 配置你的钱包。
-
-:::caution 保管好你的密钥
-切勿将私钥或助记词硬编码在配置文件或 Shell 历史记录中。使用环境变量或 agent-wallet 的加密存储。测试时请始终使用 Nile 测试网。
-:::
-
-钱包配置完成后，验证一下：
-
-```bash
-sun wallet address
-```
-
-你会看到你的钱包地址和当前网络：
-
-```json
-{ "address": "TNmoJ...xxxxx", "network": "mainnet" }
-```
-
----
-
-## 在测试网执行第一笔兑换
-
-钱包配置好后，在 Nile 测试网上试一笔**用 1 个 TRX 兑换 USDT** 的交易：
-
-```bash
-sun swap TRX USDT 1000000 --network nile --yes
-```
-
-`--yes` 标志跳过确认提示。输出包含交易 ID 和 Tronscan 链接，可以在链上查证。
-
-:::tip 先在 Nile 测试网验证
-在主网执行任何写操作前，先在 Nile 测试网上跑通。主网操作涉及真实资产，错误无法撤回。
-:::
-
----
-
-## 网络与 API 配置
-
-可选的环境变量自定义：
-
-```bash
-export TRON_NETWORK=mainnet
-```
-
-```bash
-export TRON_GRID_API_KEY="<YOUR_KEY>"
-```
-
-```bash
-export TRON_RPC_URL=https://your-rpc
-```
-
----
-
-## 下一步
-
-- **[完整能力清单](./CommandGuide.md)** — 所有命令的完整参考：钱包、价格、兑换、流动性、协议、合约操作
-- **[常见问题与排查](./FAQ.md)** — 常见问题与故障排查
-- **[SUN MCP Server](../SUNMCPServer/Intro.md)** — 更喜欢 AI 驱动的 DeFi？用 SUN MCP Server 实现自然语言交互
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/sidebars.js b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/sidebars.js
deleted file mode 100644
index d422639c..00000000
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/sidebars.js
+++ /dev/null
@@ -1,357 +0,0 @@
-/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
-const sidebars = {
-  docsSidebar: [
-    {
-      type: 'category',
-      label: 'BANK OF AI',
-      collapsed: false,
-      items: [
-        'BANK-OF-AI/Intro',
-        'BANK-OF-AI/QuickStart',
-      ],
-    },
-    {
-      type: 'category',
-      label: 'x402 Payment Protocol',
-      collapsed: false,
-      items: [
-        {
-          type: 'doc',
-          id: 'x402/index',
-          label: '简介',
-        },
-        {
-          type: 'category',
-          label: '快速入门',
-          items: [
-            'x402/getting-started/quickstart-for-sellers',
-            {
-              type: 'category',
-              label: '买家快速入门',
-              collapsed: false,
-              items: ['x402/getting-started/quickstart-for-human', 'x402/getting-started/quickstart-for-agent'],
-            },
-          ],
-        },
-        {
-          type: 'category',
-          label: '核心概念',
-          items: [
-            'x402/core-concepts/http-402',
-            'x402/core-concepts/client-server',
-            'x402/core-concepts/facilitator',
-            'x402/core-concepts/OfficialFacilitator',
-            'x402/core-concepts/gateway',
-            {
-              type: 'category',
-              label: 'API 目录',
-              collapsed: false,
-              items: [
-                'x402/api-catalog/index',
-                'x402/api-catalog/get-started',
-                'x402/api-catalog/list-your-service',
-                'x402/api-catalog/reference',
-              ],
-            },
-            'x402/core-concepts/wallet',
-            'x402/core-concepts/network-and-token-support',
-          ],
-        },
-        {
-          type: 'doc',
-          id: 'x402/sdk-features',
-          label: 'SDK 功能',
-        },
-        {
-          type: 'doc',
-          id: 'x402/faq',
-          label: '常见问题',
-        },
-      ],
-    },
-    {
-      type: 'category',
-      label: '8004 Protocol',
-      collapsed: false,
-      items: [
-        {
-          type: 'doc',
-          id: '8004/general',
-          label: '简介',
-        },
-        {
-          type: 'doc',
-          id: '8004/contract',
-          label: '合约',
-        },
-        {
-          type: 'doc',
-          id: '8004/QuickStart',
-          label: '快速开始',
-        },
-        {
-          type: 'doc',
-          id: '8004/SupportedNetworks',
-          label: '支持的网络',
-        },
-        {
-          type: 'category',
-          label: 'Usage',
-          collapsed: false,
-          items: ['8004/Usage/Install', '8004/Usage/ConfigureAgents', '8004/Usage/RegistrationHTTP'],
-        },
-      ],
-    },
-
-    {
-      type: 'category',
-      label: 'MCP Server & SKILLS',
-      collapsed: false,
-      items: [
-        {
-          type: 'doc',
-          id: 'McpServer-Skills/Intro',
-          label: '简介',
-        },
-        {
-          type: 'category',
-          label: 'MCP Server',
-          collapsed: false,
-          items: [
-            'McpServer-Skills/MCP/Intro',
-            {
-              type: 'category',
-              label: 'TRON MCP Server',
-              collapsed: true,
-              items: [
-                'McpServer-Skills/MCP/TRONMCPServer/Intro',
-                'McpServer-Skills/MCP/TRONMCPServer/QuickStart',
-                'McpServer-Skills/MCP/TRONMCPServer/OfficialServerAccess',
-                'McpServer-Skills/MCP/TRONMCPServer/LocalPrivatizedDeployment',
-                'McpServer-Skills/MCP/TRONMCPServer/ToolList',
-                'McpServer-Skills/MCP/TRONMCPServer/FAQ',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'SUN MCP Server',
-              collapsed: true,
-              items: [
-                'McpServer-Skills/MCP/SUNMCPServer/Intro',
-                'McpServer-Skills/MCP/SUNMCPServer/QuickStart',
-                'McpServer-Skills/MCP/SUNMCPServer/OfficialServerAccess',
-                'McpServer-Skills/MCP/SUNMCPServer/LocalPrivatizedDeployment',
-                'McpServer-Skills/MCP/SUNMCPServer/ToolList',
-                'McpServer-Skills/MCP/SUNMCPServer/FAQ',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'BSC MCP Server',
-              collapsed: true,
-              items: [
-                'McpServer-Skills/MCP/BSCMCPServer/Intro',
-                'McpServer-Skills/MCP/BSCMCPServer/Features',
-                'McpServer-Skills/MCP/BSCMCPServer/Installation',
-              ],
-            },
-          ],
-        },
-        {
-          type: 'category',
-          label: 'SKILLS',
-          collapsed: false,
-          items: [
-            'McpServer-Skills/SKILLS/Intro',
-            'McpServer-Skills/SKILLS/BANKOFAISkill',
-            'McpServer-Skills/SKILLS/Faq',
-          ],
-        },
-        {
-          type: 'category',
-          label: 'TOOLS',
-          collapsed: false,
-          items: [
-            {
-              type: 'category',
-              label: 'SUN CLI',
-              collapsed: true,
-              items: [
-                'McpServer-Skills/Tools/SUNCli/Intro',
-                'McpServer-Skills/Tools/SUNCli/QuickStart',
-                'McpServer-Skills/Tools/SUNCli/CommandGuide',
-                'McpServer-Skills/Tools/SUNCli/FAQ',
-              ],
-            },
-          ],
-        },
-      ],
-    },
-    {
-      type: 'category',
-      label: 'Agent Wallet',
-      collapsed: false,
-      items: [
-        'Agent-Wallet/Intro',
-        'Agent-Wallet/QuickStart',
-        {
-          type: 'category',
-          label: '进一步探索',
-          collapsed: true,
-          items: [
-            'Agent-Wallet/Developer/CLI-Reference',
-            'Agent-Wallet/Developer/SDK-Guide',
-            'Agent-Wallet/Developer/SDK-Cookbook',
-          ],
-        },
-        'Agent-Wallet/FAQ',
-      ],
-    },
-    {
-      type: 'category',
-      label: 'Openclaw 扩展插件',
-      collapsed: false,
-      items: ['Openclaw-extension/Intro', 'Openclaw-extension/QuickStart', 'Openclaw-extension/FAQ'],
-    },
-
-    {
-      type: 'category',
-      label: 'LLM Service',
-      collapsed: false,
-      items: [
-        { type: 'doc', id: 'llmservice/introduction', label: '简介' },
-        { type: 'doc', id: 'llmservice/quick-start', label: '快速开始' },
-        { type: 'doc', id: 'llmservice/pricing-and-usage', label: '定价与使用' },
-        {
-          type: 'category',
-          label: '模型',
-          collapsed: true,
-          items: [
-            {
-              type: 'category',
-              label: 'OpenAI（GPT）',
-              collapsed: true,
-              items: [
-                'llmservice/models/gpt-5-6-sol',
-                'llmservice/models/gpt-5-6-terra',
-                'llmservice/models/gpt-5-6-luna',
-                'llmservice/models/gpt-5-5',
-                'llmservice/models/gpt-5-5-instant',
-                'llmservice/models/gpt-5-4',
-                'llmservice/models/gpt-5-4-pro',
-                'llmservice/models/gpt-5-4-mini',
-                'llmservice/models/gpt-5-4-nano',
-                'llmservice/models/gpt-5-2',
-                'llmservice/models/gpt-5-mini',
-                'llmservice/models/gpt-5-nano',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'Anthropic（Claude）',
-              collapsed: true,
-              items: [
-                'llmservice/models/claude-sonnet-5',
-                'llmservice/models/claude-fable-5',
-                'llmservice/models/claude-opus-4-8',
-                'llmservice/models/claude-opus-4-7',
-                'llmservice/models/claude-opus-4-6',
-                'llmservice/models/claude-opus-4-5',
-                'llmservice/models/claude-sonnet-4-6',
-                'llmservice/models/claude-sonnet-4-5',
-                'llmservice/models/claude-haiku-4-5',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'Google（Gemini）',
-              collapsed: true,
-              items: [
-                'llmservice/models/gemini-3-6-flash',
-                'llmservice/models/gemini-3-5-flash',
-                'llmservice/models/gemini-3-5-flash-lite',
-                'llmservice/models/gemini-3-1-pro',
-                'llmservice/models/gemini-3-flash',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'DeepSeek',
-              collapsed: true,
-              items: [
-                'llmservice/models/deepseek-v4-pro',
-                'llmservice/models/deepseek-v4-flash',
-                'llmservice/models/deepseek-v3.2',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'SpaceXAI（Grok）',
-              collapsed: true,
-              items: [
-                'llmservice/models/grok-4.5',
-              ],
-            },
-            {
-              type: 'category',
-              label: '智谱 AI（GLM）',
-              collapsed: true,
-              items: [
-                'llmservice/models/glm-5-2',
-                'llmservice/models/glm-5-1',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'Moonshot AI（Kimi）',
-              collapsed: true,
-              items: [
-                'llmservice/models/kimi-k3',
-                'llmservice/models/kimi-k2.6',
-                'llmservice/models/kimi-k2.5',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'Qwen',
-              collapsed: true,
-              items: [
-                'llmservice/models/qwen3.6-27b',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'MiniMax',
-              collapsed: true,
-              items: [
-                'llmservice/models/minimax-m3',
-                'llmservice/models/minimax-m2.7',
-              ],
-            },
-          ],
-        },
-        { type: 'doc', id: 'llmservice/memory', label: '记忆服务' },
-        {
-          type: 'category',
-          label: 'OpenClaw',
-          collapsed: true,
-          items: ['llmservice/openclaw/integration-guide', 'llmservice/openclaw/one-click-script-tutorial'],
-        },
-        {
-          type: 'category',
-          label: 'Claude Code',
-          collapsed: true,
-          items: ['llmservice/Claude-Code/claudecode-bankofai-api-configuration-guide'],
-        },
-        {
-          type: 'category',
-          label: 'API',
-          collapsed: true,
-          items: ['llmservice/api/API'],
-        },
-      ],
-    },
-  ],
-}
-
-module.exports = sidebars
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/command-reference.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/command-reference.md
new file mode 100644
index 00000000..1b44cf8c
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/command-reference.md
@@ -0,0 +1,278 @@
+---
+title: '命令参考'
+description: >-
+  x402 CLI 每条命令与参数的完整参考——pay、serve、roundtrip、gateway、catalog。
+---
+
+# 命令参考
+
+本页是 x402 CLI 所有命令的完整参考。
+
+> 图例：`<arg>` = 必填参数，`[arg]` = 可选参数。除非标注 **（必填）**，选项均为可选。
+
+---
+
+## 全局选项
+
+以下参数对每条命令都生效。
+
+| 参数 | 说明 |
+| :--- | :--- |
+| `-h, --help` | 显示该命令的帮助 |
+| `-V, --version` | 打印 CLI 版本 |
+| `--json` | 打印机器可读的结构化 JSON 输出 |
+| `--human` | 打印人类可读的输出（默认） |
+
+`--json` 与 `--human` 互斥。该结构化输出始终包含 `ok` 和 `command`，以及一个 `result` 对象或一个结构化的 `error`（`code`、`message`、`hint`）。
+
+```bash
+x402-cli --help
+x402-cli --version
+x402-cli pay --help
+```
+
+---
+
+## `pay`
+
+支付一个受 x402 保护的 URL。CLI 发出请求，若服务器回应 `402 Payment Required`，它会读取 `PAYMENT-REQUIRED` 应答头、选出匹配的支付要求、签名，并携带签名载荷重试请求。
+
+```bash
+x402-cli pay <url> [options]
+```
+
+| 选项 | 说明 |
+| :--- | :--- |
+| `--method <method>` | HTTP 方法（默认：`GET`） |
+| `--header "Name: Value"` | 请求头，可重复 |
+| `--body <body>` | 非 `GET`/`HEAD` 方法的请求体 |
+| `--network <caip2>` | 要求特定网络（如 `tron:nile`） |
+| `--token <symbol>` | 要求特定代币（如 `USDT`） |
+| `--scheme <scheme>` | 要求特定 x402 scheme（如 `exact`） |
+| `--max-amount <amount>` | 允许支付的最大人类可读金额 |
+| `--max-raw-amount <amount>` | 允许支付的最大最小单位金额 |
+| `--dry-run` | 只读取支付要求，不签名、不付款 |
+| `--private-key <hex>` | 显式付款方私钥（或用下方环境变量） |
+| `--rpc-url <url>` | 显式网络 RPC URL |
+| `--timeout-ms <ms>` | 网络超时（毫秒，默认：`30000`） |
+| `--json` | 打印结构化 JSON 输出 |
+
+付款方私钥来自 `--private-key`，或环境变量：TRON 网络用 `TRON_PRIVATE_KEY`，EVM 网络用 `EVM_PRIVATE_KEY`，`PRIVATE_KEY` 作为两种网络通用的回退。
+
+**示例：**
+
+```bash
+# 预览支付要求但不付款
+x402-cli pay https://api.example.com/paid --dry-run --json
+```
+
+```bash
+# 支付，但绝不超过 0.01 USDT
+TRON_PRIVATE_KEY=<hex> x402-cli pay https://api.example.com/paid \
+  --network tron:nile --token USDT --max-amount 0.01
+```
+
+```bash
+# 带请求体和自定义请求头的 POST
+x402-cli pay https://api.example.com/paid \
+  --method POST --header "X-Client: demo" --body '{"q":"hello"}'
+```
+
+如果接口没有返回 `402`，CLI 会报告实际状态与响应，而不会付款。
+
+---
+
+## `serve`
+
+启动一个本地 x402 付费端点。它对外宣告一条支付要求，随后通过 Facilitator 校验并结算收到的支付。
+
+```bash
+x402-cli serve --pay-to <address> [options]
+```
+
+| 选项 | 说明 |
+| :--- | :--- |
+| `--pay-to <address>` | **（必填）** 收款钱包地址 |
+| `--amount <amount>` | 人类可读的代币金额（默认：`0.0001`） |
+| `--raw-amount <amount>` | 最小单位金额（与 `--amount` 互斥） |
+| `--network <caip2>` | 支付网络（默认：`tron:nile`） |
+| `--token <symbol>` | 代币符号（默认：`USDT`） |
+| `--asset <address>` | 未注册代币的显式合约地址 |
+| `--decimals <count>` | 代币精度，配合未注册的 `--asset` 时必填 |
+| `--host <host>` | 绑定主机（默认：`127.0.0.1`） |
+| `--port <port>` | 绑定端口（默认：`4020`） |
+| `--resource-url <url>` | 在支付要求中对外宣告的 URL |
+| `--facilitator-url <url>` | Facilitator 基础 URL（默认：`https://facilitator.bankofai.io`） |
+| `--timeout-ms <ms>` | Facilitator 超时（毫秒，默认：`30000`） |
+| `-d, --daemon` | 在后台运行并打印子进程 pid |
+| `--json` | 打印结构化 JSON 输出 |
+
+服务暴露四个路由：
+
+| 路由 | 用途 |
+| :--- | :--- |
+| `GET /health` | 返回 `{ "ok": true }` |
+| `GET /.well-known/x402` | 机器可读的支付元数据（网络、scheme、资产、金额、`payTo`） |
+| `GET /pay` | 返回带 `PAYMENT-REQUIRED` 头的 `402 Payment Required` |
+| `POST /pay` | 校验支付、结算，并返回交易 |
+
+**示例：**
+
+```bash
+x402-cli serve --pay-to T... --network tron:nile --token USDT
+```
+
+```bash
+x402-cli serve --pay-to 0x... --network eip155:97 --token USDT --amount 0.0001 --daemon
+```
+
+---
+
+## `roundtrip`
+
+启动一个临时本地服务、立即支付它、然后退出。这是最快的完整端到端测试。它接受 `serve` 与 `pay` 的全部选项之和。
+
+```bash
+x402-cli roundtrip --pay-to <address> [serve/pay 选项]
+```
+
+**示例：**
+
+```bash
+TRON_PRIVATE_KEY=<hex> x402-cli roundtrip \
+  --pay-to T... --amount 0.0001 --network tron:nile --token USDT
+```
+
+---
+
+## `gateway`
+
+管理本地网关的 provider 文件——校验、脚手架、启动网关进程，以及从 `provider.yml` 文件构建目录资产。
+
+```bash
+x402-cli gateway <search|start|check|scaffold|catalog> [options]
+```
+
+| 子命令 | 说明 |
+| :--- | :--- |
+| `search <query>` | 搜索目录资产（见 [`catalog search`](#catalog)） |
+| `start` | 启动本地 x402 网关进程 |
+| `check <providers>` | 校验一个或多个 `provider.yml` 文件 |
+| `scaffold <name>` | 生成一个起步用的 `provider.yml` |
+| `catalog <command>` | 构建/校验/搜索网关目录资产 |
+
+`start` 与 `gateway catalog` 需要 `@bankofai/x402-gateway` 运行时。请安装它（`npm install -g @bankofai/x402-gateway`）、从含有 `../x402-gateway/dist/cli.js` 的代码检出中运行，或通过 `--gateway-bin <path>` 指定。
+
+**校验 provider 文件：**
+
+```bash
+x402-cli gateway check ./providers
+```
+
+**生成一个新的 provider：**
+
+```bash
+x402-cli gateway scaffold my-service --forward-url https://api.myservice.com
+```
+
+这会写出 `providers/my-service/provider.yml`，其中包含可直接编辑的模板（网络、收款地址、货币，以及一个示例计费接口）。
+
+**启动网关：**
+
+```bash
+x402-cli gateway start --providers ./providers --host 127.0.0.1 --port 4020
+```
+
+### `gateway catalog`
+
+```bash
+x402-cli gateway catalog <build|check|pay-assets|search> [options]
+```
+
+| 子命令 | 说明 |
+| :--- | :--- |
+| `build <providers>` | 从 `provider.yml` 文件构建本地目录 |
+| `check <providers>` | 校验本地 `provider.yml` 文件 |
+| `pay-assets <providers>` | 列出可付费的接口资产（方法、路径、网络、价格） |
+| `search <query>` | 搜索目录资产 |
+
+```bash
+x402-cli gateway catalog pay-assets ./providers --json
+```
+
+---
+
+## `catalog`
+
+搜索、缓存、查看并导出托管的服务目录。
+
+```bash
+x402-cli catalog <update|search|show|endpoints|pay-json|export-gateway|build> [options]
+```
+
+| 子命令 | 说明 |
+| :--- | :--- |
+| `update` | 将托管/本地目录资产缓存到 `~/.cache/x402-cli/catalog` |
+| `search <query>` | 按名称、标签、链、类别、接口搜索服务 |
+| `show <provider>` | 显示服务详情 JSON |
+| `endpoints <provider>` | 列出某服务的接口 |
+| `pay-json <provider>` | 打印某服务的付费 JSON（可付费路由详情） |
+| `export-gateway <url>` | 从一个运行中的网关导出 `catalog.json` 和 `pay.md` |
+| `build <providers>` | 从本地 `provider.yml` 文件构建目录 |
+
+**常用选项：**
+
+| 选项 | 说明 |
+| :--- | :--- |
+| `--catalog <source>` | `catalog.json` 路径或 URL |
+| `--provider <fqn>` | 服务 FQN（用于 `export-gateway`） |
+| `--output-dir <dir>` | 生成文件的输出目录 |
+| `-n, --limit <count>` | 搜索结果数量上限（默认：`10`） |
+| `--include-blocked` | 在搜索结果中包含被屏蔽的服务 |
+| `--timeout-ms <ms>` | 网络超时（毫秒，默认：`30000`） |
+| `--force` | 覆盖已存在的文件（用于 `export-gateway`） |
+| `--raw` | 打印原始付费载荷（用于 `pay-json`） |
+| `--json` | 打印结构化 JSON 输出 |
+
+**目录来源解析。** 省略 `--catalog` 时，CLI 按以下顺序解析来源：环境变量 `X402_CATALOG` 或 `X402_GATEWAY_CATALOG`，然后是本地缓存 `~/.cache/x402-cli/catalog/catalog.json`，最后是托管默认值 `https://x402-catalog.bankofai.io/api/catalog.json`。
+
+**示例：**
+
+```bash
+# 将托管目录缓存到本地，实现快速、离线搜索
+x402-cli catalog update
+```
+
+```bash
+# 搜索服务，限制 5 条结果
+x402-cli catalog search "weather forecast" -n 5
+```
+
+```bash
+# 查看某个服务
+x402-cli catalog show acme.weather
+x402-cli catalog endpoints acme.weather --json
+```
+
+```bash
+# 获取某服务的可付费路由 JSON
+x402-cli catalog pay-json acme.weather --raw
+```
+
+```bash
+# 从运行中的网关导出 catalog.json + pay.md
+x402-cli catalog export-gateway https://gateway.example.com \
+  --provider acme.weather --output-dir ./out --force
+```
+
+---
+
+## 退出码
+
+| 退出码 | 含义 |
+| :--- | :--- |
+| `0` | 成功 |
+| `1` | 运行时错误（网络、钱包、结算等） |
+| `2` | 用法错误（缺少/非法参数、未知命令） |
+
+完整的错误码列表及修复方法，见 [FAQ 与故障排查](./faq.md)。
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/faq.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/faq.md
new file mode 100644
index 00000000..effb5d1a
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/faq.md
@@ -0,0 +1,136 @@
+---
+title: 'FAQ 与故障排查'
+description: >-
+  x402 CLI 的常见问题、错误码与修复方法。
+---
+
+# FAQ 与故障排查
+
+x402 CLI 的常见问题与排查建议。
+
+---
+
+## 安装与配置
+
+### 系统要求是什么？
+
+- **Node.js** 20 或更高
+- **npm**（随 Node.js 一起安装）
+- macOS、Linux 或 Windows（推荐 WSL）上的终端
+
+### 如何更新 CLI？
+
+```bash
+npm update -g @bankofai/x402-cli
+```
+
+### 不全局安装能用吗？
+
+可以。在已安装它的项目里运行 `node dist/cli.js <command>`，或使用 `npx @bankofai/x402-cli <command>`。
+
+---
+
+## 钱包与支付
+
+### 使用 CLI 一定要钱包吗？
+
+只有真正付款时才需要。只读命令——`pay --dry-run`、`catalog search`、`catalog show`、`gateway check`——都无需钱包。真正的 `pay` 或 `roundtrip` 才需要付款方私钥。
+
+### 如何提供私钥？
+
+设置以下环境变量之一：
+
+- **TRON 网络** → `TRON_PRIVATE_KEY`
+- **EVM 网络**（BSC） → `EVM_PRIVATE_KEY`
+- **两种网络通用** → `PRIVATE_KEY`，当没有设置对应网络的专用变量时作为回退
+
+你也可以用 `--private-key <hex>` 为单条命令传入，但请避免在共享 Shell 或提交到版本库的脚本里这样做——命令行参数会被记录到 Shell 历史和进程列表中。
+
+:::caution
+任何超出一次性测试范围的场景，请使用 [agent-wallet](../../Agent-Wallet/Intro.md) 付款钱包，而不是裸露的环境变量私钥；并且付款方地址里只保留当前任务所需的最小额度。
+:::
+
+### 支付会超出我的预期金额吗？
+
+只要你封顶就不会。用 `--max-amount <人类可读金额>` 或 `--max-raw-amount <最小单位>`；如果接口价格超过上限，CLI 会在签名**之前**中止。拿不准时，先 `pay --dry-run` 看清确切的支付要求。
+
+### 支持哪些网络和代币？
+
+TRON（`tron:mainnet`、`tron:nile`、`tron:shasta`）与 BSC（`eip155:56`、`eip155:97`），并按网络内置 USDT、USDD、USDC 的注册表。完整表格见 [x402 CLI 概览](./index.md#支持的网络与代币)。若代币未注册，用 `--asset <address>` 搭配 `--decimals <count>`。
+
+---
+
+## 读懂错误
+
+每次失败都会打印一个稳定的错误 `code`、一条 message 和一个 `hint`。加上 `--json` 可得到承载同样信息的结构化 JSON 输出。最常见的错误码：
+
+| 错误码 | 发生了什么 | 如何修复 |
+| :--- | :--- | :--- |
+| `WALLET_NOT_CONFIGURED` | 找不到付款方私钥 | 设置 `TRON_PRIVATE_KEY` / `EVM_PRIVATE_KEY` / `PRIVATE_KEY`，或配置 agent-wallet 付款钱包 |
+| `TRON_ACCOUNT_NOT_ACTIVATED` | 该 TRON 地址从未在链上使用过 | 先给它转一小笔 TRX 激活，再签名 |
+| `INSUFFICIENT_TOKEN_BALANCE` | 付款方缺少被收取的代币 | 用服务方宣告的确切代币和网络给付款方充值 |
+| `INSUFFICIENT_GAS` | 原生 gas / 能量不足 | 给付款方充值该网络的原生 gas 代币（TRX / BNB） |
+| `NO_MATCHING_PAYMENT_REQUIREMENT` | 没有符合你筛选条件的支付要求 | 放宽 `--network`、`--token` 或 `--scheme`，或使用服务方提供的值 |
+| `PAYMENT_AMOUNT_TOO_HIGH` | 价格超过了你的 `--max-amount` | 确认价格符合预期后再提高上限 |
+| `INVALID_X402_RESPONSE` | 接口返回 `402` 但缺少 `PAYMENT-REQUIRED` 头 | 接口配置有误，请联系服务方 |
+| `PERMIT_REVERTED` | 代币/Permit2 拒绝了签名 | 用一份全新的支付要求重试；核实代币/网络支持情况 |
+| `DEADLINE_OR_CLOCK_SKEW` | 支付要求过期或本地时钟偏差 | 校准本地时钟，用全新支付要求重试 |
+| `RATE_LIMITED` | 上游服务或 RPC 在限流 | 稍候再重试 |
+| `NETWORK_ERROR` | 无法访问 URL/RPC | 检查 URL、本地服务、代理和网络连通性 |
+| `SDK_API_DRIFT` | 已安装的 SDK 包与 CLI 不匹配 | 重装 `@bankofai/x402-cli` 及其 SDK 依赖 |
+
+### "402 response missing PAYMENT-REQUIRED header"
+
+接口返回了 `402` 却没有附带机器可读的 `PAYMENT-REQUIRED` 支付要求头。这是服务端配置问题——CLI 无法从中推导出支付要求。
+
+### "no matching payment requirement"
+
+接口提供了支付选项，但没有一个符合你的 `--network`、`--token` 或 `--scheme` 筛选。去掉这些筛选、运行 `pay --dry-run --json`，看看服务方实际接受什么，再据此收窄条件。
+
+---
+
+## 网关
+
+### `gateway start` 提示找不到运行时
+
+`gateway start` 与 `gateway catalog` 需要独立的 `@bankofai/x402-gateway` 包。请安装它（`npm install -g @bankofai/x402-gateway`）、从含有 `../x402-gateway/dist/cli.js` 的检出中运行，或用 `--gateway-bin <path>` 指向可执行文件。
+
+### 部署前如何校验我的 provider 文件？
+
+```bash
+x402-cli gateway check ./providers
+```
+
+它会解析每个 `provider.yml`，检查必填字段（`name`、`forward_url`、`operator.network`、`operator.recipient`），校验每个接口，并报告重复项。
+
+---
+
+## 服务目录
+
+### `catalog` 默认从哪里读取？
+
+省略 `--catalog` 时，来源按此顺序解析：环境变量 `X402_CATALOG` / `X402_GATEWAY_CATALOG`，然后是本地缓存（`~/.cache/x402-cli/catalog/catalog.json`），最后是托管默认值 `https://x402-catalog.bankofai.io/api/catalog.json`。
+
+### 如何让搜索更快或离线可用？
+
+运行一次 `x402-cli catalog update`，把托管目录和服务详情缓存到本地，之后的搜索都从缓存读取。
+
+---
+
+## 输出与脚本
+
+### 如何获取机器可读的输出？
+
+给任意命令加 `--json`，即可得到含 `ok`、`command`，以及 `result` 或结构化 `error` 的 JSON 输出。这是脚本和 AI Agent 推荐使用的模式。
+
+### 退出码分别代表什么？
+
+`0` 成功，`1` 运行时错误（网络、钱包、结算），`2` 用法错误（缺少/非法参数或未知命令）。
+
+---
+
+## 还是卡住了？
+
+- 用 `x402-cli <command> --help` 重新查看某命令的确切用法。
+- 在 [命令参考](./command-reference.md) 里查阅每个参数。
+- 在 [核心概念](../core-concepts/http-402.md) 中了解底层握手的运作方式。
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/index.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/index.md
new file mode 100644
index 00000000..ec4f570b
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/index.md
@@ -0,0 +1,126 @@
+---
+title: 'x402 CLI'
+description: >-
+  x402 CLI（@bankofai/x402-cli）是一个 TypeScript 命令行客户端——在终端里直接支付受保护的 URL、启动本地付费端点、管理服务目录。
+---
+
+# x402 CLI
+
+## 什么是 x402 CLI？
+
+x402 CLI（`@bankofai/x402-cli`）把 [x402 支付协议](../index.md)搬进了你的终端。它是一个依赖极简的命令，让人工操作者、Shell 脚本，或者一个 AI Agent 都能**支付一个受 x402 保护的 URL、启动本地付费端点、浏览服务目录**——不用写任何集成代码。
+
+可以这样理解：[x402 SDK](../sdk-features.md) 是你嵌进应用里、用来收费或付费的那层能力；而 CLI 是同一套能力，被包装成一条你现在就能敲的命令：
+
+```bash
+# 支付任意受 x402 保护的接口
+x402-cli pay https://api.example.com/paid --network tron:nile --token USDT
+```
+
+它完全构建在已发布的 TypeScript SDK 包之上——`@bankofai/x402-core`、`@bankofai/x402-evm`、`@bankofai/x402-tron`——每一笔稳定币支付都使用 `scheme=exact` 配合 Permit2 授权（`extra.assetTransferMethod=permit2`）。
+
+---
+
+## 它能做什么？
+
+CLI 把能力归为五条命令。
+
+| 命令 | 作用 | 示例 |
+| :--- | :--- | :--- |
+| **`pay`** | 支付一个受 x402 保护的 URL：探测接口、读取 `402` 支付要求、签名并重试。 | `x402-cli pay <url> --network tron:nile --token USDT` |
+| **`serve`** | 启动本地 x402 付费端点，返回 `402 Payment Required` 并通过 Facilitator 结算。 | `x402-cli serve --pay-to <address> --amount 0.0001` |
+| **`roundtrip`** | 启动临时服务、立即支付、随后退出——端到端冒烟测试的最快方式。 | `x402-cli roundtrip --pay-to <address>` |
+| **`gateway`** | 管理本地网关的 provider 文件：校验、脚手架、启动、构建目录资产。 | `x402-cli gateway check ./providers` |
+| **`catalog`** | 搜索、缓存、查看、导出托管的服务目录。 | `x402-cli catalog search "weather"` |
+
+只读命令（`pay --dry-run`、`catalog search`、`gateway check`）无需钱包，只有真正发起支付时才需要付款方私钥。
+
+---
+
+## 默认给人看，需要时给机器看
+
+输出默认是人类友好的文本。给任意命令加上 `--json`，就能得到一份稳定的、机器可读的结构化 JSON 输出——非常适合脚本和 AI Agent：
+
+```bash
+x402-cli pay https://api.example.com/paid --dry-run --json
+```
+
+```json
+{
+  "ok": true,
+  "command": "client",
+  "network": "tron:nile",
+  "scheme": "exact",
+  "result": {
+    "url": "https://api.example.com/paid",
+    "message": "Dry run - no payment submitted"
+  }
+}
+```
+
+每一份 JSON 输出都带有 `ok`、`command`，以及一个 `result` 对象或一个结构化的 `error`（含 `code`、`message`、`hint`）。成功时还会在相关场景返回 `network` 和 `scheme`。
+
+---
+
+## 支持的网络与代币
+
+CLI 内置了代币注册表。用 `--network` 指定网络，用 `--token` 指定代币。
+
+| 网络 | 标识符 | 内置代币 |
+| :--- | :--- | :--- |
+| **TRON 主网** | `tron:mainnet` | USDT、USDD |
+| **TRON Nile 测试网** | `tron:nile` | USDT、USDD |
+| **TRON Shasta 测试网** | `tron:shasta` | USDT |
+| **BSC 主网** | `eip155:56` | USDT |
+| **BSC 测试网** | `eip155:97` | USDT、USDC |
+
+以下简写别名会被自动接受并归一化：
+
+| 别名 | 标准标识符 |
+| :--- | :--- |
+| `tron-mainnet` | `tron:mainnet` |
+| `tron-nile` | `tron:nile` |
+| `tron-shasta` | `tron:shasta` |
+| `bsc-mainnet` | `eip155:56` |
+| `bsc-testnet` | `eip155:97` |
+
+如果代币不在注册表里，用 `--asset <address>` 搭配 `--decimals <count>` 传入。
+
+---
+
+## CLI vs SDK
+
+两条路径说的是同一套协议，区别只在集成方式。
+
+| 对比 | x402 CLI | x402 SDK |
+| :--- | :--- | :--- |
+| **集成方式** | 命令行（Shell 调用） | 引入到你的 TypeScript 应用中 |
+| **最适合** | 手动测试、脚本、CI/CD、通过 Shell 调用的 AI Agent | 生产级服务与客户端 |
+| **安装** | `npm install -g @bankofai/x402-cli` | `npm install @bankofai/x402-*` |
+| **输出** | 人类文本或 `--json` 结构化输出 | 原生 SDK 对象 |
+
+:::tip 该选哪个？
+用 CLI 去探索、测试、编写脚本对接 x402 接口，或者通过 Shell 给 AI Agent 赋予支付能力。当你要把支付嵌进真实产品时，直接基于 [SDK](../sdk-features.md) 构建。
+:::
+
+---
+
+## 安全须知
+
+:::warning
+支付会转移真实的链上资产，且不可撤销。请牢记以下原则：
+
+- **绝不硬编码私钥。** 在共享环境中，优先用环境变量（`TRON_PRIVATE_KEY`、`EVM_PRIVATE_KEY`、`PRIVATE_KEY`）或一个 [agent-wallet](../../Agent-Wallet/Intro.md) 付款钱包，而不是 `--private-key` 参数。
+- **先在测试网上验证。** 上主网前，先用 `tron:nile` 或 `eip155:97` 跑通。
+- **付款前先预览。** 用 `pay --dry-run` 在签名前看清确切的支付要求。
+- **给金额设上限。** 用 `--max-amount` 或 `--max-raw-amount`，让定价异常的接口无法超额扣款。
+- **只放最小额度。** 付款方地址里只保留当前任务所需的资金。
+:::
+
+---
+
+## 下一步
+
+- 想快速跑通第一笔支付？→ [快速开始](./quickstart.md)
+- 需要完整的命令与参数？→ [命令参考](./command-reference.md)
+- 遇到问题或有疑问？→ [FAQ 与故障排查](./faq.md)
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/quickstart.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/quickstart.md
new file mode 100644
index 00000000..3ff244bd
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/x402/cli/quickstart.md
@@ -0,0 +1,136 @@
+---
+title: '快速开始'
+description: >-
+  安装 x402 CLI，在 TRON Nile 测试网上几分钟内跑通一次完整的"支付—结算"回路。
+---
+
+# 快速开始
+
+这一页的目标很简单：**安装 CLI，在测试网上几分钟内跑通一次完整的支付回路。** 所有测试网操作都使用免费测试代币——不涉及任何真实资金。
+
+---
+
+## 准备工作
+
+开始前，请确认你已具备：
+
+1. **Node.js** >= 20（[下载](https://nodejs.org/)）
+2. **npm**（随 Node.js 一起安装）
+3. 用于支付步骤的一个有余额的测试网地址——一个 TRON **Nile** 地址，持有少量测试 **USDT** 和 **TRX**（用于能量）。参见 [钱包](../core-concepts/wallet.md)。
+
+验证你的环境：
+
+```bash
+node --version   # v20.x 或更高
+npm --version
+```
+
+---
+
+## 第 1 步：安装
+
+全局安装 CLI，让 `x402-cli` 命令在任何地方都可用：
+
+```bash
+npm install -g @bankofai/x402-cli
+```
+
+确认它已就绪：
+
+```bash
+x402-cli --version
+x402-cli --help
+```
+
+你应当看到版本号，以及命令列表（`pay`、`serve`、`roundtrip`、`gateway`、`catalog`）。
+
+---
+
+## 第 2 步：先不花钱试一试
+
+看到接口真实返回的 `402` 支付要求的最快方式是**空跑（dry run）**。它会探测接口、读取支付要求，并原样打印出你将被要求支付的内容——但不签名、不花钱：
+
+```bash
+x402-cli pay https://api.example.com/paid \
+  --network tron:nile \
+  --token USDT \
+  --dry-run \
+  --json
+```
+
+`--dry-run` 的输出包含被选中的支付要求（网络、资产、金额、收款地址）。这就是你的安全网：支付一个陌生接口前，永远先空跑一次。
+
+---
+
+## 第 3 步：在测试网跑一次完整回路
+
+`roundtrip` 会启动一个临时的本地付费端点、支付它、然后退出——一次完整的端到端测试。你需要一个 Nile 测试网的付款方私钥。
+
+```bash
+TRON_PRIVATE_KEY=<你的-nile-十六进制私钥> \
+x402-cli roundtrip \
+  --pay-to <你的-nile-收款地址> \
+  --amount 0.0001 \
+  --network tron:nile \
+  --token USDT
+```
+
+成功时，CLI 会打印出已结算的交易。那串交易哈希，就是这笔支付已在链上清算的凭证——恭喜，你的环境端到端跑通了。
+
+:::caution 保管好你的私钥
+私钥请通过环境变量传入（TRON 用 `TRON_PRIVATE_KEY`，EVM 用 `EVM_PRIVATE_KEY`，`PRIVATE_KEY` 是两种网络通用的回退），绝不要在共享 Shell 或提交到版本库的脚本里以明文命令行参数传递——命令行参数可能被本机其它进程看到。任何超出一次性测试范围的场景，请使用 [agent-wallet](../../Agent-Wallet/QuickStart.md) 付款钱包。
+:::
+
+---
+
+## 第 4 步：支付真实的 x402 接口
+
+回路跑通后，支付任意受 x402 保护的 URL，就是同一条 `pay` 命令指向真实资源：
+
+```bash
+TRON_PRIVATE_KEY=<你的十六进制私钥> \
+x402-cli pay https://api.example.com/paid \
+  --network tron:nile \
+  --token USDT \
+  --max-amount 0.01
+```
+
+`--max-amount` 给你愿意支付的金额封顶：如果接口价格超过它，CLI 会在签名前中止。EVM 网络请使用 `EVM_PRIVATE_KEY`（或通用回退 `PRIVATE_KEY`）以及像 `eip155:97` 这样的 EVM 网络。
+
+---
+
+## 可选：运行你自己的付费端点
+
+想收费而不是付费？启动一个本地 x402 服务：
+
+```bash
+x402-cli serve \
+  --pay-to <你的收款地址> \
+  --amount 0.0001 \
+  --network tron:nile \
+  --token USDT \
+  --port 4020
+```
+
+它会暴露以下路由：
+
+- `GET /health` —— 存活检查
+- `GET /.well-known/x402` —— 机器可读的支付元数据
+- `GET /pay` —— 返回 `402 Payment Required`
+- `POST /pay` —— 通过 Facilitator 校验并结算已提交的支付
+
+在另一个终端里支付它：
+
+```bash
+TRON_PRIVATE_KEY=<hex> x402-cli pay http://127.0.0.1:4020/pay --network tron:nile --token USDT
+```
+
+用 `--facilitator-url` 指向特定的 Facilitator（默认 `https://facilitator.bankofai.io`），加上 `--daemon` 可让服务在后台运行并打印子进程 id。
+
+---
+
+## 下一步
+
+- **[命令参考](./command-reference.md)** —— 每条命令与参数：`pay`、`serve`、`roundtrip`、`gateway`、`catalog`。
+- **[FAQ 与故障排查](./faq.md)** —— 修复常见错误、读懂错误码。
+- **[核心概念](../core-concepts/http-402.md)** —— `402` 握手与 Facilitator 结算到底是怎么运作的。
diff --git a/i18n/zh-Hans/docusaurus-theme-classic/navbar.json b/i18n/zh-Hans/docusaurus-theme-classic/navbar.json
index 6e0d834a..f4893a8d 100644
--- a/i18n/zh-Hans/docusaurus-theme-classic/navbar.json
+++ b/i18n/zh-Hans/docusaurus-theme-classic/navbar.json
@@ -7,16 +7,20 @@
     "message": "BANK OF AI",
     "description": "The alt text of navbar logo"
   },
-  "item.label.GitHub": {
-    "message": "GitHub",
-    "description": "Navbar item with label GitHub"
+  "item.label.Docs": {
+    "message": "文档",
+    "description": "Navbar item with label Docs"
+  },
+  "item.label.Best Practices": {
+    "message": "最佳实践",
+    "description": "Navbar item with label Best Practices"
+  },
+  "item.label.Changelogs": {
+    "message": "更新日志",
+    "description": "Navbar item with label Changelogs"
   },
   "item.label.Demo": {
     "message": "Demo",
     "description": "Navbar item with label Demo"
-  },
-  "item.label.TRON": {
-    "message": "TRON",
-    "description": "Navbar item with label TRON"
   }
 }
diff --git a/package.json b/package.json
index 473ddd09..8d1f7526 100644
--- a/package.json
+++ b/package.json
@@ -1,8 +1,11 @@
 {
   "name": "@x402-tron/docs",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "description": "x402-tron documentation",
   "license": "MIT",
+  "resolutions": {
+    "cheerio": "1.0.0-rc.12"
+  },
   "scripts": {
     "docusaurus": "docusaurus",
     "start": "NODE_OPTIONS='--openssl-legacy-provider' docusaurus start",
@@ -22,6 +25,7 @@
     "@docusaurus/preset-classic": "2.4.3",
     "@docusaurus/remark-plugin-npm2yarn": "2.4.3",
     "@docusaurus/theme-common": "2.4.3",
+    "@easyops-cn/docusaurus-search-local": "^0.35.0",
     "@mdx-js/react": "^1.6.21",
     "@types/react": "^17.0.11",
     "clsx": "^1.1.1",
diff --git a/sidebars.js b/sidebars.js
index 0c02f957..bfd98f35 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -4,15 +4,27 @@ const sidebars = {
     {
       type: 'category',
       label: 'BANK OF AI',
+      className: 'sidebar-icon sidebar-icon-bankofai',
       collapsed: false,
       items: [
         'BANK-OF-AI/Intro',
         'BANK-OF-AI/QuickStart',
+        {
+          type: 'link',
+          label: 'Official Website',
+          href: 'https://bankofai.io/',
+        },
+        {
+          type: 'link',
+          label: 'GitHub',
+          href: 'https://github.com/BofAI',
+        },
       ],
     },
     {
       type: 'category',
       label: 'x402 Payment Protocol',
+      className: 'sidebar-icon sidebar-icon-x402',
       collapsed: false,
       items: [
         {
@@ -23,12 +35,13 @@ const sidebars = {
         {
           type: 'category',
           label: 'Getting Started',
+          collapsed: true,
           items: [
             'x402/getting-started/quickstart-for-sellers',
             {
               type: 'category',
               label: 'Quickstart for Buyers',
-              collapsed: false,
+              collapsed: true,
               items: ['x402/getting-started/quickstart-for-human', 'x402/getting-started/quickstart-for-agent'],
             },
           ],
@@ -45,7 +58,7 @@ const sidebars = {
             {
               type: 'category',
               label: 'API Catalog',
-              collapsed: false,
+              collapsed: true,
               items: [
                 'x402/api-catalog/index',
                 'x402/api-catalog/get-started',
@@ -62,6 +75,21 @@ const sidebars = {
           id: 'x402/sdk-features',
           label: 'SDK Features',
         },
+        {
+          type: 'category',
+          label: 'x402 CLI',
+          collapsed: true,
+          items: [
+            {
+              type: 'doc',
+              id: 'x402/cli/index',
+              label: 'Overview',
+            },
+            'x402/cli/quickstart',
+            'x402/cli/command-reference',
+            'x402/cli/faq',
+          ],
+        },
         {
           type: 'doc',
           id: 'x402/faq',
@@ -71,123 +99,21 @@ const sidebars = {
     },
     {
       type: 'category',
-      label: '8004 Protocol',
+      label: 'SKILLS',
+      className: 'sidebar-icon sidebar-icon-skills',
       collapsed: false,
       items: [
-        {
-          type: 'doc',
-          id: '8004/general',
-          label: 'Introduction',
-        },
-        {
-          type: 'doc',
-          id: '8004/contract',
-        },
-        {
-          type: 'doc',
-          id: '8004/QuickStart',
-        },
-        {
-          type: 'doc',
-          id: '8004/SupportedNetworks',
-        },
-        {
-          type: 'category',
-          label: 'Usage',
-          collapsed: false,
-          items: ['8004/Usage/Install', '8004/Usage/ConfigureAgents', '8004/Usage/RegistrationHTTP'],
-        },
-      ],
-    },
-    {
-      type: 'category',
-      label: 'MCP Server & SKILLS',
-      collapsed: false,
-      items: [
-        {
-          type: 'doc',
-          id: 'McpServer-Skills/Intro',
-          label: 'Introduction',
-        },
-        {
-          type: 'category',
-          label: 'MCP Server',
-          collapsed: false,
-          items: [
-            'McpServer-Skills/MCP/Intro',
-            {
-              type: 'category',
-              label: 'TRON MCP Server',
-              collapsed: true,
-              items: [
-                'McpServer-Skills/MCP/TRONMCPServer/Intro',
-                'McpServer-Skills/MCP/TRONMCPServer/QuickStart',
-                'McpServer-Skills/MCP/TRONMCPServer/OfficialServerAccess',
-                'McpServer-Skills/MCP/TRONMCPServer/LocalPrivatizedDeployment',
-                'McpServer-Skills/MCP/TRONMCPServer/ToolList',
-                'McpServer-Skills/MCP/TRONMCPServer/FAQ',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'SUN MCP Server',
-              collapsed: true,
-              items: [
-                'McpServer-Skills/MCP/SUNMCPServer/Intro',
-                'McpServer-Skills/MCP/SUNMCPServer/QuickStart',
-                'McpServer-Skills/MCP/SUNMCPServer/OfficialServerAccess',
-                'McpServer-Skills/MCP/SUNMCPServer/LocalPrivatizedDeployment',
-                'McpServer-Skills/MCP/SUNMCPServer/ToolList',
-                'McpServer-Skills/MCP/SUNMCPServer/FAQ',
-              ],
-            },
-            {
-              type: 'category',
-              label: 'BSC MCP Server',
-              collapsed: true,
-              items: [
-                'McpServer-Skills/MCP/BSCMCPServer/Intro',
-                'McpServer-Skills/MCP/BSCMCPServer/Features',
-                'McpServer-Skills/MCP/BSCMCPServer/Installation',
-              ],
-            },
-          ],
-        },
-        {
-          type: 'category',
-          label: 'SKILLS',
-          collapsed: false,
-          items: [
-            'McpServer-Skills/SKILLS/Intro',
-            'McpServer-Skills/SKILLS/QuickStart',
-            'McpServer-Skills/SKILLS/BANKOFAISkill',
-            'McpServer-Skills/SKILLS/Faq',
-          ],
-        },
-        {
-          type: 'category',
-          label: 'TOOLS',
-          collapsed: false,
-          items: [
-            {
-              type: 'category',
-              label: 'SUN CLI',
-              collapsed: true,
-              items: [
-                'McpServer-Skills/Tools/SUNCli/Intro',
-                'McpServer-Skills/Tools/SUNCli/QuickStart',
-                'McpServer-Skills/Tools/SUNCli/CommandGuide',
-                'McpServer-Skills/Tools/SUNCli/FAQ',
-              ],
-            },
-          ],
-        },
+        'McpServer-Skills/SKILLS/Intro',
+        'McpServer-Skills/SKILLS/QuickStart',
+        'McpServer-Skills/SKILLS/BANKOFAISkill',
+        'McpServer-Skills/SKILLS/Faq',
       ],
     },
     {
       type: 'category',
       label: 'Agent Wallet',
-      collapsed: false,
+      className: 'sidebar-icon sidebar-icon-wallet',
+      collapsed: true,
       items: [
         'Agent-Wallet/Intro',
         'Agent-Wallet/QuickStart',
@@ -204,17 +130,11 @@ const sidebars = {
         'Agent-Wallet/FAQ',
       ],
     },
-    {
-      type: 'category',
-      label: 'Openclaw Extension',
-      collapsed: false,
-      items: ['Openclaw-extension/Intro', 'Openclaw-extension/QuickStart', 'Openclaw-extension/FAQ'],
-    },
-
     {
       type: 'category',
       label: 'LLM Service',
-      collapsed: false,
+      className: 'sidebar-icon sidebar-icon-llm',
+      collapsed: true,
       items: [
         { type: 'doc', id: 'llmservice/introduction', label: 'Introduction' },
         { type: 'doc', id: 'llmservice/quick-start', label: 'Quick Start' },
@@ -348,6 +268,76 @@ const sidebars = {
         },
       ],
     },
+    {
+      type: 'category',
+      label: 'MCP Server',
+      className: 'sidebar-icon sidebar-icon-mcp',
+      collapsed: true,
+      items: [
+        'McpServer-Skills/MCP/Intro',
+        {
+          type: 'category',
+          label: 'TRON MCP Server',
+          collapsed: true,
+          items: [
+            'McpServer-Skills/MCP/TRONMCPServer/Intro',
+            'McpServer-Skills/MCP/TRONMCPServer/QuickStart',
+            'McpServer-Skills/MCP/TRONMCPServer/OfficialServerAccess',
+            'McpServer-Skills/MCP/TRONMCPServer/LocalPrivatizedDeployment',
+            'McpServer-Skills/MCP/TRONMCPServer/ToolList',
+            'McpServer-Skills/MCP/TRONMCPServer/FAQ',
+          ],
+        },
+        {
+          type: 'category',
+          label: 'BSC MCP Server',
+          collapsed: true,
+          items: [
+            'McpServer-Skills/MCP/BSCMCPServer/Intro',
+            'McpServer-Skills/MCP/BSCMCPServer/Features',
+            'McpServer-Skills/MCP/BSCMCPServer/Installation',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'category',
+      label: '8004 Protocol',
+      className: 'sidebar-icon sidebar-icon-8004',
+      collapsed: true,
+      items: [
+        {
+          type: 'doc',
+          id: '8004/general',
+          label: 'Introduction',
+        },
+        {
+          type: 'doc',
+          id: '8004/contract',
+        },
+        {
+          type: 'doc',
+          id: '8004/QuickStart',
+        },
+        {
+          type: 'doc',
+          id: '8004/SupportedNetworks',
+        },
+        {
+          type: 'category',
+          label: 'Usage',
+          collapsed: true,
+          items: ['8004/Usage/Install', '8004/Usage/ConfigureAgents', '8004/Usage/RegistrationHTTP'],
+        },
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Openclaw Extension',
+      className: 'sidebar-icon sidebar-icon-openclaw',
+      collapsed: true,
+      items: ['Openclaw-extension/Intro', 'Openclaw-extension/QuickStart', 'Openclaw-extension/FAQ'],
+    },
   ],
 }
 
diff --git a/sidebarsChangelog.js b/sidebarsChangelog.js
new file mode 100644
index 00000000..5a3a9e6d
--- /dev/null
+++ b/sidebarsChangelog.js
@@ -0,0 +1,47 @@
+/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
+const sidebars = {
+  changelogSidebar: [
+    {
+      type: 'doc',
+      id: 'index',
+      label: 'All Products',
+    },
+    {
+      type: 'doc',
+      id: 'x402',
+      label: 'x402 Payment Protocol',
+    },
+    {
+      type: 'doc',
+      id: 'skills',
+      label: 'SKILLS',
+    },
+    {
+      type: 'doc',
+      id: 'agent-wallet',
+      label: 'Agent Wallet',
+    },
+    {
+      type: 'doc',
+      id: 'llm-service',
+      label: 'LLM Service',
+    },
+    {
+      type: 'doc',
+      id: 'mcp-server',
+      label: 'MCP Server',
+    },
+    {
+      type: 'doc',
+      id: '8004',
+      label: '8004 Protocol',
+    },
+    {
+      type: 'doc',
+      id: 'openclaw-extension',
+      label: 'Openclaw Extension',
+    },
+  ],
+}
+
+module.exports = sidebars
diff --git a/sidebarsDevnotes.js b/sidebarsDevnotes.js
new file mode 100644
index 00000000..3df9c642
--- /dev/null
+++ b/sidebarsDevnotes.js
@@ -0,0 +1,13 @@
+/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
+const sidebars = {
+  devnotesSidebar: [
+    {
+      type: 'doc',
+      id: 'index',
+      label: 'Overview',
+    },
+    'first-onchain-swap',
+  ],
+}
+
+module.exports = sidebars
diff --git a/src/css/sidebar.css b/src/css/sidebar.css
new file mode 100644
index 00000000..bca0688c
--- /dev/null
+++ b/src/css/sidebar.css
@@ -0,0 +1,320 @@
+/* ============================================================
+   Sidebar: separate top-level sections with spacing + a divider
+   so each major group reads as its own block instead of one
+   cramped list. (Getting Started / Trade / Liquidity style)
+
+   Loaded via preset `theme.customCss` so it is webpack-bundled
+   (content-hashed → cache-proof, hot-reloads in dev).
+
+   NOTE: this project swizzles DocSidebarItem to wrap every item
+   in a <div>, so `.theme-doc-sidebar-menu > .menu__list-item`
+   does NOT match. We match the wrapper <div> via :has() and use
+   the adjacent-sibling (+) combinator between two top-level
+   sections. (Mirrors sunio-docs-site.)
+   ============================================================ */
+
+/* Divider + gap ONLY between two consecutive top-level sections
+   (naturally skips the first section, never draws inside a section). */
+.theme-doc-sidebar-menu > div:has(> .theme-doc-sidebar-item-category-level-1) + div:has(> .theme-doc-sidebar-item-category-level-1),
+.theme-doc-sidebar-menu > div:has(> .theme-doc-sidebar-item-category-level-1) + div:has(> .theme-doc-sidebar-item-link-level-1),
+.theme-doc-sidebar-menu > div:has(> .theme-doc-sidebar-item-link-level-1) + div:has(> .theme-doc-sidebar-item-category-level-1),
+.theme-doc-sidebar-menu > div:has(> .theme-doc-sidebar-item-link-level-1) + div:has(> .theme-doc-sidebar-item-link-level-1) {
+  border-top: 1px solid rgba(0, 0, 0, 0.08) !important;
+  margin-top: 1.2rem !important;
+  padding-top: 1.2rem !important;
+}
+
+html[data-theme='dark'] .theme-doc-sidebar-menu > div:has(> .theme-doc-sidebar-item-category-level-1) + div:has(> .theme-doc-sidebar-item-category-level-1),
+html[data-theme='dark'] .theme-doc-sidebar-menu > div:has(> .theme-doc-sidebar-item-category-level-1) + div:has(> .theme-doc-sidebar-item-link-level-1),
+html[data-theme='dark'] .theme-doc-sidebar-menu > div:has(> .theme-doc-sidebar-item-link-level-1) + div:has(> .theme-doc-sidebar-item-category-level-1),
+html[data-theme='dark'] .theme-doc-sidebar-menu > div:has(> .theme-doc-sidebar-item-link-level-1) + div:has(> .theme-doc-sidebar-item-link-level-1) {
+  border-top-color: rgba(255, 255, 255, 0.12) !important;
+}
+
+/* Fallback for browsers without :has() — put a divider above every
+   top-level section, then remove it from the first one. */
+@supports not selector(:has(*)) {
+  .theme-doc-sidebar-item-category-level-1,
+  .theme-doc-sidebar-item-link-level-1 {
+    border-top: 1px solid rgba(0, 0, 0, 0.08) !important;
+    margin-top: 1.2rem !important;
+    padding-top: 1.2rem !important;
+  }
+  html[data-theme='dark'] .theme-doc-sidebar-item-category-level-1,
+  html[data-theme='dark'] .theme-doc-sidebar-item-link-level-1 {
+    border-top-color: rgba(255, 255, 255, 0.12) !important;
+  }
+  .theme-doc-sidebar-menu > div:first-child > .theme-doc-sidebar-item-category-level-1,
+  .theme-doc-sidebar-menu > div:first-child > .theme-doc-sidebar-item-link-level-1 {
+    border-top: none !important;
+    margin-top: 0 !important;
+    padding-top: 0 !important;
+  }
+}
+
+/* Breathing room between EVERY sidebar block, at every nesting level.
+   The swizzle wraps each item in a <div>, so adjacent wrapper divs are
+   the unit of spacing; the plain `li + li` selector covers any
+   non-wrapped rendering (e.g. if the swizzle is removed later). */
+.menu__list > div + div,
+.menu__list > .menu__list-item + .menu__list-item {
+  margin-top: 0.45rem;
+}
+
+/* Slightly more air around an expanded sub-list so a category's
+   children read as one group */
+.menu__list .menu__list {
+  margin-top: 0.45rem;
+  padding-bottom: 0.2rem;
+}
+
+/* Make each top-level label read as a section header (bolder, brighter) */
+.theme-doc-sidebar-item-category-level-1 > .menu__list-item-collapsible > .menu__link,
+.theme-doc-sidebar-item-link-level-1 > .menu__link {
+  font-size: 15px;
+  font-weight: 700;
+  letter-spacing: 0.02em;
+  color: var(--ifm-color-emphasis-900);
+}
+
+/* Sub-items keep the normal weight so the hierarchy is obvious */
+.theme-doc-sidebar-item-category-level-1 .menu__list .menu__link {
+  font-weight: 400;
+}
+
+/* Top-level sections are collapsible (collapsed by default) so users can
+   scan every major section at a glance and expand only what they need.
+   Keep the caret visible so it's obvious each section expands. */
+.theme-doc-sidebar-item-category-level-1 > .menu__list-item-collapsible > .menu__link--sublist-caret::after {
+  display: inline-block;
+}
+
+
+/* ============================================================
+   Section icons for top-level sidebar categories.
+   Monochrome Lucide icons injected via CSS mask so they inherit
+   the label color (currentColor) and adapt to light/dark themes.
+   Class names are set per category in sidebars.js.
+   ============================================================ */
+.sidebar-icon > .menu__list-item-collapsible > .menu__link::before {
+  content: '';
+  display: inline-block;
+  width: 18px;
+  height: 18px;
+  margin-right: 9px;
+  vertical-align: -4px;
+  flex-shrink: 0;
+  background-color: currentColor;
+  -webkit-mask-repeat: no-repeat;
+  mask-repeat: no-repeat;
+  -webkit-mask-position: center;
+  mask-position: center;
+  -webkit-mask-size: contain;
+  mask-size: contain;
+}
+
+.sidebar-icon-bankofai > .menu__list-item-collapsible > .menu__link::before {
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpolygon%20points%3D%2712%202%202%207%2022%207%27%2F%3E%3Cline%20x1%3D%272%27%20y1%3D%2722%27%20x2%3D%2722%27%20y2%3D%2722%27%2F%3E%3Cline%20x1%3D%274%27%20y1%3D%2710%27%20x2%3D%274%27%20y2%3D%2718%27%2F%3E%3Cline%20x1%3D%279%27%20y1%3D%2710%27%20x2%3D%279%27%20y2%3D%2718%27%2F%3E%3Cline%20x1%3D%2715%27%20y1%3D%2710%27%20x2%3D%2715%27%20y2%3D%2718%27%2F%3E%3Cline%20x1%3D%2720%27%20y1%3D%2710%27%20x2%3D%2720%27%20y2%3D%2718%27%2F%3E%3C%2Fsvg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpolygon%20points%3D%2712%202%202%207%2022%207%27%2F%3E%3Cline%20x1%3D%272%27%20y1%3D%2722%27%20x2%3D%2722%27%20y2%3D%2722%27%2F%3E%3Cline%20x1%3D%274%27%20y1%3D%2710%27%20x2%3D%274%27%20y2%3D%2718%27%2F%3E%3Cline%20x1%3D%279%27%20y1%3D%2710%27%20x2%3D%279%27%20y2%3D%2718%27%2F%3E%3Cline%20x1%3D%2715%27%20y1%3D%2710%27%20x2%3D%2715%27%20y2%3D%2718%27%2F%3E%3Cline%20x1%3D%2720%27%20y1%3D%2710%27%20x2%3D%2720%27%20y2%3D%2718%27%2F%3E%3C%2Fsvg%3E");
+}
+
+.sidebar-icon-x402 > .menu__list-item-collapsible > .menu__link::before {
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Crect%20x%3D%272%27%20y%3D%276%27%20width%3D%2720%27%20height%3D%2712%27%20rx%3D%272%27%2F%3E%3Ccircle%20cx%3D%2712%27%20cy%3D%2712%27%20r%3D%272%27%2F%3E%3Cpath%20d%3D%27M6%2012h.01%27%2F%3E%3Cpath%20d%3D%27M18%2012h.01%27%2F%3E%3C%2Fsvg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Crect%20x%3D%272%27%20y%3D%276%27%20width%3D%2720%27%20height%3D%2712%27%20rx%3D%272%27%2F%3E%3Ccircle%20cx%3D%2712%27%20cy%3D%2712%27%20r%3D%272%27%2F%3E%3Cpath%20d%3D%27M6%2012h.01%27%2F%3E%3Cpath%20d%3D%27M18%2012h.01%27%2F%3E%3C%2Fsvg%3E");
+}
+
+.sidebar-icon-8004 > .menu__list-item-collapsible > .menu__link::before {
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpath%20d%3D%27M15%202H6a2%202%200%200%200-2%202v16a2%202%200%200%200%202%202h12a2%202%200%200%200%202-2V7z%27%2F%3E%3Cpolyline%20points%3D%2714%202%2014%208%2020%208%27%2F%3E%3Cline%20x1%3D%279%27%20y1%3D%2713%27%20x2%3D%2715%27%20y2%3D%2713%27%2F%3E%3Cline%20x1%3D%279%27%20y1%3D%2717%27%20x2%3D%2715%27%20y2%3D%2717%27%2F%3E%3C%2Fsvg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpath%20d%3D%27M15%202H6a2%202%200%200%200-2%202v16a2%202%200%200%200%202%202h12a2%202%200%200%200%202-2V7z%27%2F%3E%3Cpolyline%20points%3D%2714%202%2014%208%2020%208%27%2F%3E%3Cline%20x1%3D%279%27%20y1%3D%2713%27%20x2%3D%2715%27%20y2%3D%2713%27%2F%3E%3Cline%20x1%3D%279%27%20y1%3D%2717%27%20x2%3D%2715%27%20y2%3D%2717%27%2F%3E%3C%2Fsvg%3E");
+}
+
+.sidebar-icon-skills > .menu__list-item-collapsible > .menu__link::before {
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpath%20d%3D%27M9.937%2015.5A2%202%200%200%200%208.5%2014.063l-6.135-1.582a.5.5%200%200%201%200-.962L8.5%209.936A2%202%200%200%200%209.937%208.5l1.582-6.135a.5.5%200%200%201%20.962%200L14.063%208.5A2%202%200%200%200%2015.5%209.937l6.135%201.581a.5.5%200%200%201%200%20.964L15.5%2014.063a2%202%200%200%200-1.437%201.437l-1.582%206.135a.5.5%200%200%201-.962%200z%27%2F%3E%3Cpath%20d%3D%27M20%203v4%27%2F%3E%3Cpath%20d%3D%27M22%205h-4%27%2F%3E%3Cpath%20d%3D%27M4%2017v2%27%2F%3E%3Cpath%20d%3D%27M5%2018H3%27%2F%3E%3C%2Fsvg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpath%20d%3D%27M9.937%2015.5A2%202%200%200%200%208.5%2014.063l-6.135-1.582a.5.5%200%200%201%200-.962L8.5%209.936A2%202%200%200%200%209.937%208.5l1.582-6.135a.5.5%200%200%201%20.962%200L14.063%208.5A2%202%200%200%200%2015.5%209.937l6.135%201.581a.5.5%200%200%201%200%20.964L15.5%2014.063a2%202%200%200%200-1.437%201.437l-1.582%206.135a.5.5%200%200%201-.962%200z%27%2F%3E%3Cpath%20d%3D%27M20%203v4%27%2F%3E%3Cpath%20d%3D%27M22%205h-4%27%2F%3E%3Cpath%20d%3D%27M4%2017v2%27%2F%3E%3Cpath%20d%3D%27M5%2018H3%27%2F%3E%3C%2Fsvg%3E");
+}
+
+.sidebar-icon-mcp > .menu__list-item-collapsible > .menu__link::before {
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Crect%20x%3D%272%27%20y%3D%272%27%20width%3D%2720%27%20height%3D%278%27%20rx%3D%272%27%2F%3E%3Crect%20x%3D%272%27%20y%3D%2714%27%20width%3D%2720%27%20height%3D%278%27%20rx%3D%272%27%2F%3E%3Cline%20x1%3D%276%27%20y1%3D%276%27%20x2%3D%276.01%27%20y2%3D%276%27%2F%3E%3Cline%20x1%3D%276%27%20y1%3D%2718%27%20x2%3D%276.01%27%20y2%3D%2718%27%2F%3E%3C%2Fsvg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Crect%20x%3D%272%27%20y%3D%272%27%20width%3D%2720%27%20height%3D%278%27%20rx%3D%272%27%2F%3E%3Crect%20x%3D%272%27%20y%3D%2714%27%20width%3D%2720%27%20height%3D%278%27%20rx%3D%272%27%2F%3E%3Cline%20x1%3D%276%27%20y1%3D%276%27%20x2%3D%276.01%27%20y2%3D%276%27%2F%3E%3Cline%20x1%3D%276%27%20y1%3D%2718%27%20x2%3D%276.01%27%20y2%3D%2718%27%2F%3E%3C%2Fsvg%3E");
+}
+
+.sidebar-icon-wallet > .menu__list-item-collapsible > .menu__link::before {
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpath%20d%3D%27M21%2012V7H5a2%202%200%200%201%200-4h14v4%27%2F%3E%3Cpath%20d%3D%27M3%205v14a2%202%200%200%200%202%202h16v-5%27%2F%3E%3Cpath%20d%3D%27M18%2012a2%202%200%200%200%200%204h4v-4z%27%2F%3E%3C%2Fsvg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpath%20d%3D%27M21%2012V7H5a2%202%200%200%201%200-4h14v4%27%2F%3E%3Cpath%20d%3D%27M3%205v14a2%202%200%200%200%202%202h16v-5%27%2F%3E%3Cpath%20d%3D%27M18%2012a2%202%200%200%200%200%204h4v-4z%27%2F%3E%3C%2Fsvg%3E");
+}
+
+.sidebar-icon-llm > .menu__list-item-collapsible > .menu__link::before {
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpath%20d%3D%27M12%208V4H8%27%2F%3E%3Crect%20x%3D%274%27%20y%3D%278%27%20width%3D%2716%27%20height%3D%2712%27%20rx%3D%272%27%2F%3E%3Cpath%20d%3D%27M2%2014h2%27%2F%3E%3Cpath%20d%3D%27M20%2014h2%27%2F%3E%3Cpath%20d%3D%27M15%2013v2%27%2F%3E%3Cpath%20d%3D%27M9%2013v2%27%2F%3E%3C%2Fsvg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpath%20d%3D%27M12%208V4H8%27%2F%3E%3Crect%20x%3D%274%27%20y%3D%278%27%20width%3D%2716%27%20height%3D%2712%27%20rx%3D%272%27%2F%3E%3Cpath%20d%3D%27M2%2014h2%27%2F%3E%3Cpath%20d%3D%27M20%2014h2%27%2F%3E%3Cpath%20d%3D%27M15%2013v2%27%2F%3E%3Cpath%20d%3D%27M9%2013v2%27%2F%3E%3C%2Fsvg%3E");
+}
+
+.sidebar-icon-openclaw > .menu__list-item-collapsible > .menu__link::before {
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpath%20d%3D%27M19.439%207.85c-.049.322.059.648.289.878l1.568%201.568c.47.47.706%201.087.706%201.704s-.235%201.233-.706%201.704l-1.611%201.611a.98.98%200%200%201-.837.276c-.47-.07-.802-.48-.968-.925a2.501%202.501%200%201%200-3.214%203.214c.446.166.855.497.925.968a.979.979%200%200%201-.276.837l-1.61%201.61a2.404%202.404%200%200%201-1.705.707%202.402%202.402%200%200%201-1.704-.706l-1.568-1.568a1.026%201.026%200%200%200-.877-.29c-.493.074-.84.504-1.02.968a2.5%202.5%200%201%201-3.237-3.237c.464-.18.894-.527.967-1.02a1.026%201.026%200%200%200-.289-.877l-1.568-1.568A2.402%202.402%200%200%201%201.998%2012c0-.617.236-1.234.706-1.704L4.23%208.77c.24-.24.581-.353.917-.303.515.077.877.528%201.073%201.01a2.5%202.5%200%201%200%203.259-3.259c-.482-.196-.933-.558-1.01-1.073-.05-.336.062-.676.303-.917l1.525-1.525A2.402%202.402%200%200%201%2012%201.998c.617%200%201.234.236%201.704.706l1.568%201.568c.23.23.556.338.877.29.493-.074.84-.504%201.02-.968a2.5%202.5%200%201%201%203.237%203.237c-.464.18-.894.527-.967%201.02z%27%2F%3E%3C%2Fsvg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg%20xmlns%3D%27http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%27%20width%3D%2724%27%20height%3D%2724%27%20viewBox%3D%270%200%2024%2024%27%20fill%3D%27none%27%20stroke%3D%27black%27%20stroke-width%3D%272%27%20stroke-linecap%3D%27round%27%20stroke-linejoin%3D%27round%27%3E%3Cpath%20d%3D%27M19.439%207.85c-.049.322.059.648.289.878l1.568%201.568c.47.47.706%201.087.706%201.704s-.235%201.233-.706%201.704l-1.611%201.611a.98.98%200%200%201-.837.276c-.47-.07-.802-.48-.968-.925a2.501%202.501%200%201%200-3.214%203.214c.446.166.855.497.925.968a.979.979%200%200%201-.276.837l-1.61%201.61a2.404%202.404%200%200%201-1.705.707%202.402%202.402%200%200%201-1.704-.706l-1.568-1.568a1.026%201.026%200%200%200-.877-.29c-.493.074-.84.504-1.02.968a2.5%202.5%200%201%201-3.237-3.237c.464-.18.894-.527.967-1.02a1.026%201.026%200%200%200-.289-.877l-1.568-1.568A2.402%202.402%200%200%201%201.998%2012c0-.617.236-1.234.706-1.704L4.23%208.77c.24-.24.581-.353.917-.303.515.077.877.528%201.073%201.01a2.5%202.5%200%201%200%203.259-3.259c-.482-.196-.933-.558-1.01-1.073-.05-.336.062-.676.303-.917l1.525-1.525A2.402%202.402%200%200%201%2012%201.998c.617%200%201.234.236%201.704.706l1.568%201.568c.23.23.556.338.877.29.493-.074.84-.504%201.02-.968a2.5%202.5%200%201%201%203.237%203.237c-.464.18-.894.527-.967%201.02z%27%2F%3E%3C%2Fsvg%3E");
+}
+
+/* ============================================================
+   Center the search box in the middle of the top navbar
+   (desktop only; mobile keeps Docusaurus default placement).
+   Bundled here (customCss) so it is content-hashed and reliably
+   hot-reloads, unlike the static /css/custom.css link.
+   The search container rendered by the search plugin is
+   `.navbar__search`; we lift it out of the right-hand item group
+   and absolutely center it over the navbar inner width.
+   ============================================================ */
+@media (min-width: 997px) {
+  .navbar__inner {
+    position: relative;
+  }
+  /* Centered, fixed-width tidy pill (Coinbase-style) rather than a wide
+     floating bar. The input fills the container so it reads as one pill. */
+  .navbar__search {
+    position: absolute !important;
+    top: 50% !important;
+    left: 50% !important;
+    transform: translate(-50%, -50%) !important;
+    margin: 0 !important;
+    width: 360px;
+    z-index: 1;
+  }
+  /* Fixed width (not %) so the input stays 360px even after autocomplete.js
+     wraps it on focus; otherwise it collapses and the ⌘K hint detaches. */
+  .navbar__search .navbar__search-input {
+    width: 360px !important;
+    max-width: 360px !important;
+    height: 38px;
+    box-sizing: border-box;
+    border-radius: 999px;
+  }
+}
+
+/* ============================================================
+   Wide-screen doc layout: the stock doc container centers at
+   ~1440px, which on large monitors leaves a big empty gap
+   between the sidebar and the article. Widen the doc-page
+   container so content fills the space beside the sidebar.
+   Scoped to doc pages (docMainContainer) with high specificity
+   + !important to win over the theme's own container rule.
+   ============================================================ */
+@media (min-width: 997px) {
+  [class*='docMainContainer'] .container.padding-bottom--lg {
+    max-width: 95% !important;
+  }
+}
+
+/* ============================================================
+   Changelog entries (Coinbase-style): date pill in a left rail,
+   product heading + tag pills + bullets on the right.
+   Used by the /changelog docs instance via MDX class names.
+   ============================================================ */
+.changelog-entry {
+  display: flex;
+  align-items: flex-start;
+  gap: 2.5rem;
+  padding: 2.25rem 0;
+  border-top: 1px solid var(--ifm-color-emphasis-200);
+}
+.changelog-entry:first-of-type {
+  border-top: none;
+  padding-top: 0.5rem;
+}
+.changelog-date {
+  flex: 0 0 130px;
+  display: inline-block;
+  padding: 0.3rem 0.9rem;
+  border-radius: 8px;
+  background: rgba(36, 88, 255, 0.09);
+  color: var(--ifm-color-primary);
+  font-weight: 600;
+  font-size: 0.9rem;
+  text-align: center;
+  white-space: nowrap;
+}
+html[data-theme='dark'] .changelog-date {
+  background: rgba(96, 133, 255, 0.18);
+}
+.changelog-body {
+  flex: 1;
+  min-width: 0;
+}
+.changelog-body h3:first-child {
+  margin-top: 0;
+}
+.changelog-tags {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.4rem;
+  margin: 0.4rem 0 1rem;
+}
+.changelog-tag {
+  font-size: 0.75rem;
+  line-height: 1.6;
+  padding: 0.12rem 0.65rem;
+  border-radius: 999px;
+  background: var(--ifm-color-emphasis-100);
+  color: var(--ifm-color-emphasis-700);
+  white-space: nowrap;
+}
+@media (max-width: 768px) {
+  .changelog-entry {
+    flex-direction: column;
+    gap: 0.9rem;
+  }
+  .changelog-date {
+    flex: none;
+  }
+}
+
+/* ============================================================
+   Intro capability cards: 2×2 grid of capability cards used on
+   the BANK OF AI intro page (icon + title, one-liner, component
+   links in the footer). Single column on mobile.
+   ============================================================ */
+.intro-cards {
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+  gap: 1rem;
+  margin: 1.5rem 0;
+}
+.intro-card {
+  display: flex;
+  flex-direction: column;
+  border: 1px solid var(--ifm-color-emphasis-200);
+  border-radius: 12px;
+  padding: 1.15rem 1.3rem;
+  background: var(--ifm-background-surface-color);
+  transition: box-shadow 0.15s ease, border-color 0.15s ease;
+}
+.intro-card:hover {
+  border-color: var(--ifm-color-emphasis-300);
+  box-shadow: 0 4px 14px rgba(0, 0, 0, 0.06);
+}
+html[data-theme='dark'] .intro-card:hover {
+  box-shadow: 0 4px 14px rgba(0, 0, 0, 0.35);
+}
+.intro-card-title {
+  font-weight: 700;
+  font-size: 1.05rem;
+  margin-bottom: 0.4rem;
+}
+.intro-card p {
+  margin: 0 0 0.6rem;
+  font-size: 0.95rem;
+  line-height: 1.65;
+  color: var(--ifm-color-emphasis-800);
+}
+.intro-card-links {
+  margin-top: auto;
+  padding-top: 0.55rem;
+  border-top: 1px dashed var(--ifm-color-emphasis-200);
+  font-size: 0.85rem;
+}
+.intro-card-links p {
+  margin: 0;
+  font-size: 0.85rem;
+}
+@media (max-width: 768px) {
+  .intro-cards {
+    grid-template-columns: 1fr;
+  }
+}
diff --git a/static/hideErrorBanner.js b/static/hideErrorBanner.js
index f7ea3fb2..a39bdede 100644
--- a/static/hideErrorBanner.js
+++ b/static/hideErrorBanner.js
@@ -1,3 +1,20 @@
+// 拦截浏览器插件（如 MetaMask 的 inpage.js）抛出的未处理错误，
+// 避免开发模式下 webpack 错误浮层误报。站点代码从不调用任何钱包插件；
+// 此脚本经 docusaurus.config.js scripts 注入 <head>，先于 webpack 客户端
+// 注册监听，因此能在浮层收到事件前 stopImmediatePropagation。
+window.addEventListener('error', (e) => {
+  if (e.filename && e.filename.startsWith('chrome-extension://')) {
+    e.stopImmediatePropagation()
+  }
+})
+
+window.addEventListener('unhandledrejection', (e) => {
+  const s = e.reason && (e.reason.stack || String(e.reason))
+  if (s && s.indexOf('chrome-extension://') !== -1) {
+    e.stopImmediatePropagation()
+  }
+})
+
 window.addEventListener('DOMContentLoaded', () => {
   const modal = document.getElementById('__docusaurus-base-url-issue-banner-container')
   if (modal) {
diff --git a/yarn.lock b/yarn.lock
index 97db7b48..43adf61e 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -1426,7 +1426,7 @@
     utility-types "^3.10.0"
     webpack "^5.73.0"
 
-"@docusaurus/plugin-content-docs@2.4.3":
+"@docusaurus/plugin-content-docs@2.4.3", "@docusaurus/plugin-content-docs@^2.0.0-rc.1":
   version "2.4.3"
   resolved "https://registry.npmjs.org/@docusaurus/plugin-content-docs/-/plugin-content-docs-2.4.3.tgz"
   integrity sha512-N7Po2LSH6UejQhzTCsvuX5NOzlC+HiXOVvofnEPj0WhMu1etpLEXE6a4aTxrtg95lQ5kf0xUIdjX9sh3d3G76A==
@@ -1630,7 +1630,7 @@
     tslib "^2.4.0"
     utility-types "^3.10.0"
 
-"@docusaurus/theme-translations@2.4.3":
+"@docusaurus/theme-translations@2.4.3", "@docusaurus/theme-translations@^2.0.0-rc.1":
   version "2.4.3"
   resolved "https://registry.npmjs.org/@docusaurus/theme-translations/-/theme-translations-2.4.3.tgz"
   integrity sha512-H4D+lbZbjbKNS/Zw1Lel64PioUAIT3cLYYJLUf3KkuO/oc9e0QCVhIYVtUI2SfBCF2NNdlyhBDQEEMygsCedIg==
@@ -1652,14 +1652,14 @@
     webpack "^5.73.0"
     webpack-merge "^5.8.0"
 
-"@docusaurus/utils-common@2.4.3":
+"@docusaurus/utils-common@2.4.3", "@docusaurus/utils-common@^2.0.0-rc.1":
   version "2.4.3"
   resolved "https://registry.npmjs.org/@docusaurus/utils-common/-/utils-common-2.4.3.tgz"
   integrity sha512-/jascp4GbLQCPVmcGkPzEQjNaAk3ADVfMtudk49Ggb+131B1WDD6HqlSmDf8MxGdy7Dja2gc+StHf01kiWoTDQ==
   dependencies:
     tslib "^2.4.0"
 
-"@docusaurus/utils-validation@2.4.3":
+"@docusaurus/utils-validation@2.4.3", "@docusaurus/utils-validation@^2.0.0-rc.1":
   version "2.4.3"
   resolved "https://registry.npmjs.org/@docusaurus/utils-validation/-/utils-validation-2.4.3.tgz"
   integrity sha512-G2+Vt3WR5E/9drAobP+hhZQMaswRwDlp6qOMi7o7ZypB+VO7N//DZWhZEwhcRGepMDJGQEwtPv7UxtYwPL9PBw==
@@ -1670,7 +1670,7 @@
     js-yaml "^4.1.0"
     tslib "^2.4.0"
 
-"@docusaurus/utils@2.4.3":
+"@docusaurus/utils@2.4.3", "@docusaurus/utils@^2.0.0-rc.1":
   version "2.4.3"
   resolved "https://registry.npmjs.org/@docusaurus/utils/-/utils-2.4.3.tgz"
   integrity sha512-fKcXsjrD86Smxv8Pt0TBFqYieZZCPh4cbf9oszUq/AMhZn3ujwpKaVYZACPX8mmjtYx0JOgNx52CREBfiGQB4A==
@@ -1692,6 +1692,58 @@
     url-loader "^4.1.1"
     webpack "^5.73.0"
 
+"@easyops-cn/autocomplete.js@^0.38.1":
+  version "0.38.1"
+  resolved "https://registry.yarnpkg.com/@easyops-cn/autocomplete.js/-/autocomplete.js-0.38.1.tgz#46dff5795a9a032fa9b9250fdf63ca6c61c07629"
+  integrity sha512-drg76jS6syilOUmVNkyo1c7ZEBPcPuK+aJA7AksM5ZIIbV57DMHCywiCr+uHyv8BE5jUTU98j/H7gVrkHrWW3Q==
+  dependencies:
+    cssesc "^3.0.0"
+    immediate "^3.2.3"
+
+"@easyops-cn/docusaurus-search-local@^0.35.0":
+  version "0.35.0"
+  resolved "https://registry.yarnpkg.com/@easyops-cn/docusaurus-search-local/-/docusaurus-search-local-0.35.0.tgz#d87f60c1c2b44944ff681648c147f6bad55869f9"
+  integrity sha512-sHQ8jxsVgHH8MNXJlj20nZZfP/Q0peNTAJwKCN2aPuBwfRIoO0i7LmZFaYKenZmVAW/BD2MtfVd65SREmm3zxg==
+  dependencies:
+    "@docusaurus/plugin-content-docs" "^2.0.0-rc.1"
+    "@docusaurus/theme-translations" "^2.0.0-rc.1"
+    "@docusaurus/utils" "^2.0.0-rc.1"
+    "@docusaurus/utils-common" "^2.0.0-rc.1"
+    "@docusaurus/utils-validation" "^2.0.0-rc.1"
+    "@easyops-cn/autocomplete.js" "^0.38.1"
+    "@node-rs/jieba" "^1.6.0"
+    cheerio "^1.0.0-rc.3"
+    clsx "^1.1.1"
+    debug "^4.2.0"
+    fs-extra "^10.0.0"
+    klaw-sync "^6.0.0"
+    lunr "^2.3.9"
+    lunr-languages "^1.4.0"
+    mark.js "^8.11.1"
+    tslib "^2.4.0"
+
+"@emnapi/core@^1.4.3":
+  version "1.11.2"
+  resolved "https://registry.yarnpkg.com/@emnapi/core/-/core-1.11.2.tgz#fab0a0f3c492d11f5a9ac9065d0d73955ee1c1c9"
+  integrity sha512-TC8MkTuZUtcTSiFeuC0ksCh9QIJ5+F21MvZ4Wn4ORfYaFJ/0dsiudv5tVkejgwZlwQ39jL9WWDe2lz8x0WglOA==
+  dependencies:
+    "@emnapi/wasi-threads" "1.2.2"
+    tslib "^2.4.0"
+
+"@emnapi/runtime@^1.4.3":
+  version "1.11.2"
+  resolved "https://registry.yarnpkg.com/@emnapi/runtime/-/runtime-1.11.2.tgz#eb22f04d76febfdf4f87fdaff54c8a53f6bf0dbd"
+  integrity sha512-kyOl3X0DuTiT1h2ft8r2fYO8JYtU9a9Xis/zBSiGArNaagCOWx90N1k2wxp18czFDH+OgcWGb5ZP/XMt3dcyPA==
+  dependencies:
+    tslib "^2.4.0"
+
+"@emnapi/wasi-threads@1.2.2":
+  version "1.2.2"
+  resolved "https://registry.yarnpkg.com/@emnapi/wasi-threads/-/wasi-threads-1.2.2.tgz#4c93becf5bfa3b13d1bbdcc06aee38321ad8139a"
+  integrity sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA==
+  dependencies:
+    tslib "^2.4.0"
+
 "@hapi/hoek@^9.0.0", "@hapi/hoek@^9.3.0":
   version "9.3.0"
   resolved "https://registry.npmjs.org/@hapi/hoek/-/hoek-9.3.0.tgz"
@@ -1805,6 +1857,107 @@
   resolved "https://registry.npmjs.org/@mdx-js/util/-/util-1.6.22.tgz"
   integrity sha512-H1rQc1ZOHANWBvPcW+JpGwr+juXSxM8Q8YCkm3GhZd8REu1fHR3z99CErO1p9pkcfcxZnMdIZdIsXkOHY0NilA==
 
+"@napi-rs/wasm-runtime@^0.2.3":
+  version "0.2.12"
+  resolved "https://registry.yarnpkg.com/@napi-rs/wasm-runtime/-/wasm-runtime-0.2.12.tgz#3e78a8b96e6c33a6c517e1894efbd5385a7cb6f2"
+  integrity sha512-ZVWUcfwY4E/yPitQJl481FjFo3K22D6qF0DuFH6Y/nbnE11GY5uguDxZMGXPQ8WQ0128MXQD7TnfHyK4oWoIJQ==
+  dependencies:
+    "@emnapi/core" "^1.4.3"
+    "@emnapi/runtime" "^1.4.3"
+    "@tybys/wasm-util" "^0.10.0"
+
+"@node-rs/jieba-android-arm-eabi@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-android-arm-eabi/-/jieba-android-arm-eabi-1.10.4.tgz#c8c0be3895f01c86a0138cbb1b2228d0895c6854"
+  integrity sha512-MhyvW5N3Fwcp385d0rxbCWH42kqDBatQTyP8XbnYbju2+0BO/eTeCCLYj7Agws4pwxn2LtdldXRSKavT7WdzNA==
+
+"@node-rs/jieba-android-arm64@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-android-arm64/-/jieba-android-arm64-1.10.4.tgz#02bcf7a52d6036983398fa041d50ab73e53e8e03"
+  integrity sha512-XyDwq5+rQ+Tk55A+FGi6PtJbzf974oqnpyCcCPzwU3QVXJCa2Rr4Lci+fx8oOpU4plT3GuD+chXMYLsXipMgJA==
+
+"@node-rs/jieba-darwin-arm64@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-darwin-arm64/-/jieba-darwin-arm64-1.10.4.tgz#2f39e7f21d1f01afe06fb4c5deeb7ac098f7870c"
+  integrity sha512-G++RYEJ2jo0rxF9626KUy90wp06TRUjAsvY/BrIzEOX/ingQYV/HjwQzNPRR1P1o32a6/U8RGo7zEBhfdybL6w==
+
+"@node-rs/jieba-darwin-x64@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-darwin-x64/-/jieba-darwin-x64-1.10.4.tgz#c3d007962f5b247c3a8a0707dd393ee71f840ea6"
+  integrity sha512-MmDNeOb2TXIZCPyWCi2upQnZpPjAxw5ZGEj6R8kNsPXVFALHIKMa6ZZ15LCOkSTsKXVC17j2t4h+hSuyYb6qfQ==
+
+"@node-rs/jieba-freebsd-x64@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-freebsd-x64/-/jieba-freebsd-x64-1.10.4.tgz#5ab23591604f4a256f6bad1e4230faeac5220a0d"
+  integrity sha512-/x7aVQ8nqUWhpXU92RZqd333cq639i/olNpd9Z5hdlyyV5/B65LLy+Je2B2bfs62PVVm5QXRpeBcZqaHelp/bg==
+
+"@node-rs/jieba-linux-arm-gnueabihf@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-linux-arm-gnueabihf/-/jieba-linux-arm-gnueabihf-1.10.4.tgz#415237af704f9bbd10742995f02f779679a840b1"
+  integrity sha512-crd2M35oJBRLkoESs0O6QO3BBbhpv+tqXuKsqhIG94B1d02RVxtRIvSDwO33QurxqSdvN9IeSnVpHbDGkuXm3g==
+
+"@node-rs/jieba-linux-arm64-gnu@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-linux-arm64-gnu/-/jieba-linux-arm64-gnu-1.10.4.tgz#3e9debcc6c903852a28df9caa3d004cb08bc9299"
+  integrity sha512-omIzNX1psUzPcsdnUhGU6oHeOaTCuCjUgOA/v/DGkvWC1jLcnfXe4vdYbtXMh4XOCuIgS1UCcvZEc8vQLXFbXQ==
+
+"@node-rs/jieba-linux-arm64-musl@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-linux-arm64-musl/-/jieba-linux-arm64-musl-1.10.4.tgz#faf11579a7cc3f798780819403b1fb34a0360d9e"
+  integrity sha512-Y/tiJ1+HeS5nnmLbZOE+66LbsPOHZ/PUckAYVeLlQfpygLEpLYdlh0aPpS5uiaWMjAXYZYdFkpZHhxDmSLpwpw==
+
+"@node-rs/jieba-linux-x64-gnu@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-linux-x64-gnu/-/jieba-linux-x64-gnu-1.10.4.tgz#05187afe917370ef2607564897ec5979f8e67ca9"
+  integrity sha512-WZO8ykRJpWGE9MHuZpy1lu3nJluPoeB+fIJJn5CWZ9YTVhNDWoCF4i/7nxz1ntulINYGQ8VVuCU9LD86Mek97g==
+
+"@node-rs/jieba-linux-x64-musl@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-linux-x64-musl/-/jieba-linux-x64-musl-1.10.4.tgz#d38addcb65de3b6c5e8af4bcdfaf7495bb676534"
+  integrity sha512-uBBD4S1rGKcgCyAk6VCKatEVQb6EDD5I40v/DxODi5CuZVCANi9m5oee/MQbAoaX7RydA2f0OSCE9/tcwXEwUg==
+
+"@node-rs/jieba-wasm32-wasi@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-wasm32-wasi/-/jieba-wasm32-wasi-1.10.4.tgz#28662dba21da3fdf7a7904dac19ecffba9244457"
+  integrity sha512-Y2umiKHjuIJy0uulNDz9SDYHdfq5Hmy7jY5nORO99B4pySKkcrMjpeVrmWXJLIsEKLJwcCXHxz8tjwU5/uhz0A==
+  dependencies:
+    "@napi-rs/wasm-runtime" "^0.2.3"
+
+"@node-rs/jieba-win32-arm64-msvc@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-win32-arm64-msvc/-/jieba-win32-arm64-msvc-1.10.4.tgz#7d8dffe5e54fc9ca0f8fddef93fde72ecc2a4ae4"
+  integrity sha512-nwMtViFm4hjqhz1it/juQnxpXgqlGltCuWJ02bw70YUDMDlbyTy3grCJPpQQpueeETcALUnTxda8pZuVrLRcBA==
+
+"@node-rs/jieba-win32-ia32-msvc@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-win32-ia32-msvc/-/jieba-win32-ia32-msvc-1.10.4.tgz#5081fa5e4ca84ba8044f52e0d53d9c07b2ab370b"
+  integrity sha512-DCAvLx7Z+W4z5oKS+7vUowAJr0uw9JBw8x1Y23Xs/xMA4Em+OOSiaF5/tCJqZUCJ8uC4QeImmgDFiBqGNwxlyA==
+
+"@node-rs/jieba-win32-x64-msvc@1.10.4":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba-win32-x64-msvc/-/jieba-win32-x64-msvc-1.10.4.tgz#fc325ccea3f7b864965d8cfe2ddd6bf10857f9df"
+  integrity sha512-+sqemSfS1jjb+Tt7InNbNzrRh1Ua3vProVvC4BZRPg010/leCbGFFiQHpzcPRfpxAXZrzG5Y0YBTsPzN/I4yHQ==
+
+"@node-rs/jieba@^1.6.0":
+  version "1.10.4"
+  resolved "https://registry.yarnpkg.com/@node-rs/jieba/-/jieba-1.10.4.tgz#9bc8f7e65bbb968b329c7571086993b55a95ef56"
+  integrity sha512-GvDgi8MnBiyWd6tksojej8anIx18244NmIOc1ovEw8WKNUejcccLfyu8vj66LWSuoZuKILVtNsOy4jvg3aoxIw==
+  optionalDependencies:
+    "@node-rs/jieba-android-arm-eabi" "1.10.4"
+    "@node-rs/jieba-android-arm64" "1.10.4"
+    "@node-rs/jieba-darwin-arm64" "1.10.4"
+    "@node-rs/jieba-darwin-x64" "1.10.4"
+    "@node-rs/jieba-freebsd-x64" "1.10.4"
+    "@node-rs/jieba-linux-arm-gnueabihf" "1.10.4"
+    "@node-rs/jieba-linux-arm64-gnu" "1.10.4"
+    "@node-rs/jieba-linux-arm64-musl" "1.10.4"
+    "@node-rs/jieba-linux-x64-gnu" "1.10.4"
+    "@node-rs/jieba-linux-x64-musl" "1.10.4"
+    "@node-rs/jieba-wasm32-wasi" "1.10.4"
+    "@node-rs/jieba-win32-arm64-msvc" "1.10.4"
+    "@node-rs/jieba-win32-ia32-msvc" "1.10.4"
+    "@node-rs/jieba-win32-x64-msvc" "1.10.4"
+
 "@nodelib/fs.scandir@2.1.5":
   version "2.1.5"
   resolved "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz"
@@ -1990,6 +2143,13 @@
   resolved "https://registry.npmjs.org/@tsconfig/docusaurus/-/docusaurus-1.0.7.tgz"
   integrity sha512-ffTXxGIP/IRMCjuzHd6M4/HdIrw1bMfC7Bv8hMkTadnePkpe0lG0oDSdbRpSDZb2rQMAgpbWiR10BvxvNYwYrg==
 
+"@tybys/wasm-util@^0.10.0":
+  version "0.10.3"
+  resolved "https://registry.yarnpkg.com/@tybys/wasm-util/-/wasm-util-0.10.3.tgz#015cba9e9dd47ce14d03d2a8c5d547bfb169665d"
+  integrity sha512-F3fo1MYrRJYL3zER0OUOmkutjr1Vp23m7OsSgp7nq4SP6OqX6C/56XFIPAl5bt3zaBRjmW7SGz3u/6LwFpYcOg==
+  dependencies:
+    tslib "^2.4.0"
+
 "@types/body-parser@*":
   version "1.19.6"
   resolved "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz"
@@ -2968,22 +3128,18 @@ cheerio-select@^2.1.0:
     domhandler "^5.0.3"
     domutils "^3.0.1"
 
-cheerio@^1.0.0-rc.12:
-  version "1.2.0"
-  resolved "https://registry.npmjs.org/cheerio/-/cheerio-1.2.0.tgz"
-  integrity sha512-WDrybc/gKFpTYQutKIK6UvfcuxijIZfMfXaYm8NMsPQxSYvf+13fXUJ4rztGGbJcBQ/GF55gvrZ0Bc0bj/mqvg==
+cheerio@1.0.0-rc.12, cheerio@^1.0.0-rc.12, cheerio@^1.0.0-rc.3:
+  version "1.0.0-rc.12"
+  resolved "https://registry.yarnpkg.com/cheerio/-/cheerio-1.0.0-rc.12.tgz#788bf7466506b1c6bf5fae51d24a2c4d62e47683"
+  integrity sha512-VqR8m68vM46BNnuZ5NtnGBKIE/DfN0cRIzg9n40EIq9NOv90ayxLBXA8fXC5gquFRGJSTRqBq25Jt2ECLR431Q==
   dependencies:
     cheerio-select "^2.1.0"
     dom-serializer "^2.0.0"
     domhandler "^5.0.3"
-    domutils "^3.2.2"
-    encoding-sniffer "^0.2.1"
-    htmlparser2 "^10.1.0"
-    parse5 "^7.3.0"
-    parse5-htmlparser2-tree-adapter "^7.1.0"
-    parse5-parser-stream "^7.1.2"
-    undici "^7.19.0"
-    whatwg-mimetype "^4.0.0"
+    domutils "^3.0.1"
+    htmlparser2 "^8.0.1"
+    parse5 "^7.0.0"
+    parse5-htmlparser2-tree-adapter "^7.0.0"
 
 chokidar@^3.4.2, chokidar@^3.5.3:
   version "3.6.0"
@@ -3461,7 +3617,7 @@ debug@2.6.9, debug@^2.6.0:
   dependencies:
     ms "2.0.0"
 
-debug@4, debug@^4.1.0, debug@^4.3.1, debug@^4.4.3:
+debug@4, debug@^4.1.0, debug@^4.2.0, debug@^4.3.1, debug@^4.4.3:
   version "4.4.3"
   resolved "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz"
   integrity sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==
@@ -3644,7 +3800,7 @@ domutils@^2.5.2, domutils@^2.8.0:
     domelementtype "^2.2.0"
     domhandler "^4.2.0"
 
-domutils@^3.0.1, domutils@^3.2.2:
+domutils@^3.0.1:
   version "3.2.2"
   resolved "https://registry.npmjs.org/domutils/-/domutils-3.2.2.tgz"
   integrity sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==
@@ -3732,14 +3888,6 @@ encodeurl@~2.0.0:
   resolved "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz"
   integrity sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==
 
-encoding-sniffer@^0.2.1:
-  version "0.2.1"
-  resolved "https://registry.npmjs.org/encoding-sniffer/-/encoding-sniffer-0.2.1.tgz"
-  integrity sha512-5gvq20T6vfpekVtqrYQsSCFZ1wEg5+wW0/QaZMWkFr6BqD3NfKs0rLCx4rrVlSWJeZb5NBJgVLswK/w2MWU+Gw==
-  dependencies:
-    iconv-lite "^0.6.3"
-    whatwg-encoding "^3.1.1"
-
 end-of-stream@^1.1.0:
   version "1.4.5"
   resolved "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz"
@@ -3770,11 +3918,6 @@ entities@^6.0.0:
   resolved "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz"
   integrity sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==
 
-entities@^7.0.1:
-  version "7.0.1"
-  resolved "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz"
-  integrity sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==
-
 error-ex@^1.3.1:
   version "1.3.4"
   resolved "https://registry.npmjs.org/error-ex/-/error-ex-1.3.4.tgz"
@@ -4140,7 +4283,7 @@ fresh@~0.5.2:
   resolved "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz"
   integrity sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==
 
-fs-extra@^10.1.0:
+fs-extra@^10.0.0, fs-extra@^10.1.0:
   version "10.1.0"
   resolved "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz"
   integrity sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==
@@ -4336,7 +4479,7 @@ got@^9.6.0:
     to-readable-stream "^1.0.0"
     url-parse-lax "^3.0.0"
 
-graceful-fs@^4.1.2, graceful-fs@^4.1.6, graceful-fs@^4.2.0, graceful-fs@^4.2.11, graceful-fs@^4.2.4, graceful-fs@^4.2.6, graceful-fs@^4.2.9:
+graceful-fs@^4.1.11, graceful-fs@^4.1.2, graceful-fs@^4.1.6, graceful-fs@^4.2.0, graceful-fs@^4.2.11, graceful-fs@^4.2.4, graceful-fs@^4.2.6, graceful-fs@^4.2.9:
   version "4.2.11"
   resolved "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz"
   integrity sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==
@@ -4552,16 +4695,6 @@ html-webpack-plugin@^5.5.0:
     pretty-error "^4.0.0"
     tapable "^2.0.0"
 
-htmlparser2@^10.1.0:
-  version "10.1.0"
-  resolved "https://registry.npmjs.org/htmlparser2/-/htmlparser2-10.1.0.tgz"
-  integrity sha512-VTZkM9GWRAtEpveh7MSF6SjjrpNVNNVJfFup7xTY3UpFtm67foy9HDVXneLtFVt4pMz5kZtgNcvCniNFb1hlEQ==
-  dependencies:
-    domelementtype "^2.3.0"
-    domhandler "^5.0.3"
-    domutils "^3.2.2"
-    entities "^7.0.1"
-
 htmlparser2@^6.1.0:
   version "6.1.0"
   resolved "https://registry.npmjs.org/htmlparser2/-/htmlparser2-6.1.0.tgz"
@@ -4572,6 +4705,16 @@ htmlparser2@^6.1.0:
     domutils "^2.5.2"
     entities "^2.0.0"
 
+htmlparser2@^8.0.1:
+  version "8.0.2"
+  resolved "https://registry.yarnpkg.com/htmlparser2/-/htmlparser2-8.0.2.tgz#f002151705b383e62433b5cf466f5b716edaec21"
+  integrity sha512-GYdjWKDkbRLkZ5geuHs5NY1puJ+PXwP7+fHPRz06Eirsb9ugf6d8kkXav6ADhcODhFFPMIXyxkxSuMf3D6NCFA==
+  dependencies:
+    domelementtype "^2.3.0"
+    domhandler "^5.0.3"
+    domutils "^3.0.1"
+    entities "^4.4.0"
+
 http-cache-semantics@^4.0.0:
   version "4.2.0"
   resolved "https://registry.npmjs.org/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz"
@@ -4634,13 +4777,6 @@ human-signals@^2.1.0:
   resolved "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz"
   integrity sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==
 
-iconv-lite@0.6.3, iconv-lite@^0.6.3:
-  version "0.6.3"
-  resolved "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz"
-  integrity sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==
-  dependencies:
-    safer-buffer ">= 2.1.2 < 3.0.0"
-
 iconv-lite@~0.4.24:
   version "0.4.24"
   resolved "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz"
@@ -4665,6 +4801,11 @@ image-size@^1.0.1:
   dependencies:
     queue "6.0.2"
 
+immediate@^3.2.3:
+  version "3.3.0"
+  resolved "https://registry.yarnpkg.com/immediate/-/immediate-3.3.0.tgz#1aef225517836bcdf7f2a2de2600c79ff0269266"
+  integrity sha512-HR7EVodfFUdQCTIeySw+WDRFJlPcLOJbXfwwZ7Oom6tjsvZ3bOkCDJHehQC3nxJrv7+f9XecwazynjU8e4Vw3Q==
+
 immer@^9.0.7:
   version "9.0.21"
   resolved "https://registry.npmjs.org/immer/-/immer-9.0.21.tgz"
@@ -5071,6 +5212,13 @@ kind-of@^6.0.0, kind-of@^6.0.2:
   resolved "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz"
   integrity sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==
 
+klaw-sync@^6.0.0:
+  version "6.0.0"
+  resolved "https://registry.yarnpkg.com/klaw-sync/-/klaw-sync-6.0.0.tgz#1fd2cfd56ebb6250181114f0a581167099c2b28c"
+  integrity sha512-nIeuVSzdCCs6TDPTqI8w1Yre34sSq7AkZ4B3sfOBbI2CgVSB4Du4aLQijFU2+lhAFCwt9+42Hel6lQNIv6AntQ==
+  dependencies:
+    graceful-fs "^4.1.11"
+
 kleur@^3.0.3:
   version "3.0.3"
   resolved "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz"
@@ -5208,6 +5356,16 @@ lru-cache@^5.1.1:
   dependencies:
     yallist "^3.0.2"
 
+lunr-languages@^1.4.0:
+  version "1.20.0"
+  resolved "https://registry.yarnpkg.com/lunr-languages/-/lunr-languages-1.20.0.tgz#d145555fdeb546300b1394860d768487b8e0e182"
+  integrity sha512-3LVgE7ekWXt04NBci/hjm+NXJxXZeRXuyClL0kA0HONyBOjxhP3ZQkuWIM4Ok3pbeptUW/rj3XcJcJuJVPwPYA==
+
+lunr@^2.3.9:
+  version "2.3.9"
+  resolved "https://registry.yarnpkg.com/lunr/-/lunr-2.3.9.tgz#18b123142832337dd6e964df1a5a7707b25d35e1"
+  integrity sha512-zTU3DaZaF3Rt9rhN3uBMGQD3dD2/vFQqnvZCDv4dl5iOzq2IZQqTxu90r4E5J+nP70J3ilqVCrbho2eWaeW8Ow==
+
 make-dir@^3.0.0, make-dir@^3.0.2, make-dir@^3.1.0:
   version "3.1.0"
   resolved "https://registry.npmjs.org/make-dir/-/make-dir-3.1.0.tgz"
@@ -5215,6 +5373,11 @@ make-dir@^3.0.0, make-dir@^3.0.2, make-dir@^3.1.0:
   dependencies:
     semver "^6.0.0"
 
+mark.js@^8.11.1:
+  version "8.11.1"
+  resolved "https://registry.yarnpkg.com/mark.js/-/mark.js-8.11.1.tgz#180f1f9ebef8b0e638e4166ad52db879beb2ffc5"
+  integrity sha512-1I+1qpDt4idfgLQG+BNWmrqku+7/2bi5nLf4YwF8y8zXvmfiTBY3PV3ZibfrjBueCByROpuBjLLFCajqkgYoLQ==
+
 markdown-escapes@^1.0.0:
   version "1.0.4"
   resolved "https://registry.npmjs.org/markdown-escapes/-/markdown-escapes-1.0.4.tgz"
@@ -5675,27 +5838,20 @@ parse-numeric-range@^1.3.0:
   resolved "https://registry.npmjs.org/parse-numeric-range/-/parse-numeric-range-1.3.0.tgz"
   integrity sha512-twN+njEipszzlMJd4ONUYgSfZPDxgHhT9Ahed5uTigpQn90FggW4SA/AIPq/6a149fTbE9qBEcSwE3FAEp6wQQ==
 
-parse5-htmlparser2-tree-adapter@^7.1.0:
+parse5-htmlparser2-tree-adapter@^7.0.0:
   version "7.1.0"
-  resolved "https://registry.npmjs.org/parse5-htmlparser2-tree-adapter/-/parse5-htmlparser2-tree-adapter-7.1.0.tgz"
+  resolved "https://registry.yarnpkg.com/parse5-htmlparser2-tree-adapter/-/parse5-htmlparser2-tree-adapter-7.1.0.tgz#b5a806548ed893a43e24ccb42fbb78069311e81b"
   integrity sha512-ruw5xyKs6lrpo9x9rCZqZZnIUntICjQAd0Wsmp396Ul9lN/h+ifgVV1x1gZHi8euej6wTfpqX8j+BFQxF0NS/g==
   dependencies:
     domhandler "^5.0.3"
     parse5 "^7.0.0"
 
-parse5-parser-stream@^7.1.2:
-  version "7.1.2"
-  resolved "https://registry.npmjs.org/parse5-parser-stream/-/parse5-parser-stream-7.1.2.tgz"
-  integrity sha512-JyeQc9iwFLn5TbvvqACIF/VXG6abODeB3Fwmv/TGdLk2LfbWkaySGY72at4+Ty7EkPZj854u4CrICqNk2qIbow==
-  dependencies:
-    parse5 "^7.0.0"
-
 parse5@^6.0.0:
   version "6.0.1"
   resolved "https://registry.npmjs.org/parse5/-/parse5-6.0.1.tgz"
   integrity sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw==
 
-parse5@^7.0.0, parse5@^7.3.0:
+parse5@^7.0.0:
   version "7.3.0"
   resolved "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz"
   integrity sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==
@@ -6712,7 +6868,7 @@ safe-buffer@~5.1.0, safe-buffer@~5.1.1:
   resolved "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz"
   integrity sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==
 
-"safer-buffer@>= 2.1.2 < 3", "safer-buffer@>= 2.1.2 < 3.0.0":
+"safer-buffer@>= 2.1.2 < 3":
   version "2.1.2"
   resolved "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz"
   integrity sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==
@@ -7370,11 +7526,6 @@ undici-types@~7.16.0:
   resolved "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz"
   integrity sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==
 
-undici@^7.19.0:
-  version "7.20.0"
-  resolved "https://registry.npmjs.org/undici/-/undici-7.20.0.tgz"
-  integrity sha512-MJZrkjyd7DeC+uPZh+5/YaMDxFiiEEaDgbUSVMXayofAkDWF1088CDo+2RPg7B1BuS1qf1vgNE7xqwPxE0DuSQ==
-
 unherit@^1.0.4:
   version "1.1.3"
   resolved "https://registry.npmjs.org/unherit/-/unherit-1.1.3.tgz"
@@ -7821,18 +7972,6 @@ websocket-extensions@>=0.1.1:
   resolved "https://registry.npmjs.org/websocket-extensions/-/websocket-extensions-0.1.4.tgz"
   integrity sha512-OqedPIGOfsDlo31UNwYbCFMSaO9m9G/0faIHj5/dZFDMFqPTcx6UwqyOy3COEaEOg/9VsGIpdqn62W5KhoKSpg==
 
-whatwg-encoding@^3.1.1:
-  version "3.1.1"
-  resolved "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-3.1.1.tgz"
-  integrity sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==
-  dependencies:
-    iconv-lite "0.6.3"
-
-whatwg-mimetype@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-4.0.0.tgz"
-  integrity sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==
-
 whatwg-url@^5.0.0:
   version "5.0.0"
   resolved "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz"