---
title: Agent J 官方通知
nav: 官方通知
summary: 新版本、安全修复、技能推荐和账号消息，我们签名后发到你的电脑；你的 Agent 先核对签名，再按类型处理。这一页还讲「空闲时自动更新」和升级邮件怎么设。
order: 11
---

# Agent J 官方通知

有新版本、紧急安全修复、可能用得上的技能，或者跟你账号有关的消息时，我们会给你的电脑发一条官方通知。手机的对话里会多出单独的一页，开头标着 Agent J 官方；你的 Agent 也会收到，并按通知的类型去处理。

通知只发给已经加入 Agent J 账号的电脑。

## 有哪几种通知

| 类型 | 你的 Agent 怎么处理 |
|---|---|
| 新版本 | 看「空闲时自动更新」：开着就等电脑空闲时升级，再告诉你改了什么；关了就先问你 |
| 安全修复 | 马上升级，再告诉你原因。不管「空闲时自动更新」开没开 |
| 技能推荐 | 跟你这台电脑做的事有关时（内容创作、App 开发、电商或通用），问你要不要装；无关的不打扰你。不会自己装 |
| 账单 | 只转告你。不会因为一条通知去付款或改订阅 |
| 公告 | 只转告你 |
| 客服回复 | 转告你客服在会话里的新回复，见 [找客服](/docs/support/) |

升级的时候，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`

```bash
agentj config set updates.mode ask
```

`agentj config set updates.mode auto`

```bash
agentj config set updates.mode auto
```

## 手机上看到的样子

- 每条通知在对话里单独占一页。
- 只有当这一页真的显示在已配对的手机上，手机才会告诉我们这条已读。电脑收到、Agent 已处理，和你已读，是分开记录的。
- 锁屏提醒里不放通知正文：安全修复显示「Agent J 有紧急安全更新」，其他紧急通知显示「有一个请求等你批准」，普通通知显示「有新回复」。

## 我们看得到什么，看不到什么

为了发通知，我们能看到每台电脑的这些信息：账号 ID、电脑的编号、Agent J 的版本、用的是哪个 AI 编程工具、在不在线、配了几部手机、几部在线。每条通知送到了哪些电脑、什么时候送到、什么时候在手机上读过，我们也看得到。

我们看不到：你的对话、你的邮箱、电脑和手机的名字。技能推荐跟你有没有关系，是在你的电脑上判断的，不会为此把你的情况发给我们。

## 升级邮件：转给你的 Agent J，它自己升级

有新版本时，我们每天早上 9 点（日本时间）最多发一封升级邮件。一封邮件把上次以来的更新合在一起，只写最新的版本号，按新功能、改进、修复的问题分好类，用你账号设置的语言。

邮件里有个升级授权码，代表你同意这次升级：

- 只能用来升级到邮件里写的那个版本；
- 14 天内有效；
- 这个账号下的每台电脑各能用一次。

把整封邮件转给 Agent J，比如直接贴进手机对话里。它会核对版本，然后运行下面任意一条：

`agentj update apply --from-email -`

```bash
agentj update apply --from-email -
```

`agentj update apply --authorization <授权码> --version <版本>`

```bash
agentj update apply --authorization <授权码> --version <版本>
```

接着重启、自检，把结果告诉你，中间不用你再确认。你电脑上的 Agent J 如果还是 0.14 或更早的版本，这两种写法它还不认识：请在电脑上打开当初安装 Agent J 的那个 AI 编程工具，把邮件原样贴给它。

没有邮件也一样能升级：跟你的 Agent J 说一声要升级，它会自己运行 `agentj update apply`，装好、重启、自检，再告诉你结果。

想少收或者不收：在 [账号后台](/docs/account/) 的「设置」里，「升级邮件」可以选「每次升级都发」「只发大版本」或「不发」。每封邮件底部也有退订链接，点一下就能改。
