by 运行时依赖
安装命令
点击复制技能文档
html-slide-to-pptx 将结构化的 HTML幻灯片转换为可编辑的PPTX文件，通过解析语义块并将其映射到原生PowerPoint对象。该技能是预设驱动的。当HTML属于支持的幻灯片家族时，重用现有的预设；当HTML属于新的幻灯片家族时，添加新的预设。不要承诺任意的HTML/CSS保真度。
首步： 读取传入的HTML并识别幻灯片家族。 将输出PPTX文件放在./output/.pptx（如果目录不存在则创建）。 如果您是在新机器、新的代理或依赖状态不明确的情况下，首先阅读references/setup.md。 在新环境中第一次使用前，运行npm run check-env。 如果缺少依赖项，运行npm ci或npm install。
工作流： 确定HTML是否属于支持的预设。 将HTML解析为小型中间模型，而不是尝试渲染任意CSS。 使用捆绑的脚本生成PPTX文件，使用原生文本/形状。 对生成的结果或提取的模型运行QA/预检审查。 打开或预览PPTX文件并检查间距、溢出和箭头方向问题。 当保真度不够好时，迭代预设映射。
当前支持： 预设：v9-architecture 用于此确切或近似结构：标题、品牌、标题、核心摘要框、左侧驱动面板、中心分层架构栈、右侧判断链面板。 预设：ai-runtime-page 用于此确切或近似结构：标题、品牌、标题+引导框、输入芯片行、主运行时框（5个模块）、支持层卡、输出芯片行、基础层+总结。
命令： 验证环境：npm run check-env 将HTML转换为PPTX：# 输出默认保存到./output/.pptx node scripts/html_to_pptx.js ./output/.pptx [--preset=v9-architecture|ai-runtime-page] [--dump-model ] 运行预检QA：node scripts/preflight_qa.js [--preset=v9-architecture|ai-runtime-page] [--report ]
当没有预设匹配时： 不要强制转换任意HTML。 如果HTML结构与现有预设有意义上的不同，通过实现所有三个层次添加新的预设：DOM提取规则、布局/渲染映射规则、QA/预检规则。 仅当页面家族真正接近时才重用现有预设。 如果结构在信息架构上有所不同，添加新的预设而不是过载旧的预设。
规则： 优先使用语义映射而不是截图嵌入。 首先保留可编辑性，然后迭代向保真度靠近。 将浏览器渲染视为参考，而不是生成引擎。 为每个生成的结果运行QA。 如果设置或可移植性是问题，请阅读references/setup.md。 如果扩展支持，请先阅读references/preset-decision-rules.md，然后阅读references/presets.md、references/preset-template.md和references/qa-heuristics.md。
参考： 在安装或使用技能在新机器/代理时，阅读references/setup.md。 在决定是否重用、扩展或替换预设时，阅读references/preset-decision-rules.md。 在扩展到新幻灯片家族时，阅读references/presets.md。 在创建全新的预设时，阅读references/preset-template.md。 在设计或调整预检检查时，阅读references/qa-heuristics.md。 在规划更高保真度的HTML测量或混合背景/文本层方法时，阅读references/roadmap.md。 阅读references/usage-principles.md以获取完整的5规则使用指南。 阅读README.md以获取人类友好的概述、设置摘要和可移植性注意事项。