用途:为 HyperFrames 幻灯片项目生成静态总览(overview)页面。适用于一个 topic 文件夹内约有 15 张幻灯片的组合,需要在不动画播放的情况下逐页查看幻灯片最终状态、快速复制 CSS 选择器进行修改、或需要比 npx hyperframes preview 更轻量的浏览方式时。
主要能力:生成 topics/<主题>/overview.html 单文件,无需框架运行时。左侧为所有幻灯片缩略图条(16:9 缩小,可点击跳转);右侧为当前选中幻灯片的细节预览(1920×1080 缩放适配视口)。导航支持 ←/→、↑/↓、空格、数字键(1–9,0 为 10)及顶部按钮。Aim 检查器可通过右上角 Aim 按钮悬停并点击元素,将形如 [data-slide="3"] > div.stat:nth-of-type(2) > div.num 的 CSS 选择器复制到剪贴板。Edit 文本编辑为必需子模块 hyperframes-overview-edit:Edit 按钮配合 contentEditable 直接修改,live 服务器下立即保存到 index.html 与 overview.html,静态服务器下复制 agent 可读的补丁到剪贴板。
使用方式:先检查 topic 内 index.html 的场景结构,读取 template.html 并替换 {{TOPIC_ID}}、{{TOPIC_BRAND}}、{{SLIDE_COUNT}}、{{ACCENT_HEX}}、{{ACCENT_RGB}}、{{SCENE_VARS}}、{{SCENE_STYLES}}、{{SLIDES_HTML}} 等占位符。场景转换时移除 clip 类与 timing 属性及 id,改为 data-slide 与 data-skill,并添加 brand、slide-num 页脚。16:9 使用 js-slide.html,卡片新闻使用 js-card.html。含图片时用 serve.sh 起本地服务:bash .codex/skills/hyperframes-overview/serve.sh topics/<主题>(可指定端口),随后访问 http://localhost:8765/overview.html。
限制:data-skill 类型由 hyperframes-slide 上级技能决定,本技能只负责生成静态预览页;Edit 子模块必须一并应用,否则无法编辑文本(可用 grep -L "class="edit-btn"" topics/*/overview.html 检查遗漏)。页面无动画,所有元素渲染最终状态,禁用 GSAP、data-start、opacity: 0 等动画属性。图片路径必须为相对路径,外部 URL 需先下载到 assets/。file:// 打开含图页面可能因 CORS 出错,需通过 HTTP 服务访问。npx hyperframes lint 不检查 overview.html。更多实现细节与解析规则见 hyperframes-overview-edit。