链量学堂（ChainQuest）

一个面向新手的 Web3 量化交易入门闯关游戏。
玩家通过可视化策略模块搭建交易逻辑，逐关完成“收益、执行、风控、模块组合”等目标，在反馈与复盘中建立量化交易基础。

项目概述

• 项目定位：把抽象的 Web3 交易概念做成“可操作、可反馈、可通关”的学习游戏。
• 核心用户：希望快速入门量化交易与策略思维的初学者。
• 主要场景：
  • 自学 Web3 交易基础（买卖、条件、仓位、止损止盈、DeFi 交互）
  • 黑客松演示“游戏化教育 + 可视化策略构建”
  • 作为量化课程前置实践工具

主要功能

• 关卡化学习路径：章节 -> 关卡 -> 目标反馈 -> 解锁下一关
• 可视化策略搭建：拖拽模块、连线配置、运行模拟
• 目标判定与诊断：按目标给出达成状态、当前值、修复建议
• 学习激励机制：连胜、里程碑奖励、章节解锁奖励
• 章节速记卡：通关章节后自动弹出 1 分钟复盘卡
• 本地持久化：关卡进度、经济数据、激励状态自动保存

技术栈

• 前端：React 18 + TypeScript + Vite
• 状态管理：Zustand
• 可视化画布：@xyflow/react（React Flow）
• 样式：Tailwind CSS
• 测试：Vitest + Testing Library + fast-check

安装与运行

1. 安装依赖

npm install

2. 本地开发

npm run dev

3. 构建产物

npm run build

4. 运行测试

npm run test:run

演示与仓库

• 前端演示地址：https://newrudy.github.io/while_true_learnWeb3/
• GitHub 仓库：https://github.com/NewRudy/while_true_learnWeb3

演示账号（如需）

• 当前版本无需登录，可直接体验全部公开功能。

部署说明

• 推荐部署平台：GitHub Pages（已提供自动部署工作流）/ Vercel / Netlify
• 构建命令：npm run build
• 输出目录：dist

License

• MIT（如与你的仓库保持一致，请在提交前确认）