openpress-create-slide

open-press 创建幻灯片

将幻灯片组创建为一系列可直接编辑的幻灯片源文件。每张幻灯片自行负责排版；Press 只负责幻灯片组注册、主题和真正共享的 UI。

基本原则

• 从受众、每张幻灯片传达的唯一信息以及支持该信息的证据入手。
• 每张幻灯片只表达一个视觉概念。与其使用密集的文字，不如优先采用示意图、图片、对比或醒目的数字。
• 新幻灯片应直接从源文件开始创建，不能通过注册表或预选布局资源来创建。
• 只有在某个视觉元素确实重复出现后，才复用本地组件。将其放在 press/<slug>/ui/ 或 press/<slug>/components/ 中。

修改源文件前请阅读

1. 阅读幻灯片组的 press/<slug>/press.tsx、当前使用的 theme/default.css 以及附近的幻灯片。

2. 用简短的 STYLE 说明描述幻灯片组的视觉方向：字体比例、调色板、间距和预期的视觉语言。

3. 对于新的或经过重组的幻灯片组，编写简洁的交付结构：

   AUDIENCE: who must understand what
   STORY:
   - id | composition | one message | evidence or visual
   PRODUCE: direct slide sources, active theme, only proven shared UI
   

4. 除非用户要求更改，否则保留现有的幻灯片顺序和 ID。

源文件规范

• press/<slug>/press.tsx 使用仅包含标记的 <Slide id="…" /> 条目注册幻灯片 ID。
• 每个 press/<slug>/slides/<id>/slide.tsx 都显式导入并组合所需对象。
• 幻灯片画布固定为 1920 × 1080。保留单个 <Slide> 根元素、可预测的 <Frame> 边界以及字面量 meta。
• meta 中的 layout 用于向读者描述排版；它不会选择源文件或生成幻灯片。
• 将幻灯片组的设计令牌放在 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。生成的占位内容有意保持精简：请用幻灯片的实际排版替换占位内容，不要保留样板代码。

对于新的视觉处理方式：

1. 在幻灯片源文件中构建排版。
2. 只有在相同结构有第二次实际用途后，才提取本地视觉元素。
3. 根据共享组件的作用为其命名（EvidenceGrid、SectionKicker），不要使用通用的布局类别名称。
4. 内容和元数据应保持足够直观，便于检查源文件和浏览内容。

调整顺序和移除

使用 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，然后再报告完成情况。