5 分钟理解 RKT

从零开始，从概念到安装你的第一个 Bundle。

1RKT 是什么？

RKT（Role · Kit · Team）是面向 AI 时代的对象语言。

它解决一个核心问题：当 AI 世界充斥着 Prompt、Skill、Agent、MCP、Workflow、Bot 等碎片化概念时，如何统一描述和管理 AI 能力？

答案是压缩为 4 个稳定对象：

对象回答的问题类比
Role 角色这是谁？负责什么？工作岗位说明书
Kit 能力包挂载了什么能力？受控工具箱
Team 协作怎么协作和交接？组织架构图
Bundle 系统包如何安装和交易？App 安装包
📦 当前阶段：Bundle 是最小交易/安装/替换单元（最小 = 1 Role + 0~N Kit）。
🔮 未来升级：Role / Kit / Team 均可独立交易、替换、自由组合。

2三层架构

RKT 协议是最底层，它只负责定义；上面有系统层负责运行，再上面有执行层负责执行：

Runtime (OpenClaw 等) — 执行 AI
↑ 投影
ROLEOS — 运行 AI
↑ 读取
RKT Protocol — 定义 AI

3写你的第一个 Bundle

一个最简 Bundle 的 manifest.json 长这样：

{
  "rktVersion": "1.0",
  "id": "hello-world",
  "version": "1.0.0",
  "name": "Hello World",
  "summary": "我的第一个 RKT Bundle",
  "targetUser": "初学者",
  "author": "your-name",
  "license": "MIT",

  "roles": [{
    "id": "greeter",
    "label": "问候员",
    "purpose": "友好地向用户打招呼",
    "thinkingLevel": "normal"
  }],

  "activationScope": "session",
  "rollbackProfile": {
    "snapshotEnabled": true,
    "strategy": "full"
  }
}

就这么简单！一个 Role + 基础元数据 = 一个合法 Bundle。

带 Kit 的 Bundle（受控镜像）

{
  "roles": [{ "id": "weather-role", "label": "天气播报员", "purpose": "查询天气", "kits": ["weather-kit"] }],
  "kits": [{
    "id": "weather-kit",
    "label": "天气查询",
    "capabilities": ["weather.forecast"],
    "runtime": "node",
    "riskLevel": "low",
    // 🔒 受控镜像 — 版本锁定，禁止热更新
    "mirror": {
      "source": "roleos-mirror://official",
      "digest": "sha256:abc123def456",
      "lockedAt": "2026-03-25T00:00:00Z",
      "autoUpdate": false,
      "clawHubRef": "weather-forecast@1.0.0"
    }
  }]
}

4安装你的第一个 Bundle

# 1. 安装 ROLEOS CLI
npx @roleos/cli init

# 2. 登录 roleos.ai
roleos login
✓ 已登录: user@example.com

# 3. 从市场安装 Bundle
roleos install weather-broadcaster
📦 下载 weather-broadcaster v1.0.0...
🔍 6 层 Validator 校验中...
  L1 包体结构 ✅
  L2 语义对象 ✅  (Kit capabilities / thinkingLevel)
  L3 依赖兼容 ✅  (mirror.digest 哈希校验)
  L4 权限隔离 ✅  (autoUpdate: false ✓)
  L5 运行时确定 ✅
  L6 体验可转译 ✅
🔮 生成安装预览...
✅ 已激活！写入 3 文件到 workspace

5核心概念速查

🔒 Kit 受控镜像

Kit 中挂载的 Skills 从 ClawHub 获取，但版本哈希锁定（sha256），禁止热更新。确保 Bundle 功能稳定可预测。

🛡️ 6 层 Validator

每个 Bundle 安装前都会自动通过 6 层校验：包体结构 → 语义对象 → 依赖兼容 → 权限隔离 → 运行时确定性 → 体验可转译。

🔮 Shadow Runtime

安装前自动生成人类可读的预览摘要：谁参与、能做什么、有什么风险、如何回滚。用户看得懂，才敢安装。

🔁 非侵入投影 + 回滚

Bundle 不直接修改宿主环境，而是"投影"到隔离 workspace。每次激活自动创建快照，一键回滚到安装前状态。

🔮 Phase 2 升级路径

所有对象已预留 tradable/version/author/tags 字段。未来 Role/Kit/Team 可独立交易、替换、自由组合。

下一步