🚀 NexusQuant

一核驱动，全域资产。现代多资产宏观量化引擎。

专为 Quant 和 Hacker 打造的极速、本地优先的量化投研与执行技术栈。

🇨🇳 简体中文 | 🇺🇸 English

NexusQuant 是一款从零开始专为多资产组合策略设计的下一代量化引擎。我们抛弃了臃肿的传统架构和碎片化的数据库，选择了极致性能的终极技术栈：Bun + uv + Rust + Parquet。

无论你是交易 A 股、美股七姐妹、加密货币、外汇还是大宗商品，NexusQuant 都能将碎片化的市场数据对齐为统一的 UTC 事件流，并通过内存安全的 Rust 核心在毫秒间处理数百万个 Tick 数据。

💡 核心理念："底层统一，边缘隔离"

• 标准化（现代数据湖）： 零重型数据库负担。我们使用 Dagster 编排软件定义资产（SDA），利用 Polars 摄取并清洗异构数据（Tushare、Polygon、CCXT）。所有数据最终落盘为分区的 Parquet 文件，通过 DuckDB 实现瞬间查询。
• 极速运转（WASM 引擎）： 核心的事件驱动回测与撮合引擎由 Rust 编写并编译为 WASM。它以零延迟的开销处理复杂的时区对齐、优先队列事件推送以及多币种保证金清算。
• 敏捷灵活（Bun + Elysia）： API 网关与系统胶水层运行在 Bun + Elysia 之上，提供最严格的端到端类型安全，以及处理 WebSocket 数据流和系统路由的最快运行速度。
• AI 原生（支持 MCP）： 专为 Agentic（智能体）工作流设计。通过标准的模型上下文协议（MCP）服务器，将你的多资产本地数据湖暴露给 LLM，赋能大模型的宏观逻辑推理（ReAct 循环）。

🏗️ 架构概览

nexus-quant/
├── ⚙️ nexus-edge/         # 网关层：Bun + Elysia + TypeScript
│   ├── api/               # 极速 REST & WebSocket 接口
│   └── mcp_server/        # AI 上下文协议，用于智能体推理
├── 🐍 nexus-stream/       # 数据流水线：Dagster + uv + Polars
│   ├── pyproject.toml     # 极速依赖管理
│   ├── ingestions/        # 市场适配器（A股, 美股ETF, 加密货币, 外汇）
│   └── assets.py          # 软件定义资产 (SDA) 声明
├── 🦀 nexus-core/         # 核心引擎：Rust + WASM
│   ├── Cargo.toml
│   └── src/               # 事件循环、优先队列、撮合引擎与账本
├── 🗂️ storage/            # 本地数据湖
│   ├── parquet/           # 按 /资产类别/年份/月份/ 分区存储
│   └── duckdb/            # 内存级分析聚合
├── 📄 config.yaml         # 配置中心：统管全局设置的单一文件
└── 🚀 package.json        # 项目入口

🔥 核心杀手锏

1. 统一的事件驱动核心

摒弃传统的“按天循环”模式。NexusQuant 使用绝对的 UTC 优先队列。加密货币的 7x24 小时数据流与美股交易时段、外汇周末休市完美交织。你的策略将完全还原市场真实的发生顺序。

2. 全局多币种账本

专为跨资产宏观交易打造。原生支持基础计价货币（如 USD）汇率转换、初始/维持保证金计算，以及跨资产组合净值的实时追踪。在同一个统一的回测中，轻松实现用黄金或加密货币对冲你的股票多头敞口。

3. 本地 Parquet 革命

无需配置 ClickHouse，直接在 MacBook 上查询 TB 级的历史数据。Dagster 的数据血缘追踪、Polars 的向量化清洗，加上 DuckDB 对 Parquet 文件的谓词下推，让数据处理变得瞬间响应。

4. 零延迟 WASM UI

通过将 Rust 引擎编译为 WebAssembly，NexusQuant 可以直接在浏览器内存中运行复杂的回测，为你提供用于参数调优的零延迟、高交互性分析仪表盘。

📘 数据契约

关于从 DuckDB 暂存到 Parquet 原子发布、manifest 以及浏览器读取行为的约束，请参阅 Dataset Publish Contract v1。

⚡ 快速开始

几秒钟内启动你的多资产数据湖与量化引擎：

# 1. 安装 Node/Bun 依赖（网关与工具）
bun install

# 2. 同步极速 Python 环境（Dagster 数据流水线）
uv sync

# 3. 启动 Dagster UI，物化你的 Parquet 数据湖
PYTHONWARNINGS='ignore:Function' uv run dagster dev

# 4. 启动跨资产宏观回测！
bunx nexus-quant run --strategy "macro_tech_crypto_hedge" --start 2024-01-01

运行要求： 确保你已安装 Bun、uv 和 Rust 工具链。高度优化于 macOS 及 Ubuntu Linux 环境。

🛠️ 参与贡献

NexusQuant 正在积极寻找核心贡献者！无论你是痴迷于压榨 Rust 最小堆的极致性能，还是擅长编写健壮的 Polars 数据管道，亦或是热衷于微调金融 AI 智能体，我们都欢迎你的加入。

请参阅 CONTRIBUTING.md 了解如何提交 PR 以及多资产 config.yaml 的详细规范。