Examples

示例库

每个示例都可直接载入 Playground 编译验证。示例的「已验证」标记说明它是否在真实编译器上运行过。

RCL 0.94.0-alpha.1

Docs 0.94.0-alpha.1 (Draft)

共 10 个示例

Reality Transaction

进阶

在 Playground 打开

把一次软件修改描述为一个整体提交或整体中止的现实事务。

预期结果

投影输出受影响对象、允许与禁止范围、验收与中止条件。

main.rcl

world software_change {
  object auth_service { state timeout: Duration = 30s }
  object session_store { state ttl: Duration = 15m }

  subject agent "agent:code-writer"
  subject reviewer "human:role/reviewer"
  accountable reviewer for transaction fix_login_timeout

  provider vcs "git" {
    capability [read, write, revert]
    on_failure abort
  }

  variable regression_risk: Decimal {
    range 0.0 .. 1.0
    uncertainty beta(a = 2, b = 6)
    source "provider:ci"
  }

  transaction fix_login_timeout by agent {
    target "修复登录超时问题"
    affects object auth_service, object session_store
    allow paths ["src/auth/**"]
    deny paths ["infra/**", "src/billing/**"]

    provider vcs capability [read, write, revert]

    robust {
      predictable  variable regression_risk
      controllable provider vcs
      reversible   rollback revert_commit
      stable       invariant field login_latency
    }

    evidence require {
      test_report from provider "ci"
      reviewer_approval from subject reviewer
    }

    accept when ci.tests_passed and reviewer_approval.present
    abort when deny_paths.touched or regression_risk >= 0.3
    rollback to snapshot pre_change
  }

  invariant field login_latency {
    when true keep auth_service.timeout <= 30s
  }
}

尚未在真实编译器验证：结构对应第 10 课毕业项目。

Hello Reality

入门

最小可运行结构：一个世界、一个对象、一个主体、一个变换。

world

object

subject

transform

尚未在真实编译器验证

打开查看源码

Typed Reality Variables

入门

把未知量写成带范围与不确定性的类型化现实变量。

variable

uncertainty

R_pred

尚未在真实编译器验证

打开查看源码

Constraint Guard

入门

用约束阻止账户余额进入非法状态。

constraint

guard

非法状态

尚未在真实编译器验证

打开查看源码

Adaptive Invariant

进阶

在负载波动环境下使用自适应不变量场，而不是硬编码阈值。

invariant field

R_stab

尚未在真实编译器验证

打开查看源码

4R Validation

进阶

完整声明四维鲁棒证书，观察缺项如何导致提交被拒。

robust

R_pred

R_ctrl

R_irr

R_stab

尚未在真实编译器验证

打开查看源码

Reality Transaction

进阶

把一次软件修改描述为一个整体提交或整体中止的现实事务。

transaction

allow/deny

abort

尚未在真实编译器验证

打开查看源码

Commit / Abort / Rollback

进阶

三种终态的显式声明与回滚边界。

commit

abort

rollback

snapshot

尚未在真实编译器验证

打开查看源码

Evidence Trace

进阶

声明证据要求并读取 Evidence Receipt。

evidence

trace

receipt

尚未在真实编译器验证

打开查看源码

Multi-Subject Task

高级

Agent 执行、人类审批的双主体任务规格。

subject

authority

accountable

关系

尚未在真实编译器验证

打开查看源码

RNCS Provider Bridge

高级

把 RCL 规格桥接到 RNCS 运行时的 Provider 能力集合。

provider

capability

RNCS

Commit Gate

尚未在真实编译器验证

打开查看源码