Skip to content

About

for token factory

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

AI4U Quant Trading System v3.0

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) 全局管理

登录受邀用户

  1. 打开 /quant
  2. 顶部点「登录」
  3. 输入用户名 + 邀请码
  4. 登录后顶部显示「用户名 + 受邀用户」绿色标签

当前受邀用户(默认配置)

用户名 邀请码
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
# 留空则不传

生成新 Admin 密码

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 文件

Admin 鉴权

不用明文密码。源码 / 配置只存 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

受邀用户 Token

登录成功服务端签发 HMAC 令牌(timestamp|username|apiKey|baseUrl|signature),浏览器存双 cookie:

  • openmaic_invite(HTTP-only,防 XSS)
  • openmaic_user(JS 可读,前端用)

部署

开发环境

npm install
npm run dev    # 默认 :3000

生产环境(standalone 模式)

next.config.ts 已配置 output: 'standalone'(本地部署)或 Vercel 自动处理。

npm run build
npm run start

反向代理(Nginx 示例)

server {
  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;
  }
}

安全提示

⚠️ 部署到生产前请务必:

  1. 配置 Admin 凭据(环境变量 + 用 scripts/hash-admin-password.ts 生成新 hash)
  2. rotate 受邀用户的 API key(invite-users.yml 里的 apiKey 字段)
  3. 启用 HTTPS(反代 + Let's Encrypt)
  4. 考虑加 rate-limit(如 nginx limit_req)

已知限制

  • 这是单服务器部署架构(服务端状态在本地 JSON 文件),不支持横向扩展
  • 量化因子 / 回测计算在服务端 Node.js,CPU 密集
  • 数据源:东方财富、新浪、腾讯(A 股),第三方接口稳定性不可控

许可证

学习用途,未开源。

About

for token factory

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages