文档Docs
Agent J 官方通知Official notices from Agent J
新版本、安全修复、技能推荐和账号消息，我们签名后发到你的电脑；你的 Agent 先核对签名，再按类型处理。这一页还讲「空闲时自动更新」和升级邮件怎么设。New versions, security fixes, skill suggestions and account news reach your computer signed by us; your Agent checks the signature, then acts by kind. Also: "Update automatically when idle" and the upgrade email.
有新版本、紧急安全修复、可能用得上的技能，或者跟你账号有关的消息时，我们会给你的电脑发一条官方通知。手机的对话里会多出单独的一页，开头标着 Agent J 官方；你的 Agent 也会收到，并按通知的类型去处理。
通知只发给已经加入 Agent J 账号的电脑。
有哪几种通知
| 类型 | 你的 Agent 怎么处理 |
|---|---|
| 新版本 | 看「空闲时自动更新」：开着就等电脑空闲时升级，再告诉你改了什么；关了就先问你 |
| 安全修复 | 马上升级，再告诉你原因。不管「空闲时自动更新」开没开 |
| 技能推荐 | 跟你这台电脑做的事有关时（内容创作、App 开发、电商或通用），问你要不要装；无关的不打扰你。不会自己装 |
| 账单 | 只转告你。不会因为一条通知去付款或改订阅 |
| 公告 | 只转告你 |
| 客服回复 | 转告你客服在会话里的新回复，见 找客服 |
升级的时候，Agent 只跑一条命令：agentj update apply --version <版本>。版本核对、重启、自检都照常进行。结果以这条命令的输出为准，升级没成功它不会说成功了。
升级没成功时，Agent 会用一句话告诉你哪一步失败了、电脑是不是还在用原来的版本。它还会自己把失败步骤、原因和安装命令最后几行发给 Agent J 客服，名字、路径和密钥会先在你电脑上去掉，你不用再描述一遍。不想自动发，就让 Agent 关掉 updates.report_failures。账户页会显示每台电脑最近一次升级的结果，失败的会标出来。
你的 Agent 怎么核对通知是真的
- 每条通知都有我们的签名。核对用的公开钥匙写死在你电脑上的
agentj程序里，不从网络或配置里读，换不掉。签名对不上，这条通知就当没收到。 - 通知跟着你电脑平时向账号后台的状态上报一起送达。电脑还会核对：这份通知列表是发给这台电脑的、对得上这一次上报的编号、时间相差不超过 5 分钟。
- 每条通知都有有效期，最长 30 天。过期的不处理；我们撤回的通知，你的电脑下次上报后就不会再交给 Agent。已经交给 Agent 的，撤回不了。
- 同一条通知只处理一次，内容一经签名就不会被替换。
- 通知的标题和正文只当资料看，不当命令。里面写的链接、命令和要求，Agent 一概不照做；该做什么，由你电脑上的规则按通知类型决定（就是上面那张表）。
空闲时自动更新：开，还是关
在手机右上角齿轮的「设置」→「网页版 App」里，「空闲时自动更新」是一个开关：
- 开（默认）：有新版本时，等电脑闲下来再升级——没有在跑的任务、没有待处理的卡片、30 分钟没用手机，夜里 3–5 点优先；收到新版本通知也直接升级，升完告诉你改了什么；
- 关：有新版本只告诉你改了什么，什么时候升由你决定（可以点「升级电脑上的 Agent J」，它会先列出会被打断的事再让你确认）。
这个开关一次改两个设置：updates.auto_install（电脑空闲时自己装）和 updates.mode（收到新版本通知时直接升还是先问你）。在电脑上分别用 agentj config auto-update on|off 和下面的命令。
设置里写着：「紧急安全修复会立即升级，并告诉你原因。」这是故意的：安全修复不等你回复。
在电脑上也能改：
agentj config set updates.mode ask
agentj config set updates.mode askagentj config set updates.mode auto
agentj config set updates.mode auto手机上看到的样子
- 每条通知在对话里单独占一页。
- 只有当这一页真的显示在已配对的手机上，手机才会告诉我们这条已读。电脑收到、Agent 已处理，和你已读，是分开记录的。
- 锁屏提醒里不放通知正文：安全修复显示「Agent J 有紧急安全更新」，其他紧急通知显示「有一个请求等你批准」，普通通知显示「有新回复」。
我们看得到什么，看不到什么
为了发通知，我们能看到每台电脑的这些信息：账号 ID、电脑的编号、Agent J 的版本、用的是哪个 AI 编程工具、在不在线、配了几部手机、几部在线。每条通知送到了哪些电脑、什么时候送到、什么时候在手机上读过，我们也看得到。
我们看不到：你的对话、你的邮箱、电脑和手机的名字。技能推荐跟你有没有关系，是在你的电脑上判断的，不会为此把你的情况发给我们。
升级邮件：转给你的 Agent J，它自己升级
有新版本时，我们每天早上 9 点（日本时间）最多发一封升级邮件。一封邮件把上次以来的更新合在一起，只写最新的版本号，按新功能、改进、修复的问题分好类，用你账号设置的语言。
邮件里有个升级授权码，代表你同意这次升级：
- 只能用来升级到邮件里写的那个版本；
- 14 天内有效；
- 这个账号下的每台电脑各能用一次。
把整封邮件转给 Agent J，比如直接贴进手机对话里。它会核对版本，然后运行下面任意一条：
agentj update apply --from-email -
agentj update apply --from-email -agentj update apply --authorization <授权码> --version <版本>
agentj update apply --authorization <授权码> --version <版本>接着重启、自检，把结果告诉你，中间不用你再确认。你电脑上的 Agent J 如果还是 0.14 或更早的版本，这两种写法它还不认识：请在电脑上打开当初安装 Agent J 的那个 AI 编程工具，把邮件原样贴给它。
没有邮件也一样能升级：跟你的 Agent J 说一声要升级，它会自己运行 agentj update apply，装好、重启、自检，再告诉你结果。
想少收或者不收：在 账号后台 的「设置」里，「升级邮件」可以选「每次升级都发」「只发大版本」或「不发」。每封邮件底部也有退订链接，点一下就能改。
When there is a new version, an urgent security fix, a skill you might want, or news about your account, we send your computer an official notice. It shows up in the phone conversation as a page of its own, marked Agent J official, and your Agent gets it too and handles it according to its kind.
Notices only go to computers that have joined an Agent J account.
The kinds of notice
| Kind | What your Agent does |
|---|---|
| New version | follows "Update automatically when idle": on, it upgrades once the computer is idle and then tells you; off, it asks you first |
| Security fix | upgrades right away and then tells you why, whether "Update automatically when idle" is on or off |
| Skill suggestion | if it fits what this computer is used for (content, app development, e-commerce or general), asks whether you want it; otherwise it stays quiet. It never installs on its own |
| Billing | passes it on to you; a notice never makes it pay for or change anything |
| Announcement | passes it on to you |
| Support reply | passes on a new answer in your support conversation — see Support |
To upgrade, the Agent runs exactly one command, agentj update apply --version <version>, which still does all its usual checks, the restart and the self-check. What that command reports is what counts: the Agent never claims an upgrade that didn't work.
If an upgrade doesn't go through, the Agent tells you in one sentence what failed and whether your computer is still on the old version. By itself it also sends the failed step, the reason and the installer's last lines to Agent J support — names, paths and keys are removed on your computer first — so you don't have to describe anything. Don't want that? Ask your Agent to turn off updates.report_failures. Your account page shows each computer's last upgrade, and marks the ones that failed.
How your Agent knows a notice is real
- Every notice is signed by us. The public key that checks it is built into the
agentjprogram on your computer; it isn't read from the network or from settings, so it can't be swapped. A notice whose signature doesn't match is treated as if it never arrived. - Notices travel with the status report your computer already sends to the account dashboard. The computer also checks that the notice list was made for this computer, for this very report, and within 5 minutes of now.
- Every notice has an expiry date, at most 30 days out. Expired notices are ignored. If we withdraw a notice, your computer stops passing it to the Agent after its next report; one the Agent already has can't be taken back.
- Each notice is handled once, and its signed content can never be replaced.
- The title and text of a notice are information, not orders. The Agent doesn't follow links, commands or requests written in them; what it does is decided by the rules on your computer, by kind (the table above).
Update automatically when idle: on or off
In "Settings" (the gear at the top right) → "Web app", "Update automatically when idle" is one switch:
- On (the default): a new version installs once the computer is idle — nothing running, no cards waiting, phone unused for 30 minutes — preferably between 3 and 5 at night; an announced new version is applied too, and you're told what changed;
- Off: you're told what changed and decide when to upgrade ("Upgrade Agent J on the computer" lists what would be interrupted and asks first).
The switch sets two settings at once: updates.auto_install (install by itself when idle) and updates.mode (apply an announced version, or ask first). On the computer use agentj config auto-update on|off and the commands below.
Underneath it says "Urgent security fixes upgrade immediately, then explain why." That's deliberate: a security fix doesn't wait for your reply.
You can change it on the computer too:
agentj config set updates.mode ask
agentj config set updates.mode askagentj config set updates.mode auto
agentj config set updates.mode autoWhat you see on the phone
- Each notice gets a page of its own in the conversation.
- The phone tells us a notice was read only when that page is actually on the screen of a paired phone. Arriving on the computer, being handled by the Agent and being read by you are recorded separately.
- A lock-screen alert never carries the notice's text: a security fix shows "Agent J has an urgent security update", other urgent notices show "A request is waiting for your approval", and ordinary ones show "New reply".
What we can and can't see
To send notices we see, for each computer: the account ID, the computer's ID, its Agent J version, which AI coding tool it uses, whether it's online, and how many phones are paired and online. For each notice we also see which computers got it, when, and when it was read on a phone.
We don't see your conversations, your email address, or the names of your computers and phones. Whether a skill suggestion fits you is decided on your computer, and nothing about you is sent to us for it.
The upgrade email: forward it to your Agent J
When there's a new version, we send at most one upgrade email a day, at 9:00 in the morning Japan time. One email covers everything since the last one, names only the newest version, groups the changes into new features, improvements and fixes, and is written in your account's language.
It contains an upgrade authorization code, which stands for your agreement to this upgrade:
- it only works for the version named in the email;
- it's valid for 14 days;
- each computer in the account can use it once.
Forward the whole email to your Agent J — pasting it into the phone conversation is enough. It checks the version and then runs one of these:
agentj update apply --from-email -
agentj update apply --from-email -agentj update apply --authorization <code> --version <version>
agentj update apply --authorization <code> --version <version>Then it restarts, runs its self-check and tells you how it went, without asking you to confirm again. If the Agent J on your computer is still on 0.14 or older, it doesn't know these options yet: open the AI coding tool you originally installed Agent J with, on the computer, and paste the email to it as it is.
Without an email it works too: tell your Agent J to upgrade, and it runs agentj update apply itself, installs, restarts, checks itself and tells you the result.
To get fewer emails or none: in "Settings" in the account dashboard, "Upgrade emails" can be set to "For every upgrade", "Major versions only" or "Never". Every email also has an unsubscribe link at the bottom that changes it in one click.