前言¶
讲物理课时,三维场景是绕不开的:洛伦兹力的方向随速度变化,原子轨道的形状靠图说不清,刚体旋转不看动态就理解不了。传统做法是教师自己用 GeoGebra、Python 脚本或 Three.js 现写一个演示页面,做完一个场景要花几天,换一节课又要重来。下面介绍的 edu-physics-3d 是 SkillHub 上的一个 Skill,把这类三维物理场景直接生成交互教学网页,左中右三栏,一次成稿。
这是什么¶
edu-physics-3d 由 SkillHub 用户 user_8bb4b4f5 发布,官方地址为 https://api.skillhub.cn/user_8bb4b4f5/edu-physics-3d 。它是一个基于 SKILL.md 格式的通用 Skill,面向三维物理教学:用户给出一个需要三维展示的物理场景,Skill 产出一个交互教学网页。它的形态与 edu-chem-reaction 平行,但面向 3D 物理教学而非化学分子。
SkillHub 页面显示:分类 education,评分 99722,下载 1075 次。
核心功能¶
生成的网页固定为三栏布局:
- 左栏:题面 + 动态控制台。控制台用滑块驱动参数,右侧实时显示物理量读数,并带守恒定律指示。
- 中栏:KaTeX 分步解析,公式随参数变化。
- 右栏:Three.js 3D 交互画板,支持球体、箭头、轨迹曲线等图元,画板可旋转缩放。
实现上,Three.js 通过 CDN 加载,不打包进网页;计算侧不依赖 sympy,符号处理不在本 Skill 范围内。
安装与启用¶
官方页面(api.skillhub.cn 与 skillhub.cn 两处)目前抓取不到正文,资料中未提供明确的安装命令,这里不做推测。SkillHub 上的 Skill 一般通过客户端侧安装使用,Cursor、Codex CLI、Claude Code 的具体安装方式差异以官方页面为准,拿到命令后再补入本文。
启用方式是使用触发词唤起,中英文均可:
- 中文触发词:3D 物理、洛伦兹力、叉积、右手定则、原子轨道、晶体结构、三维旋转、磁场三维、电磁波三维。
- 英文触发词:3D physics、Lorentz force、cross product、right-hand rule、atomic orbital、crystal structure、rigid body rotation、magnetic field 3D、EM wave 3D。
典型用法¶
把场景描述给 Skill,例如直接说”做一个洛伦兹力演示”或”展示 s 轨道和 p 轨道的形状”,配合触发词即可。Skill 会产出一个独立的交互网页:拖动左栏滑块改变参数,中栏解析和右栏画板同步更新,守恒定律指示显示当前是否守恒。
以洛伦兹力为例,右栏用箭头表示速度、磁场和力,用轨迹曲线画出粒子在磁场中的偏转路径,球体可用于标注电荷位置;用户可在画板上旋转缩放,从任意角度观察方向关系。原子轨道场景则用曲面展示轨道波函数的截面形状。
适用场景与注意¶
适合需要三维可视化的物理教学与课件制作:洛伦兹力与叉积、原子轨道、晶体结构、刚体旋转、三维磁场与电磁波。
两点注意:
- 只面向三维场景。抛体运动、振动、波、光学这类二维场景请使用 edu-physics,不要在本 Skill 里硬凑。
- Three.js 走 CDN,生成的网页需要能访问外网;内网或离线环境需自行把 Three.js 换成本地路径。
结尾¶
edu-physics-3d 的价值在于把”三维物理课件”从写代码变成提需求:三栏布局、滑块联动、KaTeX 解析、Three.js 画板一次到位。官方地址:https://api.skillhub.cn/user_8bb4b4f5/edu-physics-3d 。