Feishu OpenAPI Skill

通过UXC调用飞书/Lark API,支持精选OpenAPI规范、租户令牌认证及消息安全护栏。

安装

概览

飞书/Lark OpenAPI Skill 是一个基于 `uxc` 框架开发的命令行工具技能,专为通过 OpenAPI 规范调用飞书(Feishu)或 Lark 即时通讯(IM)接口而设计。该工具封装了飞书开放平台的核心 IM 功能,提供统一的 API 访问入口,支持消息发送、聊天管理、文件上传、用户查询等常用操作。开发者可通过标准化的命令格式直接与飞书或 Lark 的 RESTful API 交互,无需手动处理认证细节或 JSON 结构解析。工具内置了对租户令牌(tenant_access_token)的自动获取与刷新机制,并支持长连接事件订阅,适用于构建自动化机器人或集成工作流系统。目前该技能已验证覆盖消息收发、群组管理、媒体上传及联系人检索等场景,但不涉及文档、表格等非 IM 产品线。

核心功能特点

  1. 基于精选 OpenAPI 规范,提供飞书/Lark IM 接口的统一命令行入口
  2. 支持自动化的 tenant_access_token 获取与刷新,简化身份认证流程
  3. 集成 uxc auth 体系,支持凭证绑定与多环境配置管理
  4. 支持长连接事件订阅(feishu-long-connection),可接收实时消息推送
  5. 兼容 multipart 文件上传与结构化消息构造,适配图文、附件等多种消息类型
  6. 提供清晰的帮助输出与操作分组,便于快速查阅 API 参数与用法

适用场景

该工具特别适合需要与飞书或 Lark 即时通讯系统深度集成的开发者和运维人员。例如,在企业内部搭建自动化通知机器人时,可通过该技能发送定时提醒、状态更新或异常告警到指定群聊或个人会话中;在客服系统中,结合消息接收能力,实现自动回复与工单流转;在 DevOps 场景中,用于部署完成后向团队频道推送构建结果或日志摘要。此外,对于希望将飞书作为协作中枢的平台型应用,该工具提供了稳定可靠的底层通信能力,避免重复造轮子。由于支持事件驱动模型,也适合构建监听特定关键词、触发自动化动作的智能助手。虽然不涵盖文档协同、审批流程等其他产品线,但在纯 IM 交互需求上具备高效、安全且易于维护的优势。