CLI 架构设计指南

Appearance

命令速查表 ​

初始化和配置 ​

命令用途
lark-cli config init创建新应用配置
lark-cli config show显示当前配置
lark-cli profile list列出所有应用
lark-cli profile use切换应用
lark-cli profile add添加新应用

认证管理 ​

命令用途
lark-cli auth login用户登录
lark-cli auth login --recommend推荐权限登录
lark-cli auth login --scope指定权限
lark-cli auth logout登出
lark-cli auth status查看状态
lark-cli auth check检查权限

高级选项 ​

选项用途
--as user强制用户身份
--as bot强制 Bot 身份
--as auto自动检测身份
--profile指定应用
--jsonJSON 输出

常用命令组合 ​

第一次使用 ​

bash
lark-cli config init
lark-cli auth login --recommend
lark-cli auth status
lark-cli calendar +agenda

升级权限 ​

bash
lark-cli auth status
lark-cli auth check --scope "calendar:calendar:write"
lark-cli auth login --scope "calendar:calendar:write"

多应用管理 ​

bash
lark-cli profile add
lark-cli profile list
lark-cli profile use my-app-2
lark-cli auth login

AI Agent 集成 ​

bash
lark-cli config init --new &
DEVICE_CODE=$(lark-cli auth login --no-wait --json | jq -r '.device_code')
lark-cli auth login --device-code $DEVICE_CODE
lark-cli calendar +agenda --json

环境变量 ​

变量用途
LARKSUITE_CLI_USER_ACCESS_TOKEN提供 User Access Token (UAT)
LARKSUITE_CLI_TENANT_ACCESS_TOKEN提供 Tenant Access Token (TAT)
LARKSUITE_CLI_APP_ID提供 App ID
LARKSUITE_CLI_APP_SECRET提供 AppSecret
LARKSUITE_CLI_CONFIG_DIR配置目录
LARKSUITE_CLI_DEFAULT_AS默认身份（user/bot）
LARKSUITE_CLI_STRICT_MODE严格模式（user/bot/off）

安全检查清单 ​

认证安全 ​

  • [ ] 使用强密码保护 AppSecret
  • [ ] 定期轮换 AppSecret
  • [ ] 不要在代码中硬编码 Token
  • [ ] 使用环境变量或密钥管理系统

存储安全 ​

  • [ ] 使用 OS 原生密钥链
  • [ ] 不要在配置文件中存储 Token
  • [ ] 限制配置文件权限（600）
  • [ ] 不要提交 config.json 到版本控制

权限安全 ​

  • [ ] 只请求必要的权限
  • [ ] 定期审查授予的权限
  • [ ] 及时撤销不需要的权限
  • [ ] 使用严格模式限制 Agent 权限