Files
Agent-Workbench/docs/UPGRADE.md
T
2026-10-29 11:23:43 +08:00

1.9 KiB

从 0.1.0 升级到 1.0.0

升级脚本在原Node进程中替换工作台实现,保留现有内存连接对象、项目和会话。它不会读取、打印、导出或复制API Key。普通停止后重启会丢失仅在内存中的Key,需要重新填写。

升级条件

使用已完成构建的1.0.0便携包,保留原0.1.0发行目录。工作台中的任务和命令审批均已结束,当前本地9229端口可用。脚本只接受127.0.0.1上的0.1.0工作台,先核对进程PID和原发行路径,再迁移对象。升级后校验配置、项目、会话和PID,并关闭本次开启的调试端口。

执行

在解压后的1.0.0便携目录打开PowerShell。下面的旧发行路径替换为本机真实路径,数据目录沿用当前启动配置。

$awOldRoot = 'D:\Ai-project\REA逆向\Agent-Workbench\releases\Agent-Workbench-0.1.0-win-x64'
$awNewRoot = (Get-Location).Path
$awServiceInfo = Get-Content -LiteralPath (Join-Path $env:LOCALAPPDATA 'AgentWorkbench\service-info.json') -Encoding UTF8 -Raw | ConvertFrom-Json
& (Join-Path $awNewRoot 'runtime\node.exe') (Join-Path $awNewRoot 'scripts\upgrade-running.mjs') --url http://127.0.0.1:4318 --pid $awServiceInfo.pid --current-root $awOldRoot --new-root $awNewRoot

成功后访问 http://127.0.0.1:4318/?release=1.0.0,界面显示v1.0.0。运行诊断可核对模型名称、凭据是否已配置和文件审核状态。已有项目路径继续指向原项目,不移动用户文件。

service-info.json保留原启动目录,并增加当前实现目录runtimeRoot与版本。再次运行启动器会复用当前本地服务;以后需要重启时,从1.0.0目录启动。

验证范围

独立旧版进程测试已验证同PID升级、文件及提案保留、合成内存Key的升级后认证和调试端口关闭。正式用户连接与原会话的升级验证单独记录在 验收记录。