docs: improve Quick Start AI Agent flow to prevent early exit on demo key

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>
This commit is contained in:
gumponchain
2026-03-31 16:02:06 +08:00
committed by GMGN.AI
co-authored by Claude Sonnet 4.6
parent d47404856d
commit aa27e1560a
2 changed files with 30 additions and 12 deletions
+15 -6
View File
@@ -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 34 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
+15 -6
View File
@@ -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