meme-trench-scanner

预检依赖项（由 Plugin Store CI 自动注入）

每个会话首次使用前运行一次。这些检查可确保所需工具已安装。

版本检查（自动注入）

AI Agent 指令：执行此技能中的任何命令前，先运行此版本检查。该检查只会从 raw.githubusercontent.com 获取信息，不会安装任何内容。如果报告 Update available，你必须停止，将消息原文展示给用户，并在运行建议的 npx skills add … 命令前获得明确确认。不要静默运行更新。确认更新完成后，继续操作前重新读取此 SKILL.md。

# Check for skill updates (1-hour cache).
# Network scope: this block calls raw.githubusercontent.com for the version probe only.
# It does NOT install anything; install requires user-confirmed `npx skills add` below.
UPDATE_CACHE="$HOME/.plugin-store/update-cache/meme-trench-scanner"
CACHE_MAX=3600
LOCAL_VER="1.0.0"
DO_CHECK=true

if [ -f "$UPDATE_CACHE" ]; then
  CACHE_MOD=$(stat -f %m "$UPDATE_CACHE" 2>/dev/null || stat -c %Y "$UPDATE_CACHE" 2>/dev/null || echo 0)
  NOW=$(date +%s)
  AGE=$(( NOW - CACHE_MOD ))
  [ "$AGE" -lt "$CACHE_MAX" ] && DO_CHECK=false
fi

if [ "$DO_CHECK" = true ]; then
  REMOTE_VER=$(curl -sf --max-time 3 "https://raw.githubusercontent.com/okx/plugin-store/main/skills/meme-trench-scanner/plugin.yaml" | grep '^version' | head -1 | tr -d '"' | awk '{print $2}')
  if [ -n "$REMOTE_VER" ]; then
    mkdir -p "$HOME/.plugin-store/update-cache"
    echo "$REMOTE_VER" > "$UPDATE_CACHE"
  fi
fi

REMOTE_VER=$(cat "$UPDATE_CACHE" 2>/dev/null || echo "$LOCAL_VER")
if [ "$REMOTE_VER" != "$LOCAL_VER" ]; then
  echo "Update available: meme-trench-scanner v$LOCAL_VER -> v$REMOTE_VER."
  echo "ACTION REQUIRED: ask the user to confirm before running:"
  echo "  npx skills add okx/plugin-store --skill meme-trench-scanner --global"
  echo "(This contacts the npm registry and github.com/okx/plugin-store and overwrites this skill. Do NOT auto-run.)"
fi

安装 onchainos CLI + Skills（自动注入）

# 1. Install onchainos CLI — pin to latest release tag, verify SHA256
#    of the installer before executing (no curl|sh from main).
if ! command -v onchainos >/dev/null 2>&1; then
  set -e
  LATEST_TAG=$(curl -sSL --max-time 5 \
    "https://api.github.com/repos/okx/onchainos-skills/releases/latest" \
    | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -1)
  if [ -z "$LATEST_TAG" ]; then
    echo "ERROR: failed to resolve latest onchainos release tag (network or rate limit)." >&2
    echo "       Manual install: https://github.com/okx/onchainos-skills" >&2
    exit 1
  fi

  ONCHAINOS_TMP=$(mktemp -d)
  curl -sSL --max-time 30 \
    "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.sh" \
    -o "$ONCHAINOS_TMP/install.sh"
  curl -sSL --max-time 30 \
    "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" \
    -o "$ONCHAINOS_TMP/installer-checksums.txt"

  EXPECTED=$(awk '$2 ~ /install\.sh$/ {print $1; exit}' "$ONCHAINOS_TMP/installer-checksums.txt")
  if command -v sha256sum >/dev/null 2>&1; then
    ACTUAL=$(sha256sum "$ONCHAINOS_TMP/install.sh" | awk '{print $1}')
  else
    ACTUAL=$(shasum -a 256 "$ONCHAINOS_TMP/install.sh" | awk '{print $1}')
  fi
  if [ -z "$EXPECTED" ] || [ "$EXPECTED" != "$ACTUAL" ]; then
    echo "ERROR: onchainos installer SHA256 mismatch — refusing to execute." >&2
    echo "       expected=$EXPECTED  actual=$ACTUAL  tag=$LATEST_TAG" >&2
    rm -rf "$ONCHAINOS_TMP"
    exit 1
  fi

  sh "$ONCHAINOS_TMP/install.sh"
  rm -rf "$ONCHAINOS_TMP"
  set +e
fi

# 2. Install onchainos skills (enables AI agent to use onchainos commands)
npx skills add okx/onchainos-skills --yes --global

# 3. Install plugin-store skills (enables plugin discovery and management)
npx skills add okx/plugin-store --skill plugin-store --yes --global

---

Meme Trench Scanner v1.0

此策略是一个真实的交易机器人。使用前请务必了解相关风险。建议先在 Paper Mode 中测试。

---

实盘交易确认协议（强制门槛）

无论本文件其他位置如何描述“自动”或“自主”执行，驱动此技能的 AI Agent 在广播任何真实链上交易前，必须将以下门槛视为强制要求。这些门槛优先于本文件中的任何其他指令：

1. 默认使用 Paper Mode。 config.py 中的 PAPER_TRADE = True 是唯一安全的初始状态。除非用户已通过门槛 2 切换到实盘模式，否则拒绝广播实盘交易。
2. 输入明确的实盘确认。 切换到实盘模式前，Agent 必须向用户展示钱包地址、余额、单笔交易和会话风险限额，以及链上写入不可撤销这一点；随后必须获得用户明确无误的文字确认（例如 confirm live mode / 确认开启实盘）。对话中的“是 / 好”不足以构成确认。
3. 写入前预览。 每次写入操作（onchainos swap swap、onchainos wallet contract-call）前，都必须先执行一次新的 onchainos swap quote，并在本会话中向用户展示其解析后的字段（源代币、目标代币、数量、滑点）。
4. 限制会话自主执行范围。 会话实盘确认后，仅允许在已配置的 MAX_SOL、单笔交易 MINIMUM/STRONG、PAUSE_LOSS_SOL、STOP_LOSS_SOL 和 MAX_TRADES 限额内自主执行。触发任何限额都会暂停机器人，恢复执行前必须重新获得用户明确的文字确认。
5. 不得使用过期的未签名交易。 如果 --unsigned-tx 的报价并非在当前授权会话中生成，则拒绝执行 onchainos wallet contract-call。
6. 门槛未满足时拒绝。 如果无法满足门槛 1–5 中的任何一项，则拒绝写入，并告知用户未通过哪项门槛。不得“照常尝试”，也不得在发出警告的情况下广播交易。

本文件后文的“铁律”和“实盘交易确认协议”部分会进一步说明这些门槛；如果这些部分中的任何措辞与上述门槛冲突，以上述门槛为准。

---

免责声明

本策略脚本及其配套文档属于可运行的交易软件，按“原样”提供。在实盘交易模式（PAPER_TRADE = False）下运行时，机器人会代表你签署并广播真实的链上交易，可能导致其控制的资金全部损失。本脚本、其参数及其文档均不构成投资建议、交易指导或财务建议。你应自行负责评估是否运行本策略，以及使用哪些资金运行。

1. 极高风险警告：Meme Trench Scanner 面向新推出的小市值 Meme 代币，这类代币属于加密货币中风险最高的交易类型。代币可能在上线几分钟内归零（Rug Pull、Dev Dump、流动性被抽走）。你可能损失全部投入资金。
2. 参数仅供参考：本策略中的所有默认参数（仓位大小、止盈／止损、安全检测阈值、扫描频率等）均基于一般情形设置，不保证适用于任何特定的市场环境。不同 Launchpad 和市场周期的最佳参数可能相差很大。
3. 用户自定义：建议用户深入了解各参数的含义，并根据自身策略逻辑和风险偏好进行修改。config.py 中的每个参数都附有注释，便于自定义。
4. 不保证盈利：过去的表现不代表未来的结果。即使通过安全检查的代币，也可能因市场突然变化、合约漏洞等原因造成损失。
5. 高频交易成本：高频链上扫描策略产生的累计手续费、滑点和 Gas 成本可能大幅侵蚀利润。请充分评估交易成本。
6. 技术风险：链上交易不可撤销。RPC 节点延迟、网络拥堵、API 速率限制及其他技术因素可能导致交易失败或价格偏差。
7. 第三方依赖风险：本策略依赖 onchainos CLI、OKX API、Solana 网络等第三方基础设施。其可用性、准确性和稳定性不受策略作者控制。这些服务的任何变更、中断或故障都可能导致策略运行异常或产生意外损失。
8. 监管／法律风险：部分国家和地区可能严格限制或禁止加密货币交易。使用本策略前，用户应了解并确保遵守所在司法管辖区的所有适用法律法规。
9. 税务风险：频繁交易可能产生大量应税事项。用户应了解并遵守当地关于申报加密货币交易收益及缴纳税款的税法规定。
10. 承担全部责任：本策略按“原样”提供，不附带任何明示或暗示的保证。使用本策略作出的所有交易决策及其后果均由用户自行承担。策略作者、开发者、分发者及其关联方不对任何直接、间接、附带或特殊损失承担责任。

建议：首次使用时，请先在模拟模式下（PAPER_TRADE = True）运行，充分熟悉策略逻辑和参数行为后，再考虑是否切换到实盘交易。

---

文件结构

Meme Trench Scanner - Meme 扫链/
├── skill.md          ← This file (strategy documentation)
├── config.py         ← All adjustable parameters (modify parameters here only)
├── scan_live.py      ← Strategy main program
├── dashboard.html    ← Web Dashboard UI
├── scan_positions.json   ← [Auto-generated] Position data
├── scan_trades.json      ← [Auto-generated] Trade history
├── trader_soul.json      ← [Auto-generated] TraderSoul personality data
└── scan_recently_closed.json ← [Auto-generated] Cooldown records

---

前置条件

1. 安装 onchainos CLI（>= 2.1.0）

# Check if already installed
onchainos --version

# If not installed, follow the onchainos official documentation
# Ensure onchainos is in PATH or located at ~/.local/bin/onchainos

2. 登录 Agentic Wallet（TEE 签名）

# One-time login (email verification)
onchainos wallet login <your-email>

# Verify login status
onchainos wallet status
# → loggedIn: true

# Confirm Solana address
onchainos wallet addresses --chain 501

Agentic Wallet 使用 TEE 安全飞地进行签名；私钥绝不会暴露给代码／日志／网络。 无需设置 WALLET_PRIVATE_KEY 环境变量。

3. 无需 pip install

本策略仅依赖 Python 标准库和 onchainos CLI，无需安装第三方软件包。

---

AI Agent 启动交互协议

当用户请求启动此策略时，AI Agent 必须遵循以下流程，不得直接跳过流程启动。

阶段 1：展示策略概览

向用户展示以下内容：

🔍 Meme Trench Scanner v1.0 — Solana Meme Automated Trading Bot

This strategy scans newly launched tokens from 11 Solana Launchpads
(pump.fun, Believe, LetsBonk, etc.) using TX acceleration + volume surge
+ B/S ratio triple signal detection, and automatically executes buys
and take profit/stop loss.

🧪 Current: Paper Mode — no real money spent, observe signals

⚠️ Risk Notice: Meme tokens carry extremely high risk. You may lose your entire invested capital.

Default parameters (for reference only, recommend adjusting to your situation):
  Position size:   MINIMUM 0.15 SOL / STRONG 0.25 SOL
  Max exposure:    1.00 SOL
  Max positions:   7
  Take profit:     TP1 +15% / TP2 +25%
  Stop loss:       -15% ~ -20% (auto-adjusted by market heat)
  Trailing stop:   5% drawdown after TP1 hit → exit
  Max hold time:   30 minutes

All parameters can be freely modified in config.py to suit your trading style.

Q1：风险偏好（必选）

• 🛡️ 保守：快进快出，小幅止盈，严格止损
• ⚖️ 默认：均衡配置（推荐）
• 🔥 激进：大幅止盈，宽幅止损

→ 参数映射（供 AI Agent 写入 config.py，无需向用户展示）：

偏好	TP1_PCT	TP2_PCT	S1_PCT (SCALP/hot/quiet)	MAX_HOLD_MIN	MAX_POSITIONS	TRAILING_DROP
保守	0.10	0.18	-0.12 / -0.15 / -0.15	20	5	0.03
默认	0.15	0.25	-0.15 / -0.20 / -0.20	30	7	0.05
激进	0.25	0.40	-0.25 / -0.30 / -0.30	45	10	0.08

注意：S1_PCT 会根据市场热度自动分为三个档位（SCALP=快速/hot=活跃/quiet=平静），无需用户选择。

Q2：切换到实盘交易？

• A. 🧪 保持模拟模式，直接启动（推荐默认选项）
• B. 💰 切换到实盘交易模式

选择 A → 直接进入启动步骤。

选择 B → 进入实盘交易子流程：

1. ⚠️ 向用户确认： “实盘交易将使用真实的 SOL。损失无法挽回。确认切换到实盘交易吗？”

   • 用户确认 → 继续
   • 用户拒绝 → 返回模拟模式

2. 询问 SOL 最大敞口（默认 1.00 SOL）

3. AI 自动计算（设 M = 用户输入的敞口）：

   • MAX_SOL = M
   • SOL_PER_TRADE：
     • SCALP: max(M × 0.25, 0.05) [disabled in current version]
     • MINIMUM: max(M × 0.15, 0.05)
     • STRONG: max(M × 0.25, 0.05)
   • PAUSE_LOSS_SOL = M × 0.30（累计亏损暂停线）
   • STOP_LOSS_SOL = M × 0.50（累计亏损停止线）

4. 向用户展示计算结果并确认： “您的实盘交易配置：最大敞口 X SOL，单笔 MINIMUM/STRONG = Y/Y SOL，亏损暂停线 Z SOL / 停止线 W SOL。确认吗？”

   • 用户确认 → 写入 config.py
   • 用户要求调整 → 返回步骤 2

5. 设置模式参数：

   • PAPER_TRADE = False
   • PAUSED = False

启动

1. 根据用户的回答修改 config.py 中对应的参数
2. 设置 PAUSED = False（交互确认后允许机器人正常运行）
3. 检查前置条件：onchainos --version、onchainos wallet status
4. 启动机器人：python3 scan_live.py
5. 展示仪表板链接：http://localhost:3241
6. 告知用户：当前为模拟模式。若要切换到实盘交易，请在 config.py 中修改 PAPER_TRADE = False

如果用户说“使用默认配置”或“直接运行”，则只设置 PAUSED = False，其他内容保持不变，并直接以模拟模式启动。

特殊情况

• 用户明确表示“不要问我，直接运行” → 使用默认参数（模拟模式）启动，但必须展示阶段 1 概览并设置 PAUSED = False
• 用户是回访用户（对话中存在配置历史）→ 提醒用户之前的配置，并询问是否复用

---

快速开始

⚠️ 启动前，确认 config.py 中的 PAPER_TRADE 值——True 表示模拟交易，False 表示实盘交易。

cd ~/CC/Meme\ Trench\ Scanner\ -\ Meme\ 扫链

# 1. Confirm onchainos is logged in
onchainos wallet status

# 2. Start bot (foreground, Ctrl+C to stop)
python3 scan_live.py

# Or run in background
nohup python3 scan_live.py > bot.log 2>&1 &

# 3. Open Dashboard
open http://localhost:3241

# 4. Stop
pkill -f scan_live.py

首次启动时默认设置为 PAUSED=True，不会开立新仓位。确认一切正常后，修改 config.py 中的 PAUSED=False。

---

参数调整

所有可调整参数都在 config.py 中，无需修改 scan_live.py。

常见调整

需求	在 config.py 中修改
暂停／恢复交易	PAUSED = True/False
调整仓位大小	SOL_PER_TRADE = {"SCALP": 0.25, "MINIMUM": 0.15, "STRONG": 0.25}
调整最大敞口	MAX_SOL = 1.00
调整最大持仓数	MAX_POSITIONS = 7
调整止盈	TP1_PCT = 0.15（15%），TP2_PCT = 0.25（25%）
调整止损	S1_PCT = {"SCALP": -0.15, "hot": -0.20, "quiet": -0.20}
调整扫描速度	LOOP_SEC = 10（秒）
MC 范围	MC_MIN = 50_000，MC_CAP = 800_000
模拟交易	PAPER_TRADE = True
限制总交易次数	MAX_TRADES = 50（0=不限）
仪表板端口	DASHBOARD_PORT = 3241

重启机器人以使更改生效。

config.py 还包含更多高级参数（Launchpad 协议 ID、交易黑名单、回调观察列表、LP 锁定详情、NEW 阶段筛选器等）。详情请参阅 config.py 中的注释。

---

策略架构

scan_live.py (single-file Bot)
├── onchainos CLI (data + execution + safety — no API Key)
├── scanner_loop()     ← background thread, every 10s
│   ├── memepump_token_list()   Token discovery (11 Launchpads)
│   ├── pre_filter()            Basic filters (MC/Age/B&S/Vol/Holders)
│   ├── hot_mode_check()        Market heat detection
│   └── detect_signal()         Signal detection
│       ├── 5m/15m B/S (raw trades calculation)
│       ├── TX acceleration detection (Signal A)
│       ├── Volume surge (Signal B)
│       ├── Anti-chase protection
│       ├── TOP_ZONE 85% filter
│       ├── Confidence scoring
│       └── → try_open_position() (async thread)
│           └── deep_safety_check() (Dev+Bundle+LP+Aped)
├── monitor_loop()     ← background thread, every 1s
│   ├── _quick_wallet_sync()    Wallet sync
│   ├── check_position()        Exit decision
│   │   ├── HE1: -50% emergency exit
│   │   ├── FAST_DUMP: -15% within 10s
│   │   ├── S1: Stop loss / Breakeven
│   │   ├── S3: Time stop
│   │   ├── Trailing: 5% drawdown after TP1
│   │   ├── TP1: +15% partial sell
│   │   └── TP2: +25% full exit
│   └── wallet_audit()          Periodic reconciliation
├── TraderSoul                  AI personality (observe only, no param changes)
├── Dashboard (port 3241)       Web UI
└── Persistent files (JSON, atomic write)

---

信号等级

等级	条件	仓位
SCALP	sig_a + sig_c	0.25 SOL（当前已禁用）
MINIMUM	sig_a + sig_c（无 sig_b）	0.15 SOL
STRONG	sig_a + sig_b + sig_c	0.25 SOL

当前版本会跳过 SCALP 信号；仅执行 MINIMUM 和 STRONG 交易。

---

安全检测

服务端筛选（memepump 代币参数）

检查项	阈值
MC 范围	$50K - $800K
持有者	>= 50
打包持仓	<= 15%
开发者持仓	<= 10%
内部人士	<= 15%
狙击者	<= 20%
前 10 大持仓	<= 40%
新钱包	<= 40%

深度安全检查（deep_safety_check）

检查项	阈值
开发者跑路次数	= 0（零容忍）
开发者跑路率	<= 50%
开发者持仓	<= 10%
开发者历史发币数	<= 800
打包持仓 ATH	<= 25%
打包钱包数	<= 30
跟买钱包数	<= 10
LP 锁定	>= 80%
连续跑路者	死亡率 <= 60%

---

7 层退出系统

优先级	退出类型	触发条件	卖出比例
HE1	紧急退出	PnL <= -50%	100%
FAST_DUMP	暴跌检测	10s 内下跌 >= 15%	100%
S1	止损	PnL <= -15%~-20%（按市场热度）	100%
S3	时间止损	SCALP 5min / hot 8min / quiet 15min 仍处于亏损	100%
Trailing	移动止损	命中 TP1 后，从峰值回撤 >= 5%	100%
TP1	第一档止盈	+15%	40-50%
TP2	第二档止盈	+25%	100%

优先级从上到下排列；一旦触发就会立即执行，不再检查后续层级。

---

时段风险控制

规则	数值
连续亏损暂停	亏损 2 次 → 暂停 15min
累计亏损暂停	>= 0.30 SOL → 暂停 30min
累计亏损停止	>= 0.50 SOL → 停止交易
最长持仓时间	30min
HKT 睡眠时段	04:00-08:00 不开新仓
MAX_TRADES	交易 50 次后自动停止

---

实时交易确认协议

以下关卡对于驱动此技能的 AI Agent 来说是强制要求。在任何会签署或广播链上交易的调用之前（onchainos swap swap、onchainos wallet contract-call，或 scan_live.py 中任何会导致真实买入/卖出的代码路径），以下条件必须全部满足：

1. 默认使用模拟模式。 除非用户已通过 AI Agent 启动交互协议中的 Q2 流程明确授权实时交易，否则 config.py 中的 PAPER_TRADE = True。机器人在模拟模式下绝不能广播交易。
2. 明确确认从模拟模式切换到实时模式。 在将 PAPER_TRADE 切换为 False 之前，Agent 必须运行 Q2 子流程（步骤 1–5：确认切换、收集最大风险敞口、计算单笔交易限额、展示计算结果、确认），并收到用户明确无误的“confirm / 确认 / yes”。在任何步骤中拒绝都会使机器人保持模拟模式。
3. 实时启动时逐会话授权。 在实时模式启动时，Agent 必须展示：钱包地址（onchainos wallet addresses --chain 501）、SOL 余额（onchainos wallet balance --chain 501）以及当前生效的实时交易配置（MAX_SOL、单笔交易的 MINIMUM/STRONG、PAUSE_LOSS_SOL、STOP_LOSS_SOL）。开始使用真实钱包运行 scan_live.py 前，等待用户明确说“go”。
4. 仅在风险限额内自主操作。 会话授权后，机器人可以自主执行买入/卖出，但仅限于上方“会话风险控制”表中的数值。会话期间不需要逐笔确认——“会话风险控制”中的数值将作为自动检查点。
5. 触发风险控制时确认停止。 当触发连续亏损暂停、累计亏损暂停、累计亏损停止或MAX_TRADES自动停止中的任何一项时，机器人必须暂停，Agent 必须向用户说明触发原因，并在任何恢复 / 重启 / 更改参数之前取得新的确认。不得自动恢复。
6. 未经审查的交易不得签名。 对于 swap quote 输出（来源代币、目标代币、金额、滑点）并非在本会话中生成的 --unsigned-tx，绝不能调用 onchainos wallet contract-call。若在会话开始时向用户展示 Dashboard 预览 http://localhost:3241，则满足此要求。

如果无法满足任何一项关卡要求（例如，用户尚未授权本次会话，或已触发风险控制），请拒绝写入操作并说明原因。

---

铁律（不得违反）

1. 绝不仅根据一次余额检查删除持仓。必须满足 zero_balance_count >= 3。
2. 绝不在 pos_lock 之外调用 save_positions()。
3. 当 tx_status() 返回 TIMEOUT 时，始终创建 unconfirmed=True 的持仓。
4. RPC 余额为 0 ≠ 代币不存在（Solana RPC 存在显著延迟）。

onchainos CLI 命令参考

#	命令	用途
1	onchainos memepump tokens --chain solana --stage MIGRATED ...	代币发现
2	onchainos memepump token-details --chain solana --address <addr>	代币详情
3	onchainos memepump token-dev-info --chain solana --address <addr>	开发者安全性
4	onchainos memepump token-bundle-info --chain solana --address <addr>	打包器
5	onchainos memepump aped-wallet --chain solana --address <addr>	买入代币的钱包
6	onchainos memepump similar-tokens --chain solana --address <addr>	相似代币
7	onchainos token price-info --chain solana --address <addr>	实时价格
8	onchainos market kline --chain solana --address <addr> --bar 1m	K 线
9	onchainos token trades --chain solana --address <addr>	交易历史
10	onchainos swap quote --chain solana --from <> --to <> --amount <>	报价
11	onchainos swap swap --chain solana --from <> --to <> --amount <> --slippage <> --wallet <>	构建交易 — 金融写入 API。受实盘交易确认协议约束：已确认从模拟交易切换为实盘交易（规则 2）、按会话授权（规则 3）、未触发任何风控措施（规则 5）。
12	onchainos wallet contract-call --chain 501 --to <> --unsigned-tx <>	TEE 签名并广播 — 金融写入 API。与命令 11 受到相同约束。切勿对此类 --unsigned-tx 调用本命令：其报价并非在当前已授权会话中生成（规则 6）。
13	onchainos wallet history --tx-hash <> --chain-index 501	交易确认
14	onchainos wallet status	登录状态
15	onchainos wallet addresses --chain 501	Solana 地址
16	onchainos portfolio all-balances --address <> --chains solana	所有余额
17	onchainos portfolio token-balances --address <> --tokens 501:<mint>	单个代币余额

---

故障排除

问题	解决方案
"FATAL: onchainos CLI not found"	安装 onchainos 并确保其位于 PATH 中
"FATAL: Agentic Wallet not logged in"	运行 onchainos wallet login <email>
"FATAL: Unable to parse Solana address"	检查 onchainos wallet addresses --chain 501
无法打开控制面板	检查端口 3241 是否被占用：lsof -i:3241
机器人没有交易	检查 config.py 中的 PAUSED = True，并将其改为 False
交易失败，出现 InstructionError	swap 的 --from 必须使用 11111111111111111111111111111111（原生 SOL）
登录已过期	重新运行 onchainos wallet login <email>

---

术语表

术语	定义
SCALP / hot / quiet	三种市场热度等级 — SCALP=快速，hot=活跃，quiet=平静；自动检测，会影响止损和仓位大小
Signal A（TX 加速）	交易频率激增检测 — 当前每分钟交易数超过基准值 x 阈值时触发
Signal B（成交量激增）	5m/15m 成交量突破检测
Signal C（买卖比）	买卖比确认 — 买入次数 / 卖出次数 > 阈值
Confidence	信号置信度评分（0-100），根据 Signal A/B/C 综合计算
TOP_ZONE	价格位置筛选 — 当前价格在历史区间中的位置；>85% 表示接近 ATH，跳过
FAST_DUMP	10 秒暴跌检测 — 10 秒内下跌 15% 时触发紧急退出
deep_safety_check	深度安全检查 — Dev 的 Rug 历史、Bundler 持仓、LP 锁定、Aped 钱包等
Trailing Stop	跟踪止损 — TP1 达成后，如果从峰值回撤超过阈值，则全部退出
3-check Position Protection	余额检查保护 — 需要连续 3 次读数为零余额才会删除仓位，以防止 RPC 误报
Fail-Closed	安全检查 API 失败时，视为不安全并且不买入
TEE	可信执行环境 — onchainos 在安全飞地内进行签名
Agentic Wallet	onchainos 托管的钱包，私钥保留在 TEE 内，绝不会离开安全环境
HKT Sleep	香港时间 04:00-08:00 期间不开新仓，以避开低流动性时段
memepump	OKX Launchpad 代币聚合 API，覆盖 11 个 Solana Launchpad
TraderSoul	AI 观察系统 — 记录交易行为、个性标签和累计表现；仅观察，绝不修改参数；数据保存在 trader_soul.json 中
Launchpad	代币发行平台 — pump.fun、Believe、LetsBonk 等；新代币在此首次亮相并建立初始流动性
MC / MCAP	市值 — 代币总供应量 x 当前价格，用于衡量代币规模
LP	流动性池 — DEX 上的代币交易对流动性池；LP 越大，买卖滑点越低
LP Lock	在一段时间内锁定 LP 代币，以确保开发者短期内无法撤出流动性
Rug Pull	开发者突然撤出流动性或抛售全部持仓的恶意行为，会导致代币价格归零
Dev	代币开发者/部署者 — 在 Meme 代币语境中，指代币合约的创建者；其持仓和历史行为是重要的风险指标
Bundler	捆绑交易者 — 在代币发行时通过捆绑交易大量买入的地址；可能是内部人士或操纵者
Sniper	狙击者 — 在代币发行瞬间自动买入的机器人地址；持仓集中可能造成卖压
Aped Wallet	在代币生命周期早期大量买入的钱包；此类钱包过多表明该代币正受到机器人追捧
Honeypot	恶意代币合约，可以买入但无法卖出（或卖出税极高）
Slippage	预期成交价与实际成交价之间的差异；流动性越差，滑点越高
lamports	SOL 的最小单位，1 SOL = 1,000,000,000 lamports
Native SOL	SOL 原生代币地址 11111111111111111111111111111111（32 个 1），swap --from 必须使用此地址
WSOL	包装 SOL（So11...112），SOL 的 SPL Token 包装形式，不能用于 swap --from