verified-run-2981
本地真实部署、网页探测与交付物整理通过，已完成 OSS 校验。
部署要求：详见源码包内的慕卿部署说明。
浏览器三维模型查看与标注｜Med3D
在浏览器中加载 OBJ 三维网格、调整观察视角并添加文字标注。已用非患者演示模型验证中文导入、WebGL 显示、缩放和标注流程。
Med3D是基于Node.js、MongoDB、AngularJS和WebGL的三维可视化源码。本次实际部署真实/web/业务入口，导入生成的非患者OBJ网格，完成三维显示、缩放、中文文字标注和服务器资源读取。服务器及主要浏览器依赖做了兼容升级，但AngularJS/Bootstrap仍有已知公告，仅用于本地教学研究；不承诺临床功能或公网安全。
真实界面
项目截图
共 7 张
Capabilities
核心功能
✓中文 OBJ 文件导入（已验证）
✓WebGL 三维网格显示与视角缩放（已验证）
✓三维场景文字标注（已验证）
适用场景
非患者三维网格教学演示
OBJ 模型观察与文字备注
医学三维可视化源码研究与二次开发
适合谁
学习 WebGL 三维可视化的开发者、需要 OBJ 网格查看和标注原型的教学与研究团队。
商业化思路
面向三维数据教学、可视化原型和源码研究的自托管项目；当前已验证范围为本地演示 OBJ 模型导入、显示、视角缩放和文字标注。
你会拿到什么
- ✓兼容依赖升级、中文界面适配及真实业务验收的 Med3D 源码包
- ✓真实中文网格导入、显示与标注截图
- ✓部署入口、验证范围和遗留依赖限制说明
部署流程
- 1安装 Docker 与 Docker Compose，使用 Node.js 22 / MongoDB 8 的交付配置
- 2解压 verified-run-2981 修复源码包，执行 docker compose -f qingshen-compose.yaml up -d --build
- 3打开本地 /web/，导入非患者演示 OBJ 网格，检查三维显示、缩放和文字标注
- 4服务器资源需 MongoDB GridFS 与 Socket.IO 4；仅托管 docs 文档不能运行业务
- 5当前仅用于本地教学研究，公网或临床部署前需补齐残留依赖、认证与权限审查
真实验证结果
2026-09-28 修复版本 verified-run-2981 已走官方受保护发布；固定提交 f67e81de01ac81d6175dca234e3e241f2022fff7，兼容升级与中文适配 ZIP 经异目录 Docker 构建和真实 /web/ 操作复验。七张原始中文截图验证服务器 OBJ 选择、WebGL 加载、文字标注填写、保存、第二条标注和移除；本地 OBJ 导入、视角缩放与服务器重载关联场景亦通过，脚本异常为空。服务端 npm audit 为 0，浏览器 AngularJS/Bootstrap 残留漏洞限制仍明确保留。
部署前须知
上游停止维护；AngularJS 1.8.3 已 EOL 且存在未能通过兼容升级消除的安全公告，Bootstrap 3.4.1 仍存在已知 XSS 风险。服务端 Node.js 依赖审计 0 不代表浏览器或整套系统无漏洞。仅适合隔离本地教学研究；CT/MRI 临床影像格式、多人协作、认证与公网生产安全未完成验收。旧版本使用错误静态文档入口，应使用 verified-run-2981 修复版本。
部署难度
中等
最低配置
以部署说明和实际验证结果为准
开源许可证
BSD-2-Clause
最后验证
2026-09-28
技术栈
Node.jsMongoDBAngularJSWebGLSocket.IO
授权说明
已检测到原项目许可证文件：LICENSE；发布前仍需人工复核署名和商用边界。
Release notes
版本记录
3 个已发布版本
verified-run-2958
本地真实部署、网页探测与交付物整理通过，已完成 OSS 校验。
部署要求：真实业务部署需 Node.js 和 MongoDB；先启动数据库，再在 src_server 执行 node index.js，打开 /web/。该历史包的静态 Docker 部署说明需要替换，当前不构成完整业务部署验收。
已知问题：2026-09-28 复核：该历史版本使用静态适配器，原截图多数为 docs 中的 JSDoc/API 文档和源码页，不能证明 Med3D 业务功能通过。真实应用需 Node.js + MongoDB，入口 /web/；旧部署的静态托管不能替代数据库/API/协作服务。请使用 verified-run-2981 修复版本；该版本已完成兼容升级、中文适配及真实网格与标注复核。上游停止维护，旧依赖安装审计存在高危/严重漏洞，仅适合隔离研究，不应直接公网或临床生产使用。
verified-run-2406
本地真实部署、网页探测与交付物整理通过，已完成 OSS 校验。
部署要求：真实业务部署需 Node.js 和 MongoDB；先启动数据库，再在 src_server 执行 node index.js，打开 /web/。该历史包的静态 Docker 部署说明需要替换，当前不构成完整业务部署验收。
已知问题：2026-09-28 复核：该历史版本使用静态适配器，原截图多数为 docs 中的 JSDoc/API 文档和源码页，不能证明 Med3D 业务功能通过。真实应用需 Node.js + MongoDB，入口 /web/；旧部署的静态托管不能替代数据库/API/协作服务。请使用 verified-run-2981 修复版本；该版本已完成兼容升级、中文适配及真实网格与标注复核。上游停止维护，旧依赖安装审计存在高危/严重漏洞，仅适合隔离研究，不应直接公网或临床生产使用。
