文档Docs

通讯录与转发到邮箱Contacts and forwarding by e-mail

Agent 替你记住发过邮件的人，能一次导入 Google、Outlook、苹果、QQ、163 导出的通讯录；说“发给张三”时按拼音和谐音也能找到人。回复和文件一点就能转发到邮箱，只发给你在弹窗里选的地址。通讯录只存在你的电脑上。The Agent remembers everyone it mailed for you and imports Google, Outlook, Apple, QQ and 163 contact exports in one go. Say “send it to Zhang San” and it finds the person by pinyin and sound-alikes. Forward any reply or file to e-mail in one tap, only to the addresses you pick. The address book stays on your computer.

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

转发到邮箱

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

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

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

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

口述发邮件

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

先在通讯录里找张三。语音转写常把字写错，所以它按拼音找：“张珊”能找到“张三”，“刘能”念成“niu neng”也能找到，“zs”能找到“张三”，姓氏多音字（单、曾、解……）也照顾到了。
找到唯一一个人，就用他的邮箱；有好几个人同名，就问你是哪一个。
找不到，就直接告诉你“通讯录里没找到叫张三的人”，并在手机上弹出一张联系人卡片：你说过的信息已经填好，补上邮箱（或手机号）点「保存」即可。
发给你自己、或者收件人全在邮件白名单里，就直接发，不弹卡片。只要有一个收件人不在白名单，发信前手机上就会弹出一张批准卡片，列出收件人、标题和附件；你在手机上长按确认了才发，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 查看。
发给这里的邮件按「发给你自己」处理，邮箱、电话、链接、访问码都原样发出，详见隐私。只有收件人全是你本人的邮箱时才算；多一个别人，整封邮件照常脱敏。API key、密码这类凭据不会出现在邮件里，会改成你手机上的密钥领取卡。

在手机上管理通讯录

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

最上面是搜索框，按名字、昵称、拼音或邮箱找人。
加号图标新增联系人；点某一行打开它，可以改名字、昵称、邮箱和手机号，也可以点「删除」（会再问你一次）。这里改的是第一个邮箱和第一个手机号，其余的保持原样。
导入图标：选手机或邮箱导出的 vCard、CSV 或 JSON 文件（最大 1 MB），导完告诉你新增、合并、跳过各几个。导出图标：把整本通讯录下载成一个 vCard 文件。
有邮箱的联系人右边有一个信封图标，点一下就把他的邮箱加进邮件通道的白名单，身份是「访客」：他发来的邮件会交给 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 自己的工作文件夹里取；文本类文件发出前会检查有没有密钥，有就不发。

With the e-mail channel set up, Agent J can send mail for you. This page covers the phone's "Forward by e-mail" button, the address book the Agent keeps for you, and which files the Agent can take and give.

Forward by e-mail

The row of icons at the bottom of a reply card (right after Forward to Telegram) and every file card have an envelope icon. Tap it and a dialog opens:

To me (the default): the main e-mail in slot 0 of your address book; until you fill that in, the address marked as yourself in Settings → E-mail channel.
To someone else: pick one or more people from your contacts. Picking someone unticks "To me".
- Sort by Recent (last sent first), Most used (most mails first) or A–Z (Chinese names by pinyin).
- Search by name, nickname, pinyin (initials and sound-alikes included) or address.
- Not there? Tap New contact, enter their address and a nickname; they are saved and selected.

Forwarding a reply sends the whole exchange: on top You asked — your message, the remote you sent it from, when, and what it quoted — and below Agent J answered, with tables, code and lists laid out as on the phone, readable in light and dark mail apps. The subject is "[Agent J] " and the first 40 characters of your message. Tick Leave out my message to send the reply alone. The reply's files go along as attachments (20 MB per mail at most); the ones that do not fit are listed in the mail as "Too big, not attached". Forwarding a file sends just that file. When it is done, the same dialog says where it went (each address) and, for every file left out, why — its size against the limit, or that it looks like it holds a key (such a file goes only to your own address). If sending failed you see the reason and Retry; sending the same thing to the same people again within ten minutes asks first. The mail goes out from your own mailbox, only to the addresses ticked in the dialog. Every address is then remembered in your contacts with how often and how recently you mailed it.

With no mailbox set up yet, the dialog takes you to Settings → E-mail channel.

“Send this to Zhang San”

When you ask the Agent to mail someone, it:

Looks them up. Voice transcripts often get Chinese characters wrong, so it matches by sound: 张珊 finds 张三, “niu neng” finds 刘能, “zs” finds 张三, and surnames with special readings (单, 曾, 解 …) are handled. Latin names tolerate a typo (Jon → John).
Uses the one clear match; with several people of the same name, it asks which one.
Finds nobody? It tells you plainly (“No one called Zhang San in your contacts”) and puts a contact card on your phone with what you already said filled in. Add the address (or phone) and tap Save.
Mail to yourself, or to people who are all on the e-mail allowlist, goes straight out — no card. With anyone else among the recipients, an approval card on the phone lists recipients, subject and attachments, and nothing goes out until you hold to approve — the Agent cannot skip this. Each new recipient on the card has an unticked box “Don't ask again for mail to them (add to the allowlist)”; tick it and approve, and next time mail to them goes without a card. Attachments are checked for keys either way; a key in a file stops the mail.

Addresses the Agent mailed are remembered automatically, marked as added by the Agent.

Formatted mail, Cc and reports

Mail from the Agent is formatted by default: the body's Markdown becomes headings, lists, tables and code blocks in the same style as “Forward by e-mail”, with “Powered by Agent J” at the foot, plus a plain-text copy for mail apps that do not show HTML.

Cc and Bcc: say “cc Mr Wang” or “bcc finance” — written like recipients, by name, nickname or pinyin. The approval rule counts every recipient: one person on Cc or Bcc who is not on the allowlist brings the approval card; To, Cc and Bcc together take 10 addresses at most. Bcc recipients are hidden from the others.
A web report as the mail itself: a web page report, or an HTML report a workflow made, can go as the whole mail body. Scripts, forms and embedded frames are taken out first and the styles are written into every element, so Gmail and Outlook keep the look; local images the report points to cannot travel in a mail and become their captions — add the report's link for the full version.
Scheduled mail: when a scheduled task mails a daily or weekly report to you or to allowlisted people only, it goes at the set time without asking each time; anyone off the allowlist still needs your OK on the phone every time — that never loosens.
Want plain text only? Tell the Agent “send it as plain text”.

Slot 0: you

The first place in the address book is always you: your name, your main e-mail and, if you like, your phone number. Whenever you say "send it to me" — a web report, meeting minutes, a mail — it goes to that main e-mail.

After your first remote is paired and the Agent has said hello, a "Your contact details" card rises on the phone. If the e-mail channel already lists your address, it is filled in for you to confirm. You can skip it and add it later in Settings → My contact details.
Only you change slot 0: tap Save on the phone, or run agentj contacts owner set in your own terminal. The Agent cannot write it; it can only put the card in front of you. agentj contacts owner show shows it.
Mail to that address counts as mail to yourself: e-mail addresses, phone numbers, links and access codes go as written (see Privacy). It counts only when every recipient is you; one other recipient and the whole mail is redacted as usual. Credentials such as API keys and passwords never ride in the mail: they come as a secret pickup card on your phone.

Manage the address book on the phone

Open Settings and tap "Contacts" under Channels to look after your friends' details yourself, without asking the Agent:

The search box at the top finds people by name, nickname, pinyin or address.
The plus icon adds a contact; tap a row to open it and change the name, nicknames, e-mail and phone, or tap "Delete" (you are asked once more). The dialog edits the first e-mail and the first phone; any others stay as they are.
The import icon takes a vCard, CSV or JSON file exported from a phone or a mail service (1 MB at most) and tells you how many were added, merged and skipped. The export icon downloads the whole address book as one vCard file.
A contact with an e-mail has an envelope icon on the right: one tap puts that address on the e-mail channel's allowlist as a guest — their mail reaches the Agent but never counts as your instruction. An address already on the list shows a tick on its envelope.
The first row is you (slot 0): it opens "My contact details" and cannot be deleted; its envelope adds your address as yourself (Me).

The address book stays on the computer; the phone only reads it while this page is open. Deleting a contact does not take the address off the e-mail allowlist.

The contact card

When the Agent wants to save a new contact or complete one (“Mr Li has a second mobile”), the phone shows a contact card:

Name, nicknames, e-mails, phones, addresses, company and note are all editable; e-mails, phones and addresses can repeat.
When completing a contact, what the Agent added is marked in green.
Saving needs at least one e-mail or phone. "Don't save" or Esc saves nothing.

The address book

Each contact holds a name, nicknames, e-mails (with labels such as work / home), phones, addresses, company, title, birthday and a note, plus when you last mailed them and how often. The fields follow vCard 4.0 and the Google and Outlook CSV exports.

Import: send the Agent an export and ask it to import your contacts, or tap the import icon in Settings → Contacts and pick the file yourself:

From	File
Apple Contacts / iCloud, Android	`.vcf` (vCard 2.1 / 3.0 / 4.0)
Google Contacts	`.csv` (old and new layout) or `.vcf`
Outlook / Outlook.com	`.csv`
QQ Mail, 163, Foxmail, business mail	`.csv` (UTF-8 or GBK) or `.vcf`
Anything else	`.json` (items with name, email, phone)

The Agent does a dry run first and tells you how many are new, merged and skipped. The same e-mail or phone number is the same person and is merged; two people with the same name and different addresses stay two contacts.

Export: ask the Agent to export your contacts. You get a .vcf (vCard 3.0, which every phone and mail app imports) or a .csv (Google layout) as a file card on the phone. The export icon in Settings → Contacts downloads the .vcf directly.

Commands (the Agent runs them for you):

agentj contacts find 张珊
agentj contacts list --sort recent|frequent|name
agentj contacts import contacts.csv --dry-run
agentj contacts export contacts.vcf
agentj contacts card --name 'Zhang San' --why 'owner wants to mail Zhang San'
agentj mail send --to 'Zhang San' --subject 'Weekly report' --body-file - --attach report.pdf
agentj mail send --to-owner --cc 'Wang' --subject 'Daily report' --body-file daily.md
agentj mail send --to 'Zhang San' --subject 'Meeting notes' --body-file report/index.html

Privacy

The address book lives only on your computer (in Agent J's data folder, readable by you alone): never in the cloud, never through the relay.
The phone reads it over the same end-to-end encrypted channel as your chat.
Logs record counts and results, never an address, a name or a mail's content.
Search uses a plain table with a pinyin index. We looked at a vector database: an address book holds a few hundred names and the question is how a name sounds, which embeddings do not capture — so no extra model is installed.

Files the Agent can take and give

To the Agent: the phone's File button, Telegram private chat and e-mail attachments take any file. The Agent reads and works with these formats directly:

Kind	Formats
Images	jpg, png, webp, gif, heic, svg
Documents	pdf, txt, md, docx, xlsx, pptx, doc, xls, ppt, odt, ods, odp, rtf, epub, html
Data	csv, tsv, json, jsonl, xml, yaml, toml
Contacts, calendars, mail	vcf, ics, eml, mbox
Archives	zip, gz, tgz, tar, 7z
Audio and video	mp3, m4a, aac, ogg, opus, wav, mp4, mov, webm (transcribed on your computer when sent)

From the Agent: file cards in a reply support every format above except heic; you can download, share or forward them by e-mail. They come only from the Agent's own working folder, and text files are checked for keys first — a file with one is not sent.

这一页的 Markdown 原文This page as Markdown: zh.md · en.md