---
title: 旧版安装迁移
nav: 旧版迁移
summary: 保留旧命令、状态和下载入口，按原有流程迁移到 Agent J。
order: 62
---
# 旧版安装迁移

<details>
<summary>旧版兼容细节</summary>

仅在旧版安装上使用本页。先按当前[安装说明](https://agentj.app/install.md)核验并保留新签名下载包，告知主人并取得同意，再停止旧服务。不要清除身份、配对信息或个人文件。

- 先用 `uv tool list`（或 `pipx list`）确认旧版主机包是否存在，不要仅凭命令名称猜测安装状态。
- 确认新包已按当前安装说明下载并核验签名和校验值，再用旧版主机命令的 `service uninstall` 停止旧服务。用原安装工具卸载列表里确认的旧包，最后按安装说明装 `agentj`。不要直接执行未经核验的下载。
- 当前状态目录为 `~/.local/state/agentj`。旧状态目录仅在主人同意后迁移：终端询问 y/N；无终端用 `agentj --migrate-legacy status`。旧路径保留兼容链接，旧服务仍运行时不会强行搬走。
- 回退用 `agentj migrate rollback`，随后按原方式重装原版本。不要靠删目录或重新配对来修迁移。
- 迁移后的主机可能保留旧版兼容命令；旧命令和状态的退役另行安排，本次不删除。新安装只使用 `agentj` 或短命令 `aj`，用 `agentj alias install` 管理短命令。同名命令已存在时不会覆盖。
- 已配对的旧手机入口继续工作；当前入口为 https://m.agentj.app，不因改名字要求重新配对。

## 兼容下载地址

旧安装可能仍从原下载域名及其测试、API 子域名获取 `/install.md`、校验文件和 `/dl/`。仍须与 GitHub 副本及当前签名核对。本次仅改文字，不迁移域名、API POST/WSS、邮件、浏览器来源或配对资料。

旧访客存储来源继续兼容。本次仅改文字，不调整 iframe、来源校验或浏览器存储。

</details>
