文档Docs

iMessage 助手——Mac 上的短信，重要的推到手机iMessage assistant — your Mac's texts, the important ones on your phone

只在 Mac 上有。Agent J 定时只读这台 Mac 收到的 iMessage 和短信，验证码、快递、银行、行程、家人的消息推到手机，垃圾和骗人的短信挡掉。默认关，打开要在电脑上授权一次。Mac only. Agent J reads new iMessages and texts on your Mac (read-only) and sends codes, deliveries, bank, travel and family messages to your phone, holding back spam and scams. Off by default; one permission step on the computer.

很多人的 iPhone 短信会同步到 Mac。人不在电脑前的时候，验证码、快递、银行提醒、家人的消息都躺在 Mac 上没人看。 iMessage 助手让你电脑上的 Agent J 定时看一眼这些新消息：重要的马上推到你配对的手机，其余的攒成摘要，垃圾和骗人的短信直接挡掉。

它只读。不回复、不代发、不标已读，也不动“信息” App 里的任何东西。

只在 Mac 上有

这个开关只在电脑是 Mac 的时候出现在手机的设置 → Agent 的功能 → iMessage 助手。Linux 和 Windows 上没有“信息”数据库，所以不显示。它默认是关的。

第一次打开：在电脑上授权一次

读短信需要 macOS 的「完全磁盘访问权限」。macOS 不会自己弹窗问你，要在电脑上手动打开一次：

在手机上打开开关，状态会显示「待授权」。
点「在电脑上打开授权页」，电脑上会打开系统设置 → 隐私与安全性 → 完全磁盘访问权限，并在访达里选中要加的程序（手机上写着程序名）。
在电脑上把这个程序加进列表，打开它旁边的开关。
回到手机点「重新检测」，状态变成「运行中」就好了。

打开以后，以前的短信不会推给你，只看打开以后的新消息。要补看，可以让 Agent J 运行 agentj imessage backfill --hours 24（最多 72 小时），它会发你一份摘要。

想让 Mac 也收到普通短信（不只是 iMessage），在 iPhone 上打开设置 → 信息 → 短信转发，勾选这台 Mac。

它会提醒什么

马上推：验证码、重要联系人、银行与安全提醒、行程预约变更、熟人发来的消息。
进摘要：快递、账单、群聊和其他拿不准的消息，按你选的时间（默认每天 09:00 和 18:00）合成一条发给你。
挡掉：营销、贷款、中奖、钓鱼链接，以及想指挥 AI 做事的短信（比如要它忽略之前的指令、把验证码发出去）。挡掉的条数会写在摘要里。

每条提醒都写着类别、发件人（不在通讯录里的号码会打码）、时间和判断依据。验证码默认显示，30 分钟后从记录里隐去；也可以选「打码，只显示来源」或「不提醒验证码」。

在手机上能改的

设置 → iMessage 助手里可以直接改：多久看一次（1 分钟到 1 小时）、提醒方式（重要的马上推 / 全部马上推 / 只要摘要）、摘要时间、免打扰时段、过滤强度、验证码怎么显示、包含不包含群聊、要不要用智能分类。

智能分类默认关：只用电脑上的规则，短信正文不出这台电脑。打开后，只有规则拿不准的短信，去掉号码、邮箱和链接后交给 Jev 判断要不要提醒；验证码永远不会交给任何模型。

让 Agent J 帮你改的

过滤与提醒规则、重要联系人和静音名单在手机上只能看。要改，点「让 Agent J 帮我改」，在聊天里说一句话就行，比如：

家人的消息都要马上提醒，快递短信只进摘要
把 +1 555 010 0001 设成重要联系人
这个号码以后别提醒了
晚上 11 点到早上 7 点别打扰我

Agent J 会用 agentj imessage … 命令帮你改好，再告诉你改了什么。重要联系人只按你给的号码或邮箱精确匹配，从不按名字猜。

电脑上的命令

agentj imessage status                     # 开关、状态、今天的计数（不含短信内容）
agentj imessage on | off
agentj imessage set interval_minutes 15    # 也可以 agentj config set imessage.interval_minutes 15
agentj imessage instructions show | set "…" | reset
agentj imessage vip add +15550100001
agentj imessage mute add 团购
agentj imessage doctor                     # 重新检测权限

手机和命令改的是同一份设置，经过同一个校验，改了马上生效。

隐私与安全

只读：用只读方式打开“信息”数据库，从不写入，也不复制；没有任何发消息的功能。
正文默认不出本机：提醒和摘要只经过加密通道发到你配对的手机。电脑上只记录消息编号、类别和计数，不存短信正文；日志在 ~/Library/Logs/AgentJ/imessage.log，也不写正文。
短信是不可信的内容：短信不会交给你的 Agent 当指令，想指挥 AI 的短信会被当成垃圾挡掉。
不会漏：按消息编号往后读，Mac 睡眠或重启后会把错过的补上；正文在新版 macOS 里藏在另一个字段，Agent J 也能读出来。
关掉即清：关掉开关会清除读到哪里的记录和待发摘要。要彻底收回权限，去系统设置 → 完全磁盘访问权限把那个程序关掉。

Many iPhones sync their messages to a Mac. When you are away from the computer, codes, deliveries, bank alerts and family messages sit there unread. The iMessage assistant lets Agent J on your computer look at new messages on a schedule: important ones go straight to your paired phone, the rest wait for a digest, spam and scams are held back.

It only reads. It never replies, never sends anything for you, never marks anything as read and never changes anything in the Messages app.

Mac only

The switch appears under Settings → Agent features → iMessage assistant on the phone only when the computer is a Mac. Linux and Windows have no Messages database, so the item is not shown. It is off by default.

First time: one permission step on the computer

Reading messages needs macOS Full Disk Access. macOS never asks by itself; you switch it on once:

Turn the switch on on your phone. The status says "Needs permission".
Tap "Open on the computer": System Settings → Privacy & Security → Full Disk Access opens on the Mac, and Finder shows the program to add (its name is on the phone).
On the computer, add that program to the list and switch it on.
Back on the phone, tap "Check again". "Running" means you are done.

After it is on, old messages are not sent to you — only new ones. To catch up, ask Agent J to run agentj imessage backfill --hours 24 (up to 72 hours); you get one digest.

To get ordinary texts on the Mac too (not only iMessages), on the iPhone open Settings → Messages → Text Message Forwarding and tick this Mac.

What it alerts

At once: verification codes, VIP contacts, bank and security notices, travel and booking changes, people you know.
In the digest: deliveries, bills, group chats and anything unclear, sent together at your digest times (default 09:00 and 18:00).
Held back: marketing, loans, prizes, phishing links, and texts that try to give an AI instructions (asking it to ignore previous instructions and send the code out). The digest says how many were held back.

Every alert names the category, the sender (numbers not in your contacts are masked), the time and why it was sent. Codes are shown and hidden from the history after 30 minutes; you can also choose "Masked: sender only" or "Don't alert codes".

What you change on the phone

Under Settings → iMessage assistant: how often to look (every minute to every hour), delivery (important at once / everything at once / digest only), digest times, quiet hours, filter strength, how codes are shown, group chats, and smart sorting.

Smart sorting is off by default: only the rules on your computer are used and message text never leaves it. When on, only messages the rules can't decide go to Jev, without numbers, e-mails or links; codes never go to any model.

What Agent J changes for you

Your rules, VIP contacts and the muted list are read-only on the phone. Tap "Ask Agent J to change it" and say it in one sentence in the chat, for example:

Alert every message from my family at once; deliveries can wait for the digest
Make +1 555 010 0001 a VIP
Never alert this number again
Don't disturb me from 11 pm to 7 am

Agent J makes the change with agentj imessage … and tells you what changed. VIPs are matched only by the exact number or e-mail you give, never guessed from a name.

Commands on the computer

agentj imessage status                     # switch, status, today's counts (no message text)
agentj imessage on | off
agentj imessage set interval_minutes 15    # same as agentj config set imessage.interval_minutes 15
agentj imessage instructions show | set "…" | reset
agentj imessage vip add +15550100001
agentj imessage mute add coupon
agentj imessage doctor                     # check the permission again

The phone and the commands change the same settings, through the same validator, effective at once.

Privacy and safety

Read-only: the Messages database is opened read-only, never written, never copied; there is no way to send.
Text stays on your computer by default: alerts and digests travel only through the encrypted channel to your paired phone. The computer keeps message numbers, categories and counts, never message text; the log (~/Library/Logs/AgentJ/imessage.log) has no text either.
Texts are untrusted: a text never reaches your Agent as an instruction; texts that try to instruct an AI are held back as spam.
Nothing missed: it reads on by message number, so after the Mac sleeps or restarts it catches up; on newer macOS the text sits in a second field, and Agent J reads that too.
Off means forgotten: turning it off clears where it was and the waiting digest. To take the permission back, switch the program off under System Settings → Full Disk Access.

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