CLIAI 应用MCP 服务【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址https://gitcode.com/GitHub_Trending/of/OfficeCLI点击查看免费下载本文以 examples/ppt/transitions/transitions-morph.md 为核心文档系统讲解 OfficeCLIPowerPoint 2016 的 Morph 平滑切换的三种粒度选项、形状配对机制与降级兼容策略并给出可复现的 Shell / Python 完整示例与底层 OOXML 实现证据。读完本文你将能用officecli set --prop transitionmorph[-byword|-bychar]为幻灯片装配平滑补间动画并能借助officecli的批量接口、查询与诊断命令对生成文件进行校验与调试。Morph 是什么PowerPoint 2016 的平滑补间切换Morph平滑切换是 Office 2016 起引入的过渡动画两张相邻幻灯片上名称相同或按 OOXML 配对规则匹配的对象其位置、尺寸、旋转、颜色等几何属性会被 PowerPoint 自动插值tween为连续的运动而不是生硬的翻页。它特别适合产品发布、方案演示、信息分镜等需要“同一元素穿越幻灯片”的场景。OfficeCLI 仓库中提供了examples/ppt/transitions/transitions-morph.md、transitions-morph.sh与transitions-morph.py三份配套文件共同产出一个 4 页演示稿transitions-morph.pptx一次性覆盖 Morph 的三种补间粒度morph默认byobject——按命名形状对整体补间几何属性morph-byword——文本按单词逐词重组morph-bychar——文本按字符逐字重组。对应的完整可运行脚本位于 examples/ppt/transitions/transitions-morph.shPython SDK 等价实现位于 examples/ppt/transitions/transitions-morph.py。重新生成演示稿文档给出了最简单的复现方式进入示例目录运行 Shell 脚本即可得到transitions-morph.pptx。cd examples/ppt/transitions bash transitions-morph.sh # → transitions-morph.pptxtransitions-morph.sh内部的执行顺序见 examples/ppt/transitions/transitions-morph.sh为officecli create $PPTX # 新建文件 officecli open $PPTX # 打开启动常驻会话 # …逐页 add slide / add shape / set transition… officecli close $PPTX # 关闭 officecli validate $PPTX # 校验生成的 OOXML一个值得注意的工程细节该脚本刻意不使用set -e。脚本头注释说明这是为了“容忍前向兼容的UNSUPPORTED props警告officecli 退出码 2”从而保证整份文档始终被完整构建出来。在自动化流水线中建议对 officecli 的“警告但不失败”语义有预期再决定是否在脚本外层做严格退出码判断。四张幻灯片的逐页拆解演示稿由 4 页构成第 1 页是“起点”无过渡第 24 页分别演示三种 Morph 粒度贯穿始终的是一个被命名为morphBall的黄色椭圆——它在 4 页之间不断改变位置与大小形成可见的补间动画。Slide 1起点无过渡第 1 页建立整组动画的“入口”全幅深蓝背景1F3864、大号标题 Morph以及位于左下角的小圆morphBall。officecli add transitions-morph.pptx / --type slide # 全幅深色背景 officecli add transitions-morph.pptx /slide[1] --type shape \ --prop x0 --prop y0 --prop width33.87cm --prop height19.05cm \ --prop fill1F3864 # 标题文本 officecli add transitions-morph.pptx /slide[1] --type shape \ --prop textMorph --prop size72 --prop boldtrue --prop colorFFFFFF \ --prop aligncenter \ --prop x2cm --prop y7cm --prop width29.87cm --prop height4cm # 命名 Morph 目标——左下角的小圆 # name 是配对键14 页同名 → PowerPoint 对其做补间 officecli add transitions-morph.pptx /slide[1] --type shape \ --prop shapeellipse --prop fillFFC000 --prop namemorphBall \ --prop x2cm --prop y14cm --prop width3cm --prop height3cm关键特性namemorphBall配对键、shapeellipse、fillFFC000。这里选用--type shape加--prop shapeellipse的写法来生成显式椭圆。页面尺寸固定为 33.87cm × 19.05cm16:9后续各页背景与文本都沿用同一几何基准。Slide 2morph默认 byobject第 2 页开启 Morph小球移动到页面中央并放大。因为morphBall在第 1 页与第 2 页同名PowerPoint 会把它当作同一对象的两个状态从而自动补间几何变化。officecli add transitions-morph.pptx / --type slide officecli set transitions-morph.pptx /slide[2] --prop transitionmorph officecli add transitions-morph.pptx /slide[2] --type shape \ --prop x0 --prop y0 --prop width33.87cm --prop height19.05cm \ --prop fill2E5C8A officecli add transitions-morph.pptx /slide[2] --type shape \ --prop textmorph (byobject — default) --prop size44 --prop boldtrue \ --prop colorFFFFFF --prop aligncenter \ --prop x2cm --prop y2cm --prop width29.87cm --prop height3cm # 同名、更大且居中 → 小球通过 morph 放大 移动 officecli add transitions-morph.pptx /slide[2] --type shape \ --prop shapeellipse --prop fillFFC000 --prop namemorphBall \ --prop x15cm --prop y10cm --prop width6cm --prop height6cm关键特性transitionmorph默认即为 byobject 粒度。注意背景色由1F3864变为2E5C8A演示背景也能平滑过渡文本行注明“byobject — default”。Slide 3morph-byword第 3 页切换为逐词补间文本主体会按单词逐个重组形成文字“飞行”效果。officecli add transitions-morph.pptx / --type slide officecli set transitions-morph.pptx /slide[3] --prop transitionmorph-byword officecli add transitions-morph.pptx /slide[3] --type shape \ --prop x0 --prop y0 --prop width33.87cm --prop height19.05cm \ --prop fill4F7C3A officecli add transitions-morph.pptx /slide[3] --type shape \ --prop textmorph byword tweens words --prop size44 --prop boldtrue \ --prop colorFFFFFF --prop aligncenter \ --prop x2cm --prop y2cm --prop width29.87cm --prop height3cm # 小球继续运动——此时在右侧恢复小尺寸 officecli add transitions-morph.pptx /slide[3] --type shape \ --prop shapeellipse --prop fillFFC000 --prop namemorphBall \ --prop x27cm --prop y14cm --prop width3cm --prop height3cm关键特性transitionmorph-byword。文本字符串为 morph byword tweens words正是为了展示逐词重组小球从“中央 6cm”变为“右侧 3cm”几何补间与逐词补间同屏演示。Slide 4morph-bychar第 4 页切换为逐字符补间文本主体按字母逐个重组。officecli add transitions-morph.pptx / --type slide officecli set transitions-morph.pptx /slide[4] --prop transitionmorph-bychar officecli add transitions-morph.pptx /slide[4] --type shape \ --prop x0 --prop y0 --prop width33.87cm --prop height19.05cm \ --prop fill8A5A2B officecli add transitions-morph.pptx /slide[4] --type shape \ --prop textbychar tweens letters --prop size44 --prop boldtrue \ --prop colorFFFFFF --prop aligncenter \ --prop x2cm --prop y2cm --prop width29.87cm --prop height3cm # 小球回到中央中等大小 officecli add transitions-morph.pptx /slide[4] --type shape \ --prop shapeellipse --prop fillFFC000 --prop namemorphBall \ --prop x14cm --prop y14cm --prop width4cm --prop height4cm关键特性transitionmorph-bychar。文本 bychar tweens letters 突出逐字补间小球“右侧小圆”回到“中央 4cm”至此 4 页首尾呼应动画闭环。三种粒度总览与别名原文档用一张总表完整列出三种 Morph 粒度及其语法与补间层级OptionSyntaxTweens at the level ofbyobject (default)transitionmorphWhole shape pairs (matched by name)bywordtransitionmorph-bywordWhole words within text bodiesbychartransitionmorph-bycharIndividual characters within text bodies输入别名同样被接受object/word/char/character。get返回时输出规范形式byObject/byWord/byChar。在源码层OfficeCLI 对 Morph 选项的解析位于 src/officecli/Handlers/Pptx/PowerPointHandler.Animations.csvar morphOption (direction ?? byobject).ToLowerInvariant() switch { byword or word byWord, bychar or char or character byChar, byobject or object byObject, _ throw new ArgumentException($Invalid morph option: {direction}. Valid values: byObject, byWord, byChar.) };这段代码表明默认方向为byobjectword/char/character是额外接受的别名非法值会直接抛出ArgumentException而非静默降级。同时morph在这些方向别名 token 的“已知方向集合”里也有登记PowerPointHandler.Animations.cs说明 Morph 选项的 token 解析与方向 token 解析是同一套输入通道用户在transitionmorph-byword这样的连字符语法中填写的是“方向/选项”位置。形状配对机制为什么name是 Morph 的命门Morph 的核心是配对相邻两张幻灯片上名称相同的形状PowerPoint 将其视为同一对象的两帧并补间几何没有匹配名称的形状则各自独立淡入淡出。原文档给出了最小可复现的双页示例# 第 N 页的形状小、左下角 officecli add deck.pptx /slide[1] --type shape \ --prop shapeellipse --prop namemorphBall \ --prop x2cm --prop y14cm --prop width3cm --prop height3cm # 第 N1 页的形状更大、居中 → morph 自动补间这一变化 officecli set deck.pptx /slide[2] --prop transitionmorph officecli add deck.pptx /slide[2] --type shape \ --prop shapeellipse --prop namemorphBall \ --prop x15cm --prop y10cm --prop width6cm --prop height6cm在 OfficeCLI 源码中这一机制有两层保障!!前缀自动注入AutoPrefixMorphNames。为兼容 PowerPoint 的 OOXML 匹配规则OfficeCLI 在给某页设置 Morph 后会自动给“当前页 前一页”上所有非默认命名跳过TextBox N、Content N等自动命名的形状名加上!!前缀使文本内容不同的形状也能按名称匹配见 src/officecli/Handlers/Pptx/PowerPointHandler.Animations.cs。当transition属性被移除时对称地执行AutoUnprefixMorphNames撤销前缀并谨慎地跳过仍处于 Morph 上下文的页面PowerPointHandler.Animations.cs。添加形状时的上下文感知。在PowerPointHandler.Add.Shape中当目标页或其下一页处于 Morph 上下文SlideHasMorphContext时新形状名称会自动加上!!前缀保证 Morph 连续性——该前缀逻辑仅作用于幻灯片级形状母版/版式形状不参与页间补间见 src/officecli/Handlers/Pptx/PowerPointHandler.Add.Shape.cs。set路径的同款处理。PowerPointHandler.Set.Slide中对transition属性赋值时若值以morph开头则调用AutoPrefixMorphNames否则调用AutoUnprefixMorphNamesPowerPointHandler.Set.Slide.cs。这意味着无论你是先加形状后设 Morph还是先设 Morph 后加形状配对键都能被正确建立。实践提示由于name是配对键请避免在相邻 Morph 页上让多个形状共用同一名称否则 PowerPoint 的配对结果可能不符合预期。降级兼容老版本 PowerPoint 下的淡入淡出兜底原文档指出OfficeCLI 写入 Morph 时内置了一个内联淡入淡出回退inline fade fallbackPowerPoint 2016 之前的版本无法解析 Morph会播放回退的 fade因此文件在任何版本下都能正常打开。其 OOXML 实现是标准的mc:AlternateContent包裹结构。在 src/officecli/Handlers/Pptx/PowerPointHandler.Animations.cs 的InsertTransitionWithMcWrapper中可以看到完整结构mc:AlternateContent ├── mc:Choice[Requiresp159] # 新版本分支p:transitionp159:morph option…//p:transition └── mc:Fallback # 老版本分支p:transitionp:fade//p:transition其中p159命名空间为http://schemas.microsoft.com/office/powerpoint/2015/09/mainMorph 元素通过OpenXmlUnknownElement以原始 XML 形式写入并携带option属性byObject/byWord/byChar见 PowerPointHandler.Animations.cs。这一“新特性 旧版回退”的双分支模式在 Pptx 批处理重放时同样被保留PptxBatchEmitter明确提到 Morph、p14/p15 等“外来”过渡无法被 SDK 类型化对象完整重建因此保留mc:AlternateContent的原始结构src/officecli/Handlers/Pptx/PptxBatchEmitter.cs、PptxBatchEmitter.cs。advanceTime与advanceOnClick对 Morph 也做了专门处理它们会先检测包住p:transition的mc:AlternateContent不仅限 Morph还包括 p14/p15 过渡原地修改属性而不是追加第二个裸的p:transition兄弟节点——后者会被 PowerPoint 以 0x80070570 拒绝见 src/officecli/Handlers/Pptx/PowerPointHandler.Helpers.Transition.cs。检查生成的 PPTXquery / get / morph-check原文档给出了三组检查命令officecli query transitions-morph.pptx slide officecli get transitions-morph.pptx /slide[1] officecli get transitions-morph.pptx /slide[2] officecli get transitions-morph.pptx /slide[2]/shape[3]query … slide列出全部幻灯片及其属性get … /slide[1]、/slide[2]读取整页内容get … /slide[2]/shape[3]精确定位第 2 页第 3 个形状即补间中的morphBall。此外 OfficeCLI 还提供一条 Morph 专用诊断命令/morph-check入口在 src/officecli/Handlers/Pptx/PowerPointHandler.Query.cs实现在 src/officecli/Handlers/Pptx/PowerPointHandler.Theme.cs它会扫描全部幻灯片按“!!前缀名称”找出 Morph 候选形状逐页报告matched与下一页同名配对成功与unmatched未能配对并给出from→to的源/目标路径以及morphModebyObject/byWord/byChar。当没有可配对的!!形状时它返回提示“No morph-eligible shapes found (name shapes with !! prefix)”——这是排查“Morph 没动起来”的首选工具。Python SDK 等价实现单次 batch 往返构建整份文稿除了 Shell 脚本仓库还提供了 Python SDK 版本 examples/ppt/transitions/transitions-morph.py。它演示了 officecli 的批量写入模式启动一个常驻进程把全部页/形状/过渡打包进一次doc.batch(...)往返每个条目都是与officecli batch列表同构的{command,parent/path,type,props}字典。import officecli # pip install officecli-sdk或回退到仓库内 sdk/python 副本 FILE transitions-morph.pptx def slide(): # 一个“add slide”批处理条目 return {command: add, parent: /, type: slide} def shape(parent, **props): # 一个“add shape”批处理条目 return {command: add, parent: parent, type: shape, props: props} def transition(path, kind): # 一个“set”批处理条目 return {command: set, path: path, props: {transition: kind}} with officecli.create(FILE, --force) as doc: items [ slide(), shape(/slide[1], x0, y0, width33.87cm, height19.05cm, fill1F3864), shape(/slide[1], textMorph, size72, boldtrue, colorFFFFFF, aligncenter, x2cm, y7cm, width29.87cm, height4cm), shape(/slide[1], shapeellipse, fillFFC000, namemorphBall, x2cm, y14cm, width3cm, height3cm), slide(), transition(/slide[2], morph), # …后续页省略完整列表见 transitions-morph.py… ] doc.batch(items)运行方式pip install officecli-sdk # 另需 officecli 二进制在 PATH 上 python3 examples/ppt/transitions/transitions-morph.py脚本头部注释明确说明它与transitions-morph.sh是“SDK 孪生”产出等价的transitions-morph.pptx。与 Shell 版“容忍前向兼容警告”的思路一致批量模式同样能容忍UNSUPPORTED props警告而完整成文。选择哪种形态取决于你的构建环境Shell 脚本适合命令行流水线Python SDK 适合在 CI/编排代码里以数据结构驱动生成。更多 Morph 应用与关联文档原文档的 Related 章节指向两个延伸资源examples/product_launch_morph.pptx——以 Morph 为主运动的产品发布会全案演示稿位于仓库根目录 examples 下可作为场景级scene-levelMorph 用法的进阶参考examples/ppt/transitions/transitions-dynamic.md——Office 2010 Exciting 动效库vortex、switch、flip、prism、rotate、orbit、doors 等方向家族是独立于 Morph 的另一条代码路径。两者形成互补Morph 走mc:AlternateContentp159:morph的独立实现动态过渡走p15:prstTrans/p14:*家族它们的共性在于都依赖mc:AlternateContent的旧版回退机制这也正是 OfficeCLI 能将“新特性、旧兼容”同时写入同一份 .pptx 的关键设计。赞分享CLIAI 应用MCP 服务【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址https://gitcode.com/GitHub_Trending/of/OfficeCLI点击查看免费下载相关推荐OfficeCLI 实战指南用 Morph 平滑切换为 PPT 注入电影级过渡动画PowerPoint 2016OfficeCLI 实战指南用 Morph 平滑切换为 PPT 注入电影级过渡动画PowerPoint 2016 导读 Morph变形是 Power人工智能AI 应用AI 技能CLIMCP 服务Quasar v-morph 指令完全指南在 Vue 组件间实现丝滑的 DOM 形变过渡动画Quasar v morph 指令完全指南在 Vue 组件间实现丝滑的 DOM 形变过渡动画 导读 v morph 是 Quasar Framework 提供前端UI组件跨平台OfficeCLI Morph-PPT 风格实战warm--sunset-mosaic 落日马赛克企业渐变风设计指南OfficeCLI Morph PPT 风格实战warm sunset mosaic 落日马赛克企业渐变风设计指南 本指南以 morph ppt 技能库中 w人工智能AI 应用AI 技能CLIMCP 服务上一篇Video2X三步实现AI视频画质修复与流畅度提升的完整指南下一篇如何永久保存微信聊天记录WeChatMsg免费工具完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OfficeCLI 渐变切换（Morph）实战指南：用命名形状在 PPT 中实现平滑补间动画
CLIAI 应用MCP 服务【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址https://gitcode.com/GitHub_Trending/of/OfficeCLI点击查看免费下载本文以 examples/ppt/transitions/transitions-morph.md 为核心文档系统讲解 OfficeCLIPowerPoint 2016 的 Morph 平滑切换的三种粒度选项、形状配对机制与降级兼容策略并给出可复现的 Shell / Python 完整示例与底层 OOXML 实现证据。读完本文你将能用officecli set --prop transitionmorph[-byword|-bychar]为幻灯片装配平滑补间动画并能借助officecli的批量接口、查询与诊断命令对生成文件进行校验与调试。Morph 是什么PowerPoint 2016 的平滑补间切换Morph平滑切换是 Office 2016 起引入的过渡动画两张相邻幻灯片上名称相同或按 OOXML 配对规则匹配的对象其位置、尺寸、旋转、颜色等几何属性会被 PowerPoint 自动插值tween为连续的运动而不是生硬的翻页。它特别适合产品发布、方案演示、信息分镜等需要“同一元素穿越幻灯片”的场景。OfficeCLI 仓库中提供了examples/ppt/transitions/transitions-morph.md、transitions-morph.sh与transitions-morph.py三份配套文件共同产出一个 4 页演示稿transitions-morph.pptx一次性覆盖 Morph 的三种补间粒度morph默认byobject——按命名形状对整体补间几何属性morph-byword——文本按单词逐词重组morph-bychar——文本按字符逐字重组。对应的完整可运行脚本位于 examples/ppt/transitions/transitions-morph.shPython SDK 等价实现位于 examples/ppt/transitions/transitions-morph.py。重新生成演示稿文档给出了最简单的复现方式进入示例目录运行 Shell 脚本即可得到transitions-morph.pptx。cd examples/ppt/transitions bash transitions-morph.sh # → transitions-morph.pptxtransitions-morph.sh内部的执行顺序见 examples/ppt/transitions/transitions-morph.sh为officecli create $PPTX # 新建文件 officecli open $PPTX # 打开启动常驻会话 # …逐页 add slide / add shape / set transition… officecli close $PPTX # 关闭 officecli validate $PPTX # 校验生成的 OOXML一个值得注意的工程细节该脚本刻意不使用set -e。脚本头注释说明这是为了“容忍前向兼容的UNSUPPORTED props警告officecli 退出码 2”从而保证整份文档始终被完整构建出来。在自动化流水线中建议对 officecli 的“警告但不失败”语义有预期再决定是否在脚本外层做严格退出码判断。四张幻灯片的逐页拆解演示稿由 4 页构成第 1 页是“起点”无过渡第 24 页分别演示三种 Morph 粒度贯穿始终的是一个被命名为morphBall的黄色椭圆——它在 4 页之间不断改变位置与大小形成可见的补间动画。Slide 1起点无过渡第 1 页建立整组动画的“入口”全幅深蓝背景1F3864、大号标题 Morph以及位于左下角的小圆morphBall。officecli add transitions-morph.pptx / --type slide # 全幅深色背景 officecli add transitions-morph.pptx /slide[1] --type shape \ --prop x0 --prop y0 --prop width33.87cm --prop height19.05cm \ --prop fill1F3864 # 标题文本 officecli add transitions-morph.pptx /slide[1] --type shape \ --prop textMorph --prop size72 --prop boldtrue --prop colorFFFFFF \ --prop aligncenter \ --prop x2cm --prop y7cm --prop width29.87cm --prop height4cm # 命名 Morph 目标——左下角的小圆 # name 是配对键14 页同名 → PowerPoint 对其做补间 officecli add transitions-morph.pptx /slide[1] --type shape \ --prop shapeellipse --prop fillFFC000 --prop namemorphBall \ --prop x2cm --prop y14cm --prop width3cm --prop height3cm关键特性namemorphBall配对键、shapeellipse、fillFFC000。这里选用--type shape加--prop shapeellipse的写法来生成显式椭圆。页面尺寸固定为 33.87cm × 19.05cm16:9后续各页背景与文本都沿用同一几何基准。Slide 2morph默认 byobject第 2 页开启 Morph小球移动到页面中央并放大。因为morphBall在第 1 页与第 2 页同名PowerPoint 会把它当作同一对象的两个状态从而自动补间几何变化。officecli add transitions-morph.pptx / --type slide officecli set transitions-morph.pptx /slide[2] --prop transitionmorph officecli add transitions-morph.pptx /slide[2] --type shape \ --prop x0 --prop y0 --prop width33.87cm --prop height19.05cm \ --prop fill2E5C8A officecli add transitions-morph.pptx /slide[2] --type shape \ --prop textmorph (byobject — default) --prop size44 --prop boldtrue \ --prop colorFFFFFF --prop aligncenter \ --prop x2cm --prop y2cm --prop width29.87cm --prop height3cm # 同名、更大且居中 → 小球通过 morph 放大 移动 officecli add transitions-morph.pptx /slide[2] --type shape \ --prop shapeellipse --prop fillFFC000 --prop namemorphBall \ --prop x15cm --prop y10cm --prop width6cm --prop height6cm关键特性transitionmorph默认即为 byobject 粒度。注意背景色由1F3864变为2E5C8A演示背景也能平滑过渡文本行注明“byobject — default”。Slide 3morph-byword第 3 页切换为逐词补间文本主体会按单词逐个重组形成文字“飞行”效果。officecli add transitions-morph.pptx / --type slide officecli set transitions-morph.pptx /slide[3] --prop transitionmorph-byword officecli add transitions-morph.pptx /slide[3] --type shape \ --prop x0 --prop y0 --prop width33.87cm --prop height19.05cm \ --prop fill4F7C3A officecli add transitions-morph.pptx /slide[3] --type shape \ --prop textmorph byword tweens words --prop size44 --prop boldtrue \ --prop colorFFFFFF --prop aligncenter \ --prop x2cm --prop y2cm --prop width29.87cm --prop height3cm # 小球继续运动——此时在右侧恢复小尺寸 officecli add transitions-morph.pptx /slide[3] --type shape \ --prop shapeellipse --prop fillFFC000 --prop namemorphBall \ --prop x27cm --prop y14cm --prop width3cm --prop height3cm关键特性transitionmorph-byword。文本字符串为 morph byword tweens words正是为了展示逐词重组小球从“中央 6cm”变为“右侧 3cm”几何补间与逐词补间同屏演示。Slide 4morph-bychar第 4 页切换为逐字符补间文本主体按字母逐个重组。officecli add transitions-morph.pptx / --type slide officecli set transitions-morph.pptx /slide[4] --prop transitionmorph-bychar officecli add transitions-morph.pptx /slide[4] --type shape \ --prop x0 --prop y0 --prop width33.87cm --prop height19.05cm \ --prop fill8A5A2B officecli add transitions-morph.pptx /slide[4] --type shape \ --prop textbychar tweens letters --prop size44 --prop boldtrue \ --prop colorFFFFFF --prop aligncenter \ --prop x2cm --prop y2cm --prop width29.87cm --prop height3cm # 小球回到中央中等大小 officecli add transitions-morph.pptx /slide[4] --type shape \ --prop shapeellipse --prop fillFFC000 --prop namemorphBall \ --prop x14cm --prop y14cm --prop width4cm --prop height4cm关键特性transitionmorph-bychar。文本 bychar tweens letters 突出逐字补间小球“右侧小圆”回到“中央 4cm”至此 4 页首尾呼应动画闭环。三种粒度总览与别名原文档用一张总表完整列出三种 Morph 粒度及其语法与补间层级OptionSyntaxTweens at the level ofbyobject (default)transitionmorphWhole shape pairs (matched by name)bywordtransitionmorph-bywordWhole words within text bodiesbychartransitionmorph-bycharIndividual characters within text bodies输入别名同样被接受object/word/char/character。get返回时输出规范形式byObject/byWord/byChar。在源码层OfficeCLI 对 Morph 选项的解析位于 src/officecli/Handlers/Pptx/PowerPointHandler.Animations.csvar morphOption (direction ?? byobject).ToLowerInvariant() switch { byword or word byWord, bychar or char or character byChar, byobject or object byObject, _ throw new ArgumentException($Invalid morph option: {direction}. Valid values: byObject, byWord, byChar.) };这段代码表明默认方向为byobjectword/char/character是额外接受的别名非法值会直接抛出ArgumentException而非静默降级。同时morph在这些方向别名 token 的“已知方向集合”里也有登记PowerPointHandler.Animations.cs说明 Morph 选项的 token 解析与方向 token 解析是同一套输入通道用户在transitionmorph-byword这样的连字符语法中填写的是“方向/选项”位置。形状配对机制为什么name是 Morph 的命门Morph 的核心是配对相邻两张幻灯片上名称相同的形状PowerPoint 将其视为同一对象的两帧并补间几何没有匹配名称的形状则各自独立淡入淡出。原文档给出了最小可复现的双页示例# 第 N 页的形状小、左下角 officecli add deck.pptx /slide[1] --type shape \ --prop shapeellipse --prop namemorphBall \ --prop x2cm --prop y14cm --prop width3cm --prop height3cm # 第 N1 页的形状更大、居中 → morph 自动补间这一变化 officecli set deck.pptx /slide[2] --prop transitionmorph officecli add deck.pptx /slide[2] --type shape \ --prop shapeellipse --prop namemorphBall \ --prop x15cm --prop y10cm --prop width6cm --prop height6cm在 OfficeCLI 源码中这一机制有两层保障!!前缀自动注入AutoPrefixMorphNames。为兼容 PowerPoint 的 OOXML 匹配规则OfficeCLI 在给某页设置 Morph 后会自动给“当前页 前一页”上所有非默认命名跳过TextBox N、Content N等自动命名的形状名加上!!前缀使文本内容不同的形状也能按名称匹配见 src/officecli/Handlers/Pptx/PowerPointHandler.Animations.cs。当transition属性被移除时对称地执行AutoUnprefixMorphNames撤销前缀并谨慎地跳过仍处于 Morph 上下文的页面PowerPointHandler.Animations.cs。添加形状时的上下文感知。在PowerPointHandler.Add.Shape中当目标页或其下一页处于 Morph 上下文SlideHasMorphContext时新形状名称会自动加上!!前缀保证 Morph 连续性——该前缀逻辑仅作用于幻灯片级形状母版/版式形状不参与页间补间见 src/officecli/Handlers/Pptx/PowerPointHandler.Add.Shape.cs。set路径的同款处理。PowerPointHandler.Set.Slide中对transition属性赋值时若值以morph开头则调用AutoPrefixMorphNames否则调用AutoUnprefixMorphNamesPowerPointHandler.Set.Slide.cs。这意味着无论你是先加形状后设 Morph还是先设 Morph 后加形状配对键都能被正确建立。实践提示由于name是配对键请避免在相邻 Morph 页上让多个形状共用同一名称否则 PowerPoint 的配对结果可能不符合预期。降级兼容老版本 PowerPoint 下的淡入淡出兜底原文档指出OfficeCLI 写入 Morph 时内置了一个内联淡入淡出回退inline fade fallbackPowerPoint 2016 之前的版本无法解析 Morph会播放回退的 fade因此文件在任何版本下都能正常打开。其 OOXML 实现是标准的mc:AlternateContent包裹结构。在 src/officecli/Handlers/Pptx/PowerPointHandler.Animations.cs 的InsertTransitionWithMcWrapper中可以看到完整结构mc:AlternateContent ├── mc:Choice[Requiresp159] # 新版本分支p:transitionp159:morph option…//p:transition └── mc:Fallback # 老版本分支p:transitionp:fade//p:transition其中p159命名空间为http://schemas.microsoft.com/office/powerpoint/2015/09/mainMorph 元素通过OpenXmlUnknownElement以原始 XML 形式写入并携带option属性byObject/byWord/byChar见 PowerPointHandler.Animations.cs。这一“新特性 旧版回退”的双分支模式在 Pptx 批处理重放时同样被保留PptxBatchEmitter明确提到 Morph、p14/p15 等“外来”过渡无法被 SDK 类型化对象完整重建因此保留mc:AlternateContent的原始结构src/officecli/Handlers/Pptx/PptxBatchEmitter.cs、PptxBatchEmitter.cs。advanceTime与advanceOnClick对 Morph 也做了专门处理它们会先检测包住p:transition的mc:AlternateContent不仅限 Morph还包括 p14/p15 过渡原地修改属性而不是追加第二个裸的p:transition兄弟节点——后者会被 PowerPoint 以 0x80070570 拒绝见 src/officecli/Handlers/Pptx/PowerPointHandler.Helpers.Transition.cs。检查生成的 PPTXquery / get / morph-check原文档给出了三组检查命令officecli query transitions-morph.pptx slide officecli get transitions-morph.pptx /slide[1] officecli get transitions-morph.pptx /slide[2] officecli get transitions-morph.pptx /slide[2]/shape[3]query … slide列出全部幻灯片及其属性get … /slide[1]、/slide[2]读取整页内容get … /slide[2]/shape[3]精确定位第 2 页第 3 个形状即补间中的morphBall。此外 OfficeCLI 还提供一条 Morph 专用诊断命令/morph-check入口在 src/officecli/Handlers/Pptx/PowerPointHandler.Query.cs实现在 src/officecli/Handlers/Pptx/PowerPointHandler.Theme.cs它会扫描全部幻灯片按“!!前缀名称”找出 Morph 候选形状逐页报告matched与下一页同名配对成功与unmatched未能配对并给出from→to的源/目标路径以及morphModebyObject/byWord/byChar。当没有可配对的!!形状时它返回提示“No morph-eligible shapes found (name shapes with !! prefix)”——这是排查“Morph 没动起来”的首选工具。Python SDK 等价实现单次 batch 往返构建整份文稿除了 Shell 脚本仓库还提供了 Python SDK 版本 examples/ppt/transitions/transitions-morph.py。它演示了 officecli 的批量写入模式启动一个常驻进程把全部页/形状/过渡打包进一次doc.batch(...)往返每个条目都是与officecli batch列表同构的{command,parent/path,type,props}字典。import officecli # pip install officecli-sdk或回退到仓库内 sdk/python 副本 FILE transitions-morph.pptx def slide(): # 一个“add slide”批处理条目 return {command: add, parent: /, type: slide} def shape(parent, **props): # 一个“add shape”批处理条目 return {command: add, parent: parent, type: shape, props: props} def transition(path, kind): # 一个“set”批处理条目 return {command: set, path: path, props: {transition: kind}} with officecli.create(FILE, --force) as doc: items [ slide(), shape(/slide[1], x0, y0, width33.87cm, height19.05cm, fill1F3864), shape(/slide[1], textMorph, size72, boldtrue, colorFFFFFF, aligncenter, x2cm, y7cm, width29.87cm, height4cm), shape(/slide[1], shapeellipse, fillFFC000, namemorphBall, x2cm, y14cm, width3cm, height3cm), slide(), transition(/slide[2], morph), # …后续页省略完整列表见 transitions-morph.py… ] doc.batch(items)运行方式pip install officecli-sdk # 另需 officecli 二进制在 PATH 上 python3 examples/ppt/transitions/transitions-morph.py脚本头部注释明确说明它与transitions-morph.sh是“SDK 孪生”产出等价的transitions-morph.pptx。与 Shell 版“容忍前向兼容警告”的思路一致批量模式同样能容忍UNSUPPORTED props警告而完整成文。选择哪种形态取决于你的构建环境Shell 脚本适合命令行流水线Python SDK 适合在 CI/编排代码里以数据结构驱动生成。更多 Morph 应用与关联文档原文档的 Related 章节指向两个延伸资源examples/product_launch_morph.pptx——以 Morph 为主运动的产品发布会全案演示稿位于仓库根目录 examples 下可作为场景级scene-levelMorph 用法的进阶参考examples/ppt/transitions/transitions-dynamic.md——Office 2010 Exciting 动效库vortex、switch、flip、prism、rotate、orbit、doors 等方向家族是独立于 Morph 的另一条代码路径。两者形成互补Morph 走mc:AlternateContentp159:morph的独立实现动态过渡走p15:prstTrans/p14:*家族它们的共性在于都依赖mc:AlternateContent的旧版回退机制这也正是 OfficeCLI 能将“新特性、旧兼容”同时写入同一份 .pptx 的关键设计。赞分享CLIAI 应用MCP 服务【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址https://gitcode.com/GitHub_Trending/of/OfficeCLI点击查看免费下载相关推荐OfficeCLI 实战指南用 Morph 平滑切换为 PPT 注入电影级过渡动画PowerPoint 2016OfficeCLI 实战指南用 Morph 平滑切换为 PPT 注入电影级过渡动画PowerPoint 2016 导读 Morph变形是 Power人工智能AI 应用AI 技能CLIMCP 服务Quasar v-morph 指令完全指南在 Vue 组件间实现丝滑的 DOM 形变过渡动画Quasar v morph 指令完全指南在 Vue 组件间实现丝滑的 DOM 形变过渡动画 导读 v morph 是 Quasar Framework 提供前端UI组件跨平台OfficeCLI Morph-PPT 风格实战warm--sunset-mosaic 落日马赛克企业渐变风设计指南OfficeCLI Morph PPT 风格实战warm sunset mosaic 落日马赛克企业渐变风设计指南 本指南以 morph ppt 技能库中 w人工智能AI 应用AI 技能CLIMCP 服务上一篇Video2X三步实现AI视频画质修复与流畅度提升的完整指南下一篇如何永久保存微信聊天记录WeChatMsg免费工具完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考