Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-email
wecomcli-email
Verified何时用:仅当用户明确提到企业微信「邮箱/邮件」时使用;泛指发消息默认走本地或消息技能,纯日程/会议走 calendar/meeting 技能。企微邮件:发送/回复/转发、搜索列表、获取详情(正文/附件/内嵌图片),支持经邮件发送日程邀约和会议预定。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.8 KB |
| references/forward-mail.md | markdown | 6.9 KB |
| references/get-mail.md | markdown | 11.7 KB |
| references/reply-mail.md | markdown | 10.4 KB |
| references/search-mail.md | markdown | 14.1 KB |
| references/security.md | markdown | 2.6 KB |
| references/send-mail.md | markdown | 12.9 KB |
| references/send-schedule.md | markdown | 5.7 KB |
references/forward-mail.md
View on GitHub# 工作流示例:邮件转发
**适用场景**:用户需要将某封邮件转发给其他人,可选附加转发说明。
## 执行前必读
当本文档流程中需要调用其他技能时,必须先阅读对应技能的 SKILL 文档,获取完整的接口参数和调用规范后再执行。
## 步骤一:定位被转发邮件
若用户未直接提供邮件,参考 [search-mail](./search-mail.md) 搜索定位目标邮件(用主题关键词或发件人作为搜索条件),内部记录:
- `mail_id`(用于 `forward.last_mail_id`)
- **原邮件主题 `subject`**(用于步骤四构造新主题)
两项都可以从搜索邮件接口返回的 `mails[].mail_id` / `mails[].subject` 取得;若只有 `mail_id` 没有主题,再调获取邮件详情接口补齐 `subject`(参见 [get-mail](./get-mail.md))。
> `mail_id` 字段对用户不可见,但 `subject` 需要用于构造新主题,务必拿到。
## 步骤二:解析收件人
参考邮件发送工作流步骤二(见 [send-mail](send-mail.md))解析收件人信息:若用户已提供完整邮箱地址则直接使用;若提供的是人名,则需先通过通讯录查询——优先取其 `email` 填入 `to.emails`,若该用户没有邮箱则使用其 `userid` 填入 `to.userids` 尝试投递(不要因为没有邮箱就直接拒绝转发)。发件人由接口自动填充,无需查询。
## 可选步骤三:处理转发说明
根据用户原始表述判断是否需要附加转发说明,无需向用户追问确认:
- **用户未提及附加说明(最常见)**:正文默认**留空**。具体做法是**完全省略** `file_path` 字段,接口会自动带上原邮件正文。
- **用户提到附加说明**:用 `write` 把正文写入本地 Markdown 文件(`.md`),记录路径作为 `file_path`,调用时设 `content_type: "markdown"`。参考 [send-mail](send-mail.md) 步骤三。
- 若需要追加附件或内嵌图片,组装 `attachments[]` 和 `inline_images[]` 时 `media_id` 与 `file_path` 二选一、禁止同时填,`media_id` 禁止自行构造,详见 send-mail.md 步骤四(附件)与步骤五(内嵌图片)。内嵌图 `$xxx$` 占位符严格写成 ``(方括号留空,不带 alt 和 title)。
## 步骤四:构造转发主题
转发主题必须由本技能自己构造并填入 `subject` 字段,接口不会自动拼前缀,也不能留空。
默认规则:
```
subject = "转发:" + 原邮件主题
```
例如原邮件主题为 `"Q2 项目进展汇报"`,构造后的转发主题为 `"转发:Q2 项目进展汇报"`。
**智能去重**:如果原邮件主题已经是某封邮件的转发,此时**直接沿用原主题**,不再叠加 `"转发:"` 前缀,避免出现 `"转发:转发:转发:xxx"` 这种链式叠加。
**匹配算法**:
1. 先 trim 掉原主题前导的空白字符
2. 大小写不敏感地判断开头是否是 `转发`、`fwd` 或 `fw`(英文),后面跟中文冒号 `:` 或英文冒号 `:`
3. 冒号前后的空格数量**不影响匹配**:`Fwd: x`、`fw:x`、`FWD : x`、`转发: x`、`转发 :x` 都算命中
4. **命中时**:直接沿用原主题,必须**一字不差**保留原始的大小写、空格、标点,不要"顺手规范化"
5. **未命中时**:在原主题前面加 `"转发:"`(中文全角冒号)
| 原主题 | 判断 | 构造后的转发主题 |
|---|---|---|
| `Q2 项目进展汇报` | 未命中 | `转发:Q2 项目进展汇报` |
| `转发:Q2 项目进展汇报` | 命中 `转发:` | `转发:Q2 项目进展汇报`(沿用) |
| `Fwd: Weekly Sync` | 命中 `Fwd:` | `Fwd: Weekly Sync`(沿用) |
| `fw: daily report` | 命中 `fw:` | `fw: daily report`(沿用) |
| `FWD : Weekly` | 命中 `FWD :` | `FWD : Weekly`(沿用) |
若用户明确指定了另一个主题,使用用户指定的值,不做上述构造。
> **跨类型不抵消**:原主题如果是回复(以 `"回复:"`/`"Re:"` 开头),转发时仍然要按"转发原主题"处理,即改为 `"转发:回复:Q2 项目进展汇报"`。去重只针对**同类型**前缀,不同类型前缀互不干扰。这是合理的:因为这一链路确实是"转发了一封回复邮件",语义上两层前缀都有意义。
## 步骤五:预览并转发邮件
### 5.1 预览转发邮件
调用 `wecom-cli mail send` 之前,必须先在对话中向用户展示一份转发邮件预览,让用户感知邮件内容。**预览只作为内容呈现,展示完成后无需主动追问"是否发送/确认",直接进入 5.2 调用接口**。
预览输出格式、字段说明见 [SKILL.md](../SKILL.md) 「邮件发送预览」章节。
### 5.2 调用接口
**前置检查**:调用接口前,确认刚刚已执行过 5.1 预览;若尚未预览,必须先回到 5.1。
把各步骤得到的参数组装成最终 JSON,调用 `wecom-cli mail send` 转发。
**无附加说明的场景(正文为空)**:
```bash
wecom-cli mail send --json '{
"to": {
"emails": ["<收件人邮箱>"],
"userids": ["<收件人 userid>"]
},
"subject": "转发:<原邮件主题>",
"forward": {
"last_mail_id": "<被转发邮件 mail_id>"
}
}'
```
**附加说明的场景**:
```bash
wecom-cli mail send --json '{
"to": {
"emails": ["<收件人邮箱>"],
"userids": ["<收件人 userid>"]
},
"subject": "转发:<原邮件主题>",
"file_path": "<转发说明的本地 .md 文件路径>",
"content_type": "markdown",
"forward": {
"last_mail_id": "<被转发邮件 mail_id>"
},
"attachments": [
{"media_id": "<媒体 ID,优先>"}
]
}'
```
- `subject` 必须按步骤四构造好的结果填入,不能留空,两种场景都要带
- 接口返回 `mail_id` → 告知用户邮件已成功转发,展示收件人和主题即可。**`mail_id` 是一串不可读的内部编码,禁止出现在面向用户的任何输出中**
- 接口失败时 → **必须**按 SKILL.md「接口失败处理」展示 `error.message`(失败原因)和 `error.instruction`(解决建议);禁止只回复"失败"而不附带原因,禁止盲目重试
## 关键注意点
- **无说明的转发**:直接省略 `file_path`,不要传空字符串;接口会自动附带原邮件正文
- **有说明的转发**:正文同样走本地 `.md` 文件路径;`content_type` 固定填 `"markdown"`
- **主题必填且必须构造**:接口不会自动拼 `Fwd: ` 前缀,技能自己负责把 `subject` 构造为 `"转发:" + 原邮件主题`;原主题已有 `转发:`/`Fwd:` 前缀时直接沿用。因此在步骤一定位邮件时就要把 `subject` 一起记下来
- **转发追加的附件/图片**:`media_id` 与 `file_path` 二选一、禁止同时填,`media_id` 禁止自行构造;详见 [send-mail](send-mail.md) 步骤四(附件)与步骤五(内嵌图片)
- **邮件总大小不超过 50MB**:正文文件 + 所有附件合计不能超过 50MB,上传失败时提醒用户检查是否超限
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |