ppt-ultrawide-relayout（ppt 超宽布局）

PPT Ultra-wide Relayout

这个 skill 用来处理“PPT 比例改造 + 文字重排”。

它适合这类任务：

• 用户给了一份源 PPT，要改成更宽的横版比例
• 用户给了一份参考 PPT，希望页面比例和整体构图向参考稿靠拢
• 用户明确要求“不要拉伸文字，只能通过字号、框体、留白、位置来适配”
• 用户希望保留原稿的主题色、字体、层级、内容顺序，只重新组织版面

默认策略

默认优先使用“保留源稿高度 + 套用参考稿宽高比”的方式，而不是直接把页面压成参考稿的绝对尺寸。

这样更稳的原因是：

• 不容易把纵向空间压扁
• 更符合“不要拉伸文字”的要求
• 文字和卡片可以通过字号、文本框宽度和留白来适配

硬性约束

• 不要拉伸文字，不要通过非等比缩放让字形变扁或变长
• 不要直接把整页元素做机械等比缩放后交差
• 优先保留原稿的字体、字重、字号层级、颜色和阅读顺序
• 优先保留原稿每一页的元素顺序和块状关系，不要把本来成组的元素拆散
• 可以放大或缩小文本框，可以减小字号，可以改变换行位置
• 可以延展背景图、裁切背景图、重设图像位置，但要避免把人物或主体裁没
• 先做可编辑的 PPTX 输出，不要把内容转成纯图片页

推荐工作流

1. 先分析结构

python3 scripts/pptx_layout_dump.py /path/to/source.pptx --pretty
python3 scripts/pptx_layout_dump.py /path/to/reference.pptx --pretty

重点看：

• 画布尺寸和宽高比
• 每页主要文本框数量
• 标题字号、正文字号、字体
• 是否存在全屏背景图、右侧主视觉图、底部页脚信息

2. 决定目标画布

默认公式：

target_width = source_height * (reference_width / reference_height)
target_height = source_height

如果用户明确要求精确尺寸，才直接使用参考稿的 width x height。

3. 先映射版心，再微调

超宽重排时，默认先建立一个“居中的内容安全区”，把原始版心整体映射进去，再做小幅微调。

优先遵守这些规则：

• 不要把每个元素各自拉开
• 先保住原页的阅读顺序、成组关系和视觉节奏
• 新增空间优先用作留白、背景延展和辅助氛围
• 如果页面原本就偏左或偏右构图，可以保留这种倾向，但整体重心要稳定
• 如果某个文本框原本在一个卡片、描边块或色块里，重排后必须继续待在那个块里

4. 再按页面类型处理

优先把每页归为以下类型之一：

• 封面页
• 章节页
• 内容页
• 双列或多卡片页
• 步骤/方法论页
• 收尾页

页面信息很多时，不要为了“看起来像超宽”而把内容排得过散。优先保证层级、可读性和块内安全。

脚本用法

结构分析

python3 scripts/pptx_layout_dump.py /path/to/file.pptx --pretty

首轮超宽重排

python3 scripts/pptx_ultrawide_relayout.py \
  /path/to/source.pptx \
  --reference /path/to/reference.pptx \
  --output /path/to/output.pptx

默认行为：

• 保留源稿高度
• 按参考稿宽高比扩展画布
• 保持文字不被拉伸
• 先把原始版心整体映射到居中的安全区
• 再对背景、正文框、标题框和装饰元素做温和微调
• 尽量避免块内溢出、顺序错乱和过度横向发散

如果用户明确要求精确尺寸：

python3 scripts/pptx_ultrawide_relayout.py \
  /path/to/source.pptx \
  --reference /path/to/reference.pptx \
  --target-mode exact-reference \
  --output /path/to/output.pptx

XML 改稿原则

PPTX 本质是 zip 包。常见关键文件：

• ppt/presentation.xml
• ppt/slides/slideN.xml
• ppt/theme/theme1.xml

重点关注这些节点：

• p:sldSz：画布宽高
• a:xfrm：元素位置和尺寸
• a:off：左上角坐标
• a:ext：宽高
• a:rPr：文本字号、字重、颜色、字体

文字适配时优先这样做：

1. 先改文本框尺寸和位置
2. 再看是否需要减小字号
3. 最后再处理换行和行距

不要这样做：

• 直接对文字所在形状做横向或纵向非等比拉伸
• 不检查块边界和换行就统一缩小所有字号

验收清单

• 每一页都已经换成目标比例
• 没有任何文字被拉伸变形
• 字号层级仍然清晰
• 标题和正文没有明显溢出
• 文本框没有冲出所属卡片、描边块或底色块
• 背景图没有露白边
• 页脚、页码、辅助装饰没有被甩到错误位置
• 阅读顺序与原稿一致，没有出现“元素虽然都在，但视觉关系散掉了”的问题
• 版式整体看起来像“重新设计过”，不是“被拖宽了”