threejs-deployment

构建与交付

使用项目已安装的版本和现有架构。这些说明是对用户任务的补充，不授权进行无关更改或外部操作。

检查现有构建工具、托管目标、基础路径、浏览器要求和部署授权。遵循项目约定。即使发布需要后续授权，也要准备并验证构建。

确保 Three.js 和附加组件使用兼容的修订版本，并消除冲突实例。升级前验证对等依赖。仅包含必需的加载器和辅助工具，并在适用时对较重的可选路径进行延迟加载。检查构建产物，不要假设摇树优化已移除未使用代码。

通过适配构建的路径解析模型、纹理、解码器、工作线程和 WASM 的 URL。测试实际的嵌套基础路径，以及直接导航到应用路由的情况。提供正确的 MIME 类型；确认资源响应不是 HTML 回退页面。

为确实需要跨域的资源设置 CORS，并根据所选的工作线程／解码器配置设置所需的 CSP 指令。需要安全上下文的功能必须要求安全上下文。只有在实际的多线程／运行时功能有此要求时才启用跨域隔离；同时考虑其对第三方资源的影响。

为带内容哈希的资源使用不可变缓存，并为 HTML 和清单制定一致的更新策略。避免过期的 Service Worker 将新代码与旧解码器配对。根据产品要求处理离线和错误状态。

运行生产预览，并检查有代表性的资源、缓存行为、加载失败、备用设备和路由重新加载情况。仅在现有授权范围内发布，并且只有验证后才能报告部署 URL。

API 参考

请参阅官方文档，了解准确的签名和特定修订版本的行为。如果无法访问文档，请检查已安装的类型定义／源代码，并说明仍存在的任何不确定之处。