Install

安装中心

先回答四个问题,平台会给出最合适的分发方式与验证命令。安装完成后请务必执行 rcl --version,确认版本与你要阅读的文档一致。

目标版本 RCL 0.94.0-alpha.1
Docs 0.94.0-alpha.1 (Draft)

关于本页安装资源与校验方式

  • · 已发布项均指向真实构建产物,页面登记的 SHA-256 由构建时对文件字节计算得到;点击「下载并校验」会在浏览器内复算哈希,只有一致才写入本地磁盘。
  • · 当前分发包统一为跨平台 Node.js 教学 CLI(包名 rcl-demo,需 Node 18+): Windows 用 zip 打包、macOS/Linux 用 tar.gz 打包,内容相同,不含平台原生二进制。输出 authenticity = demo-simulated, 不是官方闭源编译器,不可作为真实编译结论。
  • · 官方编译器安装包发布后将作为独立条目补充,并附各自的 SHA-256,本页不会复用现有校验值。
1. 说明你的环境与目的

操作系统

CPU 架构

使用目的

推荐方式:A. RCL Portable

第一次试用建议使用 Portable:解压即用,不修改系统环境。

A. RCL Portable

rcl-portable-0.94.0-alpha.1-windows-x64.zip

Windows 打包(zip)
Node 18+
已发布

下载、解压、运行。不修改系统环境,适合第一次尝试。

本包是跨平台 Node.js 教学 CLI(需 Node 18+)以 ZIP 形式为 Windows 打包;平台字段只表示打包方式,不包含任何平台原生二进制。 输出 authenticity = demo-simulated,不是官方编译器。

完整性校验(SHA-256)

文件
rcl-portable-0.94.0-alpha.1-windows-x64.zip
大小
8,222 字节
登记校验值
50faa0f14c09f865e29bf315ea50f7e0dce98903931ec7c5bee36409e4800637

或在本地手动复算(结果必须与登记值一致):

macOS / Linux

$ shasum -a 256 rcl-portable-0.94.0-alpha.1-windows-x64.zip

Windows PowerShell

$ Get-FileHash -Algorithm SHA256 .\rcl-portable-0.94.0-alpha.1-windows-x64.zip | Format-List

也可直接下载后自行校验:rcl-portable-0.94.0-alpha.1-windows-x64.zip

安装步骤

  1. 1. 下载 ZIP 后解压到不含空格与中文的路径,例如 C:\rcl。
  2. 2. 把解压目录下的 bin 加入 PATH(或直接使用 bin\rcl.exe)。
  3. 3. 打开新的终端,运行 rcl --version 确认安装。

验证安装是否成功

$ shasum -a 256 rcl-portable-0.94.0-alpha.1-windows-x64.zip
$ rcl --version
$ rcl doctor
$ rcl check examples/hello-reality/main.rcl
$ rcl run examples/hello-reality/main.rcl

已知问题

  • · 实验版本尚未提供代码签名,Windows 可能提示未知发布者。

全部分发方式(RCL 0.94.0-alpha.1

6 项登记资产。未发布项与缺少受信任 Manifest 的项都不提供下载。

A. RCL Portable

rcl-portable-0.94.0-alpha.1-windows-x64.zip

Windows 打包(zip)
Node 18+
已发布

下载、解压、运行。不修改系统环境,适合第一次尝试。

本包是跨平台 Node.js 教学 CLI(需 Node 18+)以 ZIP 形式为 Windows 打包;平台字段只表示打包方式,不包含任何平台原生二进制。 输出 authenticity = demo-simulated,不是官方编译器。

完整性校验(SHA-256)

文件
rcl-portable-0.94.0-alpha.1-windows-x64.zip
大小
8,222 字节
登记校验值
50faa0f14c09f865e29bf315ea50f7e0dce98903931ec7c5bee36409e4800637

或在本地手动复算(结果必须与登记值一致):

macOS / Linux

$ shasum -a 256 rcl-portable-0.94.0-alpha.1-windows-x64.zip

Windows PowerShell

$ Get-FileHash -Algorithm SHA256 .\rcl-portable-0.94.0-alpha.1-windows-x64.zip | Format-List

也可直接下载后自行校验:rcl-portable-0.94.0-alpha.1-windows-x64.zip

安装步骤

  1. 1. 下载 ZIP 后解压到不含空格与中文的路径,例如 C:\rcl。
  2. 2. 把解压目录下的 bin 加入 PATH(或直接使用 bin\rcl.exe)。
  3. 3. 打开新的终端,运行 rcl --version 确认安装。

验证安装是否成功

$ shasum -a 256 rcl-portable-0.94.0-alpha.1-windows-x64.zip
$ rcl --version
$ rcl doctor
$ rcl check examples/hello-reality/main.rcl
$ rcl run examples/hello-reality/main.rcl

已知问题

  • · 实验版本尚未提供代码签名,Windows 可能提示未知发布者。
A. RCL Portable

rcl-portable-0.94.0-alpha.1-macos-arm64.tar.gz

POSIX 打包(tar.gz)
Node 18+
已发布

下载、解压、运行。不修改系统环境,适合第一次尝试。

本包是跨平台 Node.js 教学 CLI(需 Node 18+)以 tar.gz 形式为 POSIX(macOS / Linux)打包;平台字段只表示打包方式,不包含任何平台原生二进制。 输出 authenticity = demo-simulated,不是官方编译器。

完整性校验(SHA-256)

文件
rcl-portable-0.94.0-alpha.1-macos-arm64.tar.gz
大小
5,230 字节
登记校验值
276c7cbadad1baac6ca6cf491184c88cceb3ba3c6a9bf6106ce21150e8673330

或在本地手动复算(结果必须与登记值一致):

macOS / Linux

$ shasum -a 256 rcl-portable-0.94.0-alpha.1-macos-arm64.tar.gz

Windows PowerShell

$ Get-FileHash -Algorithm SHA256 .\rcl-portable-0.94.0-alpha.1-macos-arm64.tar.gz | Format-List

也可直接下载后自行校验:rcl-portable-0.94.0-alpha.1-macos-arm64.tar.gz

安装步骤

  1. 1. 解压:tar -xzf rcl-portable-*.tar.gz
  2. 2. 进入目录后运行 ./bin/rcl --version。
  3. 3. 如需全局使用,把 bin 目录加入 PATH。

验证安装是否成功

$ shasum -a 256 rcl-portable-0.94.0-alpha.1-macos-arm64.tar.gz
$ rcl --version
$ rcl doctor
$ rcl check examples/hello-reality/main.rcl

已知问题

  • · 未公证(notarize)前首次运行需在「隐私与安全性」中手动允许。
B. RCL CLI / SDK

rcl-cli-0.94.0-alpha.1-linux-x64.tar.gz

POSIX 打包(tar.gz)
Node 18+
已发布

命令行与 SDK,可在流水线中固定版本使用。

本包是跨平台 Node.js 教学 CLI(需 Node 18+)以 tar.gz 形式为 POSIX(macOS / Linux)打包;平台字段只表示打包方式,不包含任何平台原生二进制。 输出 authenticity = demo-simulated,不是官方编译器。

完整性校验(SHA-256)

文件
rcl-cli-0.94.0-alpha.1-linux-x64.tar.gz
大小
5,230 字节
登记校验值
276c7cbadad1baac6ca6cf491184c88cceb3ba3c6a9bf6106ce21150e8673330

或在本地手动复算(结果必须与登记值一致):

macOS / Linux

$ shasum -a 256 rcl-cli-0.94.0-alpha.1-linux-x64.tar.gz

Windows PowerShell

$ Get-FileHash -Algorithm SHA256 .\rcl-cli-0.94.0-alpha.1-linux-x64.tar.gz | Format-List

也可直接下载后自行校验:rcl-cli-0.94.0-alpha.1-linux-x64.tar.gz

安装步骤

  1. 1. 解压并将 rcl 放入 /usr/local/bin。
  2. 2. 在 CI 中固定版本号,避免实验版语法漂移。
  3. 3. 运行 rcl doctor 检查 Provider 依赖。

验证安装是否成功

$ shasum -a 256 rcl-cli-0.94.0-alpha.1-linux-x64.tar.gz
$ rcl --version
$ rcl doctor
$ rcl robust examples/4r-validation/main.rcl

已知问题

  • · glibc 版本低于 2.31 的发行版暂不支持。
B. RCL CLI / SDK

rcl-cli-0.94.0-alpha.1-macos-universal.tar.gz

POSIX 打包(tar.gz)
Node 18+
已发布

命令行与 SDK,可在流水线中固定版本使用。

本包是跨平台 Node.js 教学 CLI(需 Node 18+)以 tar.gz 形式为 POSIX(macOS / Linux)打包;平台字段只表示打包方式,不包含任何平台原生二进制。 输出 authenticity = demo-simulated,不是官方编译器。

完整性校验(SHA-256)

文件
rcl-cli-0.94.0-alpha.1-macos-universal.tar.gz
大小
5,230 字节
登记校验值
276c7cbadad1baac6ca6cf491184c88cceb3ba3c6a9bf6106ce21150e8673330

或在本地手动复算(结果必须与登记值一致):

macOS / Linux

$ shasum -a 256 rcl-cli-0.94.0-alpha.1-macos-universal.tar.gz

Windows PowerShell

$ Get-FileHash -Algorithm SHA256 .\rcl-cli-0.94.0-alpha.1-macos-universal.tar.gz | Format-List

也可直接下载后自行校验:rcl-cli-0.94.0-alpha.1-macos-universal.tar.gz

安装步骤

  1. 1. 解压后将 rcl 放入 /usr/local/bin。
  2. 2. 运行 rcl doctor。

验证安装是否成功

$ shasum -a 256 rcl-cli-0.94.0-alpha.1-macos-universal.tar.gz
$ rcl --version
$ rcl doctor
C. Docker / Dev Container

rcl-devcontainer-0.94.0-alpha.1.tar.gz

容器构建上下文
Node 18+
已发布

环境完全隔离,Agent 与 CI 推荐固定 digest。

本包是跨平台 Node.js 教学 CLI(需 Node 18+)以 tar.gz 形式提供 Dev Container 构建上下文;平台字段只表示打包方式,不包含任何平台原生二进制。 输出 authenticity = demo-simulated,不是官方编译器。

完整性校验(SHA-256)

文件
rcl-devcontainer-0.94.0-alpha.1.tar.gz
大小
5,843 字节
登记校验值
ba62892077d23ddce922d479230f4e81ed1401395022ec6db3aad41455b82e6a

或在本地手动复算(结果必须与登记值一致):

macOS / Linux

$ shasum -a 256 rcl-devcontainer-0.94.0-alpha.1.tar.gz

Windows PowerShell

$ Get-FileHash -Algorithm SHA256 .\rcl-devcontainer-0.94.0-alpha.1.tar.gz | Format-List

也可直接下载后自行校验:rcl-devcontainer-0.94.0-alpha.1.tar.gz

安装步骤

  1. 1. 先校验压缩包 SHA-256,与本页登记值比对一致后再解压。
  2. 2. 解压:tar -xzf rcl-devcontainer-0.94.0-alpha.1.tar.gz
  3. 3. 本地构建镜像:docker build -t rcl-demo:0.94.0-alpha.1 .
  4. 4. Agent 与 CI 请固定镜像 digest(docker image inspect --format '{{.Id}}'),而非 tag。

验证安装是否成功

$ shasum -a 256 rcl-devcontainer-0.94.0-alpha.1.tar.gz
$ docker build -t rcl-demo:0.94.0-alpha.1 .
$ docker run --rm rcl-demo:0.94.0-alpha.1 --version
$ docker run --rm rcl-demo:0.94.0-alpha.1 doctor
$ docker run --rm -v "$PWD:/work" rcl-demo:0.94.0-alpha.1 check /work/main.rcl

已知问题

  • · 镜像由本地 docker build 生成,完整性由压缩包 SHA-256 保证;公共镜像仓库尚未推送。
  • · 容器内运行的是教学版静态分析器(authenticity=demo-simulated),不是官方编译器。
D. Web Playground

在线 Playground(无需安装)

web
已发布

无需安装,立即试用语法结构(当前为教学 Demo 适配器)。

打开在线入口,无需下载文件,因此没有校验值。

安装步骤

  1. 1. 无需安装,直接打开 Playground。
  2. 2. 当前使用教学 Demo 适配器,不执行真实 RCL 编译器。

验证安装是否成功

已知问题

  • · Demo 适配器仅做结构化静态推导,结果不可作为真实编译结论。

安装之后该做什么?

  1. 1. 执行 rcl --version,记录版本号。
  2. 2. 在顶部版本选择器中选择相同版本,确保文档与实现一致。
  3. 3. 前往学习中心完成第一课,或直接运行Hello Reality 示例