Human Atlas

Human Atlas 是一个高性能、开源的交互式 3D 人体解剖学可视化工具。它基于 React、Three.js 和 shadcn/ui 构建，将复杂的医学数据转化为直观、可操作的网页体验。该工具旨在为医学生、教育工作者和解剖学爱好者提供一个无需安装、跨平台的探索平台。

核心功能

• 高精度模型拆解：基于 BodyParts3D 4.0 成年男性参考模型，将其拆解为 2,234 个可独立选择的网格。
• 全系统覆盖：支持探索 15 个解剖系统（如骨骼、肌肉、神经、循环系统等），并可一键切换预设视图。
• 智能搜索与隔离：内置搜索引擎支持通过 3,432 个命名概念或源标识符快速定位结构。选中后可隔离显示，并查看详细解剖信息。
• 展开式清单 (Exploded View)：提供从完整组装到部件展开的动态过渡，帮助用户理解空间层级关系。
• 移动端优化：针对触摸屏设备进行了专门优化，提供紧凑的控制面板和自适应的细节展示布局。

技术架构与性能优化

Human Atlas 在浏览器中实现了桌面级应用的流畅度，主要得益于以下技术手段：

1. GPU 驱动的状态管理：
   • 使用 GPU 纹理来控制每个结构的平移、可见性和选择状态，避免了 CPU 端的频繁计算。
   • 几何体合并为批次（Batching），大幅减少了绘制调用（Draw Calls），确保在拥有数千个独立部件时仍能保持高帧率。
2. 精确拾取与交互：
   • 组件几何体支持精确的射线检测（Raycasting），确保用户点击微小结构时也能准确选中。
   • 轨道控制（OrbitControls）经过调优，即使在场景复杂变化时也能保持响应灵敏。
3. 数据轻量化：
   • 原始模型经过简化处理（相对误差限制 0.2%），最终打包模型包含约 228 万个三角形，压缩后几何体仅约 33 MB，适合网络分发。
4. WebMCP 集成：
   • 可选的 WebMCP 工具暴露了解剖搜索和检查接口，允许其他兼容的 AI 代理或工具通过标准协议访问解剖数据。

数据来源与许可

• 基础模型：BodyParts3D 4.0（成年男性参考解剖模型）。
• 许可证：CC BY 4.0。
• 免责声明：这是一个教育探索工具，绝非用于临床诊断或手术规划。模型不代表所有人体变异或病理状态。

本地开发与部署

环境要求

• Node.js 22.13 或更新版本。
• 无需 API 密钥或后端服务。

快速启动

npm ci
npm run dev

访问 http://localhost:3016 即可开始探索。

验证与测试

项目包含完整的自动化验证脚本，涵盖网格完整性、名称映射、布局非重叠性以及多分辨率下的交互测试：

npm run check
node scripts/validate-atlas.mjs
node scripts/validate-interactions.mjs

部署

• Vercel：直接导入仓库，vercel.json 已配置好构建流程 (npm ci -> npm run build -> dist/)。
• 静态主机：运行 npm run build 后，将 dist/ 目录部署至任何支持静态文件的服务（如 Nginx, S3, GitHub Pages）。