用飞书幻灯片 CLI 创建和编辑高信息密度 PPT…

当需要通过 lark-cli 创建、读取、编辑飞书幻灯片（含豆包 /slides/ 链接）时，按规划层、XML 规范、豆包设计原则和验证流程执行。

适用场景

解决思路

1. 开始前先用 Read 工具读取 ../lark-shared/SKILL.md，认证、权限和全局参数以 lark-shared 为准。
2. 默认显式使用 --as user 执行 slides 操作；先运行 lark-cli auth login --domain slides 完成用户授权；仅在用户明确要求 bot 身份时才用 --as bot，权限不足时先检查是否误用 bot 身份，不要默认回退。
3. 生成任何 XML 之前，先用 Read 工具读取 xml/xml-schema-quick-ref.md，禁止凭记忆猜测 XML 结构。
4. 新建演示文稿或大幅改写页面时，先创建 .lark-slides/plan/<deck-or-task-id>/ 目录并写入 slide_plan.json，再生成 XML；仅替换一个标题、插入一个块等小型已有页编辑可豁免。
5. 新建或大幅改写时，生成 XML 前读取 visual-planning.md，确保 layout_type、visual_focus、text_density 实际改变页面几何、主视觉和文本量。
6. 规划 asset_need 时遵循 asset-planning.md：只做元数据规划，必须有 fallback_if_missing，不得要求真实搜索、下载或上传素材。
7. 把完整 <slide> XML 提交给 slides +create、+add-slide 或 +update-slide 之前，先把待提交 XML 保存到本地文件并运行 scripts/xml_lint.py，summary.error_count 必须为 0 才能调用接口。
8. 创建、大幅改写或整页写回后，按 workflow/validation-xml.md 做显式验证：回读全文 XML、核对页数和关键元素，并用 scripts/xml_lint.py 统一检查 XML、越界、重叠、空白页和内容稀疏风险。
9. 创建前自检或失败排障时，按 workflow/error-handling.md 检查 XML 转义、结构、shell 截断、图片 token、3350001 和布局风险。
10. 编辑已有页面时，单个标题、文本块、图片或局部元素优先用 +replace-slide（block_replace / block_insert，不动页序）；一页改动很多、要改背景或要删元素时用 +update-slide 整页覆盖（slide_id 和页序不变，但没写进 --content 的元素会被删除）；多页大改对每一页各跑一次 +update-slide，不要用 slides +create 新建整份 PPT。
11. 追加或插入单页用 +add-slide（一次一页，--before-slide-id 控制位置，--slide 支持 @file 绕开 shell 转义）；删除单页用 +delete-slide，删前先回读确认 slide_id。
12. 读取或分析已有 PPT 时，解析 slides/wiki token，用 +xml-get 回读全文或单页 XML（单页传 --slide-id 或 --slide-number），保存 xml_presentation_id、slide_id、revision_id；--output 必须是 CWD 内的相对路径。
13. 查看或回滚历史版本前先读取 cli/lark-slides-history.md；先用 +history-list 找 history_version_id，再 +history-revert，必要时 +history-revert-status 轮询；不要把 revision_id 直接传给 +history-revert。
14. 获取页面截图时按页码用 --slide-number、按 ID 用 --slide-id；单张用 --output，批量或全量用 --output-dir，每批最多 10 页串行执行；截图目录复用同一任务的 deck/task 标识，后续读取返回的实际路径。
15. 下载图片用 slides +media-download --file-token <file_token>；--output 选填，未传时自动保存到默认目录 .lark-slides/media 并按响应文件名/类型生成路径；调用后读取返回的 path，不要猜测文件名；直连被拒时自动回退到源文件预览。
16. 上传或使用图片时先上传为 file_token，禁止直接写 http(s) 外链；用 slides +media-upload，或在 +create --slides 的 XML 里写 <img src="@./path"> 占位符自动上传；图片最大 20 MB。
17. 绘制图表时原生图表（柱状、条形、折线、面积、饼（环）、雷达、组合图）用 <chart>，其他（漏斗图、金字塔图、象限图、矩阵图等）用 <shape> + <line> 模拟；绘制前必须阅读 xml/slides_chart_demo.xml。
18. 绘制表格时优先用 rect 和 text 模拟，其他用 <table>；必须设置 <table> 的 width 和 height 固定表格大小，同时设置需要保留列宽或行高的 <col> 的 width 和 <tr> 的 height；<td> 直接子元素只有 <fill>、<content> 和边框配置，不能嵌套 <shape>、<img>、<icon>。
19. 使用图标时禁止盲猜 iconType，必须先通过 iconpark_tool.py search → resolve 检索 IconPark，再写 <icon iconType="...">；图标必须填充颜色（<fill><fillColor color="rgba(R,G,B,A)"/></fill>）并和背景有足够对比；禁止使用 emoji 图标。
20. 严格遵守权威经验：PPT 尺寸 960x540，主体内容必须在页面边界内；禁止交付无图产物，必须使用大量图片且禁止重复使用同一张图；封面主视觉必须是 <img>，不要用 <shape> 或 <icon> 拼出封面视觉；禁止用 <shape> 和 <line> 拟形具体物项；禁止在 headline 或 title 下方放置分隔或装饰的 rect 或 <line>；禁止页面内部无意义装饰线条或色块条带，任何一边都不要贴边窄条。
21. 生图工具的指令参数必须以“不要出现任何文字和颜色色号”结尾，避免生成的图片上出现干扰文字。
22. 字号必须显式设置 <content> 的 fontSize 属性，不要依赖 textType 的默认字号兜底；大数字、字号大或字数多的 <content> 必须设置 wrap="true" autoFit="normal-auto-fit" 自动换行和缩排。
23. 文字颜色必须用 <content> 的 color 属性而不是 fontColor；文字行间距必须设置 <content> 的 lineSpacing="multiple:xx" 或 lineSpacing="fixed:xx" 而不是 lineSpacing="xx"；图片必须用 <img> 而不是 <image>。
24. 隐藏 <chart> 的图例只能通过不写或删除 <chartLegend> 实现，<chartLegend> 不支持 position="none"。
25. <shape type="rect"> 只是形状不是容器，<icon>、<img>、<shape type="text"> 和其他 <shape> 必须与它平级靠坐标叠放。
26. 填充渐变颜色必须用 <fill><fillColor color="linear-gradient(135deg, rgba(R,G,B,A) 0%, rgba(R,G,B,A) 100%)"/></fill>；渐变色必须使用 rgba() 格式并带百分比停靠点，使用 rgb() 或省略停靠点会导致服务端回退为白色。
27. 编辑页面前必须阅读 workflow/slides-editing.md；当用户要求无损复述历史上下文时，必须无损复述权威经验、必读的技能文档（需要重新阅读）和易错元素语法（尤其是 <table> 和 <chart>）。
28. 普通内容页的设计以豆包设计原则为最高准则（除非用户要求使用模板或直接提供设计方案），不适用于 title-cover、section-divider、conclusion、quote-highlight 和 big-number。
29. 采用信息密度极高的图文卡片布局：卡片按多行网格铺满页面，版面对称、均衡、不留白；网格数、图文比例按内容变化，避免每页雷同；多个要点拆分为多张子卡片（例如 8 张 50 字卡片优于 2 张 200 字卡片）。
30. 卡片样式使用方角卡片 + 半透明填充 + 无边框 + 卡片贴边窄条（可选）；所有卡片使用相同配色方案（少量需强调的卡片除外），禁止同页出现彩虹卡片（卡片颜色超过 3 种）。
31. 卡片结构包含视觉锚点（关键词、编号或 IconPark 图标）+ 标题 + 内容（文字、图片、图表、子卡片）。
32. 文字卡片：多数页面满足 6-8 张文字卡片、200-400 文字数量，字数不足时扩写成长句或段落，不留白；文字卡片是“标题 + 完整说明”，像浓缩的分析文稿；不得不用列表、分栏、关键词或短句时保证层次清晰，更建议拆分为多张子卡片。
33. 图片卡片：多数页面满足 1-3 张图片卡片，缺少图片时用生图工具补充配图，图片卡片与文字卡片组成网格。
34. 图表卡片：数据信息不要在文字卡片中罗列，必须在图表卡片中可视化（包括表格、图表、时间线、流程图等），与其他卡片组成网格。
35. 间距要求：所有边距左右对称，页面和内部内容的边距至少 40px，卡片和内部文字的边距至少 5px，卡片之间保持 20-40px 的间距。
36. 文字对齐：正文默认左对齐，只在封面、结尾或大号数字场景中使用居中；表格里的文字左对齐、数字右对齐、仅关键词或短句时居中对齐。
37. 视觉风格：干净、明亮、清爽但信息饱满，靠卡片和对齐网格在高密度下维持秩序感，同排卡片文字数量应相近；全篇以无衬线体（思源黑体）为主，封面或关键强调可少量使用衬线体。
38. 字号规范：标题 28-36pt、正文 12-14pt、注释 10-12pt，常规关键指标 16-32pt、核心指标用 36-52pt 数字，下面配 10-14pt 标签与简短解读，需要容纳更多文字时允许使用更小的字号。
39. 配色克制：所有页面只使用同样的 1 个背景色（偏好浅米白）、1 个主色、1 个强调色和 1 个辅助色；偏好莫兰迪配色，禁止彩虹配色（比如蓝配橙）。
40. 开始写 XML 前先在 slide_plan.json 里确定 deck 级视觉策略：主题化配色（服务本次主题、行业和受众，不要默认蓝色商务风）、主次比例（1 个主色约 60-70% 视觉权重、1 个辅助色、1 个强调色）、背景一致性（全 deck 保持同一明暗基调和底色体系）、统一 motif（可复用视觉母题贯穿全文）。
41. 每页至少要有一个视觉元素：图片、图标、图表、表格、流程、对比结构或大号数字；文本框本身不算主视觉。
42. 常见页面形态可选：双栏结构（视觉区域占 35-45% 宽度）、图标行、网格、半出血视觉、大数字卡片、对比列、时间线/流程图。
43. 避免常见错误：不要所有页面复用同一种标题 + 三 bullets 版式；不要用低对比文字或图标；不要让装饰线穿过文字或让页脚、来源、编号挤压主体内容；不要把素材缺失表现为空白图片框，必须按 fallback_if_missing 生成替代图片；不要在任何位置使用 emoji 图标。
44. 按生成流程执行：Step 1 需求分析 & 读取知识（分析主题、受众、页数、风格；模板按 workflow/template-editing.md；读取 xml-schema-quick-ref.md，新建/大幅改写还要读 planning-layer.md、visual-planning.md、asset-planning.md；涉及图表读 slides_chart_demo.xml）；Step 2 生成大纲写入 slide_plan.json；Step 3 按 plan 生成 XML 并创建（逐页消费 plan，缺素材用 fallback_if_missing，读 cli/lark-slides-create.md 定一步还是两步创建，图片按 cli/lark-slides-media-upload.md 处理，复杂 XML/转义/3350001 按 workflow/error-handling.md）；Step 4 审查 & 交付（用 slides +xml-get --presentation <xml_presentation_id> 读取全文 XML 并按 workflow/validation-xml.md 显式验证，局部问题优先用 +replace-slide 修正，没问题用 NotifyHuman 交付 PPT 链接）。
45. 生成大纲时使用模板：[PPT 标题] — [定位描述]，面向 [目标受众]；页面结构（N 页）：1. 封面页：[标题文案] 2. [页面主题]：[要点1]、[要点2]、[要点3] … N. 结尾页：[结尾文案]；风格：[配色方案]，[排版风格]。
46. 处理 URL 与 Token：/slides/ 路径中的 token 直接作为 xml_presentation_id 使用；/wiki/ 链接不能直接使用，需先查询获取真实 obj_token；带 --presentation 的 slides shortcut 会自动解析两种 URL。
47. Wiki 链接特殊处理：用 lark-cli wiki +node-get --node-token '<url>' --as user --format json 查询节点、校验 data.obj_type == "slides" 并使用 data.obj_token；节点解析必须与后续 Slides 操作使用相同身份。
48. 遵守核心规则：<slide> 直接子元素只有 <style>、<data>、<note>，文本和图形必须放在 <data> 内；文本通过 <content><p>...</p></content> 表达，不能把文字直接写在 shape 内；不要混淆 XML 元素 <content> 和 --parts 的 JSON 字段（block_replace 用 replacement，block_insert 用 insertion）。
49. 保存关键 ID（xml_presentation_id、slide_id、revision_id）；删除不可逆，删前先回读确认 slide_id。
50. <img src> 只能用上传到飞书 drive 的 file_token，禁止使用 http(s) 外链 URL；流程必须是「先把图存到本地 → 用 slides +media-upload 上传，或在 +create --slides 的 XML 里写 <img src="@./path"> 占位符自动上传 → 拿 file_token 写进 <img src>」；用户给网图链接时先 curl/下载到 CWD 内再走上传流程。
51. 如果 md 内容与 xml/slides_xml_schema_definition.xml 不一致，以后者为准。

适用边界 · 注意事项

• 不负责云文档内容编辑（走 lark-doc）、云文档里的独立画板对象（走 lark-whiteboard）、上传或下载普通文件（走 lark-drive）。
• 未完成用户授权（lark-cli auth login --domain slides）或未确认 bot 有目标演示文稿访问权限时，不要执行 slides 操作。
• 未读取对应 reference 文档、未运行 xml_lint.py 或 summary.error_count 不为 0 时，不要调用创建/编辑接口。