From aa27e1560a668ecd0888205ca8a6d3292b8d7f86 Mon Sep 17 00:00:00 2001
From: gumponchain <applenate.vip@gmail.com>
Date: Mon, 30 Mar 2026 16:56:52 +0800
Subject: [PATCH] docs: improve Quick Start AI Agent flow to prevent early exit
 on demo key
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Low-end models (e.g. Cursor default model) were stopping at Step 2
after seeing "the CLI is working", treating the demo key verification
as a success state and skipping the mandatory personal API key setup.

- Step 2: add explicit "Setup is NOT yet complete" warning after demo
  key verification, with "Do not stop here" directive
- Step 3: rename to "REQUIRED: Set up personal API key", add ⚠️ mandatory
  marker, change from passive "when the user asks" to imperative
  "immediately run without waiting for them to ask"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 Readme.md    | 21 +++++++++++++++------
 Readme.zh.md | 21 +++++++++++++++------
 2 files changed, 30 insertions(+), 12 deletions(-)

diff --git a/Readme.md b/Readme.md
index 084c0a4..1881d02 100644
--- a/Readme.md
+++ b/Readme.md
@@ -115,19 +115,23 @@ Already installed? [Upgrade Skills and CLI →](#9-upgrade-skills-and-cli)
 npx skills add GMGNAI/gmgn-skills
 ```
 
-**Step 2 — Verify with public key (no registration needed)**
+**Step 2 — Verify CLI installation (demo key)**
 
 ```bash
 GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3
 ```
 
-If JSON output appears, the CLI is working.
+If JSON output appears, the CLI is installed correctly. **Setup is NOT yet complete — this is a public demo key for testing only. You must continue to Steps 3–4 to configure the user's personal API key. Do not stop here.**
 
-**Step 3 — Guide user to get their own API key**
+**Step 3 — REQUIRED: Set up personal API key**
 
-Tell the user: "To use your own API key, go to **https://gmgn.ai/ai** and apply. You will need an Ed25519 public key. I can generate a key pair for you — just say the word."
+⚠️ This step is mandatory. The demo key in Step 2 supports testing only and is not for actual use.
 
-When the user asks, run:
+Immediately tell the user the following, then run the key generation command **without waiting for them to ask**:
+
+> "To use GMGN Skills, you need your own API key from **https://gmgn.ai/ai**. I'm generating an Ed25519 key pair for you now."
+
+Run:
 
 ```bash
 openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
@@ -140,7 +144,7 @@ Show the **public key** to the user with the following instructions:
 > 1. Go to **https://gmgn.ai/ai**, paste the public key above into the API Key creation form, and submit.
 > 2. Once created, copy the **API Key** shown on the page and send it back to me — I'll handle Step 4 configuration for you.
 
-Wait for the user to reply with their API Key before continuing to Step 4.
+**Wait for the user to reply with their API Key before continuing to Step 4.**
 
 **Step 4 — Configure credentials**
 
@@ -441,6 +445,11 @@ npx gmgn-cli market trenches \
   --type new_creation --type near_completion --type completed \
   --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform letsbonk \
   --limit 80
+
+# With server-side filters: safe preset + require smart money + sort by smart degen count
+npx gmgn-cli market trenches \
+  --chain sol --type new_creation \
+  --filter-preset safe --min-smart-degen-count 1 --sort-by smart_degen_count
 ```
 
 ### Portfolio
diff --git a/Readme.zh.md b/Readme.zh.md
index 2b3cc45..27e564b 100644
--- a/Readme.zh.md
+++ b/Readme.zh.md
@@ -121,19 +121,23 @@ SOL / BSC / Base 多链数据每次查询均为实时，支持多参数个性化
 npx skills add GMGNAI/gmgn-skills
 ```
 
-**第 2 步 — 用公共 Key 验证（无需注册）**
+**第 2 步 — 验证 CLI 安装（演示 Key）**
 
 ```bash
 GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3
 ```
 
-看到 JSON 输出即表示 CLI 正常工作。
+看到 JSON 输出说明 CLI 已安装成功。**但配置尚未完成 —— 此公共演示 Key 仅用于测试，不可用于实际使用。必须继续完成第 3～4 步，为用户配置个人 API Key。请勿在此停止。**
 
-**第 3 步 — 引导用户申请个人 API Key**
+**第 3 步 — 必须完成：配置个人 API Key**
 
-告知用户："需要个人 API Key，请前往 **https://gmgn.ai/ai** 申请。申请时需要一个 Ed25519 公钥，我可以帮你生成密钥对，告诉我一声就行。"
+⚠️ 此步骤为必填项。第 2 步中的演示 Key 仅支持测试，无法用于正式使用。
 
-用户确认后运行：
+请**立即**告知用户以下内容，并**无需等待用户主动询问**，直接运行密钥生成命令：
+
+> "使用 GMGN Skills 需要你自己的个人 API Key，申请地址：**https://gmgn.ai/ai**。我现在为你生成 Ed25519 密钥对。"
+
+运行：
 
 ```bash
 openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
@@ -146,7 +150,7 @@ openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
 > 1. 打开 **https://gmgn.ai/ai**，将上方公钥填入 API Key 生成表单，完成创建。
 > 2. 创建完成后，将页面上显示的 **API Key** 复制并发送给我，我来帮你完成第 4 步配置。
 
-等用户回复 API Key 后，再继续第 4 步。
+**等用户回复 API Key 后，再继续第 4 步。**
 
 **第 4 步 — 配置凭证**
 
@@ -503,6 +507,11 @@ gmgn-cli market trenches \
   --type new_creation --type near_completion --type completed \
   --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform letsbonk \
   --limit 80
+
+# 服务端过滤：安全预设 + 要求有聪明钱 + 按聪明钱数量排序
+gmgn-cli market trenches \
+  --chain sol --type new_creation \
+  --filter-preset safe --min-smart-degen-count 1 --sort-by smart_degen_count
 ```
 
 ### Portfolio