Aiusd Skills

核心功能

AIUSD Skill 是一套面向 AIUSD 生态系统的 MCP（Model Context Protocol）技能，专为加密货币交易与资产管理场景设计。核心能力覆盖六大模块：

1. 账户资产管理

• genalpha_get_balances：实时查询 AIUSD 托管账户与质押账户余额
• genalpha_get_trading_accounts：获取多链交易地址（支持 Solana、Ethereum 等）

2. 交易执行

• genalpha_execute_intent：支持自然语言意图交易（如"用 USDC 买入 SOL"），底层解析为链上交易
• 交易模板动态加载，参数格式以实时 tools --detailed 输出为准

3. 质押理财

• genalpha_stake_aiusd / genalpha_unstake_aiusd：AIUSD 质押与赎回，生成收益型 sAIUSD

4. 资金出入金

• genalpha_withdraw_to_wallet：提现至外部钱包地址
• 充值入口：支持直接 USDC 存款或官网 https://aiusd.ai 全币种通道

5. Gas 管理

• genalpha_ensure_gas：自动为指定链的交易账户补充原生 Gas 代币

6. 认证与故障恢复

• 三重认证层级：环境变量 MCP_HUB_TOKEN → mcporter OAuth → 本地 token 文件
• 自动 401 修复：检测到认证失效时自动执行 npm run reauth

显著优势

• 意图驱动交易：用户可用自然语言描述交易需求，无需理解底层参数结构
• 动态模式发现：强制先执行 tools --detailed，确保工具定义始终最新，避免硬编码失效
• 多链原生支持：内置跨链账户管理与 Gas 抽象，降低用户链切换认知负担
• 认证自愈机制：自动检测并修复认证过期，减少人工介入

局限性与风险

• 依赖中心化后端：所有交易通过 AIUSD 托管后端路由，存在对手方风险与潜在审查点
• 实时模式风险：若 tools --detailed 返回异常或网络中断，技能将无法正常解析用户意图
• 资产托管性质：资金存放于 AIUSD 托管合约，非用户自托管，需信任项目方安全能力
• 文档滞后性：示例参数可能过时，实际调用必须以实时模式为准
• 交易失败兜底：复杂交易失败时需引导至官网手动操作，自动化率非 100%

适合人群

• 已熟悉 AIUSD 生态、追求效率的活跃交易者
• 需要批量查询多链余额与交易历史的资管用户
• 愿意接受托管模式以换取 Gas 抽象与意图交易便利性的 DeFi 用户
• 不适合：坚持完全自托管、反对 KYC/托管架构的极端去中心化主义者

常规风险

• 智能合约风险：托管合约与质押合约存在潜在漏洞可能
• 后端单点故障：MCP 服务端不可用将导致全部功能瘫痪
• OAuth 会话劫持：本地 token 文件若权限配置不当存在泄露风险
• 误操作风险：意图解析错误可能导致非预期交易，建议大额交易前官网二次确认

核心用法

AIUSD Skill 是一款面向加密货币交易场景的 Agent 工具，通过 MCP（Model Context Protocol）协议与后端服务通信，实现账户管理与链上操作。用户可通过自然语言指令完成余额查询、交易执行、质押/解质押、Gas 充值、资金提现等操作。

使用前必须执行 aiusd-skill tools --detailed 获取实时工具列表和参数格式，避免因接口变更导致调用失败。认证采用三级降级机制：优先读取 MCP_HUB_TOKEN 环境变量，其次尝试 mcporter OAuth，最后回落到本地 token 文件。

显著优点

1. 自然语言交互：用户可直接用口语化指令如"买 100 USDC 的 SOL"或"查看我的质押收益"完成复杂链上操作，降低 DeFi 使用门槛。

2. 全功能覆盖：集成账户管理（余额、地址、交易历史）、交易执行（买卖兑换）、收益质押（sAIUSD）、资金流转（充值提现、Gas 管理）等完整链路。

3. 智能错误恢复：内置 401 认证过期自动修复机制，Claude 可自动触发 npm run reauth 重新登录，无需用户手动处理。

4. 安全设计：纯 Markdown 文档型 Skill，无可执行代码，敏感操作依赖外部 MCP 服务，本身不存储私钥或发起直接网络请求。

潜在缺点与局限性

1. 来源可信度限制：T3 级个人开发者维护，无官方组织背书，长期更新稳定性存疑。

2. 实时性依赖：工具参数和接口可能频繁变更，必须每次使用前获取最新 schema，增加交互步骤。

3. 资金安全边界：Skill 仅作指令中转，实际交易由第三方服务执行，故障时需引导用户至官网手动操作，体验不连贯。

4. 认证复杂度：三级认证逻辑增加了配置门槛，环境变量、OAuth、本地文件多种方式并存易引发混淆。

适合的目标群体

• DeFi 进阶用户：已熟悉钱包操作，希望通过自然语言快速执行多步骤交易的用户。
• 高频交易者：需要频繁查询余额、监控仓位、执行套利策略的短线投资者。
• 多链资产管理人：持有 AIUSD 及相关稳定币，需统一查看跨链账户状态的用户。

使用风险

• 资金风险：加密货币交易不可逆，Skill 本身无交易预览或二次确认机制，误操作可能导致资产损失。
• 认证泄露风险：本地 token 文件若权限设置不当，可能被其他程序读取；建议优先使用环境变量方式。
• 服务依赖风险：MCP 后端或官网服务中断时，核心功能将不可用；重要操作应保留官网手动备份方案。
• 接口变更风险：实时 schema 机制虽灵活，但若文档与实现不一致，可能产生非预期交易行为。