Web 端 3D 查看器部署：让客户在浏览器里转模型

很多项目需要给客户展示 3D 模型，客户不想装软件，最好的形态就是一个网页。我把部署过程写下来。

技术选型上，Three.js 是默认答案，生态成熟、文档齐全、社区问题都能搜到。如果只需要展示不需要交互逻辑，也可以考虑模型查看器组件，省掉自己写轨道控制器的功夫。

功能清单按优先级排：
第一，加载。支持拖拽本地文件直接查看，这个功能对内部评审特别有用，美术导出一个模型可以直接拖进去看。
第二，相机控制。轨道旋转、缩放、平移，加上视角预设（前视、顶视、等轴）。
第三，环境与光照。提供几套预设的 HDRI 环境，金属和玻璃材质没有环境光照会显得很假。
第四，材质切换。线框模式、法线可视化、贴图开关，这些对排查模型问题很实用。
第五，截图与标注。客户看完能直接圈出问题，比用语言描述有效得多。

部署上要注意的几点：
一，模型文件走静态资源服务，配好 CORS，如果跨域加载要注意响应头。
二，大模型开启 gzip 或 brotli 压缩，glTF 是文本格式，压缩比很高。
三，注意移动端性能，手机 GPU 的显存和带宽和桌面差得远，贴图尺寸要做上限控制。
四，加加载进度提示，几 MB 的文件在弱网下要等很久，没有反馈用户会以为坏了。

关于 agent：Claude Code 适合写完整的查看器工程，包括构建配置和部署脚本，一次成型。MiMo Desktop 适合做交互细节的迭代，因为查看器的问题几乎都是"看起来不对"，在实时预览里圈一下就改，比文字描述高效得多。

一个实际经验：给客户用的查看器，第一版功能少一点没关系，但加载速度和控制手感一定要好。这两个决定了客户愿不愿意继续用。