# surf

**Repository Path**: zhuangbo/surf

## Basic Information

- **Project Name**: surf
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数学曲面 3D 交互式展示

一个基于 Three.js 和 KaTeX 的数学曲面 3D 可视化网页项目，支持交互式旋转、缩放和参数调节。

## 已实现展示

- [莫比乌斯带](mobius-strip-3d.html) — 经典拓扑曲面
- [马鞍面](saddle-surface-3d.html) — 双曲抛物面

## 技术栈

- Three.js r128 — 3D 渲染
- KaTeX 0.16.9 — LaTeX 公式渲染
- 单文件 HTML，无需构建工具

## 快速使用

直接在浏览器中打开对应 `.html` 文件即可查看。

## 新增曲面展示

参考 [.trae/skills/math-surface-3d/SKILL.md](.trae/skills/math-surface-3d/SKILL.md) 中的模板，复制后修改曲面方程和控制参数即可生成新页面。

## 特性

- 鼠标拖拽旋转
- 滚轮缩放
- 实时参数调节
- 线框模式切换
- 自动旋转开关
- LaTeX 公式展示