> 内容来源：Onevium 官方文档 > 文章: 安装与更新 Onevium > 原文: https://onevium.com/zh/docs/installation > 语言：简体中文 > 更新于: 2026-09-20 > 适用版本: 1.2.1+ --- # 安装与更新 Onevium 选择匹配系统的桌面安装包，启动应用，并核对更新后的版本与工作状态。 ## 选择官方安装包 打开 [Onevium 1.2.1 发布页](https://github.com/Onevium/Onevium/releases/tag/v1.2.1)，在 Assets 中选择安装包。下面列的是该版本实际发布的格式。 | 系统与架构 | 安装包 | | ------------ | --------------------------------------------------------------------------------------------------------------------------- | | Apple 芯片 Mac | [Onevium-1.2.1-arm64.dmg](https://github.com/Onevium/Onevium/releases/download/v1.2.1/Onevium-1.2.1-arm64.dmg)；另有同架构 `.zip` | | Intel Mac | [Onevium-1.2.1-x64.dmg](https://github.com/Onevium/Onevium/releases/download/v1.2.1/Onevium-1.2.1-x64.dmg)；另有同架构 `.zip` | | Windows x64 | [Onevium-Setup-1.2.1.exe](https://github.com/Onevium/Onevium/releases/download/v1.2.1/Onevium-Setup-1.2.1.exe) | 1.2.1 没有 Linux 或 Windows arm64 安装包。历史 [1.1.23 发布页](https://github.com/Onevium/Onevium/releases/tag/v1.1.23)仍提供 Linux x86\_64 与 arm64 的 AppImage、DEB 包；下方保留的 Linux 步骤安装的是 1.1.23，不是 1.2.1。`latest*.yml`、`.blockmap` 是更新辅助文件，不是安装程序。 ## 核对系统与已有工作 - **Mac**：苹果菜单 → 关于本机。Apple M 系列选择 arm64，Intel 选择 x64。 - **Windows**：设置 → 系统 → 系统信息，查看系统类型；本版本安装包面向 x64。 - **Linux（历史 1.1.23 安装包）**：终端运行 `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`。 1.2.1 的 macOS 安装包采用 ad-hoc 临时签名，未做 Apple 公证，也未使用个人开发者证书。如果系统拦截启动，先核对官方下载来源，再使用系统提供的单应用放行流程；不要全局关闭系统保护。 ### Windows 运行 `Onevium-Setup-1.2.1.exe` 完成安装，再从开始菜单启动 Onevium。此安装包未做操作系统发布者证书签名。更新时先保存工作，避免安装过程中继续使用旧窗口。 ### Linux：AppImage 以下命令适用于历史 1.1.23 安装包。在下载文件所在目录打开终端。x86\_64 使用： ```bash chmod +x Onevium-1.1.23-x86_64.AppImage ./Onevium-1.1.23-x86_64.AppImage ``` arm64 使用： ```bash chmod +x Onevium-1.1.23-arm64.AppImage ./Onevium-1.1.23-arm64.AppImage ``` AppImage 可直接运行，不需要用包管理器安装。 ### Linux：Debian / Ubuntu 对于历史 1.1.23 安装包，在文件所在目录执行对应的一条命令： ```bash sudo apt install ./Onevium-1.1.23-amd64.deb ``` arm64 将文件名改为 `Onevium-1.1.23-arm64.deb`。安装后从应用菜单启动 Onevium。 首次打开后完成应用的账户登录或许可证激活。模型接入是下一步，详见[连接服务商](https://onevium.com/zh/docs/providers)。 ## 检查与安装更新 打开 **设置 → 通用**，查看 Onevium 版本行，点击 **检查更新**。 | 当前显示 | 下一步 | | ----------- | ---------------------------------- | | 下载并安装 | 点击后等待下载完成；准备好结束当前工作时再重启更新 | | 重启更新 | 先保存工作，再点击重启；重新打开后检查版本号 | | 手动下载 / 查看发布 | 打开官方发布页，下载匹配系统和架构的新安装包，退出旧应用后安装 | | 更新失败 | 保留错误信息；可以从官方发布页手动下载安装，不能把失败状态当作已更新 | 更新入口会根据运行环境和当前状态变化，不应只凭系统名称推定一定自动更新或一定手动更新。 ### 升级到 1.2.1 替换应用前先结束正在运行的任务并退出 Onevium，保留原操作系统账户与数据目录；再次启动时会自动迁移已有会话与设置。已有数据库需要升级时，应用会先在本地 `upgrade-backups` 生成一致性快照，不需要通过删除应用数据来触发升级。 旧版应用会拒绝较新的数据库结构。回退需要对应的升级前备份，恢复快照会丢失快照之后的改动。备份应与正在使用的数据分开保存，尝试恢复前先阅读[设置与数据](https://onevium.com/zh/docs/settings-and-data)。 Windows 保留 NSIS blockmap 差分更新格式。当前构建主机未实测 Windows、Intel Mac 安装，以及旧版本差分更新的完整流程；打包检查与 Apple Silicon 运行冒烟检查不能代替这些安装验收。 关键应用文件有完整性签名，与 macOS 公证或 Windows 发布者证书不同。需要核对下载文件时，将其 SHA-256 与同一官方发布页的 `SHA256SUMS` 对照。 升级后如会话、定时任务或回顾工具不可用，请检查 **设置 → 工具**：这些可选工具组需要启用，不会删除已有数据。AI 标题整理需主动开启。新安装的浏览器运行能力默认关闭，已有的启用设置会保留。 ## 确认实际运行版本 重新打开后，在 **设置 → 通用** 核对版本。再打开一个已有项目和会话，确认文件与历史可见。能打开应用不代表模型连接可用，还需完成一次[文字与工具验证](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)打开项目并验证工作区。