SuperAPI AI 工具集

design-export-repair

设计与创作

查看项目

更新于 10-16 02:38

技能介绍

用途:修复 AI 生成的演示文稿/PDF 导出后出现的显示问题——文字末端被截断、字体与原始设计不符、部分转换器无法正常读取 PPTX 文件等。检查逻辑基于通用 OOXML/PDF 规范,不限于 Claude 产品。

主要能力:针对四类缺陷进行处理。(1) [Content_Types].xml 声明了 zip 中不存在的部件,导致转换器失败、丢页或输出错乱;通过 python-pptx 重新加载并保存以重建清单。(2) 形状边界超出幻灯片边缘,可能被按严格视口渲染的工具裁切;将形状平移回界内,若形状本身大于幻灯片则缩小并重算表格网格。(3) 使用了自定义 Web 字体(如 Inter、Plus Jakarta Sans、JetBrains Mono)但未嵌入,渲染器会替换字体;转换前安装匹配字体文件。(4) LibreOffice 会裁切带字距(a:rPr spc)的文本末尾 1-4 个字符,通常这才是“文字被截断”的真正原因;仅对渲染副本中和字距处理,返回的 PPTX 保留原始字距以便编辑。

使用方式:运行 python3 scripts/fix_export.py <input> --out-dir <输出目录>。输入可为 .pptx、.zip(自动查找 pptx、HTML/CSS/JS 包或 PDF)或裸 .pdf。运行后查看 <out-dir>/repair_report.md,其中记录包结构问题、被移动/缩放的形状(含前后坐标)、字体状态、字距变通是否生效以及最终 PDF 校验结果。输出包括 .repaired.pptx、.repaired.pdf 和报告文件。

适用场景:从 Claude Design 导出后发现演示文稿/PDF 损坏时。推荐走普通 Export 路径(PDF/PPTX/HTML),把文件交给 Claude Code 并说明修复需求。

限制:裸 PDF 缺少可编辑源文件,无法移动形状或修复字体引用,只能做页数、空白页、边缘溢出校验。HTML/CSS/JS 包路径为尽力而为,未针对真实样本验证。安装命令与代码保持原样,未提供的细节暂未说明。