跳转到正文
Onevium文档
本页内容

安装与更新 Onevium

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

选择官方安装包#

打开 Onevium 1.3.3 发布页,在 Assets 中选择安装包。下面列的是该版本实际发布的格式。

系统与架构安装包
Apple 芯片 MacOnevium-1.3.3-arm64.dmg;另有同架构 .zip
Intel MacOnevium-1.3.3-x64.dmg;另有同架构 .zip
Windows x64Onevium-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

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

从 1.3.2 起,macOS 安装包使用固定的「Onevium」签名,未做 Apple 公证。如果系统拦截启动,先核对官方下载来源,再使用系统提供的单应用放行流程;不要全局关闭系统保护。

Windows

运行 Onevium-Setup-1.3.3.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。

首次打开后完成应用的账户登录或许可证激活。模型接入是下一步,详见连接服务商。

检查与安装更新#

打开 设置 → 通用,查看 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 包,不能假定每个发行版依赖都相同
仍显示旧版本确认启动的是“应用程序”或已安装入口,而非下载目录里的另一份副本
系统拦截启动先确认来自官方发布页,再使用系统提供的单应用放行流程;不要全局关闭系统保护
会话历史不见了先核对系统用户与应用副本,不要创建空数据覆盖旧目录

下一步#

完成模型连接,再按第一个任务打开项目并验证工作区。