如意

下载如意

选择适合你的安装包

以下链接始终指向 GitHub Releases 的最新正式发布，并使用不会随版本变化的固定资产名称。安装前建议完成 SHA-256 校验。

最新版本

下载安装包

若最新发布尚未提供某个平台的资产，GitHub 会显示未找到文件；请不要从未知镜像下载同名文件。

Stable 签名版尚未开放Apple 与 Windows 发行证书、公证及跨平台 Runner 尚未完成。当前仅提供已经过本机“打包—校验—安装—启动—卸载”验证的 Apple 芯片未签名测试版和对应的 SHA-256 清单。测试版不代表正式发布，请勿忽略系统安全提示将其用于生产环境。
Linux

64 位预览

Linux 是后续支持目标，当前资产不属于 V1 正式支持范围。

ruyi-linux-x64.AppImage下载 Linux 64 位预览版

系统要求

正式支持基线

具体版本如有更高要求，以对应发布说明为准。

macOS

  • macOS 13 或更高版本
  • Apple 芯片或英特尔芯片
  • 安装包应通过项目签名与 Apple 公证检查

Windows

  • Windows 10 22H2 或更高版本
  • Windows 11
  • 64 位处理器；需要可用的 WebView2

Linux

  • 64 位 Linux；具体发行版矩阵待正式冻结
  • 可能需要发行版提供 WebKitGTK 与 Secret Service
  • 预览支持不阻塞 macOS 与 Windows 正式版

完整性验证

先核对校验和，再检查平台签名

校验和能发现下载损坏或内容被替换；平台代码签名用于确认发布身份。二者用途不同，建议都检查。

  1. 下载官方校验文件

    下载 SHA-256 校验和文件，如发布提供独立签名，再下载校验和签名文件。只信任项目发布页公布且指纹一致的验证公钥。

  2. 计算安装包的 SHA-256

    在 macOS 终端运行：

    shasum -a 256 ruyi-macos-arm64.dmg

    在 Linux 终端运行：

    sha256sum ruyi-linux-x64.AppImage

    在 Windows PowerShell 运行：

    Get-FileHash .\ruyi-windows-x64.exe -Algorithm SHA256

  3. 逐字符比对

    计算结果必须与 SHA256SUMS 中同名资产的值完全一致。若不一致，请删除文件，不要安装，并从官方最新发布重新下载。

  4. 检查操作系统签名

    macOS 可使用 spctl --assess --type open --verbose=4 ruyi-macos-arm64.dmg 检查；Windows 可使用 Get-AuthenticodeSignature .\ruyi-windows-x64.exe，状态应为 Valid。Linux 独立签名的工具和公钥指纹以该版本发布说明为准。

校验或签名失败时不要继续不要通过忽略系统警告、关闭安全功能或运行来源不明的脚本来绕过验证。

安装提示

安装后仍由你确认关键操作

首次启动会检查官方 Pi、模型准备和项目选择。找不到 Pi 时可选择由如意协助安装官方版本，或指定已有 Pi 路径。

  • macOS：打开已验证的 DMG，将如意移入“应用程序”。
  • Windows：运行已验证的安装程序，按签名发布者信息确认来源。
  • Linux：为 AppImage 添加执行权限；预览版依赖以发布说明为准。
查看安装常见问题