lark-cli

概览

GitHubGitHub

## 简介 lark-cli 是由 larksuite 团队维护的 Lark/飞书官方命令行工具（CLI），基于 Go 语言编写，采用 MIT 协议开源。它同时面向人类开发者和 AI Agent 设计，覆盖 Messenger、Docs、Base、Sheets、Calendar、Mail、Tasks、Meetings 等 18 个核心业务领域，提供 200 多条命令和 26 个 AI Agent Skills。 ## 主要能力 - **Agent-Native 设计**：内置 24 个结构化 Skills，兼容主流 AI 工具，Agent 无需额外配置即可操作 Lark。 - **三层命令架构**：分为 Shortcuts（适合人类与 AI）、API Commands（与平台同步）和 Raw API（全量覆盖），用户可按需选择粒度。 - **AI 友好优化**：每条命令均经过真实 Agent 测试，具备精简参数、智能默认值和结构化输出，以提高 Agent 调用成功率。 - **安全可控**：支持输入注入防护、终端输出清理以及操作系统原生钥匙串凭证存储。 ## 覆盖的业务领域 lark-cli 支持的操作范围广泛，包括但不限于： - **日历与会议**：查看、创建、更新日程，查找会议室，搜索历史会议及分析转录内容。 - **消息与邮件**：发送/回复消息，管理群聊，浏览、搜索、发送邮件及管理草稿。 - **文档与云盘**：创建、读写、搜索文档，上传下载文件，管理知识库节点。 - **多维表格与电子表格**：管理表格、字段、记录、视图、仪表盘，以及电子表格数据的读写与导出。 - **任务与审批**：创建、查询、完成任务，查询并处理审批流程。 - **其他**：联系人搜索、考勤查询、OKR 管理、Markdown 文件操作及应用管理等。 ## 适用人群 - **个人开发者**：在终端中直接使用，或配合自己的 AI Agent 调用 Lark 能力。 - **企业 IT / ISV**：将 lark-cli 嵌入自有 Agent 或平台，通过 `extension/` 包进行包装扩展，实现集中凭证管理、统一审计日志和受限命令集，无需修改 CLI 源码。 ## 安装与使用 运行环境需要 Node.js（npm/npx）。若从源码构建，还需 Go v1.23+ 和 Python 3。推荐通过 npm 一键安装，随后通过交互式引导完成应用凭证配置和登录，即可开始调用。

Q&A

lark-cli 是什么？由 AI 生成

lark-cli 是由 larksuite 团队维护的 Lark/飞书官方命令行工具，基于 Go 编写，MIT 协议开源。它为人类和 AI Agent 提供 200 多条命令，覆盖 18 个核心业务领域。

安装 lark-cli 需要什么环境？由 AI 生成

需要 Node.js（npm/npx）。如果选择从源码构建，还需要 Go v1.23+ 和 Python 3。

如何安装 lark-cli？由 AI 生成

推荐使用 npm 安装，执行命令 `npx @larksuite/cli@latest install` 即可。也可以克隆仓库后通过 `make install` 从源码构建。

安装后如何配置和使用？由 AI 生成

首先运行 `lark-cli config init` 进行交互式凭证配置，然后运行 `lark-cli auth login --recommend` 登录，之后即可使用如 `lark-cli calendar +agenda` 等命令。

AI Agent 如何使用 lark-cli？由 AI 生成

AI Agent 可通过 `lark-cli config init --new` 和 `lark-cli auth login --recommend` 在后台运行并提取授权 URL 交由用户在浏览器中完成，最后用 `lark-cli auth status` 验证。

什么是三层命令架构？由 AI 生成

三层架构包括：Shortcuts（对人类和 AI 友好的快捷命令）、API Commands（与平台同步的 API 命令）和 Raw API（全量覆盖的原始 API），用户可根据需求选择合适的粒度。

企业如何将 lark-cli 嵌入到自己的平台中？由 AI 生成

企业 IT 或 ISV 可以阅读相关文档并使用 `extension/` 目录下的包，通过包装一个 wrapper main 来进行扩展，无需修改 CLI 源码，可实现集中凭证管理和统一审计日志。

lark-cli 支持哪些业务领域？由 AI 生成

支持 Calendar、Messenger、Docs、Drive、Markdown、Base、Sheets、Slides、Tasks、Wiki、Contact、Mail、Meetings、Attendance、Approval、OKR、Project 和 Apps 共 18 个领域。

lark-cli 的安全性如何保障？由 AI 生成

lark-cli 提供了输入注入防护、终端输出清理功能，并使用操作系统原生的钥匙串来存储凭证。