agentUpgrade
experimental
配置编码 agent 的升级与提醒。
experimental.agentUpgrade 选项为 next upgrade --agent 选择默认策略,并控制 next dev 和 next build 期间的升级提醒。它默认使用 security 策略。
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
experimental: {
agentUpgrade: 'latest',
},
}
export default nextConfig/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
agentUpgrade: 'latest',
},
}
module.exports = nextConfig该选项接受以下值:
| 值 | 行为 |
|---|---|
false | 禁用升级提醒。 |
security(默认) | 检查稳定版本安装是否存在安全公告,并在有可用公告时推荐安全的升级。 |
latest | 在应用当前的稳定版或 canary 通道上推荐更新的主版本或次版本。 |
experimental-future | 使用 latest 策略,并同时推荐适用的 Future Defaults。 |
该选项不会自动升级应用。它只控制提醒,以及 next upgrade --agent 未包含值时要使用的策略。
提醒行为#
在交互式终端中,next dev 或 next build 期间符合条件的提醒会提供以下操作。命令会在提示后继续执行,并在你做决定时缓冲其输出。
- 立即升级 停止当前命令,并使用配置的策略启动
next upgrade --agent。 - 跳过 返回正在运行的命令,并回放其缓冲的输出。
- 跳过直到下一个版本 针对已安装的版本和策略保存此次跳过的决定。
如果你在十秒内没有做出选择,或缓冲输出增长到约 10 MiB 以上,提醒会自动跳过。
当编码 agent 运行 next dev 或 next build 时,第一个符合条件的提醒会停止命令,并给出报告升级的指示。迅速重试同一命令会使用警告继续执行原始任务。
当升级提醒启用时,next dev 还会向 AGENTS.md 写入一个单独的受管理升级块。该块委托处理已安装 CLI 的提醒:
<!-- BEGIN:nextjs-agent-upgrade -->
## Next.js 升级提醒
本项目安装的 Next.js CLI 在 `next dev` 或 `next build` 期间发出的升级提醒,属于 `experimental.agentUpgrade` 工作流。在遵循用户拒绝升级的指示的前提下,请按照这些提醒的指示执行。
<!-- END:nextjs-agent-upgrade -->设置 experimental.agentUpgrade: false 会在下次运行 next dev 时移除该块。文档规则(agentRules)和反馈指示(experimental.agentFeedback)保持独立。create-next-app 会使用默认的 security 策略为新应用包含该升级块。
提醒要求安装的 Next.js 版本支持 experimental.agentUpgrade。运行当前 canary 升级 CLI 不会为较旧的安装添加提醒。
在 next dev 期间,如果安装的版本受到已知安全漏洞影响,Next.js DevTools 还会显示 Vulnerability Insight。该 insight 提供一段可复制的提示词,用于与编码 agent 一起启动 security 升级。
版本历史#
| 版本 | 变更 |
|---|---|
v16.5.0 | next dev 在每次启动时同步受管理的升级块。 |
v16.4.0 | 新增 experimental.agentUpgrade 配置项。 |