feishu-im-read
飞书 IM 消息读取工具使用指南，覆盖会话消息获取、话题回复读取、跨会话消息搜索、图片/文件资源下载。 **当以下情况时使用此 Skill**: (1) 需要获取群聊或单聊的历史消息 (2) 需要读取话题（thread）内的回复消息 (3) 需要跨会话搜索消息（按关键词、发送者、时间等条件） (4) 消息中包含图片、文件、音频、视频，需要下载 (5) 用户提到"聊天记录"、"消息"、"群里说了什么"、"话题回复"、"搜索消息"、"图片"、"文件下载" (6) 需要按时间范围过滤消息、分页获取更多消息
Profile →npx skills add nexu-io/nexu --skill feishu-im-read --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 飞书 IM 消息读取 ## 执行前必读 - 该 Skill 中的所有消息读取工具均以用户身份调用，只能读取用户有权限的会话 - `feishu_im_user_get_messages` 中 `open_id` 和 `chat_id` 必须二选一 - 消息中出现 `thread_id` 时，根据用户意图判断是否用 `feishu_im_user_get_thread_messages` 读取话题内回复 - 以用户身份读取后，如果消息内容中出现资源标记时，用 `feishu_im_user_fetch_resource` 下载，需要 `message_id` + `file_key` + `type` --- ## 快速索引：意图 → 工具 | 用户意图 | 工具 | 必填参数 | 常用可选 | |---------|------|---------|---------| | 获取群聊/单聊历史消息 | feishu_im_user_get_messages | chat_id 或 open_id（二选一） | relative_time, start_time/end_time, page_size, sort_rule | | 获取话题内回复消息 | feishu_im_user_get_thread_messages | thread_id（omt_xxx） | page_size, sort_rule | | 跨会话搜索消息 | feishu_im_user_search_messages | 至少一个过滤条件 | query, sender_ids, chat_id, relative_time, start_time/end_time, page_size | | 下载消息中的图片 | feishu_im_user_fetch_resource | message_id, file_key（img_xxx）, type="image" | - | | 下载消息中的文件/音频/视频 | feishu_im_user_fetch_resource | message_id, file_key（file_xxx）, type="file" | - | --- ## 核心约束 ### 1. 时间范围：确保消息覆盖完整 当用户没有明确指定时间范围时，根据用户意图推断合适的 `relative_time`，确保返回的消息能完整覆盖用户关心的内容。用户明确指定时间时直接使用用户的值。 ### 2. 分页：根据需要翻页获取更多结果 - `page_size` 范围 1-50，默认 50 - 返回结果中 `has_more=true` 时，可使用 `page_token` 继续获取下一页 - 根据用户需求判断是否需要翻页：需要完整结果时继续翻页，浏览概览时第一页
- 执行前必读
- 快速索引：意图 → 工具
- 核心约束
- 1. 时间范围：确保消息覆盖完整
- 2. 分页：根据需要翻页获取更多结果
- 3. 话题回复：主动展开话题获取上下文
- 4. 跨会话消息搜索
- 5. 图片/文件/媒体资源的提取
- 6. 时间过滤
- 7. openid 与 chatid 的选择
- 使用场景示例
- 场景 1: 获取群聊消息并展开话题
- 场景 2: 跨会话搜索消息
- 场景 3: 分页获取更多消息
What does the feishu-im-read skill do?
飞书 IM 消息读取工具使用指南，覆盖会话消息获取、话题回复读取、跨会话消息搜索、图片/文件资源下载。 **当以下情况时使用此 Skill**: (1) 需要获取群聊或单聊的历史消息 (2) 需要读取话题（thread）内的回复消息 (3) 需要跨会话搜索消息（按关键词、发送者、时间等条件） (4) 消息中包含图片、文件、音频、视频，需要下载 (5) 用户提到"聊天记录"、"消息"、"群里说了什么"、"话题回复"、"搜索消息"、"图片"、"文件下载" (6) 需要按时间范围过滤消息、分页获取更多消息
How do I install it?
Run `npx skills add nexu-io/nexu --skill feishu-im-read --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From nexu-io/nexu, a repository with 3,239 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.