n8n 2.39.0 自托管升级实操：先补两个安全漏洞，再打开 Instance AI 记忆

两个漏洞的修复版本是同一组：1.123.76、2.37.7、2.38.2。也就是说，只要你的版本低于这三条线中的对应分支，就属于受影响范围。

# 查当前版本（Docker 部署）
docker exec -it n8n n8n --version

# 或在宿主机上（npm / pnpm 安装）
n8n --version

# 看 compose 里锁的是哪个镜像 tag
grep -n "image:" docker-compose.yml

1. 数据库备份
   docker exec -t n8n-db pg_dump -U n8n n8n > n8n_backup_$(date +%Y%m%d).sql

2. 数据卷备份（包含加密密钥，丢了凭据全废）
   docker run --rm -v n8n_data:/data -v $(pwd):/backup alpine \
     tar czf /backup/n8n_data_$(date +%Y%m%d).tar.gz -C /data .

3. 记录当前镜像 tag 与 compose 文件
   cp docker-compose.yml docker-compose.yml.bak

# 改 docker-compose.yml 里的镜像 tag
#   image: docker.n8n.io/n8nio/n8n:2.39.0

docker compose pull
docker compose up -d
docker compose logs -f n8n   # 观察迁移日志，等出现 "Editor is now accessible"

□ 能登录编辑器，工作流列表完整
□ 打开一个复杂工作流，节点没有变成红色报错
□ 手动跑一个含表达式的工作流（重点验 Set / Code 节点）
□ 触发一个定时工作流，确认调度器正常
□ 调一次 AI 节点（OpenAI / Anthropic），确认凭据可用
□ 用到 Qdrant 的话，跑一次向量检索
   本版更新了 Qdrant 客户端并移除 undici v6 依赖，
   目的是恢复 Node 26 运行时下的 AI 请求兼容性

此前 Instance AI 的会话上下文在编辑器标签页关闭时就没了。2.39.0 给它补上两项能力：

1. 会话搜索
   助手能检索自己此前的会话，处理「以前见过的」工作流时
   可以直接取回上下文，不用你重新解释凭据布局与失败历史。

2. 工作区文件夹浏览
   助手的视野从「当前打开的工作流」扩展到整个工作区目录。

同一版本还新增了一个可选的并发上限，用来控制单个实例上同时运行多少个 Instance AI 任务，以及一个针对 AI 活动的分析报告模块。前者在多人都用助手时特别必要——否则一次误操作就能把实例打满。

这是本版对「链式 Agent」工作流影响最大的改动。此前每个子智能体跑在各自隔离的上下文里，父 Agent 想把自己的工作区状态交给子 Agent，只能靠节点显式传递。现在后台子智能体继承父 Agent 的工作区沙箱：

改造前：
  父 Agent ──(写文件)──> 传递节点 ──(读文件)──> 子 Agent

改造后：
  父 Agent ──(布置工作区状态一次)──> 子 Agent 直接沿用

判断标准：如果你的父子工作流里，有一半节点只是为了
「把父级的中间结果喂给子级」，那就是这次改造的候选对象。

公共 API 新增了三个 source control 端点：把项目 push 到 Git、从 Git pull、查询当前 source control 状态。编辑器侧也新增了一个 UI 控件，用来选择「哪些工作流变更要提升（promote）」。两者对应的是同一组操作。

典型 GitOps 闭环：
1. 开发者在 n8n 里改工作流
2. CI 通过 API 调「状态查询」，判断有无待提升变更
3. 通过 API 调「push」，把变更推到 Git 仓库
4. 代码评审 + 合并
5. 目标环境通过 API 调「pull」，把变更拉下来

这样外部流水线不必再人工打开 n8n 编辑器，
此前那个手工步骤正是 GitOps 断链的地方。