OpenHuman 更新指南 — 如何升级到最新版本

OpenHuman 迭代很快，v0.53 → v0.54 只隔了几天。保持最新版本可以体验新功能、修复 Bug、提升安全性。本文介绍三种更新方式。

方法一：自动更新（推荐）

OpenHuman 默认开启自动检查更新。当新版本发布时：

1. 任务栏/菜单栏的 OpenHuman 图标会显示更新提示
2. 点击提示，选择"下载更新"
3. 下载完成后，选择"立即重启"完成更新

自动下载的安装包会自动替换旧版本，你的配置和数据不会丢失。

方法二：手动下载安装包

如果你关闭了自动更新，或自动更新失败：

1. 访问 openhuman.cn 或 GitHub Releases 页面
2. 下载对应平台的最新安装包
3. 关闭当前运行的 OpenHuman
4. 运行新安装包覆盖安装

方法三：命令行升级

如果你是通过命令行安装的：

curl -fsSL https://get.openhuman.cn | bash

再次运行安装脚本会自动检测现有版本并升级到最新版。

从源码更新

如果你是从 GitHub 源码编译的：

cd openhuman
git pull --rebase
pnpm install
pnpm tauri build

更新后需要做什么？

• 检查配置：大版本更新可能新增配置项，建议检查 config.toml
• 重新连接集成：极少数情况 OAuth token 可能需要重新授权
• 查看更新日志：打开设置 → 关于，查看新版本特性

回滚到旧版本

如果新版本有兼容性问题：

• 在 GitHub Releases 下载旧版本安装包
• 卸载当前版本后安装旧版本
• 数据（Memory Tree 和配置）不受影响

相关阅读

• 安装指南
• 从源码编译
• 备份与迁移