Files
Agent-Workbench/docs/UPGRADE.md
T

2.5 KiB

升级到 1.2.0并保留原连接

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

升级条件

使用已完成构建的1.2.0便携包,保留原启动发行目录及当前实现目录。工作台中的任务、工程检查、Git交付和命令审批均已结束,当前本地9229端口可用。脚本接受127.0.0.1上的0.1.0、1.0.0、1.1.0或1.2.0工作台,先核对进程PID和原发行路径,再迁移对象。升级后校验配置、项目、会话和PID,并关闭本次开启的调试端口。控制请求使用独立HTTP连接,避免调试暂停后复用超时连接。

首次从旧JSON版本进入SQLite时,数据在保留原字节备份的事务中迁移,旧历史以legacy-import标明来源。已有SQLite实例保留原状态与Map并补齐新增Git记录类型。随附npm位于新发行runtime,原进程保留原Node可执行路径并使用新npm检查器。

执行

在解压后的1.2.0便携目录打开PowerShell。使用service-info保存的原启动目录,数据目录沿用当前启动配置;此前已经热升级的实例另传当前handler目录。

$awNewRoot = (Get-Location).Path
$awServiceInfo = Get-Content -LiteralPath (Join-Path $env:LOCALAPPDATA 'AgentWorkbench\service-info.json') -Encoding UTF8 -Raw | ConvertFrom-Json
$awUpgradeArguments = @((Join-Path $awNewRoot 'scripts\upgrade-running.mjs'), '--url', 'http://127.0.0.1:4318', '--pid', $awServiceInfo.pid, '--current-root', $awServiceInfo.appRoot, '--new-root', $awNewRoot)
if ($awServiceInfo.runtimeRoot) { $awUpgradeArguments += @('--handler-root', $awServiceInfo.runtimeRoot) }
& (Join-Path $awNewRoot 'runtime\node.exe') @awUpgradeArguments

成功后访问 http://127.0.0.1:4318/?release=1.2.0,界面显示v1.2.0。任务记录可查看工程检查、Git预览、提交与交付报告;已有项目路径继续指向原项目,不移动用户文件。

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

验证范围

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