SuperAPI AI 工具集

lark-cli

部署与运维

查看项目

更新于 10-15 21:42

技能介绍

用途:在调用其他 Lark 技能前,完成官方 Lark/Feishu CLI 的安装与引导配置,并给出身份、输出解析和副作用安全等通用规则。它不替代 lark-im(消息)、lark-contact(找人)、lark-markdown(Drive 原生 Markdown)等领域技能。

主要能力:检查 lark-cli 是否可用;通过官方 npm 包安装或升级;说明命令与包的安装位置;用正确的产品套件初始化开放平台应用凭据;以推荐权限启动 OAuth 登录;打印配置/授权 URL 供用户手动打开;验证当前认证状态。

使用方式:优先安装命令为 npx @larksuite/cli@latest install。非交互式可用包装脚本:bash <skill-path>/scripts/setup_lark_cli.sh setup --suite lark,它会依次执行安装、lark-cli config init --new --brand <lark|feishu>、lark-cli auth login --recommend、lark-cli auth status。检查用 bash <skill-path>/scripts/setup_lark_cli.sh check。用户明确说 Lark 用 --brand lark,否则用 --brand feishu;未指定时默认 feishu。注意 --suite 选择 Lark/Feishu 授权链接族,--domain calendar|docs|drive|all 选择权限业务域。

适用场景:用户要求搭建 Lark/Feishu CLI;找不到 lark-cli;Lark 技能因缺少配置或认证失败;询问安装位置;切换或验证 user 与 bot 身份。不要每次请求都重装,先运行 check。

限制与规则:需要 Node.js、npm、npx 及网络访问;缺少 Node.js 时应停止并请用户先安装,不要由本技能安装系统 Node.js。配置和登录可能打印浏览器 URL,需原样发给用户并等待授权。写操作前确认目标、内容与身份,支持时先加 --dry-run。优先用 --format json 解析,成功为 {"ok": true},错误写入 stderr。不要打印令牌、Cookie、应用密钥等凭据,不要擅自放宽默认安全设置。缺失权限时用 lark-cli auth check <scope> 或重新登录补充。安装位置:macOS/Linux 通常为 $(npm prefix -g)/bin/lark-cli,包在 $(npm root -g)/@larksuite/cli,原生二进制在 $(npm root -g)/@larksuite/cli/bin/lark-cli;Windows 通常在 %APPDATA%\npm\lark-cli.cmd。