Lark CLI v1.0.26 & v1.0.27:权限报错说清楚了,消息可以直接跳飞书了
5 月 8 日 v1.0.26,5 月 9 日 v1.0.27,两天连着发了两个版本。没有大功能上线,但有几个改动解决了一些挺实际的麻烦——权限报错终于说清楚了,消息输出可以直接跳飞书了,企业 Windows 机器上的安装问题也修了。
消息输出带上 app link 了
以前用 lark im send 发消息,或者查消息历史,拿到的是 message_id 和内容。自动化脚本里接着用还好,但如果想告诉别人「就是这条消息,去飞书看看」,只有 ID 没法直接跳过去。
v1.0.26 给消息输出加了 message_app_link,点开就能在飞书 App 里直接定位到那条消息。
# 发消息,顺手拿 app link
lark im send --chat-id <chat_id> --text "周报已同步"
# 输出里现在多了这个:
message_app_link: lark://msgp/...
一个典型场景:你有个脚本每天往群里发日报,现在可以把这条消息的 app link 一起带出来,放进邮件或者其他通知里,收到通知的人点一下直接跳到飞书里的那条消息,不用再手动翻群聊记录。
权限报错,终于说清楚缺哪个 scope 了
飞书的 OAuth 要单独配 scope,以前跑命令报权限错误,提示信息很模糊,只知道「没权限」,但不知道缺的是哪个 scope,还得去查文档对照。
v1.0.26 改了这里,报错现在会直接告诉你:
Error: Missing authorization for this operation.
Required scope: im:message:send_as_bot
→ 在飞书应用控制台添加这个 scope,重新授权即可
管多个应用或者多个 AI agent 的团队,每个应用的 scope 配置都不一样,这个改动能省下一大截来回翻文档的时间。
config 绑定可以用 lark-channel 当来源了
v1.0.27 给配置系统加了一个新的绑定来源类型:lark-channel。
意思是可以把配置内容放在飞书频道里——一条 bot 消息、一个固定帖子、一段结构化内容——然后让 CLI 工作流直接从那里读取配置。对于把飞书当核心平台的团队来说,不需要再维护单独的配置文件,配置就跟着飞书走,在哪里改、在哪里看,都在同一个地方。
公司机器上 PowerShell 被锁住导致安装失败的问题,修了
这个对企业用户挺重要。很多公司 IT 会用组策略禁用 PowerShell 脚本执行权限。以前 Lark CLI 的安装流程依赖 PowerShell,在这类机器上直接报错,装不上。
v1.0.27 改了安装路径,能正确处理组策略限制的情况了。如果你们团队里有人在公司 Windows 机器上一直装不上 Lark CLI,升到这个版本应该就好了。
其他小改动
- base 命令错误信息更干净了(v1.0.26):Bitable 相关命令报错时,之前会带一堆没用的内部细节。现在只输出有用的部分,看起来清晰多了。
- whiteboard
+update风险等级调整为 write(v1.0.26):如果你们有基于风险等级的操作门控,注意这个调整——画板的更新操作现在需要通过写入级别的审批。 - task 成员 ID 类型文档更清楚了(v1.0.27):参考文档里对 task 成员 ID 类型的说明更精确,不用再猜该传哪种 ID 格式。
升级方式
# npm 安装的用户
npm install -g @larksuite/cli@latest
# 确认版本
lark --version
完整更新记录: github.com/larksuite/cli