feishu-im-read

飞书 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 继续获取下一页 根据用户需求判断是否需要翻页：需要完整结果时继续翻页，浏览概览时第一页通常够用 3. 话题回复：主动展开话题获取上下文 获取历史消息时，返回的消息中如果包含 thread_id 字段，推荐主动获取话题的最新 10 条回复（ page_size: 10, sort_rule: "create_time_desc" ）以提供更完整的上下文。 场景 行为 获取历史消息并需要理解上下文（默认） 对发现的 thread_id 调用 feishu_im_user_get_thread_messages 获取最新 10 条回复 用户要求"完整对话"、"详细讨论"、"看看回复" 获取话题全部回复（ page_size: 50, sort_rule: "create_time_asc" ），需要时翻页 用户只浏览消息概览 / 用户明确说不看回复 跳过话题展开 注意 ：话题消息不支持时间过滤（飞书 API 限制），只能通过分页获取。 4. 跨会话消息搜索 feishu_im_user_search_messages 支持跨所有会话搜索消息： 参数 说明 query 搜索关键词，匹配消息内容 sender_ids 发送者 open_id 列表 chat_id 限定搜索范围的会话 ID mention_ids 被@用户的 open_id 列表 message_type 消息类型：file / image / media sender_type 发送者类型：user / bot / all（默认 user） chat_type 会话类型：group / p2p 搜索结果每条消息额外包含 chat_id 、 chat_type （p2p/group）、 chat_name 。单聊消息还有 chat_partner （对方 open_id 和名字）。 5. 图片/文件/媒体资源的提取 消息内容中可能出现以下资源标记，用 feishu_im_user_fetch_resource 下载： 资源类型 内容中的标记格式 fetch_resource 参数 图片 message_id= om_xxx , file_key= img_xxx , type= "image" 文件 message_id= om_xxx , file_key= file_xxx , type= "file" 音频