larksuite/cli 官方入口：飞书文档、表格和日历命令行工具教程

找 larksuite/cli 官方入口时，我不建议只收藏一个下载地址。仓库、中文 README、npm 包和飞书开放平台各自解决不同问题：代码从仓库核对，版本从 release 与 npm 核对，安装和业务示例则看官方文档。入口分清楚，后面遇到命令差异才不容易被旧教程带偏。

四个官方入口分别看什么

GitHub 仓库

查看源码、README、Skills、Issue 与 release；源码安装也从这里 HTTPS 克隆。

中文 README

核对推荐安装命令、认证方式、三层命令体系与安全提示。

npm 包

确认当前发布版本、Node.js 要求和包名是否确为 @larksuite/cli。

飞书开放平台

看安装引导、场景截图、能力地图、配置命令与常见问题。

我的入口检查法：下载前同时看 npm 版本和 GitHub latest release。截至 2026 年 7 月 16 日，两处均可核对到 v1.0.70；若第三方页面仍在教旧包名或来历不明的二进制，就回到官方入口。

文档、表格、日历从哪条命令起步

CLI 的快捷命令以 + 开头，适合先完成常见任务；参数不确定时，用对应 service 的 --help 查，而不是猜。

文档命令

lark-cli docs +fetch --doc "<文档URL或token>"
lark-cli docs +create --content '
内容
'

电子表格命令

lark-cli sheets +workbook-info --url "<表格URL>"
lark-cli sheets +csv-get --url "<表格URL>" --sheet-name "<真实表名>" --range "A1:F30"

日历命令

lark-cli calendar +agenda --as user

“表格”要先分清 Sheets 和 Base

电子表格走 sheets，多维表格走 base。读取电子表格前，我会先用 +workbook-info 取真实工作表名称，再决定范围；不会默认猜 Sheet1。如果目标是字段、记录、视图和仪表盘，则直接查看 lark-cli base --help。

下载之后先做一次无副作用检查

1. 运行 lark-cli --version，确认版本来源。
2. 运行 lark-cli auth status，确认当前身份和 scope。
3. 先读一篇文档或查看当天日程，再碰写入命令。
4. 写消息、改表格前加 --dry-run，看清请求再执行。

官方入口的价值不只在“能下载”，还在于每次升级后都能回去核对真实命令。larksuite/cli 更新较快，长期保存一张旧命令截图，反而不如记住仓库、README、npm 与开放平台这四个位置。