Offline Math Toolbox
一个完全离线、零安装的互动数学课件工具箱 —— 面向课堂演示、触屏一体机与机房学生机。
GeoGebra + Desmos + 按章编排的互动课件，拷进 U 盘即可用，全程不需要联网。
不想下载？可直接在浏览器中打开在线版课件：
https://hgaonice.github.io/offline-math/
在线版由 GitHub Pages 提供，适合快速体验与临时演示。 课堂长期使用推荐 下载离线包，完全离线、不受网络影响，并支持局域网学生机访问。
课堂里常常遇到这些麻烦：学校网络不稳定、一体机装不了软件、GeoGebra / Desmos 官网打不开、机房学生机配置混乱。本项目把主流的数学可视化工具和整理好的课件打包成一个离线文件夹，双击启动脚本就能在任意 Windows 电脑上运行：
- 🧮 GeoGebra 5.4 官方离线包 —— 经典版、图形计算器、几何、3D 绘图、CAS、表格
- 📈 Desmos 离线计算器 —— 中文界面 + 预置初中课件
- 📚 互动课件中心 —— 按教材章节编排，拖动滑块即可实时演示
- 🌐 内置局域网服务 —— 学生机在同一 Wi-Fi 下输入地址即可访问，无需安装任何东西
- 💾 完全离线 —— 无 CDN、无外部请求，U 盘拷走即用
直接打开：https://hgaonice.github.io/offline-math/
点击卡片即可使用 GeoGebra / Desmos 与全部课件。适合快速体验，或临时在没有离线包的电脑上演示。
1. 下载 / 克隆本仓库到本地（或拷到 U 盘）
2. 双击 启动服务.bat
3. 浏览器自动打开首页，从「课件中心」卡片进入
启动脚本会自动探测可用端口（8080 起，被占用则顺延），并在控制台打印本机与局域网访问地址：
本机访问： http://127.0.0.1:8080/
局域网访问： http://192.168.x.x:8080/ ← 学生机 / 一体机输入这个
关闭黑色控制台窗口即停止服务。
如果 runtime/node.exe 被杀毒软件拦截，或不需要局域网服务，可双击：
备用-直接打开（无需服务）.bat
它直接用 Edge/Chrome 打开本地页面，功能完全一致，且使用独立的临时浏览器配置，不影响原有书签与设置。
serve.js 是零依赖的 Node 静态服务器，macOS / Linux 上使用系统 Node.js 即可：
node serve.js # 默认 8080，自动顺延并打开浏览器
node serve.js 9000 # 指定端口
node serve.js --no-open # 不自动打开浏览器课件按《义务教育教科书·数学》（人民教育出版社 2024 版）章节编排，覆盖初中六册，每「节」一个课件，共 123 个：
| 册 | 文件 | 项数 |
|---|---|---|
| 七年级上册 | courseware/data/7a.js |
24 |
| 七年级下册 | courseware/data/7b.js |
26 |
| 八年级上册 | courseware/data/8a.js |
27 |
| 八年级下册 | courseware/data/8b.js |
20 |
| 九年级上册 | courseware/data/9a.js |
18 |
| 九年级下册 | courseware/data/9b.js |
8 |
| 合计 | 123 |
课件分工：几何 → GeoGebra；函数 / 方程 / 代数 → Desmos；立体图形 → GeoGebra 3D；统计图表 → 手绘多边形。
每个课件都能拖滑块、拖点、看图形实时变化，支持课堂上边讲边调参。按 F11 全屏投影效果更佳，触摸屏可直接用手指拖动缩放。
offline-math/
├─ 启动服务.bat ← 主入口（双击）
├─ 备用-直接打开（无需服务）.bat ← 备用入口
├─ 使用说明.txt ← 面向老师的完整中文手册
├─ index.html ← 首页
├─ serve.js ← 零依赖本地静态服务器
├─ runtime/ ← 便携版 Node.js（Windows）
├─ vendor/GeoGebra/ ← GeoGebra 官方离线包
├─ geogebra/ ← GeoGebra 各功能页
├─ desmos/ ← Desmos 计算器 + 中文界面
├─ courseware/ ← 课件中心
│ ├─ index.html ← 课件总目录
│ ├─ view.html / player.js ← 播放器与渲染引擎
│ ├─ app.js / style.css ← 工具函数与样式
│ └─ data/7a.js … 9b.js ← 六册课件数据 ★
└─ _prompts/ ← 课件生成提示词与验收记录
想新增课件，只需在 courseware/data/*.js 里追加一条数据，格式见 _prompts/00-公共约定.md。教师可以自行增删，无需改动引擎代码。
本仓库约 200 MB，几乎全部来自打包的第三方离线资源与运行时：
| 目录 | 大小 | 说明 |
|---|---|---|
vendor/GeoGebra/ |
~117 MB | GeoGebra 官方离线包（含 2D / 3D / Simple 三套引擎） |
runtime/node.exe |
~83 MB | 便携版 Node.js，让目标机无需安装任何东西 |
desmos/calculator-zh.js |
~4 MB | Desmos 离线计算器 |
courseware/ |
~240 KB | 本项目自己的课件与代码 |
这是「离线可用、零安装」换来的代价。若你只需要课件本体，可以只保留 courseware/；若目标机已装 Node.js，可以删掉 runtime/。
⚠️ 由于体积，直接git clone会比较慢。如需完整离线包，建议在 Releases 页面下载打包好的 ZIP。
本项目只是把官方离线资源打包整合，方便课堂离线使用，各第三方组件版权归原作者所有：
- GeoGebra —— 非商业用途免费，详见 https://www.geogebra.org/license
- Desmos —— 教育用途免费，详见 https://www.desmos.com
- Node.js —— MIT License
本项目自身的代码与课件数据以 MIT License 发布，详见 LICENSE。请勿将本工具箱用于商业用途。
当前聚焦初中数学。工具箱的框架（离线加载器 + 课件渲染引擎 + 局域网服务）与学科无关，后续计划扩展到更多学段与学科，例如：
- 高中数学
- 小学 / 初中其他学科（物理、化学等）的可视化演示
- 更多教材版本（北师大版、苏教版等）
- 课件导入 / 导出与教师自定义
欢迎通过 Issue 提出需求，或提交 Pull Request 一起完善。
- 发现课件错误、图形不正确、版式问题 → 提 Issue
- 想新增课件 → 参考
_prompts/00-公共约定.md的数据格式与 GeoGebra/Desmos 约定 - 打包体积、启动方式、跨平台问题 → 也欢迎反馈
Q：双击 .bat 一闪就没了？
A：多半是文件没拷全。请确认 runtime 和 vendor 两个文件夹都在。
Q：浏览器里 GeoGebra 一直「正在加载」？
A：请用 启动服务.bat 打开，不要直接双击 geogebra/ 里的 html 文件 —— 浏览器安全策略会拦截本地文件加载。
Q：杀毒软件拦截 node.exe？
A：改用 备用-直接打开（无需服务）.bat，它不需要 node.exe。
Q：端口被占用？ A：不用管，程序会自动往后找 8081、8082……
完整的课堂使用技巧与排错，见 使用说明.txt。