feishu-chat-server-api

# Feishu Chat Server API 这个 skill 负责飞书群组管理相关能力，当前覆盖以下 action： - `feishu-chat-create` - `feishu-chat-get` - `feishu-chat-members-list` - `feishu-chat-member-add` - `feishu-chat-member-remove` - `feishu-chat-disband` ## 何时使用 当用户请求与飞书群组本身相关的操作时使用这个 skill，例如： - 创建一个新群 - 查看某个群的详情 - 列出群成员 - 往群里加人 - 从群里移人 - 解散群 如果用户请求的是消息发送、卡片、文档、多维表格、审批等能力，不要用这个 skill，应该路由到对应模块级 skill。 ## 路由规则 根据用户意图选择具体 action： - 创建群：`feishu-chat-create` - 获取群详情：`feishu-chat-get` - 获取群成员列表：`feishu-chat-members-list` - 拉人入群：`feishu-chat-member-add` - 移出群成员：`feishu-chat-member-remove` - 解散群：`feishu-chat-disband` 不要把“移除一个成员”和“解散整个群”混淆。 ## 通用输入 凭证优先级如下： 1. action 显式传入 `app_id` / `app_secret` 2. 当前工作目录下的 `.local/feishu-extension-skills.json` 3. 环境变量 `FEISHU_APP_ID` / `FEISHU_APP_SECRET` 如果这 3 层都没有命中，调用会失败。 也可以在调用命令里通过 `--config-file /path/to/file.json` 显式指定本地配置文件路径。 群相关 action 还需要按场景提供： - `chat_id` - `name` - `user_id_list` - `member_id` 约束： - 只接受飞书 `user_id` 或 `open_id` - 不要自行猜测邮箱、手机号、姓名对应的用户 ID ## 调用命令 统一调用入口： ```bash uvx --from git+https://github.com/wodenwang/feishu-extension-skills.git feishu-extension-skills invoke <action> --args-json '<json>' ``` ClawHub 安装： ```bash clawhub install feishu-chat-server-api ``` 本地配置文件示例： ```json { "app_id": "cli_xxx", "app_secret": "sec_xxx" } ``` 示例： ```bash uvx --from git+https://github.com/wodenwang/feishu-extension-skills.git feishu-extension-skills invoke feishu-chat-create --args-json '{"app_id":"cli_xxx","app_secret":"sec_xxx","name":"项目临时群","user_id_list":["ou_xxx","ou_yyy"]}' ``` ```bash uvx --from git+https://github.com/wodenwang/feishu-extension-skills.git feishu-extension-skills invoke feishu-chat-member-add --args-json '{"app_id":"cli_xxx","app_secret":"sec_xxx","chat_id":"oc_xxx","user_id_list":["ou_xxx"]}' ``` ## 当前未覆盖 这个 skill 当前还没有封装以下群治理接口： - 更新群信息 - 更新群发言权限 - 获取群成员发言权限 - 更新群置顶 / 撤销群置顶 - 获取用户或机器人所在的群列表 - 搜索可见群列表 - 获取群分享链接