flow-nexus-platform

Flow Nexus 平台管理

对 Flow Nexus 进行全面的平台管理，涵盖身份验证、沙盒执行、应用部署、积分管理和编程挑战。

目录

1. 身份验证与用户管理
2. 沙盒管理
3. 应用商店与部署
4. 付款与积分
5. 挑战与成就
6. 存储与实时功能
7. 系统实用工具

身份验证与用户管理

注册与登录

注册新账户

mcp__flow-nexus__user_register({
  email: "[email protected]",
  password: "secure_password",
  full_name: "Your Name",
  username: "unique_username" // optional
})

登录

mcp__flow-nexus__user_login({
  email: "[email protected]",
  password: "your_password"
})

检查身份验证状态

mcp__flow-nexus__auth_status({ detailed: true })

登出

mcp__flow-nexus__user_logout()

密码管理

请求重置密码

mcp__flow-nexus__user_reset_password({
  email: "[email protected]"
})

使用令牌更新密码

mcp__flow-nexus__user_update_password({
  token: "reset_token_from_email",
  new_password: "new_secure_password"
})

验证电子邮件

mcp__flow-nexus__user_verify_email({
  token: "verification_token_from_email"
})

个人资料管理

获取用户个人资料

mcp__flow-nexus__user_profile({
  user_id: "your_user_id"
})

更新个人资料

mcp__flow-nexus__user_update_profile({
  user_id: "your_user_id",
  updates: {
    full_name: "Updated Name",
    bio: "AI Developer and researcher",
    github_username: "yourusername",
    twitter_handle: "@yourhandle"
  }
})

获取用户统计信息

mcp__flow-nexus__user_stats({
  user_id: "your_user_id"
})

升级用户等级

mcp__flow-nexus__user_upgrade({
  user_id: "your_user_id",
  tier: "pro" // pro, enterprise
})

沙盒管理

创建和配置沙盒

创建沙盒

mcp__flow-nexus__sandbox_create({
  template: "node", // node, python, react, nextjs, vanilla, base, claude-code
  name: "my-sandbox",
  env_vars: {
    API_KEY: "your_api_key",
    NODE_ENV: "development",
    DATABASE_URL: "postgres://..."
  },
  install_packages: ["express", "cors", "dotenv"],
  startup_script: "npm run dev",
  timeout: 3600, // seconds
  metadata: {
    project: "my-project",
    environment: "staging"
  }
})

配置现有沙盒

mcp__flow-nexus__sandbox_configure({
  sandbox_id: "sandbox_id",
  env_vars: {
    NEW_VAR: "value"
  },
  install_packages: ["axios", "lodash"],
  run_commands: ["npm run migrate", "npm run seed"],
  anthropic_key: "sk-ant-..." // For Claude Code integration
})

执行代码

在沙盒中运行代码

mcp__flow-nexus__sandbox_execute({
  sandbox_id: "sandbox_id",
  code: `
    console.log('Hello from sandbox!');
    const result = await fetch('https://api.example.com/data');
    const data = await result.json();
    return data;
  `,
  language: "javascript",
  capture_output: true,
  timeout: 60, // seconds
  working_dir: "/app",
  env_vars: {
    TEMP_VAR: "override"
  }
})

管理沙盒

列出沙盒

mcp__flow-nexus__sandbox_list({
  status: "running" // running, stopped, all
})

获取沙盒状态

mcp__flow-nexus__sandbox_status({
  sandbox_id: "sandbox_id"
})

将文件上传到沙盒

mcp__flow-nexus__sandbox_upload({
  sandbox_id: "sandbox_id",
  file_path: "/app/config/database.json",
  content: JSON.stringify(databaseConfig, null, 2)
})

获取沙盒日志

mcp__flow-nexus__sandbox_logs({
  sandbox_id: "sandbox_id",
  lines: 100 // max 1000
})

停止沙盒

mcp__flow-nexus__sandbox_stop({
  sandbox_id: "sandbox_id"
})

删除沙盒

mcp__flow-nexus__sandbox_delete({
  sandbox_id: "sandbox_id"
})

沙盒模板

• node：包含 npm 的 Node.js 环境
• python：包含 pip 的 Python 3.x 环境
• react：React 开发环境
• nextjs：Next.js 全栈框架
• vanilla：基础 HTML/CSS/JS
• base：精简的 Linux 环境
• claude-code：集成 Claude Code 的环境

常见沙盒模式

API 开发沙盒

mcp__flow-nexus__sandbox_create({
  template: "node",
  name: "api-development",
  install_packages: [
    "express",
    "cors",
    "helmet",
    "dotenv",
    "jsonwebtoken",
    "bcrypt"
  ],
  env_vars: {
    PORT: "3000",
    NODE_ENV: "development"
  },
  startup_script: "npm run dev"
})

机器学习沙盒

mcp__flow-nexus__sandbox_create({
  template: "python",
  name: "ml-training",
  install_packages: [
    "numpy",
    "pandas",
    "scikit-learn",
    "matplotlib",
    "tensorflow"
  ],
  env_vars: {
    CUDA_VISIBLE_DEVICES: "0"
  }
})

全栈开发

mcp__flow-nexus__sandbox_create({
  template: "nextjs",
  name: "fullstack-app",
  install_packages: [
    "prisma",
    "@prisma/client",
    "next-auth",
    "zod"
  ],
  env_vars: {
    DATABASE_URL: "postgresql://...",
    NEXTAUTH_SECRET: "secret"
  }
})

应用商店与部署

浏览与搜索

搜索应用

mcp__flow-nexus__app_search({
  search: "authentication api",
  category: "backend",
  featured: true,
  limit: 20
})

获取应用详情

mcp__flow-nexus__app_get({
  app_id: "app_id"
})

列出模板

mcp__flow-nexus__app_store_list_templates({
  category: "web-api",
  tags: ["express", "jwt", "typescript"],
  limit: 20
})

获取模板详情

mcp__flow-nexus__template_get({
  template_name: "express-api-starter",
  template_id: "template_id" // alternative
})

列出所有可用模板

mcp__flow-nexus__template_list({
  category: "backend",
  template_type: "starter",
  featured: true,
  limit: 50
})

发布应用

将应用发布到商店

mcp__flow-nexus__app_store_publish_app({
  name: "JWT Authentication Service",
  description: "Production-ready JWT authentication microservice with refresh tokens",
  category: "backend",
  version: "1.0.0",
  source_code: sourceCodeString,
  tags: ["auth", "jwt", "express", "typescript", "security"],
  metadata: {
    author: "Your Name",
    license: "MIT",
    repository: "github.com/username/repo",
    homepage: "https://yourapp.com",
    documentation: "https://docs.yourapp.com"
  }
})

更新应用

mcp__flow-nexus__app_update({
  app_id: "app_id",
  updates: {
    version: "1.1.0",
    description: "Added OAuth2 support",
    tags: ["auth", "jwt", "oauth2", "express"],
    source_code: updatedSourceCode
  }
})

部署模板

部署模板

mcp__flow-nexus__template_deploy({
  template_name: "express-api-starter",
  deployment_name: "my-production-api",
  variables: {
    api_key: "your_api_key",
    database_url: "postgres://user:pass@host:5432/db",
    redis_url: "redis://localhost:6379"
  },
  env_vars: {
    NODE_ENV: "production",
    PORT: "8080",
    LOG_LEVEL: "info"
  }
})

分析与管理

获取应用分析数据

mcp__flow-nexus__app_analytics({
  app_id: "your_app_id",
  timeframe: "30d" // 24h, 7d, 30d, 90d
})

查看已安装的应用

mcp__flow-nexus__app_installed({
  user_id: "your_user_id"
})

获取市场统计信息

mcp__flow-nexus__market_data()

应用类别

• web-api：RESTful API 和微服务
• frontend：React、Vue、Angular 应用
• full-stack：完整的端到端应用
• cli-tools：命令行实用工具
• data-processing：ETL 工作流和分析
• ml-models：预训练机器学习模型
• blockchain：Web3 和区块链应用
• mobile：React Native 和移动应用

发布最佳实践

1. 文档：提供包含设置说明的完整 README
2. 示例：提供使用示例和示例配置
3. 测试：包含测试套件和 CI/CD 配置
4. 版本管理：使用语义化版本（MAJOR.MINOR.PATCH）
5. 许可证：添加明确的许可证信息（MIT、Apache 等）
6. 部署：包含 Docker/docker-compose 配置
7. 迁移：为版本更新提供升级指南
8. 安全性：说明安全注意事项和最佳实践

收益分成

• 他人部署你的模板时可赚取 rUv 积分
• 设置价格（免费为 0，或为高级模板设置积分价格）
• 通过分析数据跟踪使用情况和收益
• 提取积分，或用于 Flow Nexus 服务

付款与积分

余额与积分

检查积分余额

mcp__flow-nexus__check_balance()

检查 rUv 余额

mcp__flow-nexus__ruv_balance({
  user_id: "your_user_id"
})

查看交易记录

mcp__flow-nexus__ruv_history({
  user_id: "your_user_id",
  limit: 100
})

获取付款记录

mcp__flow-nexus__get_payment_history({
  limit: 50
})

购买积分

创建付款链接

mcp__flow-nexus__create_payment_link({
  amount: 50 // USD, minimum $10
})
// Returns secure Stripe payment URL

自动充值配置

启用自动充值

mcp__flow-nexus__configure_auto_refill({
  enabled: true,
  threshold: 100,  // Refill when credits drop below 100
  amount: 50       // Purchase $50 worth of credits
})

禁用自动充值

mcp__flow-nexus__configure_auto_refill({
  enabled: false
})

积分定价

服务费用：

• Swarm 操作：1-10 积分/小时
• 沙箱执行：0.5-5 积分/小时
• 神经网络训练：5-50 积分/作业
• 工作流运行：0.1-1 积分/次执行
• 存储：0.01 积分/GB/天
• API 调用：0.001-0.01 积分/次请求

获取积分

获取方式：

1. 完成挑战：每项挑战可获得 10-500 积分
2. 发布模板：其他人部署时即可获得积分（定价由你设定）
3. 推荐计划：邀请用户可获得奖励积分
4. 每日登录：每日可获得少量奖励（5-10 积分）
5. 成就：解锁里程碑奖励（50-1000 积分）
6. 应用商店销售：从付费模板中获得收益分成

通过程序获取积分

mcp__flow-nexus__app_store_earn_ruv({
  user_id: "your_user_id",
  amount: 100,
  reason: "Completed expert algorithm challenge",
  source: "challenge" // challenge, app_usage, referral, etc.
})

订阅层级

免费层级

• 每月 100 积分
• 基础沙箱访问权限（最多 2 个并发）
• Swarm Agent 数量有限（最多 3 个）
• 社区支持
• 1GB 存储空间

Pro 层级（$29/月）

• 每月 1000 积分
• 优先沙箱访问权限（最多 10 个并发）
• 无限 Swarm Agent
• 高级工作流
• 电子邮件支持
• 10GB 存储空间
• 提前体验新功能

企业层级（定制定价）

• 无限积分
• 专用计算资源
• 定制神经网络模型
• 99.9% SLA 保证
• 7×24 小时优先支持
• 无限存储空间
• 白标选项
• 本地部署

成本优化技巧

1. 使用较小的沙箱：选择合适的模板（基础版或全栈版）
2. 优化神经网络训练：调整超参数，减少训练轮数
3. 批量操作：将工作流执行分组进行
4. 清理资源：删除未使用的沙箱和存储空间
5. 监控用量：定期查看 user_stats
6. 使用免费模板：利用社区模板
7. 安排在非高峰时段：在低成本时段运行开销较大的作业

挑战与成就

浏览挑战

列出可用挑战

mcp__flow-nexus__challenges_list({
  difficulty: "intermediate", // beginner, intermediate, advanced, expert
  category: "algorithms",
  status: "active", // active, completed, locked
  limit: 20
})

获取挑战详情

mcp__flow-nexus__challenge_get({
  challenge_id: "two-sum-problem"
})

提交解决方案

提交挑战解决方案

mcp__flow-nexus__challenge_submit({
  challenge_id: "challenge_id",
  user_id: "your_user_id",
  solution_code: `
    function twoSum(nums, target) {
      const map = new Map();
      for (let i = 0; i < nums.length; i++) {
        const complement = target - nums[i];
        if (map.has(complement)) {
          return [map.get(complement), i];
        }
        map.set(nums[i], i);
      }
      return [];
    }
  `,
  language: "javascript",
  execution_time: 45 // milliseconds (optional)
})

将挑战标记为已完成

mcp__flow-nexus__app_store_complete_challenge({
  challenge_id: "challenge_id",
  user_id: "your_user_id",
  submission_data: {
    passed_tests: 10,
    total_tests: 10,
    execution_time: 45,
    memory_usage: 2048 // KB
  }
})

排行榜

全球排行榜

mcp__flow-nexus__leaderboard_get({
  type: "global", // global, weekly, monthly, challenge
  limit: 100
})

特定挑战排行榜

mcp__flow-nexus__leaderboard_get({
  type: "challenge",
  challenge_id: "specific_challenge_id",
  limit: 50
})

成就与徽章

列出用户成就

mcp__flow-nexus__achievements_list({
  user_id: "your_user_id",
  category: "speed_demon" // Optional filter
})

挑战类别

• algorithms：经典算法问题（排序、搜索、图）
• data-structures：数据结构实现（树、堆、字典树）
• system-design：架构与可扩展性挑战
• optimization：性能与效率问题
• security：以安全为重点的漏洞与修复
• ml-basics：机器学习基础知识
• distributed-systems：并发与分布式计算
• databases：查询优化与模式设计

挑战难度奖励

• 入门：10-25 积分
• 中级：50-100 积分
• 高级：150-300 积分
• 专家：400-500 积分
• 大师：600-1000 积分

成就类型

• 速度达人：在创纪录的时间内完成挑战
• 代码高尔夫：尽可能缩短代码
• 满分：测试通过率达到 100%
• 连胜大师：连续 N 天完成挑战
• 多语言高手：使用多种语言解题
• 调试者：修复有问题的代码挑战
• 优化大师：达到顶级性能基准

成功技巧

1. 从简单开始：先从入门挑战开始，建立信心
2. 查看解决方案：完成挑战后，学习优秀的解决方案
3. 优化：兼顾正确性与性能
4. 每日练习：完成每日挑战以获取奖励积分
5. 社区交流：参与讨论并向他人学习
6. 跟踪进度：关注成就和排行榜名次
7. 积极尝试：尝试多种解题方法

存储与实时功能

文件存储

上传文件

mcp__flow-nexus__storage_upload({
  bucket: "my-bucket", // public, private, shared, temp
  path: "data/users.json",
  content: JSON.stringify(userData, null, 2),
  content_type: "application/json"
})

列出文件

mcp__flow-nexus__storage_list({
  bucket: "my-bucket",
  path: "data/", // prefix filter
  limit: 100
})

获取公开 URL

mcp__flow-nexus__storage_get_url({
  bucket: "my-bucket",
  path: "data/report.pdf",
  expires_in: 3600 // seconds (default: 1 hour)
})

删除文件

mcp__flow-nexus__storage_delete({
  bucket: "my-bucket",
  path: "data/old-file.json"
})

存储桶

• public：可公开访问的文件（由 CDN 提供支持）
• private：通过身份验证，仅用户本人可访问
• shared：支持 ACL 的团队协作
• temp：24 小时后自动删除

实时订阅

订阅数据库更改

mcp__flow-nexus__realtime_subscribe({
  table: "tasks",
  event: "INSERT", // INSERT, UPDATE, DELETE, *
  filter: "status=eq.pending AND priority=eq.high"
})

列出活跃订阅

mcp__flow-nexus__realtime_list()

取消订阅

mcp__flow-nexus__realtime_unsubscribe({
  subscription_id: "subscription_id"
})

执行监控

订阅执行流

mcp__flow-nexus__execution_stream_subscribe({
  stream_type: "claude-flow-swarm", // claude-code, claude-flow-swarm, claude-flow-hive-mind, github-integration
  deployment_id: "deployment_id",
  sandbox_id: "sandbox_id" // alternative
})

获取流状态

mcp__flow-nexus__execution_stream_status({
  stream_id: "stream_id"
})

列出生成的文件

mcp__flow-nexus__execution_files_list({
  stream_id: "stream_id",
  created_by: "claude-flow", // claude-code, claude-flow, git-clone, user
  file_type: "javascript" // filter by extension
})

获取执行中的文件内容

mcp__flow-nexus__execution_file_get({
  file_id: "file_id",
  file_path: "/path/to/file.js" // alternative
})

系统工具

Seraphina 女王 AI 助手

向 Seraphina 寻求指导

mcp__flow-nexus__seraphina_chat({
  message: "How should I architect a distributed microservices system?",
  enable_tools: true, // Allow her to create swarms, deploy code, etc.
  conversation_history: [
    { role: "user", content: "I need help with system architecture" },
    { role: "assistant", content: "I can help you design that. What are your requirements?" }
  ]
})

Seraphina 女王是一款高级 AI 助手，具备以下能力：

• 精通分布式系统
• 能够创建集群并编排 Agent
• 代码部署与架构设计
• 支持保留上下文的多轮对话
• 使用工具提供实操帮助

系统运行状况与监控

检查系统运行状况

mcp__flow-nexus__system_health()

查看审计日志

mcp__flow-nexus__audit_log({
  user_id: "your_user_id", // optional filter
  limit: 100
})

身份验证管理

初始化身份验证

mcp__flow-nexus__auth_init({
  mode: "user" // user, service
})

快速入门指南

第 1 步：注册并登录

// Register
mcp__flow-nexus__user_register({
  email: "[email protected]",
  password: "SecurePass123!",
  full_name: "Developer Name"
})

// Login
mcp__flow-nexus__user_login({
  email: "[email protected]",
  password: "SecurePass123!"
})

// Check auth status
mcp__flow-nexus__auth_status({ detailed: true })

第 2 步：配置账单

// Check current balance
mcp__flow-nexus__check_balance()

// Add credits
const paymentLink = mcp__flow-nexus__create_payment_link({
  amount: 50 // $50
})

// Setup auto-refill
mcp__flow-nexus__configure_auto_refill({
  enabled: true,
  threshold: 100,
  amount: 50
})

第 3 步：创建你的第一个沙盒

// Create development sandbox
const sandbox = mcp__flow-nexus__sandbox_create({
  template: "node",
  name: "dev-environment",
  install_packages: ["express", "dotenv"],
  env_vars: {
    NODE_ENV: "development"
  }
})

// Execute code
mcp__flow-nexus__sandbox_execute({
  sandbox_id: sandbox.id,
  code: 'console.log("Hello Flow Nexus!")',
  language: "javascript"
})

第 4 步：部署应用

// Browse templates
mcp__flow-nexus__template_list({
  category: "backend",
  featured: true
})

// Deploy template
mcp__flow-nexus__template_deploy({
  template_name: "express-api-starter",
  deployment_name: "my-api",
  variables: {
    database_url: "postgres://..."
  }
})

第 5 步：完成挑战

// Find challenges
mcp__flow-nexus__challenges_list({
  difficulty: "beginner",
  category: "algorithms"
})

// Submit solution
mcp__flow-nexus__challenge_submit({
  challenge_id: "fizzbuzz",
  user_id: "your_id",
  solution_code: "...",
  language: "javascript"
})

最佳实践

安全

1. 切勿将 API 密钥硬编码在代码中，请使用环境变量
2. 在可用时启用 2FA
3. 定期轮换密码和令牌
4. 使用 private 存储桶存放敏感数据
5. 定期查看审计日志
6. 设置恰当的文件过期时间

性能

1. 清理未使用的沙盒以节省额度
2. 尽可能使用较小的沙盒模板
3. 删除旧文件以优化存储
4. 批量执行操作以减少 API 调用
5. 通过 user_stats 监控用量
6. 使用 temp 存储桶存放临时数据

开发

1. 部署前先在沙盒中进行测试
2. 为应用使用语义化版本
3. 详细记录所有模板
4. 在发布的应用中包含测试
5. 使用执行监控进行调试
6. 利用实时订阅获取实时更新

成本管理

1. 谨慎设置自动充值阈值
2. 定期监控额度使用情况
3. 完成每日挑战以赚取奖励额度
4. 发布模板以赚取被动额度
5. 酌情使用免费层资源
6. 在非高峰时段安排高负载任务

故障排查

身份验证问题

• 登录失败：检查邮箱和密码，并先验证邮箱
• 令牌已过期：重新登录以获取新令牌
• 权限被拒绝：检查套餐限制，必要时升级

沙盒问题

• 沙盒无法启动：检查模板兼容性并确认额度充足
• 执行超时：增加超时参数或优化代码
• 内存不足：使用更大的模板或优化内存用量
• 软件包安装失败：检查软件包名称，并确认 npm/pip 是否可用

付款问题

• 付款失败：检查付款方式和余额是否充足
• 额度未到账：请等待 5-10 分钟以完成处理
• 自动充值未生效：确认已保存付款方式

挑战问题

• 提交被拒绝：检查代码语法，确保所有测试均通过
• 答案错误：检查测试用例，并留意边界情况
• 性能过慢：优化算法复杂度

支持与资源

• 文档：https://docs.flow-nexus.ruv.io
• API 参考：https://api.flow-nexus.ruv.io/docs
• 状态页面：https://status.flow-nexus.ruv.io
• 社区论坛：https://community.flow-nexus.ruv.io
• GitHub 问题：https://github.com/ruvnet/flow-nexus/issues
• Discord：https://discord.gg/flow-nexus
• 电子邮件支持：[email protected]（仅限 Pro/Enterprise）

渐进式披露

mcp__flow-nexus__sandbox_create({
  template: "base",
  name: "custom-environment",
  startup_script: `
    apt-get update
    apt-get install -y custom-package
    git clone https://github.com/user/repo
    cd repo && npm install
  `
})

// Stage 1: Setup
mcp__flow-nexus__sandbox_execute({
  sandbox_id: "id",
  code: "npm install && npm run build"
})

// Stage 2: Run
mcp__flow-nexus__sandbox_execute({
  sandbox_id: "id",
  code: "npm start",
  working_dir: "/app/dist"
})

const chunkSize = 5 * 1024 * 1024 // 5MB chunks
for (let i = 0; i < chunks.length; i++) {
  await mcp__flow-nexus__storage_upload({
    bucket: "private",
    path: `large-file.bin.part${i}`,
    content: chunks[i]
  })
}

// Upload to temp for processing
mcp__flow-nexus__storage_upload({
  bucket: "temp",
  path: "processing/data.json",
  content: data
})

// Move to permanent storage after processing
mcp__flow-nexus__storage_upload({
  bucket: "private",
  path: "archive/processed-data.json",
  content: processedData
})

const tables = ["users", "tasks", "notifications"]
tables.forEach(table => {
  mcp__flow-nexus__realtime_subscribe({
    table,
    event: "*",
    filter: `user_id=eq.${userId}`
  })
})

// Subscribe to task completion
mcp__flow-nexus__realtime_subscribe({
  table: "tasks",
  event: "UPDATE",
  filter: "status=eq.completed"
})

// Trigger notification workflow on event
// (handled by your application logic)

版本历史

• v1.0.0 (2025-10-19)：初始版综合平台技能
  • 身份验证与用户管理
  • 沙盒创建与执行
  • 应用商店与部署
  • 支付与积分
  • 挑战与成就
  • 存储与实时功能
  • 系统实用工具与 Queen Seraphina 集成

此技能将 6 个 Flow Nexus 命令模块整合为一个全面的平台管理界面。