open-design-landing-deck 是做什么的?
与 open-design-landing 相辅相成的技能。使用相同的 Atelier Zero 视觉系统(暖纸色、Inter Tight + Playfair Display 字体、斜体衬线强调、珊瑚色圆点),但以水平杂志风格滑动卡片形式分页呈现,而非长滚动页面。
导航模型有意借鉴了 guizang-ppt 技能——←/→ 箭头键、滚轮/滑动、ESC 概览网格——使其感觉像在翻印刷杂志,而不是滚动网页幻灯片。
inputs.json + ../open-design-landing/styles.css
│
└──────────► scripts/compose.ts
│
▼
<out>/index.html
(一个视口一张幻灯片,水平滑动)
内容概览
- 一个自包含的 HTML 文件,包含 N 个视口大小的幻灯片,水平排列在一个经过变换的 flex 轨道上。
- 键盘导航:
←/→·↑/↓· PageUp/PageDown · Space · Home/End。 - 滚轮 + 触摸滑动(具有动量保护,防止单次触控板轻扫过度滑动)。
- 每张幻灯片的 chrome 条:品牌标识、幻灯片标题、位置、罗马数字年份、实时幻灯片计数器(
01 / 11)。 - 珊瑚色进度条位于底部,随翻页前进而填充。
- 圆点指示器条位于底部附近;点击任意圆点即可跳转。
- ESC 概览网格——每张幻灯片的缩放缩略图,点击即可跳转。与
guizang-ppt的概览 UX 一致。 - 复用姐妹技能的相同 16 槽图片库——无需重复资产。
幻灯片类型
| 类型 | 用途 |
|---|---|
cover | 开头的标题页。两栏文字 + 拼贴艺术。 |
section | 章节之间的罗马数字分隔符。居中,全出血。 |
content | 眉题 + 标题 + 正文 + 项目符号 + 可选的拼贴艺术。 |
stats | 最多 4 个大型数据单元格(数值 · 标签 · 子标签)。 |
quote | 引用段落 + 作者。右侧可选的肖像拼贴。 |
cta | 结尾陈述 + 1-2 个按钮。 |
end | 超大的斜体衬线收尾词 + 签名页脚。 |
一个典型的 11 张幻灯片演讲:
1. cover — 标题页,英雄拼贴
2. section — "I. 问题"
3. content — 关于/宣言,项目符号
4. content — 能力,项目符号
5. stats — 4 个数字
6. section — "II. 使用感受"
7. content — 方法,项目符号
8. content — 精选作品
9. quote — 客户评价
10. cta — 主要 + 次要操作
11. end — 超大收尾词 + 签名
工作流程
1. 编辑 inputs.json
从 inputs.example.json(Open Design 演讲幻灯片)开始。品牌块、图片策略和资产路径与姐妹技能保持一致——如果你已经填写了 open-design-landing 的摘要,直接复制 brand 和 imagery 即可。
对于每张幻灯片,选择一个 kind 并根据 schema.ts 填写类型字段。MixedText(无衬线基线 + 斜体衬线强调跨度 + 珊瑚色终止圆点)与姐妹技能使用的编码相同——参见其 inputs.example.json。
2.(可选)生成或暂存图片
该技能不自带图片生成器或占位符脚本——它共享 open-design-landing 的 16 槽库。要重新生成或暂存:
# 通过 gpt-image-2 生成(fal.ai)
FAL_KEY=... npx tsx ../open-design-landing/scripts/imagegen.ts ../open-design-landing/inputs.example.json --out=../open-design-landing/assets/
# 或纸质纹理 SVG 占位符
npx tsx ../open-design-landing/scripts/placeholder.ts ../open-design-landing/assets/
将你的幻灯片的 inputs.imagery.assets_path 设置为这些 PNG 文件所在的路径(示例中默认为 ../open-design-landing/assets/)。
3. 组合幻灯片
npx tsx scripts/compose.ts inputs.json out/index.html
组合器读取 inputs.json,从 ../open-design-landing/styles.css 加载规范的 Atelier Zero 样式表,在其上叠加幻灯片特定的规则(水平 flex 轨道、幻灯片布局、HUD、圆点导航、ESC 概览、键盘/滚轮/触摸处理程序),并写入一个自包含的 HTML 文件。
4. 自检
- 在新浏览器标签页中打开 HTML;幻灯片 1(封面)显示时,右上角的 chrome 条显示
01 / N。 - 按
→(或 Space,或向下滚动)。平滑地向右滑动一个视口;圆点导航前进;珊瑚色进度条前进一格。 - 按
End。跳转到最后一张幻灯片。 - 按
Home。返回到幻灯片 1。 - 按
Esc。概览网格出现,显示缩放缩略图;点击任意图块即可跳转并关闭概览。 - 将浏览器窗口大小调整为 1080px 和 640px。封面/内容幻灯片折叠为单列;圆点导航仍然有效;chrome 条缩小。
-
prefers-reduced-motion: reduce(DevTools → 渲染):页面过渡保持敏捷,不会引起晕动。 - Lighthouse:对比度 AA,font-display swap,无布局偏移。
边界
- **复用姐妹技能的样式表。**组合器在编译时读取
../open-design-landing/styles.css。不要在此处维护重复副本;如果 Atelier Zero 令牌发生变化,请只在姐妹技能中编辑一处。 - **复用姐妹技能的图片库。**无需重新提示或重新渲染——相同的 16 块模板适用于两种表面。
- **保持幻灯片为单视口。**如果幻灯片内容在 1280×800 下不适应 100vh × 100vw,则会溢出并感觉拥挤。请精简文案或拆分为两张幻灯片。
- **不要切换到垂直滚动吸附。**水平滑动姿态是使此技能感觉像杂志跨页的原因;垂直滚动器只会变成一篇长文章。
- **不要添加路由器。**这是一个单文件产物。多页幻灯片超出范围;对于多幻灯片卡体验,请单独渲染每张幻灯片并从父索引链接。
参见
open-design-landing— 落地页姐妹技能。guizang-ppt— 此技能借用的杂志卡片导航模式。design-systems/atelier-zero/DESIGN.md— 令牌规范。