用途:面向飞书(Lark)即时通讯场景,提供消息收发、聊天记录搜索、群聊与成员管理、图片文件上传下载、表情回复与 Pin 等操作。
主要能力:Shortcut 封装包括 +chat-create(建群,仅机器人)、+chat-messages-list(列出会话消息)、+chat-search(按关键词或成员搜索群)、+chat-update(改群名/描述)、+messages-mget(批量取消息)、+messages-reply(回复,仅机器人)、+messages-resources-download(下载消息中的图片/文件)、+messages-search(跨会话搜索,仅用户身份)、+messages-send(发消息,仅机器人)、+threads-messages-list(列出话题回复)。原生 API 覆盖 chats、chat.members、messages、reactions、images、pins 等资源。
使用方式:开始前必须先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证与权限处理。调用 API 前先查看参数结构:lark-cli schema im.<resource>.<method>,再执行 lark-cli im <resource> <method> [flags]。身份通过 --as user(user_access_token)或 --as bot(tenant_access_token)指定,同一接口在不同身份下可能成功或失败。
限制:部分操作仅限机器人身份(如建群、发消息、回复、转发、合并转发、查询已读、上传图片);消息搜索仅限用户身份。机器人身份取消息时,若应用可见范围不含发送者,发送者名称可能显示为 open_id。卡片消息(interactive)在事件订阅中暂不支持紧凑转换,会返回原始事件数据。各方法需对应 scope,如 im:chat:create、im:message:recall、im:message.reactions:write_only 等。具体收费、价格与平台信息暂未提供。