AlphaPilot

金融 AI 工作流构建平台 — 基于 Claude Code 兼容运行时，提供量化分析、策略回测、研究报告与可视化看板能力。

技术栈

层	技术
前端	Next.js (App Router), React, TypeScript, TailwindCSS, Framer Motion, Recharts
后端	Next.js API Routes, Prisma ORM, PostgreSQL / TimescaleDB
桌面	Electron
数据服务	Python (FastAPI) — 东方财富实时行情 & A 股数据
AI 运行时	Claude Code / Claude Agent SDK
部署	Docker Compose (PostgreSQL, Redis, Grafana, Loki)

快速开始

前置条件

• Node.js ≥ 18
• Docker Desktop（数据库与基础设施）
• Python ≥ 3.11（市场数据服务）

安装与启动

# 1. 安装依赖
npm install

# 2. 启动基础设施（PostgreSQL, Redis, Grafana, Loki）
npm run db:up

# 3. 初始化数据库
npm run prisma:push

# 4. 复制环境变量
cp .env.example .env

# 5. 启动开发服务器
npm run dev

市场数据服务（可选）

cd services/market-data
pip install -e ".[dev]"
uvicorn alphapilot_market_data.api:app --port 8000

核心功能

功能	说明
AI 工作区生成	自然语言描述需求 → AI 自动生成全栈项目页面
量化分析	A 股实时行情、K 线、技术指标、财务指标、资金流向
策略回测	基于 TimescaleDB 历史数据，支持 MA 交叉等策略回测
研究看板	自动生成可视化看板：收益曲线、回撤、风险指标
多标对比	股票、ETF、指数的多维度对比与相对强度分析
公告事件	财报、分红、配股等事件驱动的异动分析
Eval 评估	量化 benchmark 运行与结果评估
Skills 治理	Claude Code Skills 的注册、版本与管理

项目结构

AlphaPilot/
├── src/                  # Next.js 前端 + API 路由
│   ├── app/              # App Router 页面
│   ├── components/       # UI 组件（Radix UI + Tailwind）
│   ├── lib/              # 核心逻辑（quant, services, skills）
│   ├── hooks/            # React Hooks
│   └── types/            # TypeScript 类型
├── services/
│   └── market-data/      # Python 市场数据后端（FastAPI）
├── sqls/                 # TimescaleDB 数据库迁移脚本
├── prisma/               # Prisma Schema + 迁移
├── deploy/               # Docker Compose + Grafana 配置
├── scripts/              # 开发者工具与 CI 脚本
├── benchmarks/           # 量化 benchmark 定义
├── electron/             # Electron 桌面壳
├── wiki/                 # 项目知识库（57 页文档）
└── .claude/              # Claude Code Skills 定义

数据库（TimescaleDB）

项目使用 TimescaleDB（PostgreSQL 扩展）存储历史 K 线数据，迁移脚本位于 sqls/：

脚本	内容
001	组件 bootstrap、超表创建
002	策略研究平台表结构
003	股票/ETF 标的池定义
004	K 线字段扩展（复权因子等）
005	日 K 上下文计算
006	行业/板块元数据
007	量化基础组件依赖

npm Scripts

命令	用途
npm run dev	启动 Next.js 开发服务器
npm run dev:desktop	启动 Electron 桌面开发模式
npm run build	构建生产版本
npm run build:desktop	构建桌面应用
npm run db:up	Docker Compose 启动数据库
npm run prisma:studio	打开 Prisma 数据浏览器
npm run lint	ESLint 检查
npm run type-check	TypeScript 类型检查
npm run doctor	项目健康检查

LLM 工具集成

AlphaPilot 深度集成 Claude Code 运行时，通过 .claude/skills/ 提供一系列领域技能：

• 量化数据 — 市场数据、财务指标、技术指标、公告事件
• 可视化看板 — 自动生成数据驱动的分析仪表盘
• 策略回测 — 单标的 MA 策略回测与报告
• 数据质量 — 自动化数据溯源与质量检查
• UI/UX 设计 — 平台页面生成与美化

启动后打开 AI 面板，AI 会自动选择合适 skills 响应需求。

配置

环境变量通过 .env 文件管理：

变量	说明	默认值
DATABASE_URL	PostgreSQL 连接串	postgresql://...
REDIS_URL	Redis 连接串	redis://localhost:6379
NEXT_PUBLIC_WS_URL	WebSocket 端点	ws://localhost:3000
MARKET_DATA_URL	Python 数据服务地址	http://localhost:8000

License

MIT