tophantppt

根据给定背景图片的视觉风格和配色，生成多版式且文字可编辑的符合设计要求的 PPT 演示文稿。

name: tophantppt slug: tophantppt version: 1.0.4 homepage: https://clawic.com/skills/tophantppt description: "支持两种输入方式：1）用户指定每页内容，2）用户提供原始材料自动提炼框架；两种方式均使用指定的背景图片作为视觉参考图，必须使用给的参考图，如果图片获取有问题则重试直至成功获取参考图，当参考图获取有问题时，可都获取默认页地址的图片，不可以跳过使用其他方式。调用生图工具（如codex的image2）直接生成每页幻灯片图片，并合并为全图片型PPTX。最终PPT所有内容均为图片，不可编辑。" changelog: | v1.0.4 统一为全图片生成模式，移除文字可编辑要求；两种模式均使用背景图片作为参考图驱动生图。 v1.0.2 修正模式说明。 v1.0.1 新增模式B。 v1.0.0 初始版本。 metadata: clawdbot: emoji: "🎨" requires: bins: [] os: ["linux", "darwin", "win32"]

background_reference_images: description: | 以下URL为各版式的背景参考图片。在生成每页幻灯片时，必须将这些图片作为视觉参考（图生图），用于确定整体配色、构图比例、氛围和版式风格。生图工具应以此为基础，生成风格一致的幻灯片图片。 list: - type: 封面页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/cover_bg.png usage: 标题、副标题、演讲者信息 - type: 目录页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/toc_bg.png usage: 章节导航、议程概览 - type: 章节过渡页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/chapter_bg.png usage: 大章节分隔、转场页 - type: 内容页-纯文字 url: https://github.com/lizhedm/tophantppt/blob/main/assets/content_text_bg.png usage: 正文、段落、说明文字 - type: 内容页-左文右图 url: https://github.com/lizhedm/tophantppt/blob/main/assets/content_split_bg.png usage: 图文混排、左右分栏 - type: 内容页-上文下图表 url: https://github.com/lizhedm/tophantppt/blob/main/assets/content_chart_bg.png usage: 图表上方、文字总结下方 - type: 数据可视化页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/data_bg.png usage: 图表、图形、数据展示 - type: 表格页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/table_bg.png usage: 结构化数据、对比表 - type: 时间轴页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/timeline_bg.png usage: 流程、历史、里程碑 - type: 团队/成员页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/team_bg.png usage: 人物介绍、组织架构 - type: 对比页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/compare_bg.png usage: 左右/多项对比 - type: 引用页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/quote_bg.png usage: 金句、名人名言、观点强调 - type: 列表页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/list_bg.png usage: 要点、bullet points - type: 结尾/感谢页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/closing_bg.png usage: 致谢、Q&A、联系方式 - type: 默认页 url: https://github.com/lizhedm/tophantppt/blob/main/assets/moren.png usage: 当其他类型找不到对应背景时使用

mode_selection: description: | 在开始操作前，先判断用户输入： - 若用户明确说明“共有X页”、“第一页是……”、“第二页……”等具体结构 → 使用模式A（指定式）。 - 若用户只提供文字段落、文章链接或原始材料，未提及页数或每页内容 → 使用模式B（自动生成式）。 无论哪种模式，最终都生成全图片型PPT（所有内容均为图片，不可编辑）。

modes: A: name: 指定式（全图片） when_to_use: 用户明确给出每页的标题、要点、图表等详细内容。 core_requirements: - 根据用户指定的每页内容，从 background_reference_images 中选择最匹配的版式参考图。 - 为每页撰写详细的图片生成描述（包括布局、文字内容、字体大小、颜色、图形元素位置等），该描述将作为生图工具（image2）的提示词。 - 调用生图工具，以对应的参考图作为视觉基底（图生图），生成每页幻灯片图片。 - 最终将所有图片合并为 .pptx 文件，每页图片铺满幻灯片。 workflow_steps: - step: 1 action: 解析用户指定的每页内容，明确标题、正文要点、图表、图片等元素。 - step: 2 action: 为每一页匹配最合适的版式参考图（根据内容类型）。 - step: 3 action: 撰写详细的图片生成描述（可使用 Markdown 格式），包含背景风格、文字内容及样式、图形布局等，确保描述充分体现参考图的配色和构图逻辑。 - step: 4 action: 调用生图工具（推荐 image2），以参考图作为参考输入，将描述作为提示词，生成高清图片（分辨率 ≥ 1920×1080，16:9），命名 slide_XX.png。 - step: 5 action: 检查生成的图片内容是否准确、文字清晰、布局合理；如有问题，修改描述并重新生成。 - step: 6 action: 使用 python-pptx 等工具新建空白演示文稿（16:9），按顺序插入生成的图片，每张图片铺满整个幻灯片区域，保存为 .pptx。 output_type: 全图片 .pptx（文字不可编辑）

B: name: 自动生成式（全图片） when_to_use: 用户仅提供一段或若干段文字材料，未指定页数或具体每页内容。 core_requirements: - 将材料提炼为逻辑清晰的演示文稿框架（不超过40页）。 - 每页需选择对应的参考图，并生成详细的图片描述，调用生图工具生成图片。 - 最终合并为全图片PPT。 workflow_steps: - step: 1 action: 内容提炼与框架构建 – 提取核心观点，按逻辑顺序组织成每页，明确版式类型、参考图、标题、要点、图表等。 - step: 2 action: 生成图片绘制描述文件 – 输出一个 Markdown 文件（如 ppt_design.md），为每一页提供详细的图片生成描述（参考图、文字内容、样式、图形等）。 - step: 3 action: 逐页生成图片 – 对每一页，将对应的参考图和描述输入生图工具，生成高清图片，命名 slide_XX.png。 - step: 4 action: 合并为PPT – 使用 python-pptx 等工具创建演示文稿，每张幻灯片插入对应图片并铺满，保存为 .pptx。 - step: 5 action: 质量保证 – 检查总页数≤40，图片清晰度、布局正确性、参考图风格一致性。 output_type: 全图片 .pptx（文字不可编辑）

core_rules:

• id: rule1 title: 清点输入与目标 content: 确认用户提供的是指定内容还是原始材料，选择对应模式。
• id: rule2 title: 版式与数量约束 content: 最终PPT页数不超过40页（模式B强制）。每页必须选择对应的参考图，并依据 slide_type_guidelines 设计布局。
• id: rule3 title: 视觉一致性 content: 所有生成的幻灯片图片必须保持与所选参考图一致的配色、字体风格和整体氛围，确保整份PPT视觉统一。
• id: rule4 title: 内容与布局匹配 content: 避免单页文字过多，图表、表格等复杂元素应合理布局。生图描述必须明确文字内容、字号、颜色、对齐方式及图形元素的位置。
• id: rule5 title: 生图质量与可移植性 content: 生成图片分辨率至少 1920×1080，确保清晰。所有图片直接嵌入PPT，不依赖外部链接。输出 .pptx 兼容主流办公软件。

slide_type_guidelines:

• type: 默认页 (moren) reference_image: moren.png description: 当其他类型不匹配时使用，保持简洁，避免信息过载。
• type: 封面页 (Cover) reference_image: cover_bg.png description: 标题、副标题、演讲者/日期信息居中或按参考图构图放置，标题字号最大。
• type: 目录页 (Table of Contents) reference_image: toc_bg.png description: 章节条目使用项目符号或编号，对齐方式参考参考图，避免与装饰元素重叠。
• type: 章节过渡页 (Chapter Transition) reference_image: chapter_bg.png description: 仅包含章节编号和标题，极简，居中或按参考图构图对齐。
• type: 内容页-纯文字 (Content - Text Only) reference_image: content_text_bg.png description: 正文段落、要点列表放在空白/低纹理区域，保证行距和段落间距。
• type: 内容页-左文右图 (Content - Split) reference_image: content_split_bg.png description: 左侧文字右侧图片（或反向），边界清晰，留白适中。
• type: 内容页-上文下图表 (Content - Chart Below) reference_image: content_chart_bg.png description: 上方总结性文字，下方图表区域，图表颜色与参考图协调。
• type: 数据可视化页 (Data Visualization) reference_image: data_bg.png description: 图表、信息图使用参考图的强调色，数据标签和图例清晰可读。
• type: 表格页 (Table) reference_image: table_bg.png description: 表格线条和填充与参考图融合，表头使用强调色。
• type: 时间轴页 (Timeline) reference_image: timeline_bg.png description: 时间节点、连接线、说明文字按流向排列，方向依参考图而定。
• type: 团队/成员页 (Team) reference_image: team_bg.png description: 成员头像（如需要）和姓名、职位信息布局整齐，头像可圆形裁剪。
• type: 对比页 (Comparison) reference_image: compare_bg.png description: 左右或多栏对比，严格对齐，对比项标题突出。
• type: 引用页 (Quote) reference_image: quote_bg.png description: 引用文字和出处分开，引号符号可适度调整透明度。
• type: 列表页 (List) reference_image: list_bg.png description: 项目符号或编号列表，缩进一致，装饰性符号与参考图协调。
• type: 结尾/感谢页 (Closing) reference_image: closing_bg.png description: 感谢语、联系方式、Q&A 提示，保持简洁。

common_traps:

• trap: 生图描述不够具体，导致生成图片与预期偏差，需细化文字内容、颜色、位置。
• trap: 参考图风格未被充分遵循，生成图片配色或构图偏离，需加强 prompt 中对参考图的描述。
• trap: 文字过小或对比不足，在投影或缩小时看不清，应使用大号字体和高对比度。
• trap: 图片分辨率低于 1920×1080，导致模糊，需设置输出分辨率。
• trap: 总页数超过40页，内容过于拥挤，需合并或精简。
• trap: 生图工具无法处理复杂图表，可简化为表格或手绘图示。
• trap: 未检查每页图片的内容准确性，可能导致数据错误或错别字。
• trap: 合并PPT时图片未铺满，留有白边，应设置图片填充整个幻灯片。
• trap: 忽略原始材料重点，框架偏离用户意图，应先与用户确认框架草案（模式B）。
• trap: 不同页面的参考图风格差异大，导致PPT整体不协调，应尽量选择同一系列或风格相近的参考图。

related_skills:

• slug: documents description: 文档材料预处理
• slug: design description: 视觉方向建议
• slug: brief description: 商业信息提炼
• slug: powerpoint-pptx description: PPTX底层操作

feedback: star_command: clawhub star tophantppt sync_command: clawhub sync