feishu-cli-chat

SKILL.md

飞书会话浏览与管理

本技能处理“读聊天记录 / 管群 / 消息互动”。发送新消息走 feishu-cli-msg；构造卡片走 feishu-cli-card。

认证

多数命令需要 User Token：

feishu-cli auth check --scope "im:message:readonly im:message.group_msg:get_as_user"
feishu-cli auth login --domain chat --recommend

msg delete 例外：默认 App Token，用于 Bot 撤回自己 24 小时内发送的消息；传 --user-access-token 或环境变量时可走管理员撤回场景。

读消息
# 群聊历史
feishu-cli msg history --container-id oc_xxx --container-id-type chat --page-size 50 -o json

# 私聊：按邮箱或 open_id 自动反查 P2P chat_id
feishu-cli msg history --user-email user@example.com --page-size 50 -o json
feishu-cli msg history --user-id ou_xxx --page-size 50 -o json

# 消息详情 / 批量详情
feishu-cli msg get <message_id> -o json
feishu-cli msg mget --message-ids <message_id1,message_id2>

# 话题回复：需要明确 thread_id
feishu-cli msg thread-messages <thread_id> --page-size 50

JSON 字段使用 snake_case：

{
  "items": [],
  "has_more": true,
  "page_token": "next_page",
  "sender_names": {"ou_xxx": "张三"},
  "merge_forward_sub_messages": {}
}

分页时检查 has_more 和 page_token。合并转发子消息会自动展开到 merge_forward_sub_messages，通常不需要二次调用 API。

搜索与定位

# 搜索群聊
feishu-cli msg search-chats --query "项目群" -o json

# 搜索消息内容，P2P 用 search messages 而不是 search-chats
feishu-cli search messages "关键词" --chat-type p2p_chat -o json
feishu-cli search messages "关键词" --chat-ids oc_xxx -o json

搜索消息属于 feishu-cli-search 的能力；本技能只在聊天阅读任务里顺带调用。

消息互动

# Reaction
feishu-cli msg reaction add <message_id> --emoji-type THUMBSUP
feishu-cli msg reaction remove <message_id> --reaction-id <reaction_id>
feishu-cli msg reaction list <message_id>

# Pin
feishu-cli msg pin <message_id>
feishu-cli msg unpin <message_id>
feishu-cli msg pins --chat-id <chat_id>

# 删除消息
feishu-cli msg delete <message_id>
feishu-cli msg delete <message_id> --user-access-token u-xxx

群聊管理

feishu-cli chat get oc_xxx -o json
feishu-cli chat update oc_xxx --name "新群名"
feishu-cli chat member list oc_xxx -o json
feishu-cli chat member add oc_xxx --id-list ou_xxx,ou_yyy
feishu-cli chat member remove oc_xxx --id-list ou_xxx
feishu-cli chat create --name "项目群" --user-ids ou_xxx,ou_yyy
feishu-cli chat delete oc_xxx

常见决策

需求
命令

看某个群最近消息
msg history --container-id <chat_id> --container-id-type chat

看和某人的私聊
msg history --user-email <email> 或 --user-id <open_id>

找群
msg search-chats --query "<name>"

按关键词搜消息
search messages "<keyword>" ...

读合并转发
msg get -o json / msg mget --message-ids ... / msg history -o json，查看 merge_forward_sub_messages

看话题回复
msg thread-messages <thread_id>

发送新消息
转到 feishu-cli-msg

输出处理

保存 JSON 到临时文件再分析，避免长消息刷屏。

文本内容通常在 body.content 里，需按 msg_type 解析 JSON 字符串。

sender_names 已自动给出 open_id 到姓名的映射，优先用它展示发送者。