lark-slides 是发布在 open.feishu.cn 的幻灯片制作技能,面向 AI 智能体,用于通过 lark-cli 的 slides 快捷命令操作飞书演示文稿(Slides)。它把「规划—生成 XML—创建—验证—交付」串成一条工作流。
【主要能力】 技能覆盖演示文稿的完整生命周期操作:用 +create 新建 PPT(可选一步或两步创建);用 +add-slide 向已有演示文稿追加或插入页面(--before-slide-id 控制位置);用 +delete-slide 按 slide_id 删除页面;用 +xml-get 读取全文或单页 XML;用 +screenshot 将页面保存为本地图片;用 +media-upload 上传本地图片并获得 file_token,用 +media-download 按 file_token 下载图片;用 +replace-slide 对已有页面做块级替换或插入(不动页序);用 +update-slide 整页覆盖,可一次改样式、插入、删除、备注与背景;历史版本相关操作用 +history-list、+history-revert、+history-revert-status。
【使用方式】 使用前需完成认证与授权,相关约定以 lark-shared 为准;执行 slides 操作默认显式使用用户身份(--as user),先运行 lark-cli auth login --domain slides 完成授权。命令形式为 lark-cli slides +<verb> [flags]。创建或大幅改写前必须先读取规划层文档并写入 .lark-slides/plan/<deck-or-task-id>/slide_plan.json,再生成 XML;提交完整 <slide> XML 前须保存到本地文件并运行 scripts/xml_lint.py,summary.error_count 必须为 0 才能调用接口。创建、大幅改写或整页写回后须回读全文 XML 并按验证文档核对页数与关键元素。
【核心规则】 <slide> 直接子元素只有 <style>、<data>、<note>,文本与图形放在 <data> 内;文本必须通过 <content><p>...</p></content> 表达;后续操作需要保存 xml_presentation_id、slide_id、revision_id;删除不可逆,删前先回读确认;图片 <img src> 只能用上传到飞书 drive 的 file_token,禁止 http(s) 外链;单张图片最大 20 MB。表格优先用 rect 和 text 模拟,原生图表使用 <chart>,漏斗图、金字塔图、象限图、矩阵图等用 <shape> + <line> 模拟。
【设计规范】 文档给出较细的设计要求:画布 960x540,主体内容须在页面边界内;普通内容页遵循信息密度较高的图文卡片布局;配色克制、同页卡片颜色不超过 3 种;禁止 emoji 图标;字号需显式设置;大数字或长文本需设置自动换行与缩排;渐变填充须使用 rgba() 并带百分比停靠点,否则服务端会回退为白色。同时列出了一组禁止项,如禁止无图产物、禁止用 shape 或 line 拟形具体物项、禁止无意义装饰线条等。
【适用场景】 适合需要以智能体自动生成或批量维护飞书演示文稿的场景,包括新建整套 PPT、按模板导入后编辑、局部修改单个标题或图片、整页改版、追加页面、截图预览、图片上下行处理与版本回滚。
【限制】 使用依赖 lark-cli 与飞书账号授权;部分操作要求以用户身份执行并具备相应访问权限;图片必须先上传为 file_token;XML 协议以 slides_xml_schema_definition.xml 为唯一正确来源。具体安装命令、收费与价格信息暂未提供。