安装、版本与仓库地图

读源码前先校准事实。上游 README 当前把 lark-cli 定位为 Lark/Feishu 官方 CLI，面向人和 AI Agent，覆盖 18 个业务域、200+ 命令，并随仓库分发 Agent Skills。

安装路径

当前 README 推荐的安装方式是 npm installer：

npx @larksuite/cli@latest install

源码安装路径是：

git clone https://github.com/larksuite/cli.git
cd cli
make install
npx skills add larksuite/cli -y -g

注意这里和一些早期笔记不同：README 里的快速开始不是 Homebrew 优先，而是 npm installer 优先；源码安装还要求安装 CLI Skill。

截至 2026-07-01 阅读时，CHANGELOG.md 最新可见版本是 v1.0.61（2026-06-30）。近期变更集中在：

版本	重点
`v1.0.61`	`whoami`、apps 数据库/文件/openapi-key 快捷命令、reference map flags
`v1.0.60`	per-command affordance、VC 会议生命周期事件、proxy warning 开关
`v1.0.58`	Sheets typed table I/O、Base/Drive/Doc/Whiteboard 能力扩展
`v1.0.56`	对齐 API success envelope，退役 legacy error envelope

这说明仓库迭代速度很快，笔记里的命令示例应优先看作源码结构说明；落地时仍要用 lark-cli <domain> --help 和 lark-cli schema ... 核验。

目录	源码角色
`cmd/`	Cobra 命令入口：root、auth、config、api、schema、event、skill、update 等
`cmd/service/`	从 API catalog 生成业务域命令树
`shortcuts/`	人类和 Agent 优先使用的 `+` 快捷命令
`skills/`	Agent Skills；当前 checkout 下有 27 个 `SKILL.md`
`internal/registry/`	嵌入/运行时 API metadata、scope、service 描述
`internal/apicatalog/`	API metadata 的导航模型，供 service/schema 复用
`internal/schema/`	把 metadata 转成 Agent 可读的 input/output schema
`internal/output/`	JSON envelope、table/csv/ndjson、jq、content safety scan
`errs/`	类型化错误契约，含 `ERROR_CONTRACT.md`
`internal/security/`	内容安全扫描配置、归一化与 provider
`internal/qualitygate/`	质量门禁：dry-run、输出、命名、skills、public content 等
`events/` 与 `cmd/event/`	飞书事件消费、订阅、schema、运行时
`extension/` 与 `sidecar/`	凭证、传输、文件 IO、平台扩展和 sidecar 示例