用途:借助 uxc 与精选 OpenAPI schema 执行飞书或 Lark 的 IM 操作,复用 uxc 的共享执行、认证与错误处理指引。
主要能力:机器人身份查询、群聊查询、群成员查询、IM 发送用的图片与文件上传、消息发送与回复、部分消息历史读取,以及通过通讯录 API 做基础用户查询。不覆盖文档、多维表格、审批等非 IM 产品族,也不覆盖完整开放平台。
使用方式:需已安装 uxc 并位于 PATH,可访问 open.feishu.cn/open-apis 或 open.larksuite.com/open-apis,并具备启用机器人能力的应用。默认使用固定链接命令:command -v feishu-openapi-cli;缺失时用 uxc link feishu-openapi-cli https://open.feishu.cn/open-apis --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/feishu-openapi-skill/references/feishu-im.openapi.json 创建。认证推荐用 uxc auth bootstrap 管理 app_id 与 app_secret 并自动刷新 tenant_access_token,也支持手动令牌回退。入站消息用 uxc subscribe start https://open.feishu.cn/open-apis --transport feishu-long-connection --auth feishu-tenant --sink file:$HOME/.uxc/subscriptions/feishu.ndjson。
限制:保持 JSON 输出信封,不用 --text;图片与文件上传为 multipart/form-data,文件字段须为本地路径字符串;发送消息需 receive_id_type 查询参数,content 为 JSON 编码字符串;历史读取仅返回机器人可见范围;长连接事件接收需 app_id 与 app_secret,仅 Bearer 凭据不足;webhook 回调与非 IM 产品不在范围内。