lark-slides
Installation
Summary
Create and edit Lark Office slides with XML protocol, supporting presentation creation, page management, and content modification.
- Supports three creation workflows: one-step creation for simple slides, two-step creation (empty presentation + page-by-page addition) for complex content, and block-level editing of existing pages without reordering
- Handles slide operations including create, read, delete, and replace at both presentation and individual page levels; automatically parses
/slides/and/wiki/URLs to extract presentation tokens - Requires planning layer (slide_plan.json) before XML generation for new presentations or major rewrites; includes visual planning (layout_type, visual_focus, text_density) and asset planning with fallback strategies
- Enforces strict XML validation: text must use
<content><p>...</p></content>, images require uploaded file_tokens (no external URLs), and all complex content undergoes post-creation verification against validation checklist - Provides template search, summarization, and extraction via
template_tool.pyto avoid boilerplate; prioritizes user identity (--as user) for personal content operations
SKILL.md
slides (v1)
Quick Reference
| 用户需求 | 优先动作 | 关键文档 / 命令 |
|---|---|---|
| 新建 PPT | 先规划 slide_plan.json，再按复杂度选择一步或两步创建 |
planning-layer.md、visual-planning.md、asset-planning.md、slides +create |
| 大幅改写页面 | 先回读现有 XML，写入新 plan，再替换或重建相关页面 | xml_presentations.get、+replace-slide、lark-slides-edit-workflows.md |
| 编辑单个标题、文本块、图片或局部元素 | 优先块级替换/插入，不改页序 | slides +replace-slide、lark-slides-replace-slide.md |
| 读取或分析已有 PPT | 解析 slides/wiki token，回读全文或单页 XML，保存 xml_presentation_id、slide_id、revision_id |
xml_presentations.get、xml_presentation.slide.get |
| 上传或使用图片 | 先上传为 file_token，禁止直接写 http(s) 外链 |
slides +media-upload，或 +create --slides 的 @./path 占位符 |
| 在 slide 中绘制柱/条/折线/面积/雷达/饼等有数据序列的图表 | 使用原生 <chart> 元素 |
xml-schema-quick-ref.md |
| 在 slide 中绘制流程图、时序图、架构图、散点图、漏斗图或装饰图案 | 必须先用 Read 工具读取参考文档，再生成 <whiteboard> 元素 |
lark-slides-whiteboard.md |
| 使用语义图标 | 先检索 IconPark，再写 <icon iconType="..."> |
iconpark_tool.py search → resolve、iconpark.md |
| 用户提到模板、主题、版式 | 先检索模板，再摘要，必要时裁切骨架 | template_tool.py search → summarize → extract |
| 创建失败、空白页、3350001、布局异常 | 先回读状态，再按排障清单修复，不假设原操作原子成功 | troubleshooting.md、validation-checklist.md |
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，认证、权限和全局参数均以 lark-shared 为准。