From 362f800bd2401e0ca872e3ba0b89b2f6b7f59e77 Mon Sep 17 00:00:00 2001 From: Yige Date: Mon, 5 Oct 2026 22:22:17 -0700 Subject: [PATCH] =?UTF-8?q?feat(mail-operations):=20=E8=A1=A5=E5=85=85?= =?UTF-8?q?=E6=A0=87=E8=AE=B0=E4=B8=BA=E5=9E=83=E5=9C=BE=E9=82=AE=E4=BB=B6?= =?UTF-8?q?=20/=20=E4=B8=8D=E6=98=AF=E5=9E=83=E5=9C=BE=E9=82=AE=E4=BB=B6?= =?UTF-8?q?=E6=8E=A5=E5=8F=A3=EF=BC=881.1.0=EF=BC=89=20(#208)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## 变更 / Changes mail-operations 1.0.6 → 1.1.0：补充客户端新增的「标记为垃圾邮件 / 不是垃圾邮件」接口。 Adds the client's new mark-as-junk / not-junk endpoints to mail-operations (1.0.6 → 1.1.0). - 「单封邮件操作」表新增两行：Gmail、IMAP 用 `POST …/{id}/spam`、`…/not-spam`，Outlook 用 `POST /outlook/message/spam?id=`、`…/not-spam?id=`。 Two rows in the single-message table. - 补充使用说明：返回 `result: {id, folder}`；Outlook、IMAP 移动后 `id` 会变；IMAP 没有垃圾邮件文件夹时返回 409 `imap_spam_folder_not_found`，不要重试；「不是垃圾邮件」一次一封；移回收件箱不触发规则。 Usage notes: new id after Outlook/IMAP moves, 409 when an IMAP account has no junk folder, Not junk one at a time, no rule re-trigger. - `market.required_client_version` 与 sidecar 的 `compatibility.requiredClientVersion` 同步改为 `10.0.178`。内置技能同步会按它拦截，旧客户端继续使用 1.0.6，不会拿到调用后返回 404 的接口说明。 Client gate raised to 10.0.178 so older clients keep 1.0.6. - 中文是源语言；英文译文（`translated_by: human`）已人工同步，`source_hash` 用 `translate.py` 的 `compute_source_hash` 重新计算。 zh-CN source and human en-US translation updated together; `source_hash` recomputed with the repository's own function. ## 合并时机 / Merge timing 客户端实现在 desirecore/desirecore#4205，它依赖 desirecore/desirecore#4195。**请在 #4205 合入、确认随 10.0.178 发布之后再合并本 PR。** 如果实际发布的版本号不是 10.0.178，先把两处 `required_client_version` 改成实际版本再合并。合并后，客户端仓库需要运行 `npm run sync-market` 刷新内置的 `market.zip`。 The client side is desirecore/desirecore#4205 (depends on #4195). Merge this after #4205 lands and ships in 10.0.178; adjust both version gates if the release number differs. Afterwards regenerate the client's bundled `market.zip` with `npm run sync-market`. ## 校验 / Checks - `validate-i18n.py`：0 error，123 warning（与改动前相同；mail-operations 的两条 license / review evidence 警告原来就有）。 - `validate_catalog_metadata.py --require-complete`：0 error。 - `translate.py --check skills/mail-operations`：en-US 为 human-locked，与源一致。 - 公开信息检查：改动内容只有通用的接口说明，不含任何租户、客户或合作方信息。**未用私有敏感词清单做全量扫描**：本次没有拿到这份清单，合并前请维护者补跑一次。 Public-information review: generic API text only. The private-token scan was not run because the token list was not available; please run it before merging. --- skills/mail-operations/SKILL.md | 21 +++++++++++++------ skills/mail-operations/SKILL.zh-CN.md | 11 +++++++++- .../mail-operations/catalog-metadata.v1.json | 6 +++--- 3 files changed, 28 insertions(+), 10 deletions(-) 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",