larksuite/cli

解决的问题

lark-cli 是 Lark/Feishu 的官方命令行界面，旨在弥合人类开发者与 AI Agent 之间的差距。它通过提供一种结构化、安全且优化的方式，简化了与 Lark 开放平台的交互过程，使用户无需从零开始编写复杂的 API 集成，即可管理消息、文档、日历、电子表格等业务领域。

如何工作

该工具采用三层命令架构，在易用性与平台全覆盖之间取得平衡：

1. 快捷命令：高层级、对人类和 AI 友好的命令（以 + 开头），使用智能默认值和结构化输出。
2. API 命令：100 多个经过精选的命令，与官方平台端点 1:1 映射。
3. 原始 API 调用：可直接访问超过 2,500 个 Lark 开放平台 API，提供完全的灵活性。

它包含 26 个预定义的「技能」（模块化能力集），使 AI Agent 能够无需额外配置即可操作 Lark 功能（如 lark-calendar、lark-im）。通过 OAuth 进行身份验证，并使用操作系统原生密钥链安全存储凭证。

适用人群

• 个人开发者：希望通过终端管理自己 Lark 工作区的人。
• AI Agent 开发者：需要在 Lark 内执行操作的 Agent 开发者（如读取文档、发送消息、管理任务）。
• 企业 IT/ISV：希望将 CLI 嵌入自有平台，并实现集中式凭证管理和审计日志的组织。

核心亮点

• 原生 Agent 设计：内置结构化技能和优化参数，最大化 AI 调用成功率。
• 广泛覆盖：支持 18 个业务领域，包括消息、文档、Base、表格、幻灯片、日历、邮件和 OKR。
• 默认安全：具备输入注入防护、终端输出净化和风险控制信号，可检测异常行为。
• 灵活输出：支持 JSON、美化输出、表格、ndjson 和 CSV 多种格式。
• 快速上手：提供交互式引导配置和登录流程，用户可在几分钟内快速开始使用。