SuperAPI AI 工具集

rich-html-presentation

办公与效率

查看项目

更新于 10-16 14:52

技能介绍

用途

rich-html-presentation 是一项用于制作自包含 HTML 网页幻灯片(浏览器幻灯片、keynote 风格演示文稿)的技能。只要用户提出创建、构建或修订这类演示文稿的请求,即可使用该技能。最终产出是单个 .html 文件,内联 CSS 与 JS,无外部依赖。

主要能力与设计系统

技能以 references/template.html 与 references/components.md 为设计系统的唯一来源。使用时应逐字复制模板的 <style> 块和全部五个 <script> 块,不改写导航或主题引擎,仅修改幻灯片内容、<title> 和 .brand 标签。模板提供可复用的组件目录,例如 .card 网格、.callout、.chips、.steps、动画 .tf 脊柱时间线(静态 .timeline 作为安静的替代方案)、.bars 条形图(用于数字、排名、比较)、.flow-panel/.loop、.asset-num、.plat 彩色列等,并配有 CSS 变量与 cN 强调类以保证两种主题下均正确显示。

演示文稿结构与内容规范

内容方面要求:先收集内容,若演示基于用户的真实世界资料(会议记录、文档、项目、产品),应先用相应工具(SearchM365、ListCalendarView 与会议记录工具、ReadFileContent、web_search)检索,找不到的内容使用清晰标记的占位符(如 [Add Q3 number]),绝不编造姓名、数字、引文或日期。每张幻灯片一个观点,节奏约每张 1.5–2 分钟,并对照目标时长说明幻灯片数量。典型结构为:标题 → 背景/原因 → 4–8 张概念幻灯片 → 选项/比较幻灯片 → 编号的功能/资产串 → 行动号召步骤列表 → 带链接的时间线/收尾。幻灯片应尽量短以适应较短的视口(预览窗格约 1200×672),每张建议 4–6 张卡片,超过则拆分。若内容包含数量,至少渲染一张 .bars 图。首张幻灯片保持 class="slide title-slide active",其余为 class="slide";<span id="tot"> 硬编码真实幻灯片数量。

预览环境的约束(引擎为何如此设计)

演示文稿常在嵌入式预览中打开(Teams 文件预览、Outlook 阅读窗格、SharePoint 预览),这些宿主会重写文档并施加三项限制:超过约 2000 字符的内联脚本会被静默地不执行;每个内联脚本被包裹,顶层 const/let 不进入共享全局作用域;每个内联脚本可能有自己的全局对象,跨块通信不可靠。因此模板将引擎拆分为五个互相独立的小脚本,绝不合并,也不让一个脚本依赖另一个脚本的变量;需要触发其他脚本时改派发 DOM 事件(如滑动处理器派发 ArrowRight/ArrowLeft keydown)。每个 <script> 应保持在约 1700 字符以下以留出余量。这些失败是静默的:CSS 仍生效,演示文稿看起来正常但导航已失效,因此模板硬编码真实幻灯片总数。这些限制属观察到的行为而非厂商文档约定,可能变化,应以第 5 步的检查重新验证。

演讲者备注(可选)

模板自带可折叠备注托盘。在 <section class="slide"> 内写 <div class="spk">…</div> 作为该张幻灯片备注,它们不会显示在幻灯片上。N 切换托盘,Esc 折叠,折叠条上的 Hide 链接可将其从屏幕移除(N 可恢复)。仅当用户要求或演讲者不在现场时添加备注;备注不私密,随文件一同分发,不应放入不宜交给接收者的内容;对外分发时建议直接移除 .spk 块。若没有备注,应删除托盘(标记、CSS 块与脚本块),空托盘比没有托盘更糟。

交付方式与验证

交付前先判断宿主:在 Cowork 等支持 artifact 的宿主上存在 CreateArtifact / EditArtifact / CopyArtifact 工具,用 CreateArtifact(surface="output"、.html 路径)创建,后续用 EditArtifact 修改;output/ 对 Write 工具只读。在 Copilot Studio 等无 artifact 工具的宿主上,将完整 HTML 写入宿主的文件输出位置(常见如 /app/created/,需按宿主惯例确认),并在同一轮作为可下载附件返回;不要在上一轮就地编辑后报告完成,每次交付都必须是当前回复附带的崭新文件。无 artifact 宿主上每次编辑都要使用递增文件名(<topic>-v1.html、-v2.html…),并告知用户当前版本。验证交付时:artifact 宿主运行 Glob output/**/* 确认 .html 存在;非 artifact 宿主确认文件已附在当轮响应。

预览检查(Step 5a)

在文本层面:计数前先去除 HTML 与 CSS 注释(包括 /* … */),以免注释中引用的 <script>、<section class="slide">、<div class="spk"> 造成误判;每个 <script> 按实际文件的字符数应低于约 1700(CRLF 每行多约 1 字节);不得存在跨块状态;计数器总数与标记中的真实幻灯片数一致;.slide 上仍保留 justify-content: safe center(并在其前声明普通 center 回退),且两个 @media (max-height: …) 块存在。若可渲染,以 1200×672 加载并检查两点:无幻灯片出现 scrollHeight > clientHeight(溢出);固定定位的 .brand(左上)、.counter(左下)、.nav(右下)是否与幻灯片首行/末行内容碰撞(应测量文本而非块,因 .content 子元素为全宽)。最后报告幻灯片数量并说明预览检查通过。

输出与控制

输出为单个自包含 .html 文件(内联 CSS + JS,无外部依赖)。默认深色主题,加载时跟随操作系统设置,并带可用的明暗切换。导航支持 ←/→(以及 PageUp/Down、空格)、Home/End、屏幕上的 ‹ ›、F 全屏、T 主题、触摸滑动。可选演讲者备注托盘。应告知用户文件名、幻灯片数量和控制方式。

限制与护栏

不得编造事实,先查用户真实数据,缺口用可见占位符。保留设计系统,保持模板 <style> 与五个 <script> 块完整,不要另做一套外观。绝不合并引擎脚本。仅自包含,内联一切,不用 CDN 链接或外部图片 URL。声称完成前必须验证文件已到达用户。交付方式需与渠道匹配。格式选择要正确:.pptx 请求应转向 PowerPoint/pptx 工作流,静态文档(备忘录/报告)请求应转向文档写作工作流,而不是强行套用本演示模板。可访问性方面,两种主题下保持可读对比度,不要移除键盘导航。

未提供的信息

本资料未提供该技能的收费、价格、平台支持范围、运行效果数据或具体安装命令等信息,暂未提供。