如意

下载如意

只提供真实可用的安装包

下载按钮必须经过在线可用性、完整性和安装流程验证。尚未生成的正式版只显示准备状态，不会把你带到 404 页面。

最新版本

下载安装包

只有已上传且通过在线检查的资产才提供下载操作；请不要从未知镜像获取同名文件。

Stable 签名版尚未开放Apple 与 Windows 发行证书、公证及跨平台 Runner 尚未完成。下面唯一可下载的文件是已完成本机“打包—校验—安装—启动—卸载”的 Apple 芯片未签名测试版。它不代表正式发布，也不建议用于生产环境。
macOS · Stable

英特尔芯片

等待 Developer ID 签名、公证和 Intel 实机验收。

ruyi-macos-x64.dmg正式版准备中
Windows · Stable

64 位

等待 Authenticode 签名和 Windows 安装、卸载实机验收。

ruyi-windows-x64.exe正式版准备中
Linux · 后续目标

64 位预览

Linux 不属于 V1 正式支持范围，当前不提供下载。

ruyi-linux-x64.AppImage暂未开放

系统要求

正式支持基线

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

macOS

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

Windows

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

Linux

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

完整性验证

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

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

  1. 下载当前校验文件

    下载 Apple 芯片测试版 SHA-256 清单。正式版开放后还必须验证平台代码签名与独立签名；当前测试包不具备这些信任证明。

  2. 计算安装包的 SHA-256

    在 macOS 终端运行：

    shasum -a 256 ruyi-macos-arm64-unsigned-20260731.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 添加执行权限；预览版依赖以发布说明为准。
查看安装常见问题