首页 / 文档 / 快速开始 / 更新升级

更新升级

通千算智的升级方式说明

命令升级（推荐）

使用 cow update 一键完成代码更新和服务重启：

bash

cow update

该命令会自动完成以下流程：

拉取最新代码（git pull）
停止当前服务
更新 Python 依赖
重新安装 CLI
启动服务

如果未安装通千算智 CLI，也可以使用 ./run.sh update 完成相同操作。

控制台一键更新

源码安装也可以直接在 Web 控制台升级，不必再开终端。

点击左侧栏底部的版本号，弹出上拉菜单。打开菜单时不会访问 GitHub。
点击 检查更新，才会拉取版本信息。这是唯一的网络请求；若有新版本，同一项会变成 立即更新 并带一个红点提示。
点击 立即更新。控制台复用 cow update 的同一条路径（git pull、安装依赖、重装 CLI），然后重启服务。菜单里的 版本说明 则会打开 GitHub releases 页面查看完整变更。

更新只操作 git 代码目录：用户数据在仓库之外（agent_workspace，默认 ~/cow），config.json 也被 gitignore，所以 git pull 不会覆盖它们，无需备份。更新前会记录当前 git 提交，如果新代码无法 import，会重置回该提交，且不杀死正在运行的进程。

更新成功后，控制台会自动重连并显示新版本号。

Docker 镜像和桌面客户端不能用这个按钮。Docker 仍使用 docker compose pull；桌面客户端继续走内置更新。Windows 上请在终端执行 cow update，Web 控制台无法从进程内部完成重启。

回滚

如果更新成功但新版本工作异常，回退到上一个提交即可：

bash

cow stop
git reset --hard <previous-commit>   # tmp/web-update-status.json 中会记录
cow start

手动升级

在项目根目录下执行：

bash

git pull
pip3 install -r requirements.txt
pip3 install -e .

更新完成后重启服务：

bash

# 使用 通千算智 CLI (推荐)
cow restart

# 或使用 run.sh
./run.sh restart

# 或使用 nohup 直接运行
kill $(ps -ef | grep app.py | grep -v grep | awk '{print $2}')
nohup python3 app.py & tail -f nohup.out

Docker 升级

在 docker-compose.yml 所在目录下执行：

bash

sudo docker compose pull
sudo docker compose up -d

提示

升级前建议备份 config.json 配置文件。Docker 环境下如需保留数据，可通过 volume 挂载持久化工作空间目录。

客户端升级

桌面客户端内置自动更新能力，有新版本时会自动检查并提示，一键即可下载并重启完成升级。

你也可以随时前往下载页手动下载最新版本安装。