安装与更新 Onevium
选择匹配系统的桌面安装包，启动应用，并核对更新后的版本与工作状态。
开始使用选择官方安装包#
打开 Onevium 1.2.1 发布页，在 Assets 中选择安装包。下面列的是该版本实际发布的格式。
| 系统与架构 | 安装包 |
|---|---|
| Apple 芯片 Mac | Onevium-1.2.1-arm64.dmg；另有同架构 .zip |
| Intel Mac | Onevium-1.2.1-x64.dmg；另有同架构 .zip |
| Windows x64 | Onevium-Setup-1.2.1.exe |
1.2.1 没有 Linux 或 Windows arm64 安装包。历史 1.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 架构。
升级前先保存文件，并结束当前任务或记录恢复位置。普通更新无需删除应用数据；需要备份时阅读设置与数据。
安装并首次启动#
macOS
- 下载匹配芯片的
.dmg，双击打开。 - 将 Onevium 拖入“应用程序”；已有版本时先退出应用，再确认替换。
- 从“应用程序”打开 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 使用：
chmod +x Onevium-1.1.23-x86_64.AppImage
./Onevium-1.1.23-x86_64.AppImage
arm64 使用：
chmod +x Onevium-1.1.23-arm64.AppImage
./Onevium-1.1.23-arm64.AppImage
AppImage 可直接运行，不需要用包管理器安装。
Linux：Debian / Ubuntu
对于历史 1.1.23 安装包，在文件所在目录执行对应的一条命令：
sudo apt install ./Onevium-1.1.23-amd64.deb
arm64 将文件名改为 Onevium-1.1.23-arm64.deb。安装后从应用菜单启动 Onevium。
首次打开后完成应用的账户登录或许可证激活。模型接入是下一步，详见连接服务商。
检查与安装更新#
打开 设置 → 通用，查看 Onevium 版本行，点击 检查更新。
| 当前显示 | 下一步 |
|---|---|
| 下载并安装 | 点击后等待下载完成；准备好结束当前工作时再重启更新 |
| 重启更新 | 先保存工作，再点击重启；重新打开后检查版本号 |
| 手动下载 / 查看发布 | 打开官方发布页，下载匹配系统和架构的新安装包，退出旧应用后安装 |
| 更新失败 | 保留错误信息；可以从官方发布页手动下载安装，不能把失败状态当作已更新 |
更新入口会根据运行环境和当前状态变化，不应只凭系统名称推定一定自动更新或一定手动更新。
升级到 1.2.1
替换应用前先结束正在运行的任务并退出 Onevium，保留原操作系统账户与数据目录；再次启动时会自动迁移已有会话与设置。已有数据库需要升级时，应用会先在本地 upgrade-backups 生成一致性快照，不需要通过删除应用数据来触发升级。
旧版应用会拒绝较新的数据库结构。回退需要对应的升级前备份，恢复快照会丢失快照之后的改动。备份应与正在使用的数据分开保存，尝试恢复前先阅读设置与数据。
Windows 保留 NSIS blockmap 差分更新格式。当前构建主机未实测 Windows、Intel Mac 安装，以及旧版本差分更新的完整流程；打包检查与 Apple Silicon 运行冒烟检查不能代替这些安装验收。
关键应用文件有完整性签名，与 macOS 公证或 Windows 发布者证书不同。需要核对下载文件时，将其 SHA-256 与同一官方发布页的 SHA256SUMS 对照。
升级后如会话、定时任务或回顾工具不可用，请检查 设置 → 工具：这些可选工具组需要启用，不会删除已有数据。AI 标题整理需主动开启。新安装的浏览器运行能力默认关闭，已有的启用设置会保留。
确认实际运行版本#
重新打开后，在 设置 → 通用 核对版本。再打开一个已有项目和会话，确认文件与历史可见。能打开应用不代表模型连接可用，还需完成一次文字与工具验证。
常见安装问题#
| 现象 | 处理方法 |
|---|---|
| 安装包无法运行 | 核对系统、架构和完整文件名；不要运行 .blockmap 或更新清单 |
| AppImage 提示没有执行权限 | 在文件所在目录运行上面的 chmod +x 命令 |
| AppImage 缺少运行库 | 记录系统报告的库名；在受支持的 Debian/Ubuntu 环境可改用对应 DEB 包，不能假定每个发行版依赖都相同 |
| 仍显示旧版本 | 确认启动的是“应用程序”或已安装入口，而非下载目录里的另一份副本 |
| 系统拦截启动 | 先确认来自官方发布页，再使用系统提供的单应用放行流程；不要全局关闭系统保护 |
| 会话历史不见了 | 先核对系统用户与应用副本，不要创建空数据覆盖旧目录 |