AI4U Classroom 的量化交易学习子系统——一站式多因子研究 / 风险模型 / 自动驾驶 / 模拟盘。
⚠️ 本系统为模拟盘(不接真实券商),仅供学习研究,不构成投资建议。
- 📊 多因子研究 — v1 三支柱 / v2 八大类因子 + IC 动态定权 + 中性化
- 🎯 Barra 风险模型 — 行业 + 风格因子 + 协方差矩阵 + 组合优化
- 🤖 自动驾驶 — 策略池自动调仓,支持分级买卖 + Kelly 仓位 + ATR 止损
- 📡 盯盘 — 自选股分组、异动标记、消息面分析
- ⚔️ 回测验证 — v1 vs v2 模型对比,真实回测无未来函数
- 📱 移动端 — PWA + 移动 App(Android APK)
- 👥 多用户体系 — 受邀用户邀请码登录 + 数据隔离
- Node.js ≥ 18(推荐 20+)
- npm ≥ 9
git clone https://github.com/boriswzb/quant-v3.git
cd quant-v3
npm install
npm run dev打开 http://localhost:3000/quant
npm run build # 生产构建
npm run start # 启动生产服务
npm run lint # ESLint
npm run typecheck # TypeScript 类型检查| 路径 | 说明 |
|---|---|
/quant |
速览模式 — 一站式主页(推荐) |
/quant/factor-analysis-v2 |
因子研究 v2 专业版 |
/quant/downloads |
移动 App 下载中心 |
/admin/invite-users |
受邀用户管理(需 Admin 凭据) |
| 身份 | 标识 | 数据隔离 |
|---|---|---|
| 受邀用户 | username(如 boriswzb) |
跨设备稳定,所有数据按 username 隔离 |
| 游客 | 浏览器派发的 openmaic_guest_id cookie |
每个浏览器独立,互不串数据 |
| 管理员 | Basic Auth(/admin/invite-users) |
全局管理 |
- 打开
/quant - 顶部点「登录」
- 输入用户名 + 邀请码
- 登录后顶部显示「用户名 + 受邀用户」绿色标签
| 用户名 | 邀请码 |
|---|---|
boriswzb |
f123456 |
me |
5315 |
boris |
boris-new-2026 |
pl |
em2.0 |
配置文件:
invite-users.yml
URL:/admin/invite-users
凭据由部署者配置(见下「环境变量」一节)。源码里有占位 fallback,生产环境必须覆盖。
复制 .env.example 为 .env.local 并按需修改:
# ─── 管理员凭据(生产环境强烈建议覆盖) ───
# 不设置则使用源码里的默认值
ADMIN_USERNAME=boris
ADMIN_PASSWORD_HASH=<run: npx tsx scripts/hash-admin-password.ts "你的密码">
# ─── 站点访问码(可选) ───
# 设置后访问 /quant 需先输入访问码(HMAC-SHA256 签名 cookie)
# 留空则不启用
# ACCESS_CODE=your-access-code
# ─── 数据 API(可选) ───
# 受邀用户默认使用 invite-users.yml 里的 apiKey
# 留空则不传npx tsx scripts/hash-admin-password.ts "你的新密码"把输出的 hash 字符串填到 .env.local 的 ADMIN_PASSWORD_HASH。
quant-v3/
├── app/
│ ├── quant/ # 量化子系统页面
│ │ ├── page.tsx # 速览模式主页(8000+ 行核心代码)
│ │ ├── factor-analysis-v2/ # 因子研究专业版
│ │ ├── downloads/ # 移动 App 下载
│ │ ├── components/ # 速览模式内部组件
│ │ └── layout.tsx
│ ├── admin/
│ │ └── invite-users/ # 受邀用户管理页
│ └── api/
│ ├── quant/ # 量化私有数据 API
│ │ ├── simulator-state/ # 状态保存/导出/导入
│ │ ├── ai-chat/ # AI 聊天
│ │ ├── reports/ # 报告生成
│ │ └── market-status/ # 行情状态
│ ├── invite/ # 受邀用户登录 API
│ │ ├── verify/ # 验证邀请码
│ │ ├── status/ # 当前登录状态
│ │ └── logout/ # 登出
│ ├── admin/
│ │ └── invite-users/ # 管理 API (Basic Auth)
│ ├── simulator/ # 模拟交易 API
│ └── stock/ # 公开行情/因子/回测 API
├── components/
│ ├── user-mode-guard.tsx # 用户身份 Guard
│ ├── user-mode-modal.tsx # 登录弹窗
│ └── quant/
│ └── user-identity-badge.tsx # 顶部用户徽章
├── lib/
│ ├── quant/ # 核心量化逻辑
│ │ ├── simulator/ # 模拟交易引擎
│ │ ├── strategies/ # 策略(MACD/KDJ/MA/Composite/...)
│ │ ├── backtest/ # 回测引擎
│ │ ├── factor/ # 因子计算
│ │ ├── risk/ # 风险模型(Barra)
│ │ ├── store/ # Zustand + IndexedDB 状态
│ │ └── data/ # 数据源抽象
│ ├── server/
│ │ ├── invite-codes.ts # 邀请码/受邀用户配置
│ │ └── admin-auth.ts # 管理员鉴权(SHA-256 哈希)
│ └── hooks/
│ └── use-i18n.ts # 简化版 i18n
├── scripts/
│ └── hash-admin-password.ts # Admin 密码哈希生成器
├── invite-users.yml # 受邀用户配置
├── invite-codes.yml # 共享邀请码配置
├── middleware.ts # Edge middleware(派发游客 ID cookie)
└── data/
└── simulator-state/ # 服务端模拟状态 JSON 备份
所有用户数据严格按 userId 隔离:
- 受邀用户:
userId = username(跨设备稳定) - 游客:
userId = guest_<random 16-byte hex>(middleware 自动派发 cookie) - 服务端:通过
getServerUserId()(lib/server/invite-codes.ts)统一派生
存储层:
- 浏览器:IndexedDB(Dexie v2 schema,含
userId字段) - 服务端:
data/simulator-state/<userId>.json文件
不用明文密码。源码 / 配置只存 SHA-256 哈希:
源码 → lib/server/admin-auth.ts DEFAULT_ADMIN_PASSWORD_HASH
环境变量(优) → ADMIN_PASSWORD_HASH
登录流程 → Basic Auth → verifyAdminCredentials() → 哈希比对 + timingSafeEqual
仓库不存任何明文密码。如需轮换:
npx tsx scripts/hash-admin-password.ts "新密码"
# 把输出写到环境变量 ADMIN_PASSWORD_HASH登录成功服务端签发 HMAC 令牌(timestamp|username|apiKey|baseUrl|signature),浏览器存双 cookie:
openmaic_invite(HTTP-only,防 XSS)openmaic_user(JS 可读,前端用)
npm install
npm run dev # 默认 :3000next.config.ts 已配置 output: 'standalone'(本地部署)或 Vercel 自动处理。
npm run build
npm run startserver {
listen 443 ssl;
server_name your-domain.com;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}- 配置 Admin 凭据(环境变量 + 用
scripts/hash-admin-password.ts生成新 hash) - rotate 受邀用户的 API key(
invite-users.yml里的apiKey字段) - 启用 HTTPS(反代 + Let's Encrypt)
- 考虑加 rate-limit(如 nginx limit_req)
- 这是单服务器部署架构(服务端状态在本地 JSON 文件),不支持横向扩展
- 量化因子 / 回测计算在服务端 Node.js,CPU 密集
- 数据源:东方财富、新浪、腾讯(A 股),第三方接口稳定性不可控
学习用途,未开源。