Riverbit AI 智能交易终端

AI 驱动的加密货币交易平台 - 无代码智能交易终端

---

项目简介

Riverbit AI 是一个创新的 AI 驱动交易平台，通过对话式界面让任何人都能创建、测试和部署专业级别的加密货币交易策略。

核心特性

• AI 对话式交互：自然语言对话，智能市场分析与交易建议
• 多交易所支持：Hyperliquid、币安等主流交易所统一接口
• 智能风险管理：内置止损、仓位计算、爆仓价格预警
• 实时回测：基于历史数据验证策略有效性
• Paper Trading：模拟交易环境，无风险测试策略
• A2UI 卡片系统：结构化 AI 响应，支持交互式操作

---

架构概览

Riverbit AI 采用 BaseAgent + Skills 统一架构，基于 LangGraph 构建：

┌─────────────────────────────────────────────────────────────┐
│                     Riverbit AI 后端                         │
├─────────────────────────────────────────────────────────────┤
│  ┌───────────────┐   ┌───────────────┐   ┌───────────────┐  │
│  │  BaseAgent    │──▶│   BaseSkill   │◀──│ SkillRegistry │  │
│  │  (抽象基类)   │   │   (抽象基类)  │   │  (注册管理)   │  │
│  └───────────────┘   └───────────────┘   └───────────────┘  │
│         │                   │                               │
│         ▼                   ▼                               │
│  ┌───────────────┐   ┌─────────────────────────────────┐   │
│  │  MarketAgent  │──▶│ MarketSkill │ RiskSkill │ Card  │   │
│  └───────────────┘   └─────────────────────────────────┘   │
├─────────────────────────────────────────────────────────────┤
│  FastAPI + SSE 流式响应  │  PostgreSQL + Redis              │
└─────────────────────────────────────────────────────────────┘

---

技术栈

层级	技术	版本
前端	Next.js + React + TypeScript	15.x / 19.x
UI	TailwindCSS + Shadcn/ui	4.x
状态	Zustand + SSE Client	5.x
后端 (Python)	FastAPI + LangGraph	0.115.x / 0.3.x
后端 (Node.js)	Fastify	5.2.x
LLM	LangChain + OpenRouter	1.2.x
交易	Hyperliquid SDK + CCXT	-
数据库	PostgreSQL + Redis	15+ / 7+

---

项目结构

riverbit-ai/
├── frontend/                    # 前端应用
│   └── web-app/                # Next.js 15 Web 应用
│       ├── src/
│       │   ├── app/            # App Router 页面
│       │   ├── components/     # React 组件
│       │   ├── hooks/          # 自定义 Hooks
│       │   ├── lib/            # 工具库
│       │   ├── store/          # Zustand 状态
│       │   └── types/          # TypeScript 类型
│       └── package.json
│
├── app/                        # Python AI 后端 (FastAPI)
│   ├── agent_core/             # Agent 核心框架
│   │   ├── base.py            # BaseAgent 抽象基类
│   │   ├── llm.py             # LLM 客户端配置
│   │   ├── session.py         # 会话管理
│   │   └── streaming.py       # SSE 流式处理
│   ├── agents/                 # Agent 实现
│   │   └── market/            # 市场分析 Agent
│   ├── skills/                 # Skills 系统
│   │   ├── market/            # 市场数据 Skill
│   │   ├── risk/              # 风险计算 Skill
│   │   └── card/              # A2UI 卡片 Skill
│   ├── api/                    # API 路由
│   ├── backtest/               # 回测引擎
│   └── main.py                 # FastAPI 入口
│
├── backend/                    # Node.js 后端服务
│   ├── api-gateway/           # API 网关 (Fastify 5)
│   ├── auth-service/          # 认证服务
│   ├── user-service/          # 用户管理
│   └── strategy-service/      # 策略管理
│
├── shared/                     # 共享模块
│   ├── common-types/          # 类型定义
│   ├── utils/                 # 工具函数
│   └── config/                # 配置管理
│
├── docs/                       # 项目文档
│   └── architecture/          # 架构文档
│
├── CLAUDE.md                   # AI 开发指引
├── Makefile                    # Python 后端命令
├── pyproject.toml              # Python 依赖配置
├── package.json                # Node.js 根配置
└── docker-compose.yml          # Docker 编排

---

快速开始

前置要求

# Node.js 环境
node >= 18.x
pnpm >= 8.x

# Python 环境
python >= 3.13
uv >= 0.5.0  # 推荐的 Python 包管理器

# 数据库
PostgreSQL >= 15
Redis >= 7.0

1. 前端启动

# 安装依赖
cd frontend/web-app
pnpm install

# 配置环境变量
echo "NEXT_PUBLIC_RIVERBIT_URL=http://localhost:8000" > .env.local

# 启动开发服务器
pnpm dev

# 访问应用
open http://localhost:3000

2. Python 后端启动 (Riverbit AI)

# 安装 Python 依赖
cd /path/to/riverbit-ai
uv sync

# 配置环境变量
cp .env.example .env
# 编辑 .env 填入：
# - OPENROUTER_API_KEY
# - DATABASE_URL
# - REDIS_URL

# 启动后端服务
make dev
# 或
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# 访问 API 文档
open http://localhost:8000/docs

3. Node.js 后端服务 (可选)

# 安装依赖
pnpm install

# 启动所有服务
pnpm dev

---

页面路由

路径	功能	描述
/	首页	快捷入口 & 市场概览
/chat	AI 对话	与 AI 交互获取市场分析
/strategies	策略管理	创建和管理交易策略
/paper-trading	模拟交易	无风险测试交易策略
/backtest	回测	历史数据策略验证
/settings	设置	用户偏好设置

---

API 端点

AI Agent API

端点	方法	描述
/api/v1/agent/chat	POST	AI 对话（SSE 流式响应）
/api/v1/agent/insight	POST	市场洞察分析

市场数据 API

端点	方法	描述
/api/v1/market/analysis	GET	获取市场分析
/api/v1/market/orderbook	GET	获取订单簿

回测 API

端点	方法	描述
/api/v1/backtest/run	POST	执行回测
/api/v1/backtest/results	GET	获取回测结果

---

开发命令

前端

cd frontend/web-app

pnpm dev          # 启动开发服务器
pnpm build        # 构建生产版本
pnpm lint         # 代码检查
pnpm type-check   # TypeScript 类型检查

Python 后端

make dev          # 启动开发服务器
make test         # 运行测试
make lint         # 代码检查 (Ruff)
make format       # 代码格式化 (Black)

全局

pnpm dev          # 启动所有服务 (Turbo)
pnpm build        # 构建所有模块
pnpm test         # 运行所有测试
pnpm format       # 格式化代码

---

环境变量

前端 (.env.local)

NEXT_PUBLIC_RIVERBIT_URL=http://localhost:8000
NEXT_PUBLIC_APP_ENV=development

Python 后端 (.env)

# LLM 配置
OPENROUTER_API_KEY=your_api_key
DEFAULT_MODEL=qwen/qwen3-max

# 数据库
DATABASE_URL=postgresql://user:pass@localhost:5432/riverbit
REDIS_URL=redis://localhost:6379/0

# 交易所
HYPERLIQUID_WALLET_ADDRESS=your_wallet
HYPERLIQUID_PRIVATE_KEY=your_key

# 安全
JWT_SECRET=your_jwt_secret

---

贡献指南

提交规范

遵循 Conventional Commits：

feat: 新功能
fix: 修复 bug
docs: 文档更新
style: 代码格式调整
refactor: 重构
test: 测试相关
chore: 构建/工具链更新

开发流程

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'feat: add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建 Pull Request

---

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

---

相关链接

• API 文档：http://localhost:8000/docs (Swagger UI)
• ReDoc：http://localhost:8000/redoc
• 开发指南：CLAUDE.md

---

免责声明：加密货币交易有风险，投资需谨慎。Riverbit AI 仅提供工具和分析，不构成投资建议。

---

最后更新：2026-01-12 维护者：Riverbit Development Team