From 8cad17760de99ceaa7f111b03403d691be989dc1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=83=AD=E6=B5=A9?= Date: Thu, 6 Aug 2026 22:50:45 +0800 Subject: [PATCH] feat: expand presenter mode toolkit --- SKILL.md | 18 +- assets/template-swiss.html | 377 +++++++++++++++++++++++---- assets/template.html | 379 ++++++++++++++++++++++++---- references/checklist.md | 10 +- references/presenter-mode.md | 125 +++++++-- scripts/validate-presenter-mode.mjs | 30 ++- 6 files changed, 800 insertions(+), 139 deletions(-) diff --git a/SKILL.md b/SKILL.md index 172df75..2b15406 100644 --- a/SKILL.md +++ b/SKILL.md @@ -28,7 +28,7 @@ description: 生成横向翻页网页 PPT(单 HTML 文件),含 WebGL 背 - 模板:`assets/template-swiss.html` · 主题色:`references/themes-swiss.md` · 布局:`references/layouts-swiss.md` - 美学锚点:像 Massimo Vignelli + Helvetica Forever -**两种风格共享**:横向翻页(键盘 ← →、滚轮、触屏、ESC 总览)、右下角 `P` 演讲者模式、当前/下一页预览、讲稿备注、计时、观众屏状态与断线恢复、Lucide 图标、Motion One 入场动效(本地 + CDN 双保险)。 +**两种风格共享**:横向翻页(键盘 ← →、滚轮、触屏、ESC 总览)、右下角 `P` 演讲者模式、当前/下一页 16:9 预览、讲稿备注、逐页计时、排练记录、可选自动翻页、激光笔/圈选、观众屏黑白屏/冻结、同步状态与断线恢复、演前检查、Lucide 图标、Motion One 入场动效(本地 + CDN 双保险)。 @@ -115,10 +115,10 @@ git -C "" pull --ff-only 如果用于正式演讲,页面计划不能只有“这一页放什么”,还要同时规划“台上说什么”。先读 `references/presenter-mode.md`,给每页确定稳定的 `data-slide-id`,并补齐: -| 页码 | 页面 ID | 页面目的 | 观众可见信息 | 演讲者补充 | 建议时长 | 转场 | cue | -|---|---|---|---|---|---:|---|---| +| 页码 | 页面 ID | 章节 | 页面目的 | 观众可见信息 | 演讲者补充 | 建议时长 | 转场 | 可选现场信息 | +|---|---|---|---|---|---|---:|---|---| -默认生成 3-5 条提词卡式讲述要点,不写逐字稿;只有用户明确要求逐字稿时才展开。总建议时长最多占用户时长的 90%,给停顿、互动和现场意外留缓冲。 +默认生成 3-5 条提词卡式讲述要点,不写逐字稿;只有用户明确要求逐字稿时才展开。总建议时长最多占用户时长的 90%,给停顿、互动和现场意外留缓冲。用户没有提供的现场信息不猜测:时长缺失时显示横杠,其他可选模块整段隐藏。 大纲建议保存为 `项目记录.md` 或 `大纲-v1.md`,便于后续迭代。 @@ -237,9 +237,11 @@ cp "/assets/template-swiss.html" "项目/XXX/ppt/index.html" - `purpose` 说明这一页在整场叙事中的任务。 - `talk` 补充背景、例子、判断依据和语气,不逐字复述 slide。 - `transition` 解释为什么下一页紧接着出现。 -- `cue` 只写停顿、提问、Demo、视频、敏感信息提醒等舞台动作。 +- `section` 只在大纲已给出章节或连续页面明显属于同一章节时填写。 +- `minutes` 是讲述计划;`autoAdvanceSeconds` 是播放行为,两者必须分开,且后者只在用户明确要求时填写。 +- `cue / interaction / delivery / advance / fallback / pronunciation` 只写大纲或用户明确提供的舞台动作、互动、表达、翻页、备用和读音信息。 -没有来源支持的事实不能写进备注;缺失信息要标记“待补充”或询问用户。 +没有来源支持的事实不能写进备注;影响内容正确性的缺失信息要标记“待补充”或询问用户,不影响内容的可选演讲信息直接省略。 #### 3.0 · 预检:类名必须在模板的 `