cli

lark-cli 是 Lark/飞书的官方命令行界面，由 larksuite 团队维护。它专为人类用户和 AI Agent 设计，覆盖 18 个核心业务领域，包括 Messenger、Docs、Base、Sheets、Slides、Calendar、Mail、Tasks、Meetings、Markdown、Wiki、Contact、Attendance、Approval、OKR、Project 和 Apps，提供超过 200 个精选命令和 26 个 AI Agent 技能。 该工具采用 Agent 原生设计，具有结构化技能，兼容主流 AI 工具，使 Agent 无需额外设置即可操作 Lark。每个命令都经过真实 Agent 测试，具有简洁参数、智能默认值和结构化输出，以最大化 Agent 调用成功率。它采用 MIT 许可证开源，可通过 npm 几步安装。 三层命令系统在不同粒度上提供灵活性：快捷方式（以 + 为前缀，专为人类和 AI 设计，具有智能默认值和表格输出）、API 命令（从 Lark OAPI 元数据自动生成，通过评估和质量门控筛选，100+ 命令与平台端点 1:1 映射）和原始 API 调用（直接访问任何 Lark 开放平台端点，覆盖 2500+ API）。 认证支持 OAuth 登录，具有交互式选择或 CLI 标志用于范围、用户和机器人之间的身份切换，以及非阻塞验证 URL 的 Agent 模式。该工具包括多种输出格式（JSON、pretty、table、ndjson、CSV）、分页支持、副作用命令的 dry-run 预览，以及用于检查 API 参数和响应结构的模式内省。 安全功能包括输入注入保护、终端输出清理、操作系统原生钥匙串凭据存储，以及与 OpenAPI 请求一起发送到官方飞书/Lark HTTPS 域名的风险控制信号。该工具警告用户 AI Agent 自动化操作时的固有风险，包括模型幻觉、不可预测执行和提示注入，并建议使用集成机器人作为私人对话助手，而不是在群聊中使用。 对于企业使用，该工具支持嵌入自定义 Agent 或平台，具有集中凭据、统一审计日志和通过扩展包限制命令表面。该项目使用 Go（v1.23+）编写，通过 npm 分发，欢迎社区在 MIT 许可证下贡献。