trade-agent

核心功能

AIUSD Skill 是一款面向加密资产管理的 MCP（Model Context Protocol）技能，允许 AI Agent 直接调用 AIUSD 后端服务完成链上操作。主要功能包括：

• 余额查询：实时查看 AIUSD 托管账户与质押账户的资产
• 交易执行：通过意图执行（intent）完成 buy/sell/swap 操作
• 质押管理：AIUSD 的质押与解质押（sAIUSD 收益）
• 资金流转：提现至外部钱包、Gas 充值保障交易执行
• 历史追踪：交易记录与状态查询
• 账户充值：引导用户通过 USDC 直充或官网完成资金入账

显著优点

1. 一站式链上操作：无需用户手动切换钱包或浏览器，Agent 可直接完成从查询到执行的全流程
2. 意图驱动交易：genalpha_execute_intent 支持自然语言交易描述（如 "buy SOL with USDC"），降低操作门槛
3. 自动认证修复：内置 401/session 过期自动重认证机制，减少人工干预
4. 动态工具发现：强制要求先执行 tools --detailed 获取实时 schema，确保参数格式与工具可用性始终最新
5. 多链支持：通过 genalpha_get_trading_accounts 管理多链地址

潜在局限与风险

| 局限 | 说明 |

|------|------|

| 认证依赖外部 OAuth | 需通过 mcporter 或环境变量配置 token，流程涉及浏览器交互 |

| 仅支持特定稳定币直充 | 直接充值仅限 USDC，其他稳定币需跳转官网 |

| 交易失败需人工兜底 | 链上交易失败时引导至官网手动操作，无法自动重试 |

| 实时性依赖后端 | 价格、Gas、交易状态均依赖 AIUSD 后端服务可用性 |

| 文档示例可能过时 | 虽强制要求 live schema，但新手开发者可能误用静态示例 |

适合人群

• DeFi 活跃用户：需要高频查询余额、执行交易、管理质押
• AI Agent 开发者：希望为机器人集成加密资产管理能力
• 多链交易者：需要统一管理多链地址与 Gas

常规风险

• 私钥与 Token 安全：~/.mcp-hub/token.json 与 mcporter 缓存需妥善保管，避免泄露
• 交易确认风险：链上交易不可逆，Agent 执行前需用户明确确认金额与币种
• 钓鱼网站风险：文档明确禁止在认证响应中包含 URL，防止伪造登录页面
• Gas 不足导致失败：需定期执行 genalpha_ensure_gas 保障交易执行

核心用法

aiusd-skill 是一个通过 MCP（Model Context Protocol）协议与 AIUSD 官方后端交互的交易管理技能。用户可通过自然语言指令完成加密货币账户管理，包括查询余额、执行买卖交易、质押 AIUSD 获取收益、提现至外部钱包、Gas 充值以及查看交易历史等操作。

使用前必须完成 OAuth 认证，系统按优先级读取 MCP_HUB_TOKEN 环境变量、mcporter OAuth 或本地 ~/.mcp-hub/token.json 文件。所有工具调用前需先执行 aiusd-skill tools --detailed 获取实时 schema，确保参数格式正确。

显著优点

1. 自然语言交互：用户无需记忆复杂命令，直接说"买 100 USDC 的 SOL"或"查看我的质押收益"即可完成操作。

2. 功能覆盖全面：集交易执行、账户管理、质押理财、Gas 管理于一体，减少多平台切换成本。

3. 认证机制灵活：支持环境变量、OAuth 和本地令牌三种认证方式，适应不同使用场景。

4. 实时工具发现：通过 tools --detailed 动态获取最新可用工具，避免因接口变更导致调用失败。

5. 错误自动修复：遇到 401 认证错误时自动触发重认证流程，提升使用连续性。

潜在缺点与局限性

1. 来源可信度有限：由个人开发者（T3 级别）维护，非官方团队直接背书，代码审计依赖社区力量。

2. 金融操作风险：直接涉及真实资金转移，虽需用户确认，但误操作或恶意指令可能导致资产损失。

3. 依赖外部服务稳定性：后端服务（aiusd.ai、mcp.alpha.dev）的可用性直接影响技能功能。

4. 安装脚本风险：升级时会删除旧目录，未备份可能导致配置丢失。

5. 权限要求较高：需访问本地认证文件和环境变量，存在凭证泄露的潜在风险面。

适合的目标群体

• DeFi 活跃用户：频繁进行链上交易、质押、跨链操作的用户，可显著提升操作效率。
• AIUSD 生态用户：已持有或使用 AIUSD、sAIUSD 等资产的用户。
• 技术接受度较高的投资者：理解加密货币钱包、Gas、质押等概念，能接受非官方工具的风险。
• 多账户管理者：需要快速切换或管理多个交易账户的用户。

使用风险

1. 资金安全风险：交易类操作不可逆，建议首次使用先小额测试，仔细核对每笔交易的金额、币种和目标地址。

2. 认证凭证泄露：token 文件权限建议设置为 600，避免多用户系统下被他人读取。

3. 网络钓鱼风险：仅从官方渠道（ClawHub、GitHub Releases）下载，验证文件哈希值，警惕假冒安装包。

4. 服务中断风险：建议定期备份重要配置，关注官方公告，避免在关键交易时遇到服务维护。

5. 合规风险：加密货币交易在部分地区受限，用户需自行确认当地法规合规性。