科普互动实验
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 将 @user_281d3505/z-sci-viz-lab 安装到 AI 助手。
技能介绍
它解决什么问题
写技术文章时常见一种窘境:概念本身有清晰的空间关系、时间变化或参数依赖,但手里的表达工具只有静态截图和 LaTeX 公式。读者看完定义仍不知道“调大这个值会发生什么”,作者也很难用文字补齐这层直觉。科普互动实验要补上的正是这一环——把抽象的数学/科学概念变成一个“电脑手机都能打开的单页互动实验”,先让用户动手旋转、拖动、调参数,再回到正式定义、结论边界与来源引用。
它如何工作
技能按固定方法论推进,核心流程分 8 步:
事实核验:动工之前先查官方页面、原始论文或可靠综述,杜绝虚构定理与数字;直觉模型:把抽象概念转成 3D 模型或 2D 画布,回答“这道题到底在问什么”;正式定义:在直觉之后给出准确定义,并区分容易混淆的关键概念;互动实验设计:参数滑杆实时更新模型与状态文字,支持拖动旋转、滚轮缩放、重置视角、暂停动画;边界说明:写清楚页面只用于建立直觉,不充当数学证明;来源追溯:结论可回到官方资料,页面末尾列出链接;Vite 单文件构建:npm run build经vite-plugin-singlefile打成单个dist/index.html;发布上线:npm run deploy部署到 Cloudflare Pages,拿到桌面与手机都能访问的线上地址。
技能提供两种使用方式。方式 A 用于全新主题,直接修改 templates/prompt-template.txt 中的主题对象、核心变量、运动规则、时间线与权威资料五处参数,即可生成完整的单页项目。方式 B 用于扩展现有项目,需实现 { id, name, init(container), update(params), dispose(), getDefaultParams() } 接口,并在主入口通过 registerScene(myScene) 完成注册;场景由 scene-loader.js 懒加载,激活时才初始化,全局只有一个渲染循环。
底层技术栈为 Vite + Three.js(3D)+ HTML Canvas(2D),辅以 vite-plugin-singlefile 做产物打包;视觉上采用暖米白背景、深海军蓝实验区、红色强调和等宽字体参数标注,风格接近编辑部科学手册。
适用边界与注意点
- 页面演示的核心目的是建立直觉,不作为数学证明,开放问题需明确说明;
- 所有结论必须可追溯到官方资料或可靠综述,禁止虚构引文;
- 桌面与手机分辨率均需无横向滚动,控件要支持键盘访问并遵守
prefers-reduced-motion; - 滑杆、按钮、拖动、缩放、重置需实测可用,浏览器控制台无报错;
- 构建产物
dist/index.html必须是可直接打开的单文件,线上地址能够访问。
使用场景
- 撰写数学科普文章时,需要把抽象概念做成可拖动、调参数的单页演示,而非静态截图。
- 做天文主题科普时,需要根据日食、月相或潮汐等主题,生成带权威来源的互动实验。
- 维护开源可视化项目时,需要按插件接口新增一个场景,并注册、懒加载与发布。
- 发布教学演示时,需要得到一个桌面与手机都能直接打开、无横向滚动的线上页面。
适合人员
- 负责数学或物理概念讲解的技术博主,需要把公式变成读者可动手操作的互动演示。
- 编写天文或地理教学材料的教师,需要配合课程主题生成单页互动实验并附来源。
- 开发开源可视化项目的工程师,需要按 scene 接口扩展新场景并维持统一渲染循环。
- 搭建学位课交互演示的学生,需要快速产出可访问、可验证结论的原型页面。