用途:当用户需要带 .glb 三维模型并配合 Morph 过渡的 .pptx 时使用。它是 morph-ppt 的扩展,沿用其命名、幽灵、设计与校验规则。
主要能力:在幻灯片中插入 GLB 模型,并通过跨页同名模型实现 Morph;可设置 x、y、width、height 位置尺寸,name 需跨页一致,roty 控制 Y 轴旋转、rotx 控制 X 轴倾斜、rotz 为 Z 轴滚转。附带配色方案、字体搭配、版式与视觉元素规则,以及模型尺寸层级与多种版式模式。
使用方式:需先安装 officecli。macOS/Linux 用 curl -fsSL https://d.officecli.ai/install.sh | bash,Windows 用 irm https://d.officecli.ai/install.ps1 | iex,随后用 officecli --version 验证。安装失败可从 https://github.com/iOfficeAI/OfficeCLI/releases 下载二进制。示例:officecli add deck.pptx '/slide[1]' --type 3dmodel --prop path=model.glb --prop 'name=!!model-hero' --prop x=16cm --prop y=1cm --prop width=16cm --prop height=16cm --prop roty=0。模型、PPTX 与构建脚本需放在同一目录。
限制:仅支持 .glb,其他格式需先转换;模型文件建议小于 50MB。不要克隆含 3D 模型的幻灯片,否则会产生重名冲突,应在每页用相同 name 独立添加新模型。不要手动设置或对 3D 变换参数使用 raw-set;meterPerModelUnit、preTrans、相机景深与位置由系统自动计算。脚本语法仅适用于 macOS/Linux,Windows 需改写为 PowerShell。视觉设计部分含正文最小 16pt、深色背景对比度、每张内容页需演讲者备注、每三页至少一个非文字视觉元素等硬性规则。模型来源、许可与具体下载步骤详见原文资料。