用途
Lark/飞书 CLI 是 larksuite 团队维护的官方命令行工具，面向人类用户与 AI Agent 两类使用者。它把飞书开放平台的业务能力封装为命令行操作，覆盖 Messenger、Docs、Base、Sheets、Slides、Calendar、Mail、Tasks、Meetings、Markdown 等核心业务域，共 18 个业务域、200+ 精选命令与 26 个 AI Agent Skills。
主要能力
- Agent 原生设计：开箱提供 24 个结构化 Skills，兼容主流 AI 工具，Agent 无需额外配置即可操作飞书。
- 广泛覆盖：18 个业务域、200+ 精选命令、26 个 AI Agent Skills。
- 面向 AI 优化：每条命令均经真实 Agent 测试，参数简洁、默认值智能、输出结构化，以提升 Agent 调用成功率。
- 三层命令体系：快捷命令（以 + 为前缀，面向人类与 AI，含智能默认值、表格输出与 dry-run 预览）→ API 命令（由飞书 OAPI 元数据自动生成，经评估与质量门禁筛选，100+ 命令与平台端点一一对应）→ 原始 API 调用（可直接调用任意飞书开放平台端点，覆盖 2500+ API）。
- JSON 输出契约：使用 --format json（默认）时，成功与错误信封相互区分。成功写入 stdout、退出码为 0；错误写入 stderr、退出码非零。判断命令是否成功应检查 ok == true（或退出码），而非 code == 0。
- Schema 自省：使用 schema 可查看任意 API 方法的参数、请求体、响应结构、支持的身份与权限范围。
- 安全与可控：具备输入注入防护、终端输出净化、操作系统原生钥匙串凭据存储。
使用方式
前置条件：Node.js（npm/npx）；从源码构建时另需 Go v1.23+ 与 Python 3。
人类用户快速开始（二选一）：
- 方式一（推荐）：从 npm 安装。
- 方式二：从源码构建（需 Go v1.23+ 与 Python 3）。
AI Agent 快速开始：
- 第 1 步：安装。
- 第 2 步：配置应用凭据。在后台运行命令，它会输出授权 URL，提取并发送给用户；用户在浏览器完成设置后命令自动退出。
- 第 3 步：同上，在后台运行，提取授权 URL 发送给用户。
- 第 4 步：验证。
其他要点：
- 运行 lark-cli <service> --help 可查看全部快捷命令。
- 对有副作用的命令，可先用 --dry-run 预览请求。
- 对 AI Agent 的提示：在任意开放平台文档 URL 后追加 .md 可获取原始 Markdown。
适用场景
适合需要通过命令行或 AI Agent 自动化操作飞书/Lark 的场景，例如消息、文档、多维表格、表格、幻灯片、日历、邮件、任务、会议等业务域的操作与集成。
限制与风险
该工具可由 AI Agent 调用以自动化操作飞书开放平台，存在模型幻觉、不可预测执行、提示注入等固有风险。授权飞书权限后，AI Agent 将以你的用户身份在授权范围内行动，可能导致敏感数据泄露或未授权操作等高风险后果，请谨慎使用。工具默认在多层启用安全防护，但风险仍然存在；强烈建议不要主动修改任何默认安全设置，一旦放宽相关限制，风险将显著增加，后果由使用者承担。建议将集成该工具的飞书机器人作为私密对话助手使用，不要加入群聊或允许其他用户与其交互，以避免权限滥用或数据泄露。
为降低访问令牌被盗带来的安全风险，CLI 在向确切的飞书/Lark 官方 HTTPS 域名发起 OpenAPI 请求时会发送最小化的风控信号，用于帮助识别异常 API 活动。该保护默认启用，发送的信息仅限于：操作系统类型（macOS、Windows 或 Linux）、设备硬件型号（例如 Mac17,9）。可通过命令为当前工作区禁用、启用该保护或恢复默认策略。
使用本工具即视为自愿承担全部相关责任。项目基于 MIT 许可开源；运行时调用飞书/Lark 开放平台 API，使用这些 API 需遵守飞书用户服务条款、飞书隐私政策、飞书开放平台应用服务商安全管理规范、Lark 用户服务条款与 Lark 隐私政策。
贡献
欢迎社区贡献。发现 bug 或有功能建议，可提交 Issue 或 Pull Request；重大变更建议先通过 Issue 讨论。提交 PR 前请参阅 AGENTS.md 中的本地构建、测试与 PR 检查清单。
