insect-world

一个在浏览器里运行的3D昆虫图鉴，名字叫”昆虫世界”。作者用代码直接生成昆虫模型，仓库里一个模型文件都没有，全是TypeScript现算出来的几何体。

Github地址

https://github.com/xr843/insect-world

在线体验

https://insect-world.pages.dev/

功能特性

3种昆虫、14个目，每只虫都是浏览器实时生成的代码模型，能转能看能解剖，还能做题测验。

核心看点是”零资产”建模。不用买模型、不用扫标本，靠参数化代码描述昆虫的身体结构——头胸腹三段、三对足、两对翅、分节的附肢，这些规律性的东西写成可调参数，加一个新物种就添一份描述文件。三角面数从一万三到三万六不等，构建时间30到90毫秒，首屏JS压缩后约424KB，物种代码点到谁下谁。

交互方面。左侧图鉴列表点选或上下键翻页，中间3D展台拖转滚轮缩放，彩色圆点是部位标注，点开会讲这是啥结构。工具条四个按钮都有真响应：聚焦把镜头怼到具体部位，剖切是真实的裁剪平面切开模型，分层让外骨骼变半透明，对比能在底部浮出对照条。右侧详解带分步讲解，每步镜头自动移到讲的位置；小测能答题、判对错、给解释、算得分。

两套主题切换。默认”标本台”是冷灰绿档案衬板配青铜铭牌，切”博物馆之夜”变成展厅黑底、黄铜骨架、聚光灯打亮标本，金属鞘翅和薄膜虹彩在暗底上比较出效果。

数据层有中英双语，但英文是AI翻译的未校订版，学名拉丁二名法是两边唯一可靠的对应锚点。图鉴文案也是AI写的，作者明确说不能当学术引用。

部署使用

本地跑：npm install 后 npm run dev，主站开5178端口，带一个 /preview.html 的模型调试台。npm test 跑4000多个测试，npm run build 做类型检查加vite构建，npm run deploy 发布到Cloudflare Pages（要先 npx wrangler login）。