tophantppt

SKILL.md

 ```yaml
---
name: tophantppt
slug: tophantppt
version: 1.0.0
homepage: https://clawic.com/skills/tophantppt
description: "以给定的 URL 背景图片为视觉基底，生成符合图片配色、布局与风格设计的可编辑文字 PPT。支持多版式页面（封面、目录、章节、内容、图文、数据、表格、时间轴、团队、结尾等），背景图片仅作视觉层，所有文字保持独立可编辑。"
changelog: 初始版本，支持多版式背景图驱动的 PPT 生成，文字与背景分离以确保可编辑性。
metadata: {"clawdbot":{"emoji":"🎨","requires":{"bins":[]},"os":["linux","darwin","win32"]}}
---

## When to Use

当任务需要输出工作文档创建 PowerPoint 演示文稿，且视觉风格、配色方案和布局必须与这些图片保持一致，同时所有文字必须保持可编辑状态（不能栅格化到背景中）时使用。典型场景包括：对内汇报对外沟通的演示文稿、带有自定义背景的模板化 PPT，或任何背景图像设定视觉基调但内容文字需要生成后编辑的 `.pptx` 工作。

## Background Image Placeholders

本 skill 通过 URL 占位符引用背景图片。在生成前，将下表中的 URL 替换为实际资源。

| 版式类型 | 占位 URL | 用途说明 |
|---|---|---|
| 封面页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/cover_bg.png` | 标题、副标题、演讲者信息 |
| 目录页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/toc_bg.png` | 章节导航、议程概览 |
| 章节过渡页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/chapter_bg.png` | 大章节分隔、转场页 |
| 内容页-纯文字 | `https://github.com/lizhedm/tophantppt/blob/main/assets/content_text_bg.png` | 正文、段落、说明文字 |
| 内容页-左文右图 | `https://github.com/lizhedm/tophantppt/blob/main/assets/content_split_bg.png` | 图文混排、左右分栏 |
| 内容页-上文下图表 | `https://github.com/lizhedm/tophantppt/blob/main/assets/content_chart_bg.png` | 图表上方、文字总结下方 |
| 数据可视化页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/data_bg.png` | 图表、图形、数据展示 |
| 表格页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/table_bg.png` | 结构化数据、对比表 |
| 时间轴页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/timeline_bg.png` | 流程、历史、里程碑 |
| 团队/成员页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/team_bg.png` | 人物介绍、组织架构 |
| 对比页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/compare_bg.png` | 左右/多项对比 |
| 引用页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/quote_bg.png` | 金句、名人名言、观点强调 |
| 列表页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/list_bg.png` | 要点、bullet points |
| 结尾/感谢页 | `https://github.com/lizhedm/tophantppt/blob/main/assets/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 Guidelines

### 默认页 (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` 作为背景。
- 正文段落、要点列表放置在预留的空白/低纹理区域。
- 行高和段间距需保证长文本的可读性。

### 内容页-左文右图 (Content - Split)
- 使用 `content_split_bg.png` 作为背景。
- 左侧文本，右侧图片占位；或根据背景构图反向调整。
- 图片与文本边界清晰，保持呼吸感。

### 内容页-上文下图表 (Content - Chart Below)
- 使用 `content_chart_bg.png` 作为背景。
- 上方为总结性文字，下方为图表区域。
- 图表颜色需与背景色调协调，避免视觉冲突。

### 数据可视化页 (Data Visualization)
- 使用 `data_bg.png` 作为背景。
- 图表、信息图、进度条等使用与背景强调色一致的配色方案。
- 数据标签和图例必须清晰可读，避免与背景复杂区域重叠。

### 表格页 (Table)
- 使用 `table_bg.png` 作为背景。
- 表格线条和填充色需与背景融合，表头可使用背景中的强调色。
- 单元格内文字保持可编辑，不转换为图片。

### 时间轴页 (Timeline)
- 使用 `timeline_bg.png` 作为背景。
- 时间节点、连接线、说明文字均为独立可编辑元素。
- 时间流向（横向/纵向）根据背景构图确定。

### 团队/成员页 (Team)
- 使用 `team_bg.png` 作为背景。
- 成员头像（如有）和姓名、职位信息使用独立文本框。
- 头像如需圆形/圆角裁剪，使用形状裁剪而非预合成图片。

### 对比页 (Comparison)
- 使用 `compare_bg.png` 作为背景。
- 左右或多栏对比内容严格对齐，使用可编辑文本框。
- 对比项标题使用强调色突出。

### 引用页 (Quote)
- 使用 `quote_bg.png` 作为背景。
- 引用文字和出处分开为两个文本框，便于独立编辑。
- 引号符号如与背景冲突，可调整透明度或颜色。

### 列表页 (List)
- 使用 `list_bg.png` 作为背景。
- Bullet points 或编号列表使用标准文本框，保持缩进一致。
- 图标或装饰性 bullet 可使用与背景协调的矢量形状。

### 结尾/感谢页 (Closing)
- 使用 `closing_bg.png` 作为背景。
- 感谢语、联系方式、Q&A 提示使用独立文本框。
- 保持简洁，避免信息过载。

## Common Traps

- 占位符文字和示例图表如果不显式替换，通常会在模板复用中残留。
- 直接编辑一张幻灯片可能会失败，如果实际问题存在于母版或版式中。
- 图表、图标和文本框需要足够空间；近碰撞通常只有在渲染后才可见。
- 版式索引因模板而异，因此一个演示文稿中的内置假设在另一个中通常会失效。
- 缺失的占位符或错误的形状目标可能会悄无声息地将内容放到错误的位置。
- 在选择版式后计算文字想法数量通常会导致空占位符、弱层次或残留模板垃圾。
- 字体替换可能会移动换行符并破坏精心设计的间距。
- 演讲者备注、批注和链接媒体即使在可见幻灯片看起来正常时也可能保持损坏。
- 演示文稿可以通过文字检查但仍因重叠、对比度或边缘裁剪而在视觉上失败。
- 仅从一张幻灯片进行编辑可能会遗漏主题、母版或版式定义中的真正真相来源。
- 在没有匹配内容的情况下选择引用、对比或多列版式通常会使演示文稿看起来是模板化的而非有意设计的。
- 合并或复制幻灯片而不检查母版和主题可能会逐张幻灯片产生细微的不一致。
- 宽高比不匹配（如 `16:9` 与 `4:3`）可能会影响每个放置决策，即使每张幻灯片在局部看起来合理。
- **针对 tophantppt**：
  - 将文字栅格化到背景图片中会使其无法编辑——始终将文字保持为独立图层。
  - 将文字放置在繁忙或高对比度背景区域上方会破坏可读性。
  - 假设所有背景图片共享相同的亮度或色温可能会导致某些幻灯片出现看不见的文字。
  - 忘记嵌入或验证背景图片 URL 会导致在其他机器上缺失背景。
  - 使用带有内置水印或示例文字的背景图片而不遮罩它们会导致重复/冲突的文字。

## Related Skills

使用 `clawhub install <slug>` 安装，如果用户确认：
- `documents` — 经常为演示文稿内容提供素材的文档工作流。
- `design` — 视觉方向和布局决策。
- `brief` — 幻灯片叙述的简洁商业信息。
- `powerpoint-pptx` — 通用 PowerPoint 编辑和 OOXML 操作。

## Feedback

- 如果好用：`clawhub star tophantppt`
- 保持更新：`clawhub sync`
 ```