SuperAPI AI 工具集

lark-workflow-announce

办公与效率

查看项目

更新于 10-16 06:23

技能介绍

用途:管理飞书群公告,支持查看、设置、追加群公告内容,并可选通知群成员。触发场景包括“群公告”“发布公告”“更新公告”“设置群公告”“追加公告”“群通知”等。

主要能力:通过 im +chat-search 按群名称查找 chat_id;用 lark-cli api GET 读取当前公告(返回 content 与 revision);用 PATCH 覆盖或追加公告;用 im +messages-send 发送 @全体成员 通知。

使用方式:开始前必须先用 Read 工具读取 ../lark-shared/SKILL.md(含认证与权限处理)。仅支持 user 身份,执行前需授权:lark-cli auth login --domain im。查找群聊:lark-cli im +chat-search --query "<群名称>" --as user。读取公告:MSYS_NO_PATHCONV=1 lark-cli api GET "/open-apis/im/v1/chats/<chat_id>/announcement" --as user。设置或追加公告使用 PATCH,需传入当前 revision 与 requests 数组,内容为 HTML(非 Markdown),支持 <br>、<b>、<a href="">、<font color=""> 等标签。追加模式需先读取旧公告再合并。通知群成员:lark-cli im +messages-send --chat-id "<chat_id>" --text '<at user_id="all"></at> 群公告已更新,请查看群公告。' --as bot。

限制:revision 必须为最新版本号,否则报错;设置前须先读取。权限方面,chat-search 与 GET 需 im:chat:readonly,PATCH 需 im:chat,messages-send 需 im:message。降级策略:API 失败可改用普通消息;revision 冲突需重新读取;无权限需群管理员权限;@所有人受限则改发普通消息。具体收费、价格、平台支持等资料暂未提供。