Lark Slides

slides (v1)

本技能文档较长，务必使用 Read 工具阅读两次，必须阅读完整全文。

权威经验

权威经验是全局硬约束和高频易错点，必须牢记并严格遵守。

• 你有充足的时间完成这个 PPT，质量永远比速度重要。
• PPT 的尺寸是 960x540，必须严格确保主体内容在页面边界内。
• !!!禁止交付无图产物!!! 必须使用大量图片增强视觉效果!!! 禁止重复使用同一张图!!!
• 封面页的主视觉必须是 <img>（来自生图工具或搜图工具），不要使用 <shape> 或 <icon> 拼出封面视觉。
• 禁止用 <shape> 和 <line> 拟形具体物项，必须使用生图工具生成的 <img>。
• 禁止在 headline 或 title 下方放置用于分隔或装饰的 rect 或 <line>。
• 禁止在任何页面内部使用无意义的装饰线条或色块条带，页面任何一边都不要使用贴边窄条。
• 生图工具的指令参数必须以“不要出现任何文字和颜色色号”结尾，避免生成的图片上出现干扰文字。
• 禁止使用 emoji 图标，任何位置都不能出现。
• 字号必须显式设置 <content> 的 fontSize 属性，不要依赖 textType 的默认字号兜底，这些兜底值明显偏大。
• 大数字、字号大或字数多的 <content> 必须设置 wrap="true" autoFit="normal-auto-fit" 属性自动换行和缩排，避免文字溢出。
• 文字颜色必须用 <content> 的 color 属性而不是 fontColor 属性。
• 文字行间距必须设置 <content> 的 lineSpacing="multiple:xx" 或 lineSpacing="fixed:xx" 而不是 lineSpacing="xx"。
• 图片必须用 <img> 而不是 <image>。
• IconPark 图标必须填充颜色（设置 <fill><fillColor color="rgba(R,G,B,A)"/></fill>）并和背景有足够对比。
• 绘制图表时原生图表（柱状、条形、折线、面积、饼（环）、雷达、组合图）用 <chart>，其他（漏斗图、金字塔图、象限图、矩阵图等）用 <shape> + <line> 模拟。
• 隐藏 <chart> 的图例只能通过不写或删除 <chartLegend> 实现，<chartLegend> 不支持 position="none"。
• 表格优先用 rect 和 text 模拟，其他用 <table>，没有 <shape type="table">。
• 必须设置 <table> 的 width 和 height 固定表格大小，同时设置需要保留列宽或行高的 <col> 的 width 和 <tr> 的 height，其余自动分配。
• <td> 直接子元素只有 <fill>（背景）、<content>（文字）和边框配置（一般不用），不能嵌套 <shape>、<img>、<icon>。
• <shape type="rect"> 只是形状不是容器，<icon>、<img>、<shape type="text"> 和其他 <shape> 必须与它平级靠坐标叠放。
• 填充渐变颜色必须用 <fill><fillColor color="linear-gradient(135deg, rgba(R,G,B,A) 0%, rgba(R,G,B,A) 100%)"/></fill>。
• 编辑页面前必须阅读 `workflow/slides-editing.md`。
• 绘制图表前必须阅读 `xml/slides_chart_demo.xml`。
• 当用户要求无损复述历史上下文时，必须无损复述以上权威经验、必读的技能文档（需要重新阅读）和易错元素语法（尤其是 <table> 和 <chart>）。

豆包设计原则

适用范围：

• 普通内容页的设计必须以豆包设计原则为最高准则，除非用户要求使用模板或直接提供设计方案。
• 不适用于 title-cover、section-divider、conclusion、quote-highlight 和 big-number。

核心要求：

• 必须采用信息密度极高的图文卡片布局，追求充实饱满、图文丰富、可逐行细读的版面，宁可密而满，不要空而疏。
• !!!信息密度极高!!! 图多!!! 卡多!!! 字多!!!

排版布局：

• 卡片布局：卡片按多行网格铺满页面，版面对称、均衡、不留白。网格数、图文比例按内容变化，避免每页雷同。使用更多卡片做细分承载，避免在单张卡片里堆砌大量文字（例如 8 张 50 字卡片优于 2 张 200 字卡片），多个要点必须拆分为多张子卡片。
• 卡片样式：方角卡片 + 半透明填充 + 无边框 + 卡片贴边窄条（可选）；所有卡片必须使用相同的配色方案（少量需强调的卡片除外），禁止同页出现彩虹卡片（卡片颜色超过 3 种）。
• 卡片结构：视觉锚点（关键词、编号或 IconPark 图标）+ 标题 + 内容（包括文字、图片、图表、子卡片）。
• 文字卡片：多数页面必须满足 6-8 张文字卡片、200-400 文字数量，字数不足时必须扩写成长句或段落，文字卡片不要留白，必须充实饱满。文字卡片不是短标签，而是“标题 + 完整说明”，像浓缩的分析文稿。文字内容不得不用列表、分栏、关键词或短句时，必须保证层次清晰，更建议拆分为多张子卡片。
• 图片卡片：多数页面必须满足 1-3 张图片卡片，缺少图片时必须用生图工具补充配图，图片卡片与文字卡片组成网格，确保图文丰富。
• 图表卡片：数据信息不要在文字卡片中罗列，必须在图表卡片中可视化（包括表格、图表、时间线、流程图等），图表卡片与其他卡片组成网格，展现数据驱动。
• 间距要求：所有边距都要左右对称，页面和内部内容的边距至少 40px（内容不要贴边），卡片和内部文字的边距至少 5px（文字不要贴边），卡片之间保持 20-40px 的间距。
• 文字对齐：正文默认左对齐，只在封面、结尾或大号数字场景中使用居中；表格里的文字左对齐、数字右对齐、仅关键词或短句时居中对齐。

视觉风格：

• 美学：干净、明亮、清爽但信息饱满；靠卡片和对齐网格在高密度下维持秩序感；同排卡片文字数量应相近以保持观感整齐。
• 字体：全篇以无衬线体（思源黑体）为主，封面或关键强调可少量使用衬线体。
• 字号：标题 28-36pt、正文 12-14pt、注释 10-12pt，常规关键指标 16-32pt、核心指标用 36-52pt 数字，下面配 10-14pt 标签与简短解读，需要容纳更多文字时允许使用更小的字号。
• 图标：内嵌 IconPark 图标（可用关键词或编号替代）作为视觉锚点，让高密度文字也有图形节奏，而不是成片纯文字块。
• 配色：克制颜色数量，确保所有页面都只使用同样的 1 个背景色（偏好浅米白）、1 个主色、1 个强调色和 1 个辅助色；偏好莫兰迪配色，禁止彩虹配色（比如蓝配橙）。

Quick Reference

本表只定位「场景 → 用哪条命令、读哪份文档」。参数以「执行前必做」里对应的文档和 `lark-cli slides +<verb> --help` 为准，不要凭记忆或按别的命令类比补参数。

CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，认证、权限和全局参数均以 lark-shared 为准。

CRITICAL — 查看或回滚历史版本前，MUST 先读取 [`cli/lark-slides-history.md`](references/cli/lark-slides-history.md)。回滚接口只接受 `history_version_id`，不要把 `revision_id` 直接传给 `+history-revert`。

CRITICAL — 生成任何 XML 之前，MUST 先用 Read 工具读取 [xml/xml-schema-quick-ref.md](references/xml/xml-schema-quick-ref.md)，禁止凭记忆猜测 XML 结构。

CRITICAL — 新建演示文稿或大幅改写页面时，MUST 先生成 `.lark-slides/plan/<deck-or-task-id>/slide_plan.json`，再生成 XML。先创建对应目录，规划层规则和中间产物生命周期见 [planning-layer.md](references/planning-layer.md)。仅替换一个标题、插入一个块等小型已有页编辑可豁免。

CRITICAL — 新建演示文稿或大幅改写页面时，生成 XML 前 MUST 读取 [visual-planning.md](references/visual-planning.md)，确保 `layout_type`、`visual_focus`、`text_density` 实际改变页面几何、主视觉和文本量。

CRITICAL — 新建演示文稿或大幅改写页面时，规划 `asset_need` MUST 遵循 [asset-planning.md](references/asset-planning.md)：只做元数据规划，必须有 `fallback_if_missing`，不得要求真实搜索、下载或上传素材。

CRITICAL — 将完整 `<slide>` XML 提交给 `slides +create`、`slides +add-slide` 或 `slides +update-slide` 之前，MUST 先把待提交 XML 保存到本地文件并运行唯一版式准出入口 [`scripts/xml_lint.py`](scripts/xml_lint.py)；`summary.error_count` 必须为 0 才能调用接口。

CRITICAL — 创建、大幅改写或整页写回后，MUST 按 [workflow/validation-xml.md](references/workflow/validation-xml.md) 做显式验证：回读全文 XML、核对页数和关键元素，并使用 [`scripts/xml_lint.py`](scripts/xml_lint.py) 统一检查 XML、越界、重叠、空白页和内容稀疏风险。

CRITICAL — 创建前自检或失败排障时，MUST 按 [workflow/error-handling.md](references/workflow/error-handling.md) 检查 XML 转义、结构、shell 截断、图片 token、3350001 和布局风险。

编辑已有幻灯片页面：单个标题、文本块、图片或局部元素优先用 `+replace-slide`（块级替换/插入，不动页序）；一页里改动很多（例如批量换字体）、要改背景、或要删掉若干元素时用 `+update-slide` 整页覆盖（slide_id 和页序不变，但没写进 --content 的元素会被删除）；多页大改就对每一页各跑一次 `+update-slide`。选择 action 和完整读-改-写流程见 `workflow/slides-editing.md`。

用户要求使用模板：按 workflow/template-editing.md 处理。

身份选择

飞书幻灯片通常是用户自己的内容资源。默认应优先显式使用 `--as user`（用户身份）执行 slides 相关操作，始终显式指定身份。

• `--as user`（推荐）：以当前登录用户身份创建、读取、管理演示文稿。执行前先完成用户授权：

lark-cli auth login --domain slides

• `--as bot`：仅在用户明确要求以应用身份操作，或需要让 bot 持有/创建资源时使用。使用 bot 身份时，要额外确认 bot 是否真的有目标演示文稿的访问权限。

执行规则：