Shirone × Znfooe

目标人群#

平台功能#

• 65+ 个交互式数学实验，覆盖极坐标曲线、三角函数、泰勒展开、线性代数、矩阵分解、PCA、蒙特卡洛、马尔可夫链、拉普拉斯变换、小波分析、黄金分割、博弈论等
• 参数实时调控：每个实验配滑块 + 数字输入框
• 坐标系智能锁定：调参时坐标系不动，曲线超出视野才自动扩大
• 全屏演示模式：图表撑满屏幕，内置可折叠参数面板，ESC 退出
• AI 语音讲解：双音色普通话旁白，随实验同步播放
• 防误触设计：全屏时滚轮不误缩放图表，适配课堂翻页笔

技术栈#

1
React 19 + TypeScript + Vite + Tailwind CSS + Plotly.js
2
后端：Express + LowDB（仅用于缺陷反馈收集，非核心）

快速开始#

1
# 1. 克隆仓库
2
git clone https://github.com/Znfooe/mathviz.git
3
cd mathviz
4

5
# 2. 安装全部依赖
6
npm run install:all
7

8
# 3. 启动开发环境（前端 5173 + 后端 3001）
9
npm run dev

构建生产版本：

1
cd client
2
npm run build   # 产物输出到 client/dist/

部署#

平台构建产物是纯静态网站，部署极其简单：将 web/ 目录上传到任意静态服务器（nginx、宝塔、Vercel、Netlify、GitHub Pages 均可），无需 Node.js、后端或数据库。

项目已开源，欢迎前往 GitHub 仓库查看完整文档：

github.com/Znfooe/mathviz