Community图像github.com

poster-skills

从PPT模板创建精美HTML幻灯片。适用于TRAE网页PPT工作:母版提取、cqw/cqh布局、视觉质检、响应式幻灯片或8K导出。

poster-skills 是什么?

该技能(poster-skills)是一个专业化的AI辅助工具,专注于将高校、学院或企业的PPT模板高效转化为可编辑、可等比缩放且支持高清导出的HTML幻灯片。它通过一套标准化的流程,包括“母版约束拆解”、“逐页版式生成”、“截图视觉质检”和“无头浏览器高清导出”,形成了完整的闭环工作流。主要支持TRAE平台,但也适用于任何需要从PPT或设计稿生成网页幻灯片的场景。该技能的核心优势在于强制使用 `cqw/cqh` 容器查询单位实现真正的响应式布局,解决了传统HTML幻灯片在不同屏幕或导出尺寸下比例失真的问题。此外,它内置了严格的视觉质检和8K (7680×4320) 高清导出能力。工作流程上,它强调先建立母版(解构模板为不变量),再基于母版逐页生成内容,最后通过截图进行像素级验证。特别值得注意的是,该技能严格区分了“可编辑的PPTX文件”与“作为演示的HTML幻灯片”,避免了用HTML冒充可编辑文件的错误。对于开发者或AI Agent用户而言,这是一个集成了最佳实践(如素材本地化、最小范围修改、排除常见问题)的完整解决方案,能够极大提升从设计到开发的效率和产出质量。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CanFlyhang/poster-skills/tree/HEAD

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

TRAE 网页 PPT 制作流程

将高校、学院或企业 PPT 模板转化为可编辑、可等比缩放、可高清导出的 HTML 幻灯片。通过“母版约束 + 逐页版式 + 截图质检 + 无头浏览器导出”形成完整闭环。

适用场景

  • 根据 PPT 模板、参考截图或现有 HTML 母版制作网页 PPT。
  • 统一整套幻灯片的 Banner、LOGO、色彩、字体和网格。
  • 使用 TRAE 逐页生成、改版、修复遮挡或调整文案。
  • 将 HTML 幻灯片批量导出为高清 PNG,包括 7680×4320 的 8K 图片。

如果用户要求的是对象级可编辑 .pptx,应使用 PPTX 工具,不要把 HTML 图片冒充为可编辑 PowerPoint。

开始前确认

优先读取用户已有材料,不要重复索要工作区中已有的信息。

  1. 模板依据:PPT、参考图、HTML 母版页或品牌规范。
  2. 页面内容:大纲、每页标题、要点、数据、图片和参考文献。
  3. 固定规范:页面比例、主色、字体、LOGO、页眉页脚及必须保留的元素。
  4. 交付形式:HTML 源文件、本地素材、预览图、8K 图片或导出入口。

缺少非关键信息时采用合理默认值:16:9、系统字体、本地素材、1920×1080 质检。只有缺失内容会阻塞制作时才追问。

核心原则

  1. 先拆母版,再写页面:不要边生成边猜风格。
  2. 母版元素是不变量:Banner、LOGO、主色、标题位置和内容区网格不得逐页漂移。
  3. 版式尺寸相对化:定位、宽高、字号和间距使用 cqw/cqh,不要混用固定 px 控制版式。
  4. 一页一种主要表达结构:相邻页面避免无意义地重复“左图右文”;对比页等特殊情况除外。
  5. 素材本地化:不依赖临时图床;真实照片需来源明确,概念图优先内联 SVG。
  6. 每页截图验收:代码无报错不代表画面正确,必须看渲染结果。
  7. 最小范围修改:修复单页问题时,不随意重排其他模块或改动整套母版。

标准工作流

第一步:拆解模板,建立不变量

从参考模板中提取并记录:

类别需要确认的内容
Banner背景、LOGO 位置、标题位置、装饰线、固定高度
色彩主色、辅助色、正文色、灰阶、强调色使用规则
字体标题字体、正文字体、字号层级、字重
网格左右安全边距、内容区起点、栏间距、页脚位置
可变项每页标题、副标题、正文结构、图片与图表

优先使用系统自带字体,避免外部字体在不同电脑上失效。参考图需要复刻时,把“位置、尺寸、字体、配色与参考一致”写成硬约束,而不是只写“风格类似”。

第二步:搭建 16:9 技术底座

所有页面共享同一容器逻辑:

/* 幻灯片容器:保持 16:9,并启用容器查询尺寸单位。 */
.slide {
  width: min(100vw, calc(100vh * 16 / 9));
  aspect-ratio: 16 / 9;
  position: relative;
  overflow: hidden;
  container-type: size;
}

/* 页面元素:相对容器定位,窗口缩放时保持比例。 */
.title {
  position: absolute;
  top: 6.5cqh;
  left: 4cqw;
  font-size: 2.5cqw;
}

container-type: size 是 cqw/cqh 生效的关键。在 1920×1080 画布中,1cqw = 19.2px,1cqh = 10.8px。窗口缩小、投影放大或高倍导出时,版式比例保持一致。

第三步:制作母版页

先完成少量基准页,再批量生成其余页面:

  • 封面页:主标题、汇报人、单位、日期及品牌视觉。
  • 正文母版页:固定 Banner、标题区、内容网格和页脚。
  • 收尾页:结论、致谢或参考文献,根据内容需要区分用途。

母版验收通过后,将其作为后续页面的结构与样式依据。修改已有页面前必须先读取文件,不能凭文件名猜测结构。

第四步:逐页生成,匹配内容结构

每次生成新页都写清五项:

  1. 参考哪个母版页,哪些元素保持不变。
  2. 页面比例、文件名和保存位置。
  3. 本页标题、要点、数据及结论。
  4. 本页采用的版式,以及与前面页面的差异。
  5. 图片来源、本地化要求和版权约束。

可按内容选择版式,不要为了新颖而牺牲信息表达:

内容类型推荐结构
封面居中大标题、品牌横幅、单张主视觉
并列对象等宽卡片阵列、分栏对比
流程与阶段阶梯、时间线、递进横幅
因果关系链条、箭头流程、中心辐射
核心概念中心图解 + 四周注解
结构与原理剖面图、SVG 示意图 + 要点
数据与仪表图表、指标卡、对开面板
多维信息2×2 网格、矩阵、分组卡片
结论中心论点、竖轴收束、少量关键数字
参考文献文献封面或来源截图 + 规范列表
致谢大字号短文案 + 主视觉,减少模块堆叠

第五步:选择配图方式

按以下优先级选择:

  1. 真实照片:优先用户提供或授权明确的素材;公开素材需核对许可并记录来源。
  2. 内联 SVG:适合晶格、缺陷、剖面、流程、因果链等无法直接拍摄的概念。
  3. CSS 图形:适合阶梯、谱条、徽章、指标底色等简单装饰性信息图。

所有图片保存到本地并核对引用路径。不得使用与内容无关的 AI 氛围图填充版面。

第六步:逐页视觉质检

Windows 可调用 Edge 无头模式生成 1920×1080 质检图。按实际浏览器路径和文件路径调整:

$edge = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
& $edge --headless=new --disable-gpu --hide-scrollbars `
  --virtual-time-budget=6000 --window-size=1920,1080 `
  --screenshot="_chk.png" "file:///absolute/path/to/page.html"

逐页检查:

  • 页面完整显示为 16:9,没有意外滚动条。
  • 无元素溢出、裁切、重叠或模块间距过近。
  • 所有图片成功加载,无空白占位和破图。
  • 标题、正文、图注层级清晰,无孤字和异常换行。
  • Banner、LOGO、色彩和网格与母版一致。
  • 数据、单位、年份、术语和参考文献口径一致。
  • 缩小窗口后仍等比缩放,没有固定像素元素破坏布局。

发现问题后先定位根因,只修改相关样式或元素,再次截图复核。删除角标、页眉等元素时,同时检查对应 HTML、CSS 和页面标题,避免残留。

第七步:导出高清图片

使用 1920×1080 视口配合 4 倍设备缩放导出 7680×4320 PNG:

& $edge --headless=new --disable-gpu --hide-scrollbars `
  --virtual-time-budget=6000 --window-size=1920,1080 `
  --force-device-scale-factor=4 `
  --screenshot="export/page.png" "file:///absolute/path/to/page.html"

该方式让浏览器按高倍比例重新渲染文字、CSS 和 SVG,不是把低分辨率位图拉伸为 8K。

批量导出时优先复用项目已有脚本。进程退出后仍需确认文件存在、尺寸正确且写盘完成,不能只凭命令退出码判断成功。

第八步:整理交付物

推荐保持清晰、可复用的目录:

project/
├── 001.html ... NNN.html
├── assets/
│   ├── images/
│   └── logos/
├── export/
└── html2img_8k.py        # 项目已有或用户要求时提供

交付时列出源文件、素材目录、导出目录及尚未由用户补充的信息,不将临时质检截图混入正式成果。

可复用提示词

生成新页

请基于【母版页路径】生成【新页面文件名】:
1. 保持 16:9、Banner、LOGO、字体、色彩和网格不变;
2. 标题为【标题】,内容包含【要点 A】【要点 B】【要点 C】;
3. 采用【指定版式】,与相邻页面的结构有所区别;
4. 页面内定位、尺寸、字号和间距使用 cqw/cqh;
5. 图片本地化并注明来源,完成后进行 1920×1080 截图质检。

修复视觉问题

请定位【页面路径】中【具体模块】出现【遮挡/溢出/破图/换行】的根因,
只修复相关问题,保持其他模块和母版不变,修改后重新截图核验。

调整文案

将【页面路径】中的【原文】替换为【新文案】,
保持现有版式,检查单行显示、孤字、溢出和模块间距。

常见问题

问题优先检查
cqw/cqh 不生效容器是否设置 container-type: size,元素是否位于该容器内
换电脑后字体变化是否使用外部字体或未安装字体,改用系统字体栈
图片空白或 404文件名、大小写、相对路径、特殊字符及零宽空格
文件名含零宽空格 U+200B重命名文件,或将字符 URL 编码为 %E2%80%8B
模块撞入标题区内容区起点、模块高度、阶梯抬升量是否过大
段落出现孤字先优化文案,再微调字号或容器宽度
页面风格逐渐漂移是否绕过母版自由发挥,重新核对不变量
8K 图片模糊是否使用 4 倍设备缩放重渲染,而非放大已有截图
导出文件不完整是否等待页面渲染及文件写盘稳定

完成标准

只有在以下条件全部满足后才算完成:

  • 母版与全套页面风格一致,内容页结构服务于信息表达。
  • 所有新增或修改页面均经过实际渲染检查。
  • 图片、字体、LOGO 和脚本引用可用,素材已本地化。
  • 导出图片尺寸符合要求,8K 输出为 7680×4320。
  • 交付目录清晰,临时文件与正式成果分离。

相关技能