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 条回复 | | 用户要求"完整对话"、"详细讨论"、"看看回复...