> 内容来源：Onevium 官方文档
> 文章: 安装与更新 Onevium
> 原文: https://onevium.com/zh/docs/installation
> 语言：简体中文
> 更新于: 2026-09-09
> 适用版本: 1.1.22
> 功能状态: 已发布

---

# 安装与更新 Onevium

选择匹配系统的桌面安装包，启动应用，并核对更新后的版本与工作状态。

## 选择官方安装包

打开 [Onevium 1.1.22 发布页](https://github.com/Onevium/Onevium/releases/tag/v1.1.22)，在 Assets 中选择安装包。下面列的是该版本实际发布的格式。

| 系统与架构         | 安装包                                                           |
| ------------- | ------------------------------------------------------------- |
| Apple 芯片 Mac  | `Onevium-1.1.22-arm64.dmg`；另有同架构 `.zip`                       |
| Intel Mac     | `Onevium-1.1.22-x64.dmg`；另有同架构 `.zip`                         |
| Windows x64   | `Onevium-Setup-1.1.22.exe`                                    |
| Linux x86\_64 | `Onevium-1.1.22-x86_64.AppImage` 或 `Onevium-1.1.22-amd64.deb` |
| Linux arm64   | `Onevium-1.1.22-arm64.AppImage` 或 `Onevium-1.1.22-arm64.deb`  |

1.1.22 没有 Windows arm64 或 RPM 安装包。`latest*.yml`、`.blockmap` 是更新辅助文件，不是安装程序。

## 核对系统与已有工作

- **Mac**：苹果菜单 → 关于本机。Apple M 系列选择 arm64，Intel 选择 x64。
- **Windows**：设置 → 系统 → 系统信息，查看系统类型；本版本安装包面向 x64。
- **Linux**：终端运行 `uname -m`。`x86_64` 对应 x86\_64/amd64，`aarch64` 或 `arm64` 对应 arm64。Debian/Ubuntu 还可用 `dpkg --print-architecture` 确认 DEB 架构。

升级前先保存文件，并结束当前任务或记录恢复位置。普通更新无需删除应用数据；需要备份时阅读[设置与数据](https://onevium.com/zh/docs/settings-and-data)。

## 安装并首次启动

### macOS

1. 下载匹配芯片的 `.dmg`，双击打开。
2. 将 Onevium 拖入“应用程序”；已有版本时先退出应用，再确认替换。
3. 从“应用程序”打开 Onevium，不要继续运行磁盘映像中的副本。`.zip` 是同架构的替代分发包，一般优先使用 `.dmg`。

### Windows

运行 `Onevium-Setup-1.1.22.exe` 完成安装，再从开始菜单启动 Onevium。更新时先保存工作，避免安装过程中继续使用旧窗口。

### Linux：AppImage

在下载文件所在目录打开终端。x86\_64 使用：

```bash
chmod +x Onevium-1.1.22-x86_64.AppImage
./Onevium-1.1.22-x86_64.AppImage
```

arm64 使用：

```bash
chmod +x Onevium-1.1.22-arm64.AppImage
./Onevium-1.1.22-arm64.AppImage
```

AppImage 可直接运行，不需要用包管理器安装。

### Linux：Debian / Ubuntu

在安装包所在目录执行对应的一条命令：

```bash
sudo apt install ./Onevium-1.1.22-amd64.deb
```

arm64 将文件名改为 `Onevium-1.1.22-arm64.deb`。安装后从应用菜单启动 Onevium。

首次打开后完成应用的账户登录或许可证激活。模型接入是下一步，详见[连接服务商](https://onevium.com/zh/docs/providers)。

## 检查与安装更新

打开 **设置 → 通用**，查看 Onevium 版本行，点击 **检查更新**。

| 当前显示        | 下一步                                |
| ----------- | ---------------------------------- |
| 下载并安装       | 点击后等待下载完成；准备好结束当前工作时再重启更新          |
| 重启更新        | 先保存工作，再点击重启；重新打开后检查版本号             |
| 手动下载 / 查看发布 | 打开官方发布页，下载匹配系统和架构的新安装包，退出旧应用后安装    |
| 更新失败        | 保留错误信息；可以从官方发布页手动下载安装，不能把失败状态当作已更新 |

更新入口会根据运行环境和当前状态变化，不应只凭系统名称推定一定自动更新或一定手动更新。

## 确认实际运行版本

重新打开后，在 **设置 → 通用** 核对版本。再打开一个已有项目和会话，确认文件与历史可见。能打开应用不代表模型连接可用，还需完成一次[文字与工具验证](https://onevium.com/zh/docs/providers#check)。

## 常见安装问题

| 现象                | 处理方法                                                       |
| ----------------- | ---------------------------------------------------------- |
| 安装包无法运行           | 核对系统、架构和完整文件名；不要运行 `.blockmap` 或更新清单                       |
| AppImage 提示没有执行权限 | 在文件所在目录运行上面的 `chmod +x` 命令                                 |
| AppImage 缺少运行库    | 记录系统报告的库名；在受支持的 Debian/Ubuntu 环境可改用对应 DEB 包，不能假定每个发行版依赖都相同 |
| 仍显示旧版本            | 确认启动的是“应用程序”或已安装入口，而非下载目录里的另一份副本                           |
| 系统拦截启动            | 先确认来自官方发布页，再使用系统提供的单应用放行流程；不要全局关闭系统保护                      |
| 会话历史不见了           | 先核对系统用户与应用副本，不要创建空数据覆盖旧目录                                  |

## 下一步

完成[模型连接](https://onevium.com/zh/docs/providers)，再按[第一个任务](https://onevium.com/zh/docs/getting-started)打开项目并验证工作区。