---
title: 通讯录与转发到邮箱
nav: 通讯录
summary: Agent 替你记住发过邮件的人，能一次导入 Google、Outlook、苹果、QQ、163 导出的通讯录；说“发给张三”时按拼音和谐音也能找到人。回复和文件一点就能转发到邮箱，只发给你在弹窗里选的地址。通讯录只存在你的电脑上。
order: 31
---
# 通讯录与转发到邮箱

有了[邮件通道](/docs/email/)，Agent J 就能替你发邮件。这一页讲三件事：手机上的「转发到邮箱」、Agent 替你维护的通讯录，还有 Agent 能收发哪些文件。

## 转发到邮箱

回复卡片底部那排图标里（紧挨着转发到 Telegram）和每张文件卡片上，都有一个信封图标。点一下会弹出一个窗口：

- **发给我自己**（默认）：发到通讯录 0 号位你的主邮箱；没填时用「邮件通道」白名单里标成「我本人」的邮箱。
- **发给别人**：从通讯录里选，可以多选。一旦选了别人，「发给我自己」就自动取消。
  - 排序：**最近**（最近发过的在前）、**最常用**（发得最多的在前）、**A–Z**（按姓名拼音字母）。
  - 搜索框按名字、昵称、拼音（含声母、谐音）或邮箱查找。
  - 没找到就点「新增联系人」，填对方的邮箱和昵称，保存后自动选中。

转发一条回复时，发出去的是整段对话：上面是**你问**——你发的那条消息、从哪个遥控器发的、什么时间、引用了哪条；下面是 **Agent J 答**，表格、代码、列表都按原样排好，深色和浅色的邮件客户端里都看得清。邮件标题是 `[Agent J]` 加上你那条消息的前 40 个字。不想带上你的提问，就在弹窗里勾上「不带我的提问」，只发回复。回复里的文件作为附件一起发（单封合计 20 MB 以内），装不下的会在邮件里列出来，注明「文件太大未附上」；转发一个文件时只发这个文件。发完后，同一个弹窗会告诉你发到了哪些地址；没附上的文件逐个写明原因——实际大小和上限，或者里面有像密钥的内容（这种文件只在发给你自己时附上）。没发出去会写明原因，并给一个「重试」；十分钟内把同一条再发给同样的人，会先问你一句。邮件从你自己配置的邮箱发出，**只发给你在弹窗里选中的地址**。发出后，这些地址会记进通讯录，并记下发送次数和最近一次发送时间。

还没配置邮箱时，弹窗会带你去设置里的「邮件通道」，配好后再转发。

## 口述发邮件

你对 Agent 说“把这个文件发给张三”，它会：

1. 先在通讯录里找张三。语音转写常把字写错，所以它按拼音找：“张珊”能找到“张三”，“刘能”念成“niu neng”也能找到，“zs”能找到“张三”，姓氏多音字（单、曾、解……）也照顾到了。
2. 找到唯一一个人，就用他的邮箱；有好几个人同名，就问你是哪一个。
3. 找不到，就直接告诉你“通讯录里没找到叫张三的人”，并在手机上弹出一张**联系人卡片**：你说过的信息已经填好，补上邮箱（或手机号）点「保存」即可。
4. 发给你自己、或者收件人全在[邮件白名单](/docs/email/)里，就直接发，不弹卡片。只要有一个收件人不在白名单，发信前手机上就会弹出一张批准卡片，列出收件人、标题和附件；你在手机上长按确认了才发，Agent 不能绕过这一步。卡片上每个新收件人旁边有一个勾选框「以后发给 TA 不用再确认（加入白名单）」，默认不勾；勾上再确认，TA 就进了白名单，下次发给 TA 不再弹卡片。附件不管弹不弹卡片都要先过密钥检查，查出密钥就不发。

Agent 发过的地址会自动记进通讯录，并标明来源是 Agent。

### 带格式的邮件、抄送和报告

Agent 发的邮件默认是排好版的：正文按 Markdown 排成标题、列表、表格、代码块，用的是和「转发到邮箱」同一套样式，页脚写着「Powered by Agent J」；同时附一份纯文本版，不显示网页的邮件客户端也能读。

- **抄送、密送**：说“抄送王总”“密送财务”就行，写法和收件人一样，名字、昵称、拼音都能认。批准规则对每个收件人都算：抄送或密送里只要有一个人不在白名单，就会弹批准卡片；收件人、抄送、密送合计最多 10 个。密送的人别的收件人看不到。
- **网页报告直接当邮件正文**：网页报告、工作流生成的 HTML 报告，可以整页作为邮件正文发出。发出前会去掉脚本、表单和内嵌框架，样式写进每个元素里，Gmail、Outlook 里也能保持原样；报告里引用的本地图片带不进邮件，会换成图片说明，要看完整版就在邮件里附上报告链接。
- **定时任务发邮件**：让 Agent 每天、每周定时给谁发报告，收件人全是你自己或白名单里的人，到点直接发，不用每次批准；有白名单以外的人，每次照样要你在手机上确认，这一条不会放宽。
- 只想发纯文本，就跟 Agent 说“发纯文本”。

## 0 号位：你自己

通讯录的第一个位置永远是你本人：名字、主邮箱，手机号可以不填。以后你说「发给我自己」「发我邮箱」，网页报告、会议纪要、邮件都发到这个主邮箱。

- 第一次配好遥控器，Agent 跟你打完招呼后，手机上会弹出一张「你的联系方式」卡片。邮件通道里要是已经登记了你的邮箱，它会先帮你填上，你确认一下就行。也可以先跳过，之后在「设置」的「我的联系方式」里补。
- 0 号位只有你能改：在手机上点保存，或者在你自己的终端运行 `agentj contacts owner set`。Agent 改不了它，只能弹卡片请你确认。用 `agentj contacts owner show` 查看。
- 发给这里的邮件按「发给你自己」处理，邮箱、电话、链接、访问码都原样发出，详见[隐私](/docs/privacy/)。只有收件人全是你本人的邮箱时才算；多一个别人，整封邮件照常脱敏。API key、密码这类凭据不会出现在邮件里，会改成你手机上的密钥领取卡。

## 在手机上管理通讯录

在手机上打开「设置」，在「沟通渠道」里点「通讯录」，就能自己管理朋友的联系方式，不用每次都让 Agent 代劳：

- 最上面是搜索框，按名字、昵称、拼音或邮箱找人。
- 加号图标新增联系人；点某一行打开它，可以改名字、昵称、邮箱和手机号，也可以点「删除」（会再问你一次）。这里改的是第一个邮箱和第一个手机号，其余的保持原样。
- 导入图标：选手机或邮箱导出的 vCard、CSV 或 JSON 文件（最大 1 MB），导完告诉你新增、合并、跳过各几个。导出图标：把整本通讯录下载成一个 vCard 文件。
- 有邮箱的联系人右边有一个信封图标，点一下就把他的邮箱加进[邮件通道](/docs/email/)的白名单，身份是「访客」：他发来的邮件会交给 Agent，但不当作你的指令。已经在白名单里的，信封上带一个勾。
- 第一行是你自己（0 号位），点开就是「我的联系方式」卡片，这一行不能删；它的信封把你的邮箱加成「我本人」。

通讯录存在电脑上，手机只在打开这一页时读取。删掉一个联系人不会把他从邮件白名单里移除。

## 联系人卡片

Agent 想新建联系人，或者想给已有联系人补信息（比如你说“李总还有个手机号”）时，会在手机上弹出联系人卡片：

- 名字、昵称、邮箱、手机号、地址、公司、备注都能改；邮箱、手机号、地址都可以填多个。
- 补充已有联系人时，新加的内容会用绿色标出来。
- **至少有一个邮箱或手机号才能保存**；点「不保存」或按 Esc，什么都不会存。

## 通讯录

每个联系人包括：名字、昵称（可多个）、邮箱（可多个，带“工作 / 家庭”等标签）、手机号（可多个）、地址、公司、职位、生日、备注，以及最近发送时间和发送次数。字段与 vCard 4.0、Google 通讯录 CSV、Outlook CSV 对齐。

**导入：** 把导出的文件发给 Agent，让它“导入通讯录”；也可以在「设置」→「通讯录」里点导入图标自己选文件。支持：

| 来源 | 文件 |
|---|---|
| 苹果通讯录 / iCloud、安卓手机 | `.vcf`（vCard 2.1 / 3.0 / 4.0） |
| Google 通讯录 | `.csv`（新旧两种格式）或 `.vcf` |
| Outlook / Outlook.com | `.csv` |
| QQ 邮箱、163 邮箱、Foxmail、企业邮箱 | `.csv`（UTF-8 或 GBK 编码都行）或 `.vcf` |
| 其他 | `.json`（每项有 name、email、phone） |

Agent 会先试导一遍，告诉你新增几个、合并几个、跳过几个，再正式导入。**同一个邮箱或同一个手机号算同一个人**，导入时自动合并；两个同名的人邮箱不同，就保留成两个联系人。

**导出：** 让 Agent “导出通讯录”，它会生成 `.vcf`（vCard 3.0，手机和邮箱都能直接导入）或 `.csv`（Google 格式），以文件卡片发到手机上；在「设置」→「通讯录」里点导出图标，直接下载 `.vcf`。

命令行（一般不用你敲，Agent 会替你跑）：

```
agentj contacts find 张珊
agentj contacts list --sort recent|frequent|name
agentj contacts import 通讯录.csv --dry-run
agentj contacts export contacts.vcf
agentj contacts card --name 张三 --why '主人要给张三发邮件'
agentj mail send --to 张三 --subject '周报' --body-file - --attach 周报.pdf
agentj mail send --to-owner --cc 王总 --subject '日报' --body-file 日报.md
agentj mail send --to 张三 --subject '周会纪要' --body-file report/index.html
```

## 隐私

- 通讯录只存在你的电脑上（Agent J 的数据目录里，只有你本人能读），不上云，也不经过中继。
- 手机读通讯录走和聊天一样的端到端加密通道。
- 日志只记次数和结果，不记地址、名字和邮件内容。
- 查找用的是普通表格加拼音索引。我们评估过向量数据库：通讯录通常只有几百人，要查的是名字和读音，向量检索帮不上忙，还要多装模型，所以没有用。

## Agent 能收发哪些文件

**交给 Agent：** 手机上的「文件」按钮、Telegram 私聊、邮件附件，都能发任何文件。下面这些格式，Agent 能直接读懂、拿来干活：

| 类别 | 格式 |
|---|---|
| 图片 | jpg、png、webp、gif、heic、svg |
| 文档 | pdf、txt、md、docx、xlsx、pptx、doc、xls、ppt、odt、ods、odp、rtf、epub、html |
| 数据 | csv、tsv、json、jsonl、xml、yaml、toml |
| 联系人、日历、邮件 | vcf、ics、eml、mbox |
| 压缩包 | zip、gz、tgz、tar、7z |
| 音频、视频 | mp3、m4a、aac、ogg、opus、wav、mp4、mov、webm（发送时在电脑上转成文字） |

**Agent 给你：** 回复里的文件卡片，除了 heic，其他格式都能发。你可以下载、分享，或者转发到邮箱。文件只能从 Agent 自己的工作文件夹里取；文本类文件发出前会检查有没有密钥，有就不发。