一句话在浏览器里创建可交互的数学图形。输入自然语言描述，AI 自动生成 GeoGebra 命令并在实时画板中呈现。
| 变量 | 必填 | 说明 |
|---|---|---|
MODEL_API_KEY |
是 | 模型服务 Key，部署时自动注入服务端，（sk-xxxxxxxxxxxxxxxxxxx） |
MODEL_BASE_URL |
是 | 模型服务接口地址（ https://tokenhub.tencentmaas.com/v1 ） |
MODEL_NAME |
是 | 默认模型名（ deepseek/deepseek-flash ） |
- 学生和教师：想要快速创建数学几何图形辅助学习和教学，无需学习复杂的 GeoGebra 命令语法
- 数学/科研爱好者：需要可视化函数、几何关系或数学模型
- 前端开发者：对 AI 集成（Vercel AI SDK）、SolidJS 实践、数学可视化感兴趣
- 教育技术探索者：研究如何将大语言模型与专业软件结合，降低使用门槛
GeoGebra 是一款优秀的动态数学软件（Geometry + Algebra），全球用户超过 1 亿。然而，使用 GeoGebra 需要掌握其特定的命令语法，对初学者构成门槛。
与此同时，大语言模型在理解和生成自然语言方面的能力不断提升。Geogebra Webchat 的核心思路：让用户用自然语言描述数学问题，AI 自动转化为 GeoGebra 命令，在画板上实时构造图形，并用文字解释几何关系。
这带来了几个根本性的变化：
- 降低门槛：不用记命令，说人话就行
- 提高效率：一句「画一个正四面体并标出外接球」秒出结果
- 拓展场景：经济学图表、物理模型、3D 几何都可以用自然语言生成
- 自然语言作图：输入数学/几何问题，AI 自动生成并执行 GeoGebra 命令
- 实时交互画板：拖拽、缩放、旋转，图形与代数区联动
- 流式 Markdown 渲染：AI 解释步骤实时显示，公式用 KaTeX 渲染
- 2D / 3D 支持：平面几何和立体图形均可
- 多模型兼容：通过 OpenAI 兼容 API，可切换任意大模型（DeepSeek、通义千问、GPT 等）
- 服务端 Key 注入：可选隐藏 API Key，不暴露给浏览器
输入：Draw a triangular pyramid (tetrahedron) and then draw its circumscribed sphere
输入：美国总统证明勾股定理图示
输入：经济学的李嘉图贸易理论
输入：各种圆锥曲线
- 前端：SolidJS + Vite，
marked渲染 Markdown，KaTeX 渲染公式 - AI：Vercel
aiSDK v6，浏览器内streamText({ stopWhen: stepCountIs(6) })跑工具调用循环 - GeoGebra：官方 CDN
deployggb.js，无需本地 vendor 文件 - 后端：EdgeOne 云函数
cloud-functions/llm-proxy，透明转发 + 解决 CORS + 服务端 Key 注入 - 部署：EdgeOne Pages，
edgeone makers deploy一条命令上线
├── index.html
├── src/
│ ├── App.tsx # 聊天 + 画板 布局
│ ├── ai-client.ts # AI 工具循环（核心）
│ ├── geogebra.ts # CDN 加载 + 画板控制
│ ├── styles.css
│ └── lib/normalize.ts # 命令规范化（中文别名→英文）
├── cloud-functions/
│ └── llm-proxy/ # EdgeOne 云函数：LLM 请求代理
├── doc/ # 效果截图与参考文档
└── edgeone.json # EdgeOne 部署配置
① 一个模型 API Key —— AI 的「大脑钥匙」。需要一个 OpenAI 兼容格式 的模型服务，例如 tokenhub 平台的 Key、DeepSeek 官方 Key 等。
拿到两样东西：
- Key：形如
sk-xxxx - 接口地址（Base URL）：形如
https://api.deepseek.com/v1
提示：作图效果需要较强的模型（DeepSeek-V3 / GPT-4o 级别以上）。
② 部署工具：服务器上或本机需要能执行部署命令——
npm install -g edgeone # 安装 EdgeOne CLI
edgeone login # 登录你的 EdgeOne 账号这是 AI 的「大脑钥匙」。你需要一个 OpenAI 兼容格式 的模型服务，例如 tokenhub 平台的 Key、DeepSeek 官方 Key 等。
拿到两样东西：
- Key：形如
sk-xxxx - 接口地址（Base URL）：形如
https://api.deepseek.com/v1
提示：作图效果需要较强的模型（DeepSeek-V3 / GPT-4o 级别以上）。
把项目里的 .env.example 复制一份，重命名为 .env，打开填入你的 Key：
MODEL_API_KEY=sk-你的Key
MODEL_BASE_URL=https://你的接口地址/v1
MODEL_NAME=你的模型名
（项目里已提供 .env.example 模板，照着填就行）
这个 Key 只保存在服务器端，不会暴露给浏览器——访客打开网页无需任何配置。
在项目目录执行一条命令：
edgeone makers deploy -n geogebra-webchat完成后会输出你的专属网址。
浏览器打开网址，直接输入数学题——不需要填任何 Key（服务端已自动注入）。
想换模型？页面右上角直接修改模型名和接口地址即可。
前置：安装 Node.js 20+ 和 EdgeOne CLI（npm install -g edgeone）。
npm install
edgeone makers dev打开 http://localhost:8088 即可边改边看（前端改动热更新，云函数改动自动重启）。
| 变量 | 必填 | 说明 |
|---|---|---|
MODEL_API_KEY |
是 | 模型服务 Key，部署时自动注入服务端，访客无需配置 |
MODEL_BASE_URL |
推荐 | 模型服务接口地址（.env 里已提供示例） |
MODEL_NAME |
否 | 默认模型名（也可在页面右上角随时切换） |
想换模型不需要改环境变量——打开网页，在右上角直接修改模型名和接口地址即可。
你输入数学题 ──→ 浏览器内的 AI 工具循环（Vercel AI SDK）
│ AI 生成 GeoGebra 命令
▼
云函数 /llm-proxy（EdgeOne）──转发──→ 模型服务
│
▼
GeoGebra 画板逐条执行命令 → 图形出现
│
▼
AI 再用文字解释几何关系（流式输出）
- 前端：SolidJS + Vite，AI 逻辑跑在浏览器里（
src/ai-client.ts），GeoGebra 用官方 CDN 加载 - 后端：只有一个 EdgeOne 云函数
cloud-functions/llm-proxy，负责转发模型请求、解决跨域、隐藏你的 Key - 命令规范化：
src/lib/normalize.ts把中文命令别名自动转成 GeoGebra 英文命令
├── index.html
├── src/
│ ├── App.tsx # 聊天 + 画板 布局
│ ├── ai-client.ts # AI 工具循环（核心）
│ ├── geogebra.ts # 画板加载与控制
│ └── lib/normalize.ts # 命令规范化（中文别名→英文）
├── cloud-functions/
│ └── llm-proxy/ # EdgeOne 云函数：LLM 请求代理
├── doc/ # 效果截图与参考文档
├── edgeone.json # EdgeOne 部署配置
├── .env.example # 环境变量模板（复制为 .env 使用）
└── .env # 你的实际配置（不提交到仓库）
MIT
