1. 个人介绍
在校大学生,独立开发者。习惯把学习里遇到的“看不懂、记不住”拆成能动手操作的小工具;这次赛期用 TRAE 从 0 到 1 完成了 4 个作品,骨问是其中之一。
解剖复习时,二维图谱能看懂,但一合上书就想不起三维结构;市面上的 3D 解剖软件又偏重、偏贵。骨问先把“点一块骨头、马上知道它叫什么、在哪一区”这件事做顺。
2. 产品简介
是什么:一个在浏览器里直接打开的 3D 人体骨骼学习工具,不需要安装,也不需要登录。
面向谁:医学生、护理专业学生、运动康复自学者,以及需要快速对照骨骼名称的自学者。
功能与使用路径:
- 打开即见全身骨架,支持旋转、缩放、平移;首屏为 2.67 MB 量化低模,先看整体
- 单击任意骨块:骨骼自发光高亮,右侧面板显示中文名、英文名、所属分区、数量与编号
- 单击后相机自动推近;滚轮对准光标缩放;双击聚焦到该骨;R 重置视角
- 按分区筛选:颅骨 / 听小骨 / 脊柱 / 胸廓 / 上肢 / 下肢;听小骨当前无网格数据,界面明确标注“无数据”
- 选中后异步加载 16 MB 高模,右上角显示「HD 加载中 / HD 已就绪」
- 快捷键:Esc 取消选中、空格自动旋转、S 切换侧栏
技术栈:React + TypeScript + Vite + Three.js + React Three Fiber + drei
3. 体验地址
公开访问,无需登录;建议桌面浏览器,移动端暂未适配。
4. 演示视频
视频为线上站点真实录屏:点选推近、滚轮缩放、双击聚焦、R 重置、空格旋转。
5. TRAE 实践过程
赛期内时间线
- W1:项目骨架、骨骼拾取、高亮、信息面板、分区筛选、两级加载
- W4:修复部署版模型截断(线上低模曾是 0.78 MB 损坏文件),用 gltf-transform 从高模重生成 2.67 MB 量化低模并重新部署
- 验收返工:按包围盒自动取景(全身含指骨/趾骨)、zoomToCursor 深度缩放、双击聚焦、自发光高亮 + 脉冲环 + 居中标签、UI 重做
- 回归修复:分区映射 key 的空格/下划线归一化(183 块全部归区)、清理 drei Html 卸载报错、修复加载浮层卡 0%
关键截图
关键任务 Session ID
- 6afe8738704f54de3c7291b8:W1 骨架、拾取、高亮、信息面板
- 6afdbbda252ab451eeda56f5:验收返工(取景/缩放/UI/交互)
- 6afdbbc3252ab451eeda56dc:回归修复(分区映射、removeChild、加载浮层)
- 6afdb253db463f167bdfd707:线上部署与最终验收
踩坑与解决
- 线上低模文件被截断导致黑屏:从高模重新生成低模,校验文件头与网格数后再部署
- 映射表 77 个 key 带空格、运行时网格名带下划线:统一归一化后再查表,剑突从“未知 / 0 块”恢复为“胸廓 · 26 块”
- drei 的 Html 标签卸载时报 removeChild:调整挂载与销毁时序,线上控制台 0 报错
- 加载浮层只依赖 useProgress().active,长请求时永远停在 0%:改为“低模就绪即隐藏”
已知限制
- 尚未开展正式用户研究,交互取舍来自开发者自测
- 移动端未适配;高模 16 MB,弱网首次加载较慢
- 听小骨暂无网格数据,界面如实标注



