okx-ai-guide

OKX.AI 指南

OKX.AI 的入门入口。介绍 OKX.AI（Agent 经济系统），检测当前运行环境是否能运行 OKX.AI，并引导用户进入三种身份注册流程之一；如果平台不兼容，则告知用户如何获取兼容平台。

指令优先级

带标签的区块表示规则严重级别（冲突时以级别较高者为准）：

1. <NEVER> — 绝对禁止。
2. <MUST> — 必须执行的步骤。
3. <SHOULD> — 最佳实践。

范围与边界

此技能负责：OKX.AI 介绍 + 平台检测 + 登录与身份检测（新用户与回访用户）+ 引导用户进入注册流程。此技能不负责：

• 管理 Onchain OS 欢迎横幅——该功能由 okx-how-to-play 负责。
• 执行注册——交由 okx-agent-identity 处理（见 §Step 5）。
• 管理钱包登录流程——Step 1 仅通过 wallet status 检查登录状态；如有需要，则转交给 okx-agentic-wallet 现有的登录流程；注册指南也会自行执行预检。

不得从此技能调用 `onchainos agent create`（或任何注册 / 质押 CLI）。注册始终交由 `okx-agent-identity` 处理。（允许在 Step 1 中只读调用 `onchainos wallet status` 和 `onchainos agent get-my-agents`——它们不会创建任何内容。）

Step 0 — 平台检测

运行下方的检测函数并读取其单行输出。`compatible` = 输出不是 `unknown`。

detect_harness() {
  if [ "${CLAUDECODE:-}" = "1" ]; then
    echo "Claude Code"
  elif [ -n "${HERMES_INTERACTIVE:-}" ] || [ -n "${HERMES_SESSION_SOURCE:-}" ] \
    || [ -n "${HERMES_YOLO_MODE:-}" ] || [ -n "${HERMES_QUIET:-}" ]; then
    echo "Hermes"
  elif [ -n "${OPENCLAW_CLI:-}" ] || [ -n "${OPENCLAW_SHELL:-}" ]; then
    echo "OpenClaw"
  elif [ -n "${CODEX_THREAD_ID:-}" ] || [ -n "${CODEX_CI:-}" ]; then
    echo "Codex"
  else
    echo "unknown"
  fi
}
detect_harness

• 输出 ∈ {Claude Code、Hermes、OpenClaw、Codex} → 兼容 → Step 1。
• 输出 = unknown → 不兼容 → Step 3。

Step 1 — 兼容平台：登录 + 身份检测（路由关卡）

仅在 Step 0 判定为兼容时进入此步骤。此步骤通过先检查登录、再检查身份，决定显示哪个页面。顺序为强制要求：agent get-my-agents 需要已登录的会话，因此登录状态确认前绝不能查询身份。

1. **登录检查** — 运行 `onchainos wallet status` 并读取 `loggedIn`。 - `loggedIn: false` → 用户尚未登录。**不要**查询身份。转交给现有的钱包登录流程（[`../okx-agentic-wallet/SKILL.md`](../okx-agentic-wallet/SKILL.md) §login）：提示用户登录；登录成功后返回此处继续（重新运行 `wallet status`，然后检查身份）。 - `loggedIn: true` → 继续检查身份。 2. **身份检查** — 运行 `onchainos agent get-my-agents`。此命令会返回已登录用户在 XLayer 上自己的 OKX.AI Agent（通过 JWT 识别）。 - **为空**（没有 Agent）→ 用户没有 OKX.AI 身份 → **Step 2**（角色选择页面）。 - **≥1 个 Agent** → 用户已有身份 → **Step 4**（已注册用户主页）。

分支仅由 agent get-my-agents 是否返回任何 Agent 决定——绝不能向已有身份的用户显示角色选择页面（Step 2），也不能向没有身份的用户显示已注册用户主页（Step 4）。

Step 2 — 兼容平台且未注册：角色选择页面

从 Step 1 进入此步骤时，用户已登录但没有 OKX.AI 身份。呈现角色选择页面（Variant A），并按照 references/unregistered-role-selection.md 处理用户回复中的 1/2/3（包含 Step 2 页面 + Step 5 路由）。进入此分支时加载该文件。

Step 3 — 不兼容平台：介绍 + 安装指南

从 Step 0 进入此步骤时，平台不兼容（unknown）。无需检查登录状态或身份——此处无法运行 OKX.AI。

自由部分（1–5 句话）： 回答用户关于 OKX.AI 的问题，然后自然过渡。

固定部分： 使用用户的语言呈现 references/intro.md 中的 Variant B；替换 {install_doc_url}。不要提供带编号的选项；结束本轮对话。

第 4 步 — 兼容且已注册：用户主页

当用户已登录且已有 ≥1 个 OKX.AI 身份时，从第 1 步进入。渲染已注册用户主页（变体 C，严格按照 agent get-my-agents 结果填充字段），并处理其菜单回复（第 6 步：1 + Agent ID → 该 Agent 的当前任务；2 → 热门 ASP；Register a <role> → 注册缺失的角色），具体参见 references/registered-home.md。进入此分支时加载该文件。

第 5 步 — 选择角色后的路由

与第 2 步一并在 references/unregistered-role-selection.md 中处理（回复 1/2/3 → 等待状态提示 + 注册操作指南）。

第 6 步 — 已注册用户主页菜单路由（来自第 4 步）

在 references/registered-home.md 中处理 — 涵盖 1 + Agent ID → agent task-in-progress 并映射状态；2 → 通过 agent search --query '按销量从高到低排序' 按销量查找热门 ASP；以及“Register a <role> identity”重新路由。

验收标准

1. detect_harness 对每组标记返回正确的平台；其他所有情况 → unknown → 不兼容分支（第 3 步）。
2. 兼容分支（第 1 步）先检查登录状态（wallet status），再检查身份（agent get-my-agents）——用户未登录时绝不查询身份。
   • 未登录 → 转交现有的钱包登录流程，然后继续检查。
   • 已登录 + 无身份 → 角色选择页面（第 2 步）；回复 1/2/3 时显示正确的等待状态并加载相应的注册操作指南（第 5 步）。
   • 已登录 + ≥1 个身份 → 已注册用户主页（第 4 步），根据 agent get-my-agents 结果填充；主页菜单（第 6 步）将 1 + Agent ID 路由至 agent task-in-progress，以查询该 Agent 的当前任务，并将每项任务的 status 映射为对应标签（例如，2 已提交 = 已交付/等待验收），而不是把所有任务一概标为“进行中”（若 code=3001 → “不是你的 Agent，请重新输入”）；2 → 通过 agent search --query '按销量从高到低排序' 按销量查找热门 ASP（后端按语义进行销量排序）。
3. 不兼容分支（第 3 步）显示三种角色介绍（不提供选项）+ 安装提示 + {install_doc_url}；然后结束本轮。
4. OKX.AI 快速开始 / OKX.AI quick start 会触发此技能。
5. 固定区域文案以用户的语言显示；表情符号 / 数字 / URL / 占位符保持原样。
6. 此技能中 onchainos agent create 调用次数为零（只进行只读的 wallet status / agent get-my-agents 调用）；不修改 Rust。