📥 安装手册

开发手册 安装手册 使用手册

环境与系统要求

在开始部署和安装本项目之前，请确保您的计算机或服务器满足以下最低配置要求：

  • 硬件要求 (重要)：由于系统大量使用 WebGL 与 3D 渲染，请务必在一台支持硬件显卡加速的机器上运行，并确保在浏览器设置中开启了“使用硬件加速”。
  • 浏览器要求：建议使用最新版的 Google Chrome、Microsoft Edge。
  • 环境软件：Node.js v16.0 或更高版本 (针对 React 版)；Python 环境 (针对快速启动静态 Web 服务)。

静态 3D 资源版部署 (配套资源 目录)

重要安全限制警告： 切勿直接双击目录中的 .htm 文件运行！源码中的数字人体和无人机模块需要读取本地数十兆的 .glb 格式的 3D 模型文件。现代浏览器出于安全考虑 (CORS 跨源资源共享机制)，禁止在 file:// 协议下读取本地二进制模型资源。直接双击打开将导致模型不显示、黑屏或白屏。

正确的部署方法：必须使用本地 Web 服务器。

方法一：Python 快速服务器 (推荐)

  1. 确保电脑安装了 Python。
  2. 在终端（命令行）中进入 配套资源/ 主目录。
  3. 运行命令启动服务：python -m http.server 8000
  4. 在浏览器中访问 http://localhost:8000，再点击对应的演示案例。

方法二：Node.js 快速服务器

  1. 如果您更熟悉 Node，进入目录后，运行：npx http-server -p 8080
  2. 在浏览器中访问 http://localhost:8080 即可。

React 仿真版环境与依赖安装 (app 目录)

核心的“直肠前切除术 3D 仿真系统”位于 app 目录，您需要进行依赖安装：

1. 安装 Node.js

前往 Node.js 官网 下载并安装 LTS 版本。安装完成后，在终端验证：

node -v
npm -v

2. 安装项目依赖

打开终端，进入项目主目录：

cd [您的本地路径]\配套资源\app

运行安装命令，下载并构建 Three.js 和 React 相关的底层包：

npm install
网络提示： 如果安装过慢，建议切换至淘宝 npm 镜像：
npm config set registry https://registry.npmmirror.com

启动与生产打包 (app目录)

开发模式启动

依赖安装完成后，您可以启动本地开发服务器，它具有热模块替换（HMR）功能：

npm run dev

通常终端会提示一个本地地址，如 http://localhost:5173，在浏览器中打开此地址即可体验手术仿真面板。

生产环境打包部署

当您准备将项目部署到线上服务器时，需要先将其编译构建为静态资源：

npm run build

构建完成后，会在目录下生成一个 dist/ 文件夹。您只需将 dist/ 文件夹内的所有文件上传到您的 Web 服务器（如 Nginx）配置好路由即可。

常见问题与排错

问题：执行 npm install 时报错 node-gyp rebuild error
解答：这通常是因为缺少 C++ 编译环境。如果您在 Windows 上，请以管理员身份打开 PowerShell 并运行 npm install --global windows-build-tools，然后重新安装依赖。
问题：打开无人机或数字人体案例后，控制台大量标红“Fetch error”或“CORS”
解答：您违背了上述的 CORS 警告，试图使用直接双击 HTML 文件的形式加载资源。请使用 Python 或 Node.js 开启局域网服务器访问。