FreedomIntelligence/BodyVista

项目介绍

BodyVista 是一个用于人体解剖与生理教学的 3D 互动平台。它把 2,900 个解剖结构、12 个身体系统、140 个动态演示条目和 6 个微观主题放进浏览器，让学习者查看空间关系、逐层隐藏结构，并把器官形态与生理功能联系起来。界面提供中文、英文和日文，并适配桌面与移动布局。

它适合学生、教师、科普工作者和独立学习者，用来替代静态图谱式的查阅方式。核心交互在浏览器本地运行，站点不需要自建后端或数据库。

学习模块

• 人体解剖：按系统和 7 个身体区域浏览 2,900 个结构，支持选择、逐层隐藏、多选、透明度和结构聚焦。
• 生命运动：提供 133 个系统演示、5 个全身演示和 2 个口腔牙科演示，带播放、进度和速度控制。
• 微观探索：覆盖肺泡气体交换、肾单位、肌节收缩、神经突触、小肠绒毛和血管壁 6 个主题。
• 解剖挑战：每轮 5 题，练习结构识别、在 3D 中定位结构和微观知识题，并给出答案反馈与结果。

3D 视图还支持旋转、平移、缩放、透视与正交投影切换，以及横断面、矢状面和冠状面剖切。绘图、橡皮擦、结构标注和测量工具可用于课堂演示或自主探索；结构搜索、解释、相关结构、参考文献，以及牙科结构的 FDI 牙位编号也已提供。AI 辅助学习入口会用当前结构和所选语言拼出提示词，打开 ChatGPT 或 DeepSeek；这是外部链接，项目内不需要 API key。

快速使用

可以直接打开在线演示或 Hugging Face Space，无需安装。若要在本地运行，请先安装 Node.js 22.12 或更高版本和 npm，然后克隆仓库并启动 Vite：

git clone https://github.com/FreedomIntelligence/BodyVista.git
cd BodyVista
npm ci
npm run dev

打开终端输出的本地地址。源码入口必须通过 Vite 提供，不能直接从文件系统打开 index.html。运行测试、构建并预览生产版本：

npm test
npm run build
npm run preview

npm run build 会先检查翻译和口腔模块的内容覆盖情况，再在 dist/ 生成站点。模型和缩略图已包含在仓库中，克隆和首次加载可能需要一些时间；请保留 assets/、thumbs/ 和 dental/models/ 目录。部署方面，仓库通过 GitHub Actions 发布：在 Pages 设置中把来源设为 GitHub Actions，推送到 main 后会使用 Node.js 22 安装锁定依赖、运行测试和内容检查、构建站点与模型资源，并发布 dist/（部署说明）。

使用约束与许可

本地开发需要 Node.js 22.12 或更高版本，并使用 Vite 提供和构建页面。模型与缩略图随仓库提交，因此完整克隆体积较大，首次加载也可能慢于轻量文档项目。

内容面向教学与学习。动画、微观场景和部分口腔结构包含示意图，不用于临床诊断或治疗决策。第三方模型和教学内容各自保留许可，部分口腔资源使用 CC BY-SA 2.1 Japan 和 CC BY-SA 4.0。每个结构的来源记录在 catalog.json 中，其中一些记录标有 NC exceptions; research only，其来源和允许公开分发的范围仍待核实。MIT 许可仅覆盖项目有权以该许可发布的代码和文档，不覆盖第三方模型或另行许可的内容（许可说明）。

HotRepo 点评

HotRepo 在 2026-11-03 的 JavaScript 语言新项目榜记录到：该项目在 2026-11-02 18:45 至 2026-11-03 05:45 UTC 的统计窗口内新增 22 Star，达到 122 Star、26 Fork，但未记录到全语言日榜名次。这个早期快照只能说明发布窗口内获得了一定关注，不能据此判断长期采用趋势。对读者更重要的是内容范围：一个在浏览器中交付的解剖图集，带演示、测验和剖切功能，同时对第三方模型明确标注了来源和许可限制。即使项目自身代码采用 MIT 许可，NC exceptions; research only 标记仍是复用或公开再分发模型前需要核查资产权利的具体理由。