渲染与数字路由规范:okx-guide 技能的新手引导入口实战指南)
【免费下载链接】internet-court-skillThe trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 payments, escrow, and dispute resolution as one open, catch-all Agent Skill / Claude Code plugin.项目地址https://gitcode.com/gh_mirrors/in/internet-court-skill点击查看免费下载本篇文章围绕internet-court-skill仓库中vendored/okx/okx-guide技能的入口文档 welcome.md 展开系统讲解 Onchain OS 欢迎横幅的完整渲染流程登录态探测、Polymarket 地理封锁的 fail-closed 判定、双变体模板、以及「数字即显示索引」的路由契约。读完本文你将掌握在 Agent 会话中正确渲染欢迎横幅、处理过期会话、路由登录门控选项、并以静默方式降级被地理封锁菜单项的完整实现方案。1. 欢迎横幅在 okx-guide 技能中的定位欢迎横幅Welcome Banner是 Onchain OS 新手引导的核心入口。在 okx-guide/SKILL.md 的意图路由表中凡是「第一次使用 / what is onchainos / what can it do / how to use / how to play / getting started / tutorial / I just installed / now what / where do I start / Im new / 欢迎横幅 数字选择路由」这类意图都会先加载 how-to-play.md而该文件内部明确要求渲染横幅必须以 welcome.md 为准——它承载了占位符{evm_address}/{solana_address}/{balance}、地理封锁变体判定以及 Step 4 的选择路由。横幅本体按登录态分为两个变体Variant A / Variant B两者共享同一个5 段式结构3 行头部header—— 价值主张两种登录态下完全相同地址块address block—— 仅登录态显示EVM、Solana、USD 余额OKX.AI 精选块—— Todays highlight 价值主张 专属 CTAReply 1次级编号菜单—— Other things you might likeVariant A 3 项Variant B 2 项底部免责声明disclaimer—— 每次渲染的最后一行非空内容。变体差异由polymarket_available决定Variant Apolymarket_available true共4 个选项1 OKX.AI 精选 CTA2 Polymarket3 USDC APY4 Daily briefVariant Bpolymarket_available false共3 个选项1 OKX.AI 精选 CTA2 USDC APY3 Daily brief。同时横幅渲染前必须先经过 preflight.md 描述的共享预检运行onchainos preflight --skill-version 版本号并读取data.action字段预检始终退出 0action为null时静默继续非null时向用户展示并按其指示执行例如onchainos upgrade --force。该预检仅在 onboarding 流程§1 → how-to-play中执行。2. Step 1 — 自由区Free Zone的取舍规则横幅头部本身已经回答了「Onchain OS 是什么 / 怎么玩」——它包含 Hi, welcome to Onchain OS. 以及 3 句价值主张解释 Onchain OS 是什么、如何运作。因此在自由区重复这些内容是纯冗余应当直接跳过。具体判定表如下用户开场是否渲染自由区what is onchainos / how do I play / how to use / what can it do / introduce yourself / tutorial / getting started跳过直接进入横幅I just installed it, now what / where do I start / Im new用 1 句简短话确认然后过渡bridge用户同时附带提出无关的具体问题用 1–3 句回答该问题然后过渡过渡Bridging的硬性要求仅在存在自由区时以半句话收尾例如 let me drop the menu / heres where to start ↓绝不能用硬句号结尾再紧接横幅首行。自检方法把自由区尾句与横幅首行连起来读一遍如果像两条被粘贴在一起的消息就重写尾句如果自由区在复述横幅已有的内容则整段删除自由区。3. Step 2 — 渲染前的占位符准备BEFORE Rendering3.1 登录态Auth State登录态来自先前已经执行过的onchainos wallet status据此选择横幅变体loggedIn: true→登录态变体loggedIn: false→登出态变体。在 how-to-play.md 的 Status Check 一节中同样规定在展示任何登录或欢迎文案之前必须运行onchainos wallet status并以loggedIn字段分支。3.2 地址与余额仅登录态变体从onchainos wallet balance的响应中提取evmAddress、solAddress与总 USD 余额。绝不虚构这些数据。关键兜底MUST——过期会话回退wallet status可能基于缓存凭证返回loggedIn: true而实际上会话的 refresh token 已经过期——此时wallet balance会失败例如返回{ok: false, error: Refresh token expired. Log in again.}或返回结果中缺少地址/余额字段。当余额调用失败或字段缺失时不要渲染登录态横幅不要展示部分或虚构数据告知用户会话已过期、需要重新登录路由到 how-to-play.md 的Login Method Choice重新登录完成后按Post-login routing恢复以现在有效的地址 余额渲染登录态欢迎横幅。禁止调用onchainos wallet qrcode—— QR 码已不属于横幅。该 CLI 子命令仍可直接使用但欢迎流程不再渲染 QR 码块状图。3.3 Polymarket 地理封锁检查fail-closedPolymarket 在部分司法管辖区受限如美国。在决定渲染 Variant A 还是 Variant B 之前先用onchainos wallet geoblock探测地理状态onchainos wallet geoblock预期 stdout退出码 0{blocked:false}polymarket_available必须严格按下述规则设定退出码 0且stdout 能解析为 JSON且blocked false→polymarket_available true任何其他结果—— 非零退出码、JSON 解析失败、blocked字段缺失或非布尔值、或blocked true—— →polymarket_available false。这是**默认失败即封锁fail-closed**的设计。不要向用户警告或透露地理封锁判定结果静默切换到被封锁的菜单变体即可。4. Step 3 — 渲染横幅模板以下模板为规范英文版canonical English。运行时须按 how-to-play.md 的 Authoring Pattern 全局翻译规则以用户会话语言渲染。输出为纯文本无引用前缀、无围栏渲染顺序自上而下header → 仅登录态地址块→ OKX.AI 精选块 → 次级编号菜单 → trailer → 免责声明。下方围栏只是本文档中的模板容器实际输出只发射围栏内部的文本。4.1 Header —— 两种变体相同Hi, welcome to Onchain OS. Im your on-chain AI sidekick — just talk to me to trade, check markets, and chase trends. Wallet, trading, market data, payments — all in one place, ready out of the box — no more juggling a dozen DApps, re-connecting wallets, or reviewing signatures every time.4.2 地址块 —— 仅登录态变体Your Agentic Wallet addresses: EVM: {evm_address} Solana: {solana_address} Balance: ${balance}其中{evm_address}、{solana_address}、${balance}均来自 Step 2.2 的wallet balance响应逐一填充绝不虚构。4.3 OKX.AI 精选块 —— 两种变体相同这是主要精选段渲染于次级编号菜单之上。它本身不是编号选项之一其专属 CTA 就是字面上的Reply 1。✨ Todays highlight — OKX.AI Ever thought about doing business with an Agent? Post tasks and buy services — let other peoples Agents do the work for you. Or put your own Agent to work selling services 24/7, earning while you kick back. One person, with a fleet of Agents, is a whole company. Reply 1 to see how OKX.AI works →4.4 次级菜单 —— Variant Apolymarket_available true3 个编号选项Other things you might like: 2 · Polymarket — top 3 markets worth watching today, Ill handpick them 3 · Dont let your USDC sit idle — lets find the best APY right now ☕ 4 · One coffees time to digest todays on-chain market4.5 次级菜单 —— Variant Bpolymarket_available false2 个编号选项无 PolymarketOther things you might like: 2 · Dont let your USDC sit idle — lets find the best APY right now ☕ 3 · One coffees time to digest todays on-chain market4.6 Trailer结尾提示登出态Which one? Just reply with 1–N 登录态Which one? Just reply with 1–N 其中N在 Variant A 中替换为4在 Variant B 中替换为3。4.7 Disclaimer —— 永远在底部两种变体一致这是每次渲染的最后一行非空内容两种变体、两种登录态均如此其后不再渲染任何内容即 welcome.md 末尾的 Canonical render terminator**Attention ⚠️:** AI analysis is for reference only, trade with caution.5. Step 4 — 选项处理Pick Handling与数字路由契约数字路由契约已锁定编号选项必须严格对照当前渲染中的菜单解释。例如用户在 Variant B 中输入 2会被路由到 Variant B 槽位 2 的描述USDC APY而不是PolymarketVariant A 的槽位 2。数字是显示索引不是稳定的规范 ID这一规则适用于两种变体中的所有编号槽位。因此应按选项的描述路由而不是按原始数字数字会在变体之间偏移。完整路由表Reply变体描述登录门控目标1A BOKX.AI 精选是登出 → Login Method Choice → 恢复ai-guide.md2A Polymarket Top 3否调用okx-dapp-discovery其会路由到 / 安装polymarket-plugin2B USDC APY否调用okx-defi3A USDC APY否调用okx-defi3B☕ 每日链上简报是登出 → Login Method Choice → 恢复~/.onchainos/workflows/daily-brief.md4A☕ 每日链上简报是登出 → Login Method Choice → 恢复~/.onchainos/workflows/daily-brief.md5.1 Reply1— OKX.AI 精选登录门控两种变体OKX.AI 是主推精选选项认证处理如下已登录用户直接加载 ai-guide.md。附一行过渡语Handing off to OKX.AI — meet your Agent.。未登录用户一行过渡文案OKX.AI needs a wallet logged in — Ill walk you through login first, then well pick this up right after.路由到 how-to-play.md 的Login Method Choice记住原始选项。登录完成后自动恢复——加载ai-guide.md不要重新渲染欢迎横幅也不要要求用户重新表述。ai-guide.md本身是 OKX.AI 的注册入口它先用detect_harness检测运行时平台Claude Code / Hermes / OpenClaw / Codex 为兼容平台再用onchainos wallet status查登录、用onchainos agent get-my-agents查身份进而分流到角色选择页unregistered-role-selection.md、不兼容平台介绍页intro.md或已注册用户主页registered-home.md。5.2 Reply2/ Reply3Variant A—— 技能选项无登录门控技能自身在需要时会自行处理认证不要预先拦截登录。 PolymarketVariant A 的2调用okx-dapp-discovery技能附一行过渡语Handing off Polymarket to dapp-discovery.不要预先解释或预路由。 USDC APYVariant A 的3、Variant B 的2调用okx-defi技能传入用户意图find best USDC APY。5.3 Daily brief —— 登录门控Variant A 的4、Variant B 的3Daily brief 假定已认证的钱包其内部大多数 CLI 命令都需要登录。已登录用户直接加载~/.onchainos/workflows/daily-brief.md并按其执行。未登录用户一行过渡文案This one needs the wallet logged in — Ill walk you through login first, then well pick this up right after.路由到Login Method Choice记住原始选项登录完成后自动恢复加载daily-brief.md不重新渲染横幅、不要求用户重述与 OKX.AI 路径对称。5.4 login 回复仅登出态当登出用户回复login或类似词时路由到Login Method Choice。登录完成后渲染登录态欢迎横幅让用户看到自己的地址 余额。不要在此分支自动加载任何选项目标——用户要求的是登录而不是执行某个具体选项。5.5 自由文本任意状态其他任何输入非编号选项、非login、非隐藏选项关键词先在自由区作答然后按 how-to-play.md 的Free-form fallback表路由。其中值得注意的是自由文本中的smart money/ 巨鲸跟踪意图或new tokens/ 新上线代币意图 → 路由到okx-dex。这两个描述已不在编号菜单中但 Free-form fallback 仍能正确路由它们对应 how-to-play 中 meme sniping / pump.fun / new launches, or follow smart money / KOL / whale →okx-dex或加载smart-money-signals.mdyield / earn / stake / DeFi →okx-defilogin → 本技能的 Login Method Choice具名 DApp 动作动词 →okx-dapp-discovery。5.6 用户点选隐藏选项例如 Variant B 渲染时输入 polymarket用户选择了一个不在当前菜单上的描述最常见geoblock 返回非blocked:false时提到 Polymarket。禁止复述它被隐藏的原因禁止说出 region、blocked、geo、your country、jurisdiction、restricted 或任何能让用户反推出 geoblock 结果的字眼。使用将用户留在可见菜单上的中性重定向That one isnt available here right now — anything else from the menu work for you? Reply 1–3 Variant B 的选项数是 3如果 Variant A 进入此分支把3换成4。如果用户继续追问重复该重定向不要协商也不要解释超出 not available right now 的内容。5.7 登录放弃 —— 任何登录门控路由如果用户选择了登录门控选项任意变体的 Reply1OKX.AIVariant A 的 Reply4Daily briefVariant B 的 Reply3Daily brief随后在Login Method Choice流程中放弃未完成登录则流程在 Login Method Choice 处停止原始目标ai-guide.md或daily-brief.md不会被自动恢复欢迎横幅也不会重新渲染。将放弃呈现为干净的退出若用户稍后再次参与将新一轮视为全新请求处理。5.8 下游技能加载失败横幅形态变体、选项数、编号在渲染时已根据 Step 2 占位符固定。如果用户点选后下游技能加载失败例如okx-defi未安装、ai-guide.md找不到、daily-brief.md缺失在点选之后呈现失败即可——横幅不会追溯重渲染数字到描述的映射也不会改变。若用户重试让他们走失败技能定义的标准错误/回退路径而不是重新走一遍全新横幅。6. 登录方法选择与登录后路由上下文衔接当用户对登出横幅回复login或从欢迎菜单选择登录门控工作流时会进入 how-to-play.md 的Login Method Choice固定区模板Welcome to Agentic Wallet — the Onchain OS wallet built for agents. Pick a login method: 1. Email (recommended — 30 seconds) 2. API Key (already an OKX developer? Fastest path) Reply 1 or 2 ↓回复1或 email →Email Loginonchainos wallet login email --locale locale→onchainos wallet verify code回复2或 API Key →API Key Login先展示一次性提示需设置OKX_API_KEY、OKX_SECRET_KEY、OKX_PASSPHRASE三个环境变量并警告不要在聊天中粘贴凭证用户确认后再运行onchainos wallet login。Post-login routing登录成功后的恢复逻辑来自登出态 OKX.AI 选项Reply1→ 自动加载ai-guide.md不重渲染横幅来自登出态 Daily briefVariant A 的4/ Variant B 的3→ 自动加载~/.onchainos/workflows/daily-brief.md来自登出态其他工作流选项 → 自动加载对应工作流文件~/.onchainos/workflows/file.md来自登出横幅回复login→ 渲染登录态欢迎横幅展示地址 余额。7. 可验证的验收标准Acceptance Criteriahow-to-play.md 为欢迎横幅流程定义了明确的验收标准可据此自检实现质量横幅变体匹配登录态——loggedIn: false渲染登出变体无地址loggedIn: true渲染登录变体地址 余额技能选项无登录门控即可加载—— PolymarketVariant A 的 2与 USDC APYA 的 3 / B 的 2在登出时也能加载各技能自行处理认证OKX.AIReply 1与 Daily briefA 的 4 / B 的 3以登录为门—— 登出时先走 Login Method Choice再自动恢复所选目标ai-guide.md或daily-brief.md不重渲染欢迎横幅smart-money / new-token 意图不再是编号选项但仍可通过 Free-form fallback 表okx-dex触达轮次预算—— 新用户端到端 ≤ 3 轮回访用户选择工作流 登录 ≤ 2 轮免责声明位置—— 免责声明是每次渲染横幅的最后一段两种变体、两种登录态过期会话回退——wallet status返回loggedIn: true但wallet balance失败如 refresh token 过期或缺少地址/余额字段时流程提示重新登录路由到 Login Method Choice而不是渲染部分或虚构的登录横幅重新登录后渲染登录横幅。8. 与上游技能的边界与依赖欢迎横幅渲染只发生在 onboarding 流程中其他意图各有归属勿越界OKX.AI§2 → ai-guide.md不运行共享预检ai-guide.md通过onchainos wallet status自行做登录/身份检查该技能禁止调用onchainos agent create注册一律委托给okx-ai只读的wallet status与agent get-my-agents允许客服§3 → ai-support.md纯会话层无 CLI不运行预检钱包命令本体由 okx-agentic-wallet/SKILL.md 承载其全局安全规则同样约束横幅渲染凭证accessToken / refreshToken / apiKey / secretKey / passphrase 等绝不落日志或展示展示给用户的链上标识必须逐字符原样来自最近一次 CLI stdout交易时间戳为毫秒需转可读格式。从源码结构看欢迎横幅是整个 okx-guide 引导体系的「前端总闸」它把「新用户 → 登录 → 具体技能/工作流」压缩在 3 轮以内并将地理封锁、会话过期、登录放弃、下游加载失败等异常路径全部收敛到确定性的路由规则中是 Onchain OS 新手体验中事实上的状态机入口。关键文件索引均可在当前仓库中直接查看本文核心规范welcome.md技能入口与意图路由SKILL.md主流程Authoring Pattern / Status Check / Login Method Choice / Post-login routing / Free-form fallback / 验收标准how-to-play.md共享预检preflight.md登录门控目标OKX.AI 引导ai-guide.md、intro.md、unregistered-role-selection.md、registered-home.md下游技能okx-defiSKILL.md、okx-dapp-discoverySKILL.md、okx-agentic-walletSKILL.md赞分享【免费下载链接】internet-court-skillThe trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 payments, escrow, and dispute resolution as one open, catch-all Agent Skill / Claude Code plugin.项目地址https://gitcode.com/gh_mirrors/in/internet-court-skill点击查看免费下载相关推荐BepInEx 6.0.0版本架构深度解析与Unity游戏插件框架稳定性优化实践BepInEx 6.0.0版本架构深度解析与Unity游戏插件框架稳定性优化实践 BepInEx作为Unity游戏开发中广泛使用的插件框架和模组注入系统在6.Onchain OS 新手指南从空白提问到 DApp 工作流的「如何上手」入口路由实战Onchain OS 新手指南从空白提问到 DApp 工作流的「如何上手」入口路由实战 这是一篇围绕 okx guide 技能中 how to play.mdBazzite 桌面版 MOTD 欢迎横幅机制解析模板、环境变量与渲染管线Bazzite 桌面版 MOTD 欢迎横幅机制解析模板、环境变量与渲染管线 在 Bazzite 中每次打开终端/Shell 时都会看到一个带镜像标识、命令速操作系统上一篇AMD Phi-4量化模型兼容性指南PyTorch 2.11.0与ZenTorch集成方案下一篇突破无限增长困境Text-Generation-Inference服务队列优化实战指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考