用途:作为飞书 CLI 的平台基础能力层,处理登录鉴权、多应用配置、权限诊断、技能与 CLI 版本维护,并提供 OpenAPI 查询与直接调用的通道。它不是飞书请求的通用兜底,业务命令应交由对应领域技能。
主要能力与路由:登录、登出、scope 预检、应用已开通 scope 诊断、Token、profile、config、doctor、技能安装与漂移、CLI 升级,见 references/workflows/auth/workflow.md;调用任意 OpenAPI(含 --as、分页、dry-run)见 references/workflows/api/workflow.md;查询本地 OpenAPI path、参数与 scope 见 references/workflows/schema/workflow.md;全局搜索文档、消息或应用见 search workflow;查询用户、邮箱、手机号、部门及搜索机器人见 directory workflow。使用时应先判断意图再读取对应工作流,不要一次加载全部 reference;references/、scripts/、templates/、examples/ 相对路径按 workflow.md 所在目录解析。
执行规则:仓库开发优先使用 make build 生成的 bin/feishu-cli 或 ./feishu-cli,安装环境用 PATH 中的 feishu-cli;版本不一致时以 --help 为准,可用 feishu-cli skills read <技能> <相对路径> 读取配套文档。auth check --scope 只检查当前 profile 的本地 User Token,不代表 Bot 权限;应用侧是否开通使用 auth scopes --scope;不要回显真实 Token。多 Bot 场景先 profile list --json,单次使用 --profile <name> 且不改默认指针;环境变量覆盖冲突时可在本次进程内移除覆盖,或用 --bot-app-id/--bot-app-secret 指定凭证,不修改用户全局环境。api 写请求可先用本地 --dry-run 预览,但预览不代表服务端接受。
限制与约定:Schema 只负责发现接口,API 负责执行请求,通常先查 schema 再调 api;查 schema 或透传未封装端点时留在本技能,业务命令交给对应领域技能。退出码 10 需用户同意后才追加 --yes,判断命令成败与脚本约定见 agent-contract。涉及身份选择或遇 Token、身份、scope 报错时读取 identity 文档。搜索与通讯录结果默认只读。各领域边界:文档 feishu-cli-docs、云盘 feishu-cli-storage、消息 feishu-cli-messaging、Sheet/Bitable feishu-cli-data、视觉 feishu-cli-visual、办公 feishu-cli-work、邮箱 feishu-cli-mail、会议 feishu-cli-meetings。具体收费与平台限制资料暂未提供。