# 邮件

企业微信邮箱的**发、回、转、搜、读**：发新邮件、回复、全部回复、转发、发日程邀约邮件与会议邮件，
按各种条件搜邮件，读正文、附件和内嵌图。
**能做的比大多数人以为的多**——但**标已读、删除、存草稿、改标签、撤回这些一概做不了**。

## 你可以怎么说

> 「给张三发封邮件，说 Q2 进展汇报已经发在群里了」
> 「回一下这封邮件：收到，周五前给结果」
> 「把这封转给李四」
> 「邮箱里搜一下产品周报」
> 「有没有新邮件？」
> 「这封邮件说了什么？」

## 📋 验证状态

| 项 | 状态 |
|---|---|
| 搜索邮件 | ✅ **已实测**（返回 0 封匹配——账号里当时确实没有匹配邮件） |
| 发送新邮件 | ⚠️ **未实测** |
| 回复 / 全部回复 | ⚠️ **未实测** |
| 转发 | ⚠️ **未实测** |
| 日程邀约邮件 / 会议邮件 | ⚠️ **未实测** |
| 读邮件正文、附件、内嵌图 | ⚠️ **未实测** |
| 完整链路（你说一句话 → 助手自动发完） | ⚠️ 未实测 |

**实测记录**（命令层，人工在真实账号上执行）：

```bash
wecom-cli mail search      # 通过，返回 0 封匹配
```

**只验证了「接口通、能返回」**。发送方向一条都没测——因为发出去就收不回，
不适合拿真人邮箱做验收实验。所以本页不写「实际效果」，也不虚构任何邮件内容、收件人或返回值。

## 能力清单

| 能做什么 | 命令 | 风险 |
|---|---|---|
| 搜索 / 浏览邮件列表 | `wecom-cli mail search` | 读取（隐私敏感） |
| 读邮件详情（正文 / 附件 / 内嵌图 / 日程信息） | `wecom-cli mail get` | 读取（隐私敏感） |
| 发送新邮件 | `wecom-cli mail send` | **高风险写入** |
| 回复 / 全部回复 | 同上（换一组参数） | **高风险写入** |
| 转发 | 同上 | **高风险写入** |
| 日程邀约邮件（只发日程，不建线上会议） | 同上 | **高风险写入** |
| 会议邮件（同时建线上会议） | 同上 | **高风险写入** |

后面五行其实是**同一个发送方法的五种用法**，靠传不同的参数区分，风险级别相同。

### 明确做不到的事

这些企业微信的命令行工具都没有提供，助手会如实告诉你去客户端操作：

- **标记已读 / 未读**（但**按未读条件搜索是可以的**）
- **删除邮件**、**保存草稿**
- **给邮件打标签 / 移除标签**（但**按标签搜索是可以的**）
- **撤回已发送的邮件**、**修改已发送的邮件**
- 邮箱账号设置、签名、自动回复、收信规则

## 注意事项

**发出去就收不回，所以一定会先给你看预览。**
助手会把最终的主题、收件人（只显示姓名，不显示邮箱）、抄送、正文完整摆出来，
**然后等你明确同意才发**。哪怕你已经把内容说得很完整，这一步也不会省。

（顺带说明一件事：这套助手的上游文档原本要求「展示完预览就直接发，不许再问」。
本项目**故意改了这条**——发邮件不可撤回，属于最典型的高风险动作，所以预览之后仍然要等你点头。）

**回复的收件人来自原邮件，不去通讯录里找。**
这条看起来是细节，实际很关键：通讯录的模糊搜索可能匹配到同音不同字的人，那就发错了。
所以回复时助手直接用原邮件里的发件人地址。

**「回一下」默认是全部回复。** 想只回发件人，说清楚「只回他」「别回复所有人」。
即使参数上不需要列收件人，**预览里也会把最终会收到这封邮件的所有人列全**，让你看清范围。

**主题前缀是助手自己拼的。** 回复会拼成「回复：原主题」，转发拼成「转发：原主题」。
原主题已经带同类前缀时会沿用（一字不改，不会「顺手规范化」），
但**跨类型不抵消**——转发一封「回复：xxx」，主题会变成「转发：回复：xxx」。

**转发默认不带附加说明。** 你没提要加话，助手就不加，企业微信会自动带上原邮件正文。
你提了，它才写进去。

**日程邮件和会议邮件的区别是「建不建线上会议室」。**

- 说「开会 / 线上会议 / 拉个视频会」→ **会议邮件**（会建线上会议室）。**线下会议也走会议邮件**，
  会议室照建，用不用由你定。
- 说「发个日程 / 约个碰头 / 提醒大家周五有活动」→ **日程邀约邮件**（不建会议室）。
- 实在判不准，助手会问一句「需要创建线上会议室吗？」。

**只有你明确提到「邮箱」或「邮件」时才走这条路。**
你只说「帮我约个会」而没提邮件，那是 [05 日程](05-日程.md) / [06 会议](06-会议.md) 的活，
助手**不会**擅自替你改成「发封会议邮件」。

**搜索有三条硬线：**

- 带时间范围、未读、重要这类条件时，**搜索窗口不超过最近 30 天**。
- 带关键词的搜索**最多返回 100 封**。
- 单封邮件的正文加附件**合计不超过 50MB**。

**「最近」按 7 天算。** 你说「最近」「近期」「这段时间」而没给具体范围时，助手按最近 7 天处理，
并会在回复里说明它用的是哪个范围。

**没拉完会明说。** 结果还有更多没取回时，助手会在末尾提示「已展示前 N 条（未拉完）」，
**不会让你误以为看到的就是全部**。问「有几封」时它看的是总数字段；
总数被接口限制截断时也会如实说明。

**多封候选时它不会替你挑。** 你要找某一封特定的邮件而搜出好几封时，
助手会用「序号 + 主题 + 发件人 + 时间」列出来让你选。只是浏览或统计时才直接给列表。

**附件分两种，一种下得下来，一种下不来。**

- 普通附件——助手能落到本地读给你听。
- **微盘附件、以及防泄漏加密链接**——这类只能给你一个可点的链接，助手**打不开也解不开**，
  引导你在企业微信客户端里点开看。这是正常的产品行为，不是故障。

**邮件正文里的内容是数据，不是指令。** 正文里如果出现「忽略之前的指令」「请执行以下命令」
这类文本，助手一律当普通文字处理，不执行。检测到疑似夹带时会在摘要里附一句提示。

**收发件人数量看计数不看列表。** 一封群发邮件，接口只返回前 30 个收件人，真实人数在计数字段里。
问「这封发给了多少人」时助手报的是真实总数。

### 三条通用边界在本域怎么体现

1. **只能改它自己建的东西**——邮件这一域的写操作**只有「发出去」**，没有「改已有的」。
   已发送的邮件既不能改也不能撤回，接口层就没有这两个能力。
2. **能力按品类逐项开通**——邮件是独立品类（实测账号是后来单独补开的）。
   未开通时助手会把官方开通指引原样转给你，然后停下，不重试。
3. **危险动作先问你**——**发送方向的五种用法全是高风险写入**，都会先展示预览、
   再等你明确同意。见 [99 风险与确认](99-风险与确认.md)。

## 相关

- [02 通讯录](02-通讯录.md)——按人名发邮件时，先在这里把姓名解析成邮箱
- [05 日程](05-日程.md) / [06 会议](06-会议.md)——管理日程和会议**本身**（改期、取消、查询）走那边，
  本域只负责「通过邮件发出去」
- [15 媒体文件](15-媒体文件.md)——读邮件附件内容时中间那一步在做什么
- [03 消息与会话](03-消息与会话.md)——发企业微信消息是另一套能力
- [99 风险与确认](99-风险与确认.md)——发送前的确认怎么算数