Cloud 命令

Cloud 命令实现跨开发者的基因共享。通过 Rotifer Cloud Registry，发布的基因可以被全球开发者发现、安装和竞争。

使用 GitHub OAuth 认证 Rotifer Cloud。

rotifer login

认证流程：

打开浏览器前往 GitHub OAuth 授权页面
用户授权 Rotifer Protocol
PKCE 流程交换授权码获取令牌
凭证保存至 ~/.rotifer/credentials.json

示例：

$ rotifer login
  正在打开浏览器进行 GitHub 认证...
  等待授权...
  ✓ 已登录为 @yourname

rotifer logout

清除 Cloud 认证凭证。

rotifer logout

rotifer publish

将基因上传至 Rotifer Cloud Registry。

rotifer publish <名称> [选项]

参数：

参数	必填	说明
`名称`	是	要发布的基因名称

选项：

标志	说明
`--description <文本>`	覆盖基因描述

前提条件：

必须已登录（rotifer login）
基因必须有有效的 phenotype.json
建议先编译 WASM（gene.ir.wasm），但非必须

上传内容：

Phenotype 元数据（域、模式、版本、保真度）
WASM 二进制文件（如果已编译）
描述和作者信息

发布后：

基因目录中保存 .cloud-manifest.json，关联本地基因与云端 ID
基因对其他开发者可搜索和安装

示例：

$ rotifer publish my-search --description "快速网页搜索基因"
  以 @yourname 身份发布...
  上传到云端注册表...

  ✓ 基因 'my-search' 已发布到云端！

  ID：       a1b2c3d4-...
  所有者：   yourname
  域：       search.web
  版本：     0.1.0
  保真度：   Wrapped
  WASM 大小：142.3KB

  其他人可安装：rotifer install a1b2c3d4-...
  提交到 Cloud Arena：rotifer arena submit --cloud my-search

rotifer search

在 Cloud Registry 中搜索基因。

rotifer search [查询] [选项]

参数：

参数	必填	说明
`查询`	否	搜索关键词（匹配名称和描述）

选项：

标志	说明
`-d, --domain <域>`	按功能域过滤
`--fidelity <类型>`	按 `Native` 或 `Wrapped` 过滤
`--sort <排序>`	排序：`newest`、`popular`、`fitness`
`--page <n>`	页码（每页 20 条）

示例：

$ rotifer search "web search"
  ┌──────────────────────┬──────────┬────────────┬─────────┬──────────┬───────────┐
  │ Name                 │ Owner    │ Domain     │ Version │ Fidelity │ Downloads │
  ├──────────────────────┼──────────┼────────────┼─────────┼──────────┼───────────┤
  │ fast-web-search      │ alice    │ search.web │ 0.2.0   │ Native   │ 142       │
  │ my-web-search        │ bob      │ search.web │ 0.1.0   │ Wrapped  │ 38        │
  └──────────────────────┴──────────┴────────────┴─────────┴──────────┴───────────┘

rotifer install

从 Cloud Registry 下载并安装基因到本地项目。

rotifer install <gene-id>

参数：

参数	必填	说明
`gene-id`	是	基因的 UUID

工作流程：

从云端获取基因元数据
下载 WASM 二进制文件（如有）
在项目的 genes/ 目录中创建基因目录
保存 phenotype.json 和 gene.ir.wasm

示例：

$ rotifer install a1b2c3d4-e5f6-7890-abcd-ef1234567890
  正在从云端下载 'fast-web-search'...
  ✓ 已安装到 genes/fast-web-search/

  域：      search.web
  保真度：  Native
  版本：    0.2.0

  测试：rotifer test fast-web-search
  提交到 Arena：rotifer arena submit fast-web-search

自定义端点

默认情况下，Cloud 命令连接 https://rotifer-cloud.supabase.co。可配置自定义端点：

环境变量：

export ROTIFER_CLOUD_ENDPOINT=https://your-instance.supabase.co

配置文件（~/.rotifer/cloud.json）：

{
  "endpoint": "https://your-instance.supabase.co",
  "anonKey": "your-anon-key"
}