BodyVista｜开源浏览器 3D 人体解剖生理交互学习平台

10 个关键问题 Q&A

Q1：BodyVista 需要服务器后端吗？A1：不需要，全部核心交互在浏览器本地运行，是纯前端项目。

Q2：一共包含多少解剖结构？A2：内置 2900 个解剖结构，按人体系统和 7 大区域组织。

Q3：支持哪些语言？A3：中文、英文、日语三种语言，界面和教学内容同步翻译。

Q4：里面的动画和模型能不能用来看病诊断？A4：不能，属于教学示意图，禁止用于临床诊断与治疗决策。

Q5：AI 辅助学习功能需要配置 API Key 吗？A5：不需要，只是跳转 ChatGPT/DeepSeek 外链，自动带入提示词。

Q6：本地部署需要什么环境？A6：Node.js 22.12 及以上，使用 Vite 启动，不能直接打开 index.html。

Q7：项目模型来源是哪里？A7：来自 Z-Anatomy、BodyParts3D、Dental Scope、OpenStax 等开源资源。

Q8：代码是 MIT 开源，模型也是 MIT 吗？A8：不是，仅项目自有代码 MIT；模型、教学素材有独立许可，部分仅限研究。

Q9：有哪些特色微观学习内容？A9：肺泡气体交换、肾单位、肌节收缩、神经突触、肠绒毛、血管壁 6 个专题。

Q10：社区提交 PR 有什么硬性要求？A10：提交前执行 npm test 与 npm run build；新增文本补齐三语翻译；解剖生理修改附上参考文献。

项目地址：

• GitHub：https://github.com/FreedomIntelligence/BodyVista
• 在线演示：https://freedomintelligence.github.io/BodyVista/
• HuggingFace Space：https://huggingface.co/spaces/FreedomIntelligence/BodyVista
• 文档：英文 README / 中文 README.zh-CN.md

从人体解剖到生理机制，可观察、可交互、可探索的人体 3D 教学平台。BodyVista 是面向解剖学、生理学教学与自主学习的浏览器端 3D 交互平台，内置 2900 个解剖结构、12 大人体系统、140 项动态演示、6 大微观专题，全部在浏览器内运行，帮助学习者理解解剖空间位置、层次关系与生理功能。支持中、英、日三语，适配电脑与移动端；核心交互在本地浏览器执行，不需要自建后端、数据库，可直接部署到 GitHub Pages。

✨ 核心功能

附加工具：

1. 3D 浏览与断层剖切：旋转、平移、缩放、视角重置；透视 / 正交投影切换；横断、矢状、冠状切面查看
2. 绘图与测量：画笔粗细可调、橡皮擦、结构标注、测量工具，适合课堂演示和自学
3. 结构检索与知识库：名称检索，查看结构释义、关联结构、参考文献；牙科结构支持 FDI 牙位编号与组织说明
4. AI 辅助拓展学习：基于当前选中结构，一键唤起 ChatGPT / DeepSeek（外链，项目本身不需要 API Key）
5. 多语言响应式界面：中 / 英 / 日内容与界面；桌面侧边栏、移动端折叠菜单

⚠️ 重要声明：本项目用于教学学习。动画、微观场景、部分口腔结构为示意图，不可用于临床诊断、制定治疗方案。

🛠️ 技术栈

🚀 快速上手

本地开发

环境要求：Node.js 22.12 或更高版本 + npm

bash

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


打开终端输出的本地链接；必须通过 Vite 服务访问，不能直接双击打开 index.html

测试 & 打包

bash

npmtest
npm run build
npm run preview


npm run build打包前会自动校验翻译完整性、口腔模块内容覆盖度，产物输出到 dist/；npm run preview用来本地预览生产包。

仓库内置模型与缩略图，首次克隆加载耗时较长；assets/、thumbs/、dental/models/目录不可删除。

GitHub Pages 自动部署

仓库内置 workflows 配置文件 .github/workflows/pages.yml在仓库设置 → Pages → Build and deployment，部署源选择 GitHub Actions。

• 每次向 main 分支推送：锁定依赖安装、自动测试、内容校验、打包模型资源、发布 dist
• 也可手动触发：Actions → Deploy BodyVista to GitHub Pages → Run workflow

🌱 项目愿景

希望降低人体生物学学习门槛，为科普、资源匮乏地区的医学教育提供直观教具；远期计划把这套内容迁移到 VR/AR 沉浸式交互形态，实现沉浸式人体解剖生理探索。

🙏 致谢

• Z-Anatomy（Lluís Vinent 及贡献者）：人体解剖模型与数据，每个结构来源记录在 catalog.json的 source_attribution
• BodyParts3D / DBCLS（生命科学数据库中心）：人体解剖、口腔模型基础资源
• Dental Scope（Yoseph 及贡献者）：口腔引擎、解剖配准、教学内容与模型；授权与修改记录见 dental 目录文档
• OpenStax《Anatomy and Physiology 2e》：解剖生理知识点参考，内容数据内保留对应章节链接
• Three.js、Vite、three-mesh-bvh、Zustand、React 社区：渲染、构建、口腔模块依赖

注意：第三方资源各自保留原有来源与许可；BodyVista 的署名不能替代原作者版权声明。

👥 贡献者

MarkMaMed、rikka314、WangRongsheng欢迎提 Issue 和 PR。提交前务必执行 npm test+ npm run build；新增界面文本需要同步补充中、英、日三语翻译；修改解剖 / 生理内容时附上可核验参考文献。

📄 许可证

© 2026 FreedomAIBodyVista 自有代码采用 MIT 协议，但不覆盖第三方模型、素材、教学内容的原有许可证，详细见 THIRD_PARTY_NOTICES.md：

1. Dental Scope 代码：MIT；口腔模型、改编教学素材看 dental/vendor/CREDITS.md、assets.md、dental/README.md，包含 CC BY-SA 2.1 Japan、CC BY-SA 4.0 等协议
2. 主体解剖模型：版权信息在 catalog.json，部分标记 NC exceptions（仅研究用途），分发权限仍待核验，不可默认按宽松开源处理
3. 其余第三方库：遵循各自原始许可协议

MIT 仅适用于项目方有权开源的代码与文档；模型和独立授权内容不在 MIT 范围内。