lark-cli

中文版 | English

这是由 larksuite 团队维护的官方 Lark/飞书 CLI 工具，专为人类用户和 AI Agent 设计。涵盖了消息、文档、多维表格、电子表格、幻灯片、日历、邮件、任务、会议、Markdown 等核心业务领域，提供 200 多个命令和 26 个 AI Agent 技能 (Skills)。

安装与快速入门 · AI Agent 技能 · 身份认证 · 命令系统 · 进阶用法 · 安全与风险提示 · 贡献指南

为什么选择 lark-cli？

• Agent 原生设计 — 开箱即用，内置 24 个结构化 Skills，兼容主流 AI 工具，AI Agent 无需额外配置即可操作飞书。
• 广泛覆盖 — 覆盖 18 个业务领域，内置 200 多条精选命令，提供 26 个 AI Agent Skills。
• AI 友好且经过优化 — 每个命令均由真实的 AI Agent 进行测试，具备简洁的参数、智能默认值和结构化输出，最大限度提升 Agent 调用成功率。
• 开源，零门槛 — 采用 MIT 协议，只需 npm install 即可使用。
• 3 分钟快速上手 — 一键创建应用、交互式登录，从安装到完成首次 API 调用仅需 3 步。
• 安全可控 — 支持输入注入防护、终端输出脱敏、系统原生密钥链凭证存储。
• 三层架构 — 快捷命令 (对人类及 AI 友好) → API 命令 (平台同步) → 原生 API (全量覆盖)，根据需求选择最合适的粒度。

功能特性

类别	功能
📅 日历	查看、创建及更新日程，邀请参与者，查找会议室，回复邀请，检查忙闲状态及时间建议
💬 消息	发送/回复消息，创建及管理群聊，查看聊天记录及话题，搜索消息，下载媒体文件
📄 文档	创建、读取、更新及搜索文档，读写媒体文件及白板
📁 云盘	上传及下载文件，搜索文档与知识库，管理评论
📝 Markdown	创建、获取、修改及覆盖云盘原生 .md 文件
📊 多维表格	创建及管理表格、字段、记录、视图、仪表盘、工作流、表单、权限及数据汇总分析
📈 电子表格	创建、读取、写入、追加、查找及导出表格数据
🖼️ 幻灯片	创建及管理演示文稿，读取内容，添加或删除幻灯片
✅ 任务	创建、查询、更新及完成任务，管理任务列表、子任务、评论及提醒
📚 知识库	创建及管理知识空间、节点及文档
👤 通讯录	按姓名/邮箱/手机号搜索用户，获取用户个人资料
📧 邮件	浏览、搜索、读取邮件，发送、回复、转发，管理草稿，监控新邮件
🎥 会议	搜索会议记录，查询会议纪要片段及录制内容
🕐 考勤	查询个人考勤打卡记录
✍️ 审批	查询审批任务，执行审批/拒绝/转交操作，取消及抄送实例
🎯 OKR	查询、创建、更新 OKR，管理目标与关键结果、对齐、指标及进度
📋 项目	Meegle — 通过独立的 meegle-cli 管理工作项、日程及数据（需单独安装）
🔗 应用	开发、部署 HTML、网页及应用程序

安装与快速入门

环境要求

在开始之前，请确保已满足以下环境要求：

# 检查 Node.js 版本 (要求 >= 18)
node -v

# 检查 npm 版本
npm -v