feishu-cli 是一个统一的飞书/Lark CLI Skill,用于让智能体在本地调用飞书 API。它通过一个运行时脚本处理四类动作:help 渐进式帮助(适配 LLM 自发现)、auth 授权与 token 管理、tool 业务动作、api 原始 Open API 调用。
用法上以 python3 skills/feishu-cli/run.py '{...}' 形式执行,参数为 JSON。help 支持逐层展开:先看顶层总览,再看 auth、modules,进而查看某模块动作,最后查看某动作参数与示例。auth 支持查看授权状态、获取租户 token、生成 OAuth URL(含 redirect allowlist 预检)。tool 覆盖 calendar、contact、doc、wiki、drive、sheets、mail、meeting、okr、bitable、message、task 等模块,例如创建日程、读取文档、查询通讯录用户。api 可发起原始调用,如 {"action":"api","method":"GET","path":"/contact/v3/scopes"}。
环境变量包括 LARK_APP_ID、LARK_APP_SECRET、LARK_TENANT_TOKEN(可选,优先直用)、LARK_OPEN_BASE_URL、LARK_OAUTH_REDIRECT_URI、LARK_OAUTH_REDIRECT_ALLOWLIST、LARK_OAUTH_SCOPES。旧动作名已配置别名,可正常调用,文档以新名为准。
适用场景为需要以编程方式在本地操作飞书各类资源的智能体任务。限制与收费、配额、权限细节暂未提供。