cli

lark-cli 是 Lark/Feishu 的官方命令行接口，由 larksuite 团队维护。它同时面向人类用户和 AI Agent，覆盖 18 个核心业务领域，包括即时通讯、文档、多维表格、电子表格、幻灯片、日历、邮件、任务、会议、Markdown、知识库、通讯录、考勤、审批、OKR、项目和应用，提供超过 200 个精选命令和 26 项 AI Agent 技能。 该工具采用 Agent 原生设计，提供与主流 AI 工具兼容的结构化技能（Skills），让 Agent 无需额外配置即可操作 Lark。每条命令都经过真实 Agent 测试，具有简洁的参数、智能默认值和结构化输出，以最大化 Agent 调用成功率。它采用 MIT 许可证开源，可通过 npm 几步完成安装。 三层命令系统在不同粒度上提供灵活性：快捷命令（以 + 为前缀，面向人类和 AI 设计，具有智能默认值和表格输出）、API 命令（根据 Lark OAPI 元数据自动生成，经过评估和质量门控筛选，100+ 命令与平台端点一一对应），以及原始 API 调用（直接访问任何 Lark 开放平台端点，覆盖 2500+ 个 API）。 身份验证支持 OAuth 登录，可交互式选择或通过 CLI 参数指定作用域，支持用户与机器人身份切换，以及带有非阻塞验证 URL 的 Agent 模式。该工具包含多种输出格式（JSON、pretty、table、ndjson、CSV）、分页支持、副作用命令的 dry-run 预览，以及用于检查 API 参数和响应结构的模式自省（schema introspection）功能。 安全功能包括输入注入保护、终端输出清理、操作系统原生钥匙串凭据存储，以及随 OpenAPI 请求发送到官方 Feishu/Lark HTTPS 域名的风险控制信号。该工具提醒用户，当 AI Agent 自动化操作时存在固有风险，包括模型幻觉、不可预测的执行和提示注入，并建议将集成机器人用作私人对话助手，而不是用于群聊。 在企业使用场景下，该工具支持嵌入自定义 Agent 或平台，提供集中式凭据、统一审计日志，并通过扩展包限制命令面。该项目使用 Go（v1.23+）编写，通过 npm 分发，欢迎社区在 MIT 许可证下贡献代码。