SuperAPI AI 工具集

feishu-cli-auth

通用与其它

查看项目

更新于 10-15 16:41

技能介绍

本技能用于飞书开放平台的认证与令牌管理。默认使用 App Token;搜索、消息历史/互动、审批任务、会议/妙记、邮箱等用户身份场景需 User Access Token。

主要能力:一是 scope 预检与登录,auth check --scope 判断某组权限是否已授,auth login 支持 --domain、--recommend、--scope(三者互斥),登录为增量授权,多次申请的 scope 在服务端累积。二是 AI Agent 授权两步模式:先 feishu-cli auth login --recommend --no-wait --json 获取 device_code 与 verification_uri_complete 并发给用户,用户授权后再用 feishu-cli auth login --device-code <device_code> --json 续轮询;device_code 有效期约 10 分钟,重跑第一步会作废旧链接。--json 以 JSONL 输出 device_authorization 与 authorization_complete 事件,后者含 granted_scopes、missing_scopes、refresh_token_present 等字段。三是 Token 导出,feishu-cli auth token --as user|bot|auto 可供 curl/Python 复用。四是诊断与 profile,doctor 提供 config_file、user_token、endpoint_open、endpoint_larksuite、proxy、dependencies 六项检查;profile 用于多租户/多 App 切换,profile add 不自动迁移旧配置,profile migrate 不可逆且不删旧文件,profile use 后需重新 auth login。

限制与注意:非交互环境必须显式指定授权范围;不要用短 timeout 反复重试第一步;阻塞模式需后台运行或 timeout ≥ 600s;不要将 user_access_token、device_code 写入文档、代码或日志;verification_uri_complete 应原样发送,勿改写 URL。