Composer 不能生成维护保养动画，它只是PHP依赖管理工具；实际需手动集成Three.js等前端库并编写JS控制模型状态、零件高亮、爆炸展开和步骤提示。
Composer 不能直接“利用动画展示维护保养流程”——它不解析步骤逻辑、不驱动交互式引导、也不生成带语音/标注的维修指引动画。所谓“手册配套动画”，实际是用 Composer 安装前端依赖（如 Three.js、GSAP、或定制化维修可视化库），再由你手写 JS 控制模型状态切换、零件高亮、爆炸展开和步骤提示。
维护保养动画 ≠ Composer 内置功能
很多人在搜索“Composer 维护保养动画”时，误以为它像 SolidWorks Composer 那样能导入 CAD、设爆炸路径、加文字气泡、导出带交互的 HTML。但这里的 Composer 是 PHP 的依赖管理工具，和 3D 可视化软件 完全无关。它不会读取.step 文件，不会渲染剖面，也不会响应“第3步：拧松M6螺栓”这样的语义指令。
常见错误现象：
- 执行
composer require acme/maintenance-viewer后页面空白——因为包只含 PHP 类，没提供前端资源路径 - 在 Blade 模板里写了
<div id="step-2"></div>，但没写 JS 初始化逻辑，导致动画根本不触发 - 误把 SolidWorks Composer 导出的 .avi 视频文件当成可交互内容，嵌入网页后只能播放，无法跳转步骤或点击查看零件详情
真正需要安装的 Composer 包，只负责“交付静态资源”
如果你的维护手册是基于 Laravel 或 Symfony 构建的 Web 应用，Composer 的作用仅限于把前端依赖拉到 vendor/，再通过自定义脚本复制进 public/ 目录。它不参与运行时控制。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 选包前确认是否含
dist/目录：比如acme/maintenance-3d-player应提供dist/bundle.js和dist/style.css，否则只是个空壳 - 在
composer.json中声明 post-install-cmd 脚本："post-install-cmd": ["php scripts/copy-maintenance-assets.php"]，该脚本负责把vendor/acme/maintenance-3d-player/dist/*复制到public/js/maintenance/ - 不要在 Blade 中直接
@include('maintenance::player')——除非该包明确支持 Laravel View Components；更稳妥的是手动引入：<script src="{{ mix('js/maintenance/bundle.js') }}"></script>
前端必须自己实现的 4 类核心逻辑
即使 Composer 把所有 JS/CSS 都装好了，以下逻辑仍需你手写，且极易出错：
-
步骤同步：点击“步骤4”时，不仅要高亮对应零件，还要调用
model.setExplode(0.3)、camera.flyTo(partA.position)、tooltip.show("使用扭矩扳手，拧紧至15N·m") -
状态持久化：用户关闭页面再打开，应恢复上次看到的步骤——需用
localStorage.setItem('currentStep', '5')，并在初始化时读取 -
离线可用：维修现场常无网络，所有模型文件（.glb）、贴图、音频必须提前下载并缓存；
service-worker.js不能只缓存 HTML -
轻量化适配：老款车间平板显存有限，需检测
renderer.capabilities.isWebGL2Available，自动降级为线框模式或预渲染帧序列
导出与部署时最常被忽略的兼容性点
你以为动画在本地 Chrome 跑通就结束了？实际在车间终端上可能全黑屏或卡死：
- 国产信创设备（如麒麟 OS + 鲲鹏 CPU）多数不支持 WebGL2，必须 fallback 到
CSS 3D transforms或静态 SVG 步骤图 - 内网 PPT 嵌入需求：若需插入 PowerPoint，不能依赖
<iframe>，得导出为 .wmv（H.264 不被旧版 Office 支持），用ffmpeg -i input.mp4 -c:v wmv2 -c:a wmav2 output.wmv - PDF 手册嵌入：Acrobat 只支持 Flash（已淘汰）或 PDF 3D（仅 Adobe 自家格式），通用解法是每步截一张高清 PNG，用 LaTeX 生成带缩放的矢量 PDF
真正难的不是让第1步动起来，而是让第12步在断网、低配、无 GPU 的环境下仍能准确指示“右侧散热风扇卡扣位置”，这要求你绕过 Composer 的抽象层，直面 THREE.js 的 BufferGeometry.attributes.position.array 做坐标映射——而 Composer 连这个数组在哪都不知道。
