cloud-payments

用途

Cloud Payments 用于在 Flow Nexus 生态系统中管理 rUv 积分、计费和财务操作。它面向需要查询余额、购买积分、配置自动充值、追踪交易记录、管理订阅套餐以及了解成本优化策略的用户。

主要能力

该技能通过 MCP 工具提供以下能力：

余额检查：快速查询当前积分余额、自动充值状态、阈值和套餐等级；也可按用户 ID 查询详细余额，包括待处理积分、累计获得和累计支出。
积分购买：创建支付链接，金额以美元计，最低 $10，最高 $10,000，返回支付 URL、过期时间和对应积分数额。
自动充值配置：启用或禁用自动充值，设置触发阈值和充值金额，返回启用状态、阈值、金额和下次扣费时间。
交易历史：查询 rUv 积分交易记录（最多 100 条），以及支付历史（最多 100 条），包含日期、金额、类型、描述、状态和发票链接。
套餐管理：将用户升级到 Pro 或 Enterprise 套餐，返回新套餐、每月积分和生效日期。
积分获取：为应用创作者、挑战完成等场景发放积分，支持 challenge、app_usage、referral 等来源。
使用统计：查询用户累计获得积分、累计支出积分、已发布应用数和已完成挑战数。

使用方式

使用前需要具备 Flow Nexus 账户和有效会话、用于购买积分的支付方式，并完成用户认证。

典型调用示例：

// 检查当前余额
const balance = await mcp__flow-nexus__check_balance();
console.log(`Credits: ${balance.credits}, Auto-refill: ${balance.auto_refill}`);

// 购买积分
const paymentLink = await mcp__flow-nexus__create_payment_link({
  amount: 50  // USD minimum $10
});

// 配置自动充值
await mcp__flow-nexus__configure_auto_refill({
  enabled: true,
  threshold: 100,
  amount: 50
});

// 查看交易历史
const history = await mcp__flow-nexus__ruv_history({
  user_id: "user_id",
  limit: 20
});

适用场景

在执行操作前检查当前积分余额
为平台使用购买积分
设置自动积分充值以避免服务中断
追踪支出和交易历史
管理订阅套餐
了解成本优化策略
追踪已发布应用的收入

核心概念

rUv 积分是平台货币，用于沙箱执行时间、神经网络训练、智能体部署、模板部署和 API 调用。

定价套餐：

套餐	每月积分	价格	功能
Free	100	$0	基础功能、社区支持
Pro	1,000	$29/月	优先访问、邮件支持
Enterprise	无限	定制	专用资源、SLA

积分获取机会：

活动	积分
挑战完成（初级）	10-50
挑战完成（高级）	100-500
模板发布（每次使用）	收入分成
推荐	奖励积分
每日参与	小额奖励
成就	里程碑奖励

限制

购买积分最低 $10，最高 $10,000。
交易历史和支付历史查询最多返回 100 条。
需要有效的 Flow Nexus 账户、会话和支付方式。
套餐升级前需完成支付。
自动充值失败通常由支付方式过期引起，需更新支付方式。
余额不足时需添加积分或启用自动充值。

最佳实践

在执行重型操作前检查余额。
启用自动充值以防止服务中断。
合理配置沙箱资源，避免过度分配。
批量执行相关任务以减少开销。
复用现有模板。
及时删除未使用的沙箱。

成本优化策略

策略	节省	投入
合理配置沙箱	20-40%	低
批量操作	10-20%	中
模板复用	30-50%	低
非高峰调度	5-15%	低
资源清理	15-30%	低
套餐优化	不定	中

错误处理

错误	原因	解决方案
insufficient_credits	余额过低	添加积分或启用自动充值
payment_failed	支付方式问题	更新支付方式
invalid_amount	金额低于最低值	使用 $10 最低金额
auto_refill_failed	支付方式过期	更新支付方式
tier_upgrade_failed	需要支付	先完成支付

集成点

与 Challenges 集成：完成挑战后可通过 app_store_earn_ruv 发放积分。
与 App Store 集成：通过 user_stats 查询已发布应用的收入。

技能介绍

用途