WPS 协作

这个技能解决什么问题

团队协作平台里，IM 会话、日程、邮件分散在不同入口。写自动化脚本时，要轮询会话列表、翻页、按时间过滤、发消息带 @、约日程查忙闲、搜邮件……每个动作都要手写一套 HTTP 调用，参数格式各不一样，稍不注意就会翻车。@user_b22a52ba/wps-collab 把这些能力打包成一组统一的函数式接口，让 Agent 可以直接读写 WPS 协作的数据。

核心能力

IM 聊天管理：im_recent_chats 拉最近会话（可过滤未读、@我），im_get_history 取历史消息，im_create_chat 建群或单聊，im_recall 撤回消息，im_send / im_send_me 发送文本、图片、云文档的组合消息，另有 search_chats、search_messages。

身份与组织：get_user 查用户详情，search_user 按姓名/邮箱/手机号/登录名搜索企业用户。

日程协作：list_events_single_calendar 按区间拉日程（注意区间 ≤ 31 天），create_event / delete_event 增删日程，batch_create_event_attendee / batch_delete_event_attendee 批量维护参与者，list_free_busy 查忙闲。

邮件处理：list_mail_messages_in_folder 列邮件，get_mail_message 取全文，search_mail_messages 按发件人/主题/正文搜索，send_mail 支持抄送、密送与附件。

AI 增值：recall_rank 在知识库中按问题召回相关片段，get_meeting_summary 取日程对应的会议纪要。

关键细节与坑

• 所有 start_time / end_time 统一接受 ISO 字符串，如 "2026-03-23T00:00:00+08:00"。
• 发消息时 file_id 是 https://365.kdocs.cn/l/{file_id} 中 {file_id} 那一段，不是整条 URL。
• 多图与文字交叉排列时优先用 blocks 内容块，而不是 text + image_paths。
• 用 mentions 时不要在 text/blocks 里手写 @名字，系统会自动追加标记，手写反而重复且不触发通知。
• promo_text 是必填的消息后缀/签名；传空字符串会自动补默认后缀，也可以读取用户记忆中的签名字段。
• send_mail 不可重复调用：若返回"草稿已创建但发送失败"，应重试发送该草稿，而不是重新调用 send_mail()。
• create_event 只建日程、不处理参与者，邀请人要事后单独调用 batch_create_event_attendee。
• search_messages 的 keyword / chat_id_list / 时间范围三选一必填，page_size 上限多为 50。