sorin-skill

预检依赖项（由 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/sorin-skill"
CACHE_MAX=3600
LOCAL_VER="1.0.1"
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/sorin-skill/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: sorin-skill v$LOCAL_VER -> v$REMOTE_VER."
  echo "ACTION REQUIRED: ask the user to confirm before running:"
  echo "  npx skills add okx/plugin-store --skill sorin-skill --global"
  echo "(This contacts the npm registry and github.com/okx/plugin-store and overwrites this skill. Do NOT auto-run.)"
fi

---

Sorin 技能

概述

Sorin 技能通过 Sahara 的 Sorin DeFi AI Services Gateway，帮助回答有关代币、资金池、链、协议和项目的加密货币相关问题。 它会识别用户意图，选择最相关的网关端点，并返回简明、有数据支持的分析，同时说明假设和风险。

网关

• 基础 URL：https://defi-tools-proxy.saharaa.info
• API 密钥环境变量：DEFI_TOOLS_API_KEY
• 认证标头：Authorization: Bearer ${DEFI_TOOLS_API_KEY}
• Accept 标头：accept: text/plain

默认请求模板：

GET https://defi-tools-proxy.saharaa.info/<path>?<query>
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

资金池分析示例：

GET https://defi-tools-proxy.saharaa.info/pool/analysis?chain=Ethereum
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

快速开始

1. 运行 sorin-skill quickstart。
2. 确认 Agent 运行环境中已设置 DEFI_TOOLS_API_KEY。
3. 使用资金池分析示例检查网关连通性。
4. 如果成功，确认 Sorin 技能已就绪，并建议用户提供代币、资金池、链、协议或项目分析提示词。
5. 如果失败，返回网关状态和准确的错误消息。

意图路由

1. 从自然语言中识别用户意图。
2. 优先选择且仅选择一个主 API（仅在需要时添加辅助 API）。
3. 验证必需的输入。若有缺失，只询问最少的补充问题。
4. 调用 API 并解析 success、data、error。

意图 -> API 映射

1）代币基本面／价格／持有者／技术指标

• API：tokenTool
• 使用场景：用户要求进行代币市场分析（宏观流动性 + 微观市场结构）。
• 输入：
  • token_symbol（必填）：代币符号，例如 BTC、ETH
  • quote_currency（可选，默认值为 USDT）：交易对的计价货币
• 请求：

GET https://defi-tools-proxy.saharaa.info/token/analysis?token_symbol=ETH&quote_currency=USDT
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

2）收益／质押资金池发现与评分

• API：poolTool
• 使用场景：用户询问质押去处、最佳 APY 资金池、资金池比较、TVL／APY 趋势。
• 输入（所有筛选条件均可选）：
  • chain（可选）：链 ID 字符串，例如 1、56
  • project（可选）：项目标识，例如 lido、aave-v3
  • protocol（例如 lido、aave-v3）
  • token_symbol（例如 ETH、USDC）
  • pool_id（可选）：唯一的资金池标识符
  • pool_category（可选）：资金池类别筛选条件
• 请求：

GET https://defi-tools-proxy.saharaa.info/pool/analysis?chain=Ethereum&protocol=lido&token_symbol=ETH
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

3）链级 DEX 和 TVL 格局

• API：chainTool
• 使用场景：用户询问链上 DEX 交易量趋势、TVL 变化、协议主导情况。
• 输入（可选，尽可能提供一项）：
  • chainId（整数）：链 ID，例如 1
  • chainName（字符串）：链名称，例如 Ethereum
• 请求：

GET https://defi-tools-proxy.saharaa.info/chain/analysis?chainName=Ethereum
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

4）协议级财务分析

• API：protocolTool
• 使用场景：用户询问协议 TVL／费用／收入／资金流和综合指标。
• 请求：

GET https://defi-tools-proxy.saharaa.info/protocol/analysis?protocol=aave
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

5）预测市场和项目展望

• API：projectTool
• 使用场景：用户询问项目概率、FDV 预期、短期／长期目标价或项目市场情绪。
• 输入：
  • projectName（必填）：项目名称，例如 berachain
• 请求：

GET https://defi-tools-proxy.saharaa.info/project/analysis?projectName=berachain
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

面向最终用户的输出风格

使用以下回复结构：

1. 查询内容：API 名称和关键参数。
2. 关键发现：用 3-5 条要点列出指标。
3. 解读：用通俗语言说明趋势／风险／机会。
4. 可执行的下一步：提出一个具体的后续步骤。
5. 置信度和注意事项：说明缺失字段、数据过时区间及低流动性的影响。

决策启发式

• 如果问题针对特定资产，请从 tokenTool 开始。
• 如果问题侧重收益，请从 poolTool 开始。
• 如果问题侧重链生态，请使用 chainTool。
• 如果问题侧重协议的财务健康状况，请使用 protocolTool。
• 如果问题侧重项目叙事或估值，请使用 projectTool。

安全规则

• 切勿编造价格、持有人数量、APY、TVL 或交易结果。
• 如果 API 返回失败，请明确说明具体原因，并建议一种重试方式。
• 仅在缺少必需参数时才提出后续问题。
• 存在歧义时，请明确指定链 ID。