用途
openpress-create-slide 用于在 OpenPress 中创建、编辑、重排和验证幻灯片演示文稿(slide deck)。它的核心理念是把演示文稿表达为一系列“直接、可编辑的幻灯片源码”。每张幻灯片拥有自己的构图;Press 只负责演示文稿注册、主题以及真正共享的 UI。
主要能力
- 创建、编辑、重排与校验 OpenPress 幻灯片。
- 新增幻灯片以直接源文件形式出现,不经过注册表或预选布局资源。
- 支持通过 CLI 重排、移除幻灯片并查看状态。
- 提供审查清单,用于检查信息传达、图表可读性、源码自包含性与共享组件合理性。
使用方式
基本原则
- 从受众、每张幻灯片的单一信息和支撑证据出发。
- 每张幻灯片只保留一个视觉想法;优先使用示意图、图片、对比或大数字,而不是密集的文字。
- 新幻灯片以直接源文件开始,绝不通过注册表或预先选定的布局资产创建。
- 只有当某个视觉原语确实被重复使用时,才复用本地组件。组件放在 press/<slug>/ui/ 或 press/<slug>/components/ 下。
修改源码前先阅读
- 阅读演示文稿的 press/<slug>/press.tsx、当前主题 default.css 以及相邻幻灯片。
- 用简短的 STYLE 说明陈述演示文稿的视觉方向:字号层级、配色、间距和预期的视觉语言。
- 对于新的或重构的演示文稿,写一个紧凑的交付形状:AUDIENCE(谁必须理解什么)、STORY(id | 构图 | 单一信息 | 证据或视觉)、PRODUCE(直接幻灯片源码、当前主题、仅已验证的共享 UI)。
- 除非用户要求更改,否则保留现有幻灯片顺序和 ID。
源码契约
- press/<slug>/press.tsx 使用仅含标记的 <Slide id="…" /> 条目注册幻灯片 ID。
- 每个 press/<slug>/slides/<id>/slide.tsx 显式导入并组合自己所需的对象。
- 画布固定为 1920 × 1080。保持单一 <Slide> 根、可预测的 <Frame> 边界和字面 meta。
- meta 中的 layout 描述构图供读者参考,它不选择源码也不生成幻灯片。
- 将演示文稿 token 放在 press/<slug>/theme/default.css。幻灯片专用 CSS 放在该幻灯片旁,或被整个演示文稿共享时放入当前主题。
- 在有助于清晰表达几何、语义结构或响应式约束时,使用 @open-press/core 对象;创作的细节使用普通 TSX 和 CSS。
- 创建幻灯片前阅读 references/layout-contract.md;修改样式时阅读 references/css-colocate.md;添加文件时阅读 references/press-tree.md。
添加与编辑幻灯片
使用以下命令创建空白幻灯片源码:
open-press slide add <id> --press <slug>
然后直接编辑 press/<slug>/slides/<id>/slide.tsx。生成的占位内容刻意保持最小,应替换为该幻灯片的实际构图,而不是保留样板。
对于新的视觉处理:
- 在幻灯片源码中构建构图。
- 只有当相同结构出现第二次真实使用时,才抽取本地原语。
- 共享组件按其角色命名(EvidenceGrid、SectionKicker),而不是按通用布局类别命名。
- 保持内容和元数据足够字面,便于源码检查和读者导航。
重排与移除
使用 CLI 保持注册和目录一致性:
open-press slide move <id> <position> --press <slug>
open-press slide remove <id> --press <slug>
open-press slide status --press <slug>
审查清单
- 每张幻灯片是否在演讲语速下传达一个主张?
- 图片、图表和示意图在演示距离下是否清晰可读?
- 幻灯片源码是否自包含且可直接编辑?
- 共享组件是否由真实复用而非预期复用所支撑?
- 当前主题是否提供演示文稿所需的间距和对比度?
- 导航、幻灯片顺序、备注、源码视图和焦点状态是否仍然正常?
验证
使用以下命令验证源码变更:
npm run typecheck
npm test
npm run build
对于视觉相关工作,还要运行 npm run dev:workspace,并在报告完成前在 Workbench 中检查受影响的 Press。
适用场景
适用于需要以源码方式编排 OpenPress 演示文稿、对每页构图进行精细控制、并希望幻灯片可被源码审阅和导航的场景。
限制
资料未提供关于收费、价格、平台依赖等更多信息,暂未提供。