定义
LarkSuite CLI（简称 lark-cli） 是飞书（Lark/Feishu）官方出品的命令行工具，由 larksuite 团队（属于字节跳动/阿里生态）开发维护。项目定位为「为人类和 AI Agent 设计的飞书全能命令行入口」，覆盖飞书全部核心业务域。
核心定位
- 人类用户的飞书 CLI — 终端狂人的飞书操作入口
- AI Agent 的飞书桥接层 — 23 个结构化 Skill 开箱即用，Agent 无需额外配置即可操作飞书
- 三层可伸缩架构 — Shortcut→API→Raw，操作粒度灵活可控
架构特色
三层命令系统
Shortcuts (+前缀)
↓
API Commands (平台同步)
↓
Raw API (全覆盖)
- Shortcuts：
lark-cli calendar +agenda— 智能默认值，表格输出，dry-run 预览 - API Commands：
lark-cli im messages-send— 与飞书开放平台 API 一一对应 - Raw API：直接调用底层接口，满足高级定制需求
Agent Native 设计
每个 Skill 都经过真实 Agent 测试，具备以下特征：
- 简洁参数（减少 Agent 误调用率）
- 智能默认值（无需全量参数）
- 结构化输出（JSON 格式，Agent 易解析）
- 身份切换（
--as user/--as bot）
安装
npm install -g @larksuite/cli
# 或
go install github.com/larksuite/cli@latest快速上手
# 交互式登录（TUI 引导）
lark-cli auth login
# 查看今日日程
lark-cli calendar +agenda
# 发消息
lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello"
# 创建文档
lark-cli docs +create --title "周报" --content "# 本周完成\n- 任务A"Agent 使用场景
- 消息通知 — Agent 通过
lark-im向用户发送飞书消息（当前已在用） - 文件传输 — Agent 通过飞书 API 向用户发送文件（当前已在用）
- 日程管理 — Agent 查询/创建日历事件
- 文档协作 — Agent 创建/编辑飞书文档
- 多维表格 — Agent 操作 Base 数据
- 审批流转 — Agent 查询/处理审批
安全与认证
- OAuth 交互式 TUI 登录
- 支持
--no-wait异步认证（Agent 场景） - OS 原生 keychain 存储凭据
- 终端输出注入防护 + 清洗
- 支持多账号管理
关联连接
- 摘要-larksuite-cli — LarkSuite CLI 项目详细摘要
- Agent_Skills — 通用 Agent 技能框架
- GenericAgent — 当前 Agent 底座，已集成 lark-cli
- LarkSuite_CLI_Skill_Guide — (TODO) lark-cli 在 GenericAgent 中的集成指南