Cloud 命令

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

通过 OAuth 认证 Rotifer Cloud。

rotifer login [选项]

选项：

标志	说明
`--provider <name>`	OAuth 提供商：`github`（默认）或 `gitlab`
`--endpoint <url>`	Cloud 端点 URL（覆盖默认值）

认证流程：

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

示例：

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

rotifer logout

清除 Cloud 认证凭证。

rotifer logout

示例：

$ rotifer logout
  ✓ Logged out successfully

rotifer publish

将基因上传至 Rotifer Cloud Registry。

rotifer publish [gene-name] [选项]

参数：

参数	必填	说明
`gene-name`	是（除非使用 `--all`）	要发布的基因名称

选项：

标志	说明
`--description <文本>`	覆盖基因描述
`--changelog <文本>`	本版本的变更记录（最长 500 字符）
`--skip-arena`	跳过自动 Arena 提交和声誉计算
`--skip-security`	跳过发布前安全检查（危险 API / IR / 密钥扫描）
`--all`	发布 `genes/` 目录下所有有效基因

前提条件：

必须已登录（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                 │ Creator  │ 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-ref> [选项]

参数：

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

选项：

标志	说明
`--force`	本地已存在同名基因时强制覆盖

工作流程：

从云端获取基因元数据
下载 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://cloud.rotifer.dev。可配置自定义端点：

环境变量：

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

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

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