全文搜索

MailAgent 把每封邮件的正文和附件里的文字（PDF / Word / PPT / Excel 都会被抽取出来，扫描件与图片经 OCR 也能搜到）一起建进全文索引。所以你搜的不只是主题和发件人——一份藏在 PDF 附件里的某个词，也能被搜到。中文同样支持。

怎么开始搜

最快的入口是命令面板：按 ⌘K，输入关键词回车即可；也可以直接打开 /search 页搜索。命中的邮件会列出来，正文里匹配到的片段会高亮显示。

简单搜索就这么直接：

redis timeout

这会找出正文 / 主题 / 发件人里同时包含”redis”和”timeout”的邮件（多个词默认是「都要满足」的关系）。

结果分组

⌘K 的结果按对象类型分组：邮件（命中片段 + 归属的事项编号，如果有）、事项（编号、状态、命中片段）、联系人（姓名、所在组织、主邮箱）、资料库（本机文件树里的命中文件）。哪个词该去哪个域搜，不需要你先想清楚——同一次输入会并行覆盖这几类对象。

Gmail 风格的字段过滤

需要更精确时，可以像 Gmail 那样用 字段:值 缩小范围：

写法	含义	例子
`from:`	发件人（地址或名字）	`from:alice`
`to:` / `cc:`	收件人 / 抄送	`to:bob`
`subject:`	主题包含	`subject:周报`
`mailbox:` / `in:`	限定邮箱	`in:收件箱`
`is:`	状态	`is:unread`、`is:flagged`、`is:read`
`has:attachment`	带附件	`has:attachment`
`attachment:`	附件内容或文件名含此词	`attachment:合同`
`filename:`	附件文件名含此词	`filename:roadmap`
`priority:`	AI 优先级	`priority:urgent`、`priority:重要`
`after:` / `before:`	日期范围	`after:2026-06-01`
`date:`	某一天	`date:2026-06-01`
`newer_than:` / `older_than:`	相对时间	`newer_than:7d`（近 7 天）

几点实用规则：

字段名不区分大小写（From: 等于 from:）。
值里有空格就加引号：from:"Zhang San"、subject:"weekly report"。
多个条件并排写就是「都要满足」：from:alice subject:周报 is:unread。
mailbox: 支持英文别名：inbox→收件箱、sent→发件箱、archive→存档、drafts→草稿箱。
has:attachment（只看有没有附件）与 attachment:（看附件里有没有这个词）是两回事，可以一起用：from:bob attachment:合同。

否定与「或者」

在字段或词前加 - 表示排除：-from:noreply、-报告、-is:read。
用大写的 OR（必须大写）表示「或者」：from:alice OR from:bob。

组合起来用

from:alice subject:周报 is:unread after:2026-06-01 has:attachment -from:noreply 产品评审

意思是：6 月 1 日之后、未读、带附件、发件人含 alice 但不含 noreply、主题含「周报」、且全文相关「产品评审」的邮件。

更多例子：

查询	它在找什么
`from:alice 报告`	alice 发来的、全文含「报告」
`subject:"weekly report" -from:noreply`	主题含该短语、发件人不含 noreply
`产品评审 has:attachment newer_than:7d`	近 7 天带附件、相关「产品评审」
`in:收件箱 is:flagged priority:urgent`	收件箱里标了旗、AI 判定紧急的
`filename:v2 is:unread`	未读且附件文件名含”v2”
`redis OR timeout -is:read`	全文含 redis 或 timeout，且未读

中文搜索

中文邮件可以直接搜中文词，命中后同样会高亮，包括不完整的中文子串。英文同样支持模糊子串（比如 firmwar 能命中 “firmware”）。日期用本地时区理解——after:2026-06-01 指你所在时区的 6 月 1 日 0 点起，before:2026-06-01 会包含当天全天。

AI 智能搜索

有时你不知道该用哪个关键词，只记得大概想找什么——这时可以让 AI 替你搜。在 ⌘K 里直接输入一句自然语言（比如「上周 Alice 发来的那封关于产品评审的邮件」），命令面板顶部会出现一行「AI 理解」，回车即可。

AI 会把你的话翻译成精确的搜索条件，必要时多轮缩小或放宽范围，最后把真正相关的邮件挑出来。它只会从真实命中的邮件里选，不会编造不存在的邮件。

人工搜索和 AI 搜索底层用的是同一套搜索引擎——所以同一个问题，无论你手敲条件还是交给 AI，命中的邮件都是一致的。

更顺手的小功能

未读 / 有附件快捷过滤：在 ⌘K 里输入关键词后，下方会出现「未读」「有附件」小标签，点一下就把对应条件加进查询。
最近搜索：刚打开 ⌘K（还没输入时）会列出你最近搜过的词，点一下直接重搜。
收藏搜索：常用的复杂查询可以「收藏此搜索」，下次从收藏列表一键调出。

接下来

想就搜到的邮件继续追问、让 AI 跨邮件帮你梳理？看 AI Chat 面板。
命令面板还能切邮箱、跳路由，配合快捷键见邮件。

深入了解（含完整 DSL 语法、日期归一、跨语言契约）：搜索查询语法规格