Files
Agent-Workbench/docs/UPGRADE.md
2026-10-29 19:33:24 +08:00

30 lines
2.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 升级到 1.4.0并保留原连接
升级脚本在原Node进程中替换工作台实现,保留现有内存连接对象、项目和会话。它不会读取、打印、导出或复制API Key。普通停止后重启会丢失仅在内存中的Key,需要重新填写。
## 升级条件
使用已经验收的1.4.0便携包,保留原启动目录和当前实现目录,使用新的独立发行目录。工作台的任务、检查、Git、文件批次和审批没有活动执行,本地9229端口可用。脚本接受127.0.0.1上的0.1.0及1.0.0–1.4.0工作台,先核对PID和原发行路径,再迁移对象。升级后校验公开配置、项目、会话和PID,并关闭本次开启的调试端口。控制请求使用独立HTTP连接。
首次从旧JSON进入SQLite时,在保留原字节备份的事务中迁移,旧历史以legacy-import标明来源。已有SQLite实例保留原状态与Map,并补齐新增Git和change_set类型。1.4.0给旧会话增加空的execution.changeSets数组,原字段和实际批次记录保留。随附npm位于新发行runtime,原进程保留原Node可执行路径并使用新npm检查器。
## 执行
在解压后的1.4.0便携目录打开PowerShell。使用service-info保存的原启动目录,数据目录沿用当前启动配置;此前已热升级的实例另传当前handler目录。运行中的发行目录保持不变,后续打包创建新的时间戳目录。
```powershell
$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.4.0`,界面显示v1.4.0。「改动」面板可审查整批文件与恢复结果,任务记录可查看工程检查、Git及交付报告;已有项目继续指向原目录。
`service-info.json`保留原启动目录,并更新当前实现目录`runtimeRoot`与版本。再次运行启动器会复用当前本地服务;以后需要重启时,从最终1.4.0目录启动。
## 验证范围
独立旧版进程测试已验证同PID升级、文件及提案保留、合成内存Key的升级后认证和调试端口关闭。正式用户连接与原会话的升级验证单独记录在 [验收记录](VALIDATION.md)。