安装与更新 Onevium
选择匹配系统的桌面安装包,启动应用,并核对更新后的版本与工作状态。
开始使用选择官方安装包#
打开 Onevium 1.3.3 发布页,在 Assets 中选择安装包。下面列的是该版本实际发布的格式。
| 系统与架构 | 安装包 |
|---|---|
| Apple 芯片 Mac | Onevium-1.3.3-arm64.dmg;另有同架构 .zip |
| Intel Mac | Onevium-1.3.3-x64.dmg;另有同架构 .zip |
| Windows x64 | Onevium-Setup-1.3.3.exe |
1.3.3 没有 Linux 或 Windows arm64 安装包。历史 1.1.23 发布页仍提供 Linux x86_64 与 arm64 的 AppImage、DEB 包;下方保留的 Linux 步骤安装的是 1.1.23,不是 1.3.3。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.3.2 起,macOS 安装包使用固定的「Onevium」签名,未做 Apple 公证。如果系统拦截启动,先核对官方下载来源,再使用系统提供的单应用放行流程;不要全局关闭系统保护。
Windows
运行 Onevium-Setup-1.3.3.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.3.2 升级到 1.3.3
保存工作并结束正在运行的任务,保留同一系统用户和数据目录。首次启动会在 upgrade-backups 中创建并校验主数据库快照,再迁移会话与设置。请等待启动进度完成,不要强制退出或删除应用数据。
1.3.2 不能打开升级后的主数据库。如果必须回退,先完全退出 Onevium,另存当前整个数据目录,再用升级前快照恢复 onevium.db,将工作目录中旧的 onevium.db-wal、onevium.db-shm 移到别处后启动旧版。恢复后的主数据库不包含快照之后新增的数据。
资料空间的独立数据库、资料文件和版本位于数据目录的 space 文件夹,主数据库备份不包含完整的资料空间。迁移电脑或回退 beta 前,请退出应用并复制整个数据目录,详见备份范围。
macOS 固定签名与增量更新
官方 1.3.2 与 1.3.3 的 macOS 安装包使用同一固定 Onevium 签名身份。从 1.3.2 升级时可使用应用内更新。旧包缓存和 blockmap 可用时,更新器可复用未改变的数据块;下载量随版本变化,必要时会回退为完整下载。
更早的 1.3.1 和 ad-hoc beta 包需要手动安装一次 DMG。退出应用后替换「应用程序」中的 Onevium,再核对系统权限。固定签名不等于 Apple 公证。新构建可能请求钥匙串访问,请确认请求来自 Onevium 后再允许。
1.3.3 的行为变化
- 每日简报及其专用触发器已退役。可单独安装官方每日复盘 Skill,在资料空间保存日报与经验并按需设置每日任务,旧计划不会自动迁移。旧数据库记录保留,普通定时任务与记忆继续可用。
- 检查「设置 → 权限与确认」。未保存新规则时,普通确认等待 30 秒后确认,提问等待两分钟后采用可用默认选项,不会编造必填文字。原有秘钥超时拒绝设置继续用于秘钥、SSH 与敏感操作。
- 保留已有模型选择、自定义映射和禁用状态;受限目录模型需要取得服务商权限后手动启用。
- 新安装的默认值不会重置已有个人设置。使用资料空间保存重要文件前,请了解其备份范围。
确认实际运行版本#
重新打开后,在 设置 → 通用 核对版本。再打开一个已有项目和会话,确认文件与历史可见。能打开应用不代表模型连接可用,还需完成一次文字与工具验证。
常见安装问题#
| 现象 | 处理方法 |
|---|---|
| 安装包无法运行 | 核对系统、架构和完整文件名;不要运行 .blockmap 或更新清单 |
| AppImage 提示没有执行权限 | 在文件所在目录运行上面的 chmod +x 命令 |
| AppImage 缺少运行库 | 记录系统报告的库名;在受支持的 Debian/Ubuntu 环境可改用对应 DEB 包,不能假定每个发行版依赖都相同 |
| 仍显示旧版本 | 确认启动的是“应用程序”或已安装入口,而非下载目录里的另一份副本 |
| 系统拦截启动 | 先确认来自官方发布页,再使用系统提供的单应用放行流程;不要全局关闭系统保护 |
| 会话历史不见了 | 先核对系统用户与应用副本,不要创建空数据覆盖旧目录 |