菜单
Read and search Feishu IM messages via lark-cli — conversation history, thread expansion, cross-chat search, and resource download.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Control message formatting and writing style for Lark/Feishu conversations.
Create, query, edit, and manage Feishu Bitable (multidimensional spreadsheets) via lark-cli base — apps, tables, fields, records, views, dashboards, forms, workflows.
Manage Feishu calendar events via lark-cli — create/update/delete events, manage attendees, query free/busy and suggest available time slots, find and book meeting rooms.
List Feishu group chat members and resolve chat metadata via lark-cli.
Create a Feishu cloud document from Lark-flavored Markdown via lark-cli, with optional folder or wiki placement.
Comment management and media (image/file) operations on Feishu cloud documents via lark-cli.
| name | feishu-im-read |
| description | Read and search Feishu IM messages via lark-cli — conversation history, thread expansion, cross-chat search, and resource download. |
Inbound/read-side messaging routed through lark-cli im. For sending use feishu-im.
--as user 走用户身份；--as bot 仅能读 bot 在群里的消息。oc_xxx，message om_xxx，thread om_xxx 或 omt_xxx。--chat-id 和 --user-id 二选一；--relative-time 和 --start/--end 二选一。thread_id 时主动展开 thread。| Intent | Command |
|---|---|
| 群/单聊历史消息 | lark-cli im +chat-messages-list --chat-id oc_xxx |
| P2P 历史（用 user_id） | lark-cli im +chat-messages-list --user-id ou_xxx |
| 限定时间窗 | ... --start "2026-05-20T00:00:00+08:00" --end "2026-05-20T23:59:59+08:00" |
| 相对时间 | ... --relative-time 24h |
| Thread 展开 | lark-cli im +threads-messages-list --thread-id <om_or_omt> |
| 全局搜索消息 | lark-cli im +messages-search --query "<keyword>" |
| 限定群/人/时间搜 | lark-cli im +messages-search --query "..." --chat-id oc_xxx --sender ou_yyy --start ... --end ... |
| 批量拉消息 by id | lark-cli im +messages-mget --message-ids om_a,om_b,om_c |
| 列我所在群 | lark-cli im +chat-list |
| 找群 by 关键词/成员 | lark-cli im +chat-search --query "周会" --member-ids ou_xxx |
| 下载消息中的图片/文件 | lark-cli im +messages-resources-download --message-id om_xxx --file-key <key> --output ./x.jpg |
| 场景 | 取多少 |
|---|---|
| 默认理解上下文 | 最新 10 条 (page_size 10, sort create_time_desc) |
| "完整对话"/"详细讨论" | 全部 (page_size 50, sort create_time_asc)，分页拉完 |
| 仅浏览概览 | 跳过 thread 展开 |
Thread 不支持时间过滤（API 限制），只能分页。
# 看某个群最近一天聊了什么
lark-cli im +chat-messages-list \
--chat-id oc_abc \
--relative-time 24h --page-all
# 跨群搜"线上故障"
lark-cli im +messages-search --query "线上故障" --start "2026-05-13" \
--jq '.items[]|{chat,sender_name,text:.content|@text}'
# 展开一个 thread
lark-cli im +threads-messages-list --thread-id omt_xxx --page-all
| Wrong | Right |
|---|---|
同时给 --chat-id 和 --user-id | 二选一 |
同时给 --relative-time 和 --start/--end | 二选一 |
看到 thread_id 不展开 | 主动用 +threads-messages-list 拿 thread 全文 |
| 把 image key 当 URL 访问 | 必须 +messages-resources-download 下载 |
| 拉大量历史不分页 | 加 --page-all 自动翻页 |