工具入口：小程序首页 → 「3D」→「3D 昆虫图鉴」包含功能：82 种昆虫的 3D 模型，按「目」分组浏览，科普讲解 + 小测验 + 实拍对照适用版本：功能以线上体验版为准

一、功能简介

一句话：一部可 360° 观察、可剖开看结构的 3D 昆虫百科，边看模型边学、还能自测。

• 收录 82 种昆虫，覆盖 21 个目（鞘翅目 28 种、膜翅目 8 种、半翅目 8 种、双翅目 7 种、鳞翅目 6 种、直翅目 5 种等）；

• 每个物种为程序化生成的 3D 几何（原版几何优先、部分物种以简化版兜底），100% 自研，无外部模型与贴图的授权负担；

• 支持剖切（沿矢状面切开看内部）与分层（体壁半透明）两种观察辅助；

• 全部名称、形态与习性说明均为科普示意，学名以权威志书为准。

二、昆虫分类（按「目」浏览）

列表页把所有物种按目（分类学阶元）分组成卡片，每张卡片标注该目的物种数与一句代表说明。当前收录情况：

合计 82 种、21 个目。

三、操作步骤

1. 列表页：按「目」浏览

昆虫分类列表

进入后是一张昆虫分类列表：按「目」分组、两列排布。

• 每张卡片显示目名 + 「N 种 · 代表物种」的说明（如「膜翅目 8 种 · 西方蜜蜂、熊蜂 等」）；

• 顶部副标题提示操作手势：「单指拖动旋转 · 双指捏合缩放 · 双指拖动平移 · 点选结构查看说明」；

• 点任意卡片 → 从底部弹出该目的物种抽屉。

2. 展开某个目，挑选物种

膜翅目物种抽屉

• 底部抽屉列出该目下的全部物种，每个物种是一条卡片：图标 + 中文名 + 英文名 + 一句话简介，右侧为「进入 ›」按钮；

• 抽屉右上角的 × 可关闭；

• 点任意物种的「进入」即打开它的 3D 视图。

3. 进入 3D 视图

西方蜜蜂 3D 视图

进入后即打开该昆虫的 3D 模型，模型默认自动缓慢旋转，便于 360° 观察：

• 模型上叠加若干深色标注胶囊（如「胸部」「复眼」「翅」等），直接标出各结构的位置；

• 画布底部靠左是功能条：讲解 / 实拍 / 剖切 / 分层；

• 画布左下是自动旋转开关（▶/⏸），右下是明暗切换按钮（🌙/☀️）；

• 页面底部两个按钮：重置视角、隐藏标注。

4. 旋转、缩放与平移

在画布上：

• 单指拖动：绕模型旋转，从任意角度看头 / 胸 / 腹、足、翅、触角、复眼等结构；

• 双指捏合：放大 / 缩小模型；

• 双指拖动：平移模型，用于微调观察位置。

5. 点标注看结构介绍

点击标注查看结构介绍

• 点模型上的任一深色标注胶囊，底部会弹出该结构的介绍浮层：显示名称与功能说明（图中为「胸部：运动中枢：足与翅着生于此，内含飞行与步行的肌肉」）；

• 浮层右侧的 × 可关闭；

• 说明文字较长时只显示前 4 行。

6. 切换明暗背景

深色背景

• 点画布右下角的圆形按钮（🌙/☀️）切换背景明暗；

• 深色背景下标注胶囊会反转为浅底深字，适合夜间或暗环境查看，也让甲壳、膜翅的高光更突出。

7. 自动旋转开关

• 画布左下的圆形按钮（▶/⏸）控制自动旋转，默认开启；

• 点一下暂停旋转（便于停下来细看某个角度），再点一下恢复；

• 该设置会被记住（下次进入沿用同一状态）。

8. 讲解与测验

讲解与小测验

点功能条里的**「讲解」，展开该物种的观察要点 · 小测验**面板：

• 观察要点：分 3～4 步，逐步说明该物种的辨认特征与代表性习性；

• 小测验：2 道选择题，点选项即时判对错（✓ 答对啦 / ✗ 再看看）；每道题只能作答一次；

• 面板顶部「收起 ×」关闭；内容较多时在面板内部滚动，不会让整页出现滚动条。

9. 实拍对照图

实拍对照图

点**「实拍」弹出该物种的实拍照片**（来自 iNaturalist，CC 授权）：

• 照片底部标注摄影者 · 许可协议（署名为许可条件）；

• 离线或暂无实拍图时，显示「该物种实拍图整理中」，不影响 3D 浏览。

10. 剖切观察内部

剖切视图

点**「剖切」会沿矢状面把模型切开，露出内部结构**；再点一次恢复原状。适合观察体节、内部器官的相对位置。

11. 分层观察内部

分层视图

点**「分层」会让体壁半透明**，一眼看穿外壳、看到内部的足、翅根与体节；再点一次恢复。

「剖切」与「分层」互斥：打开其中一个会自动关掉另一个。

12. 重置视角与标注显隐

页面底部两个按钮：

• 重置视角：把模型拉回初始的取景与缩放；

• 隐藏标注 / 显示标注：一键开关模型上所有深色标注胶囊（结构本身不受影响）。

13. 换个物种看看

帝王蝶 3D 视图

不同「目」的昆虫形态差异很大（如蝶蛾的翅、甲虫的鞘翅、螳螂的捕捉足），观察与操作方式完全一致。回到列表换一个物种即可继续探索。

四、选项与手势说明

五、注意事项

• 物种形态、习性说明为科普示意，非权威来源，学名以权威志书为准；

• 3D 几何由程序即时生成，进入即出图、无需联网下载模型，因此首屏没有加载进度；

• 实拍图需联网加载：图片托管于后端站点（源为 iNaturalist），离线或暂无图时显示「该物种实拍图整理中」，不影响 3D 浏览；

• 标注位置随模型旋转实时投影，若某个标注暂时不可见（转到了背面），旋转一下模型即可看到；

• 各物种标签的中文化程度不一：常用结构（头 / 胸 / 腹 / 翅 / 复眼 / 触角）为中文，个别特化结构（如蜜蜂的 stinger 螫针、pollenBasket 花粉篮）沿用原站英文标签；

• 剖切 / 分层属于观察辅助，只改变显示效果，不改变模型本身。

六、数据与许可

3D 模型几何

全部 3D 几何由本工具程序化生成（代码位于 src/pages/insect/three/，其中部分几何移植自开源项目 insect-world，MIT 协议，作者 xr843）：

• 除实拍图外，不引用任何外部 GLB 模型、贴图或第三方素材；

• 因此没有第三方模型授权负担，可自由使用与传播。

实拍对照图

实拍照片来自 iNaturalist，采用 CC-BY / CC-BY-NC / CC0 等知识共享许可，署名为许可条件：

• 应用内每张实拍图均标注摄影者与许可协议；

• 完整图源与署名清单见 src/pages/insect/data/photo-credits.js。

文字说明

各物种的名称、观察要点与小测验为本工具自撰，仅陈述公开、通行的昆虫学事实。

展示页已注明「科普示意，非权威来源」——学名与分类以权威志书为准。