diff --git a/skills/mail-operations/SKILL.md b/skills/mail-operations/SKILL.md index 3521b15..b27e4a7 100644 --- a/skills/mail-operations/SKILL.md +++ b/skills/mail-operations/SKILL.md @@ -10,7 +10,7 @@ description: >- Use when 用户提到 邮件、邮箱、收件箱、发邮件、回复邮件、查邮件、Gmail、 Outlook、QQ邮箱、163邮箱、附件、标签、草稿、自动回复、邮件规则、 转发、抄送、未读邮件、收信、发信、邮件同步、邮件搜索。 -version: 1.0.6 +version: 1.1.0 type: procedural risk_level: medium status: enabled @@ -24,7 +24,7 @@ tags: - smtp metadata: author: desirecore - updated_at: '2026-09-29' + updated_at: '2026-10-05' i18n: default_locale: en-US source_locale: zh-CN @@ -45,9 +45,9 @@ metadata: description: >- Use this skill whenever the user wants to interact with email. This includes reading inbox, sending emails, replying, searching messages, managing labels and categories, downloading attachments, setting up auto-reply rules, or triggering agents to handle incoming emails. Supports Gmail, Outlook, and IMAP/SMTP (QQ Mail, 163, Yahoo, etc.) through DesireCore's local REST API. Use when the user mentions email, mailbox, inbox, sending email, replying, checking email, Gmail, Outlook, QQ Mail, 163 Mail, attachments, labels, drafts, auto-reply, email rules, forwarding, CC, unread email, receiving, sending, email sync, or email search. body: ./SKILL.md - source_hash: sha256:02d90959ea1d7e29 + source_hash: sha256:ec3be525ab586e62 translated_by: human - translated_at: '2026-05-03' + translated_at: '2026-10-05' market: icon: >- 所有路径前缀为 `/api/{provider}/messages`(Gmail/IMAP)或 `/api/outlook/`(Outlook 特殊路由)。IMAP 的 `{uid}` 可直接用列表返回的 `id`(`imap:`),`folder` 规则见第 2 节,INBOX 可省略。 +**标记为垃圾邮件 / 不是垃圾邮件**:把邮件移入垃圾邮件文件夹,或从垃圾邮件文件夹移回收件箱,服务器与本地缓存同时修改,返回 `result: {id, folder}`。 +- Gmail 改 `SPAM` / `INBOX` 标签,`id` 不变;Outlook、IMAP 移动后 `id` 会变,之后再操作这封邮件要用返回的新 `id`。IMAP 服务器不支持 UIDPLUS 时 `id` 为 `null`,对目标文件夹做一次 `messages/fetch` 后再取。 +- IMAP 账户在服务器上没有垃圾邮件文件夹时返回 409 `imap_spam_folder_not_found`,如实告知用户,不要重试,也不要改用其他文件夹代替。 +- 邮件已经在目标文件夹时直接返回成功。移回收件箱的邮件不会触发邮件规则,也不会推送新邮件通知。 +- 「不是垃圾邮件」一次只处理一封,不要把一批邮件一起移回收件箱;标记为垃圾邮件可以逐封调用。 +- 需要客户端 10.0.178 及以上;旧客户端返回 404,提示用户升级客户端。 + **邮件详情额外字段**:`body: {content, contentType}`, `ccRecipients`, `attachments: [{id, filename, contentType, size}]`。IMAP 附件的 `id` 是附件在该邮件中的序号字符串(`"0"`、`"1"`……)。 ### 4. 发送与回复 diff --git a/skills/mail-operations/catalog-metadata.v1.json b/skills/mail-operations/catalog-metadata.v1.json index 710c1f1..f54ae3c 100644 --- a/skills/mail-operations/catalog-metadata.v1.json +++ b/skills/mail-operations/catalog-metadata.v1.json @@ -31,13 +31,13 @@ }, "release": { "state": "known", - "version": "1.0.6", + "version": "1.1.0", "versionScheme": "semver" }, "timestamps": { "catalogUpdatedAt": { "state": "known", - "value": "2026-09-29", + "value": "2026-10-05", "precision": "day" }, "releasePublishedAt": { @@ -68,7 +68,7 @@ "platforms": { "state": "unknown" }, - "requiredClientVersion": "10.0.148" + "requiredClientVersion": "10.0.178" }, "spec": { "kind": "skill",