运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install tophantppt
镜像加速npx clawhub@latest install tophantppt --registry https://cn.longxiaskill.com
技能文档
When to Use
当任务需要输出工作文档创建 PowerPoint 演示文稿,且视觉风格、配色方案和布局必须与这些图片保持一致,同时所有文字必须保持可编辑状态(不能栅格化到背景中)时使用。典型场景包括:对内汇报对外沟通的演示文稿、带有自定义背景的模板化 PPT,或任何背景图像设定视觉基调但内容文字需要生成后编辑的 .pptx 工作。
Background Image Placeholders
本 技能 通过 URL 占位符引用背景图片。在生成前,将下表中的 URL 替换为实际资源。
| 版式类型 | 占位 URL | 用途说明 |
|---|---|---|
| 封面页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/cover_bg.png | 标题、副标题、演讲者信息 |
| 目录页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/toc_bg.png | 章节导航、议程概览 |
| 章节过渡页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/chapter_bg.png | 大章节分隔、转场页 |
| 内容页-纯文字 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/content_text_bg.png | 正文、段落、说明文字 |
| 内容页-左文右图 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/content_split_bg.png | 图文混排、左右分栏 |
| 内容页-上文下图表 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/content_图表_bg.png | 图表上方、文字总结下方 |
| 数据可视化页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/data_bg.png | 图表、图形、数据展示 |
| 表格页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/table_bg.png | 结构化数据、对比表 |
| 时间轴页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/timeline_bg.png | 流程、历史、里程碑 |
| 团队/成员页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/team_bg.png | 人物介绍、组织架构 |
| 对比页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/compare_bg.png | 左右/多项对比 |
| 引用页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/quote_bg.png | 金句、名人名言、观点强调 |
| 列表页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/列出_bg.png | 要点、bullet points |
| 结尾/感谢页 | https://github.com/lizhedm/tophantppt/blob/mAIn/as设置s/closing_bg.png | 致谢、Q&A、联系方式 |
Core Rules
1. 背景图片仅作为视觉层,文字必须保持可编辑
- 背景图片作为幻灯片背景(
slide.background)或锁定的背景形状应用,绝不能作为文字内容的一部分。 - 所有文字必须存在于独立的文本框、占位符或放置于背景层之上的形状中。
- 禁止将文字栅格化、扁平化或烘焙到背景图片中。
- 文本框在生成后必须在 PowerPoint 中保持可选中和可编辑状态。
- 如果背景图片包含不应出现在最终演示文稿中的装饰性文字或水印,请将其遮罩、裁剪掉,或选择图片的干净区域。
2. 操作前先选择工作流
- 读取文字、编辑现有演示文稿、从模板重建和从零创建是不同的任务,具有不同的失败模式。
- 对于文字提取或检查,先读取演示文稿再进行编辑。
- 文字提取加缩略图式视觉检查比仅凭形状假设进行编辑更安全。
- 对于模板驱动的工作,在替换内容前先清点演示文稿。
- 对于深度编辑,请记住
.pptx文件是 OOXML 格式,包含幻灯片、版式、母版、媒体、备注和批注等独立部分。 - 如果存在模板,模板保真度优先于通用的幻灯片设计直觉。
- 复用或复制一张好的现有幻灯片通常比重建它并指望主题仍然匹配更安全。
3. 布局决策前先清点演示文稿和背景图集
- 首先清点可复用的版式、真实占位符、备注、批注、媒体以及重复的排版或色彩模式。
- 占位符索引和版式索引不是可移植的假设。
- 在定位标题、正文、图表或图片形状之前,先检查实际幻灯片或模板。
- 演讲者备注、批注和链接资源可以存在于可见幻灯片表面之外。
- 缺失或错误的占位符目标可能会悄无声息地将内容放到错误的框或错误的图层中。
- 母版和版式设置可以覆盖本地幻灯片编辑,因此可见问题不一定出在你正在编辑的幻灯片上。
- 针对 tophantppt:首先清点提供的背景图片——注意它们的主色调、安全文字区域(视觉复杂度低的区域)、宽高比,以及它们暗示的是深色模式还是浅色模式文字。
4. 将内容与实际占位符和安全区域匹配
- 在选择版式前先清点实际的内容片段数量。
- 根据幻灯片实际需要的想法数量、列数、图片或图表来选择版式。
- 不要强行将两个想法塞进三列幻灯片,或在图表下方塞入密集文字。
- 类别数量和数据系列长度必须匹配,否则图表会以丑陋的方式损坏。
- 明确的尺寸优于一厢情愿:文本框、图片和图表需要实际空间,而不是"它应该能放下"。
- 不要选择占位符数量超过内容能够有意义填充的版式。
- 引用版式用于真实引用,图片主导版式用于实际有图片的幻灯片。
- 对于图表、表格或图片密集的幻灯片,全幻灯片或双列版式通常比在视觉上方堆叠密集文字更安全。
- 针对 tophantppt:仅将文字放置在背景图片的"安全区域"内——即颜色均匀、渐变或模糊的区域,确保文字清晰可读。避免将文字放置在繁忙的摄影主体、强烈图案或高对比度边缘上方。
5. 从背景图片推导视觉语言
- 从提供的背景图片中提取主色调、强调色和色调氛围。
- 主题、母版和版式文件通常比任何单张幻灯片更能决定字体、颜色和层次。
- 从演示文稿的实际主题、字体、间距和宽高比开始,而不是即兴创作新风格。
- 复用演示文稿自身的对齐和间距系统,而不是发明第二套视觉语言。
- 使用通用字体以确保可移植性,使用强对比以确保可读性。
- 首先保留下模板的视觉逻辑;原创性不如不破坏演示文稿现有语言重要。
- 针对 tophantppt:
6. 分别运行内容 QA 和视觉 QA
- 文字溢出、对齐不良、形状裁剪、对比度弱和占位符残留是正常的一遍失败。
- 同时运行内容 QA 和视觉 QA;缺失文字和布局损坏是不同的故障类别。
- 当布局重要时,在交付前渲染或检查实际演示文稿输出。
- 在称演示文稿完成之前,搜索残留的模板垃圾、示例标签和占位符文字。
- 在视觉检查之外,单独检查备注、批注、标签、图例以及图表/表格语义。
- 演示文稿可以通过文字提取但仍因重叠、裁剪、错误主题继承或损坏备注而失败。
- 缩略图网格和渲染幻灯片通常比代码或文字检查更快揭示布局错误。
- 假设第一次渲染是错误的,在称演示文稿完成前至少进行一次修复-验证循环。
- 每次修复后重新检查受影响的幻灯片,因为一个间距变化经常会产生另一个问题。
- 针对 tophantppt:
7. 保持演示文稿可移植且适合审阅
- 模板母版可以以令人惊讶的方式覆盖直接编辑。
- 复杂效果可能在 PowerPoint、LibreOffice 和转换流程中降级,因此保持重要内容在不依赖它们的情况下依然稳健。
- 图片尺寸、字体替换和占位符不匹配是演示文稿在代码中看起来不错但在屏幕上看起来很差的常见原因。
- 备注、批注、链接媒体和合并的演示文稿即使在可见幻灯片看起来正常时也可能保持损坏。
- 针对 tophantppt:
.pptx 媒体文件夹中,或在提供的 URL 上可靠托管。优先嵌入以避免断链。
- 如果图片通过 URL 链接,在生成时验证可访问性,如果 URL 失败则提供备用纯色背景。Slide Type 图形界面delines
默认页 (moren)
- 使用
moren.png作为背景。 - 下面的其他页面类型找不到页面背景图时,使用默认页。
- 保持简洁,避免信息过载。
封面页 (Cover)
- 使用
cover_bg.png作为背景。 - 标题、副标题、演讲者/日期信息使用独立文本框,放置在背景的安全区域(通常是上部或中部的低复杂度区域)。
- 文字尺寸最大,建立视觉层次。
目录页 (Table of Contents)
- 使用
toc_bg.png作为背景。 - 章节条目使用可编辑文本框或项目符号列表,避免与背景装饰元素重叠。
- 如有序号,使用与背景协调的强调色。
章节过渡页 (Chapter Transition)
- 使用
chapter_bg.png作为背景。 - 通常只包含章节编号和章节标题,保持极简,突出转场感。
- 文字居中或按背景构图对齐。
内容页-纯文字 (Content - Text Only)
- 使用
content_text_bg.png作为背景。 - 正文段落、要点列表放置在预留的空白/低纹理区域。
- 行高和段间距需保证长文本的可读性