Doa ppt

Skill medalsoftchina/workcopilot/embedded-skills/doa-ppt

Full project lifecycle AI workstation — orchestrates Agents, Skills, Hooks & Prompts for end-to-end development workflow, from requirements analysis to delivery. 项目全生命周期 AI 工作站。

Install

npx -y skills add medalsoftchina/workcopilot --skill doa-ppt

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

生成或优化商务PPT演示文稿、产品介绍、技术方案、项目报告，支持多页HTML幻灯片预览、 HTML转PPT导出，或将PDF、截图、笔记、参考文档等源材料转化为精美演示文稿。不用于独立网页或Web应用。

SKILL.md

63.1 KB, as published. Nobody here has run it

HTML to PPTX — 商务演示文稿生成

工作流概览

用户输入（描述 + 参考图）
  → 确认PPT规模
  → 使用公司模板（唯一默认模板）
  → 生成可翻页 HTML 预览
  → 逐页检查 HTML 是否越界/裁切/重叠
  → 用户确认/调整 HTML
  → 只有用户明确确认 HTML 无问题后，才进入 PPT 模式选择
  → 默认推荐截图高保真模式（用户如需二次编辑再切换到可编辑）
  → 生成 PPT

本次实战经验固化

当用户提供 PDF、截图、既有 HTML 或已有 PPT，并要求“基于这个继续生成 / 整合 / 扩展 / 转 PPT”时，必须先把资料链路整理清楚，再改版式。

2026-05-30 延峰项目增补（强制）

HTML 是唯一语义源：slides.html 才是可维护源文件；截图型 .pptx/.pdf 只作为交付物，不作为反向编辑来源。
双导出链路必须物理分离：

截图高保真：export_pptx.py
可编辑重建：export_editable_pptx.py
严禁在同一脚本里混合两种导出逻辑，避免需求反复切换时互相污染。

需求切换优先级规则：当用户在“可编辑 / 不可编辑”之间反复切换时，始终以“最后一次明确指令”为准，立即切换导出模式，不纠缠历史决策。
先定稿再导出：只有在用户明确确认“按当前 HTML 导出”后，才执行最终导出；导出阶段不再顺手改布局，避免一边改版一边导出导致版本漂移。
输出文件不得覆盖旧版本：每次最终交付使用新文件名（建议带日期和后缀，如 _Editable_YYYYMMDD、_HD_YYYYMMDD），防止 PermissionError 和历史交付丢失。
导出后必须二次验证：至少校验文件存在、页数一致、截图分辨率正确（高清链路应为 2560×1440），再对外宣称“已完成交付”。

资料驱动型 PPT 的处理顺序

先定位源材料：在工作区搜索 .pdf、.html、.pptx、生成脚本和相关资源，确认哪一个是主源文件、哪一个是导出结果。
PDF 先提取文本，失败再转图片阅读：优先用 pypdf/pdfplumber；如果每页文本为空，说明多半是扫描型 PDF，应使用 PyMuPDF 渲染为图片后逐页查看。
先总结再入页：不要把 PDF 原文堆进 PPT。先提炼为“调研范围 → 候选路线 → 选型结论 → 当前方案”的决策链路。
封面优先确认：封面通常是客户第一眼看到的页面。若用户要求“第 N 页挪到首页作为封面”，必须同步调整 active 状态、data-index 和页码。
插入/删除页面后整体重编号：任何插页、删页、重排都要统一更新以下内容，缺一不可：
- 每页 data-index 属性（从 0 连续递增）
- 每页 .page-no 页码（当前页 / 新总数）
- 目录页中对应条目的增删和序号重编
- HTML 注释中的页码标注（如 ）
- 使用 multi_replace_string_in_file 一次性完成所有页码更新，避免遗漏

技术方案类 PPT 推荐叙事结构

对于架构、安全、技术选型类 PPT，优先采用以下结构：

封面：结论导向，明确方案对象、日期和一句话判断
调研范围：说明为什么要调研，选型标准是什么
候选路线：把语言级、进程级、内核级、容器级、云托管等方案放在一张对比页
选型结论：说明为什么选择当前方案，而不是只说“推荐方案”
风险论证：用业务可理解的语言说明备选方案的风险边界
推荐架构：给出控制面、执行面、隔离边界、运行时治理
落地配置：给出参考规格、扩容方式、运维和审计能力
最终结论：用一句客户能复述的话收束，例如“跑自己的任务用 Job，跑别人的代码用沙箱”

版式与导出踩坑记录

固定幻灯片画布仍使用 1280×720。浏览器预览可以通过 CSS/JS 做自适应缩放，但导出截图必须保持 .slides-viewport 的原始 1280×720 尺寸。
每次新增 layout class 后，要检查它是否覆盖 .content{height:600px}。如果直接把 .grid-* 用在 .content 上，必须补 .content.grid-*{height:600px} 防止内容压到 footer。
高保真导出脚本激活页面时不要写 slide.className = 'slide active'，否则会丢失 cover 等特殊 class。应使用 classList.remove('active','exit-left') 和 classList.add('active')。
PowerShell 执行带空格路径的 Python 时必须用调用运算符：& "c:/path with spaces/.venv/Scripts/python.exe" script.py。
如果 PPT 文件可能正被 PowerPoint 打开，优先输出到新文件名，避免 PermissionError。

SVG 装饰插图踩坑记录

SVG 默认 overflow:visible：SVG 子元素（<circle>, <rect> 等）即使超出 viewBox 范围，浏览器仍会渲染并占据布局空间。getBoundingClientRect() 会返回超出 viewBox 的实际渲染区域，导致边界检查报越界。
CSS overflow:hidden 对 SVG 子元素的 bounding rect 无效：给 SVG 父容器加 overflow:hidden 只能在视觉上裁剪，但 getBoundingClientRect() 仍然返回子元素的完整渲染尺寸，边界检查仍会报 overflow。
正确做法：确保 SVG 内容不超出 viewBox：所有 <circle>, <rect> 等元素的坐标 + 半径/尺寸必须在 viewBox 范围内。例如 viewBox="0 0 320 320" 中，<circle cx="220" r="130"> 右边界为 350，超出 320，必须减小 cx 或 r。
不要使用负偏移量让 SVG 超出幻灯片边界：如 right:-30px 会让 SVG 内容溢出 slide 右边界。背景装饰 SVG 应使用 right:0 并让视觉内容自然收敛在 viewBox 内。
装饰 SVG 推荐写法：position:absolute; pointer-events:none; z-index:0; opacity:0.03~0.08，确保不影响交互且视觉上足够微妙。

左右分栏等高对齐踩坑记录

强制规则：所有使用左右分栏的内容页，左右两列必须等高对齐，底部齐平。这是不可协商的硬性要求。

.grid-2 { align-items: stretch } 只拉伸直接子元素：grid 子 div 会被拉伸到等高，但内部元素（表格、卡片）不会自动填满。
必须在 grid 子 div 上加 display:flex; flex-direction:column：让内部元素参与 flex 布局。
需要填满高度的元素加 flex:1：表格用 style="flex:1" 填满剩余高度；多张卡片用 flex:1 让每张卡片等分空间。
左右卡片数量不对等时，少的一侧每张卡片必须加 flex:1：例如左 3 卡片、右 2 卡片，右侧每张卡片必须加 flex:1 使其自动拉伸填满。禁止出现一侧比另一侧短、底部有大段空白的情况。
左右分栏的父容器必须填满内容区：.content 加 display:flex;flex-direction:column，.grid-2 加 flex:1 或 style="height:100%"，确保 grid 占满内容区而非只占内容自然高度。

2026-05-31 图文分栏对齐补充（强制）

.screenshot-panel 默认 padding 导致高度不对齐：.screenshot-panel 类自带 padding:8px，会导致图片面板比左侧内容区矮 16px。必须在 style 中加 padding:0 覆盖，否则左右高度永远对不齐。
背景配图必须用 object-fit:cover：背景类图片（非产品截图）用 width:100%;height:100%;object-fit:cover 铺满面板，不留白边。产品截图用 object-fit:contain 保留完整界面。
flex 子元素必须加 min-height:0：flex 容器的子元素默认 min-height:auto，内容过多时会撑破容器导致溢出。所有 flex 子元素（左侧内容区、右侧图片面板）都必须加 min-height:0。
图片面板必须加 overflow:hidden：防止图片超出面板边界。
图片不要用 .product-screenshot 类：该类自带 box-shadow 和 border，适用于产品截图，不适用于背景配图。背景配图直接写内联样式 border-radius:14px。
左侧内容区也要 min-width:0：flex 子元素默认 min-width:auto，表格等元素可能撑宽导致右侧图片被压缩。加 min-width:0 允许内容区按比例缩小。

对齐问题诊断清单

当左右高度不对齐时，按以下顺序检查：

☐ .content 是否有 display:flex;align-items:stretch？
☐ 右侧面板是否有 padding:0 覆盖默认 padding？
☐ 图片是否有 width:100%;height:100%;object-fit:cover？
☐ 左右两侧是否都有 min-height:0？
☐ 左侧是否有 min-width:0？
☐ 右侧是否有 overflow:hidden？

典型结构：

<div class="grid-2">
  <div style="display:flex;flex-direction:column;">
    <div style="...title...">标题</div>
    <table class="cmp-table" style="flex:1;">...</table>
  </div>
  <div style="display:flex;flex-direction:column;">
    <div style="...title...">标题</div>
    <table class="cmp-table" style="flex:1;">...</table>
  </div>
</div>

减少空白与紧凑排版踩坑记录

页眉上边距应紧凑：.header { padding: 24px 56px 0 } 而非 32px，减少页眉到内容区的间距。色条 .header::after { top: 68px } 同步调整。
内容区高度最大化：.content { padding: 16px 56px 10px; height: 600px } 而非旧值 40px/32px/548px，可用面积增加约 20%。
font-size 全局下限 15px：整个 PPT 中不允许出现小于 15px 的文字。如果内容放不下，优先精简文案或拆页，不要缩小字号。
底部摘要/结论用 margin-top:auto 推到底部：全宽表格页（如对比矩阵 + 底部摘要）应让 .content 设为 display:flex;flex-direction:column，底部摘要块用 margin-top:auto 贴近底部，消除表格与摘要之间的大片空白。
警告/提示框不要用 position:absolute：绝对定位的提示框容易与上方内容重叠或在不同内容量时错位。应放在正常文档流中，用 margin-top:auto 或 margin-top:10px 控制位置。
grid-2 内部结合 flex:1 填满高度：.grid-2 的父容器 .content 设为 display:flex;flex-direction:column，然后 .grid-2 自身加 flex:1 使其填满剩余空间，避免 grid 与 footer 之间出现大段空白。

典型紧凑内容页结构：

<div class="content" style="display:flex;flex-direction:column;">
  <table class="cmp-table">...</table>
  <div style="margin-top:auto;padding:12px 16px;background:var(--primary-soft);border-radius:8px;">
    <strong>💡 结论：</strong>摘要文字
  </div>
</div>

字体放大与溢出联动踩坑记录

当用户反馈"字太小、看不清"时，必须按以下策略系统性放大字体，同时联动调整布局参数防止溢出。

系统性放大而非逐个调整：使用 Python 正则脚本批量替换，对 font-size:Npx 统一 +2px（13→15, 14→16, 15→17, 16→18, 17→19, 18→20），.page-title 从 30→34px。不要只改一两处导致大小不统一。
内容区高度联动增加：字体放大后 .content { height } 从 590→600px，padding 从 20px 56px 14px → 16px 56px 10px，腾出更多垂直空间。
图片高度联动缩减：字体放大必然挤压空间，图片高度按比例缩减：280→240, 220→190, 200→175, 150→140。优先保证文字可读性，图片可以小一些。
放大后必须逐页检查溢出：使用浏览器 JS 遍历所有 .slide，计算 scrollHeight - clientHeight，任何 > 2px 的页面必须修复（缩减图片、减少间距、精简文案）。1-2px 的误差属于亚像素渲染，可忽略。
时间轴/步骤类页面最容易溢出：这类页面元素多且垂直堆叠，放大后优先压缩 margin-bottom（20→12px）、图片高度、标题 margin，必要时删除 <br> 空行。

PDF 导出踩坑记录

Pillow Image.save(save_all=True) 可用于简单场景：将截图 PNG 合并为多页 PDF，代码最简洁，适合截图高保真模式。需要 convert('RGB') 去掉 alpha 通道。
reportlab 适合需要自定义页面尺寸的场景：如果 PDF 页面尺寸需要精确控制（如匹配 2x 截图分辨率 2560×1440），使用 reportlab。
同时导出 PPTX + PDF 时，共享截图：截图只做一次，分别喂给 build_pptx() 和 build_pdf() 两个函数，避免重复截图。

导出后的强制校验

截图高保真 PPT 生成后，必须验证：

.pptx 文件存在
Presentation(...).slides 页数等于 HTML 中 .slide 数量
ppt/media/image*.png 数量等于页数
首页截图尺寸应与 VIEWPORT × DEVICE_SCALE 一致；标准 2x 高清链路下应为 2560×1440
若封面应为深色/有色背景，检查首页或封面页的平均 RGB，避免背景丢失变白
如果封面被挪到其他页，校验对应媒体图，而不是只校验 image1.png

Step 1: 收集需求

向用户收集以下信息：

业务功能描述：产品/功能的核心卖点、关键特性、目标用户
参考图（可选）：用于参考布局和内容排版
PPT 规模（必选）：确认演示文稿的页数范围
特殊要求（可选）：Logo、指标数据等

确认页眉页脚风格

必须在生成前与用户确认，使用 vscode_askQuestions 工具提问，提供两个选项：

选项	说明	适用场景
公司品牌模板	页眉：左侧渐变圆点 + 标题，右侧 SWO / 微钉双品牌 Logo；页脚：左 "SoftwareOne \| 微钉科技"，右页码胶囊	对外商务演示、客户提案、正式交付
AI 自动设计	AI 根据 PPT 主题和内容自动决定页眉页脚的图标、品牌名和排版风格	内部分享、读书会、技术沙龙、个人演示等非品牌场景

选择"公司品牌模板"时，使用 Step 1.5 中定义的 Logo 和页脚规范；选择"AI 自动设计"时，AI 根据内容主题自行设计页眉标识（如书名缩写、主题 icon 等）和页脚文字，但仍遵循相同的布局结构和字号规范。

公司品牌模板 Logo 素材

品牌素材位于 .claude/skills/doa-ppt/brand-assets/，生成 PPT 时需复制到 output/<项目名>/ppt_softwareonemedlasoft_assets/：

文件名	用途
`SoftwareOne.png`	SoftwareOne Logo（黑色，通用于封面/内容页/结尾页）
`Medaslsoft.png`	微钉科技 Logo（彩色，含中英文图标，通用于封面/内容页/结尾页）
`Medaslsoft_Sample.png`	微钉小图标（仅 icon，用于目录页和内容页标题左侧的 `.header-dot`）

CSS 引用方式（统一用 background: url(...) center/contain no-repeat）：

页标题左侧图标：.header-dot → Medaslsoft_Sample.png（32×32px，替代原来的渐变圆点）
封面：.cover-logo-swo → SoftwareOne.png，.cover-logo-medalsoft → Medaslsoft.png
内容页页眉右侧：.header-logo-swo → SoftwareOne.png，.header-logo-medalsoft → Medaslsoft.png
结尾页：.ending-logo-swo → SoftwareOne.png，.ending-logo-medalsoft → Medaslsoft.png

确认 PPT 规模

必须在生成前与用户确认，使用 vscode_askQuestions 工具提问：

规模	页数	适用场景	内容深度
单页精华版	1 页	一页纸汇报、功能速览、电梯演讲	核心卖点 + 关键指标
标准版	7-12 页	产品介绍、项目汇报、方案评审	封面 + 概览 + 功能详解 + 架构 + 数据 + 总结
完整版	17-23 页	正式提案、年度汇报、深度技术方案	全面覆盖背景、现状、方案、细节、规划、附录

Step 1.5: 默认模板 — 公司模板（唯一模板）

所有 PPT 统一使用公司模板，不做主题选择。此模板来源于 DOA-WorkCopilot Skill 产品介绍 PPT 的实际设计成果。

视觉方向

整体气质：科技感 + 柔和感，紫蓝色系为主调，通过大面积薰衣草渐变底色营造精致氛围
核心视觉元素：3D 紫色球体 + 轨道环 + 旋转玻璃菱形，贯穿封面、章节页和结尾页，形成统一视觉母题
配色风格：不走深色系，全程使用浅紫灰渐变底色（#EDE5F8 → #CDD3EC），保持明亮通透
装饰克制：内容页只用极轻的 deco-circle 渐变圆点缀右上角，不与内容争夺视线

配色体系

用途	变量	色值
主色	`--primary`	`#4C78FF`
主色深	`--primary-dark`	`#3B32D4`
主色浅	`--primary-soft`	`#EEF1FF`
辅助青	`--accent`	`#46B6FF`
品牌紫	`--purple`	`#9D6BFF`
品牌橙	`--amber`	`#F2B27C`
品牌粉	`--red`	`#F062C0`
品牌绿	`--green`	`#58BFC8`
文字主色	`--text-primary`	`#1E1842`
文字次色	`--text-secondary`	`#4A4567`
文字辅助	`--text-muted`	`#7D78A0`
边框	`--border`	`rgba(141, 136, 208, 0.24)`

页面级背景策略

页面类型	背景
HTML body 背景（浏览器预览区）	`linear-gradient(135deg, #EDE5F8 0%, #DDD8F0 30%, #D5D6EE 60%, #CDD3EC 100%)`
所有幻灯片统一底色	`linear-gradient(90deg, #EDE5F8 0%, #DDD8F0 35%, #D5D6EE 65%, #CDD3EC 100%)`
底部色条	`linear-gradient(90deg, var(--accent), var(--primary), var(--purple), var(--red))`

硬性要求：body 背景色禁止使用深色（如 #1a1a2e），必须使用浅紫到浅蓝的渐变色，与幻灯片底色保持视觉一致。公司模板不在页面间做深浅分层，所有页面使用同一底色。通过"球体+玻璃"装饰强度区分页面类型。

核心装饰母题：紫色球体 + 轨道环 + 玻璃菱形

三类页面（封面、章节页、结尾页）共享同一组视觉元素，通过位置和大小变化营造统一感：

球体（3D 渐变紫色圆球）：

background: radial-gradient(circle at 38% 32%, #A480F0, #6535D9 55%, #4520B0);
box-shadow: 0 28px 80px rgba(91,48,215,.35);

轨道环（两层同心圆细线）：

border: 1px solid rgba(180,175,210,.3);   /* 内环 */
border: 1px solid rgba(180,175,210,.18);  /* 外环，更淡 */

玻璃矩形（旋转 50° 的毛玻璃矩形，带左侧渐变边线）：

background: linear-gradient(160deg, rgba(255,255,255,.48), rgba(245,240,255,.25), rgba(230,220,250,.10));
border: 1.5px solid rgba(255,255,255,.50);
backdrop-filter: blur(14px);
transform: rotate(50deg);
border-radius: 24px;

/* 左侧渐变边线 */
.cover-glass1::before {
  content:''; position:absolute; top:20px; bottom:20px; left:-2px;
  width:3px; border-radius:99px;
  background:linear-gradient(180deg, #9D6BFF, #6BB8FF);
}

装饰圆点（三种颜色点缀）：

蓝色：linear-gradient(135deg, #6BB8FF, #46B6FF)
粉色：linear-gradient(135deg, #FF6BA0, #FF4081)
紫色：radial-gradient(circle at 35% 30%, #C4A0FA, #7E50DE 80%)

斜切装饰线（极淡渐变线）：

background: linear-gradient(90deg, transparent, rgba(76,120,255,.15), rgba(157,107,255,.20));
transform: rotate(-30deg);

封面页规范

布局：左侧文字（标题+副标题+作者），右侧球体+轨道环+毛玻璃矩形
左侧对齐规则（强制）：Logo、标题内容、底部信息三者左侧必须对齐
- .cover-logo { left: 28px } — Logo 紧靠左侧
- .cover-content { padding: 0 48px } — 标题/副标题/作者信息
- .cover-bottom { left: 48px } — 底部网址和品牌名

球体：460×460px，right:130px; top:60px，z-index:3

background: radial-gradient(circle at 38% 32%, #B898FA, #8050F0 40%, #6030D8 65%, #4A20C0);
box-shadow: 0 32px 90px rgba(91,48,215,.28);

轨道环：两层，z-index:1
- 内环：560×560px，right:130px; top:40px，border: 1px solid rgba(180,175,210,.25)
- 外环：660×660px，right:80px; top:-10px，border: 1px solid rgba(180,175,210,.15)

毛玻璃矩形：560×780px，rotate(50deg)，right:50px; top:300px，z-index:4（在球体前面，半透明覆盖）

background: linear-gradient(160deg, rgba(255,255,255,.48), rgba(245,240,255,.25), rgba(230,220,250,.10));
border: 1.5px solid rgba(255,255,255,.50);
backdrop-filter: blur(14px);
border-radius: 24px;

毛玻璃渐变边线：左侧竖向紫蓝渐变线（::before 伪元素）

.cover-glass1::before { position:absolute; top:20px; bottom:20px; left:-2px; width:3px; border-radius:99px; background:linear-gradient(180deg, #9D6BFF, #6BB8FF); }

装饰圆点：三个（非四个），各有独特位置
- 蓝色（22px）：left:130px; top:140px，在左侧空白区
- 粉色（20px）：right:580px; top:130px，在轨道环上
- 紫色（32px）：left:-6px; top:380px，半隐藏在页面左边缘
× 装饰符号：right:50px; top:60px，18px 淡紫色，z-index:5
斜切装饰线：width:900px; rotate(-25deg); left:-100px; bottom:60px
标题字体：52px/900 weight，渐变色（--primary-dark → --primary → --red）
子标题：36px，用第二渐变（--purple → --accent → --green）
Logo：左上方双品牌 Logo，top:32px; left:28px，z-index:5
底部：bottom:24px; left:48px; right:48px，左侧网址链接，右侧 "Medalsoft"

<div class="slide cover active" data-index="0">
  <div class="cover-ring-o2"></div>
  <div class="cover-ring-o1"></div>
  <div class="cover-glass1"></div>
  <div class="cover-sphere"></div>
  <div class="cover-dot1"></div><div class="cover-dot2"></div><div class="cover-dot3"></div>
  <div class="cover-x">×</div>
  <div class="cover-line"></div>
  <div class="cover-content">
    <div class="cover-logo">...</div>
    <div class="cover-title">产品名称<br><span>子标题</span></div>
    <div class="cover-subtitle">描述文字</div>
    <div class="cover-meta">作者 · 公司 · 日期</div>
  </div>
  <div class="cover-bottom"><a href="#">www.medalsoft.com</a><span>Medalsoft</span></div>
</div>

章节分隔页规范（标题页）

章节分隔页是 PPT 必备页面类型，每个主要章节前必须有一张。球体 + 轨道环 + 毛玻璃面板三要素缺一不可。

目录条目与章节分隔页 1:1 对应（强制）：目录页有 N 个条目，就必须有 N 个章节分隔页。例如目录 8 个条目编号 1-8，则必须有 8 个分隔页（sd-num 为 01-08），每个分隔页的标题必须与目录中对应条目的标题一致。不允许"只给部分章节加分隔页"——这会让读者在翻页时失去节奏感。

布局：球体居左偏中，毛玻璃面板右侧延伸，页码数字叠加在球体上
球体：280×280px，left:210px; top:220px
轨道环：两层（380px / 460px）

毛玻璃面板（必须还原）：width:fit-content，padding-left:160px; padding-right:50px

.sd-glass {
  background: linear-gradient(155deg, rgba(255,255,255,.46), rgba(210,200,240,.12));
  border: 1px solid rgba(255,255,255,.50);
  backdrop-filter: blur(6px);
  border-radius: 24px;
}

页码数字：92px 白色斜体（Inter），叠在球体中心
章节标题：36px/800 weight，深紫色 #2E1A6E
不显示底部色条：.slide.section-divider::after { display:none; }
编号必须与目录页一致（强制）：章节分隔页的 .sd-num 数字必须等于目录页中对应条目的序号。例如目录第 2 项“认知革命”，则该章节分隔页显示 02，而不是独立从 01 开始计数。目录页描述文字也必须与对应内容页的标题一致，不得出现通用词糊弄。

<div class="slide section-divider">
  <div class="sd-ring r2"></div>
  <div class="sd-ring r1"></div>
  <div class="sd-sphere"></div>
  <div class="sd-num">01</div>
  <div class="sd-glass"><div class="sd-glass-title">章节标题</div></div>
  <div class="sd-dot pink"></div>
  <div class="sd-dot purple"></div>
  <div class="sd-dot blue"></div>
</div>

结尾页规范

布局：封面的镜像 — 球体在左侧，大字 "THANK YOU" 在右侧
Logo：左上方双品牌 Logo，top:32px; left:28px（与封面完全一致），z-index:5

球体：440×440px，left:50px; top:100px，z-index:3

background: radial-gradient(circle at 38% 32%, #B898FA, #8050F0 40%, #6030D8 65%, #4A20C0);
box-shadow: 0 32px 90px rgba(91,48,215,.28);

轨道环：两层，z-index:1
- 内环：560×560px，left:-10px; top:40px，border: 1px solid rgba(180,175,210,.25)
- 外环：660×660px，left:-60px; top:-10px，border: 1px solid rgba(180,175,210,.15)

毛玻璃矩形：1100×600px，rotate(28deg)，left:450px; top:60px，z-index:4（在球体上面）

与封面的关键差异：结尾页的毛玻璃矩形更宽更扁、角度更缓（28° vs 封面 50°），覆盖右半区域直到右下角
无上方边框，只有底部渐变色条（::after 伪元素）
无左侧渐变边线（::before 隐藏）

.ending-glass {
  width: 1100px; height: 600px;
  background: linear-gradient(160deg, rgba(255,255,255,.48), rgba(245,240,255,.25), rgba(230,220,250,.10));
  border: none;
  backdrop-filter: blur(10px);
  transform: rotate(28deg);
  border-radius: 0 0 24px 24px;
  overflow: hidden;
}
/* 左侧渐变边线隐藏 */
.ending-glass::before { display: none; }
/* 底部渐变色条（粉→紫→蓝） */
.ending-glass::after {
  content: ''; position: absolute; bottom: 0; left: 0; right: 0;
  height: 2px;
  background: linear-gradient(90deg, #E95BC2, #8050F0, #3DA5FF);
  border-radius: 0 0 24px 24px;
}

装饰圆点：两个
- 粉色（24px）：left:50px; top:100px，在 Logo 下方
- 蓝色（18px）：right:60px; top:140px，在右侧
× 装饰符号：right:50px; top:60px，18px 淡紫色
斜切装饰线：width:1000px; rotate(-25deg); left:0px; bottom:60px
"THANK YOU"：108px/900 weight，渐变从粉到紫（linear-gradient(180deg, #E95BC2, #3F2FD7)），居右
底部：bottom:24px; left:48px; right:48px，左侧 "Medalsoft"，右侧日期

<div class="slide ending" data-index="最后">
  <div class="ending-ring2"></div><div class="ending-ring1"></div>
  <div class="ending-glass"></div><div class="ending-sphere"></div>
  <div class="ending-dot-pink"></div><div class="ending-dot-blue"></div>
  <div class="ending-x">×</div>
  <div class="ending-line"></div>
  <div class="ending-logo-area">
    <div class="ending-logo-swo"></div>
    <div class="ending-logo-divider"></div>
    <div class="ending-logo-medalsoft"></div>
  </div>
  <div class="ending-content">
    <div class="ending-copy">
      <div class="ending-title">THANK<br>YOU</div>
    </div>
  </div>
  <div class="ending-bottom"><span>Medalsoft</span><span>日期</span></div>
</div>

内容页组件规范

页眉：左侧微钉小图标 Medaslsoft_Sample.png（32×32px）+ 标题（34px/800），右侧双品牌 Logo。页眉下方 120px 蓝紫渐变色条。

卡片：圆角 20px，白色半透明（.94/.84），双层边框 + 柔和阴影，backdrop-filter:blur(10px)。

终端代码块：深色 #1A1730，带红黄绿三色窗口按钮，代码用 JetBrains Mono，高亮色：蓝 #7dd3fc、绿 #86efac、紫 #c4b5fd。

照片框：圆角 16px，底部渐变遮罩 + 白色说明文字。

表格：表头渐变紫 linear-gradient(135deg, #6D79C8, #7E6ED7)，白底行，圆角 14px。

Before/After 对比列：粉色（Before）vs 青色（After），用 justify-content:space-evenly 均匀分布条目。

提示框：白色毛玻璃底，左侧 3px 蓝色竖线，圆角 16px。

流程步骤：48px 渐变圆球 + 连接线 + 文字标签，颜色从蓝到绿到紫渐变。

标签 pill：5 种颜色变体（green/amber/purple/red/blue），圆角 99px。

页脚：左 "SoftwareOne | 微钉科技"，右页码（圆角胶囊式，白底紫文字）。

目录条目（毛玻璃卡片式）：每个目录项为一张全宽毛玻璃卡片，左侧标题+描述，右侧编号圆球。必须还原毛玻璃效果。

.toc-item {
  display: flex; align-items: center; justify-content: space-between;
  gap: 16px; padding: 16px 24px;
  background: linear-gradient(155deg, rgba(255,255,255,.46), rgba(210,200,240,.12));
  border: 1px solid rgba(255,255,255,.50);
  backdrop-filter: blur(6px);
  border-radius: 16px;
  transition: all .3s;
}
.toc-item:hover { box-shadow: var(--shadow); transform: translateY(-2px); }
.toc-num {
  width: 44px; height: 44px; border-radius: 50%;
  background: linear-gradient(135deg, var(--primary), var(--purple));
  color: white; font-size: 16px; font-weight: 800;
  display: flex; align-items: center; justify-content: center;
  flex-shrink: 0;
  box-shadow: 0 4px 16px rgba(76,120,255,.25);
}
.toc-text { font-size: 18px; font-weight: 700; color: var(--primary-dark); }
.toc-desc { font-size: 14px; color: var(--text-muted); margin-top: 4px; }

目录页推荐结构（根据条目数量自动选择布局）：

布局规则（强制）：

≤ 5 个条目：单列堆叠布局，display:flex;flex-direction:column;gap:12px

6-8 个条目：双列网格布局，grid-2，每列 3-4 个条目，每个条目加 flex:1 使同列条目等高

超过 8 个：拆分为多个目录页，或精简章节结构

禁止在单列布局中塞入超过 5 个条目——必定导致溢出或压缩到无法阅读的尺寸。

<div class="slide" data-index="1">
  <div class="header">
    <div class="header-left"><div class="header-dot"></div><div class="page-title">目录</div></div>
    <div class="header-brand"><span class="logo-text">品牌名</span></div>
  </div>
  <div class="content" style="display:flex;flex-direction:column;gap:12px;padding-top:16px;">
    <div class="toc-item">
      <div><div class="toc-text">章节标题</div><div class="toc-desc">简要描述</div></div>
      <div class="toc-num">1</div>
    </div>
    <!-- 更多条目... -->
  </div>
  <div class="page-footer"><span>品牌名</span><span class="page-no">02 / N</span></div>
</div>

关键：.toc-item 必须使用 backdrop-filter: blur(6px) + 半透明白色渐变背景实现毛玻璃效果，不要用纯白卡片。编号圆球放在右侧（justify-content: space-between），而非左侧。

动画规范

fadeUp：从下方 24px 淡入
fadeScale：从下方 12px + 缩放 0.97 淡入
封面标题依次入场（delay 0.1s → 0.2s）
卡片、终端、照片、提示框统一用 fadeScale 0.5s
目录条目依次入场（delay 0.02s 递增 0.06s）
章节页球体 fadeScale 0.6s → 数字 fadeUp 0.6s → 玻璃面板 fadeScale 0.6s

实战踩坑要点

玻璃面板宽度用 fit-content：不要固定宽度，自适应标题文字长度，padding-right:50px 控制右侧留白
Before/After 列不要用 <br> 堆行：改为 <div> + flex-direction:column; justify-content:space-evenly，避免底部大片空白
照片与下方提示框之间要留 margin-top:12px：避免紧贴重叠
左右分栏的短列元素加 flex:1：卡片、表格、终端都要 flex:1 撑满，避免左右不等高
表格容器要 display:flex;flex-direction:column：让 <table style="flex:1"> 生效
球体 z-index 层级：轨道环 z1 → 球体 z3 → 玻璃矩形 z4 → 装饰点/内容 z5
所有页面统一底色：不分页面类型做深浅差异，只靠装饰元素密度区分

各规模推荐页面结构

单页精华版（1 页）：

标题 + 功能描述 + 特性卡片 + 交互预览 + 关键指标

标准版（7-12 页）：

封面（标题 + 副标题 + 日期）
目录 / 议程
背景与痛点
产品/功能概览
核心特性详解（2-4 页，每页 1-2 个特性）
技术架构 / 工作原理
关键数据与成效
路线图 / 下一步计划
总结 / Q&A

完整版（17-23 页）：

封面
目录
执行摘要
背景与现状分析（2-3 页）
痛点与需求（1-2 页）
解决方案概览
核心功能详解（4-6 页，每页聚焦一个功能）
技术架构（1-2 页）
交互体验展示（1-2 页）
数据与成效（1-2 页）
案例 / 场景演示
竞品对比 / 优势分析
实施路线图
团队与资源
风险与应对
总结与展望
Q&A / 附录

Step 2: 生成可翻页 HTML 预览

基于收集的需求和确认的规模，使用公司模板生成一个可左右翻页的 HTML 文件，模拟幻灯片放映效果。

翻页 HTML 结构

所有页面合并为一个 slides.html 文件，内置翻页交互：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>PPT 预览</title>
  <style>
    /* 主题 CSS 变量（根据选定主题填充） */
    :root { ... }

    * { margin: 0; padding: 0; box-sizing: border-box; }
    body {
      background: linear-gradient(135deg, #EDE5F8 0%, #DDD8F0 30%, #D5D6EE 60%, #CDD3EC 100%);
      display: flex; justify-content: center; align-items: center;
      min-height: 100vh; font-family: 'Noto Sans SC', sans-serif;
      overflow: hidden;
    }

    /* 幻灯片容器 */
    .slides-viewport {
      position: relative;
      width: 1280px; height: 720px;
      overflow: hidden; border-radius: 8px;
      box-shadow: 0 20px 60px rgba(0,0,0,0.3);
    }
    .slide {
      position: absolute; top: 0; left: 0;
      width: 1280px; height: 720px;
      opacity: 0; transform: translateX(100px);
      transition: all 0.5s cubic-bezier(0.4, 0, 0.2, 1);
      pointer-events: none;
    }
    .slide.active {
      opacity: 1; transform: translateX(0);
      pointer-events: auto;
    }
    .slide.exit-left {
      opacity: 0; transform: translateX(-100px);
    }

    /* 导航控件 */
    .nav-btn {
      position: fixed; top: 50%; transform: translateY(-50%);
      width: 50px; height: 50px; border-radius: 50%;
      background: rgba(255,255,255,0.5); border: none;
      color: #4A4567; font-size: 24px; cursor: pointer;
      backdrop-filter: blur(10px);
      transition: background 0.3s;
      z-index: 100;
    }
    .nav-btn:hover { background: rgba(255,255,255,0.7); }
    .nav-btn.prev { left: 30px; }
    .nav-btn.next { right: 30px; }
    .nav-btn:disabled { opacity: 0.3; cursor: not-allowed; }

    /* 页码指示器 */
    .page-indicator {
      position: fixed; bottom: 30px; left: 50%;
      transform: translateX(-50%);
      display: flex; gap: 8px; z-index: 100;
    }
    .page-dot {
      width: 10px; height: 10px; border-radius: 50%;
      background: rgba(76,120,255,0.25);
      cursor: pointer; transition: all 0.3s;
    }
    .page-dot.active {
      background: #4C78FF; transform: scale(1.3);
    }

    /* 键盘提示 */
    .keyboard-hint {
      position: fixed; bottom: 60px; left: 50%;
      transform: translateX(-50%);
      color: rgba(74,69,103,0.4); font-size: 13px;
    }
      transform: translateX(-50%);
      display: flex; gap: 8px; z-index: 100;
    }
    .page-dot {
      width: 10px; height: 10px; border-radius: 50%;
      background: rgba(76,120,255,0.25);
      cursor: pointer; transition: all 0.3s;
    }
    .page-dot.active {
      background: #4C78FF; transform: scale(1.3);
    }

    /* 键盘提示 */
    .keyboard-hint {
      position: fixed; bottom: 60px; left: 50%;
      transform: translateX(-50%);
      color: rgba(74,69,103,0.4); font-size: 13px;
    }
  </style>
</head>
<body>
  <div class="slides-viewport">
    <div class="slide active" data-index="0">
      <!-- 第 1 页内容 -->
    </div>
    <div class="slide" data-index="1">
      <!-- 第 2 页内容 -->
    </div>
    <!-- ... 更多页面 ... -->
  </div>

  <button class="nav-btn prev" onclick="navigate(-1)">‹</button>
  <button class="nav-btn next" onclick="navigate(1)">›</button>

  <div class="page-indicator">
    <!-- JS 动态生成 -->
  </div>
  <div class="keyboard-hint">← → 方向键翻页 | 点击圆点跳转</div>

  <script>
    let current = 0;
    const slides = document.querySelectorAll('.slide');
    const total = slides.length;
    const indicator = document.querySelector('.page-indicator');
    const prevBtn = document.querySelector('.nav-btn.prev');
    const nextBtn = document.querySelector('.nav-btn.next');

    // 生成页码圆点
    for (let i = 0; i < total; i++) {
      const dot = document.createElement('div');
      dot.className = 'page-dot' + (i === 0 ? ' active' : '');
      dot.onclick = () => goTo(i);
      indicator.appendChild(dot);
    }

    function goTo(index) {
      if (index < 0 || index >= total || index === current) return;
      const dir = index > current ? 1 : -1;
      if (dir > 0) slides[current].classList.add('exit-left');
      slides[current].classList.remove('active');
      current = index;
      slides[current].classList.remove('exit-left');
      slides[current].classList.add('active');
      updateControls();
    }
    function navigate(dir) { goTo(current + dir); }
    function updateControls() {
      prevBtn.disabled = current === 0;
      nextBtn.disabled = current === total - 1;
      document.querySelectorAll('.page-dot').forEach((d, i) =>
        d.className = 'page-dot' + (i === current ? ' active' : '')
      );
    }
    // 键盘导航
    document.addEventListener('keydown', (e) => {
      if (e.key === 'ArrowLeft') navigate(-1);
      if (e.key === 'ArrowRight') navigate(1);
    });
    updateControls();
  </script>
</body>
</html>

每页幻灯片内容结构

每个 .slide div 内部是完整的幻灯片内容，与之前的单页 HTML 结构一致。所有页面共享同一套 CSS 变量和样式。

设计原则

商务简约：清晰的视觉层次，不过度装饰
配色统一：从选定主题的 CSS 变量体系出发，所有页面风格一致
信息密度适中：标题 + 功能描述 + 特性卡片 + 交互预览 + 指标数据
翻页流畅：CSS 过渡动画，支持键盘 / 点击 / 圆点导航

封面与内容页差异化设计准则

封面页：简洁美观

极简主义：封面只保留 Logo、主标题、副标题/日期，不堆砌信息
大量留白：封面的视觉重心靠留白和色彩营造高级感，而非密集排版
品牌调性突出：深色渐变背景 + 品牌色装饰线 + Logo 居中，一眼传达品牌气质
文字层级鲜明：主标题 36-48px 加粗，副标题 16-20px 轻量，不超过 3 层信息

内容页：详实丰富、图文搭配

信息密度高：每页应充分利用版面承载核心观点，避免"一句话占一整页"
图文搭配：纯文字页面占比不超过 30%，优先使用图标、图表、架构图、截图等视觉元素辅助表达
数据可视化：关键指标用数字高亮卡片、进度条、对比图表呈现，而非纯文字罗列
案例 + 截图：技术方案页配架构图，功能页配界面截图或交互示意

图文结合的反 AI 味准则（强制）

核心原则：从第一稿开始，每个内容页都必须图文结合，使用真实图片（联网搜索或用户提供），严禁 Emoji 图标，严禁纯文字页面。不要先用 Emoji 占位再让用户修改——第一版就必须到位。

第一稿就必须配图，不允许后期修补：生成 HTML 的同时就要完成图片搜索/下载/引用，不能先出纯文字版让用户反复要求加图。这是硬性门禁，没有配图的内容页不得交付。
每个内容页必须包含至少一张真实图片：不是装饰，而是承载信息的视觉元素。产品类用界面截图，技术类用架构图/截图，书籍类用封面照，历史类用文物/遗址/古画照片。纯文字卡片堆叠的页面观感极差。
数据/表格页也必须有图：即使是规则表格、对比矩阵等数据密集页面，也要做图文分栏——左侧缩窄表格/数据区，右侧配主题相关的背景图。不允许全宽纯文字表格独占整页。
严禁使用 Emoji 作为图标或装饰（从第一稿起）：不要用 🔥📊🚀💡🛡️ 等 Emoji 充当视觉元素。如需图标效果，使用纯色圆角方块 + 中文单字的 .icon-bar 组件：
```
<div class="icon-bar">
  <span class="ib" style="background:var(--primary);">审</span>
  <span class="ib" style="background:var(--purple);">核</span>
  <span class="ib" style="background:var(--green);">验</span>
</div>
```
.ib 样式：display:inline-flex; width:28px; height:28px; border-radius:7px; color:#fff; font-size:13px; font-weight:700; align-items:center; justify-content:center;
不要只堆卡片和 bullet：如果一页全是等宽小卡片 + 抽象文案，AI 味会非常重。至少给关键页加入一张真实截图、业务场景图或结构图。
图片要承担信息功能：图片不是装饰填空。界面优化页用真实界面截图，实施页用流程图/时间轴，问题页用现状截图，对比页用前后对照。
单页至少一个视觉主角：每页应有一个主视觉元素，通常是大图、表格、时间轴、架构图、数据横幅中的一个，而不是所有元素平均铺开。
同一张图不要反复滥用：若素材不足，可复用同类风格图，但不要整套稿件只靠一张图裁来裁去。至少在封面、现状、方案、交付几个阶段使用不同视觉来源。
咨询稿结构优先：推荐采用 左文右图、上图下结论、大图 + 侧栏摘要、主图 + 底部指标条 这类结构，避免平均分配成四宫格信息墙。
图片与文字的视觉重量要互补：大图页应减少正文密度；文字多时图片只保留一张主图或局部截图，避免图和字同时抢焦点。

图片素材获取与回退策略（强制）

图片是内容页质量的决定性因素，必须主动获取，不能跳过。

有联网能力时（默认流程）

主动利用联网能力搜索高质量图片：使用 Tavily/Unsplash/Pexels 等可商用图源，根据 PPT 主题关键词批量搜索相关图片。每个内容页至少配一张，整套 PPT 至少准备 8-15 张不同图片。
图片下载到本地 images/ 目录：所有网络图片必须下载到 output/<项目名>/images/ 目录，HTML 中使用相对路径 images/xxx.jpg 引用，不依赖外部 URL。
图片语义匹配：不要随便拿风景图填技术页。书籍类用封面/作者/场景照，历史类用文物/遗址/古画，技术类用架构截图/产品界面，商务类用办公/团队/数据可视化照片。
下载失败立即换源：Wikimedia 缩略图限制较多（400 错误常见），优先使用 Unsplash（https://images.unsplash.com/photo-xxx?w=800），备选 Pexels。某张图 404 时立即换另一张同主题图，不要阻塞流程。
图片尺寸建议：宽度 600-1200px 即可，不需要超高清。JPG 格式优先，单张控制在 50-250KB。

无联网能力时（回退流程）

立即告知用户：明确提示"当前环境无法联网下载图片，请您手动收集相关图片放入 output/<项目名>/images/ 文件夹"。

提供图片清单：列出每页需要的图片主题和建议文件名，如：

images/cover.jpg      — 书籍封面或主题封面照
images/scene_01.jpg   — 第一章节主题配图
images/scene_02.jpg   — 第二章节主题配图
...

先生成 HTML 框架：即使图片暂缺，也先生成完整 HTML，图片位置用 placeholder 占位（灰色背景 + 文字提示），等用户补图后自动显示。
用户补图后再做最终检查：图片到位后重新在浏览器中检查每页渲染效果。

通用规则

优先级顺序：本地截图 / 项目现状图 / 品牌资产 / 用户提供图片 / 可商用网络图片。
本地素材也要讲语义：即便只能使用本地截图，也要按"现状页、方案页、交付页"分别选图，不能随便拿一张图填所有页面。
禁止为补图而破坏版权边界：仅使用用户提供、本地已有、品牌资产或可明确商用的图片来源（Unsplash/Pexels 均为免费商用授权）。

图文分栏布局标准模式（强制）

所有内容页必须使用图文分栏布局。不允许任何内容页只有纯文字/纯表格而没有图片。

内容页标准结构为 左文右图 flex 分栏：

<div class="content" style="display:flex;gap:20px;align-items:stretch;">
  <!-- 左侧：文字/卡片/表格 -->
  <div style="flex:1;display:flex;flex-direction:column;min-width:0;min-height:0;">
    <!-- 内容区 -->
    <div class="highlight-box" style="margin-top:auto;padding:8px 14px;">
      <p style="font-size:12px;margin:0;"><strong>总结文字</strong></p>
    </div>
  </div>
  <!-- 右侧：图片面板 -->
  <div class="screenshot-panel" style="flex:0 0 340px;overflow:hidden;min-height:0;padding:0;">
    <img src="images/xxx.jpg" style="width:100%;height:100%;object-fit:cover;border-radius:14px;" alt="描述">
  </div>
</div>

关键规则

项目	规则	原因
flex 容器	`display:flex;gap:20px;align-items:stretch`	stretch 让左右等高
左侧内容区	`flex:1;display:flex;flex-direction:column;min-width:0;min-height:0`	min-height:0 防止内容撑破容器
右侧图片面板	`flex:0 0 300~400px;overflow:hidden;min-height:0;padding:0`	固定宽度，padding:0 覆盖默认值
图片样式	`width:100%;height:100%;object-fit:cover;border-radius:14px`	cover 填满面板，不留白边
底部摘要	`margin-top:auto` 推到底部	消除中间空白

不同页面类型的图片面板宽度建议

页面类型	图片面板 `flex-basis`	说明
常规文字+卡片	`flex:0 0 400px`	文字少图片大
数据表格（单表）	`flex:0 0 340px`	表格需要更多宽度
数据表格（双表/密集）	`flex:0 0 300px`	给表格让出更多空间
产品截图（精确展示）	`flex:1`（与文字等宽）	截图需要大面积

产品截图 vs 背景配图

类型	来源	用途	样式差异
产品截图	Playwright 截图 + 裁剪	精确展示界面功能	`object-fit:contain`，保留白底，加 `box-shadow` 和 `border`
背景配图	Unsplash/Pexels 联网下载	视觉氛围、主题烘托	`object-fit:cover`，铺满面板，`padding:0`

表格页图文分栏示例

数据密集的表格页也必须有图片，做法是缩窄表格列宽 + 减小字号：

<div class="content" style="display:flex;gap:20px;align-items:stretch;">
  <div style="flex:1;display:flex;flex-direction:column;min-width:0;">
    <table class="cmp-table" style="flex:1;font-size:13px;">
      <thead><tr><th style="width:50px;">编号</th><th style="width:120px;">名称</th><th>描述</th><th style="width:70px;">等级</th></tr></thead>
      <tbody><!-- 数据行 --></tbody>
    </table>
    <div class="highlight-box" style="margin-top:auto;padding:8px 14px;">
      <p style="font-size:12px;margin:0;"><strong>总结</strong></p>
    </div>
  </div>
  <div class="screenshot-panel" style="flex:0 0 340px;overflow:hidden;min-height:0;padding:0;">
    <img src="images/bg_theme.jpg" style="width:100%;height:100%;object-fit:cover;border-radius:14px;" alt="主题图">
  </div>
</div>

内容间距规范（强制）

不同内容块之间必须有可见间距，禁止紧贴在一起。

元素	间距规则	CSS
表格行间距	每行之间留 8px 间距	`border-spacing: 0 8px;`
卡片之间	卡片之间留 12-16px 间距	`gap: 12px` 或 `gap: 16px`
标题与内容	标题下方留 10-12px	`margin-bottom: 10px`
内容与底部摘要	自动推到底部	`margin-top: auto`
左右分栏间隔	左侧内容与右侧图片之间	`gap: 20px`
图文分栏内部	左列内部元素之间	`gap: 10px`
全宽表格 td	单元格内边距	`padding: 14px 16px`

表格行间距实现

.cmp-table {
  border-spacing: 0 8px;   /* 行间距 8px */
  border-collapse: separate; /* 必须用 separate 才能生效 */
}
.cmp-table td {
  padding: 14px 16px;      /* 单元格内边距 */
}

禁止的紧凑写法

禁止 border-spacing: 0 或 border-collapse: collapse 导致行间无间距
禁止卡片之间 gap: 0 或无 gap 导致卡片紧贴
禁止多个 highlight-box 或提示框之间无 margin 导致视觉糊在一起

多元素对称与布局规范

网格对齐：多卡片/多模块布局必须基于网格系统，保证等宽、等高、等间距
偶数列优先：2 列、4 列布局天然对称；3 列时确保中间列居中，左右等距
视觉重量平衡：左右分栏时，文字侧与图片侧视觉重量应大致相当（文字多则配大图，文字少则配小图 + 留白）
垂直节奏统一：同一页内所有卡片顶部对齐、底部对齐，标题到内容的间距一致
重复元素模板化：同类卡片（如特性卡片、步骤卡片）必须使用完全相同的尺寸、圆角、阴影和内边距
奇数元素处理：当出现 3/5/7 个元素时，优先考虑拆行（如 3+2、4+3）或用留白/装饰块补位，避免末行孤立元素靠左

硬性版式约束

不得超出页面边界：任何标题、正文、图表、卡片、页码、页脚、装饰元素都不能溢出 1280×720 幻灯片安全区域
左右分栏必须等高对齐：所有使用 .grid-2 的内容页，左右两列底部必须对齐，禁止出现一侧比另一侧短、底部留有大片空白的情况。通过 flex:1 让卡片/表格自动拉伸填满
优先缩内容，不挤边界：若内容放不下，优先精简文案、拆分页面、减少卡片数量或降低局部字号，不允许为了塞内容而越出边界
保留安全边距：正文和关键组件应默认保留至少 24-40px 的可视边距，避免贴边或在截图/PPT中被裁切
生成后必须检查越界：如果预览中出现裁切、遮挡、重叠、贴边或翻页控件覆盖正文，必须先调整版式再继续导出 PPT

多页 PPT 的设计一致性

所有页面共享同一套 CSS 变量（配色体系）
Header 区域（Logo + 页标题）位置保持一致
页脚区域风格统一（可加页码）
每页使用相同的字体大小层级（页面主标题 34px，卡片标题 18-20px，正文 17px，辅助/标签 15px）
最小字体硬性下限 15px：整个 PPT 中任何可见文字（含页脚、标签、图片说明）不得小于 15px。禁止使用 10-14px 等小字号——在投影仪上完全无法阅读
卡片正文使用 font-size: 17px; line-height: 1.7，确保在 1280×720 画布和投影场景下清晰可读
优先通过精简文案来适配版面，而不是缩小字号塞更多内容

HTML 技术要点

使用 Google Fonts（Noto Sans SC 中文 + 一款英文字体）
CSS 变量定义配色体系（--primary, --primary-light, --accent 等）
Flexbox/Grid 布局，固定 width: 1280px; min-height: 720px
卡片组件带 border-left 色条、圆角、轻阴影
渐变色仅用于装饰横幅，正文区域保持纯色

交付物

生成一个 slides.html 文件（内置翻页交互，所有幻灯片在同一个文件中）

保存到用户工作目录，提示用户在浏览器中预览，根据反馈迭代调整。

HTML 预览后的强制门禁

必须先逐页检查边界：生成 slides.html 后，必须逐页检查每一页是否存在越界、裁切、遮挡、重叠、贴边或导航控件压住正文的问题
检查不通过不得生成 PPT：只要任意一页存在版式问题，必须先修改 HTML 并重新检查，直到全部页面通过为止
用户修改 HTML 后不得自动继续导出：如果用户要求“修改这个 HTML / 调整这几页 / 优化版式”，完成修改后只能停在 HTML 预览确认阶段，不能直接继续生成 PPT
必须等待用户明确确认：只有当用户明确表达“HTML 没问题了 / 可以生成 PPT / 按这个版本导出”这类确认后，才允许进入 PPT 生成步骤
禁止默认代替用户确认：即使边界检查通过，也不能把“看起来没问题”当成用户确认

HTML 检查清单

逐页至少检查以下项目：

标题、副标题、正文、卡片、图表、页码、页脚都在 1280×720 安全区域内
底部 footer、页码、导航按钮不会被内容挤出画布
左右分栏、网格卡片、时间线、流程块之间无重叠
左右分栏 (.grid-2) 两列底部必须对齐，不得出现一侧短、另一侧留有大片空白的情况
关键正文与边缘至少保留安全边距，不出现明显贴边
翻页控件、页码圆点、键盘提示不会遮挡正文内容

如果任一项不满足，返回 HTML 调整步骤，不得继续生成 PPT

Step 3: 用户确认 HTML 后，选择 PPT 生成模式

只有在同时满足以下两个条件后，才允许进入此步骤：

HTML 已完成逐页边界与版式检查，确认没有越界或遮挡问题
用户已明确确认当前 HTML 内容和版式没有问题，可以开始生成 PPT

进入此步骤前，使用 vscode_askQuestions 或用户明确文本确认，拿到类似以下结论之一：

按当前 HTML 生成 PPT
HTML 没问题，可以导出
就用这个版本生成

拿到确认后，再使用 vscode_askQuestions 工具让用户选择导出格式和模式：

导出格式选择

使用 vscode_askQuestions 让用户选择输出格式：

格式	说明	适用场景
PPTX（默认推荐）	生成 .pptx 演示文稿	需要在 PowerPoint 中放映或编辑
PDF	生成 .pdf 文档	只读分发、邮件附件、打印
都要	同时生成 .pptx 和 .pdf	既要放映也要分发

PPT 生成模式选择（仅 PPTX 格式时）

默认推荐：截图高保真 PPT。 只有在用户明确要求“后续需要在 PowerPoint 里继续改字、改布局、改单页内容”时，才优先选择可编辑模式。

模式	说明	优点	缺点
截图高保真模式	将每页 HTML 截图为图片插入 PPT	还原度 100%，与 HTML 完全一致，最适合作为默认推荐	内容不可编辑，文件体积较大
可编辑模式	python-pptx 逐元素重建	文字/形状均可编辑，灵活修改	还原度约 85-90%，复杂布局可能有偏差

导出模式切换规则（新增）

同一轮会话内，用户若改口“还是要不可编辑高清 PPT”，应立即从可编辑链路切回截图高保真链路。
切换模式后不复用对方输出文件名，必须生成新的目标文件并保留历史版本。
对外反馈时必须明确告知本次产物属于哪种模式（可编辑 / 高保真），避免用户误判可改性。

模式 A: 截图高保真 PPT（默认推荐，HTML → 截图 → 插入）

将每页 HTML 幻灯片截图为高清图片，再逐张插入 PPT 作为全页背景图。

截图转换参考模板

读取 references/screenshot-pptx-template.py 获取完整的截图转 PPT 脚本模板。

该模板包含：

capture_slides() — Playwright 逐页截图（2x 高清）
build_pptx() — 截图插入 PPT 全屏背景
auto_detect_total() — 自动检测 HTML 中幻灯片总数
CONFIG 区域只需修改 HTML_FILE 和 OUTPUT_PPTX 路径即可运行

截图时隐藏导航控件（强制要求）

不管输出 PPTX 还是 PDF，只要使用截图方式，必须在截图前通过 JS 隐藏所有导航控件（左右箭头、页码圆点、键盘提示），避免遮挡幻灯片内容：

// 在页面加载完成后、开始截图前执行
document.querySelectorAll('.nav-btn, .page-indicator, .keyboard-hint')
    .forEach(el => el.style.display = 'none');

模板脚本 screenshot-pptx-template.py 已内置此逻辑。自定义脚本也必须包含此步骤。

截图高保真执行步骤

前置条件：HTML 已逐页检查通过，且用户已明确确认可导出。

确认依赖已安装：pip install python-pptx playwright，然后 playwright install chromium
复制模板脚本，修改 CONFIG 中的文件路径
运行脚本生成 .pptx 文件
告知用户输出路径

模式 B: 可编辑 PPT（用户明确要求可修改时，python-pptx 转换）

使用 python-pptx 库将 HTML 内容逐元素映射为 PPT 原生对象。

转换参考模板

读取 references/pptx-converter-template.py 获取完整的可编辑 PPT 转换脚本模板和工具函数库。

该模板包含：

颜色常量定义模式
add_rounded_rect() — 圆角矩形（支持圆角半径调整）
add_text_box() — 文本框（支持字体、颜色、对齐、垂直锚点）
add_multiline_text() — 多行文本段落
add_rich_paragraph() — 富文本（多 run，混合粗体/颜色）
add_circle() — 圆形形状
set_slide_bg() — 幻灯片背景色

PPT 生成要点

幻灯片尺寸：Inches(13.333) × Inches(7.5)（16:9 宽屏）
使用 blank layout：prs.slide_layouts[6]
字体统一为 Microsoft YaHei（PPT 中不依赖 Google Fonts）
颜色不用渐变：python-pptx 中渐变配置复杂，改用纯色近似
圆角矩形：通过 a:avLst 的 adj 值控制圆角半径
富文本：单个文本框内用多个 run 实现粗体/颜色混排
垂直居中：通过设置 bodyPr 的 anchor='ctr' 实现

执行步骤

前置条件：HTML 已逐页检查通过，且用户已明确确认可导出。

确认 python-pptx 已安装：pip install python-pptx
基于模板生成定制化 Python 脚本
- 单页版：一个函数构建一页 slide
- 多页版：每页一个 build_slideN() 函数，共享颜色常量和工具函数，主函数循环调用
运行脚本生成 .pptx 文件
告知用户输出路径

模式 C: 截图高保真 PDF（HTML → 截图 → 合并 PDF）

将每页 HTML 幻灯片截图为高清图片，再使用 reportlab 合并为 PDF 文档。

PDF 导出执行步骤

前置条件：HTML 已逐页检查通过，且用户已明确确认可导出。

确认依赖已安装：pip install playwright reportlab，然后 playwright install chromium
截图流程与模式 A 完全相同（包括隐藏导航控件）
使用 Pillow 或 reportlab 将截图合并为 PDF：

# 方式 A：Pillow（最简洁，推荐）
from PIL import Image
images = [Image.open(s).convert('RGB') for s in screenshots]
images[0].save(output_pdf, save_all=True, append_images=images[1:], resolution=144.0)

# 方式 B：reportlab（精确控制页面尺寸）
from reportlab.pdfgen import canvas
page_w = VIEWPORT_W * DEVICE_SCALE  # 2560
page_h = VIEWPORT_H * DEVICE_SCALE  # 1440
c = canvas.Canvas(output_pdf, pagesize=(page_w, page_h))
for img_path in screenshots:
    c.drawImage(img_path, 0, 0, width=page_w, height=page_h)
    c.showPage()
c.save()

告知用户输出路径

两种方式均可：Pillow 方式代码最简但页面尺寸由图片分辨率决定；reportlab 方式可精确控制 PDF 页面尺寸。如果同时导出 PPTX + PDF，截图只需做一次，分别喂给两个构建函数。

元素映射关系（HTML → PPT，仅可编辑模式）

HTML 元素	PPT 实现
渐变背景	纯色 `RGBColor` 近似
`border-left` 色条	`MSO_SHAPE.RECTANGLE` 窄矩形
圆角卡片	`MSO_SHAPE.ROUNDED_RECTANGLE` + `avLst`
图标 emoji	`add_text_box()` 文本框放 emoji
富文本（粗体/链接色）	多个 `run` 设置不同 `font` 属性
输入框	圆角矩形 + 文本框叠加
分隔线	极窄矩形 `height=Pt(1.5)`
圆形头像/状态点	`MSO_SHAPE.OVAL`
底部指标横幅	圆角矩形 + 居中文本框

One thing to look at

What its author says it does

SKILL.md

HTML to PPTX — 商务演示文稿生成

工作流概览

本次实战经验固化

2026-05-30 延峰项目增补（强制）

资料驱动型 PPT 的处理顺序

技术方案类 PPT 推荐叙事结构

版式与导出踩坑记录

SVG 装饰插图踩坑记录

左右分栏等高对齐踩坑记录

2026-05-31 图文分栏对齐补充（强制）

对齐问题诊断清单

减少空白与紧凑排版踩坑记录

字体放大与溢出联动踩坑记录

PDF 导出踩坑记录

导出后的强制校验

Step 1: 收集需求

确认页眉页脚风格

公司品牌模板 Logo 素材

确认 PPT 规模

Step 1.5: 默认模板 — 公司模板（唯一模板）

视觉方向

配色体系

页面级背景策略

核心装饰母题：紫色球体 + 轨道环 + 玻璃菱形

封面页规范

章节分隔页规范（标题页）

结尾页规范

内容页组件规范

动画规范

实战踩坑要点

各规模推荐页面结构

Step 2: 生成可翻页 HTML 预览

翻页 HTML 结构

每页幻灯片内容结构

设计原则

封面与内容页差异化设计准则

封面页：简洁美观

内容页：详实丰富、图文搭配

图文结合的反 AI 味准则（强制）

图片素材获取与回退策略（强制）

有联网能力时（默认流程）

无联网能力时（回退流程）

通用规则

图文分栏布局标准模式（强制）

关键规则

不同页面类型的图片面板宽度建议

产品截图 vs 背景配图

表格页图文分栏示例

内容间距规范（强制）

表格行间距实现

禁止的紧凑写法

多元素对称与布局规范

硬性版式约束

推荐布局结构

封面页布局

内容页布局（左右分栏）

内容页布局（全宽）

总结页 / Q&A 页布局

多页 PPT 的设计一致性

HTML 技术要点

交付物

HTML 预览后的强制门禁

HTML 检查清单

Step 3: 用户确认 HTML 后，选择 PPT 生成模式

导出格式选择

PPT 生成模式选择（仅 PPTX 格式时）

导出模式切换规则（新增）

模式 A: 截图高保真 PPT（默认推荐，HTML → 截图 → 插入）

截图转换参考模板

截图时隐藏导航控件（强制要求）

截图高保真执行步骤

模式 B: 可编辑 PPT（用户明确要求可修改时，python-pptx 转换）

转换参考模板

PPT 生成要点

执行步骤

模式 C: 截图高保真 PDF（HTML → 截图 → 合并 PDF）

PDF 导出执行步骤